superdoc 2.6.0-next.9 → 2.6.1-next.1

package/dist/chunks/{create-super-doc-ui-Bom7oDPv.cjs → create-super-doc-ui-CwCvqMOa.cjs}

@@ -5509,9 +5509,18 @@ function createSuperDocUI(options) {
 				const entry = readListApplyStateEntry();
 				const shippedStatus = typeof entry?.shippedStatus === "string" ? entry.shippedStatus : null;
 				const supported = shippedStatus !== "not-shipped" && shippedStatus !== "disabled";
+				const enabled = supported && (typeof entry?.enabled === "boolean" ? entry.enabled : true);
+				const activeSeed = supported ? readListActiveSeed(entry) : null;
+				if (readonly) return normalizeCommandState({
+					enabled: false,
+					active: activeSeed === listKind,
+					supported,
+					value: entry?.value,
+					reason: SUPERDOC_UI_REASONS.documentReadonly
+				}, "builtin");
 				return normalizeCommandState({
-					enabled: supported && (typeof entry?.enabled === "boolean" ? entry.enabled : true),
-					active: (supported ? readListActiveSeed(entry) : null) === listKind,
+					enabled,
+					active: activeSeed === listKind,
 					supported,
 					value: entry?.value
 				}, "builtin");
@@ -8154,6 +8163,7 @@ function createSuperDocUI(options) {
 		}
 		const listKind = listToggleKind(id);
 		if (listKind) {
+			if (readDocumentMode() === "viewing") return false;
 			if (typeof (getEditCommands()?.lists)?.apply === "function") return executeListToggleCommand(listKind, payload);
 		}
 		const trackCommand = trackDecisionCommand(id);

package/dist/chunks/{create-super-doc-ui-DbzVC0rr.es.js → create-super-doc-ui-DCjm-_Xo.es.js}

@@ -5509,9 +5509,18 @@ function createSuperDocUI(options) {
 				const entry = readListApplyStateEntry();
 				const shippedStatus = typeof entry?.shippedStatus === "string" ? entry.shippedStatus : null;
 				const supported = shippedStatus !== "not-shipped" && shippedStatus !== "disabled";
+				const enabled = supported && (typeof entry?.enabled === "boolean" ? entry.enabled : true);
+				const activeSeed = supported ? readListActiveSeed(entry) : null;
+				if (readonly) return normalizeCommandState({
+					enabled: false,
+					active: activeSeed === listKind,
+					supported,
+					value: entry?.value,
+					reason: SUPERDOC_UI_REASONS.documentReadonly
+				}, "builtin");
 				return normalizeCommandState({
-					enabled: supported && (typeof entry?.enabled === "boolean" ? entry.enabled : true),
-					active: (supported ? readListActiveSeed(entry) : null) === listKind,
+					enabled,
+					active: activeSeed === listKind,
 					supported,
 					value: entry?.value
 				}, "builtin");
@@ -8154,6 +8163,7 @@ function createSuperDocUI(options) {
 		}
 		const listKind = listToggleKind(id);
 		if (listKind) {
+			if (readDocumentMode() === "viewing") return false;
 			if (typeof (getEditCommands()?.lists)?.apply === "function") return executeListToggleCommand(listKind, payload);
 		}
 		const trackCommand = trackDecisionCommand(id);

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.6.0-next.9",
+	superdocVersion: "2.6.1-next.1",
 	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.6.0-next.9",
+	superdocVersion: "2.6.1-next.1",
 	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/graphic-placement.d.ts

@@ -28,6 +28,19 @@ export declare function isPagePositionedParagraphFrame(frame: {
     vAnchor: 'page';
     y: number;
 };
+export declare function isPagePositionedFloatingTable<T extends {
+    kind?: string;
+    anchor?: {
+        isAnchored?: boolean;
+        vRelativeFrom?: string;
+    };
+}>(block: T | undefined): block is T & {
+    kind: 'table';
+    anchor: {
+        isAnchored: true;
+        vRelativeFrom: 'page';
+    };
+};
 /**
  * Resolve the page-space origin used for page-anchored paragraph frames in a footer.
  * Invalid or negative bottom margins behave like a zero margin.

package/dist/layout-engine/contracts/src/header-footer-resolution.d.ts

@@ -24,5 +24,19 @@ export type HeaderFooterEffectiveRefResult = {
     matchedSectionIndex: number;
     matchedVariant: HeaderFooterVariant;
 };
+/**
+ * Ordered, snapshot-backed resolver for repeated header/footer lookups.
+ * Runtime section updates must go through `updateSection` so cached inherited
+ * results cannot outlive a reference change.
+ */
+export declare class HeaderFooterResolutionIndex {
+    #private;
+    constructor(sections: readonly HeaderFooterResolutionSection[]);
+    get revision(): number;
+    hasAny(kind: HeaderFooterKind): boolean;
+    resolve(sectionIndex: number, kind: HeaderFooterKind, variant: HeaderFooterVariant): HeaderFooterEffectiveRefResult | null;
+    updateSection(section: HeaderFooterResolutionSection): boolean;
+}
+export declare function createHeaderFooterResolutionIndex(sections: readonly HeaderFooterResolutionSection[]): HeaderFooterResolutionIndex;
 export declare function selectHeaderFooterVariantForPage({ documentPageNumber, sectionPageNumber, titlePg, alternateHeaders, }: HeaderFooterVariantSelectionInput): HeaderFooterVariant | null;
 export declare function resolveEffectiveHeaderFooterRef({ sections, sectionIndex, kind, variant, }: HeaderFooterEffectiveRefInput): HeaderFooterEffectiveRefResult | null;

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

@@ -10,7 +10,7 @@ export type { BaseDirection, WritingMode, SectionDirectionContext, TableDirectio
 export { getParagraphInlineDirection, getTableVisualDirection } from './direction-context.js';
 export { OOXML_PCT_DIVISOR, resolveTableWidthAttr, type TableWidthAttr, type TableColumnSpec, } from './engines/tables.js';
 export { effectiveTableCellSpacing } from './table-cell-spacing.js';
-export { selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
+export { createHeaderFooterResolutionIndex, selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterResolutionIndex, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
 export { rescaleColumnWidths } from './table-column-rescale.js';
 export { getCellSpacingPx } from './cell-spacing.js';
 export { normalizeZIndex, coerceRelativeHeight, isPlainObject, OOXML_Z_INDEX_BASE, resolveFloatingZIndex, getFragmentZIndex, } from './ooxml-z-index.js';
@@ -18,7 +18,7 @@ export { shouldApplyJustify, calculateJustifySpacing, getFirstLineIndentOffset,
 export { parseInsetClipPathForScale, formatInsetClipPathTransform, type InsetClipPathScale, } from './clip-path-inset.js';
 export { SUBSCRIPT_SUPERSCRIPT_SCALE, normalizeBaselineShift, hasExplicitBaselineShift, isSuperscriptOrSubscript, usesDefaultScriptLayout, scaleFontSizeForVerticalText, resolveBaseFontSizeForVerticalText, type VerticalTextAlign, } from './vertical-text.js';
 export { computeFragmentPmRange, computeLinePmRange, type LinePmRange } from './pm-range.js';
-export { resolveAnchoredGraphicY, resolveAnchoredGraphicX, resolveFooterPageFrameOriginY, isPositionedParagraphFrame, isPagePositionedParagraphFrame, isAnchorHRelative, isAnchorVRelative, isAnchorAlignH, isAnchorAlignV, ANCHOR_H_RELATIVE_VALUES, ANCHOR_V_RELATIVE_VALUES, ANCHOR_H_ALIGN_VALUES, ANCHOR_V_ALIGN_VALUES, type ColumnLayoutForAnchor, type ResolveAnchoredGraphicYInput, type ResolveAnchoredGraphicXContext, type AnchorHRelative, type AnchorVRelative, type AnchorAlignH, type AnchorAlignV, } from './graphic-placement.js';
+export { resolveAnchoredGraphicY, resolveAnchoredGraphicX, resolveFooterPageFrameOriginY, isPositionedParagraphFrame, isPagePositionedParagraphFrame, isPagePositionedFloatingTable, isAnchorHRelative, isAnchorVRelative, isAnchorAlignH, isAnchorAlignV, ANCHOR_H_RELATIVE_VALUES, ANCHOR_V_RELATIVE_VALUES, ANCHOR_H_ALIGN_VALUES, ANCHOR_V_ALIGN_VALUES, type ColumnLayoutForAnchor, type ResolveAnchoredGraphicYInput, type ResolveAnchoredGraphicXContext, type AnchorHRelative, type AnchorVRelative, type AnchorAlignH, type AnchorAlignV, } from './graphic-placement.js';
 export { LAYOUT_BOUNDARY_SCHEMA, bodyStoryLocator, namedStoryLocator, computeLayoutFragmentId, buildLayoutSourceIdentity, buildLayoutSourceIdentityForFragment, } from './layout-identity.js';
 export type { LayoutBlockRef, LayoutFragmentId, LayoutPartialRowIdentity, LayoutSourceIdentity, LayoutStoryKind, LayoutStoryLocator, } from './layout-identity.js';
 export { LAYOUT_SEGMENT_GEOMETRY_SCHEMA } from './segment-geometry.js';
@@ -538,6 +538,8 @@ export type ImageRun = {
     placeholder?: RenderPlaceholder;
     /** DrawingML docPr/@id of the picture (used to target the Document API for interactive resize). */
     imageId?: string;
+    /** Opaque Document API identity when projection can resolve it without a catalog read. */
+    imageMutationId?: string;
     /** Clip-path value for cropped images. */
     clipPath?: string;
     /** DrawingML picture frame; paint-only and excluded from layout sizing. */
@@ -932,6 +934,8 @@ export type ImageBlock = {
     placeholder?: RenderPlaceholder;
     /** DrawingML docPr/@id of the picture (used to target the Document API for interactive resize). */
     imageId?: string;
+    /** Opaque Document API identity when projection can resolve it without a catalog read. */
+    imageMutationId?: string;
     objectFit?: 'contain' | 'cover' | 'fill' | 'scale-down';
     display?: 'inline' | 'block';
     padding?: BoxSpacing;
@@ -2600,6 +2604,8 @@ export type PartialRowInfo = {
 export type TableFragment = {
     kind: 'table';
     blockId: BlockId;
+    /** True when this fragment was emitted by floating-table placement. */
+    isAnchored?: boolean;
     /** Flow column that owns this fragment, distinct from visual x when overflow crosses margins. */
     columnIndex?: number;
     fromRow: number;

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

@@ -46,6 +46,10 @@ export type MeasureCacheStats = {
      */
     memorySizeEstimate: number;
 };
+declare const preparedMeasureCacheKeyBrand: unique symbol;
+export type PreparedMeasureCacheKey = string & {
+    readonly [preparedMeasureCacheKeyBrand]: true;
+};
 /**
  * LRU-enhanced MeasureCache
  *
@@ -77,6 +81,12 @@ export declare class MeasureCache<T> {
      * @returns The cached value or undefined
      */
     get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): 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;
+    getPrepared(key: PreparedMeasureCacheKey | undefined): T | undefined;
     /**
      * Store a measure in the cache for the given block and dimensions.
      * Silently returns if the block is null/undefined or lacks an ID.
@@ -87,6 +97,7 @@ export declare class MeasureCache<T> {
      * @param value - The value to cache
      */
     set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string): void;
+    setPrepared(key: PreparedMeasureCacheKey | undefined, blockId: string | undefined, value: T): void;
     /**
      * Invalidates cached measurements for specific block IDs.
      * Removes all cache entries whose keys start with any of the provided block IDs.
@@ -144,3 +155,4 @@ export declare class MeasureCache<T> {
      */
     private composeKey;
 }
+export {};

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

@@ -95,6 +95,10 @@ export type IncrementalLayoutBridgeTiming = {
     /** Union wall time spent inside caller-owned measure callbacks across body and furniture. */
     measureCallbackWallMs: number;
     measureCacheLookupMs: number;
+    /** Body-measure cache insertion wall time, including content-key composition. */
+    measureCacheWriteMs: number;
+    /** Previous-measure content-adoption lookup/build wall time. */
+    measureContentAdoptionMs: number;
     measureActualMs: number;
     headerFooterPreLayoutMs: number;
     headerPreLayoutMs: number;
@@ -104,6 +108,14 @@ export type IncrementalLayoutBridgeTiming = {
     layoutDocumentMs: number;
     /** Initial body-layout wrapper work outside `layoutDocument` (proof, slice, convergence, splice). */
     layoutReuseOrchestrationMs: number;
+    /** Initial pagination invocation including bridge reuse orchestration. */
+    paginationInitialMs: number;
+    /** Body page-token convergence pagination only. */
+    paginationPageTokenMs: number;
+    /** Footnote convergence pagination only; overlaps `footnoteMs`. */
+    paginationFootnoteMs: number;
+    /** All initial, page-token, and footnote pagination invocation wall time. */
+    paginationTotalMs: number;
     paginationMs: number;
     pageTokenSetupMs: number;
     pageTokenTotalMs: number;
@@ -116,8 +128,16 @@ export type IncrementalLayoutBridgeTiming = {
     unattributedMs: number;
     counters: {
         blocksRead: number;
+        blocksByKind?: Record<FlowBlock['kind'], number>;
+        bodyBlocksMeasuredByKind: Record<FlowBlock['kind'], number>;
         cacheHits: number;
         cacheMisses: number;
+        bodyMeasureCacheReads: number;
+        bodyMeasureCacheWrites: number;
+        bodyMeasureCacheKeyComputations: number;
+        measureContentSignatureComputations: number;
+        fontSignaturePresent: number;
+        fontSignatureChanged: number;
         measuresAdopted: number;
         pagesPaginated: number | null;
         pagesSplicedByReuse: number;

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

@@ -331,8 +331,9 @@ export declare function layoutDocumentRange(input: LayoutRangeInput): LayoutRang
  * transformations and computing the actual height required by visible content.
  *
  * When `kind` and `constraints.pageHeight` are provided, page-relative and
- * margin-relative anchored drawings are post-normalized from the synthetic
- * measurement canvas to header/footer-local coordinates.
+ * margin-relative anchored drawings and page-relative floating footer tables
+ * are post-normalized from the synthetic measurement canvas to
+ * header/footer-local coordinates.
  *
  * Returns separate measurement bounds (for pagination) and render bounds
  * (for overlay shift). See the Coordinate Contract in the fix plan for details.

package/dist/layout-engine/layout-engine/src/normalize-header-footer-fragments.d.ts

@@ -32,9 +32,9 @@ export type RegionConstraints = {
  * offset so they do not inflate the reserved header height by carrying
  * body-canvas coordinates.
  *
- * Page-anchored paragraph frames are likewise converted from physical-page
- * coordinates; other paragraphs, inline images, and absolute overlays pass
- * through unchanged.
+ * Page-anchored paragraph frames and floating footer tables are likewise
+ * converted from physical-page coordinates; other paragraphs, inline images,
+ * and absolute overlays pass through unchanged.
  */
 export declare function normalizeFragmentsForRegion(pages: Array<{
     number: number;

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-Bom7oDPv.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.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-DbzVC0rr.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.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-Bom7oDPv.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CwCvqMOa.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-DbzVC0rr.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCjm-_Xo.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };