ooxml-core 0.2.0

package/dist/docx/layout/tab-stops.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutTabStop } from './input.js';
+export interface TabPlacement {
+    widthPx: number;
+    leader?: LayoutTabStop['leader'];
+}
+/**
+ * Where a tab at `positionPx` (from the paragraph's text margin) advances to, as Word does:
+ * the next custom stop after it, else the hanging indent (an implicit stop for list labels),
+ * else the next default stop. `followingPx` is the width of the text after the tab up to the
+ * next tab or line end, used by right, center and decimal stops; `beforeDecimalPx` is the part
+ * of it before the first decimal separator.
+ */
+export declare function placeTab(positionPx: number, stops: readonly LayoutTabStop[], hangingStopPx: number | undefined, followingPx: number, beforeDecimalPx: number): TabPlacement;
+//# sourceMappingURL=tab-stops.d.ts.map

package/dist/docx/layout/tab-stops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-stops.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/tab-stops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACrB,YAAY,CAyBd"}

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

@@ -0,0 +1,30 @@
+import type { TextMeasurer } from './measure.js';
+import type { LayoutParagraph, LayoutTableRow } from './input.js';
+import type { LayoutCellGeometry, LayoutParagraphBox } from './result.js';
+export interface RowLayout {
+    heightPx: number;
+    cells: LayoutParagraphBox[][];
+    geometry: LayoutCellGeometry[];
+}
+/** Lays out paragraphs stacked top to bottom (a table cell's or a footnote's content). */
+export declare function stackParagraphs(paragraphs: LayoutParagraph[], widthPx: number, measurer: TextMeasurer, note: (message: string) => void, topPx?: number, startTokens?: ReadonlyMap<string, number>): {
+    heightPx: number;
+    boxes: LayoutParagraphBox[];
+};
+/**
+ * Lays out one table row. Cells take their grid position and width when the table has a grid,
+ * otherwise the table width split evenly, and their content is inset by the cell margins.
+ */
+export declare function layoutRow(row: LayoutTableRow, tableWidthPx: number, measurer: TextMeasurer, note: (message: string) => void, remaining?: LayoutParagraphBox[][]): RowLayout;
+export interface RowSplit {
+    before: RowLayout;
+    after: RowLayout | null;
+}
+/**
+ * Splits a row that does not fit in `cutHeightPx` of remaining page/column
+ * space. Every cell is clipped at the same shared line boundary (never
+ * mid-line); a cell shorter than the cut simply has nothing in `after`.
+ * Returns `after: null` when every cell fit (nothing left to continue).
+ */
+export declare function splitRowAtHeight(row: RowLayout, cutHeightPx: number): RowSplit;
+//# sourceMappingURL=table-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table-layout.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/table-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAmB,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAC9B,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,KAAK,SAAI,EACT,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAyBnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EAC/B,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,GAChC,SAAS,CAyCX;AAsDD,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAoB9E"}

package/dist/docx/layout/test-helpers.d.ts

@@ -0,0 +1,3 @@
+/** Read `items[index]`, failing the test with a clear message when it is absent. */
+export declare function at<T>(items: readonly T[] | undefined, index: number): T;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/docx/layout/test-helpers.d.ts.map

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

package/dist/docx/layout/text-breaks.d.ts

@@ -0,0 +1,56 @@
+/**
+ * A UAX#14-lite tokenizer: enough of the Unicode line-breaking algorithm to
+ * place break opportunities at spaces, hyphens, and between CJK characters,
+ * without implementing the full class table.
+ *
+ * The `isEastAsianChar` codepoint ranges are ported, with this provenance
+ * note, from the sibling PowerPoint viewer's East Asian line-breaking helper
+ * at `../pptx-viewer-new/packages/angular/src/internal/shared-src/render/text-east-asian-breaks.ts`
+ * (`isEastAsianChar`). That module's hanging-punctuation/kinsoku machinery is
+ * PowerPoint-specific (`a:pPr/@hangingPunct`, `@eaLnBrk`) and is not ported;
+ * only the character classification is reused here.
+ */
+export declare function isEastAsianChar(ch: string): boolean;
+export type BreakToken = {
+    kind: 'word';
+    text: string;
+    runIndex: number;
+    sourceStart: number;
+} | {
+    kind: 'space';
+    text: string;
+    runIndex: number;
+    sourceStart: number;
+} | {
+    kind: 'tab';
+    runIndex: number;
+    sourceStart: number;
+}
+/** An inline picture: an unbreakable box of the run's object size. */
+ | {
+    kind: 'object';
+    runIndex: number;
+    sourceStart: number;
+}
+/** A manual line break (`w:br`/`w:cr`); ends the current line without ending the paragraph. */
+ | {
+    kind: 'lineBreak';
+    runIndex: number;
+    sourceStart: number;
+}
+/** An explicit page or column break carried on a run (see {@link LayoutRun.breakAfter}). */
+ | {
+    kind: 'pageBreak' | 'columnBreak';
+    runIndex: number;
+    sourceStart: number;
+};
+/**
+ * Splits one run's text into break-opportunity tokens. `sourceStart` is the
+ * character offset of each token within the run's own text, so callers can
+ * map a line's fragments back to a paragraph/run character range (used for
+ * click-to-place-cursor mapping in the Print Layout view).
+ */
+export declare function tokenizeRun(text: string, runIndex: number): BreakToken[];
+/** Appends a forced page or column break marker after a run's tokens. */
+export declare function appendBreakMarker(tokens: BreakToken[], runIndex: number, sourceStart: number, kind: 'page' | 'column'): void;
+//# sourceMappingURL=text-breaks.d.ts.map

