ooxml-core 0.2.0

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

@@ -0,0 +1,206 @@
+/**
+ * Engine-side input contracts. These are intentionally a separate type family
+ * from `@christophervr/docx-core`'s `DocumentModel`: several fields here
+ * (keepNext, cantSplit, tblHeader, explicit page/column breaks, sections,
+ * columns) are not yet represented in the shared model. `adapter.ts` maps
+ * what the current model exposes and leaves the rest at their (Word-default)
+ * fallback, so the pipeline keeps compiling as other agents add model
+ * fields, and nothing here ever reads `(x as any)`.
+ */
+import type { SignedTwips, Twips } from '../index.js';
+export interface LayoutRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    fontFamily?: string;
+    /** Points, matching `TextRun.fontSize` in docx-core. */
+    fontSizePt?: number;
+    textScalePercent?: number;
+    ligatures?: import('../ligatures.js').Ligatures;
+    characterSpacingPx?: number;
+    kerningThresholdPt?: number;
+    /** Positive raises the baseline, negative lowers it. */
+    positionPx?: number;
+    /** A hard page/column break placed immediately after this run's text. */
+    breakAfter?: 'page' | 'column';
+    /** An inline picture: occupies its size on the line (`text` is empty). */
+    object?: LayoutObject;
+    /** Generated text (a list label) that is not part of the paragraph's own characters. */
+    synthetic?: boolean;
+    /** Generated list marker; the remaining characters in this run are its separator. */
+    marker?: {
+        length: number;
+        alignment: 'left' | 'center' | 'right';
+    };
+    /** Superscript or subscript: drawn smaller and raised or lowered (note marks are superscript). */
+    script?: 'super' | 'sub';
+    /** `#rrggbb`, display only. */
+    color?: string;
+    underline?: boolean;
+    strike?: boolean;
+}
+/** A picture's package part and size in CSS pixels; the engine never loads its bytes. */
+export interface LayoutObject {
+    partName: string;
+    contentType: string;
+    widthPx: number;
+    heightPx: number;
+}
+/** A floating picture anchored to a paragraph (`wp:anchor`), positioned on the page. */
+export interface LayoutFloat extends LayoutObject {
+    /** `wp:positionH/@relativeFrom`: page, margin, column, leftMargin, rightMargin, character… */
+    relativeFromH?: string;
+    alignH?: 'left' | 'center' | 'right' | 'inside' | 'outside';
+    offsetXPx?: number;
+    /** `wp:positionV/@relativeFrom`: page, margin, paragraph, line, topMargin, bottomMargin… */
+    relativeFromV?: string;
+    alignV?: 'top' | 'center' | 'bottom' | 'inside' | 'outside';
+    offsetYPx?: number;
+    behindText?: boolean;
+    wrap?: string;
+}
+/** A paragraph tab stop, positioned from the paragraph's text margin (not its indent). */
+export interface LayoutTabStop {
+    posPx: number;
+    align: 'left' | 'center' | 'right' | 'decimal' | 'bar' | 'clear' | 'start' | 'end' | 'num';
+    leader?: 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
+}
+/** A paragraph border side: the line and its `w:space` gap to the text. */
+export interface LayoutParagraphBorder extends LayoutBorder {
+    spacePx: number;
+}
+export interface LayoutParagraphBorders {
+    top?: LayoutParagraphBorder;
+    bottom?: LayoutParagraphBorder;
+    left?: LayoutParagraphBorder;
+    right?: LayoutParagraphBorder;
+}
+/** A footnote's content, laid out in the page's footnote area. */
+export interface LayoutNote {
+    id: string;
+    paragraphs: LayoutParagraph[];
+}
+export type ParagraphAlign = 'left' | 'center' | 'right' | 'justify';
+export type LineSpacingRule = 'auto' | 'exact' | 'atLeast';
+export interface LayoutParagraph {
+    kind: 'paragraph';
+    id: string;
+    runs: LayoutRun[];
+    align?: ParagraphAlign;
+    direction?: 'ltr' | 'rtl';
+    spacingBeforeTwips?: Twips;
+    spacingAfterTwips?: Twips;
+    lineSpacingTwips?: SignedTwips;
+    lineSpacingRule?: LineSpacingRule;
+    indentLeftTwips?: SignedTwips;
+    indentRightTwips?: SignedTwips;
+    indentStartTwips?: SignedTwips;
+    indentEndTwips?: SignedTwips;
+    firstLineTwips?: Twips;
+    hangingTwips?: Twips;
+    /** `w:contextualSpacing`: suppress spacing between paragraphs sharing `styleId`. */
+    contextualSpacing?: boolean;
+    styleId?: string;
+    /** `w:pageBreakBefore`. */
+    pageBreakBefore?: boolean;
+    /** `w:keepNext`: keep this paragraph on the same page as the block after it. */
+    keepNext?: boolean;
+    /** `w:keepLines`: never split this paragraph's own lines across pages. */
+    keepLines?: boolean;
+    /** `w:widowControl`; Word's document default is on. Undefined means on. */
+    widowControl?: boolean;
+    /** Floating pictures anchored in this paragraph. */
+    floats?: LayoutFloat[];
+    /** Custom tab stops (`w:tabs`). */
+    tabStops?: LayoutTabStop[];
+    /** Footnotes referenced here; they go at the bottom of the page where the paragraph starts. */
+    footnotes?: LayoutNote[];
+    /** Border lines around the paragraph, with each side's gap to the text. */
+    borders?: LayoutParagraphBorders;
+    /** `#rrggbb` shading behind the paragraph. */
+    shading?: string;
+}
+/** A resolved cell border, ready to draw. */
+export interface LayoutBorder {
+    widthPx: number;
+    style: 'solid' | 'double' | 'dotted' | 'dashed';
+    color: string;
+}
+export interface LayoutCellBorders {
+    top?: LayoutBorder;
+    right?: LayoutBorder;
+    bottom?: LayoutBorder;
+    left?: LayoutBorder;
+}
+export interface LayoutCellPadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface LayoutTableCell {
+    paragraphs: LayoutParagraph[];
+    /** Column width in CSS pixels; undefined cells share the row's remaining width evenly. */
+    widthPx?: number;
+    /** Left edge from the table's left, from the table grid (merged cells span grid columns). */
+    xPx?: number;
+    /** Cell margins (`w:tcMar`, else the table default); content is inset by them. */
+    padding?: LayoutCellPadding;
+    borders?: LayoutCellBorders;
+    /** `#rrggbb` shading fill. */
+    shading?: string;
+    verticalAlign?: 'top' | 'center' | 'bottom';
+}
+export interface LayoutTableRow {
+    cells: LayoutTableCell[];
+    /** `w:trPr/w:cantSplit`: this row must stay on one page. */
+    cantSplit?: boolean;
+    /** `w:trHeight`: a minimum (`atLeast`) or fixed (`exact`) row height. */
+    heightPx?: number;
+    heightRule?: 'atLeast' | 'exact';
+    /** `w:trPr/w:tblHeader`: repeat this row at the top of every page the table continues onto. */
+    isHeader?: boolean;
+}
+export interface LayoutTable {
+    kind: 'table';
+    id: string;
+    rows: LayoutTableRow[];
+    /** Total grid width, for aligning the table in its column. */
+    widthPx?: number;
+    /** `w:tblInd`: offset from the column's left edge. */
+    indentPx?: number;
+    /** `w:jc` on the table. */
+    alignment?: 'left' | 'center' | 'right';
+}
+export type LayoutBlock = LayoutParagraph | LayoutTable;
+export interface LayoutPageGeometry {
+    widthPx: number;
+    heightPx: number;
+    marginTopPx: number;
+    marginRightPx: number;
+    marginBottomPx: number;
+    marginLeftPx: number;
+}
+export interface LayoutColumns {
+    count: number;
+    gapPx: number;
+    separator?: boolean;
+    /** Explicit column widths and the gap after each column (`w:col`). */
+    widths?: {
+        widthPx: number;
+        gapPx: number;
+    }[];
+}
+export interface LayoutSection {
+    page: LayoutPageGeometry;
+    columns?: LayoutColumns;
+    blocks: LayoutBlock[];
+    /** How this section begins relative to the previous one; the first section is always a fresh page. */
+    break?: 'nextPage' | 'continuous' | 'evenPage' | 'oddPage';
+    /** `w:vAlign`: where content sits vertically on each page of the section. */
+    verticalAlign?: 'top' | 'center' | 'both' | 'bottom';
+}
+export interface LayoutDocumentInput {
+    sections: LayoutSection[];
+}
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/input.ts"],"names":[],"mappings":"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"}

