@betteroffice/docx 0.4.1 → 0.4.2

package/dist/editor/index.d.mts

@@ -1,21 +1,23 @@
 import { R as ResidentMeasurementConfig } from '../rustMeasureSource-BkCx1FDx.mjs';
-import { L as Layout, a as LayoutOptions } from '../types-Buyw6dFd.mjs';
+import { L as Layout, a as LayoutOptions } from '../types-Cz7S77Ut.mjs';
 import { MeasuredBlock } from '../layout/pagination/index.mjs';
-import { D as DisplayListHeadersFooters } from '../rustDisplayList-DcaA5iok.mjs';
+import { D as DisplayListHeadersFooters } from '../rustDisplayList-B7uPoItK.mjs';
 import { Document } from '../types/document.mjs';
-import { Y as YrsSession, a as YrsRenderEnv } from '../index-yOtBET85.mjs';
-import { f as SectionProperties, N as NoteKind, g as DocumentBody } from '../content-BzoC6bSz.mjs';
+import { Y as YrsSession, a as YrsRenderEnv } from '../index-DzZVJC8-.mjs';
+import { f as SectionProperties, N as NoteKind, g as DocumentBody } from '../content-DSb-6a9T.mjs';
 import '../formatting-gqLFeJ9X.mjs';
-import '../frameDelta-ByU7HBuB.mjs';
+import '../frameDelta-CLeO7K5z.mjs';
 import '../styles-AryxLAhx.mjs';
 import '../pagedExport-BmSlEhoP.mjs';
 import '../loadWasmAsset-Cr95TImt.mjs';
-import '../rezip-Bxiq4Z_R.mjs';
 import '../plugin-api/index.mjs';
