superdoc 2.12.0-next.1 → 2.12.0-next.10

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.12.0-next.1",
+	superdocVersion: "2.12.0-next.10",
 	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.12.0-next.1",
+	superdocVersion: "2.12.0-next.10",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/layout-engine/contracts/src/index.d.ts

@@ -2836,7 +2836,7 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 };
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
-export { expandRunsForInlineNewlines, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
+export { expandRunsForInlineNewlines, isBodyNoteReferenceRun, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
 export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

package/dist/layout-engine/contracts/src/run-helpers.d.ts

@@ -1,4 +1,12 @@
 import { FlowBlock, Line, Run, TextRun } from './index.js';
+export declare const NOTE_REFERENCE_MARKER_ATTR = "data-v2-note-ref";
+export declare const NOTE_LABEL_MARKER_ATTR = "data-v2-note-label";
+/** Body note markers paint text but occupy one source-coordinate unit. */
+export declare function isBodyNoteReferenceRun(run: Run): boolean;
+/** Synthetic note-band or appended-endnote label keyed to its source note. */
+export declare function isNoteLabelRun(run: Run): boolean;
+/** Numbered marker text whose measurement identity can use digit capabilities. */
+export declare function isNumberedNoteMarkerRun(run: Run): boolean;
 export declare function isEmptySdtPlaceholderRun(run: Run): run is TextRun & {
     visualPlaceholder: 'emptyInlineSdt' | 'emptyBlockSdt';
 };

package/dist/layout-engine/layout-bridge/src/cache.d.ts

@@ -1,4 +1,5 @@
 import { FlowBlock } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
 /**
  * Generates a cache key hash from a block's content, incorporating text,
  * formatting, and embedded block data.
@@ -23,7 +24,7 @@ import { FlowBlock } from '../../contracts/src/index.js';
  * content component of that key, so adopting a previous measure on hash
  * equality is exactly as sound as a cache hit.
  */
-export declare const hashMeasureContent: (block: FlowBlock) => string;
+export declare const hashMeasureContent: (block: FlowBlock, capabilities?: FontMeasureCapabilities) => string;
 /**
  * Cache statistics with LRU eviction tracking
  */
@@ -80,12 +81,12 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @returns The cached value or undefined
      */
-    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): T | undefined;
+    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): T | undefined;
     /**
      * Compose the complete content, constraint, and font key once for a cache
      * read followed by an insertion in the same measurement transaction.
      */
-    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): PreparedMeasureCacheKey | undefined;
+    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): PreparedMeasureCacheKey | undefined;
     getPrepared(key: PreparedMeasureCacheKey | undefined): T | undefined;
     /**
      * Store a measure in the cache for the given block and dimensions.
@@ -96,7 +97,7 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @param value - The value to cache
      */
-    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string): void;
+    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string, capabilities?: FontMeasureCapabilities): void;
     setPrepared(key: PreparedMeasureCacheKey | undefined, blockId: string | undefined, value: T): void;
     /**
      * Invalidates cached measurements for specific block IDs.

package/dist/layout-engine/layout-bridge/src/incrementalLayout.d.ts

@@ -1,5 +1,5 @@
 import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, LayoutBlockResumeCheckpoint, Measure, Page, HeaderFooterLayout, ColumnLayout } from '../../contracts/src/index.js';
-import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
+import { FontMeasureCapabilities, FontMeasureContext } from '../../../shared/font-system/src/index.js';
 import { LayoutOptions, HeaderFooterConstraints, LayoutExecutionCheckpoint } from '../../layout-engine/src/index.js';
 import { computeDirtyRegions } from './diff.js';
 import { MeasureCache } from './cache.js';
@@ -534,10 +534,13 @@ export declare function incrementalLayout(previousBlocks: FlowBlock[], _previous
 }, previousMeasures?: Measure[] | null, fontRuntime?: {
     fontContext?: FontMeasureContext;
     previousFontSignature?: string;
+    fontCapabilities?: FontMeasureCapabilities;
 }, warmStart?: {
     footnoteReserveSeed?: FootnoteReserveSeed | null;
     /** Host proved the authoritative note projection bundle was retained exactly. */
     noteMeasurePlaneRetainedExact?: true;