package/dist/docx/layout/keep-rules.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure helpers for Word's paragraph "keep together" rules. Kept separate
+ * from page-flow.ts (which owns page/column bookkeeping) so the rules
+ * themselves are trivial to unit test in isolation.
+ */
+/**
+ * Word's default widow/orphan control: never leave a single line of a
+ * paragraph stranded alone at the bottom of a page/column (an "orphan") or
+ * alone at the top of the next one (a "widow"). Returns how many of the
+ * paragraph's `totalLines` should actually be placed on the current
+ * page/column, given that `fittingLines` would otherwise fit by height alone.
+ */
+export declare function adjustForWidowOrphan(totalLines: number, fittingLines: number, widowControl: boolean): number;
+/** `w:contextualSpacing`: suppress spacing between adjacent same-style paragraphs. */
+export declare function suppressesSpacing(previous: {
+    styleId?: string;
+    contextualSpacing?: boolean;
+} | undefined, current: {
+    styleId?: string;
+    contextualSpacing?: boolean;
+}): boolean;
+/** Word's document default for widow/orphan control is on unless explicitly turned off. */
+export declare function widowControlEnabled(value: boolean | undefined): boolean;
+//# sourceMappingURL=keep-rules.d.ts.map

package/dist/docx/layout/keep-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-rules.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/keep-rules.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,OAAO,GACnB,MAAM,CAOR;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACvE,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD,OAAO,CAGT;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAEvE"}

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

