fix(v2): keep the RTL caret on the boundary WebKit will not measure

packages/superdoc/src/core/v2-integration/v2-integration.js

@@ -14,6 +14,7 @@
 // constructed (e.g. a non-DOM context); it never selects v1.
 
 import { defineComponent, h, onMounted } from 'vue';
+import { installWebKitCollapsedCaretRectFix } from './webkit-collapsed-caret-rect.js';
 /** @type {() => Promise<unknown>} */
 let engineModuleLoader = () => import('@superdoc/docx-engine');
 /** @type {Promise<void> | null} */
@@ -39,6 +40,12 @@ export function configureDefaultV2IntegrationLoader(loader) {
 
 /** Load the engine before Vue evaluates the synchronous integration seam. */
 export async function loadDefaultV2Integration() {
+  // Every distribution mode reaches the engine through this function, so it is
+  // the one place that guarantees the workaround is installed before the engine
+  // can paint a caret. The quirk probe measures a throwaway element of its own,
+  // so no editor document has to exist yet. It never throws: a caret nicety must
+  // not be able to reject this promise and drop the editor to its stub.
+  if (typeof window !== 'undefined') installWebKitCollapsedCaretRectFix(window);
   if (!engineModulePromise) {
     const loadPromise = Promise.resolve()
       .then(() => engineModuleLoader())

packages/superdoc/src/core/v2-integration/v2-integration.test.js

@@ -1,4 +1,4 @@
-import { describe, it, expect } from 'vite-plus/test';
+import { describe, it, expect, vi } from 'vite-plus/test';
 import {
   createDefaultV2Integration,
   loadDefaultV2Integration,
@@ -9,6 +9,24 @@ import {
   isV2SyntheticTrackedChangeRow,
 } from './v2-integration.js';
 
+// The WebKit caret-rect workaround is wired in here and nowhere else, so the
+// call is what the fix ships on. Mocked so the wiring itself is asserted rather
+// than the workaround's own behaviour, which its module tests cover.
+vi.mock('./webkit-collapsed-caret-rect.js', () => ({
+  installWebKitCollapsedCaretRectFix: vi.fn(() => null),
+}));
+
+describe('WebKit caret-rect workaround wiring', () => {
+  it('installs the workaround when the engine is loaded', async () => {
+    const { installWebKitCollapsedCaretRectFix } = await import('./webkit-collapsed-caret-rect.js');
+    installWebKitCollapsedCaretRectFix.mockClear();
+
+    await loadDefaultV2Integration();
+
+    expect(installWebKitCollapsedCaretRectFix).toHaveBeenCalledWith(window);
+  });
+});
+
 // V2 branch: the integration is the single DOCX Engine runtime. There is no
 // customer-provided integration and no v1 fallback selection.
 describe('createDefaultV2Integration', () => {