+    /** Host proved this seed is an exact, geometry-equivalent subset of the current note plane. */
+    noteMeasurePlaneRetainedSubset?: true;
     /** Extra note/decorative planes paired with the retained note bundle. */
     retainedFootnoteExtras?: {
         blocks: FlowBlock[];

package/dist/layout-engine/layout-bridge/src/note-marker-measure-key.d.ts

@@ -0,0 +1,3 @@
+import { TextRun } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
+export declare function noteMarkerMeasureKey(run: TextRun, capabilities?: FontMeasureCapabilities): string;

package/dist/layout-engine/layout-bridge/src/remeasure.d.ts

@@ -1,4 +1,5 @@
 import { ParagraphBlock, ParagraphMeasure, ParagraphLineRegion } from '../../contracts/src/index.js';
+import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
 /** Drop cached text widths and the canvas context. Call when registered font faces may have changed. */
 export declare function clearRemeasureTextCaches(): void;
 /**
@@ -72,4 +73,4 @@ export declare function clearRemeasureTextCaches(): void;
  * // First line has only 170px available (200 - 30), subsequent lines have full 200px
  * ```
  */
-export declare function remeasureParagraph(block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[]): ParagraphMeasure;
+export declare function remeasureParagraph(block: ParagraphBlock, maxWidth: number, firstLineIndent?: number, lineRegions?: readonly (readonly ParagraphLineRegion[])[], fontContext?: FontMeasureContext): ParagraphMeasure;

package/dist/public/ui-react.cjs

@@ -157,16 +157,45 @@ function useSuperDocToolbar() {
 		copyFormatActive: false
 	});
 }
-/** Subscribe to a single command's enable/active state. */
+var EMPTY_COMMAND_STATE = {
+	enabled: false,
+	active: false,
+	supported: false
+};
+/** Subscribe to and execute one SuperDoc command. */
 function useSuperDocCommand(id) {
-	return useSuperDocSlice((ui) => ({
-		getSnapshot: () => ui.commands.get(id).getState(),
-		observe: (cb) => ui.commands.get(id).observe(cb)
-	}), {
-		enabled: false,
-		active: false,
-		supported: false
-	});
+	const ui = useSuperDocUI();
+	const [observed, setObserved] = (0, react.useState)(() => ({
+		id,
+		ui,
+		state: ui ? ui.commands.get(id).getState() : EMPTY_COMMAND_STATE
+	}));
+	(0, react.useEffect)(() => {
+		if (!ui) {
+			setObserved({
+				id,
+				ui,
+				state: EMPTY_COMMAND_STATE
+			});
+			return;
+		}
+		const command = ui.commands.get(id);
+		const publish = (state) => setObserved({
+			id,
+			ui,
+			state
+		});
+		publish(command.getState());
+		return command.observe(publish);
+	}, [id, ui]);
+	const state = observed.id === id && observed.ui === ui ? observed.state : ui ? ui.commands.get(id).getState() : EMPTY_COMMAND_STATE;
+	const execute = (0, react.useCallback)((payload) => ui ? ui.commands.execute(id, payload) : false, [id, ui]);
+	const executeAsync = (0, react.useCallback)((payload) => ui ? ui.commands.executeAsync(id, payload) : Promise.resolve(false), [id, ui]);
+	return {
+		...state,
+		execute,
+		executeAsync
+	};
 }
 /** Subscribe to the document slice. */
 function useSuperDocDocument() {

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

@@ -156,16 +156,45 @@ function useSuperDocToolbar() {
 		copyFormatActive: false
 	});
 }