@@ -0,0 +1,9 @@
+import type { DocumentModel } from '../index.js';
+import type { LayoutDocumentInput } from './input.js';
+import type { LayoutResult } from './result.js';
+import type { TextMeasurer } from './measure.js';
+/** Paginates an engine-native `LayoutDocumentInput` (bypasses the DocumentModel adapter). */
+export declare function layoutDocument(input: LayoutDocumentInput, measurer: TextMeasurer): LayoutResult;
+/** Paginates a `docx-core` `DocumentModel` directly: `adaptDocumentModel` + `layoutDocument`. */
+export declare function layoutDocumentModel(model: DocumentModel, measurer: TextMeasurer): LayoutResult;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,CAc/F;AAED,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,CAQ9F"}

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

@@ -0,0 +1,4 @@
+import type { Ligatures } from '../ligatures.js';
+/** Explicitly sets every optional class so None cancels inherited font features. */
+export declare function ligatureCss(value: Ligatures): string;
+//# sourceMappingURL=ligatures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ligatures.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/ligatures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAGpD"}

package/dist/docx/layout/line-metrics.d.ts

@@ -0,0 +1,21 @@
+import { type LayoutFontSpec, type TextMeasurer } from './measure.js';
+import type { BreakToken } from './text-breaks.js';
+import type { LayoutParagraph } from './input.js';
+import { type PlacedToken } from './paragraph-tokens.js';
+/** Where a token's box sits relative to the baseline: its extent above and below it. */
+export declare function tokenExtent(token: BreakToken, paragraph: LayoutParagraph, fonts: LayoutFontSpec[], measurer: TextMeasurer): {
+    above: number;
+    below: number;
+    ascent: number;
+    descent: number;
+};
+/**
+ * A line's height and baseline: the tallest extent above and below the baseline over its tokens
+ * (inline pictures sit on the baseline), scaled by the paragraph's line spacing. Word adds extra
+ * spacing above the text, so the baseline sits one descent above the line's bottom.
+ */
+export declare function lineMetrics(placed: PlacedToken[], fonts: LayoutFontSpec[], paragraph: LayoutParagraph, measurer: TextMeasurer): {
+    heightPx: number;
+    baselinePx: number;
+};
+//# sourceMappingURL=line-metrics.d.ts.map

package/dist/docx/layout/line-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-metrics.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/line-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMjE,wFAAwF;AACxF,wBAAgB,WAAW,CAC1B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,YAAY,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,cAAc,EAAE,EACvB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,YAAY,GACpB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuB1C"}

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