+import '../rezip-Bxiq4Z_R.mjs';
 import '../docx/wrapTypes.mjs';
 
 interface ResidentRegionLayoutRequest {
     bodyStory: 'body';
+    /** @internal Use saved page totals while the layout is partial. */
+    cachedPageTotals?: boolean;
     options: Pick<LayoutOptions, 'contractVersion' | 'pageGap'>;
     regions: {
         sections: Array<{
@@ -41,6 +43,8 @@ interface ComputeLayoutInputs {
     session: Pick<YrsSession, 'layoutDocumentWithRegionsRetainedJson' | 'residentWorkerProbe' | 'retainedKernelInputsJson'>;
     renderEnv: YrsRenderEnv;
     measurement: ResidentMeasurementConfig;
+    /** @internal See `ResidentRegionLayoutRequest.cachedPageTotals`. */
+    cachedPageTotals?: boolean;
 }
 interface LayoutComputation {
     layout: Layout;

package/dist/editor/index.mjs

@@ -1 +1 @@
-export{c as buildResidentRegionLayoutRequest,e as computeLayout,d as getLayoutKernelInputs,a as resolvedFinalSectionProperties,b as updateFinalSectionProperties,f as workerLayoutComputation}from'../chunk-NVN26RHH.mjs';import'../chunk-TTRUPDAB.mjs';
+export{c as buildResidentRegionLayoutRequest,e as computeLayout,d as getLayoutKernelInputs,a as resolvedFinalSectionProperties,b as updateFinalSectionProperties,f as workerLayoutComputation}from'../chunk-MLEMGJP7.mjs';import'../chunk-TTRUPDAB.mjs';

package/dist/{frameDelta-ByU7HBuB.d.mts → frameDelta-CLeO7K5z.d.mts}

@@ -1,5 +1,5 @@
 import { T as TextModernEffects } from './formatting-gqLFeJ9X.mjs';
-import { D as DrawingScene, c as ShapeTextBodyProperties } from './content-BzoC6bSz.mjs';
+import { D as DrawingScene, c as ShapeTextBodyProperties } from './content-DSb-6a9T.mjs';
 
 interface DisplayList {
     /** Contract version. Undefined reads as legacy version 0. */
@@ -736,6 +736,7 @@ interface FramePagePositionShift {
     readonly fingerprint: bigint;
     readonly runs: readonly FramePositionShiftRun[];
     readonly anchors: readonly FrameNoteAnchor[];
+    readonly spanDelta?: number;
 }
 type FramePageOperation = FramePageUpsert | FramePageRemove | FramePageMove | FramePagePositionPatch | FramePagePositionShift;
 interface DecodedFrameDelta {
@@ -776,6 +777,8 @@ interface RetainedFrame {
  * browser state. Page payloads are typed values, not embedded JSON strings.
  */
 declare function decodeFrameDelta(input: Uint8Array | ArrayBuffer): DecodedFrameDelta;
+/** @internal Decode in resumable slices without publishing partial state. */
+declare function decodeFrameDeltaSteps(input: Uint8Array | ArrayBuffer): Generator<void, DecodedFrameDelta>;
 /** Apply one already-validated frame atomically, rejecting stale generations. */
 declare function applyFrameDelta(previous: RetainedFrame | null, delta: DecodedFrameDelta): RetainedFrame;
 /**
@@ -801,4 +804,4 @@ declare function displayPageRevision(page: DisplayPage): number;
  */
 declare function displayPageNoteAnchorRevision(page: DisplayPage): number;
 
-export { type DisplayList as D, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, type LinePrimitive as L, type PositionedGlyph as P, type RetainedFrame as R, type TextRunPrimitive as T, type DisplayPage as a, type DisplayPrimitive as b, type DecodedFrameDelta as c, type DecorationPrimitive as d, type DisplayBounds as e, type DocAttrs as f, FRAME_DELTA_PAGE_OP_BYTES as g, FRAME_DELTA_VERSION as h, FrameDeltaError as i, type FrameDeltaErrorCode as j, type FramePageOperation as k, type RectPrimitive as l, type RetainedFramePage as m, type TableCellRef as n, applyFrameDelta as o, applyFrameDeltaOwned as p, decodeFrameDelta as q, displayPageNoteAnchorRevision as r, displayPageRevision as s };
+export { type DisplayList as D, FRAME_DELTA_HEADER_BYTES as F, type GlyphRunPrimitive as G, type HfRegion as H, type ImagePrimitive as I, type LinePrimitive as L, type PositionedGlyph as P, type RetainedFrame as R, type TextRunPrimitive as T, type DisplayPage as a, type DisplayPrimitive as b, type DecodedFrameDelta as c, type DecorationPrimitive as d, type DisplayBounds as e, type DocAttrs as f, FRAME_DELTA_PAGE_OP_BYTES as g, FRAME_DELTA_VERSION as h, FrameDeltaError as i, type FrameDeltaErrorCode as j, type FramePageOperation as k, type RectPrimitive as l, type RetainedFramePage as m, type TableCellRef as n, applyFrameDelta as o, applyFrameDeltaOwned as p, decodeFrameDelta as q, decodeFrameDeltaSteps as r, displayPageNoteAnchorRevision as s, displayPageRevision as t };

package/dist/{index-yOtBET85.d.mts → index-DzZVJC8-.d.mts}

@@ -1,11 +1,11 @@
 import { C as ColorValue } from './formatting-gqLFeJ9X.mjs';
 import { Document, CompatibilityFlags } from './types/document.mjs';
 import { a0 as DocxEditSuggestion, a1 as DocxEditFailure, a2 as DocxEditFailureCode, a3 as DocxTextRange, a4 as DocxReadParagraphsRequest, a5 as DocxReadParagraphsResult, a6 as DocxFindTextRequest, a7 as DocxFindTextResult, a8 as DocxEditRequest, a9 as DocxValidationResult, aa as DocxEditResult, ab as DocxTextTarget, ac as DocxEditRefusal, a as DocxExportOptions, H as DocxExportResult, c as DocxStructuredContent, b as DocxMarkdownContent, d as DocxPageExportOptions, f as DocxPagedStructuredContent, i as DocxLayoutMap, g as DocxSnapshotLayoutMap, D as DocxExportFailure, V as DocxParagraphHeading, m as DocxContentControlsOptions, w as DocxContentControlsResult, l as DocxContentControlQuery } from './pagedExport-BmSlEhoP.mjs';
-import { R as RetainedFrame } from './frameDelta-ByU7HBuB.mjs';
+import { R as RetainedFrame } from './frameDelta-CLeO7K5z.mjs';
 import { a as WasmModuleMemory } from './loadWasmAsset-Cr95TImt.mjs';
-import { R as RepackOptions } from './rezip-Bxiq4Z_R.mjs';
-import { e as Comment } from './content-BzoC6bSz.mjs';
 import { PointPosition } from './plugin-api/index.mjs';
+import { B as BlockContent, e as Comment } from './content-DSb-6a9T.mjs';
+import { R as RepackOptions } from './rezip-Bxiq4Z_R.mjs';
 
 type CollaborationUpdateOrigin = 'local' | 'remote';
 interface CollaborationReplica {
@@ -110,6 +110,19 @@ interface RustParagraphIds {
         part: string;
         paraIds: Array<[number, string]>;
     }>;
+    /**
+     * Story parts written as their source bytes with only some paragraphs
+     * re-serialized: those whose `sourceOrdinal` is in `changed`, or whose
+     * written comments, revisions, notes or relationships differ from their
+     * source. `paragraphs` lists every `sourceOrdinal` the model holds for the
+     * part, `sha256` the source part it addresses.
+     */
+    splicedParts?: Array<{
+        part: string;
+        sha256: string;
+        paragraphs: number[];
+        changed: number[];
+    }>;
 }
 
 /**
@@ -241,8 +254,18 @@ type DocxParagraphAnchorResult = {
     status: 'unsupported';
     reason: 'foreign-session' | 'foreign-package' | 'no-source-package';
 };
-/** The paragraph IDs a session save applies, as the package writer's `paragraphIds`. @internal */
-type DocxParagraphSavePlan = RustParagraphIds;
+/**
+ * The paragraph IDs a session save applies, as the package writer's
+ * `paragraphIds`, with each spliced part's paragraphs as `[ordinal, session key]`. @internal
+ */
+interface DocxParagraphSavePlan extends Omit<RustParagraphIds, 'splicedParts'> {
+    splicedParts?: Array<{
+        part: string;
+        sha256: string;
+        paragraphs: Array<[number, string]>;
+        changed: number[];
+    }>;
+}
 
 /**
  * Host proposals: tracked changes a host proposes by paragraph anchor and search, grouped by the
@@ -381,6 +404,102 @@ declare function residentCaretDeviceRect(rect: Pick<YrsResidentCaretRect, 'x' |
 };
 declare function residentCaretSnapshotForFrame(snapshot: YrsResidentCaretSnapshot, frame: RetainedFrame): YrsResidentCaretSnapshot | null;
 
+type PositionReader = Pick<YrsSession, 'hasStory' | 'storySegments'>;
+type YrsLocProjection = Pick<YrsPositionProjection, 'positionForLoc'>;
+type YrsPositionOutline = Record<string, {
+    contentStart: number;
+    size: number;
+    paragraphs: Array<{
+        paraId: string;
+        displayStart: number;
+        length: number;
+        leading: number;
+    }>;
+}>;
+declare function createYrsLocProjectionFromOutline(outline: YrsPositionOutline): YrsLocProjection;
+/** @internal */
+interface YrsProjectedNode {
+    kind: string;
+    start: number;
+    nodeSize: number;
+    attrs: Record<string, unknown>;
+    story: string;
+}
+/** @internal */
+interface YrsProjectedTable extends YrsProjectedNode {
+    kind: 'table';
+    tableIndex: number;
+    widthsTwips: number[];
+    rowCount: number;
+    cells: YrsProjectedCell[];
+}
+/** @internal */
+interface YrsProjectedCell {
+    row: number;
+    column: number;
+    rowspan: number;
+    colspan: number;
+    story: string;
+    start: number;
+    contentStart: number;
+    nodeSize: number;
+    attrs: Record<string, unknown>;
+}
+/** @internal */
+interface YrsPointerProjectionTarget {
+    story: string;
+    displayPosition: number;
+    cell?: YrsCellLoc;
+}
+/** @internal */
+interface YrsStorySegmentSource {
+    segments(story: string): YrsStorySegment[];
+}
+/** @internal */
+declare function createYrsPositionProjection(session: PositionReader, rootStory: string, source?: YrsStorySegmentSource): YrsPositionProjection | null;
+/** @internal */
+declare function projectYrsDisplayPosition(position: number | PointPosition, getProjection: (rootStory: string) => YrsPositionProjection | null): YrsPointerProjectionTarget | null;
+/** @internal */
+declare class YrsPositionProjection {
+    readonly rootStory: string;
+    private readonly stories;
+    private readonly nodes;
+    private readonly tables;
+    private readonly source;
+    private readonly paragraphsById;
+    constructor(session: Pick<YrsSession, 'storySegments'>, rootStory: string, source?: YrsStorySegmentSource);
+    get size(): number;
+    nodeAt(position: number): YrsProjectedNode | null;
+    tableAtPosition(position: number): YrsProjectedTable | null;
+    tableAtStart(start: number): YrsProjectedTable | null;
+    tableStartForLoc(at: YrsCellLoc): number | null;
+    cellPosition(tableStart: number, row: number, column: number): number | null;
+    targetAt(position: number): YrsPointerProjectionTarget;
+    positionForLoc(loc: YrsLoc): number | null;
+    /** First paragraph for each paraId. */
+    private paragraphIndex;
+    bookmarkPosition(name: string): number | null;
+    private buildStory;
+    private inputPositionAt;
+    private buildTable;
+}
+/** @internal */
+declare function yrsLocToProjectedDisplayPosition(reader: Pick<YrsSession, 'hasStory' | 'paragraphSpans'>, projectionFor: (rootStory: string) => YrsLocProjection | null, loc: YrsLoc, activeRootStory?: string, inputMap?: (story: string) => YrsInputPositionMap | null): number | null;
+
+/** @internal */
+interface ResidentSearchMatch {
+    story: string;
+    paraId: string;
+    start: number;
+    displayFrom: number;
+    displayTo: number;
+}
+/** @internal */
+interface ResidentSearchResult {
+    matches: ResidentSearchMatch[];
+    carried: number;
+}
+
 /** @internal */
 interface AnchorResolutionFailure {
     ok: false;
@@ -392,7 +511,12 @@ interface AnchorResolutionFailure {
 /** @internal */
 type AnchorReader = Pick<YrsSession, 'resolveParagraphAnchor' | 'hasStory' | 'paragraphSpans' | 'storySegments' | 'findText' | 'listRevisions'>;
 /** @internal */
-type ProposalGeometryReader = AnchorReader & Pick<YrsSession, 'storyIds' | 'paragraphs' | 'paragraphIdCount' | 'locateParagraph' | 'version'>;
+type ProposalGeometryReader = AnchorReader & Pick<YrsSession, 'storyIds' | 'paragraphs' | 'paragraphIdCount' | 'locateParagraph' | 'version'> & {
+    proposalRevisions?(ids: readonly string[]): readonly ProposalGeometryRevision[];
+    positionOutline?(root: string): YrsPositionOutline | null;
+};
+/** @internal */
+type ProposalGeometryRevision = Pick<ReturnType<AnchorReader['listRevisions']>[number], 'revisionId' | 'kind' | 'story' | 'range'>;
 /** @internal */
 type AnchorGeometryTarget = {
     kind: 'proposal';
@@ -433,9 +557,9 @@ declare function textRangeToRaw(segments: readonly YrsStorySegment[], range: Doc
     range: RawAnchorRange;
 } | AnchorResolutionFailure;
 /** @internal */
-declare function hiddenRanges(session: AnchorReader, version: string, snapshot: DocxProposalSnapshot | null): RawAnchorRange[];
+declare function hiddenRanges(session: AnchorReader, version: string, snapshot: DocxProposalSnapshot | null, revisions?: readonly ProposalGeometryRevision[]): RawAnchorRange[];
 /** @internal */
-declare function resolveAnchorTarget(session: AnchorReader, target: AnchorGeometryTarget, version: string, snapshot?: DocxProposalSnapshot | null): AnchorResolution;
+declare function resolveAnchorTarget(session: AnchorReader, target: AnchorGeometryTarget, version: string, snapshot?: DocxProposalSnapshot | null, proposalRevisions?: readonly ProposalGeometryRevision[]): AnchorResolution;
 /** @internal */
 interface ProposalDisplayTarget {
     ranges: {
@@ -454,6 +578,7 @@ interface ProposalGeometryMirror {
     previewVersion: number;
     proposals: string;
     targets: Record<string, ProposalGeometryTarget>;
+    navigationTargets?: Record<string, ReturnType<typeof resolveNavigationTarget>>;
     hidden: {
         from: number;
         to: number;
@@ -462,7 +587,9 @@ interface ProposalGeometryMirror {
 /** @internal */
 declare function proposalSetIdentity(snapshot: DocxProposalSnapshot): string;
 /** @internal */
-declare function computeProposalGeometryMirror(reader: ProposalGeometryReader, snapshot: DocxProposalSnapshot): ProposalGeometryMirror;
+declare function computeProposalGeometryMirror(reader: ProposalGeometryReader, snapshot: DocxProposalSnapshot, includeNavigationTargets?: boolean): ProposalGeometryMirror;
+/** @internal */
+declare function resolveMirroredNavigationTarget(mirror: ProposalGeometryMirror | null, snapshot: DocxProposalSnapshot, story: string, paraId: string): ReturnType<typeof resolveNavigationTarget> | null;
 /** @internal */
 declare function resolveNavigationTarget(reader: ProposalGeometryReader, story: string, paraId: string): {
     loc: YrsLoc;
@@ -493,6 +620,10 @@ interface ResidentProposalResponse {
     updates: ArrayBuffer[];
     stateVector: ArrayBuffer;
     geometry: ProposalGeometryMirror;
+    fontRequirements?: {
+        layoutInput: string;
+        requirementsJson: string;
+    };
 }
 /** @internal */
 type ResidentDocumentRead = {
@@ -503,6 +634,15 @@ type ResidentDocumentRead = {
 } | {
     kind: 'readParagraphs';
     request: DocxReadParagraphsRequest;
+} | {
+    kind: 'searchText';
+    query: string;
+    caseSensitive: boolean;
+    carry?: YrsStickyPosition | null;
+} | {
+    kind: 'stickyAnchors';
+    locs: YrsLoc[];
+    version: string;
 } | {
     kind: 'navigationTarget';
     story: string;
@@ -516,10 +656,18 @@ interface ResidentDocumentReadValues {
     };
     readParagraphs: DocxReadParagraphsResult;
     navigationTarget: ReturnType<typeof resolveNavigationTarget>;
+    searchText: ResidentSearchResult;
+    stickyAnchors: Array<YrsStickyPosition | null>;
 }
+/** @internal */
+type ResidentEngineWorkerHostModule = {
+    type: 'editModule';
+    module: WebAssembly.Module | null;
+};
 type ResidentEngineWorkerRequest = {
     id: number;
     type: 'warm';
+    hostModule?: true;
 } | {
     id: number;
     type: 'bootstrap';
@@ -554,6 +702,11 @@ type ResidentEngineWorkerRequest = {
     generation?: string;
     /** The most the worker's editing core may allocate at once. */
     heapLimitBytes?: number;
+    /**
+     * Opens a display-only preview of the first `previewBlocks` body blocks instead. A later
+     * `open` of the whole document replaces it.
+     */
+    previewBlocks?: number;
 } | {
     id: number;
     type: 'fontRequirements';
@@ -587,12 +740,23 @@ type ResidentEngineWorkerRequest = {
     layoutExtras?: string;
     displayWindow?: [number, number];
     retainBuiltPages?: boolean;
+    provisionalPages?: number;
 } | {
     id: number;
     type: 'buildPages';
     pages: number[];
     expectedFrameEpoch: number;
     paintCaret: boolean;
+    background?: boolean;
+} | {
+    id: number;
+    type: 'releasePages';
+    pages: Array<{
+        index: number;
+        pageId: string;
+    }>;
+    expectedFrameEpoch: number;
+    paintCaret: boolean;
 } | {
     id: number;
     type: 'completeLayout';
@@ -659,6 +823,9 @@ type ResidentEngineWorkerResponse = ({
     id: number;
     ok: true;
     frame?: ArrayBuffer;
+    pageFrames?: ArrayBuffer[];
+    pageBuildSuperseded?: boolean;
+    superseded?: true;
     updates?: ArrayBuffer[];
     engineMs?: number;
     workerTotalMs?: number;
@@ -681,6 +848,8 @@ type ResidentEngineWorkerResponse = ({
     layoutProvisional?: boolean;
     /** An `open` reply: the opened package's host metadata JSON. */
     hostJson?: string;
+    /** An `open` reply: the package cannot open as a preview; nothing was opened. */
+    previewRefused?: boolean;
     /** A `fontRequirements` reply. */
     requirementsJson?: string;
     /** An `encodeState` reply: the document state as one yrs v1 update. */
@@ -718,6 +887,7 @@ interface ResidentProposalReply extends Omit<ResidentProposalResponse, 'updates'
 }
 interface ResidentEngineWorkerFrame {
     frame: Uint8Array;
+    pageFrames?: Uint8Array[];
     updates: Uint8Array[];
     engineMs: number;
     workerTotalMs: number;
@@ -742,7 +912,7 @@ interface ResidentEngineWorkerLayoutOptions {
     layoutExtras?: string;
     /** The host state vector the snapshot brings the worker to. */
     stateVector?: Uint8Array;
-    /** Bootstrap only: lay out just the body's first pages before replying. */
+    /** Lay out just the body's first pages before replying. */
     provisionalPages?: number;
     /** Bootstrap only: lay out the document {@link ResidentEngineWorkerClient.open} opened. */
     opened?: boolean;
@@ -777,7 +947,7 @@ interface ResidentEngineWorkerPort {
     onmessage: ((event: MessageEvent<ResidentEngineWorkerResponse>) => void) | null;
     onerror: ((event: ErrorEvent) => void) | null;
     onmessageerror: ((event: MessageEvent) => void) | null;
-    postMessage(message: ResidentEngineWorkerRequest, transfer?: Transferable[]): void;
+    postMessage(message: ResidentEngineWorkerRequest | ResidentEngineWorkerHostModule, transfer?: Transferable[]): void;
     terminate(): void;
 }
 /** Dedicated-worker owner for resident input, pagination, and FrameDelta output. */
@@ -795,13 +965,17 @@ declare class ResidentEngineWorkerClient {
     /** Set once `open` is sent, with the heap limit it opened under. */
     private openedHeapLimit;
     private bootstraps;
+    /** The font-requirements read still in flight, shared while nothing was posted after it. */
+    private fontRead;
     /** Id of the last snapshot request sent; replies to earlier requests must
      * not replace the state it recorded. */
     private lastSnapshotId;
     private keepSurfaces;
+    private bootstrapWaiters;
     private lastMemory;
     private answeredFrameEpoch;
     private retainBuiltPages;
+    private failureListener;
     constructor(worker?: ResidentEngineWorkerPort);
     isReady(): boolean;
     /** @internal */
@@ -813,7 +987,9 @@ declare class ResidentEngineWorkerClient {
     answeredFrame(): number;
     /** @internal */
     setRetainBuiltPages(retain: boolean): void;
-    /** @internal Whether a frame request other than `buildPages` awaits its reply. */
+    /** @internal Called once when the worker fails, whether or not a request was waiting; not on `destroy`. */
+    onFailure(listener: ((error: Error) => void) | null): void;
+    /** @internal Whether foreground document or frame work awaits its reply. */
     frameRequestPending(): boolean;
     /** The worker replica's last reported yrs state vector (null before any). */
     remoteStateVector(): Uint8Array | null;
@@ -821,6 +997,8 @@ declare class ResidentEngineWorkerClient {
     syncedFontsRevision(): number | null;
     /** A bootstrap was sent; later snapshots go as syncs queued behind it. */
     bootstrapSent(): boolean;
+    /** Resolves once a bootstrap is sent, at once when one was. */
+    whenBootstrapSent(): Promise<void>;
     /**
      * Starts over with another document in the same worker: the next request
      * is a bootstrap, which keeps the page surfaces already attached so the
@@ -837,6 +1015,15 @@ declare class ResidentEngineWorkerClient {
         generation?: string;
         heapLimitBytes?: number;
     }): Promise<ResidentEngineWorkerOpened>;
+    /**
+     * Opens a display-only preview of the first `blocks` body blocks of a DOCX in the worker, or
+     * resolves null when the package cannot open as a preview. Its first layout is a bootstrap
+     * with `opened`; {@link rebootstrap} then lets {@link open} replace it with the whole document.
+     * A copy of `bytes` is transferred.
+     */
+    openPreview(bytes: Uint8Array, blocks: number, options?: {
+        heapLimitBytes?: number;
+    }): Promise<ResidentEngineWorkerOpened | null>;
     /** The font requirements of a region layout request, read from the opened document. */
     fontRequirements(layoutInput: string): Promise<string>;
     /** @internal */
@@ -868,6 +1055,14 @@ declare class ResidentEngineWorkerClient {
     buildFrame(extras: string, expectedFrameEpoch: number, paintCaret?: boolean, displayWindow?: [number, number]): Promise<ResidentEngineWorkerFrame>;
     /** Build unbuilt display pages; the reply frame carries them. */
     buildPages(pages: number[], expectedFrameEpoch: number, paintCaret?: boolean): Promise<ResidentEngineWorkerFrame>;
+    /** @internal */
+    buildPages(pages: number[], expectedFrameEpoch: number, paintCaret: boolean, background: boolean): Promise<ResidentEngineWorkerFrame | null>;
+    releasePages(pages: Array<{
+        index: number;
+        pageId: string;
+    }>, expectedFrameEpoch: number, paintCaret?: boolean): Promise<ResidentEngineWorkerFrame | {
+        superseded: true;
+    }>;
     applyInput(text: string, selection: YrsSelection, expectedFrameEpoch: number, profile?: boolean, paintCaret?: boolean, displayWindow?: [number, number]): Promise<ResidentEngineWorkerApplyResult | {
         applied: false;
     }>;
@@ -937,6 +1132,12 @@ declare function documentToYrs(session: YrsSession, document: Document, options?
 
 /** yrs-to-OOXML save projection. */
 
+/**
+ * `blocks` with paragraphs of their own, in table cells too, each still the
+ * session paragraph it was projected from: a save edits these, not the
+ * projection the next one reuses. @internal
+ */
+declare function ownProjectedParagraphs(blocks: readonly BlockContent[]): BlockContent[];
 /**
  * Rebuild all yrs-owned editable stories into the serializer-facing Document
  * while preserving every package part the editor does not own.
@@ -989,11 +1190,13 @@ declare function captureSessionSave(session: YrsSession): DocxSessionSave;
 /**
  * Writes `document`, projected from `session` when `capture` was taken, and
  * records the Word paragraph IDs the bytes hold as saved. `patches` selects
- * the planned parts written as `originalBuffer`'s bytes with IDs patched in;
- * it selects none unless `originalBuffer` is the session's source package.
+ * the planned parts written as `originalBuffer`'s bytes with IDs patched in,
+ * and `splices` the story parts written as its bytes with only the
+ * paragraphs that need it re-serialized; each selects none unless
+ * `originalBuffer` is the session's source package.
  * @internal
  */
-declare function writeSessionSave(session: YrsSession, document: Document, capture: DocxSessionSave, originalBuffer: ArrayBuffer, options?: RepackOptions, patches?: (part: string) => boolean, skipMutations?: boolean): Promise<DocxSavedDocument>;
+declare function writeSessionSave(session: YrsSession, document: Document, capture: DocxSessionSave, originalBuffer: ArrayBuffer, options?: RepackOptions, patches?: (part: string) => boolean, skipMutations?: boolean, splices?: (part: string) => boolean): Promise<DocxSavedDocument>;
 /**
  * Saves a session opened from DOCX bytes and reports each saved paragraph's
  * persisted anchor, read from the same projection the bytes are written
@@ -1024,76 +1227,6 @@ declare function sessionSourcePackage(session: YrsSession): {
     keys: ReturnType<typeof editorSaveKeys>;
 } | null;
 
-type PositionReader = Pick<YrsSession, 'hasStory' | 'storySegments'>;
-/** @internal */
-interface YrsProjectedNode {
-    kind: string;
-    start: number;
-    nodeSize: number;
-    attrs: Record<string, unknown>;
-    story: string;
-}
-/** @internal */
-interface YrsProjectedTable extends YrsProjectedNode {
-    kind: 'table';
-    tableIndex: number;
-    widthsTwips: number[];
-    rowCount: number;
-    cells: YrsProjectedCell[];
-}
-/** @internal */
-interface YrsProjectedCell {
-    row: number;
-    column: number;
-    rowspan: number;
-    colspan: number;
-    story: string;
-    start: number;
-    contentStart: number;
-    nodeSize: number;
-    attrs: Record<string, unknown>;
-}
-/** @internal */
-interface YrsPointerProjectionTarget {
-    story: string;
-    displayPosition: number;
-    cell?: YrsCellLoc;
-}
-/** @internal */
-interface YrsStorySegmentSource {
-    segments(story: string): YrsStorySegment[];
-}
-/** @internal */
-declare function createYrsPositionProjection(session: PositionReader, rootStory: string, source?: YrsStorySegmentSource): YrsPositionProjection | null;
-/** @internal */
-declare function projectYrsDisplayPosition(position: number | PointPosition, getProjection: (rootStory: string) => YrsPositionProjection | null): YrsPointerProjectionTarget | null;
-/** @internal */
-declare class YrsPositionProjection {
-    readonly rootStory: string;
-    private readonly stories;
-    private readonly nodes;
-    private readonly tables;
-    private readonly source;
-    private readonly paragraphsById;
-    constructor(session: Pick<YrsSession, 'storySegments'>, rootStory: string, source?: YrsStorySegmentSource);
-    get size(): number;
-    nodeAt(position: number): YrsProjectedNode | null;
-    tableAtPosition(position: number): YrsProjectedTable | null;
-    tableAtStart(start: number): YrsProjectedTable | null;
-    tableStartForLoc(at: YrsCellLoc): number | null;
-    cellPosition(tableStart: number, row: number, column: number): number | null;
-    targetAt(position: number): YrsPointerProjectionTarget;
-    positionForLoc(loc: YrsLoc): number | null;
-    /** First paragraph for each paraId. */
-    private paragraphIndex;
-    bookmarkPosition(name: string): number | null;
-    private buildStory;
-    private inputPositionAt;
-    private buildTable;
-}
-/** @internal */
-declare function yrsLocToProjectedDisplayPosition(reader: Pick<YrsSession, 'hasStory' | 'paragraphSpans'>, projectionFor: (rootStory: string) => YrsPositionProjection | null, loc: YrsLoc, activeRootStory?: string, inputMap?: (story: string) => YrsInputPositionMap | null): number | null;
-
 interface YrsDocxHost {
     document: Document;
     referencedFonts: string[];
@@ -1104,6 +1237,8 @@ interface YrsDocxHost {
      * preview's cover only its own first pages.
      */
     unusedScriptFonts?: string[];
+    /** A preview whose cut holds the whole body. */
+    wholeBody?: true;
     embeddedFonts: Map<string, ArrayBuffer>;
     fontTableRelationshipsXml?: string;
 }
@@ -1841,8 +1976,12 @@ interface YrsSession extends CollaborationReplica {
     setDisplayWindow(start: number, end: number): void;
     /** Keep every previously built page while windowed builds are on. @internal */
     setDisplayRetainBuiltPages(retain: boolean): void;
+    /** @internal */
+    setWindowedIncrementalBuilds(enabled: boolean): void;
     /** Build the listed unbuilt pages into a FrameDelta v1. @internal */
     buildDisplayPagesFrame(pages: readonly number[], expectedFrameEpoch: number): Uint8Array;
+    /** Release built pages; null means the request was superseded. @internal */
+    releaseDisplayPagesFrame(pages: number[], expectedFrameEpoch: number): Uint8Array | null;
     /** Make the next frame a full one, for a host taking over from another engine; no-op once destroyed. */
     resetFrameBase(): void;
     /** Caret geometry from the current resident display frame. */
@@ -1905,6 +2044,11 @@ interface YrsSession extends CollaborationReplica {
     openDocxPreview(bytes: Uint8Array, blocks: number): YrsDocxHost | null;
     /** Opened by {@link openDocxPreview}: its document refuses every change. @internal */
     isDisplayOnly(): boolean;
+    /**
+     * Marks this empty session as showing a preview another engine opened: it refuses every
+     * change, and {@link openDocxPreview} can still load the preview here. @internal
+     */
+    markDisplayOnly(): void;
     /**
      * Marks whether the document is a preview's, as a replica of one is: its
      * layouts render NUMPAGES empty. @internal
@@ -2320,4 +2464,4 @@ declare function decodeDocxHostJson(json: string, source: Uint8Array): YrsDocxHo
  */
 declare function createYrsSession(options?: CreateYrsSessionOptions): Promise<YrsSession>;
 
-export { type DocxSavedDocument as $, type AnchorGeometryTarget as A, type DocxParagraphAnchor as B, type CollaborationReplica as C, type DocxOccurrence as D, type DocxParagraphAnchorResult as E, type DocxParagraphIdAssignment as F, type DocxParagraphIdDiagnostic as G, type DocxParagraphIdOrigin as H, type DocxParagraphIdRefusal as I, type DocxParagraphIdentity as J, type DocxParagraphIdentityReceipt as K, type DocxParagraphIdentitySnapshot as L, type DocxParagraphOrigin as M, type DocxParagraphRef as N, type DocxParagraphSavePlan as O, type DocxPersistedParagraphAnchor as P, type DocxProposalFailure as Q, type DocxProposalInput as R, type DocxProposalRecord as S, type DocxProposalRegistryState as T, type DocxProposalRequest as U, type DocxProposalResult as V, type DocxProposalSnapshot as W, type DocxProposalState as X, type YrsSession as Y, type DocxProposalStateRequest as Z, type DocxProposalWithdrawRequest as _, type YrsRenderEnv as a, type YrsSelectionContext as a$, type DocxSavedParagraph as a0, type DocxSessionParagraphAnchor as a1, type DocxSessionSave as a2, type DocxSourceParagraphAnchor as a3, type DocxSourceStory as a4, type ProposalDisplayTarget as a5, type ProposalGeometryMirror as a6, type ProposalGeometryReader as a7, type ProposalGeometryTarget as a8, type RawAnchorRange as a9, type YrsNumberingProperties as aA, type YrsOpeningOptions as aB, type YrsParaOffset as aC, type YrsParagraph as aD, type YrsParagraphAttrs as aE, type YrsParagraphLength as aF, type YrsParagraphReceipt as aG, type YrsParagraphSeed as aH, type YrsParagraphSpan as aI, type YrsParagraphTabStop as aJ, type YrsPointerProjectionTarget as aK, YrsPositionProjection as aL, type YrsProjectedCell as aM, type YrsProjectedNode as aN, type YrsProjectedTable as aO, type YrsRawOp as aP, type YrsRegionLayoutProgress as aQ, type YrsReplaceReceipt as aR, type YrsResidentCaretRect as aS, type YrsResidentCaretSnapshot as aT, type YrsResidentFontRegistration as aU, type YrsResidentWorkerSnapshot as aV, type YrsResidentWorkerSyncOptions as aW, type YrsResolveReceipt as aX, type YrsResolvedCommentAnchor as aY, type YrsRevisionReceipt as aZ, type YrsRunMark as a_, type ResidentCaretPaintStyle as aa, type ResidentEngineOffscreenPage as ab, type ResidentEngineWorkerApplyResult as ac, ResidentEngineWorkerClient as ad, type ResidentEngineWorkerFrame as ae, type ResidentEngineWorkerOpened as af, type ResidentProposalReply as ag, ResidentWorkerFailureError as ah, ResidentWorkerOutOfMemoryError as ai, type YrsAuthor as aj, type YrsCellBorder as ak, type YrsCellBorders as al, type YrsCellLoc as am, type YrsChangeTarget as an, type YrsCommentInfo as ao, type YrsCommentReceipt as ap, type YrsContentControlValue as aq, type YrsDocxHost as ar, type YrsEngineApplyProfile as as, type YrsHyperlinkAttrs as at, type YrsImageGeometry as au, type YrsInlineFormatDelta as av, type YrsInputParagraphSeed as aw, type YrsInputParagraphSpan as ax, type YrsInputPositionMap as ay, type YrsMediaSource as az, type CollaborationTransport as b, type YrsSelectionText as b0, type YrsSplitReceipt as b1, type YrsStickyPosition as b2, type YrsStoryRange as b3, type YrsStorySeed as b4, type YrsStorySegmentSource as b5, type YrsTableLoc as b6, type YrsTableRange as b7, type YrsTableReceipt as b8, type YrsTargetEditResult as b9, proposalRevisionPreview as bA, proposalSetIdentity as bB, residentCaretDeviceRect as bC, residentCaretSnapshotForFrame as bD, resolveAnchorTarget as bE, resolveNavigationTarget as bF, retainPreloadedResidentEngineWorker as bG, sameYrsSelection as bH, saveYrsDocx as bI, sessionSourcePackage as bJ, takePreloadedResidentEngineWorker as bK, textRangeToRaw as bL, writeSessionSave as bM, yrsLocToDisplayPosition as bN, yrsLocToProjectedDisplayPosition as bO, yrsToDocument as bP, type YrsTextColor as ba, type YrsTextMatch as bb, type YrsTextSearchOptions as bc, type YrsTriState as bd, type YrsUndoCaptureMode as be, type YrsWatermark as bf, type YrsWorkerDocumentMirror as bg, anchorFailure as bh, canUseResidentEngineWorker as bi, captureSessionSave as bj, compareYrsLocs as bk, computeProposalGeometryMirror as bl, createYrsInputPositionMap as bm, createYrsPositionProjection as bn, createYrsSession as bo, decodeDocxHostJson as bp, displayPositionToYrsLoc as bq, documentToYrs as br, editorSaveKeys as bs, hiddenRanges as bt, isBodyStory as bu, preloadDocxEngine as bv, preloadResidentEngineWorker as bw, prepareDocxBytes as bx, preparedDocxDigest as by, projectYrsDisplayPosition as bz, type CollaborationProviderOptions as c, type CollaborationStatus as d, type CollaborationPeer as e, type CollaborationCursor as f, type CollaborationPeerListener as g, type CollaborationStatusListener as h, type CollaborationErrorListener as i, type YrsSelection as j, type CollaborationAwarenessState as k, CollaborationError as l, type CollaborationErrorCode as m, type CollaborationPresence as n, type CollaborationResolvedUser as o, type CollaborationStatusChange as p, type CollaborationTextInsertion as q, type CollaborationTransportEvent as r, type CollaborationUpdateOrigin as s, type CollaborationUser as t, type YrsLoc as u, type YrsStorySegment as v, type YrsRevisionInfo as w, type AnchorReader as x, type AnchorResolutionFailure as y, type CreateYrsSessionOptions as z };
+export { type DocxSavedDocument as $, type AnchorGeometryTarget as A, type DocxParagraphAnchor as B, type CollaborationReplica as C, type DocxOccurrence as D, type DocxParagraphAnchorResult as E, type DocxParagraphIdAssignment as F, type DocxParagraphIdDiagnostic as G, type DocxParagraphIdOrigin as H, type DocxParagraphIdRefusal as I, type DocxParagraphIdentity as J, type DocxParagraphIdentityReceipt as K, type DocxParagraphIdentitySnapshot as L, type DocxParagraphOrigin as M, type DocxParagraphRef as N, type DocxParagraphSavePlan as O, type DocxPersistedParagraphAnchor as P, type DocxProposalFailure as Q, type DocxProposalInput as R, type DocxProposalRecord as S, type DocxProposalRegistryState as T, type DocxProposalRequest as U, type DocxProposalResult as V, type DocxProposalSnapshot as W, type DocxProposalState as X, type YrsSession as Y, type DocxProposalStateRequest as Z, type DocxProposalWithdrawRequest as _, type YrsRenderEnv as a, type YrsResolvedCommentAnchor as a$, type DocxSavedParagraph as a0, type DocxSessionParagraphAnchor as a1, type DocxSessionSave as a2, type DocxSourceParagraphAnchor as a3, type DocxSourceStory as a4, type ProposalDisplayTarget as a5, type ProposalGeometryMirror as a6, type ProposalGeometryReader as a7, type ProposalGeometryRevision as a8, type ProposalGeometryTarget as a9, type YrsLocProjection as aA, type YrsMediaSource as aB, type YrsNumberingProperties as aC, type YrsOpeningOptions as aD, type YrsParaOffset as aE, type YrsParagraph as aF, type YrsParagraphAttrs as aG, type YrsParagraphLength as aH, type YrsParagraphReceipt as aI, type YrsParagraphSeed as aJ, type YrsParagraphSpan as aK, type YrsParagraphTabStop as aL, type YrsPointerProjectionTarget as aM, type YrsPositionOutline as aN, YrsPositionProjection as aO, type YrsProjectedCell as aP, type YrsProjectedNode as aQ, type YrsProjectedTable as aR, type YrsRawOp as aS, type YrsRegionLayoutProgress as aT, type YrsReplaceReceipt as aU, type YrsResidentCaretRect as aV, type YrsResidentCaretSnapshot as aW, type YrsResidentFontRegistration as aX, type YrsResidentWorkerSnapshot as aY, type YrsResidentWorkerSyncOptions as aZ, type YrsResolveReceipt as a_, type RawAnchorRange as aa, type ResidentCaretPaintStyle as ab, type ResidentEngineOffscreenPage as ac, type ResidentEngineWorkerApplyResult as ad, ResidentEngineWorkerClient as ae, type ResidentEngineWorkerFrame as af, type ResidentEngineWorkerOpened as ag, type ResidentProposalReply as ah, ResidentWorkerFailureError as ai, ResidentWorkerOutOfMemoryError as aj, type YrsAuthor as ak, type YrsCellBorder as al, type YrsCellBorders as am, type YrsCellLoc as an, type YrsChangeTarget as ao, type YrsCommentInfo as ap, type YrsCommentReceipt as aq, type YrsContentControlValue as ar, type YrsDocxHost as as, type YrsEngineApplyProfile as at, type YrsHyperlinkAttrs as au, type YrsImageGeometry as av, type YrsInlineFormatDelta as aw, type YrsInputParagraphSeed as ax, type YrsInputParagraphSpan as ay, type YrsInputPositionMap as az, type CollaborationTransport as b, type YrsRevisionReceipt as b0, type YrsRunMark as b1, type YrsSelectionContext as b2, type YrsSelectionText as b3, type YrsSplitReceipt as b4, type YrsStickyPosition as b5, type YrsStoryRange as b6, type YrsStorySeed as b7, type YrsStorySegmentSource as b8, type YrsTableLoc as b9, preloadDocxEngine as bA, preloadResidentEngineWorker as bB, prepareDocxBytes as bC, preparedDocxDigest as bD, projectYrsDisplayPosition as bE, proposalRevisionPreview as bF, proposalSetIdentity as bG, residentCaretDeviceRect as bH, residentCaretSnapshotForFrame as bI, resolveAnchorTarget as bJ, resolveMirroredNavigationTarget as bK, resolveNavigationTarget as bL, retainPreloadedResidentEngineWorker as bM, sameYrsSelection as bN, saveYrsDocx as bO, sessionSourcePackage as bP, takePreloadedResidentEngineWorker as bQ, textRangeToRaw as bR, writeSessionSave as bS, yrsLocToDisplayPosition as bT, yrsLocToProjectedDisplayPosition as bU, yrsToDocument as bV, type YrsTableRange as ba, type YrsTableReceipt as bb, type YrsTargetEditResult as bc, type YrsTextColor as bd, type YrsTextMatch as be, type YrsTextSearchOptions as bf, type YrsTriState as bg, type YrsUndoCaptureMode as bh, type YrsWatermark as bi, type YrsWorkerDocumentMirror as bj, anchorFailure as bk, canUseResidentEngineWorker as bl, captureSessionSave as bm, compareYrsLocs as bn, computeProposalGeometryMirror as bo, createYrsInputPositionMap as bp, createYrsLocProjectionFromOutline as bq, createYrsPositionProjection as br, createYrsSession as bs, decodeDocxHostJson as bt, displayPositionToYrsLoc as bu, documentToYrs as bv, editorSaveKeys as bw, hiddenRanges as bx, isBodyStory as by, ownProjectedParagraphs as bz, type CollaborationProviderOptions as c, type CollaborationStatus as d, type CollaborationPeer as e, type CollaborationCursor as f, type CollaborationPeerListener as g, type CollaborationStatusListener as h, type CollaborationErrorListener as i, type YrsSelection as j, type CollaborationAwarenessState as k, CollaborationError as l, type CollaborationErrorCode as m, type CollaborationPresence as n, type CollaborationResolvedUser as o, type CollaborationStatusChange as p, type CollaborationTextInsertion as q, type CollaborationTransportEvent as r, type CollaborationUpdateOrigin as s, type CollaborationUser as t, type YrsLoc as u, type YrsStorySegment as v, type YrsRevisionInfo as w, type AnchorReader as x, type AnchorResolutionFailure as y, type CreateYrsSessionOptions as z };

package/dist/layout/index.d.mts

@@ -1,7 +1,7 @@
 import { B as BundledFontProvider } from '../rustMeasureSource-BkCx1FDx.mjs';
 export { a as BundledFontProviderSource, E as EmbeddedFaceInput, F as FontScript, b as ResidentFontRequirement, R as ResidentMeasurementConfig, c as RustMeasureSource, d as RustTextEngine, e as createRustMeasureSource, g as getRustTextEngine } from '../rustMeasureSource-BkCx1FDx.mjs';
-import { f as SectionProperties, H as HeaderFooter } from '../content-BzoC6bSz.mjs';
-export { D as DrawingScene, V as DrawingSceneNode, b as ShapeEffect, aX as ShapeFillPaint, aY as ShapeStrokePaint, c as ShapeTextBodyProperties } from '../content-BzoC6bSz.mjs';
+import { f as SectionProperties, H as HeaderFooter } from '../content-DSb-6a9T.mjs';
+export { D as DrawingScene, V as DrawingSceneNode, b as ShapeEffect, aX as ShapeFillPaint, aY as ShapeStrokePaint, c as ShapeTextBodyProperties } from '../content-DSb-6a9T.mjs';
 import { Document } from '../types/document.mjs';
 import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';