package/dist/docx/layout/text-breaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-breaks.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/text-breaks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAYnD;AAED,MAAM,MAAM,UAAU,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACxD,sEAAsE;GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC3D,+FAA+F;GAC7F;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC9D,4FAA4F;GAC1F;IAAE,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAoCxE;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,QAAQ,GACrB,IAAI,CAEN"}

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

@@ -0,0 +1,17 @@
+import { type SignedTwips } from '../index.js';
+/** Twentieths of a point (Word's native unit for spacing/indents) to CSS pixels. */
+export declare function twipsToPx(value: SignedTwips): number;
+/** Zero twips, the default for absent spacing and indents. */
+export declare const NO_TWIPS: import("../units.js").Twips;
+/** CSS pixels to whole twips (rounded half away from zero; may be negative). */
+export declare function pxToTwips(px: number): SignedTwips;
+/** Points (Word's native unit for font sizes). */
+export declare function ptToPx(pt: number): number;
+/** Default tab stop interval: every half inch when no custom `w:tabs` are modeled. */
+export declare const DEFAULT_TAB_STOP_PX: number;
+/** Word's default body font when a run specifies neither family nor size. */
+export declare const DEFAULT_FONT_FAMILY = "Calibri";
+export declare const DEFAULT_FONT_SIZE_PT = 11;
+/** Single line-spacing is expressed by Word as 240 twentieths-of-a-line. */
+export declare const SINGLE_LINE_SPACING_UNITS = 240;
+//# sourceMappingURL=units.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/units.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAExE,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEpD;AACD,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,6BAAW,CAAC;AACjC,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAEjD;AACD,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AACD,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,QAAwB,CAAC;AACzD,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,MAAM,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { LineBoxFn } from './paragraph-layout.js';
+import type { LayoutPageBox } from './result.js';
+/** Where text may not go on a page, in page coordinates (CSS pixels). */
+export interface Exclusion {
+    xPx: number;
+    yPx: number;
+    widthPx: number;
+    heightPx: number;
+    /** Top-and-bottom wrapping keeps both sides empty. */
+    topAndBottom: boolean;
+}
+/** Areas that wrapped floating pictures take from the text, per page index. */
+export declare function wrapExclusions(pages: LayoutPageBox[]): Map<number, Exclusion[]>;
+/** Whether two exclusion maps place the same areas (to stop re-laying out once floats settle). */
+export declare function sameExclusions(a: Map<number, Exclusion[]>, b: Map<number, Exclusion[]>): boolean;
+/**
+ * Line boxes for a paragraph whose first line starts at `topPx` (page coordinates) in a column
+ * spanning `columnLeftPx`..`columnLeftPx + columnWidthPx`: lines beside a picture use the wider
+ * side of it (Word's "largest side"), and lines that cannot fit beside it move below it.
+ */
+export declare function lineBoxesFor(exclusions: readonly Exclusion[], topPx: number, columnLeftPx: number, columnWidthPx: number): LineBoxFn;
+//# sourceMappingURL=wrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/docx/layout/wrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOjD,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAe/E;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,OAAO,CAShG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACnB,SAAS,CAuBX"}

package/dist/docx/ligatures.d.ts

@@ -0,0 +1,9 @@
+import { type XmlDocument, type XmlElement } from './xml.js';
+export declare const LIGATURE_VALUES: readonly ["none", "standard", "contextual", "historical", "discretional", "standardContextual", "standardHistorical", "contextualHistorical", "standardDiscretional", "contextualDiscretional", "historicalDiscretional", "standardContextualHistorical", "standardContextualDiscretional", "standardHistoricalDiscretional", "contextualHistoricalDiscretional", "all"];
+export type Ligatures = (typeof LIGATURE_VALUES)[number];
+export declare const isLigatures: (value: unknown) => value is Ligatures;
+export declare const WORD_2010_NS = "http://schemas.microsoft.com/office/word/2010/wordml";
+export declare const ligatureElements: (props: XmlElement) => Element[];
+export declare const parseLigatures: (props: XmlElement) => Ligatures | undefined;
+export declare function writeLigatures(doc: XmlDocument, props: XmlElement, value: Ligatures | undefined): void;
+//# sourceMappingURL=ligatures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ligatures.d.ts","sourceRoot":"","sources":["../../src/docx/ligatures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvE,eAAO,MAAM,eAAe,0WAiBlB,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAC8B,CAAC;AACrF,eAAO,MAAM,YAAY,yDAAyD,CAAC;AAGnF,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,cAGhD,CAAC;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,UAAU,KAAG,SAAS,GAAG,SAG9D,CAAC;AAeF,wBAAgB,cAAc,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,SAAS,GAAG,SAAS,GAC1B,IAAI,CAaN"}

package/dist/docx/load/detect.d.ts

@@ -0,0 +1,6 @@
+import type { LoadedDocument } from '../model.js';
+export type DocumentFormat = 'docx' | 'doc';
+export declare function detectDocumentFormat(input: Uint8Array | ArrayBuffer): DocumentFormat;
+/** Sniff content, never trust a user-supplied filename extension. */
+export declare function loadDocument(input: Uint8Array | ArrayBuffer): Promise<LoadedDocument>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/docx/load/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../src/docx/load/detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAC5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CASpF;AACD,qEAAqE;AACrE,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAE3F"}