@@ -0,0 +1,34 @@
+/** A font as the measurer needs it; sizes are already in CSS pixels. */
+export interface LayoutFontSpec {
+    family: string;
+    sizePx: number;
+    bold?: boolean;
+    italic?: boolean;
+    kerning?: 'normal' | 'none';
+    ligatures?: import('../ligatures.js').Ligatures;
+    smallCaps?: boolean;
+}
+/** Injectable text measurer: a host supplies canvas or font tables, tests use the fake below. The engine never touches the DOM. */
+export interface TextMeasurer {
+    /** Glyph width in CSS pixels, including the requested kerning mode, before scale/spacing. */
+    widthOf(text: string, font: LayoutFontSpec): number;
+    /** Natural single-spaced line height for `font`, in CSS pixels (ascent + descent + leading). */
+    lineHeightOf(font: LayoutFontSpec): number;
+    /** Height above the baseline within that line height; about 80% when not provided. */
+    ascentOf?(font: LayoutFontSpec): number;
+}
+/** A font's ascent and descent (together its single line height), for baseline alignment. */
+export declare function fontMetrics(measurer: TextMeasurer, font: LayoutFontSpec): {
+    ascent: number;
+    descent: number;
+};
+/**
+ * Deterministic measurer for unit tests: fixed per-character advance and line
+ * height derived only from font size, so line-breaking and pagination tests
+ * never depend on host font metrics or canvas availability.
+ */
+export declare function createFakeMeasurer(options?: {
+    charWidthFactor?: number;
+    lineHeightFactor?: number;
+}): TextMeasurer;
+//# sourceMappingURL=measure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/measure.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,iBAAiB,EAAE,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mIAAmI;AACnI,MAAM,WAAW,YAAY;IAC5B,6FAA6F;IAC7F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IACpD,gGAAgG;IAChG,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC3C,sFAAsF;IACtF,QAAQ,CAAC,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;CACxC;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,cAAc,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAIrC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,YAAY,CAgBd"}

package/dist/docx/layout/page-cursor.d.ts

@@ -0,0 +1,45 @@
+import type { LayoutColumns, LayoutPageGeometry } from './input.js';
+import type { LayoutBlockBox, LayoutColumnBox, LayoutFootnoteBox, LayoutPageBox } from './result.js';
+/** Space for the short rule above a page's footnotes. */
+export declare const FOOTNOTE_SEPARATOR_PX = 12;
+/**
+ * Mutable fill-position bookkeeping for one section: which page/column is
+ * currently being filled and how much vertical space remains in it. A new
+ * `PageCursor` is created per section (see `page-flow.ts`'s approximation
+ * that a continuous section break still starts a fresh page).
+ */
+export declare class PageCursor {
+    readonly pages: LayoutPageBox[];
+    private readonly equalColumnWidthPx;
+    readonly columnHeightPx: number;
+    private geometry;
+    private columns;
+    private columnIndex;
+    private yPx;
+    private readonly sectionIndex;
+    private pageInSection;
+    /** Height taken by footnotes (and their separator) at the bottom of the current page. */
+    private reservedPx;
+    /** Footnotes of the paragraph about to be placed; they join the page its first box lands on. */
+    private pending;
+    constructor(pages: LayoutPageBox[], geometry: LayoutPageGeometry, columns: LayoutColumns, sectionIndex?: number);
+    private pushPage;
+    get page(): LayoutPageBox;
+    get column(): LayoutColumnBox;
+    get columnWidthPx(): number;
+    get y(): number;
+    get atColumnTop(): boolean;
+    remainingHeightPx(): number;
+    private pendingHeightPx;
+    /**
+     * Reserves room for a paragraph's footnotes on whichever page its first box is placed, so the
+     * notes print on the same page as their reference, as Word does.
+     */
+    holdFootnotes(blockId: string, notes: LayoutFootnoteBox[]): void;
+    newPage(): void;
+    /** Advances to the next column, or a new page when the section has no more columns. */
+    newColumn(): void;
+    /** Places a box at the current fill position (sets its `yPx`) and advances by `advancePx`. */
+    place(box: LayoutBlockBox, advancePx: number): void;
+}
+//# sourceMappingURL=page-cursor.d.ts.map