-/** Subscribe to a single command's enable/active state. */
+var EMPTY_COMMAND_STATE = {
+	enabled: false,
+	active: false,
+	supported: false
+};
+/** Subscribe to and execute one SuperDoc command. */
 function useSuperDocCommand(id) {
-	return useSuperDocSlice((ui) => ({
-		getSnapshot: () => ui.commands.get(id).getState(),
-		observe: (cb) => ui.commands.get(id).observe(cb)
-	}), {
-		enabled: false,
-		active: false,
-		supported: false
-	});
+	const ui = useSuperDocUI();
+	const [observed, setObserved] = useState(() => ({
+		id,
+		ui,
+		state: ui ? ui.commands.get(id).getState() : EMPTY_COMMAND_STATE
+	}));
+	useEffect(() => {
+		if (!ui) {
+			setObserved({
+				id,
+				ui,
+				state: EMPTY_COMMAND_STATE
+			});
+			return;
+		}
+		const command = ui.commands.get(id);
+		const publish = (state) => setObserved({
+			id,
+			ui,
+			state
+		});
+		publish(command.getState());
+		return command.observe(publish);
+	}, [id, ui]);
+	const state = observed.id === id && observed.ui === ui ? observed.state : ui ? ui.commands.get(id).getState() : EMPTY_COMMAND_STATE;
+	const execute = useCallback((payload) => ui ? ui.commands.execute(id, payload) : false, [id, ui]);
+	const executeAsync = useCallback((payload) => ui ? ui.commands.executeAsync(id, payload) : Promise.resolve(false), [id, ui]);
+	return {
+		...state,
+		execute,
+		executeAsync
+	};
 }
 /** Subscribe to the document slice. */
 function useSuperDocDocument() {

package/dist/shared/font-system/src/index.d.ts

@@ -15,7 +15,7 @@
  */
 export type { FontLoadStatus, FontFaceSource, FontFaceDescriptor, RegisteredFace, RegisterFaceResult, FontLoadResult, FontLoadSummary, FontFaceRequest, FontFaceLoadResult, FontAssetUrlContext, FontAssetUrlResolver, RequiredFace, } from './types.js';
 export { SETTLED_STATUSES, isSettled } from './types.js';
-export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureContext, ResolvePhysicalFamily, } from './resolver.js';
+export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureCapabilities, FontMeasureContext, FontMeasureFace, ResolvePhysicalFamily, ResolveNaturalLineMultiplier, } from './resolver.js';
 export { FontResolver, createFontResolver, insertFontFamilyBeforeGeneric } from './resolver.js';
 export { resolveFontFamily, resolvePhysicalFamily, resolvePrimaryPhysicalFamily, resolvePhysicalFamilies, resolveFace, DEFAULT_FONT_MEASURE_CONTEXT, } from './resolver.js';
 export { getFontConfigVersion, bumpFontConfigVersion, __resetFontConfigVersion } from './epoch.js';
@@ -26,6 +26,8 @@ export type { FontResolutionRecord, ResolvedFontEvidence, UsedFace } from './rep
 export { buildFontReport, buildFaceReport } from './report.js';
 export type { EmbeddingPolicy } from './os2.js';
 export { parseEmbeddingPolicy } from './os2.js';
+export type { SfntNaturalLineMetrics } from './natural-line-metrics.js';
+export { parseSfntNaturalLineMetrics } from './natural-line-metrics.js';
 export type { UnicodeCoverage, UnicodeRange } from './unicode-coverage.js';
 export { parseUnicodeCoverage, textForUnicodeCoverage, unicodeCoverageIncludes } from './unicode-coverage.js';
 export { CORE_SYMBOL_FALLBACK_COVERAGE, CORE_SYMBOL_FALLBACK_FAMILY, installCoreSymbolFallback, textForCoreSymbolFallback, } from './core-symbol-fallback.js';

package/dist/shared/font-system/src/natural-line-metrics.d.ts

@@ -0,0 +1,11 @@
+export interface SfntNaturalLineMetrics {
+    unitsPerEm: number;
+    lineHeightUnits: number;
+    lineHeightMultiplier: number;
+    source: 'os2-typo' | 'legacy-win-hhea';
+}
+/**
+ * Read a static SFNT face's design-unit baseline pitch without consulting browser font state.
+ * Variable fonts fail closed until their MVAR/axis instance can be applied to these metrics.
+ */
+export declare function parseSfntNaturalLineMetrics(bytes: ArrayBuffer | ArrayBufferView): SfntNaturalLineMetrics | null;

