@betteroffice/docx 0.2.1 → 0.4.0

package/dist/parseWasm-NLAG22EU.mjs

@@ -0,0 +1 @@
+import'./chunk-LT2GCWZ3.mjs';export{h as decodeTiffImage,b as parseDocxS9Wire,c as parseRelationshipsXmlWire,a as preloadParseWasm,d as serializeDocxS10Wire,e as serializeDocxS11Wire,f as serializeDocxS12Wire,g as writeDocxS13Wire}from'./chunk-3CYO46ML.mjs';import'./chunk-6CHGYCFU.mjs';import'./chunk-TTRUPDAB.mjs';

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-DF8F6fMl.mjs';
+import { RenderedDomContext, PositionCoordinates, PointPosition } from './index.mjs';
+import { D as DisplayListRect, a as DisplayListQueries } from '../displayListQueries-H5YnU_hX.mjs';
 import '../types/document.mjs';
-import '../content-CvEtPl0c.mjs';
-import '../formatting-7zKCTu5a.mjs';
+import '../content-BzoC6bSz.mjs';
+import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-7e-mq3c-.mjs';
-import '../frameDelta-pA4jrQ1G.mjs';
-import '../rustDisplayList-BJqaN9tt.mjs';
-import '../types-C4A8mWjU.mjs';
+import '../styles-AryxLAhx.mjs';
+import '../frameDelta-ByU7HBuB.mjs';
+import '../rustDisplayList-LcRZHCSL.mjs';
+import '../types-D6Pra38E.mjs';
 import '../layout/pagination/index.mjs';
 
 /**
@@ -62,6 +62,8 @@ declare class RenderedDomContextImpl implements RenderedDomContext {
     private readonly queries;
     private readonly projector;
     constructor(pagesContainer: HTMLElement, zoom?: number, options?: RenderedDomContextOptions);
+    /** Client pixels per unit of this context: its zoom times the container's ancestor CSS zoom. */
+    private clientScale;
     /**
      * Run spans (`data-doc-start`/`data-doc-end`) in reading order, deep-queried
      * from the a11y mirror subtree nested under `.canvas-pages`.
@@ -74,6 +76,7 @@ declare class RenderedDomContextImpl implements RenderedDomContext {
      * Uses the browser's text rendering via Range API for precise positioning.
      */
     getCoordinatesForPosition(position: number): PositionCoordinates | null;
+    getPositionAtPoint(clientX: number, clientY: number): PointPosition | null;
     /**
      * Find DOM elements that overlap with a display-position range.
      */