package/dist/docx/layout/page-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cursor.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/page-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,KAAK,EACX,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,MAAM,aAAa,CAAC;AAErB,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,UAAU;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,aAAa,CAAK;IAC1B,yFAAyF;IACzF,OAAO,CAAC,UAAU,CAAK;IACvB,gGAAgG;IAChG,OAAO,CAAC,OAAO,CAAgF;gBAG9F,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,aAAa,EACtB,YAAY,SAAI;IAkBjB,OAAO,CAAC,QAAQ;IA+BhB,IAAI,IAAI,IAAI,aAAa,CAExB;IACD,IAAI,MAAM,IAAI,eAAe,CAE5B;IACD,IAAI,aAAa,IAAI,MAAM,CAE1B;IACD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,eAAe;IAKvB;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAKhE,OAAO,IAAI,IAAI;IAGf,uFAAuF;IACvF,SAAS,IAAI,IAAI;IASjB,8FAA8F;IAC9F,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAenD"}

package/dist/docx/layout/page-flow.d.ts

@@ -0,0 +1,7 @@
+import type { TextMeasurer } from './measure.js';
+import type { LayoutDocumentInput } from './input.js';
+import type { LayoutResult } from './result.js';
+import { type Exclusion } from './wrap.js';
+/** Paginates an already-adapted engine input. See `layout.ts` for the DocumentModel-facing entry point. */
+export declare function layoutSections(input: LayoutDocumentInput, measurer: TextMeasurer, exclusions?: ReadonlyMap<number, Exclusion[]>): LayoutResult;
+//# sourceMappingURL=page-flow.d.ts.map

package/dist/docx/layout/page-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-flow.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/page-flow.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAe,mBAAmB,EAAiB,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAoNzD,2GAA2G;AAC3G,wBAAgB,cAAc,CAC7B,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,GAC3C,YAAY,CAWd"}

package/dist/docx/layout/paragraph-fragments.d.ts

@@ -0,0 +1,6 @@
+import type { LayoutFragment } from './result.js';
+import type { LayoutParagraph } from './input.js';
+import type { PlacedToken } from './paragraph-tokens.js';
+export declare function buildFragments(tokensOnLine: PlacedToken[], paragraph: LayoutParagraph): LayoutFragment[];
+export declare function alignFragments(fragments: LayoutFragment[], width: number, isLastLine: boolean, effectiveAlign: 'left' | 'right' | 'center' | 'justify'): LayoutFragment[];
+//# sourceMappingURL=paragraph-fragments.d.ts.map

package/dist/docx/layout/paragraph-fragments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-fragments.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/paragraph-fragments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAgB,cAAc,CAC7B,YAAY,EAAE,WAAW,EAAE,EAC3B,SAAS,EAAE,eAAe,GACxB,cAAc,EAAE,CA+BlB;AAmBD,wBAAgB,cAAc,CAC7B,SAAS,EAAE,cAAc,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,OAAO,EACnB,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GACrD,cAAc,EAAE,CAWlB"}

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

