superdoc 2.5.1 → 2.6.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.5.1",
+	superdocVersion: "2.6.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.5.1",
+	superdocVersion: "2.6.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

@@ -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;
@@ -2807,7 +2811,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, } from './run-helpers.js';
+export { expandRunsForInlineNewlines, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, 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 { PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

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

@@ -21,3 +21,13 @@ export declare function expandRunsForInlineNewlines(runs: Run[]): Run[];
  * @returns Array of runs present in the line
  */
 export declare function sliceRunsForLine(block: FlowBlock, line: Line): Run[];
+/**
+ * Whether a line's text must be painted from measured segment coordinates.
+ *
+ * Explicit tab coordinates require positioned painting. Horizontally scaled
+ * text does as well because browser inline flow cannot preserve the measured
+ * advance after `scaleX`. Keeping this decision in the shared contracts layer
+ * prevents the resolver and painter from disagreeing about whether paragraph
+ * indentation is represented by CSS or by the segments' absolute X values.
+ */
+export declare function usesPositionedTextGeometry(line: Line, runsForLine: Run[], isRtl: boolean): boolean;

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

@@ -59,11 +59,13 @@ export type MeasureCacheStats = {
  * Performance characteristics:
  * - get(): O(1) - Map lookup + delete + re-insert for LRU tracking
  * - set(): O(1) - eviction (delete first key) + insert
- * - invalidate(): O(n) - where n = number of keys matching blockId prefix
+ * - invalidate(): O(k) - where k = cached variants for the requested block IDs
  * - Memory: Bounded at 10K entries ~= 50-100MB
  */
 export declare class MeasureCache<T> {
     private cache;
+    private keysByBlockId;
+    private blockIdByKey;
     private stats;
     /**
      * Retrieve a cached measure for the given block and dimensions.
@@ -130,6 +132,7 @@ export declare class MeasureCache<T> {
      * Update size statistics
      */
     private updateSizeStats;
+    private deleteKey;
     /**
      * Composes a cache key from block properties and dimensions.
      * Validates and clamps dimensions to prevent memory exhaustion.

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

@@ -1,4 +1,4 @@
-import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, Measure, HeaderFooterLayout, ColumnLayout } from '../../contracts/src/index.js';
+import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, LayoutBlockResumeCheckpoint, Measure, HeaderFooterLayout, ColumnLayout } from '../../contracts/src/index.js';
 import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
 import { LayoutOptions, HeaderFooterConstraints, LayoutExecutionCheckpoint } from '../../layout-engine/src/index.js';
 import { computeDirtyRegions } from './diff.js';
@@ -353,6 +353,11 @@ export declare function incrementalLayout(previousBlocks: FlowBlock[], _previous
         measures: Measure[];
     };
 }, layoutReuse?: IncrementalLayoutReuseOptions, measureReuseProof?: IncrementalMeasureReuseProof, execution?: IncrementalLayoutExecutionControl): Promise<IncrementalLayoutResult>;
+export declare function __test_only_splicedCheckpointStats(map: ReadonlyMap<string, LayoutBlockResumeCheckpoint> | undefined): {
+    pieceCount: number;
+    sourceCount: number;
+    maximumTransformTreeDepth: number;
+} | null;
 /**
  * Normalizes a margin value, using a fallback for undefined or non-finite values.
  * Prevents NaN content sizes when margin properties are partially defined.

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

@@ -5,6 +5,7 @@ export type FootnoteAnchorIndexInput = {
     refs?: Array<{
         id: string;
         pos: number;
+        blockId?: string;
     }>;
     bodyHeightById?: Map<string, number>;
     firstLineHeightById?: Map<string, number>;

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

@@ -71,6 +71,13 @@ export type ParagraphLayoutContext = {
      * vertical layout height.
      */
     layoutOnlyAnchorCarrier?: boolean;
+    /**
+     * Keep positioned objects on the page that owns this zero-height carrier.
+     * A carrier immediately before a forcing sectPr belongs to the preceding
+     * section; moving its object for page-fit would insert an extra page before
+     * the section break and detach it from its authored paragraph anchor.
+     */
+    preserveAnchorCarrierPage?: boolean;
     /**
      * True when a split line-break carrier carries paragraph spacing that should
      * remain in the flow. The carrier reserves one line plus spacing instead of

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

@@ -10,6 +10,7 @@ export type ParagraphLineIndentationParams = {
     continuesFromPrev?: boolean;
     suppressFirstLineIndent: boolean;
     resetContinuationTextIndent?: boolean;
+    positionedTextGeometry?: boolean;
 };
 export declare const hasExplicitSegmentPositioning: (line: Line) => boolean;
 export declare const applyParagraphLineIndentation: (params: ParagraphLineIndentationParams) => void;

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

@@ -229,9 +229,14 @@ export type PaintSnapshot = {
     pages: PaintSnapshotPage[];
     entities: PaintSnapshotEntities;
 };
+type PainterFragmentFailure = {
+    readonly blockId: string;
+    readonly code: 'painter-fragment-unavailable';
+};
 type PersistentPagePainterTransaction = {
     commit(): void;
     rollback(): void;
+    readFragmentFailures(): readonly PainterFragmentFailure[];
 };
 /**
  * DOM-based document painter that renders layout fragments to HTML elements.
@@ -478,14 +483,6 @@ export declare class DomPainter {
      * @returns HTMLElement containing the rendered fragment or error placeholder
      */
     private renderParagraphFragment;
-    /**
-     * Creates an error placeholder element for failed fragment renders.
-     * Prevents entire paint operation from failing due to single fragment error.
-     *
-     * @param blockId - The block ID that failed to render
-     * @param error - The error that occurred
-     * @returns HTMLElement showing the error
-     */
     private createErrorPlaceholder;
     private renderImageFragment;
     /**
@@ -628,6 +625,7 @@ export declare class DomPainter {
      *                  Selects the wrapper's section-scoped identity and legacy PM attributes.
      */
     private updateFragmentElement;
+    private applyRenderDiagnosticFragmentFrame;
     /**
      * Applies fragment positioning, dimensions, and metadata to an HTML element.
      *