package/dist/shared/font-system/src/resolver.d.ts

@@ -190,6 +190,8 @@ export declare function resolveFace(logicalFamily: string, face: FaceKey, hasFac
  * never mapped onto a Bold/Italic run it cannot render unless the evidence explicitly allows it.
  */
 export type ResolvePhysicalFamily = (cssFontFamily: string, face: FaceKey) => string;
+/** Resolve a loaded physical face's deterministic baseline-pitch ratio for the given run text. */
+export type ResolveNaturalLineMultiplier = (cssFontFamily: string, face: FaceKey, text: string) => number | undefined;
 /**
  * The per-document font identity that every measure and paint path needs, carried as ONE value so
  * the resolver and its signature cannot travel separately and drift:
@@ -207,8 +209,20 @@ export type ResolvePhysicalFamily = (cssFontFamily: string, face: FaceKey) => st
  */
 export interface FontMeasureContext {
     resolvePhysical: ResolvePhysicalFamily;
+    resolveNaturalLineMultiplier?: ResolveNaturalLineMultiplier;
     fontSignature: string;
 }
+/** Font face inputs whose measured digit advances can affect layout reuse. */
+export interface FontMeasureFace {
+    family: string;
+    sizePx: number;
+    weight: FaceKey['weight'];
+    style: FaceKey['style'];
+}
+/** Immutable, invocation-scoped facts established by the active measurement surface. */
+export interface FontMeasureCapabilities {
+    hasTabularDigits(face: FontMeasureFace): boolean;
+}
 /**
  * The global-resolver / empty-signature context. The behavior-preserving default for outer entry
  * points and non-document callers (tests, the global measure path). Frozen so a stray

package/dist/style.css

@@ -1818,11 +1818,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-01062725] {
+.superdoc[data-v-770204b4] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-01062725] {
+.sd-visually-hidden[data-v-770204b4] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1833,14 +1833,14 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.superdoc__mutation-status[data-v-01062725] {
+.superdoc__mutation-status[data-v-770204b4] {
   position: sticky;
   z-index: 10;
   top: 12px;
   height: 0;
   pointer-events: none;
 }
-.superdoc__edit-rejected-status[data-v-01062725] {
+.superdoc__edit-rejected-status[data-v-770204b4] {
   position: absolute;
   top: 0;
   left: 50%;
@@ -1858,30 +1858,30 @@ img[data-v-c95b2073] {
   line-height: 20px;
   pointer-events: none;
 }
-.right-sidebar[data-v-01062725] {
+.right-sidebar[data-v-770204b4] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-01062725] {
+.floating-comments[data-v-770204b4] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-01062725] {
+.superdoc__layers[data-v-770204b4] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-01062725] {
+.superdoc__document[data-v-770204b4] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-01062725] {
+.superdoc__sub-document[data-v-770204b4] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-01062725] {
+.superdoc__selection-layer[data-v-770204b4] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1892,13 +1892,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-01062725] {
+.superdoc__whiteboard-layer[data-v-770204b4] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-01062725] {
+.superdoc__temp-selection[data-v-770204b4] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-01062725] {
+.superdoc__right-sidebar[data-v-770204b4] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1906,7 +1906,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-01062725] {
+.superdoc__compact-comment-popover[data-v-770204b4] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1915,14 +1915,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-01062725] {
+.tools[data-v-770204b4] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-01062725] {
+.tools-item[data-v-770204b4] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1933,10 +1933,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-01062725] {
+.tools-item i[data-v-770204b4] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-01062725] {
+.superdoc__tools-icon[data-v-770204b4] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1951,22 +1951,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-01062725] {
+.superdoc .superdoc__layers[data-v-770204b4] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-01062725] {
+.superdoc__sub-document[data-v-770204b4] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-01062725] {
+.superdoc__right-sidebar[data-v-770204b4] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-01062725] {
+.ai-writer-container[data-v-770204b4] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1982,10 +1982,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-01062725] {
+.ai-tool > svg[data-v-770204b4] {
   fill: transparent;
 }
-.ai-tool[data-v-01062725]::before {
+.ai-tool[data-v-770204b4]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2006,7 +2006,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-01062725]:hover::before {
+.ai-tool[data-v-770204b4]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -1818,11 +1818,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-01062725] {
+.superdoc[data-v-770204b4] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-01062725] {
+.sd-visually-hidden[data-v-770204b4] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1833,14 +1833,14 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.superdoc__mutation-status[data-v-01062725] {
+.superdoc__mutation-status[data-v-770204b4] {
   position: sticky;
   z-index: 10;
   top: 12px;
   height: 0;
   pointer-events: none;
 }
-.superdoc__edit-rejected-status[data-v-01062725] {
+.superdoc__edit-rejected-status[data-v-770204b4] {
   position: absolute;
   top: 0;
   left: 50%;
@@ -1858,30 +1858,30 @@ img[data-v-c95b2073] {
   line-height: 20px;
   pointer-events: none;
 }
-.right-sidebar[data-v-01062725] {
+.right-sidebar[data-v-770204b4] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-01062725] {
+.floating-comments[data-v-770204b4] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-01062725] {
+.superdoc__layers[data-v-770204b4] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-01062725] {
+.superdoc__document[data-v-770204b4] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-01062725] {
+.superdoc__sub-document[data-v-770204b4] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-01062725] {
+.superdoc__selection-layer[data-v-770204b4] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1892,13 +1892,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-01062725] {
+.superdoc__whiteboard-layer[data-v-770204b4] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-01062725] {
+.superdoc__temp-selection[data-v-770204b4] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-01062725] {
+.superdoc__right-sidebar[data-v-770204b4] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1906,7 +1906,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-01062725] {
+.superdoc__compact-comment-popover[data-v-770204b4] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1915,14 +1915,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-01062725] {
+.tools[data-v-770204b4] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-01062725] {
+.tools-item[data-v-770204b4] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1933,10 +1933,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-01062725] {
+.tools-item i[data-v-770204b4] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-01062725] {
+.superdoc__tools-icon[data-v-770204b4] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1951,22 +1951,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-01062725] {
+.superdoc .superdoc__layers[data-v-770204b4] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-01062725] {
+.superdoc__sub-document[data-v-770204b4] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-01062725] {
+.superdoc__right-sidebar[data-v-770204b4] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-01062725] {
+.ai-writer-container[data-v-770204b4] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1982,10 +1982,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-01062725] {
+.ai-tool > svg[data-v-770204b4] {
   fill: transparent;
 }
-.ai-tool[data-v-01062725]::before {
+.ai-tool[data-v-770204b4]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2006,7 +2006,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-01062725]:hover::before {
+.ai-tool[data-v-770204b4]:hover::before {
   filter: brightness(1.3);
 }
 

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

@@ -3213,11 +3213,26 @@ export interface SuperDocExceptionRestorePayload {
  * re-emit path forwards `originalException?.editor ?? null`, so
  * consumers may receive `null` (not just `undefined`).
  */
+export interface SuperDocWorkerFailureDetail {
+    phase: string;
+    reason: string;
+    beforeHello: boolean;
+    message: string;
+    elapsedMs?: number;
+    errorName?: string;
+    errorMessage?: string;
+    errorStack?: string;
+    filename?: string;
+    lineno?: number;
+    colno?: number;
+}
 export interface SuperDocExceptionEditorPayload {
     error: unknown;
     editor?: Editor | null;
     code?: string;
     documentId?: string | null;
+    /** Structured browser-worker failure detail when editor startup failed in its worker transport. */
+    workerFailure?: SuperDocWorkerFailureDetail;
 }
 /**
  * Exception payload raised by the built-in toolbar.