@@ -0,0 +1,37 @@
+import type { TextMeasurer } from './measure.js';
+import type { LayoutLine, LayoutParagraphFrame } from './result.js';
+import type { LayoutParagraph } from './input.js';
+export interface ParagraphLayoutResult {
+    /** Lines with `yPx` relative to the paragraph box's own top (0 for the first line). */
+    lines: LayoutLine[];
+    spacingBeforePx: number;
+    spacingAfterPx: number;
+    contentHeightPx: number;
+    /** Indices (into `lines`) after which an explicit page break token was consumed. */
+    pageBreakAfterLine: Set<number>;
+    /** Indices after which an explicit column break token was consumed. */
+    columnBreakAfterLine: Set<number>;
+    /** Space above the first line and below the last taken by top and bottom borders. */
+    insetTopPx: number;
+    insetBottomPx: number;
+    frame?: LayoutParagraphFrame;
+}
+/**
+ * Lays out one paragraph's lines within `contentWidthPx` (the column/table
+ * cell width available to the paragraph, before indents are subtracted).
+ * Page and column breaks are reported back as line indices; the page-flow
+ * stage decides what to do with them (start a new page/column) since only it
+ * knows the current page/column state.
+ */
+/**
+ * Space taken from one line by wrapped floating pictures: insets from the line's left and right
+ * (beyond the paragraph indents) and a gap to skip first (text below a picture). `yPx` is the
+ * line's top relative to the paragraph's first line.
+ */
+export type LineBoxFn = (yPx: number, heightPx: number) => {
+    leftInsetPx: number;
+    rightInsetPx: number;
+    gapBeforePx: number;
+};
+export declare function layoutParagraph(paragraph: LayoutParagraph, contentWidthPx: number, measurer: TextMeasurer, note: (message: string) => void, lineBox?: LineBoxFn, startToken?: number): ParagraphLayoutResult;
+//# sourceMappingURL=paragraph-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-layout.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/paragraph-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAkB,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAclD,MAAM,WAAW,qBAAqB;IACrC,uFAAuF;IACvF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,uEAAuE;IACvE,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED;;;;;;GAMG;AACH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,KACZ;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,wBAAgB,eAAe,CAC9B,SAAS,EAAE,eAAe,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,OAAO,CAAC,EAAE,SAAS,EACnB,UAAU,SAAI,GACZ,qBAAqB,CAmPvB"}

package/dist/docx/layout/paragraph-tokens.d.ts

@@ -0,0 +1,27 @@
+import type { LayoutFontSpec, TextMeasurer } from './measure.js';
+import type { LayoutFragment } from './result.js';
+import { type BreakToken } from './text-breaks.js';
+import type { LayoutParagraph, LayoutRun } from './input.js';
+/** Word draws superscript and subscript text at about two thirds of the run's size. */
+export declare const SCRIPT_SCALE = 0.65;
+export declare function fontOf(run: LayoutRun): LayoutFontSpec;
+/** Word applies additional character spacing after scaling the glyph advances. */
+export declare function runTextWidth(text: string, run: LayoutRun, measurer: TextMeasurer): number;
+export declare function resolveIndents(paragraph: LayoutParagraph): {
+    leftPx: number;
+    rightPx: number;
+    firstLineExtraPx: number;
+};
+export declare function tokenizeParagraph(paragraph: LayoutParagraph): {
+    tokens: BreakToken[];
+    runOffsets: number[];
+};
+export interface PlacedToken {
+    token: BreakToken;
+    widthPx: number;
+    /** Glyph position and consumed advance differ for centered/right-aligned list markers. */
+    xOffsetPx?: number;
+    advancePx?: number;
+    leader?: LayoutFragment['leader'];
+}
+//# sourceMappingURL=paragraph-tokens.d.ts.map

package/dist/docx/layout/paragraph-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paragraph-tokens.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/paragraph-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG7D,uFAAuF;AACvF,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,cAAc,CAerD;AAGD,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMzF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,GAAG;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CACzB,CAqBA;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG;IAC9D,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB,CAyBA;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;CAClC"}

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

