ooxml-core 1.12.2 → 1.14.0

package/dist/docx/inline-model.d.ts

@@ -1,6 +1,7 @@
 import type { DocxChart } from './chart.js';
 import type { DocxDiagram } from './diagram.js';
 import type { StRelFromH, StRelFromV } from './generated/wml-simple-types.js';
+import type { ShapeSpec } from './shape-model.js';
 /** An inline drawing (`w:drawing` or legacy `w:pict`) modeled at run granularity. */
 export interface InlineImage {
     /** Relationship id in `word/_rels/document.xml.rels` pointing at the media part. */
@@ -30,6 +31,8 @@ export interface InlineImage {
     textBoxEditable?: boolean;
     /** For an editable text box: whether it draws an outline (default true). */
     textBoxBorder?: boolean;
+    /** For a drawing shape (`unsupported: "Shape"`): its preset geometry, fill, outline and text. */
+    shape?: ShapeSpec;
     /** For SmartArt (`unsupported: "SmartArt"`): its parts, extent and cached drawing; the markup and parts are preserved on save. */
     diagram?: DocxDiagram;
     /** For a chart (`unsupported: "Chart"`): its part and the parsed `c:chartSpace`; the markup and parts are preserved on save. */

package/dist/docx/inline-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline-model.d.ts","sourceRoot":"","sources":["../../docx/inline-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE3E,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC3B,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,0GAA0G;IAC1G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uGAAuG;IACvG,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,8IAA8I;IAC9I,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oGAAoG;IACpG,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kIAAkI;IAClI,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gIAAgI;IAChI,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB;AACD,uGAAuG;AACvG,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;CAClC;AACD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;IAC/D,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,UAAU,CAAC;CAC3B;AACD,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"inline-model.d.ts","sourceRoot":"","sources":["../../docx/inline-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC3B,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,0GAA0G;IAC1G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uGAAuG;IACvG,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,8IAA8I;IAC9I,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oGAAoG;IACpG,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iGAAiG;IACjG,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kIAAkI;IAClI,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gIAAgI;IAChI,KAAK,CAAC,EAAE,SAAS,CAAC;CAClB;AACD,uGAAuG;AACvG,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,YAAY,CAAC;CAClC;AACD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;IAC/D,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,UAAU,CAAC;CAC3B;AACD,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/docx/layout/adapt-floats.d.ts

@@ -1,8 +1,8 @@
-import type { Paragraph } from '../index.js';
+import type { Paragraph, ThemeCatalog } from '../index.js';
 import type { LayoutFloat } from './input.js';
 /** Floating pictures anchored in a paragraph, with their `wp:positionH`/`wp:positionV` placement. */
-export declare function paragraphFloats(paragraph: Paragraph): LayoutFloat[];
-export declare function floatsOf(paragraph: Paragraph): {
+export declare function paragraphFloats(paragraph: Paragraph, theme?: ThemeCatalog): LayoutFloat[];
+export declare function floatsOf(paragraph: Paragraph, theme?: ThemeCatalog): {
     floats?: LayoutFloat[];
 };
 //# sourceMappingURL=adapt-floats.d.ts.map

package/dist/docx/layout/adapt-floats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapt-floats.d.ts","sourceRoot":"","sources":["../../../docx/layout/adapt-floats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,EAAE,CAsBnE;AACD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAGzE"}
+{"version":3,"file":"adapt-floats.d.ts","sourceRoot":"","sources":["../../../docx/layout/adapt-floats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CAyBzF;AACD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,CAG/F"}

package/dist/docx/layout/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../docx/layout/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,aAAa,EAAyC,MAAM,UAAU,CAAC;AAsB5F,OAAO,EAIN,KAAK,mBAAmB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAEX,mBAAmB,EAKnB,MAAM,SAAS,CAAC;AA2BjB,oFAAoF;AACpF,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,EAC1C,OAAO,GAAE,mBAAwB,GAC/B,mBAAmB,CAiXrB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../docx/layout/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,aAAa,EAAyC,MAAM,UAAU,CAAC;AA0B5F,OAAO,EAIN,KAAK,mBAAmB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAEX,mBAAmB,EAKnB,MAAM,SAAS,CAAC;AA8CjB,oFAAoF;AACpF,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAe,EAC1C,OAAO,GAAE,mBAAwB,GAC/B,mBAAmB,CAyXrB"}

package/dist/docx/layout/equation-object.d.ts

@@ -0,0 +1,7 @@
+import type { LayoutObject } from './input.js';
+/**
+ * The inline object for an equation at `sizePx`, or undefined when its markup holds nothing that
+ * can be drawn (the caller then shows a marker).
+ */
+export declare function equationObject(omml: string, sizePx: number): LayoutObject | undefined;
+//# sourceMappingURL=equation-object.d.ts.map

package/dist/docx/layout/equation-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equation-object.d.ts","sourceRoot":"","sources":["../../../docx/layout/equation-object.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAa5C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAkBrF"}

package/dist/docx/layout/floats.d.ts

@@ -12,6 +12,14 @@ export declare function floatPosition(float: LayoutFloat, page: LayoutPageBox, c
     xPx: number;
     yPx: number;
 };
+/** Where a float's `posOffset` is measured from: the start of its horizontal and vertical frame. */
+export declare function floatOrigin(float: LayoutFloat, page: LayoutPageBox, column: Pick<LayoutColumnBox, 'xPx' | 'widthPx'>, paragraph: {
+    topPx: number;
+    heightPx: number;
+}): {
+    xPx: number;
+    yPx: number;
+};
 /**
  * Positions each paragraph's floating pictures on the page where the paragraph starts, from their
  * `wp:positionH`/`wp:positionV` reference frame, alignment and offset. Returns whether any were placed.

package/dist/docx/layout/floats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floats.d.ts","sourceRoot":"","sources":["../../../docx/layout/floats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAkB,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/E,eAAO,MAAM,eAAe,oNACiL,CAAC;AAqE9M;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC,EAChD,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAoC1F"}
+{"version":3,"file":"floats.d.ts","sourceRoot":"","sources":["../../../docx/layout/floats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAkB,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/E,eAAO,MAAM,eAAe,oNACiL,CAAC;AAqE9M;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC,EAChD,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO9B;AAED,oGAAoG;AACpG,wBAAgB,WAAW,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC,EAChD,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAuC1F"}

package/dist/docx/layout/incremental-layout.d.ts

@@ -0,0 +1,39 @@
+import type { LayoutDocumentInput } from './input.js';
+import type { TextMeasurer } from './measure.js';
+import type { LayoutResult } from './result.js';
+interface BlockState {
+    /** The page the block's last piece sits on, and the fill position after it. */
+    page: number;
+    y: number;
+}
+interface Snapshot {
+    /** Everything in the section but its blocks: page geometry and columns. */
+    context: string;
+    signatures: string[];
+    state: BlockState[];
+    /** Per page: the block its first box belongs to, and whether that box starts the block. */
+    firstBlock: (number | undefined)[];
+    startsBlock: boolean[];
+    result: LayoutResult;
+}
+/** What the last pass did, for tests and diagnostics. */
+export interface IncrementalStats {
+    mode: 'full' | 'incremental' | 'unchanged';
+    /** Blocks that went through pagination in that pass. */
+    placed: number;
+    /** The first page that was laid out again. */
+    fromPage: number;
+}
+export interface IncrementalMemory {
+    last?: Snapshot | undefined;
+    stats?: IncrementalStats;
+}
+/**
+ * Paginates like `layoutDocument`, but reuses the previous pass when the input is a plain
+ * single-section document: pagination resumes at a page start before the first changed paragraph
+ * and stops as soon as a page matches the previous layout again, taking the old pages from there.
+ * Results are identical to a full pass; anything outside that shape runs the full pass.
+ */
+export declare function layoutDocumentIncremental(input: LayoutDocumentInput, measurer: TextMeasurer, memory: IncrementalMemory): LayoutResult;
+export {};
+//# sourceMappingURL=incremental-layout.d.ts.map

package/dist/docx/layout/incremental-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-layout.d.ts","sourceRoot":"","sources":["../../../docx/layout/incremental-layout.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAiC,YAAY,EAAE,MAAM,UAAU,CAAC;AAQ5E,UAAU,UAAU;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;CACV;AAED,UAAU,QAAQ;IACjB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2FAA2F;IAC3F,UAAU,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IACnC,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,CAAC;IAC3C,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAsGD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,iBAAiB,GACvB,YAAY,CAmGd"}