superdoc 2.7.0-next.1 → 2.7.0-next.10

package/dist/layout-engine/painters/dom/src/web-flow/types.d.ts

@@ -0,0 +1,77 @@
+import { FlowBlock, LayoutSourceIdentity } from '../../../../contracts/src/index.js';
+/** Opaque adapter-issued identity. The painter never derives this value from DOM or block ids. */
+export type WebFlowStableDomKey = string;
+export interface WebFlowPaintItem {
+    readonly stableDomKey: WebFlowStableDomKey;
+    readonly renderFingerprint: string;
+    readonly block: FlowBlock;
+    readonly layoutEpoch?: number;
+    readonly layoutIdentities?: readonly LayoutSourceIdentity[];
+    readonly editable?: boolean;
+}
+export type WebFlowPaintCommand = {
+    readonly kind: 'replace-all';
+    readonly epoch: number;
+    readonly items: readonly WebFlowPaintItem[];
+} | {
+    readonly kind: 'splice';
+    readonly expectedBaseEpoch: number;
+    readonly epoch: number;
+    readonly storyKey: string;
+    readonly expectedRemovedKeys: readonly WebFlowStableDomKey[];
+    readonly expectedLeftKey: WebFlowStableDomKey | null;
+    readonly expectedRightKey: WebFlowStableDomKey | null;
+    readonly items: readonly WebFlowPaintItem[];
+    /** Identity-only updates for retained nodes downstream of a structural splice. */
+    readonly retainedRebases?: readonly WebFlowPaintItem[];
+};
+export interface WebFlowPaintWorkSummary {
+    readonly kind: WebFlowPaintCommand['kind'];
+    readonly retainedNodes: number;
+    readonly createdNodes: number;
+    readonly removedNodes: number;
+    readonly rebasedNodes: number;
+    readonly touchedItems: number;
+}
+export interface WebFlowDomBinding {
+    readonly key: WebFlowStableDomKey;
+    readonly renderFingerprint: string;
+    readonly blockId: string;
+    readonly node: HTMLElement;
+}
+export interface WebFlowPaintSnapshot {
+    readonly epoch: number | null;
+    readonly version: number;
+    readonly bindings: readonly WebFlowDomBinding[];
+}
+export interface WebFlowAppliedPaint {
+    readonly work: WebFlowPaintWorkSummary;
+    /** Bindings directly owned by this command; localized splices never scan the retained root. */
+    readonly touchedBindings: readonly WebFlowDomBinding[];
+    /** Bindings whose DOM node or retained identity changed in this command. */
+    readonly changedBindings: readonly WebFlowDomBinding[];
+}
+export interface WebFlowPaintTransaction {
+    readonly command: WebFlowPaintCommand;
+    /** Installs the candidate synchronously. The caller must then finalize or roll it back. */
+    apply(): WebFlowAppliedPaint;
+    /** Publishes the applied state and releases the rollback journal. */
+    finalize(): WebFlowAppliedPaint;
+    /** Restores the exact pre-apply DOM and retained state. */
+    rollback(): void;
+}
+export interface WebFlowPainterHandle {
+    prepare(command: WebFlowPaintCommand): WebFlowPaintTransaction;
+    snapshot(): WebFlowPaintSnapshot;
+    /** Rebuilds the last committed derived DOM after an externally owned mutation. */
+    restoreCommittedDomAfterUnownedMutation(): WebFlowPaintSnapshot;
+    dispose(): void;
+}
+export interface WebFlowPainterOptions {
+    readonly resolvePhysical?: (cssFontFamily: string, face: {
+        weight: '400' | '700';
+        style: 'normal' | 'italic';
+    }) => string;
+    /** Fires synchronously when the mutation observer first detects unowned DOM. */
+    readonly onUnownedMutation?: (kind: 'text' | 'dom') => void;
+}

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C44xPZxz.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BTNVc3UD.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C44xPZxz.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BTNVc3UD.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/composables/use-link-popover.d.ts

