@betteroffice/docx 0.0.4 → 0.1.0

package/dist/plugin-api/RenderedDomContext.d.mts

@@ -1,13 +1,13 @@
 import { RenderedDomContext, PositionCoordinates } from './index.mjs';
-import { D as DisplayListRect, a as DisplayListQueries } from '../displayListQueries-DLzpvJV6.mjs';
+import { D as DisplayListRect, a as DisplayListQueries } from '../displayListQueries-DGDR-OWc.mjs';
 import '../types/document.mjs';
-import '../content-C3sTRz-u.mjs';
-import '../formatting-BEkIBePP.mjs';
+import '../content-DrqzbIr7.mjs';
+import '../formatting-BqrFPeev.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-BK3Jecxs.mjs';
-import '../frameDelta-B2kC6XiP.mjs';
-import '../rustDisplayList-B0M2eBkU.mjs';
-import '../types-C1rv3KM-.mjs';
+import '../styles-CMybYYHS.mjs';
+import '../frameDelta-DMgR8n13.mjs';
+import '../rustDisplayList-B9dQoLHI.mjs';
+import '../types-CXLxVF1t.mjs';
 import '../layout/pagination/index.mjs';
 
 /**

package/dist/plugin-api/index.d.mts

@@ -1,8 +1,8 @@
 import { Document } from '../types/document.mjs';
-import '../content-C3sTRz-u.mjs';
-import '../formatting-BEkIBePP.mjs';
+import '../content-DrqzbIr7.mjs';
+import '../formatting-BqrFPeev.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-BK3Jecxs.mjs';
+import '../styles-CMybYYHS.mjs';
 
 /**
  * Framework-Agnostic Plugin Interface for the DOCX Editor

package/dist/plugin-api/resolveItemPositions.d.mts

@@ -1,9 +1,9 @@
 import { SidebarItem, RenderedDomContext } from './index.mjs';
 import '../types/document.mjs';
-import '../content-C3sTRz-u.mjs';
-import '../formatting-BEkIBePP.mjs';
+import '../content-DrqzbIr7.mjs';
+import '../formatting-BqrFPeev.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-BK3Jecxs.mjs';
+import '../styles-CMybYYHS.mjs';
 
 /**
  * Pure layout algorithm: given a list of sidebar items + their

package/dist/{rustDisplayList-B0M2eBkU.d.mts → rustDisplayList-B9dQoLHI.d.mts}

@@ -1,27 +1,34 @@
-import { a as Layout } from './types-C1rv3KM-.mjs';
+import { a as Layout } from './types-CXLxVF1t.mjs';
 import { MeasuredBlock } from './layout/pagination/index.mjs';
-import { D as DisplayList, R as RetainedFrame } from './frameDelta-B2kC6XiP.mjs';
+import { D as DisplayList, R as RetainedFrame } from './frameDelta-DMgR8n13.mjs';
 
 /**
- * JS seam to the Rust display-list builder (crates/docx-layout).
+ * JS seam to the Rust display-list builder.
  *
- * Marshals the same `{ measured, options, layout }` triple the golden
- * fixtures pin (see scripts/export-displaylist-fixtures.ts) across the wasm
- * boundary and parses the resulting DisplayList. All paint/geometry decisions
- * happen in Rust — this module is serialization glue only.
+ * Marshals the `{ measured, options, layout }` envelope across the wasm
+ * boundary and hands back a DisplayList. Every paint and geometry decision
+ * happens in Rust; this module is serialization glue and nothing else, so a
+ * failure here is terminal — the types below carry no second engine to fall
+ * back to, only a typed {@link RustDisplayListSourceError} naming the stage
+ * that failed.
  *
- * The wasm module is loaded lazily via dynamic import on first build, so the
- * ~800KB inlined binary costs nothing until the experimental canvas renderer
- * is actually enabled.
+ * Two transports exist. {@link buildRustDisplayList} sends the whole envelope
+ * and parses a DisplayList back. {@link buildRustDisplayFrame} prefers an
+ * engine that already retains pagination: it sends only the display-level
+ * extras and receives a binary FrameDelta, which is applied to the previous
+ * frame so unchanged pages keep object identity — the invariant the query
+ * facade's page-delta adoption depends on. An engine without
+ * `buildDisplayListFrame` takes the full-JSON path instead.
  *
- * @experimental part of the rust-canvas-engine change; shape may evolve.
+ * The wasm module is loaded lazily on first build, so the inlined binary costs
+ * nothing until a display list is actually requested.
  */
 
 /**
  * One header/footer part in the `headersFooters` envelope field: the measured
- * blocks of the HF ProseMirror doc identified by `rId`, plus the band metrics
- * `convertHeaderFooterPmDocToContent` computed (passed through verbatim — the
- * Rust builder re-derives nothing).
+ * blocks of the header/footer document identified by `rId`, plus the band
+ * metrics the caller already computed. The builder passes the metrics through
+ * verbatim and re-derives none of them.
  */
 interface DisplayListHfVariant {
     rId: string;
@@ -41,14 +48,14 @@ interface DisplayListHfVariant {
      * line width is measured ONCE at the field's fallback text ("1"), so without
      * this the builder holds the same centered position on every page even though
      * "Page 2 of 3"/"Page 10 of 12" have different widths. Omitted ⇒ the fields
-     * ride the char-distributed fallback width (byte-identical to before).
+     * ride the char-distributed fallback width on every page.
      */
     fieldWidths?: DisplayListFieldWidths[];
 }
 /**
  * Per-page widths of one PAGE/NUMPAGES field run in an HF part. `pmStart` is the
- * field run's position in the HF ProseMirror doc (the key the Rust builder
- * matches). `fallbackWidth` is the width the measure baked into `line.width`
+ * field run's position in the header/footer document, and is the key the Rust
+ * builder matches on. `fallbackWidth` is the width the measure baked into `line.width`
  * (the field's fallback text); `perPage[i]` is the width of the field's resolved
  * text on layout page index `i` (PAGE → that page's number, NUMPAGES → total).
  */
@@ -71,7 +78,7 @@ interface DisplayListHeadersFooters {
     /** Page-level Word watermark, painted behind body/header/footer content. */
     watermark?: DisplayListWatermark;
     variants: DisplayListHfVariant[];
-    /** Stable section identity. Undefined = document-global legacy envelope. */
+    /** Stable section identity. Undefined ⇒ the envelope covers the whole document. */
     sectionId?: string;
     /** Zero-based section index. */
     sectionIndex?: number;
@@ -158,7 +165,7 @@ interface DisplayListCommentThread {
 }
 /** The `{ measured, options, layout }` envelope the Rust builder consumes. */
 interface DisplayListBuildInputs {
-    /** Serialization contract version. Undefined reads as legacy version 0. */
+    /** Serialization contract version. Undefined reads as version 0. */
     contractVersion?: number;
     measured: MeasuredBlock[];
     options: unknown;
@@ -170,35 +177,42 @@ interface DisplayListBuildInputs {
      * → measurement `FontStore` ids — the SAME map the measurement input carries.
      * Present only under Rust measurement (the ids must belong to a populated
      * store); its presence against that store is what gates GlyphRun emission.
-     * Omitted ⇒ every text run takes the browser-measured `TextRunPrimitive` path
-     * (byte-identical to the pre-glyph build).
+     * Omitted ⇒ every text run is emitted as a browser-measured
+     * `TextRunPrimitive` rather than a shaped `GlyphRun`.
      */
     fontChains?: Record<string, number[]>;
     /** Page/section note regions. Undefined = no note emission. */
     noteAreas?: DisplayListNoteArea[];
     /** Resolved comments suppressed from active tint. Undefined = none known. */
     resolvedCommentIds?: number[];
-    /** Stable reviewer palette. Undefined = legacy hard-coded colors. */
+    /** Stable reviewer palette. Undefined ⇒ the builder's built-in colors. */
     commentAuthors?: DisplayListCommentAuthor[];
     /** Per-comment thread metadata for a11y announcements. Undefined = none. */
     commentThreads?: DisplayListCommentThread[];
 }
-/** Minimal engine surface, injectable so tests can fake the wasm module. */
+/**
+ * Minimal build surface, injectable so tests can fake the wasm module. Only
+ * `buildDisplayListJson` is required; the optional members are what an engine
+ * that retains its own pagination and display state additionally offers.
+ */
 interface RustDisplayListEngine {
     buildDisplayListJson(input: string): string;
-    /** Resident editing engines expose binary deltas; the stateless layout wasm does not. */
+    /** Binary FrameDelta build; the stateless layout wasm does not offer it. */
     buildDisplayListFrame?(input: string, expectedFrameEpoch: number): Uint8Array;
-    /** One-owner ordinary input path; available on the resident editing engine. */
+    /** Applies one keystroke and returns its frame, without a layout round trip. */
     applyInput?(text: string, expectedFrameEpoch: number): Uint8Array;
     displayHitTestRegionsJson?(pageIndex: number, x: number, y: number): string;
     displayVerticalMoveJson?(position: number, direction: 'up' | 'down', goalX: number): string;
     displayRangeRectsJson?(from: number, to: number): string;
-    displayRangeRectsRegionJson?(region: 'body' | 'header' | 'footer', rId: string, from: number, to: number): string;
+    displayRangeRectsRegionJson?(region: string, partId: string, from: number, to: number): string;
 }
 type RustDisplayListSourceErrorStage = 'load' | 'build' | 'parse' | 'decode' | 'apply';
 interface RustDisplayFrameResult {
     displayList: DisplayList;
-    /** Null only on the compatibility JSON engine path. */
+    /**
+     * The retained frame to pass as `previous` on the next build. Null when the
+     * engine answered over full JSON, which retains nothing.
+     */
     frame: RetainedFrame | null;
     transport: 'frame-delta-v1' | 'json';
 }
@@ -215,30 +229,32 @@ declare class RustDisplayListSourceError extends Error {
  * Query surface over an already-built display list, injectable so tests can
  * fake the wasm module.
  *
- * The `*Json` calls take the display-list JSON string as an argument (the Rust
- * side re-parses it per query — callers should cache the string). The
- * session-handle members parse the list ONCE (`openDisplayList` → handle) and
- * answer many queries by handle with no re-serialization, reusing the same
- * hit/range logic so results are byte-identical. The handle members are
- * OPTIONAL: the embedded wasm carries them only after the integrator re-embeds,
- * so `createDisplayListQueries` feature-detects `hasDisplayListSession` and
- * falls back to the `*Json` path when they are absent.
+ * The required `*Json` members take the display-list JSON as an argument and
+ * the Rust side re-parses it per query, so callers should cache the string.
+ * The OPTIONAL session-handle members parse the list once (`openDisplayList` →
+ * a handle) and answer many queries by handle with no re-serialization,
+ * reusing the same hit and range logic so results are byte-identical. They are
+ * optional because the embedded wasm may not carry them; `hasDisplayListSession`
+ * and `hasRangeRectsRegion` report what is present, and
+ * `createDisplayListQueries` falls back to the `*Json` path when it is not.
  */
 interface RustDisplayListQueryEngine {
-    /** region-aware hit test → `{"region","rId"?,"pos"}` or `"null"` JSON */
+    /**
+     * region-aware hit test → `{"region","rId"?,"noteId"?,"pos","target"}` or
+     * `"null"` JSON
+     */
     hitTestRegionsJson(displayList: string, pageIndex: number, x: number, y: number): string;
     /** closest caret position on the adjacent visual line */
     verticalMoveJson?(displayList: string, position: number, direction: 'up' | 'down', goalX: number): string;
-    /** body PM range → JSON array of `{pageIndex,x,y,width,height}` rects */
+    /** body document range → JSON array of `{pageIndex,x,y,width,height}` rects */
     rangeRectsJson(displayList: string, from: number, to: number): string;
     /**
-     * Region-aware PM range → JSON array of rects. `region` is
-     * `'body' | 'header' | 'footer'`; `rId` scopes header/footer to one HF part
-     * (empty for body / match-any). OPTIONAL: the embedded wasm carries it only
-     * after the integrator re-embeds, so `createDisplayListQueries` falls back to
-     * `[]` when absent (HF selection geometry stays a documented gap until then).
+     * Region-aware document range → JSON array of rects. `region` is a
+     * `DisplayListHitRegion` discriminant; `partId` names the instance — a
+     * header/footer part (empty for body, or to match any band of the kind) or a
+     * note id. Optional — the facade returns `[]` when it is absent.
      */
-    rangeRectsRegionJson?(displayList: string, region: string, rId: string, from: number, to: number): string;
+    rangeRectsRegionJson?(displayList: string, region: string, partId: string, from: number, to: number): string;
     /** true when the embedded wasm carries the region-aware range-rect exports */
     hasRangeRectsRegion?(): boolean;
     /** true when the embedded wasm carries the session-handle exports below */
@@ -255,10 +271,10 @@ interface RustDisplayListQueryEngine {
     hitTestRegionsByHandle?(handle: number, pageIndex: number, x: number, y: number): string;
     /** adjacent visual-line move against a stored display list */
     verticalMoveByHandle?(handle: number, position: number, direction: 'up' | 'down', goalX: number): string;
-    /** body PM range against a stored display list (by handle) */
+    /** body document range against a stored display list (by handle) */
     rangeRectsByHandle?(handle: number, from: number, to: number): string;
-    /** region-aware PM range against a stored display list (by handle) */
-    rangeRectsRegionByHandle?(handle: number, region: string, rId: string, from: number, to: number): string;
+    /** region-aware document range against a stored display list (by handle) */
+    rangeRectsRegionByHandle?(handle: number, region: string, partId: string, from: number, to: number): string;
 }
 /**
  * Lazily load the wasm query surface (hit-test + range-rects). Shares the
@@ -270,13 +286,21 @@ declare function loadRustDisplayListQueryEngine(): Promise<RustDisplayListQueryE
 declare function encodeDisplayListFrameExtras(inputs: DisplayListBuildInputs): string;
 /**
  * Build a DisplayList for a computed layout through the Rust engine. Throws
- * when the wasm module fails to load or the builder rejects the input — the
- * caller is expected to fall back to the DOM painter.
+ * {@link RustDisplayListSourceError} tagged with the failing stage — `load`,
+ * `build` or `parse` — when the wasm module cannot be loaded, the builder
+ * rejects the input, or its output does not parse.
  */
 declare function buildRustDisplayList(inputs: DisplayListBuildInputs, engine?: RustDisplayListEngine): Promise<DisplayList>;
 /**
- * Production display build. Resident editing engines return FrameDelta v1;
- * older/stateless engines retain the full-JSON parity path.
+ * Build one display frame. An engine that retains pagination returns a binary
+ * FrameDelta, decoded and applied on top of `previous` so unchanged pages keep
+ * object identity; `previous` also supplies the frame epoch the engine checks
+ * before sending a delta rather than a full frame. An engine without
+ * `buildDisplayListFrame` takes the full-JSON path, and its result carries
+ * `frame: null` and `transport: 'json'`.
+ *
+ * Throws {@link RustDisplayListSourceError} tagged with the failing stage:
+ * `load`, `build`, `decode` or `apply`.
  */
 declare function buildRustDisplayFrame(inputs: DisplayListBuildInputs, engine?: RustDisplayListEngine, previous?: RetainedFrame | null): Promise<RustDisplayFrameResult>;
 

package/dist/{rustMeasureSource-D1KsQvVC.d.mts → rustMeasureSource-C0EZB055.d.mts}

@@ -32,7 +32,7 @@ interface BundledFontProvider {
      * The always-available last-resort base face (broad-coverage Latin —
      * Liberation Sans/Serif per serif-ness). Unlike {@link
      * BundledFontProvider.resolve}, a conforming provider (e.g.
-     * `@betteroffice/docx-fonts`'s `resolveLastResortFace`) returns a loader for
+     * `@betteroffice/fonts`'s `resolveLastResortFace`) returns a loader for
      * EVERY family, so the chain this registry builds is guaranteed non-empty
      * and a run never routes to the browser measurer for want of font bytes. The
      * face's metrics are the base font's, not the requested family's — the
@@ -66,6 +66,8 @@ interface EmbeddedFaceInput {
     /** Whether the source face was subsetted (`w:subsetted`). */
     subsetted: boolean;
 }
+/** A provider or async factory; `undefined` means no bundled bytes. @public */
+type BundledFontProviderSource = BundledFontProvider | (() => Promise<BundledFontProvider | undefined>);
 
 interface RustTextEngine {
     registerFont(bytes: Uint8Array): number;
@@ -98,9 +100,10 @@ interface RustMeasureSource {
     clear(): void;
 }
 declare function getRustTextEngine(): Promise<RustTextEngine>;
+/** Builds a source with an explicit provider or the optional default package. */
 declare function createRustMeasureSource(options: {
     engine: RustTextEngine;
     bundled?: BundledFontProvider;
 }): RustMeasureSource;
 
-export { type BundledFontProvider as B, type EmbeddedFaceInput as E, type FontScript as F, type ResidentMeasurementConfig as R, type ResidentFontRequirement as a, type RustMeasureSource as b, type RustTextEngine as c, createRustMeasureSource as d, getRustTextEngine as g };
+export { type BundledFontProvider as B, type EmbeddedFaceInput as E, type FontScript as F, type ResidentMeasurementConfig as R, type BundledFontProviderSource as a, type ResidentFontRequirement as b, type RustMeasureSource as c, type RustTextEngine as d, createRustMeasureSource as e, getRustTextEngine as g };

package/dist/{selectiveSave-CVoajSKE.d.mts → selectiveSave-CRh-_Y_C.d.mts}

@@ -4,7 +4,7 @@ import { D as DocxInput } from './docxInput-DTbCa48g.mjs';
 /**
  * Public DOCX parser facade.
  *
- * Rust S9 owns ZIP/XML parsing. TypeScript only normalizes host inputs,
+ * Rust owns ZIP/XML parsing. TypeScript only normalizes host inputs,
  * rehydrates the public `Document`, reports progress, and registers fonts.
  * @packageDocumentation
  * @public
@@ -35,7 +35,7 @@ interface RepackOptions {
     updateModifiedDate?: boolean;
     modifiedBy?: string;
 }
-/** Repack a public Document through the live Rust S13 writer. */
+/** Repack a public Document through the Rust package writer. */
 declare function repackDocx(doc: Document, options?: RepackOptions): Promise<ArrayBuffer>;
 declare function updateMultipleFiles(originalBuffer: ArrayBuffer, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
 declare function createDocx(doc: Document): Promise<ArrayBuffer>;
@@ -48,7 +48,7 @@ interface SelectiveSaveOptions {
     hasUntrackedChanges: boolean;
 }
 /**
- * Patch changed paragraphs through the Rust S13 writer. Returns `null` when
+ * Patch changed paragraphs through the Rust package writer. Returns `null` when
  * selective save is unsafe so callers can fall back to a full repack.
  */
 declare function attemptSelectiveSave(doc: Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;

package/dist/styles/index.d.mts

@@ -1,8 +1,8 @@
-import { a as ParagraphFormatting, b as TextFormatting } from '../formatting-BEkIBePP.mjs';
-import { S as StyleDefinitions, a as Style, D as DocDefaults } from '../styles-BK3Jecxs.mjs';
+import { a as ParagraphFormatting, b as TextFormatting } from '../formatting-BqrFPeev.mjs';
+import { S as StyleDefinitions, a as Style, D as DocDefaults } from '../styles-CMybYYHS.mjs';
 
 /**
- * Style Resolver for ProseMirror Editor
+ * Style Resolver
  *
  * Resolves OOXML style definitions to final paragraph and run properties.
  * Handles the cascade:

package/dist/{styles-BK3Jecxs.d.mts → styles-CMybYYHS.d.mts}

@@ -1,4 +1,4 @@
-import { b as TextFormatting, a as ParagraphFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting } from './formatting-BEkIBePP.mjs';
+import { b as TextFormatting, a as ParagraphFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting } from './formatting-BqrFPeev.mjs';
 
 /**
  * Styles, Theme, Font Table, Relationships & Media Types

package/dist/types/content.d.mts

@@ -1,3 +1,3 @@
-export { B as BlockContent, l as BlockSdt, m as BookmarkEnd, n as BookmarkStart, o as BreakContent, e as Chart, p as ChartAxis, q as ChartContent, s as ChartLegend, v as ChartSeries, w as ChartType, x as Column, f as Comment, G as CommentRangeEnd, I as CommentRangeStart, K as ComplexField, M as DEFAULT_WATERMARK_PRESETS, O as Deletion, g as DocumentBody, Q as DrawingContent, j as Endnote, U as EndnotePosition, E as EndnoteProperties, V as Field, X as FieldCharContent, _ as FieldType, $ as FooterReference, i as Footnote, a0 as FootnotePosition, F as FootnoteProperties, H as HeaderFooter, a1 as HeaderFooterType, a2 as HeaderReference, a3 as Hyperlink, a5 as Image, a6 as ImageCrop, a9 as ImagePadding, aa as ImagePosition, ac as ImageSize, ad as ImageTransform, ae as ImageWrap, ag as InlineSdt, ah as Insertion, ai as InstrTextContent, ak as LineNumberRestart, an as MathEquation, ao as MoveFrom, ap as MoveFromRangeEnd, aq as MoveFromRangeStart, ar as MoveTo, as as MoveToRangeEnd, at as MoveToRangeStart, au as NoBreakHyphenContent, av as NoteNumberRestart, aw as NoteRefMarkContent, ax as NoteReferenceContent, aC as PageOrientation, P as Paragraph, aD as ParagraphContent, aE as ParagraphPropertyChange, aF as PictureWatermark, aG as PropertyChangeInfo, aH as Run, aI as RunContent, aJ as RunPropertyChange, aL as SdtDataBinding, b as SdtProperties, aO as SdtType, aP as Section, S as SectionProperties, aQ as SectionStart, aR as SeparatorContent, aS as Shape, aT as ShapeContent, aW as ShapeTextBody, aX as SimpleField, aY as SoftHyphenContent, a$ as SymbolContent, b0 as TabContent, b1 as Table, b2 as TableCell, b3 as TableCellPropertyChange, b4 as TablePropertyChange, b5 as TableRow, b6 as TableRowPropertyChange, b7 as TableStructuralChangeInfo, b8 as TextBox, b9 as TextContent, ba as TextWatermark, bb as TrackedChangeInfo, bc as TrackedRunChange, bd as VerticalAlign, W as Watermark, be as pictureWatermarkDisplayEmu } from '../content-C3sTRz-u.mjs';
-export { k as ShapeFill, l as ShapeOutline, m as ShapeType } from '../formatting-BEkIBePP.mjs';
+export { B as BlockContent, l as BlockSdt, m as BookmarkEnd, n as BookmarkStart, o as BreakContent, e as Chart, p as ChartAxis, q as ChartContent, t as ChartLegend, x as ChartSeries, y as ChartType, z as Column, f as Comment, J as CommentRangeEnd, K as CommentRangeStart, M as ComplexField, Q as DEFAULT_WATERMARK_PRESETS, T as Deletion, g as DocumentBody, U as DrawingContent, j as Endnote, X as EndnotePosition, E as EndnoteProperties, Y as Field, Z as FieldCharContent, a0 as FieldType, a1 as FooterReference, i as Footnote, a2 as FootnotePosition, F as FootnoteProperties, H as HeaderFooter, a3 as HeaderFooterType, a4 as HeaderReference, a5 as Hyperlink, a7 as Image, a8 as ImageCrop, ab as ImagePadding, ac as ImagePosition, ae as ImageSize, af as ImageTransform, ag as ImageWrap, ai as InlineSdt, aj as Insertion, ak as InstrTextContent, am as LineNumberRestart, ap as MathEquation, aq as MoveFrom, ar as MoveFromRangeEnd, as as MoveFromRangeStart, at as MoveTo, au as MoveToRangeEnd, av as MoveToRangeStart, aw as NoBreakHyphenContent, ax as NoteNumberRestart, ay as NoteRefMarkContent, az as NoteReferenceContent, aE as PageOrientation, P as Paragraph, aF as ParagraphContent, aG as ParagraphPropertyChange, aH as PictureWatermark, aI as PropertyChangeInfo, aJ as Run, aK as RunContent, aL as RunPropertyChange, aN as SdtDataBinding, b as SdtProperties, aQ as SdtType, aR as Section, S as SectionProperties, aS as SectionStart, aT as SeparatorContent, aU as Shape, aV as ShapeContent, aY as ShapeTextBody, aZ as SimpleField, a_ as SoftHyphenContent, b1 as SymbolContent, b2 as TabContent, b3 as Table, b4 as TableCell, b5 as TableCellPropertyChange, b6 as TablePropertyChange, b7 as TableRow, b8 as TableRowPropertyChange, b9 as TableStructuralChangeInfo, ba as TextBox, bb as TextContent, bc as TextWatermark, bd as TrackedChangeInfo, be as TrackedRunChange, bf as VerticalAlign, W as Watermark, bg as pictureWatermarkDisplayEmu } from '../content-DrqzbIr7.mjs';
+export { k as ShapeFill, l as ShapeOutline, m as ShapeType } from '../formatting-BqrFPeev.mjs';
 import '../docx/wrapTypes.mjs';

package/dist/types/document.d.mts

@@ -1,9 +1,9 @@
-import { F as FootnoteProperties, E as EndnoteProperties, g as DocumentBody, h as NumberingDefinitions, i as Footnote, j as Endnote, H as HeaderFooter, e as Chart, k as BookmarkRange } from '../content-C3sTRz-u.mjs';
-export { A as AbstractNumbering, B as BlockContent, l as BlockSdt, m as BookmarkEnd, n as BookmarkStart, o as BreakContent, p as ChartAxis, q as ChartContent, r as ChartGrouping, s as ChartLegend, t as ChartPlotGroup, u as ChartPoint, v as ChartSeries, w as ChartType, x as Column, f as Comment, y as CommentAnchorRange, z as CommentAuthor, G as CommentRangeEnd, I as CommentRangeStart, J as CommentReferenceContent, K as ComplexField, L as ContentPosition, M as DEFAULT_WATERMARK_PRESETS, O as Deletion, Q as DrawingContent, D as DrawingScene, T as DrawingSceneNode, U as EndnotePosition, V as Field, X as FieldCharContent, Y as FieldFormData, Z as FieldInlineContent, _ as FieldType, $ as FooterReference, a0 as FootnotePosition, a1 as HeaderFooterType, a2 as HeaderReference, a3 as Hyperlink, a4 as HyperlinkContent, a5 as Image, a6 as ImageCrop, a7 as ImageEffect, a8 as ImageHyperlink, a9 as ImagePadding, aa as ImagePosition, ab as ImageRotationBounds, ac as ImageSize, ad as ImageTransform, ae as ImageWrap, af as ImageWrapPoint, ag as InlineSdt, ah as Insertion, ai as InstrTextContent, aj as LevelSuffix, ak as LineNumberRestart, al as ListLevel, am as ListRendering, an as MathEquation, ao as MoveFrom, ap as MoveFromRangeEnd, aq as MoveFromRangeStart, ar as MoveTo, as as MoveToRangeEnd, at as MoveToRangeStart, au as NoBreakHyphenContent, N as NoteKind, av as NoteNumberRestart, aw as NoteRefMarkContent, ax as NoteReferenceContent, ay as NoteSeparatorReference, az as NumberFormat, aA as NumberingInstance, aB as PageNumberingProperties, aC as PageOrientation, P as Paragraph, aD as ParagraphContent, aE as ParagraphPropertyChange, aF as PictureWatermark, aG as PropertyChangeInfo, aH as Run, aI as RunContent, aJ as RunPropertyChange, aK as SdtCheckboxGlyph, a as SdtControlState, aL as SdtDataBinding, aM as SdtDateState, aN as SdtGalleryState, b as SdtProperties, aO as SdtType, aP as Section, S as SectionProperties, aQ as SectionStart, aR as SeparatorContent, aS as Shape, aT as ShapeContent, c as ShapeEffect, aU as ShapeFillPaint, aV as ShapeStrokePaint, aW as ShapeTextBody, d as ShapeTextBodyProperties, aX as SimpleField, aY as SoftHyphenContent, aZ as StructuredFieldContent, a_ as StructuredFieldTree, a$ as SymbolContent, b0 as TabContent, b1 as Table, b2 as TableCell, b3 as TableCellPropertyChange, b4 as TablePropertyChange, b5 as TableRow, b6 as TableRowPropertyChange, b7 as TableStructuralChangeInfo, b8 as TextBox, b9 as TextContent, ba as TextWatermark, bb as TrackedChangeInfo, bc as TrackedRunChange, bd as VerticalAlign, W as Watermark, be as pictureWatermarkDisplayEmu } from '../content-C3sTRz-u.mjs';
-import { f as Theme, C as ColorValue } from '../formatting-BEkIBePP.mjs';
-export { B as BorderSpec, g as CellMargins, h as ConditionalFormatStyle, E as EmphasisMark, F as FloatingTableProperties, L as LineSpacingRule, i as ParagraphAlignment, a as ParagraphFormatting, R as RunFontHint, j as RunLanguage, S as ShadingProperties, k as ShapeFill, l as ShapeOutline, m as ShapeType, n as TabLeader, o as TabStop, p as TabStopAlignment, q as TableBorders, e as TableCellFormatting, c as TableFormatting, r as TableLook, s as TableMeasurement, d as TableRowFormatting, t as TableStyleCascade, u as TableStyleRegion, v as TableWidthType, w as TextEffect, b as TextFormatting, T as TextModernEffects, x as ThemeColorScheme, y as ThemeColorSlot, z as ThemeFont, A as ThemeFontScheme, U as UnderlineStyle } from '../formatting-BEkIBePP.mjs';
-import { S as StyleDefinitions, F as FontTable, R as RelationshipMap, M as MediaFile } from '../styles-BK3Jecxs.mjs';
-export { D as DocDefaults, b as FontEmbed, c as FontInfo, d as Relationship, e as RelationshipType, a as Style, f as StyleType } from '../styles-BK3Jecxs.mjs';
+import { F as FootnoteProperties, E as EndnoteProperties, g as DocumentBody, h as NumberingDefinitions, i as Footnote, j as Endnote, H as HeaderFooter, e as Chart, k as BookmarkRange } from '../content-DrqzbIr7.mjs';
+export { A as AbstractNumbering, B as BlockContent, l as BlockSdt, m as BookmarkEnd, n as BookmarkStart, o as BreakContent, p as ChartAxis, q as ChartContent, r as ChartDataLabels, s as ChartGrouping, t as ChartLegend, u as ChartPlotGroup, v as ChartPoint, w as ChartPointLabel, x as ChartSeries, y as ChartType, z as Column, f as Comment, G as CommentAnchorRange, I as CommentAuthor, J as CommentRangeEnd, K as CommentRangeStart, L as CommentReferenceContent, M as ComplexField, O as ContentPosition, Q as DEFAULT_WATERMARK_PRESETS, T as Deletion, U as DrawingContent, D as DrawingScene, V as DrawingSceneNode, X as EndnotePosition, Y as Field, Z as FieldCharContent, _ as FieldFormData, $ as FieldInlineContent, a0 as FieldType, a1 as FooterReference, a2 as FootnotePosition, a3 as HeaderFooterType, a4 as HeaderReference, a5 as Hyperlink, a6 as HyperlinkContent, a7 as Image, a8 as ImageCrop, a9 as ImageEffect, aa as ImageHyperlink, ab as ImagePadding, ac as ImagePosition, ad as ImageRotationBounds, ae as ImageSize, af as ImageTransform, ag as ImageWrap, ah as ImageWrapPoint, ai as InlineSdt, aj as Insertion, ak as InstrTextContent, al as LevelSuffix, am as LineNumberRestart, an as ListLevel, ao as ListRendering, ap as MathEquation, aq as MoveFrom, ar as MoveFromRangeEnd, as as MoveFromRangeStart, at as MoveTo, au as MoveToRangeEnd, av as MoveToRangeStart, aw as NoBreakHyphenContent, N as NoteKind, ax as NoteNumberRestart, ay as NoteRefMarkContent, az as NoteReferenceContent, aA as NoteSeparatorReference, aB as NumberFormat, aC as NumberingInstance, aD as PageNumberingProperties, aE as PageOrientation, P as Paragraph, aF as ParagraphContent, aG as ParagraphPropertyChange, aH as PictureWatermark, aI as PropertyChangeInfo, aJ as Run, aK as RunContent, aL as RunPropertyChange, aM as SdtCheckboxGlyph, a as SdtControlState, aN as SdtDataBinding, aO as SdtDateState, aP as SdtGalleryState, b as SdtProperties, aQ as SdtType, aR as Section, S as SectionProperties, aS as SectionStart, aT as SeparatorContent, aU as Shape, aV as ShapeContent, c as ShapeEffect, aW as ShapeFillPaint, aX as ShapeStrokePaint, aY as ShapeTextBody, d as ShapeTextBodyProperties, aZ as SimpleField, a_ as SoftHyphenContent, a$ as StructuredFieldContent, b0 as StructuredFieldTree, b1 as SymbolContent, b2 as TabContent, b3 as Table, b4 as TableCell, b5 as TableCellPropertyChange, b6 as TablePropertyChange, b7 as TableRow, b8 as TableRowPropertyChange, b9 as TableStructuralChangeInfo, ba as TextBox, bb as TextContent, bc as TextWatermark, bd as TrackedChangeInfo, be as TrackedRunChange, bf as VerticalAlign, W as Watermark, bg as pictureWatermarkDisplayEmu } from '../content-DrqzbIr7.mjs';
+import { f as Theme, C as ColorValue } from '../formatting-BqrFPeev.mjs';
+export { B as BorderSpec, g as CellMargins, h as ConditionalFormatStyle, E as EmphasisMark, F as FloatingTableProperties, L as LineSpacingRule, i as ParagraphAlignment, a as ParagraphFormatting, R as RunFontHint, j as RunLanguage, S as ShadingProperties, k as ShapeFill, l as ShapeOutline, m as ShapeType, n as TabLeader, o as TabStop, p as TabStopAlignment, q as TableBorders, e as TableCellFormatting, c as TableFormatting, r as TableLook, s as TableMeasurement, d as TableRowFormatting, t as TableStyleCascade, u as TableStyleRegion, v as TableWidthType, w as TextEffect, b as TextFormatting, T as TextModernEffects, x as ThemeColorScheme, y as ThemeColorSlot, z as ThemeFont, A as ThemeFontScheme, U as UnderlineStyle } from '../formatting-BqrFPeev.mjs';
+import { S as StyleDefinitions, F as FontTable, R as RelationshipMap, M as MediaFile } from '../styles-CMybYYHS.mjs';
+export { D as DocDefaults, b as FontEmbed, c as FontInfo, d as Relationship, e as RelationshipType, a as Style, f as StyleType } from '../styles-CMybYYHS.mjs';
 import '../docx/wrapTypes.mjs';
 
 interface CompatibilityFlags {
@@ -13,7 +13,7 @@ interface CompatibilityFlags {
     useWord97LineBreakRules: boolean;
     balanceSingleByteDoubleByteWidth: boolean;
 }
-/** Public model contract rehydrated by the Rust S9 facade. */
+/** Public model contract rehydrated by the Rust parser. */
 interface DocumentSettings {
     defaultTabStop: number;
     defaultTableStyle?: string;

package/dist/{types-C1rv3KM-.d.mts → types-CXLxVF1t.d.mts}

@@ -1,14 +1,14 @@
-import { a as SdtControlState, b as SdtProperties, R as RevisionInfo, C as CellMarker, D as DrawingScene, c as ShapeEffect, d as ShapeTextBodyProperties, e as Chart, W as Watermark, F as FootnoteProperties, E as EndnoteProperties } from './content-C3sTRz-u.mjs';
-import { T as TextModernEffects, P as PresetGeometryPathCommand, B as BorderSpec } from './formatting-BEkIBePP.mjs';
+import { a as SdtControlState, b as SdtProperties, R as RevisionInfo, C as CellMarker, D as DrawingScene, c as ShapeEffect, d as ShapeTextBodyProperties, e as Chart, W as Watermark, F as FootnoteProperties, E as EndnoteProperties } from './content-DrqzbIr7.mjs';
+import { T as TextModernEffects, P as PresetGeometryPathCommand, B as BorderSpec } from './formatting-BqrFPeev.mjs';
 
 /**
  * Inline SDT widget metadata carried by a painted text run.
  */
 interface InlineSdtWidget {
     kind: 'checkbox';
-    /** Stable per-document id derived from the ProseMirror node position. */
+    /** Stable per-document id derived from the node position. */
     groupId: string;
-    /** ProseMirror position of the inline SDT node. */
+    /** Document position of the inline SDT node. */
     pos: number;
     /** Word tag value (`w:tag`). */
     tag?: string;
@@ -20,7 +20,7 @@ interface InlineSdtWidget {
 /**
  * One run's visible slice on a laid-out line: the run to render/measure plus
  * its on-line text. For a boundary text run this is a shallow copy sliced to
- * the line's head/tail char (PM positions shifted to match); tabs, images,
+ * the line's head/tail char (document positions shifted to match); tabs, images,
  * line breaks, and fields pass through whole with an empty `text`. `text` is
  * the run's textual contribution to the line (empty for non-text runs), so
  * joining a line's segment texts reconstructs the line's visible characters.
@@ -195,9 +195,9 @@ type TextRun = RunFormatting & {
     text: string;
     /** Hyperlink information if this run is a link. */
     hyperlink?: HyperlinkInfo;
-    /** PM doc offset where the run's text begins. */
+    /** Document offset where the run's text begins. */
     pmStart?: number;
-    /** PM doc offset one past the run's final character. */
+    /** Document offset one past the run's final character. */
     pmEnd?: number;
     /** Inline content-control widget metadata when this run is the visible glyph. */
     inlineSdtWidget?: InlineSdtWidget;
@@ -432,6 +432,8 @@ type ParagraphAttrs = {
     indent?: ParagraphIndent;
     keepNext?: boolean;
     keepLines?: boolean;
+    /** w:widowControl, a toggle defaulting on: only an authored off is carried. */
+    widowControl?: boolean;
     pageBreakBefore?: boolean;
     styleId?: string;
     contextualSpacing?: boolean;
@@ -484,13 +486,13 @@ type ParagraphBlock = {
     sdtGroups?: SdtGroup[];
     kind: 'paragraph';
     id: BlockId;
-    /** Stable Word `w14:paraId` / PM `paraId`, when available. */
+    /** Stable Word `w14:paraId`, when available. */
     paraId?: string;
     runs: Run[];
     attrs?: ParagraphAttrs;
-    /** ProseMirror start position for this block. */
+    /** Document start position for this block. */
     pmStart?: number;
-    /** ProseMirror end position for this block. */
+    /** Document end position for this block. */
     pmEnd?: number;
 };
 /**
@@ -827,7 +829,7 @@ type ShapeBlock = {
     decorative?: boolean;
     title?: string;
     description?: string;
-    /** PM/doc positions for selection mapping. */
+    /** Document positions for selection mapping. */
     docStart?: number;
     docEnd?: number;
     pmStart?: number;
@@ -952,9 +954,9 @@ type TextBoxBlock = {
     };
     /** Paragraph blocks inside the text box */
     content: ParagraphBlock[];
-    /** Display mode copied from the ProseMirror text box node */
+    /** Display mode copied from the text box node */
     displayMode?: 'inline' | 'float' | 'block';
-    /** CSS float direction copied from the ProseMirror text box node */
+    /** CSS float direction copied from the text box node */
     cssFloat?: 'left' | 'right' | 'none';
     /** OOXML wrap type for anchored text boxes */
     wrapType?: string;
@@ -986,9 +988,9 @@ interface SdtGroup {
     checked?: boolean;
     bound?: boolean;
     repeatingItem?: boolean;
-    /** Authored numeric `w:id`; undefined = address by `id`/PM position. */
+    /** Authored numeric `w:id`; undefined = address by `id`/position. */
     controlId?: number;
-    /** Stable PM position for untagged controls. */
+    /** Stable document position for untagged controls. */
     pos?: number;
     /** Typed overlay state. Undefined = derive from content. */
     controlState?: SdtControlState;
@@ -1035,6 +1037,8 @@ type TypesetRow = {
     descent: number;
     /** Total line height in pixels. */
     lineHeight: number;
+    /** Deterministic line geometry produced without a measurement face. */
+    syntheticFallback?: boolean;
     /** Left offset from floating images (pixels from content left edge). */
     leftOffset?: number;
     /** Right offset from floating images (pixels from content right edge). */
@@ -1177,7 +1181,7 @@ type TextBoxExtent = {
 type BlockExtent = ParagraphExtent | ImageExtent | ShapeExtent | ChartExtent | TableExtent | TextBoxExtent | SectionBreakExtent | PageBreakExtent | ColumnBreakExtent;
 /**
  * Fields every fragment carries: which block it came from, where it sits on
- * its page, and the PM span it maps to.
+ * its page, and the document span it maps to.
  */
 type FragmentBase = {
     /** Block ID this fragment belongs to. */
@@ -1188,9 +1192,9 @@ type FragmentBase = {
     y: number;
     /** Width of the fragment. */
     width: number;
-    /** ProseMirror start position (for click mapping). */
+    /** Document start position (for click mapping). */
     pmStart?: number;
-    /** ProseMirror end position (for click mapping). */
+    /** Document end position (for click mapping). */
     pmEnd?: number;
 };
 /**
@@ -1274,7 +1278,7 @@ type ShapeFragment = FragmentBase & {
     kind: 'shape';
     /** Height of the shape bbox. */
     height: number;
-    /** PM/doc positions for display-list consumers that use docStart/docEnd names. */
+    /** Document positions for display-list consumers that use docStart/docEnd names. */
     docStart?: number;
     docEnd?: number;
     /** True when positioned outside normal flow. */
@@ -1547,7 +1551,7 @@ type LayoutOptions = {
     /** Per-page footnote reserved heights (pageNumber → height in pixels). */
     footnoteReservedHeights?: Map<number, number>;
     /** Section break type for the body-level (final) section (for section transition logic). */
-    bodyBreakType?: 'continuous' | 'nextPage' | 'evenPage' | 'oddPage';
+    bodyBreakType?: 'continuous' | 'nextPage' | 'evenPage' | 'oddPage' | 'nextColumn';
     /** Effective section states, indexed by section. Undefined = legacy globals. */
     sections?: Array<{
         sectionId?: string;
@@ -1579,8 +1583,8 @@ type HitTestResult = {
     localY?: number;
 };
 /**
- * A location expressed in block/run/character terms, with the matching PM
- * position when known.
+ * A location expressed in block/run/character terms, with the matching
+ * document position when known.
  */
 type DocumentPosition = {
     /** Block index. */
@@ -1589,7 +1593,7 @@ type DocumentPosition = {
     runIndex?: number;
     /** Character offset within the run. */
     charOffset?: number;
-    /** ProseMirror position. */
+    /** Document position. */
     pmPos?: number;
 };
 /**

package/dist/utils/comments.d.mts

@@ -1,5 +1,5 @@
-import { P as Paragraph, B as BlockContent, f as Comment } from '../content-C3sTRz-u.mjs';
-import '../formatting-BEkIBePP.mjs';
+import { P as Paragraph, B as BlockContent, f as Comment } from '../content-DrqzbIr7.mjs';
+import '../formatting-BqrFPeev.mjs';
 import '../docx/wrapTypes.mjs';
 
 /**