@@ -109,6 +112,6 @@ declare class RenderedDomContextImpl implements RenderedDomContext {
  * @param options - query/projector backend options. Omit for the mirror-DOM
  *   fallback.
  */
-declare function createRenderedDomContext(pagesContainer: HTMLElement, zoom?: number, options?: RenderedDomContextOptions): RenderedDomContext;
+declare function createRenderedDomContext(pagesContainer: HTMLElement, zoom?: number, options?: RenderedDomContextOptions): RenderedDomContext & Required<Pick<RenderedDomContext, 'getPositionAtPoint'>>;
 
 export { type DisplayListPageProjector, type ProjectedDisplayListRect, RenderedDomContextImpl, type RenderedDomContextOptions, createCanvasHostProjector, createRenderedDomContext };

package/dist/plugin-api/RenderedDomContext.mjs

@@ -1 +1 @@
-import {a}from'../chunk-WRWRCBLK.mjs';import {b}from'../chunk-TTRUPDAB.mjs';function E(h,n,s=1){let t=s>0?s:1,o=e=>{let r=n.pageSize(e.pageIndex),i=a(h,n,e.pageIndex);if(!i||!r||r.width<=0||r.height<=0)return null;let a$1=h.getBoundingClientRect(),c=i.width/r.width,u=i.height/r.height;return {x:(i.left-a$1.left+e.x*c)/t,y:(i.top-a$1.top+e.y*u)/t,width:e.width*c/t,height:e.height*u/t}};return {projectRect:o,getPageBounds:e=>{let r=n.pageBounds(e);return r?o(r):null}}}var f=class{constructor(n,s=1,t){b(this,"pagesContainer");b(this,"zoom");b(this,"queries");b(this,"projector");if(this.pagesContainer=n,this.zoom=s,this.queries=t?.displayListQueries??null,this.projector=t?.projector??null,this.queries===null!=(this.projector===null))throw new Error("RenderedDomContext requires displayListQueries and projector together")}spanEntries(){let n=[],s=Array.from(this.pagesContainer.querySelectorAll(".layout-page-content")),t=s.length>0?s:[this.pagesContainer];for(let o of t)for(let e of Array.from(o.querySelectorAll("span[data-doc-start][data-doc-end]")))n.push({el:e,start:Number(e.dataset.docStart),end:Number(e.dataset.docEnd)});return n}emptyRuns(){return Array.from(this.pagesContainer.querySelectorAll(".layout-empty-run"))}getCoordinatesForPosition(n){if(this.queries&&this.projector){let t=this.queries.caretRect(n),o=t?this.projector.projectRect(t):null;return o?{x:o.x,y:o.y,height:o.height}:null}let s=this.pagesContainer.getBoundingClientRect();for(let{el:t,start:o,end:e}of this.spanEntries()){let r=t;if(t.classList.contains("layout-run-tab")){if(n>=o&&n<e){let i=t.getBoundingClientRect(),a=t.closest(".layout-line"),c=a?a.offsetHeight:16;return {x:(i.left-s.left)/this.zoom,y:(i.top-s.top)/this.zoom,height:c/this.zoom}}continue}if(n>=o&&n<=e&&r.firstChild?.nodeType===Node.TEXT_NODE){let i=r.firstChild,a=Math.min(n-o,i.length),c=t.ownerDocument;if(!c)continue;let u=c.createRange();u.setStart(i,a),u.setEnd(i,a);let p=u.getBoundingClientRect(),d=t.closest(".layout-line"),l=d?d.offsetHeight:16;return {x:(p.left-s.left)/this.zoom,y:(p.top-s.top)/this.zoom,height:l/this.zoom}}}for(let t of this.emptyRuns()){let o=t.closest(".layout-paragraph");if(!o)continue;let e=Number(o.dataset.docStart),r=Number(o.dataset.docEnd);if(n>=e&&n<=r){let i=t.getBoundingClientRect(),a=t.closest(".layout-line"),c=a?a.offsetHeight:16;return {x:(i.left-s.left)/this.zoom,y:(i.top-s.top)/this.zoom,height:c/this.zoom}}}return null}findElementsForRange(n,s){let t=[];for(let{el:o,start:e,end:r}of this.spanEntries())r>n&&e<s&&t.push(o);return t}getRectsForRange(n,s){if(this.queries&&this.projector)return this.queries.rangeRects(n,s).map(e=>this.projector.projectRect(e)).filter(e=>e!==null);let t=this.pagesContainer.getBoundingClientRect(),o=[];for(let{el:e,start:r,end:i}of this.spanEntries()){let a=e;if(i>n&&r<s){if(e.classList.contains("layout-run-tab")){let l=e.getBoundingClientRect();o.push({x:(l.left-t.left)/this.zoom,y:(l.top-t.top)/this.zoom,width:l.width/this.zoom,height:l.height/this.zoom});continue}if(a.firstChild?.nodeType!==Node.TEXT_NODE)continue;let c=a.firstChild,u=e.ownerDocument;if(!u)continue;let p=Math.max(0,n-r),d=Math.min(c.length,s-r);if(p<d){let l=u.createRange();l.setStart(c,p),l.setEnd(c,d);let R=l.getClientRects();for(let m of Array.from(R))o.push({x:(m.left-t.left)/this.zoom,y:(m.top-t.top)/this.zoom,width:m.width/this.zoom,height:m.height/this.zoom});}}}return o}getCoordinatesForHfPosition(n,s,t,o){if(!this.queries||!this.projector)return null;let e=this.queries.hfCaretRects(n,s,t).find(i=>i.pageIndex===o),r=e?this.projector.projectRect(e):null;return r?{x:r.x,y:r.y,height:r.height}:null}getRectsForHfRange(n,s,t,o,e){return !this.queries||!this.projector?[]:this.queries.hfRangeRects(n,s,t,o).filter(r=>r.pageIndex===e).map(r=>this.projector.projectRect(r)).filter(r=>r!==null)}getPageBounds(n){if(this.projector)return this.projector.getPageBounds(n);let s=this.pagesContainer.querySelectorAll(".layout-page"),t=Array.from(s).find((r,i)=>Number(r.dataset.pageIndex??i)===n);if(!t)return null;let o=t.getBoundingClientRect(),e=this.pagesContainer.getBoundingClientRect();return {x:(o.left-e.left)/this.zoom,y:(o.top-e.top)/this.zoom,width:o.width/this.zoom,height:o.height/this.zoom}}getContainerOffset(){let n=this.pagesContainer.parentElement;if(!n)return {x:0,y:0};let s=this.pagesContainer.getBoundingClientRect(),t=n.getBoundingClientRect();return {x:(s.left-t.left)/this.zoom,y:(s.top-t.top)/this.zoom}}};function L(h,n=1,s){return new f(h,n,s)}export{f as RenderedDomContextImpl,E as createCanvasHostProjector,L as createRenderedDomContext};
+import {a,h,d,g}from'../chunk-AOWJ4WDE.mjs';import {b}from'../chunk-TTRUPDAB.mjs';function D(h,r,o=1){let i=o>0?o:1,e=t=>{let n=r.pageSize(t.pageIndex),s=g(h,r,t.pageIndex);if(!s||!n||n.width<=0||n.height<=0)return null;let a$1=h.getBoundingClientRect(),c=s.width/n.width,l=s.height/n.height,u=i*a(h);return {x:(s.left-a$1.left+t.x*c)/u,y:(s.top-a$1.top+t.y*l)/u,width:t.width*c/u,height:t.height*l/u}};return {projectRect:e,getPageBounds:t=>{let n=r.pageBounds(t);return n?e(n):null}}}var R=class{constructor(r,o=1,i){b(this,"pagesContainer");b(this,"zoom");b(this,"queries");b(this,"projector");if(this.pagesContainer=r,this.zoom=o,this.queries=i?.displayListQueries??null,this.projector=i?.projector??null,this.queries===null!=(this.projector===null))throw new Error("RenderedDomContext requires displayListQueries and projector together")}clientScale(){return this.zoom*a(this.pagesContainer)}spanEntries(){let r=[],o=Array.from(this.pagesContainer.querySelectorAll(".layout-page-content")),i=o.length>0?o:[this.pagesContainer];for(let e of i)for(let t of Array.from(e.querySelectorAll("span[data-doc-start][data-doc-end]")))r.push({el:t,start:Number(t.dataset.docStart),end:Number(t.dataset.docEnd)});return r}emptyRuns(){return Array.from(this.pagesContainer.querySelectorAll(".layout-empty-run"))}getCoordinatesForPosition(r){if(this.queries&&this.projector){let e=this.queries.caretRect(r),t=e?this.projector.projectRect(e):null;return t?{x:t.x,y:t.y,height:t.height}:null}let o=this.pagesContainer.getBoundingClientRect(),i=this.clientScale();for(let{el:e,start:t,end:n}of this.spanEntries()){let s=e;if(e.classList.contains("layout-run-tab")){if(r>=t&&r<n){let a=e.getBoundingClientRect(),c=e.closest(".layout-line"),l=c?c.offsetHeight:16;return {x:(a.left-o.left)/i,y:(a.top-o.top)/i,height:l/this.zoom}}continue}if(r>=t&&r<=n&&s.firstChild?.nodeType===Node.TEXT_NODE){let a=s.firstChild,c=Math.min(r-t,a.length),l=e.ownerDocument;if(!l)continue;let u=l.createRange();u.setStart(a,c),u.setEnd(a,c);let d=u.getBoundingClientRect(),g=e.closest(".layout-line"),p=g?g.offsetHeight:16;return {x:(d.left-o.left)/i,y:(d.top-o.top)/i,height:p/this.zoom}}}for(let e of this.emptyRuns()){let t=e.closest(".layout-paragraph");if(!t)continue;let n=Number(t.dataset.docStart),s=Number(t.dataset.docEnd);if(r>=n&&r<=s){let a=e.getBoundingClientRect(),c=e.closest(".layout-line"),l=c?c.offsetHeight:16;return {x:(a.left-o.left)/i,y:(a.top-o.top)/i,height:l/this.zoom}}}return null}getPositionAtPoint(r,o){if(!this.queries||!Number.isFinite(r)||!Number.isFinite(o))return null;let i=h(this.pagesContainer,this.queries,r,o),e=i?.hit;return !i||!e||e.pos===null||e.target!=="text"||(e.region==="header"||e.region==="footer")&&!e.rId||(e.region==="footnote"||e.region==="endnote")&&e.noteId===void 0?null:{position:e.pos,pageIndex:i.pageIndex,region:e.region,...e.rId===void 0?{}:{rId:e.rId},...e.noteId===void 0?{}:{noteId:e.noteId}}}findElementsForRange(r,o){if(this.queries){let e=new Set(this.queries.rangeRects(r,o).map(t=>t.pageIndex));d(this.pagesContainer,[...e]);}let i=[];for(let{el:e,start:t,end:n}of this.spanEntries())n>r&&t<o&&i.push(e);return i}getRectsForRange(r,o){if(this.queries&&this.projector)return this.queries.rangeRects(r,o).map(n=>this.projector.projectRect(n)).filter(n=>n!==null);let i=this.pagesContainer.getBoundingClientRect(),e=this.clientScale(),t=[];for(let{el:n,start:s,end:a}of this.spanEntries()){let c=n;if(a>r&&s<o){if(n.classList.contains("layout-run-tab")){let p=n.getBoundingClientRect();t.push({x:(p.left-i.left)/e,y:(p.top-i.top)/e,width:p.width/e,height:p.height/e});continue}if(c.firstChild?.nodeType!==Node.TEXT_NODE)continue;let l=c.firstChild,u=n.ownerDocument;if(!u)continue;let d=Math.max(0,r-s),g=Math.min(l.length,o-s);if(d<g){let p=u.createRange();p.setStart(l,d),p.setEnd(l,g);let E=p.getClientRects();for(let m of Array.from(E))t.push({x:(m.left-i.left)/e,y:(m.top-i.top)/e,width:m.width/e,height:m.height/e});}}}return t}getCoordinatesForHfPosition(r,o,i,e){if(!this.queries||!this.projector)return null;let t=this.queries.hfCaretRects(r,o,i).find(s=>s.pageIndex===e),n=t?this.projector.projectRect(t):null;return n?{x:n.x,y:n.y,height:n.height}:null}getRectsForHfRange(r,o,i,e,t){return !this.queries||!this.projector?[]:this.queries.hfRangeRects(r,o,i,e).filter(n=>n.pageIndex===t).map(n=>this.projector.projectRect(n)).filter(n=>n!==null)}getPageBounds(r){if(this.projector)return this.projector.getPageBounds(r);let o=this.pagesContainer.querySelectorAll(".layout-page"),i=Array.from(o).find((s,a)=>Number(s.dataset.pageIndex??a)===r);if(!i)return null;let e=i.getBoundingClientRect(),t=this.pagesContainer.getBoundingClientRect(),n=this.clientScale();return {x:(e.left-t.left)/n,y:(e.top-t.top)/n,width:e.width/n,height:e.height/n}}getContainerOffset(){let r=this.pagesContainer.parentElement;if(!r)return {x:0,y:0};let o=this.pagesContainer.getBoundingClientRect(),i=r.getBoundingClientRect(),e=this.clientScale();return {x:(o.left-i.left)/e,y:(o.top-i.top)/e}}};function H(h,r=1,o){return new R(h,r,o)}export{R as RenderedDomContextImpl,D as createCanvasHostProjector,H as createRenderedDomContext};

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

@@ -1,8 +1,8 @@
 import { Document } from '../types/document.mjs';
-import '../content-CvEtPl0c.mjs';
-import '../formatting-7zKCTu5a.mjs';
+import '../content-BzoC6bSz.mjs';
+import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-7e-mq3c-.mjs';
+import '../styles-AryxLAhx.mjs';
 
 /**
  * Framework-Agnostic Plugin Interface for the DOCX Editor
@@ -22,6 +22,14 @@ interface PositionCoordinates {
     y: number;
     height: number;
 }
+/** A caret position within a page's body, header, footer, or note. */
+interface PointPosition {
+    position: number;
+    pageIndex: number;
+    region: 'body' | 'header' | 'footer' | 'footnote' | 'endnote';
+    rId?: string;
+    noteId?: number;
+}
 /**
  * Context for accessing rendered-page geometry in the paged editor.
  *
@@ -41,6 +49,11 @@ interface RenderedDomContext {
      * Returns null if the position cannot be found.
      */
     getCoordinatesForPosition(position: number): PositionCoordinates | null;
+    /**
+     * Client coordinates to a region-local caret; null outside text or without ready canvas queries.
+     * Optional so contexts written before it keep compiling; a context without it answers null.
+     */
+    getPositionAtPoint?(clientX: number, clientY: number): PointPosition | null;
     /**
      * Find DOM elements that overlap with a display-position range.
      */
@@ -83,6 +96,7 @@ interface RenderedDomContext {
 }
 /**
  * Props passed to plugin panel components (framework-agnostic base).
+ * @deprecated Use `DocxPluginPanel` from `@betteroffice/docx-react`.
  */
 interface PluginPanelProps<TState = unknown> {
     /** Current serializer-facing document snapshot. */
@@ -103,6 +117,7 @@ interface PluginPanelProps<TState = unknown> {
 }
 /**
  * Configuration for plugin panel rendering.
+ * @deprecated Use `DocxPluginPanel` from `@betteroffice/docx-react`.
  */
 interface PanelConfig {
     /** Where to render the panel */
@@ -130,6 +145,7 @@ interface PanelConfig {
  *
  * Framework adapters (ReactEditorPlugin, VueEditorPlugin) extend this
  * with their own Panel component type and renderOverlay function.
+ * @deprecated Use `defineDocxPlugin` and the `plugins` prop of `@betteroffice/docx-react`.
  */
 interface EditorPluginCore<TState = any> {
     /** Unique plugin identifier */
@@ -180,6 +196,7 @@ interface SidebarItem {
 }
 /**
  * Context provided to plugins when computing sidebar items.
+ * @deprecated Use `DocxPluginSidebarItem` from `@betteroffice/docx-react`.
  */
 interface SidebarItemContext {
     document: Document | null;
@@ -189,4 +206,4 @@ interface SidebarItemContext {
     zoom: number;
 }
 
-export type { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext, SidebarItem, SidebarItemContext };
+export type { EditorPluginCore, PanelConfig, PluginPanelProps, PointPosition, PositionCoordinates, RenderedDomContext, SidebarItem, SidebarItemContext };

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

@@ -1,9 +1,9 @@
 import { SidebarItem, RenderedDomContext } from './index.mjs';
 import '../types/document.mjs';
-import '../content-CvEtPl0c.mjs';
-import '../formatting-7zKCTu5a.mjs';
+import '../content-BzoC6bSz.mjs';
+import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';
-import '../styles-7e-mq3c-.mjs';
+import '../styles-AryxLAhx.mjs';
 
 /**
  * Pure layout algorithm: given a list of sidebar items + their

package/dist/rezip-Bxiq4Z_R.d.mts

@@ -0,0 +1,24 @@
+import { Document } from './types/document.mjs';
+
+/**
+ * Public DOCX package I/O wrappers.
+ *
+ * Model serialization and selective package writing are Rust-owned. The
+ * TypeScript kept here is compatibility glue for public ZIP utilities and host
+ * values; package inflation/deflation continues through `docx-container` wasm.
+ * @packageDocumentation
+ * @public
+ */
+
+interface RepackOptions {
+    /** Retained for signature compatibility; `docx-container` chooses compression. */
+    compressionLevel?: number;
+    updateModifiedDate?: boolean;
+    modifiedBy?: string;
+}
+/** 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>;
+
+export { type RepackOptions as R, createDocx as c, repackDocx as r, updateMultipleFiles as u };

package/dist/{rustDisplayList-BJqaN9tt.d.mts → rustDisplayList-LcRZHCSL.d.mts}

@@ -1,6 +1,6 @@
-import { L as Layout } from './types-C4A8mWjU.mjs';
+import { L as Layout } from './types-D6Pra38E.mjs';
 import { MeasuredBlock } from './layout/pagination/index.mjs';
-import { D as DisplayList, R as RetainedFrame } from './frameDelta-pA4jrQ1G.mjs';
+import { D as DisplayList, R as RetainedFrame } from './frameDelta-ByU7HBuB.mjs';
 
 /**
  * JS seam to the Rust display-list builder.
@@ -205,6 +205,13 @@ interface RustDisplayListEngine {
     displayVerticalMoveJson?(position: number, direction: 'up' | 'down', goalX: number): string;
     displayRangeRectsJson?(from: number, to: number): string;
     displayRangeRectsRegionJson?(region: string, partId: string, from: number, to: number): string;
+    /** The bytes and media type of the part a `media:{n}` image source names. */
+    mediaSource?(token: string): {
+        bytes: Uint8Array;
+        mimeType: string;
+    } | null;
+    /** Changes whenever the package `mediaSource` reads changes. */
+    mediaScope?(): number;
 }
 type RustDisplayListSourceErrorStage = 'load' | 'build' | 'parse' | 'decode' | 'apply';
 interface RustDisplayFrameResult {
@@ -295,13 +302,14 @@ declare function buildRustDisplayList(inputs: DisplayListBuildInputs, engine?: R
  * 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
+ * before sending a delta rather than a full frame, unless `expectedFrameEpoch`
+ * overrides it (the engine numbers its frame after that epoch). 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>;
+declare function buildRustDisplayFrame(inputs: DisplayListBuildInputs, engine?: RustDisplayListEngine, previous?: RetainedFrame | null, expectedFrameEpoch?: number): Promise<RustDisplayFrameResult>;
 
 export { type DisplayListHeadersFooters as D, type RustDisplayListQueryEngine as R, type DisplayListBuildInputs as a, type DisplayListHfVariant as b, type DisplayListPictureWatermark as c, type DisplayListTextWatermark as d, type DisplayListWatermark as e, type RustDisplayFrameResult as f, type RustDisplayListEngine as g, RustDisplayListSourceError as h, type RustDisplayListSourceErrorStage as i, buildRustDisplayFrame as j, buildRustDisplayList as k, encodeDisplayListFrameExtras as l, loadRustDisplayListQueryEngine as m };

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

@@ -20,6 +20,8 @@ type FontScript = 'cjk-sc' | 'cjk-tc' | 'cjk-jp' | 'cjk-kr' | 'arabic' | 'hebrew
 interface BundledFontProvider {
     /** Resolve a Word family to bundled metric-compatible face byte loaders, or undefined. */
     resolve(family: string, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
+    /** Like {@link BundledFontProvider.resolve}, but also accepts bundled family names such as `"Gelasio"`, and never substitutes another style. */
+    resolveFamily?(family: string, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
     /**
      * Optional per-script coverage fallback (Noto CJK/RTL faces). Same loader
      * contract as {@link BundledFontProvider.resolve}; providers without
@@ -42,9 +44,10 @@ interface BundledFontProvider {
      * Optional so mock/partial providers can omit it; when absent (or returning
      * undefined) an unmapped family still yields an empty chain and the caller
      * browser-falls-back that run — the pre-policy behavior. Same lazy loader
-     * contract as {@link BundledFontProvider.resolve}.
+     * contract as {@link BundledFontProvider.resolve}. This registry passes
+     * `office: 'word'` so the pick follows Word's substitution.
      */
-    resolveLastResort?(family: string, bold: boolean, italic: boolean): (() => Promise<ArrayBuffer>) | undefined;
+    resolveLastResort?(family: string, bold: boolean, italic: boolean, office?: 'word' | 'powerpoint'): (() => Promise<ArrayBuffer>) | undefined;
 }
 /**
  * One embedded face extracted from the open document. Structurally identical
@@ -71,6 +74,13 @@ type BundledFontProviderSource = BundledFontProvider | (() => Promise<BundledFon
 
 interface RustTextEngine {
     registerFont(bytes: Uint8Array): number;
+    /**
+     * Measurement view of `id` carrying the vertical metrics and advance pitch
+     * Word measures `family` with; `id` when the engine knows none. Optional so
+     * a host that predates it still measures, with the substitute's own
+     * metrics.
+     */
+    registerSubstituteFont?(id: number, family: string): number;
     clearFonts(): void;
 }
 interface ResidentFontRequirement {
@@ -83,8 +93,8 @@ interface ResidentFontRequirement {
 interface ResidentMeasurementConfig {
     fontChains: Record<string, number[]>;
     defaults: {
-        fontSize: 11;
-        fontFamily: 'Calibri';
+        fontSize: number;
+        fontFamily: string;
     };
     compat: {
         noLeading: boolean;

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

@@ -19,27 +19,6 @@ interface ParseOptions {
 }
 declare function parseDocx(input: DocxInput, options?: ParseOptions): Promise<Document>;
 
-/**
- * Public DOCX package I/O wrappers.
- *
- * Model serialization and selective package writing are Rust-owned. The
- * TypeScript kept here is compatibility glue for public ZIP utilities and host
- * values; package inflation/deflation continues through `docx-container` wasm.
- * @packageDocumentation
- * @public
- */
-
-interface RepackOptions {
-    /** Retained for signature compatibility; `docx-container` chooses compression. */
-    compressionLevel?: number;
-    updateModifiedDate?: boolean;
-    modifiedBy?: string;
-}
-/** 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>;
-
 /** Rust-backed selective DOCX save compatibility wrapper. */
 
 interface SelectiveSaveOptions {
@@ -53,4 +32,4 @@ interface SelectiveSaveOptions {
  */
 declare function attemptSelectiveSave(doc: Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;
 
-export { attemptSelectiveSave as a, createDocx as c, parseDocx as p, repackDocx as r, updateMultipleFiles as u };
+export { attemptSelectiveSave as a, parseDocx as p };

package/dist/styles/index.d.mts

@@ -1,5 +1,5 @@
-import { a as ParagraphFormatting, b as TextFormatting } from '../formatting-7zKCTu5a.mjs';
-import { S as StyleDefinitions, a as Style, D as DocDefaults } from '../styles-7e-mq3c-.mjs';
+import { a as ParagraphFormatting, b as TextFormatting } from '../formatting-gqLFeJ9X.mjs';
+import { S as StyleDefinitions, a as Style, D as DocDefaults } from '../styles-AryxLAhx.mjs';
 
 /**
  * Style Resolver

package/dist/{styles-7e-mq3c-.d.mts → styles-AryxLAhx.d.mts}

@@ -1,4 +1,4 @@
-import { b as TextFormatting, a as ParagraphFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting } from './formatting-7zKCTu5a.mjs';
+import { b as TextFormatting, a as ParagraphFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting } from './formatting-gqLFeJ9X.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, d as Chart, p as ChartAxis, q as ChartContent, t as ChartLegend, x as ChartSeries, y as ChartType, z as Column, e 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, a6 as Hyperlink, a8 as Image, a9 as ImageCrop, ac as ImagePadding, ad as ImagePosition, af as ImageSize, ag as ImageTransform, ah as ImageWrap, aj as InlineSdt, ak as Insertion, al as InstrTextContent, an as LineNumberRestart, aq as MathEquation, ar as MoveFrom, as as MoveFromRangeEnd, at as MoveFromRangeStart, au as MoveTo, av as MoveToRangeEnd, aw as MoveToRangeStart, ax as NoBreakHyphenContent, ay as NoteNumberRestart, az as NoteRefMarkContent, aA as NoteReferenceContent, aF as PageOrientation, P as Paragraph, aG as ParagraphContent, aH as ParagraphPropertyChange, aI as PictureWatermark, aJ as PropertyChangeInfo, bi as RawXml, aK as Run, aL as RunContent, aM as RunPropertyChange, aO as SdtDataBinding, a as SdtProperties, aR as SdtType, aS as Section, f as SectionProperties, aT as SectionStart, aU as SeparatorContent, aV as Shape, aW as ShapeContent, aZ as ShapeTextBody, a_ as SimpleField, a$ as SoftHyphenContent, b2 as SymbolContent, b3 as TabContent, b4 as Table, b5 as TableCell, b6 as TableCellPropertyChange, b7 as TablePropertyChange, b8 as TableRow, b9 as TableRowPropertyChange, ba as TableStructuralChangeInfo, bb as TextBox, bc as TextContent, bd as TextWatermark, be as TrackedChangeInfo, bf as TrackedRunChange, bg as VerticalAlign, W as Watermark, bh as pictureWatermarkDisplayEmu } from '../content-CvEtPl0c.mjs';
-export { k as ShapeFill, l as ShapeOutline, m as ShapeType } from '../formatting-7zKCTu5a.mjs';
+export { B as BlockContent, l as BlockSdt, m as BookmarkEnd, n as BookmarkStart, o as BreakContent, d as Chart, p as ChartAxis, q as ChartContent, t as ChartLegend, x as ChartSeries, y as ChartType, z as Column, e 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, a6 as Hyperlink, a8 as Image, a9 as ImageCrop, ac as ImagePadding, ad as ImagePosition, af as ImageSize, ag as ImageTransform, ah as ImageWrap, aj as InlineSdt, ak as Insertion, al as InstrTextContent, an as LineNumberRestart, aq as MathEquation, ar as MoveFrom, as as MoveFromRangeEnd, at as MoveFromRangeStart, au as MoveTo, av as MoveToRangeEnd, aw as MoveToRangeStart, ax as NoBreakHyphenContent, ay as NoteNumberRestart, az as NoteRefMarkContent, aA as NoteReferenceContent, aF as PageOrientation, P as Paragraph, aG as ParagraphContent, aH as ParagraphPropertyChange, aI as PictureWatermark, aJ as PropertyChangeInfo, bi as RawXml, aK as Run, aL as RunContent, aM as RunPropertyChange, aO as SdtDataBinding, a as SdtProperties, aR as SdtType, aS as Section, f as SectionProperties, aT as SectionStart, aU as SeparatorContent, aV as Shape, aW as ShapeContent, aZ as ShapeTextBody, a_ as SimpleField, a$ as SoftHyphenContent, b2 as SymbolContent, b3 as TabContent, b4 as Table, b5 as TableCell, b6 as TableCellPropertyChange, b7 as TablePropertyChange, b8 as TableRow, b9 as TableRowPropertyChange, ba as TableStructuralChangeInfo, bb as TextBox, bc as TextContent, bd as TextWatermark, be as TrackedChangeInfo, bf as TrackedRunChange, bg as VerticalAlign, W as Watermark, bh as pictureWatermarkDisplayEmu } from '../content-BzoC6bSz.mjs';
+export { k as ShapeFill, l as ShapeOutline, m as ShapeType } from '../formatting-gqLFeJ9X.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, d as Chart, k as BookmarkRange } from '../content-CvEtPl0c.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, e 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 HorizontalRuleContent, a6 as Hyperlink, a7 as HyperlinkContent, a8 as Image, a9 as ImageCrop, aa as ImageEffect, ab as ImageHyperlink, ac as ImagePadding, ad as ImagePosition, ae as ImageRotationBounds, af as ImageSize, ag as ImageTransform, ah as ImageWrap, ai as ImageWrapPoint, aj as InlineSdt, ak as Insertion, al as InstrTextContent, am as LevelSuffix, an as LineNumberRestart, ao as ListLevel, ap as ListRendering, aq as MathEquation, ar as MoveFrom, as as MoveFromRangeEnd, at as MoveFromRangeStart, au as MoveTo, av as MoveToRangeEnd, aw as MoveToRangeStart, ax as NoBreakHyphenContent, N as NoteKind, ay as NoteNumberRestart, az as NoteRefMarkContent, aA as NoteReferenceContent, aB as NoteSeparatorReference, aC as NumberFormat, aD as NumberingInstance, aE as PageNumberingProperties, aF as PageOrientation, P as Paragraph, aG as ParagraphContent, aH as ParagraphPropertyChange, aI as PictureWatermark, aJ as PropertyChangeInfo, aK as Run, aL as RunContent, aM as RunPropertyChange, aN as SdtCheckboxGlyph, S as SdtControlState, aO as SdtDataBinding, aP as SdtDateState, aQ as SdtGalleryState, a as SdtProperties, aR as SdtType, aS as Section, f as SectionProperties, aT as SectionStart, aU as SeparatorContent, aV as Shape, aW as ShapeContent, b as ShapeEffect, aX as ShapeFillPaint, aY as ShapeStrokePaint, aZ as ShapeTextBody, c as ShapeTextBodyProperties, a_ as SimpleField, a$ as SoftHyphenContent, b0 as StructuredFieldContent, b1 as StructuredFieldTree, b2 as SymbolContent, b3 as TabContent, b4 as Table, b5 as TableCell, b6 as TableCellPropertyChange, b7 as TablePropertyChange, b8 as TableRow, b9 as TableRowPropertyChange, ba as TableStructuralChangeInfo, bb as TextBox, bc as TextContent, bd as TextWatermark, be as TrackedChangeInfo, bf as TrackedRunChange, bg as VerticalAlign, W as Watermark, bh as pictureWatermarkDisplayEmu } from '../content-CvEtPl0c.mjs';
-import { f as Theme, C as ColorValue } from '../formatting-7zKCTu5a.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-7zKCTu5a.mjs';
-import { S as StyleDefinitions, F as FontTable, R as RelationshipMap, M as MediaFile } from '../styles-7e-mq3c-.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-7e-mq3c-.mjs';
+import { F as FootnoteProperties, E as EndnoteProperties, g as DocumentBody, h as NumberingDefinitions, i as Footnote, j as Endnote, H as HeaderFooter, d as Chart, k as BookmarkRange } from '../content-BzoC6bSz.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, e 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 HorizontalRuleContent, a6 as Hyperlink, a7 as HyperlinkContent, a8 as Image, a9 as ImageCrop, aa as ImageEffect, ab as ImageHyperlink, ac as ImagePadding, ad as ImagePosition, ae as ImageRotationBounds, af as ImageSize, ag as ImageTransform, ah as ImageWrap, ai as ImageWrapPoint, aj as InlineSdt, ak as Insertion, al as InstrTextContent, am as LevelSuffix, an as LineNumberRestart, ao as ListLevel, ap as ListRendering, aq as MathEquation, ar as MoveFrom, as as MoveFromRangeEnd, at as MoveFromRangeStart, au as MoveTo, av as MoveToRangeEnd, aw as MoveToRangeStart, ax as NoBreakHyphenContent, N as NoteKind, ay as NoteNumberRestart, az as NoteRefMarkContent, aA as NoteReferenceContent, aB as NoteSeparatorReference, aC as NumberFormat, aD as NumberingInstance, aE as PageNumberingProperties, aF as PageOrientation, P as Paragraph, aG as ParagraphContent, aH as ParagraphPropertyChange, aI as PictureWatermark, aJ as PropertyChangeInfo, aK as Run, aL as RunContent, aM as RunPropertyChange, aN as SdtCheckboxGlyph, S as SdtControlState, aO as SdtDataBinding, aP as SdtDateState, aQ as SdtGalleryState, a as SdtProperties, aR as SdtType, aS as Section, f as SectionProperties, aT as SectionStart, aU as SeparatorContent, aV as Shape, aW as ShapeContent, b as ShapeEffect, aX as ShapeFillPaint, aY as ShapeStrokePaint, aZ as ShapeTextBody, c as ShapeTextBodyProperties, a_ as SimpleField, a$ as SoftHyphenContent, b0 as StructuredFieldContent, b1 as StructuredFieldTree, b2 as SymbolContent, b3 as TabContent, b4 as Table, b5 as TableCell, b6 as TableCellPropertyChange, b7 as TablePropertyChange, b8 as TableRow, b9 as TableRowPropertyChange, ba as TableStructuralChangeInfo, bb as TextBox, bc as TextContent, bd as TextWatermark, be as TrackedChangeInfo, bf as TrackedRunChange, bg as VerticalAlign, W as Watermark, bh as pictureWatermarkDisplayEmu } from '../content-BzoC6bSz.mjs';
+import { f as Theme, C as ColorValue } from '../formatting-gqLFeJ9X.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-gqLFeJ9X.mjs';
+import { S as StyleDefinitions, F as FontTable, R as RelationshipMap, M as MediaFile } from '../styles-AryxLAhx.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-AryxLAhx.mjs';
 import '../docx/wrapTypes.mjs';
 
 interface CompatibilityFlags {
@@ -12,6 +12,9 @@ interface CompatibilityFlags {
     doNotExpandShiftReturn: boolean;
     useWord97LineBreakRules: boolean;
     balanceSingleByteDoubleByteWidth: boolean;
+    doNotUseHTMLParagraphAutoSpacing?: boolean;
+    suppressSpBfAfterPgBrk?: boolean;
+    allowSpaceOfSameStyleInTable?: boolean;
 }
 /** Public model contract rehydrated by the Rust parser. */
 interface DocumentSettings {

package/dist/{types-C4A8mWjU.d.mts → types-D6Pra38E.d.mts}

@@ -1,5 +1,5 @@
-import { S as SdtControlState, a as SdtProperties, R as RevisionInfo, C as CellMarker, D as DrawingScene, b as ShapeEffect, c as ShapeTextBodyProperties, d as Chart, W as Watermark, F as FootnoteProperties, E as EndnoteProperties } from './content-CvEtPl0c.mjs';
-import { T as TextModernEffects, P as PresetGeometryPathCommand, B as BorderSpec } from './formatting-7zKCTu5a.mjs';
+import { S as SdtControlState, a as SdtProperties, R as RevisionInfo, C as CellMarker, D as DrawingScene, b as ShapeEffect, c as ShapeTextBodyProperties, d as Chart, W as Watermark, F as FootnoteProperties, E as EndnoteProperties } from './content-BzoC6bSz.mjs';
+import { T as TextModernEffects, P as PresetGeometryPathCommand, B as BorderSpec } from './formatting-gqLFeJ9X.mjs';
 
 /**
  * Inline SDT widget metadata carried by a painted text run.
@@ -128,6 +128,8 @@ type RunFormatting = {
     emphasisMark?: 'dot' | 'comma' | 'circle' | 'underDot';
     /** Hidden run (OOXML w:vanish, §17.3.2.41). Painter skips the run. */
     hidden?: boolean;
+    /** Run-level document-grid opt-out (OOXML w:snapToGrid, §17.3.2). Absent = on. */
+    snapToGrid?: boolean;
     /**
      * Per-run right-to-left direction (OOXML w:rtl, §17.3.2.30). Independent
      * from the paragraph's bidi flag — a single run may flip direction within
@@ -330,6 +332,8 @@ type ImageRun = {
     changeRevisionId?: number;
     pmStart?: number;
     pmEnd?: number;
+    /** Native inline DrawingML payload; present only for textless inline shapes. */
+    inlineShape?: unknown;
 };
 /** Run for an explicit w:br — ends the line, not the paragraph. */
 type LineBreakRun = {
@@ -346,16 +350,22 @@ type FieldRun = RunFormatting & {
     fieldType: 'PAGE' | 'NUMPAGES' | 'DATE' | 'TIME' | 'OTHER';
     /**
      * Raw Word field type token (e.g. `TOC`, `PAGEREF`) when `fieldType`
-     * collapsed it to a painter category. Carried for a11y announcement only.
+     * collapsed it to a painter category. Carried for a11y announcement, and
+     * read to number `SEQ` fields.
      */
     rawType?: string;
     /**
      * Raw field instruction text (`w:instrText`), carried INERT so the display
-     * list can announce field identity. Never parsed into behavior or executed.
+     * list can announce field identity. Never executed; only a `SEQ` field's is
+     * parsed, to number it.
      */
     instruction?: string;
-    /** Fallback text if field can't be resolved */
+    /** Text shown when the painter doesn't resolve the field: Word's cached result, or a `SEQ` field's number. */
     fallback?: string;
+    /** `w:fldLock`: the field keeps its cached result. */
+    locked?: boolean;
+    /** Sequences of `SEQ` fields nested in this field; they keep their cached results. */
+    nestedSequences?: string[];
     pmStart?: number;
     pmEnd?: number;
 };
@@ -438,6 +448,11 @@ type ParagraphAttrs = {
     /** w:widowControl, a toggle defaulting on: only an authored off is carried. */
     widowControl?: boolean;
     pageBreakBefore?: boolean;
+    /**
+     * The paragraph opens with a hard `w:br w:type="page"` run rather than
+     * carrying `w:pageBreakBefore`; Word keeps its space-before.
+     */
+    pageBreakBeforeRun?: boolean;
     styleId?: string;
     effectiveStyleId?: string;
     contextualSpacing?: boolean;
@@ -484,6 +499,14 @@ type ParagraphAttrs = {
     pPrIns?: RevisionInfo | null;
     /** Tracked-change marker on the paragraph mark (`<w:pPr><w:rPr><w:del/>`). */
     pPrDel?: RevisionInfo | null;
+    /** Paragraph-level document-grid opt-out (OOXML w:snapToGrid, §17.3.1). Absent = on. */
+    snapToGrid?: boolean;
+    /** East Asian / Latin auto-spacing opt-out (OOXML w:autoSpaceDE, §17.3.1.11). Absent = on. */
+    autoSpaceDE?: boolean;
+    /** East Asian / number auto-spacing opt-out (OOXML w:autoSpaceDN, §17.3.1.12). Absent = on. */
+    autoSpaceDN?: boolean;
+    /** Section grid pitch in px (w:docGrid w:linePitch), gated to an activating grid type. Absent = no snap. */
+    docGridPitchPx?: number;
 };
 /**
  * Flow block for one paragraph: its runs plus resolved attributes.
@@ -818,6 +841,7 @@ type ShapeBlock = {
     y?: number;
     /** Optional inner paragraphs for future text-bearing shape rendering. */
     innerText?: ParagraphBlock[];
+    nestedSequences?: string[];
     /** Pre-measured inner paragraph measures for display-list shape text. */
     innerMeasures?: ParagraphExtent[];
     /** Child shapes positioned relative to this shape's top-left corner. */
@@ -1498,6 +1522,8 @@ type Layout = {
     footers?: Record<string, HeaderFooterLayout>;
     /** Gap between pages in pixels (for rendering). */
     pageGap?: number;
+    /** Lays out only part of the document, so its page count is not the document's. */
+    partial?: boolean;
 };
 /**
  * Measured header/footer heights keyed by variant.

package/dist/utils/comments.d.mts

@@ -1,5 +1,5 @@
-import { P as Paragraph, B as BlockContent, e as Comment } from '../content-CvEtPl0c.mjs';
-import '../formatting-7zKCTu5a.mjs';
+import { P as Paragraph, B as BlockContent, e as Comment } from '../content-BzoC6bSz.mjs';
+import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';
 
 /**

package/dist/utils/index.d.mts

@@ -1,12 +1,13 @@
 export { PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels } from './units.mjs';
-export { F as FONT_MAPPING, C as FontDefinition, T as ThemeMatrixCell, b as blendColors, c as canRenderFont, a as colorsEqual, d as createRgbColor, e as createThemeColor, f as darkenColor, g as ensureHexPrefix, D as extractFontsFromDocument, h as generateThemeTintShadeMatrix, i as getContrastingColor, E as getGoogleFontEquivalent, j as getLoadedFonts, k as getThemeTintShadeHex, l as isBlack, m as isFontLoaded, o as isGoogleFontsEnabled, n as isLoading, p as isWhite, q as lightenColor, G as loadDocumentFonts, r as loadFont, H as loadFontDefinitions, s as loadFontFromBuffer, I as loadFontFromUrl, J as loadFontWithMapping, t as loadFonts, K as loadFontsWithMapping, L as onFontError, u as onFontsLoaded, v as parseColorString, w as preloadCommonFonts, x as resolveColor, M as resolveColorToHex, y as resolveHighlightColor, z as resolveHighlightToCss, A as resolveShadingColor, B as setGoogleFontsEnabled } from '../fontLoader-b8eicJKV.mjs';
+import { F as FontLoadScope } from '../fontLoader-BNSs0E8K.mjs';
+export { C as BufferFaceInput, D as FONT_MAPPING, E as FontDefinition, T as ThemeMatrixCell, b as blendColors, c as canRenderFont, a as colorsEqual, G as createFontLoadScope, d as createRgbColor, e as createThemeColor, f as darkenColor, g as ensureHexPrefix, H as extractFontsFromDocument, h as generateThemeTintShadeMatrix, i as getContrastingColor, I as getGoogleFontEquivalent, j as getLoadedFonts, k as getThemeTintShadeHex, l as isBlack, m as isFontLoaded, o as isGoogleFontsEnabled, n as isLoading, p as isWhite, q as lightenColor, J as loadDocumentFonts, r as loadFont, K as loadFontDefinitions, s as loadFontFromBuffer, L as loadFontFromUrl, M as loadFontWithMapping, t as loadFonts, N as loadFontsWithMapping, O as onFontError, u as onFontsLoaded, v as parseColorString, w as preloadCommonFonts, P as registerDocumentFaces, x as resolveColor, Q as resolveColorToHex, y as resolveHighlightColor, z as resolveHighlightToCss, A as resolveShadingColor, B as setGoogleFontsEnabled } from '../fontLoader-BNSs0E8K.mjs';
 export { D as DocxInput, t as toArrayBuffer } from '../docxInput-DTbCa48g.mjs';
-import { F as FontTable } from '../styles-7e-mq3c-.mjs';
+import { F as FontTable } from '../styles-AryxLAhx.mjs';
 import { Document } from '../types/document.mjs';
 import { FontOption } from './fontOptions.mjs';
 export { MIN_CARD_GAP, SIDEBAR_DOCUMENT_SHIFT, SIDEBAR_PAGE_GAP, SIDEBAR_WIDTH } from './sidebarConstants.mjs';
-import { e as Comment } from '../content-CvEtPl0c.mjs';
-import '../formatting-7zKCTu5a.mjs';
+import { e as Comment } from '../content-BzoC6bSz.mjs';
+import '../formatting-gqLFeJ9X.mjs';
 import '../docx/wrapTypes.mjs';
 
 /**
@@ -109,6 +110,17 @@ declare function extractEmbeddedFontFaces(document: Document): Promise<EmbeddedF
  * @public
  */
 declare function loadEmbeddedFonts(fontTable: FontTable | undefined, rawFonts: ReadonlyMap<string, ArrayBuffer>, fontTableRelsXml: string | null | undefined): Promise<Set<string>>;
+/**
+ * {@link loadEmbeddedFonts}, resolving to the CSS family each embedded family
+ * was registered under: its own name, or an alias when another live document
+ * registered different faces under that name (see {@link registerDocumentFaces}).
+ * With a scope, the faces are held until its next document or its disposal,
+ * and a call that a later document load into the scope overtook resolves to
+ * an empty map.
+ *
+ * @public
+ */
+declare function loadEmbeddedFontFamilies(fontTable: FontTable | undefined, rawFonts: ReadonlyMap<string, ArrayBuffer>, fontTableRelsXml: string | null | undefined, scope?: FontLoadScope): Promise<Map<string, string>>;
 
 /**
  * Discover the fonts a document actually references and that the browser can
@@ -208,6 +220,9 @@ interface HeadingInfo {
  * Detection logic:
  * 1. Check `outlineLevel` attr (set by OOXML parsing or style resolution)
  * 2. Fallback to `styleId` matching /^[Hh]eading(\d)$/
+ *
+ * @deprecated A legacy tree walker kept for compatibility. `YrsSession.headings(story)` classifies
+ * headings with the engine's resolver, which also reads style inheritance and document defaults.
  */
 declare function collectHeadings(doc: EditorTreeNode): HeadingInfo[];
 
@@ -485,4 +500,4 @@ declare function createComment(allocator: CommentIdAllocator, text: string, auth
  */
 declare function sanitizeHref(href: string | null | undefined): string | undefined;
 
-export { type CellAnchor, type ColorMode, type CommentIdAllocator, DEFAULT_PARAGRAPH_FLASH_COLOR, DEFAULT_PARAGRAPH_FLASH_DURATION_MS, type EmbeddedFontFace, type HeadingInfo, PARAGRAPH_FLASH_CLASS_NAME, PENDING_COMMENT_ID, type ParagraphHighlightOptions, type ReadDocxFileResult, type RenderableFontOptions, type ScrollToParaIdOptions, type SplitLayoutResult, type SplitTarget, type WordSelectionResult, buildAnchorMaps, collectHeadings, computeSplitDialogDefaults, computeSplitLayout, createComment, createCommentIdAllocator, createDoubleClickWordSelector, createTripleClickParagraphSelector, deobfuscateFont, excludeFontsByName, expandSelectionToWordBoundaries, extractEmbeddedFontFaces, findParagraphFragmentsByParaId, findWordAt, findWordBoundaries, flashParagraphElements, flashParagraphFragmentsByParaId, getEmbeddedFontFaces, getEmbeddedFontFamilies, getRenderableDocumentFonts, getWordAt, handleClickForMultiClick, isValidFontKey, loadEmbeddedFonts, prefersColorSchemeDark, readDocxFileFromInput, redistributeColumnWidths, resolveIsDark, sanitizeHref, selectParagraphAtCursor, selectRenderableFonts, selectWordAtCursor, selectWordInTextNode, subscribeSystemDark, sumColumnWidths };
+export { type CellAnchor, type ColorMode, type CommentIdAllocator, DEFAULT_PARAGRAPH_FLASH_COLOR, DEFAULT_PARAGRAPH_FLASH_DURATION_MS, type EmbeddedFontFace, FontLoadScope, type HeadingInfo, PARAGRAPH_FLASH_CLASS_NAME, PENDING_COMMENT_ID, type ParagraphHighlightOptions, type ReadDocxFileResult, type RenderableFontOptions, type ScrollToParaIdOptions, type SplitLayoutResult, type SplitTarget, type WordSelectionResult, buildAnchorMaps, collectHeadings, computeSplitDialogDefaults, computeSplitLayout, createComment, createCommentIdAllocator, createDoubleClickWordSelector, createTripleClickParagraphSelector, deobfuscateFont, excludeFontsByName, expandSelectionToWordBoundaries, extractEmbeddedFontFaces, findParagraphFragmentsByParaId, findWordAt, findWordBoundaries, flashParagraphElements, flashParagraphFragmentsByParaId, getEmbeddedFontFaces, getEmbeddedFontFamilies, getRenderableDocumentFonts, getWordAt, handleClickForMultiClick, isValidFontKey, loadEmbeddedFontFamilies, loadEmbeddedFonts, prefersColorSchemeDark, readDocxFileFromInput, redistributeColumnWidths, resolveIsDark, sanitizeHref, selectParagraphAtCursor, selectRenderableFonts, selectWordAtCursor, selectWordInTextNode, subscribeSystemDark, sumColumnWidths };