@@ -127,10 +127,9 @@ export type HyperlinkGetResult = {
 };
 /**
  * Result of `doc.bookmarks.get()` as read here (Document API `BookmarkInfo`).
- * `range.from.blockId` is the bookmark's `w14:paraId`, used to find/reveal
- * the target paragraph. `address.story` is populated for non-body
- * bookmarks (omitted for body) — used to scope this fix to body targets,
- * since `revealBodyTarget`/`pageIndexForBodyTarget` are body-only.
+ * `range.from.blockId` identifies the model paragraph sent to the viewport.
+ * `address.story` is populated for non-body bookmarks (omitted for body),
+ * which keeps anchor navigation scoped to body targets.
  */
 export type BookmarkGetResult = {
     address?: {
@@ -184,16 +183,6 @@ export type LinkPopoverDocumentApi = {
         }) => BookmarkGetResult | Promise<BookmarkGetResult | null | undefined> | null | undefined;
     } | null | undefined;
 };
-/**
- * Result of `activeEditor.pageMetrics.revealBodyTarget()` as read here
- * (`V2EditorHostRevealBodyTargetResult`). Only available in editing/
- * suggesting mode — the host rejects with `editing-not-mounted` in
- * viewing mode.
- */
-export type RevealBodyTargetResult = {
-    status?: "rejected" | "revealed" | undefined;
-    reason?: string | undefined;
-};
 /**
  * The `v2-link-click` payload the shell relays from the v2 host's
  * `onLinkClick` callback.

package/dist/superdoc/src/core/types/index.d.ts

@@ -2543,7 +2543,11 @@ export type ViewLayout = 'print' | 'web';
  * Mirrors OOXML document view settings.
  */
 export interface ViewOptions {
-    /** Document view layout (OOXML ST_View compatible). */
+    /**
+     * Document view layout (OOXML ST_View compatible). In the browser editor,
+     * `'web'` selects the retained semantic DOM surface. Browser normal flow
+     * rewraps content as the editor container changes width.
+     */
     layout?: ViewLayout;
 }
 export interface ExportParams {
@@ -3378,6 +3382,11 @@ export interface Config {
     experimental?: {
         unifiedHistory?: boolean;
         v2Host?: boolean;
+        /**
+         * Temporary V2 web-surface rollout control. The value is snapshotted at
+         * mount and changing it requires a remount. This is not a stable renderer API.
+         */
+        v2WebSurface?: 'dense-control' | 'retained-dom';
         /**
          * Derived-invalidation deferral for direct single-paragraph edits (v2
          * engine only). Field display text settles off the keystroke path under
@@ -3605,10 +3614,8 @@ export interface Config {
      */
     workerStartupTimeoutMs?: number;
     /**
-     * Opt-in toggle for the layout engine. Auto-disabled when web layout is
-     * requested without `layoutEngineOptions.flowMode === 'semantic'`; the
-     * loader logs a warning and falls back to the legacy ProseMirror render
-     * path in that case.
+     * Compatibility toggle retained for existing configurations. V2 always
+     * uses the OOXML kernel; `viewOptions.layout` selects the mounted renderer.
      */
     useLayoutEngine?: boolean;
     /**

package/dist/superdoc/src/helpers/v2-review-mutation-impact.d.ts

@@ -2,9 +2,8 @@
  * Classify the tracked-change identities carried by a v2 mutation event.
  *
  * Receipt entities are the durable invalidation contract between the document
- * kernel and derived review UI. Consumers apply removals/remaps locally; the
- * next committed window supplies surviving or restored rows. History follows
- * the same bounded path and never enumerates invisible review identities.
+ * kernel and derived review UI. Direct receipts carry entity refs; mutation
+ * plans carry the same identities through `trackedChanges` and per-step ids.
  */
 export function getV2TrackedChangeMutationImpact(event: any): {
     allResolved?: any;

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-D38u8ta_.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-RC64TPzL.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-CwCvqMOa.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C44xPZxz.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-SDR04tiH.cjs");
 const require_constants = require("./chunks/constants-DpXuDx_g.cjs");
 let vue = require("vue");
@@ -18195,10 +18195,9 @@ function scrollToElement(targetElement, options = {
 */
 /**
 * Result of `doc.bookmarks.get()` as read here (Document API `BookmarkInfo`).
-* `range.from.blockId` is the bookmark's `w14:paraId`, used to find/reveal
-* the target paragraph. `address.story` is populated for non-body
-* bookmarks (omitted for body) — used to scope this fix to body targets,
-* since `revealBodyTarget`/`pageIndexForBodyTarget` are body-only.
+* `range.from.blockId` identifies the model paragraph sent to the viewport.
+* `address.story` is populated for non-body bookmarks (omitted for body),
+* which keeps anchor navigation scoped to body targets.
 * @typedef {Object} BookmarkGetResult
 * @property {{ story?: { kind?: string, storyType?: string } }} [address]
 * @property {{ from?: { blockId?: string } }} [range]
@@ -18217,15 +18216,6 @@ function scrollToElement(targetElement, options = {
 * @property {{ get?: (input: { target: { kind: 'entity', entityType: 'bookmark', name: string } }) => BookmarkGetResult | Promise<BookmarkGetResult | null | undefined> | null | undefined } | null} [bookmarks]
 */
 /**
-* Result of `activeEditor.pageMetrics.revealBodyTarget()` as read here
-* (`V2EditorHostRevealBodyTargetResult`). Only available in editing/
-* suggesting mode — the host rejects with `editing-not-mounted` in
-* viewing mode.
-* @typedef {Object} RevealBodyTargetResult
-* @property {'revealed' | 'rejected'} [status]
-* @property {string} [reason]
-*/
-/**
 * The `v2-link-click` payload the shell relays from the v2 host's
 * `onLinkClick` callback.
 * @typedef {Object} LinkClickPayload
@@ -18567,20 +18557,8 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 		handle.result?.then?.((outcome) => clearCurrentPopover(handle, outcome), () => clearCurrentPopover(handle));
 	}
 	/**
-	* Look up a real `<a name>` anchor, or a bookmark-marker span, in the
-	* currently mounted DOM. The marker span
-	* (`data-bookmark-marker`/`data-bookmark-name`) is a best-effort fast
-	* path only: layout-engine measuring drops those zero-width marker runs
-	* from paint whenever the wrapping paragraph has other visible content
-	* (the standard shape for a TOC bookmark wrapping heading text,
-	* `<w:bookmarkStart .../><w:r>Heading</w:r><w:bookmarkEnd/>`) — but it
-	* DOES survive for a standalone/empty bookmark paragraph (a supported v2
-	* shape, see `v2-layout-adapter/src/empty-paragraph.test.ts` and
-	* `isSyntheticStandaloneBookmarkParagraph` in
-	* `v2-host/src/compose-exact-complete-render.ts`), where it lets a
-	* mounted bookmark scroll immediately without a Document API round trip.
-	* `findPaintedParagraphByParaId` remains the reliable fallback for the
-	* common (marker-not-painted) case.
+	* Find a mounted named anchor for runtimes that do not expose the bookmark
+	* model. Model-backed runtimes never use DOM identity for navigation.
 	* @param {HTMLElement | null} container
 	* @param {string} escapedAnchorName
 	* @returns {HTMLElement | null}
@@ -18589,44 +18567,6 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 		return container?.querySelector?.(`a[name='${escapedAnchorName}'], [data-bookmark-marker='start'][data-bookmark-name='${escapedAnchorName}']`) ?? null;
 	}
 	/**
-	* Find the painted paragraph element for a `w14:paraId`, mirroring the
-	* attribute chain `paintedParaIdElement` uses in v2-host
-	* (`create-v2-editor-host.ts`) to confirm a paragraph is painted.
-	* @param {HTMLElement | null} container
-	* @param {string} paraId
-	* @returns {HTMLElement | null}
-	*/
-	function findPaintedParagraphByParaId(container, paraId) {
-		if (!container) return null;
-		const escaped = cssEscape(paraId);
-		return container.querySelector(`[data-source-node-id='${escaped}']`) ?? container.querySelector(`[data-layout-paraid='${escaped}']`) ?? container.querySelector(`[data-block-id$='/${escaped}']`) ?? container.querySelector(`[data-layout-block-ref$='/${escaped}']`) ?? null;
-	}
-	/**
-	* Poll for an element across a bounded number of animation frames. Used
-	* after `scrollToPage()` in review/viewing mode, where — unlike
-	* `revealBodyTarget` in editing mode — there is no promise that resolves
-	* once the deep-jumped page's geometry reconciles and paints.
-	* @param {() => HTMLElement | null} lookup
-	* @param {number} maxTicks
-	* @returns {Promise<HTMLElement | null>}
-	*/
-	function pollForElement(lookup, maxTicks = 30) {
-		return new Promise((resolve) => {
-			const raf = typeof window !== "undefined" ? window.requestAnimationFrame : null;
-			let ticks = 0;
-			const tick = () => {
-				const found = lookup();
-				if (found || ticks >= maxTicks || typeof raf !== "function") {
-					resolve(found ?? null);
-					return;
-				}
-				ticks += 1;
-				raf(tick);
-			};
-			tick();
-		});
-	}
-	/**
 	* Move the editable caret to the start of a resolved target paragraph after
 	* navigating to it. Mirrors V1's `goToAnchor`, whose final step places the
 	* caret at the bookmark position: without it a V2 TOC click only scrolls, so
@@ -18666,87 +18606,59 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 		} catch {}
 	}
 	/**
-	* Navigate to an internal `#anchor` link (TOC entries, bookmark links).
-	* Tries a real `<a name>` anchor in the currently mounted DOM first, then
-	* resolves the bookmark's target paragraph through the Document API and
-	* scrolls to that paragraph by its `paraId` — not to a bookmark-marker
-	* element, which layout-engine measuring may have excluded from paint.
-	*
-	* In editing/suggesting mode (`placeCaret`), also moves the caret to the
-	* start of the resolved target paragraph, matching V1's `goToAnchor`.
-	*
-	* If the paragraph isn't mounted (the v2 layout engine only mounts a
-	* sliding window of pages), asks the host to reveal it:
-	*  - In editing/suggesting mode, `pageMetrics.revealBodyTarget` deep-jumps
-	*    into unmounted pages and resolves once the target is painted. Any
-	*    rejection here OTHER than `editing-not-mounted` is a real failure of
-	*    this strong, paint-confirmed path and is left as a no-op rather than
-	*    silently degrading to the weaker path below.
-	*  - In viewing mode the host is mounted in "review" mode, where
-	*    `revealBodyTarget` always rejects with reason `editing-not-mounted`
-	*    (or is simply unpublished); only then falls back to
-	*    `pageIndexForBodyTarget` + `scrollToPage` (neither gated on mount
-	*    mode) and polls for paint, since neither returns a paint-complete
-	*    promise.
-	*
-	* Out of scope: bookmarks outside the body story (headers/footers/
-	* footnotes) — `revealBodyTarget`/`pageIndexForBodyTarget` are body-only.
+	* Navigate to a body bookmark through its model address. A mounted-anchor
+	* fallback is reserved for runtimes without a callable bookmark model.
 	* @param {string | null | undefined} anchorUrl
 	* @param {{ placeCaret?: boolean }} [options]
 	*/
 	async function navigateToAnchor(anchorUrl, { placeCaret = false } = {}) {
 		if (typeof anchorUrl !== "string" || !anchorUrl.startsWith("#")) return;
 		const anchorName = anchorUrl.slice(1);
-		const escapedAnchorName = cssEscape(anchorName);
-		const mountedAnchor = findMountedAnchor(getUi()?.viewport?.getHost?.() ?? null, escapedAnchorName);
-		if (mountedAnchor) {
-			scrollToElement(mountedAnchor);
-			return;
-		}
 		/** @type {LinkPopoverDocumentApi | null | undefined} */
 		const doc = getActiveEditor()?.doc;
+		const bookmarkGet = doc?.bookmarks?.get;
+		if (typeof bookmarkGet !== "function") {
+			const mountedAnchor = findMountedAnchor(getUi()?.viewport?.getHost?.() ?? null, cssEscape(anchorName));
+			if (mountedAnchor) scrollToElement(mountedAnchor, {
+				block: "start",
+				behavior: "instant"
+			});
+			return;
+		}
 		/** @type {BookmarkGetResult | null} */
 		let bookmark = null;
 		try {
-			bookmark = await Promise.resolve(doc?.bookmarks?.get?.({ target: {
+			bookmark = await Promise.resolve(bookmarkGet.call(doc.bookmarks, { target: {
 				kind: "entity",
 				entityType: "bookmark",
 				name: anchorName
 			} }));
 			bookmark ??= null;
 		} catch {
-			bookmark = null;
+			return;
 		}
 		const story = bookmark?.address?.story;
 		if (story && story.storyType !== "body") return;
 		const blockId = bookmark?.range?.from?.blockId;
 		if (typeof blockId !== "string") return;
 		if (placeCaret) await placeCaretAtHeadingStart(blockId);
-		const mountedParagraph = findPaintedParagraphByParaId(getUi()?.viewport?.getHost?.() ?? null, blockId);
-		if (mountedParagraph) {
-			scrollToElement(mountedParagraph);
-			return;
-		}
-		const pageMetrics = getActiveEditor()?.pageMetrics;
-		const revealBodyTarget = pageMetrics?.revealBodyTarget;
-		let revealResult;
+		const viewport = getUi()?.viewport;
+		const scrollIntoView = viewport?.scrollIntoView;
+		if (typeof scrollIntoView !== "function") return;
 		try {
-			revealResult = await revealBodyTarget?.({ paraId: blockId });
-		} catch {
-			revealResult = void 0;
-		}
-		if (revealResult?.status === "revealed") {
-			const revealedParagraph = findPaintedParagraphByParaId(getUi()?.viewport?.getHost?.() ?? null, blockId);
-			if (revealedParagraph) scrollToElement(revealedParagraph);
-			return;
-		}
-		if (revealBodyTarget && revealResult?.reason !== "editing-not-mounted") return;
-		const pageIndexForBodyTarget = pageMetrics?.pageIndexForBodyTarget;
-		const scrollToPage = pageMetrics?.scrollToPage;
-		const pageIndex = pageIndexForBodyTarget?.({ paraId: blockId });
-		if (typeof pageIndex !== "number" || !scrollToPage?.(pageIndex)) return;
-		const revealedByScroll = await pollForElement(() => findPaintedParagraphByParaId(getUi()?.viewport?.getHost?.() ?? null, blockId));
-		if (revealedByScroll) scrollToElement(revealedByScroll);
+			await Promise.resolve(scrollIntoView.call(viewport, {
+				target: {
+					kind: "text",
+					blockId,
+					range: {
+						start: 0,
+						end: 0
+					}
+				},
+				block: "start",
+				behavior: "instant"
+			}));
+		} catch {}
 	}
 	/**
 	* @param {LinkPopoverContext} ctx
@@ -43572,10 +43484,6 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.layoutEngineOptions = this.config.layoutEngineOptions || {};
 		const isWebLayout = this.config.viewOptions?.layout === "web";
 		const isSemanticFlow = this.config.layoutEngineOptions?.flowMode === "semantic";
-		if (isWebLayout && this.config.useLayoutEngine && !isSemanticFlow) {
-			console.warn("[SuperDoc] Web layout uses PM fallback unless layoutEngineOptions.flowMode is set to 'semantic'. Automatically disabling layout engine.");
-			this.config.useLayoutEngine = false;
-		}
 		if (!isWebLayout && isSemanticFlow) {
 			console.warn("[SuperDoc] flowMode 'semantic' is only valid with web layout. Coercing to 'paginated'.");
 			this.config.layoutEngineOptions.flowMode = "paginated";
@@ -43606,7 +43514,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.7.0-next.1";
+		this.version = "2.7.0-next.10";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];