@@ -0,0 +1,139 @@
+/** One laid-out fragment of text within a line, styled by a single run. */
+export interface LayoutFragment {
+    text: string;
+    xPx: number;
+    widthPx: number;
+    runIndex: number;
+    bold?: boolean;
+    italic?: boolean;
+    fontFamily?: string;
+    fontSizePt?: number;
+    textScalePercent?: number;
+    ligatures?: import('../ligatures.js').Ligatures;
+    characterSpacingPx?: number;
+    kerningThresholdPt?: number;
+    /** An inline picture drawn in this fragment's box, bottom-aligned on the line. */
+    object?: import('./input.js').LayoutObject;
+    color?: string;
+    underline?: boolean;
+    strike?: boolean;
+    script?: 'super' | 'sub';
+    /** Top of the fragment's text box within the line, placing its baseline on the line's. */
+    topPx?: number;
+    /** Height of the fragment's font box (ascent + descent), used as its CSS line height. */
+    boxHeightPx?: number;
+    /** A tab's leader fill (dots, hyphens, a line…) drawn across its width. */
+    leader?: 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
+}
+/** One visual line of a paragraph, positioned within its block's box. */
+export interface LayoutLine {
+    yPx: number;
+    heightPx: number;
+    fragments: LayoutFragment[];
+    /** Distance from the line's top to its baseline. */
+    baselinePx?: number;
+    /** Space skipped above this line to clear a picture wrapped top-and-bottom; `yPx` is below it. */
+    gapBeforePx?: number;
+    /** Character range within the paragraph's concatenated run text, for hit-testing. */
+    sourceStart: number;
+    sourceEnd: number;
+    /** First unconsumed paragraph token, for reflow into a column of a different width. */
+    nextToken?: number;
+    /** First token on this line, for reflowing a split table-cell paragraph. */
+    firstToken?: number;
+}
+export interface LayoutParagraphBox {
+    kind: 'paragraph';
+    blockId: string;
+    yPx: number;
+    heightPx: number;
+    lines: LayoutLine[];
+    /** Paragraph borders and shading, spanning the box's height at these horizontal bounds. */
+    frame?: LayoutParagraphFrame;
+}
+export interface LayoutParagraphFrame {
+    leftPx: number;
+    widthPx: number;
+    borders?: import('./input.js').LayoutParagraphBorders;
+    shading?: string;
+}
+/** Where a cell sits in its row and how it is drawn (borders, shading, padding). */
+export interface LayoutCellGeometry {
+    xPx: number;
+    widthPx: number;
+    paddingLeftPx: number;
+    paddingRightPx: number;
+    borders?: import('./input.js').LayoutCellBorders;
+    shading?: string;
+    verticalAlign?: 'top' | 'center' | 'bottom';
+    /** Height of the cell's content (with its top and bottom padding), for vertical alignment. */
+    contentHeightPx: number;
+}
+export interface LayoutTableRowBox {
+    yPx: number;
+    heightPx: number;
+    /** True when this row is a repeated header copy rather than the row's first placement. */
+    repeated: boolean;
+    cells: LayoutParagraphBox[][];
+    /** Per-cell position and appearance, parallel to `cells`. */
+    geometry?: LayoutCellGeometry[];
+}
+export interface LayoutTableBox {
+    kind: 'table';
+    blockId: string;
+    /** Offset from the column's left edge (table indent or alignment). */
+    xPx?: number;
+    yPx: number;
+    heightPx: number;
+    rows: LayoutTableRowBox[];
+}
+export type LayoutBlockBox = LayoutParagraphBox | LayoutTableBox;
+export interface LayoutColumnBox {
+    xPx: number;
+    widthPx: number;
+    blocks: LayoutBlockBox[];
+}
+export interface LayoutPageBox {
+    index: number;
+    /** Index into the input sections this page belongs to. */
+    sectionIndex: number;
+    /** Zero-based position of this page within its section (for first-page headers and numbering). */
+    pageInSection: number;
+    widthPx: number;
+    heightPx: number;
+    marginTopPx: number;
+    marginRightPx: number;
+    marginBottomPx: number;
+    marginLeftPx: number;
+    columns: LayoutColumnBox[];
+    columnSeparator?: boolean;
+    /** Floating pictures on this page, in page coordinates (CSS pixels from the sheet's top-left). */
+    floats?: LayoutFloatBox[];
+    /** Footnotes at the bottom of the page, in reference order; `yPx` values are within the area. */
+    footnotes?: LayoutFootnoteBox[];
+}
+export interface LayoutFootnoteBox {
+    id: string;
+    /** Top of this note within the footnote area (below the separator). */
+    yPx: number;
+    heightPx: number;
+    paragraphs: LayoutParagraphBox[];
+}
+export interface LayoutFloatBox {
+    blockId: string;
+    xPx: number;
+    yPx: number;
+    widthPx: number;
+    heightPx: number;
+    partName: string;
+    contentType: string;
+    behindText: boolean;
+    /** `wp:wrapSquare`, `wrapTopAndBottom`… (`none` floats over or behind the text). */
+    wrap?: string;
+}
+export interface LayoutResult {
+    pages: LayoutPageBox[];
+    /** Honest, human-readable notes on approximations relative to Word (see docs/parity-roadmap.md §3). */
+    approximations: string[];
+}
+//# sourceMappingURL=result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/result.ts"],"names":[],"mappings":"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"}