superdoc 2.7.0-next.4 → 2.7.0-next.6

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.7.0-next.4",
+	superdocVersion: "2.7.0-next.6",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.7.0-next.4",
+	superdocVersion: "2.7.0-next.6",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/painters/dom/src/index.d.ts

@@ -3,6 +3,8 @@ import { PageStyles } from './styles.js';
 import { PositionValidationOptions, PositionValidationSummary } from './pm-position-validation.js';
 import { DomPainterInput, PageDecorationProvider, PaintSnapshot, PositionMapping, FlowMode } from './renderer.js';
 import { DomPainterPersistentPageInput } from './persistent-page-surface.js';
+export { createWebFlowPainter, ensureWebFlowStyles, WEB_FLOW_CLASS_NAMES } from './web-flow/index.js';
+export type { WebFlowAppliedPaint, WebFlowDomBinding, WebFlowPaintCommand, WebFlowPaintItem, WebFlowPaintSnapshot, WebFlowPaintTransaction, WebFlowPainterHandle, WebFlowPainterOptions, WebFlowPaintWorkSummary, WebFlowStableDomKey, } from './web-flow/index.js';
 export { DOM_CLASS_NAMES } from './constants.js';
 export type { DomClassName } from './constants.js';
 export { ensureDocumentSurfaceStyles } from './styles.js';

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

@@ -0,0 +1,3 @@
+export { createWebFlowPainter } from './painter.js';
+export { ensureWebFlowStyles, WEB_FLOW_CLASS_NAMES } from './styles.js';
+export type { WebFlowAppliedPaint, WebFlowDomBinding, WebFlowPaintCommand, WebFlowPaintItem, WebFlowPaintSnapshot, WebFlowPaintTransaction, WebFlowPainterHandle, WebFlowPainterOptions, WebFlowPaintWorkSummary, WebFlowStableDomKey, } from './types.js';

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

@@ -0,0 +1,2 @@
+import { WebFlowPainterHandle, WebFlowPainterOptions } from './types.js';
+export declare function createWebFlowPainter(mount: HTMLElement, options?: WebFlowPainterOptions): WebFlowPainterHandle;

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

@@ -0,0 +1,6 @@
+import { WebFlowPaintItem, WebFlowPainterOptions } from './types.js';
+export declare function renderWebFlowItem(item: WebFlowPaintItem, doc: Document, options: WebFlowPainterOptions): HTMLElement;
+/** Identity-only signature for deciding whether a retained node needs dataset rebasing. */
+export declare function webFlowItemIdentityFingerprint(item: WebFlowPaintItem): string;
+/** Rebase canonical identity datasets without replacing an unchanged retained node. */
+export declare function rebaseWebFlowItemNode(node: HTMLElement, previous: WebFlowPaintItem, next: WebFlowPaintItem): () => void;

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

@@ -0,0 +1,10 @@
+export declare const WEB_FLOW_CLASS_NAMES: {
+    readonly root: "superdoc-web-flow";
+    readonly block: "superdoc-web-flow-block";
+    readonly paragraph: "superdoc-web-flow-paragraph";
+    readonly run: "superdoc-web-flow-run";
+    readonly listMarker: "superdoc-web-flow-list-marker";
+    readonly table: "superdoc-web-flow-table";
+    readonly diagnostic: "superdoc-web-flow-diagnostic";
+};
+export declare function ensureWebFlowStyles(doc: Document): void;

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/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.cjs

@@ -43484,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";
@@ -43518,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.4";
+		this.version = "2.7.0-next.6";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -43417,10 +43417,6 @@ var SuperDoc = class extends 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";
@@ -43451,7 +43447,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.7.0-next.4";
+		this.version = "2.7.0-next.6";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];