ooxml-core 0.2.0

package/dist/docx/load/legacy-doc.d.ts

@@ -0,0 +1,7 @@
+import type { LoadedDocument } from '../model.js';
+export declare class LegacyDocError extends Error {
+    constructor(message: string);
+}
+/** Load Word 97-2003 binary .doc. This API preserves source bytes for no-op saves. */
+export declare function loadLegacyDoc(input: Uint8Array | ArrayBuffer): Promise<LoadedDocument>;
+//# sourceMappingURL=legacy-doc.d.ts.map

package/dist/docx/load/legacy-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-doc.d.ts","sourceRoot":"","sources":["../../../src/docx/load/legacy-doc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,cAAc,EAAa,MAAM,aAAa,CAAC;AAS5E,qBAAa,cAAe,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI3B;AAoDD,sFAAsF;AACtF,wBAAsB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CA+D5F"}

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

@@ -0,0 +1,100 @@
+import type { StJc, StTabJc, StTabTlc } from './generated/wml-simple-types.js';
+import type { Revision, TextRun } from './model-run.js';
+import type { SignedTwips, Twips } from './units.js';
+/** A paragraph tab stop (`w:tab`): position from the text margin, alignment and leader fill. */
+export interface TabStop {
+    posTwips: SignedTwips;
+    align: StTabJc;
+    leader?: StTabTlc;
+}
+export interface Paragraph {
+    type: 'paragraph';
+    /** Stable identity across edits, unique throughout the document. */
+    id: string;
+    runs: TextRun[];
+    align?: 'left' | 'center' | 'right' | 'justify';
+    /**
+     * The exact `w:jc` value read from the file (`start`, `end`, `distribute`, kashida variants...).
+     * `align` is derived from it for rendering; it is only authoritative while `align` still equals
+     * `alignFromJustification(justification, rtl)`, since editors change `align` alone.
+     */
+    justification?: StJc;
+    /** Paragraph base direction from direct `w:bidi`; undefined inherits. */
+    direction?: 'ltr' | 'rtl';
+    style?: string;
+    /** Word paragraph spacing and indentation values, kept in their native twip units (1/20 pt). */
+    spacingBeforeTwips?: Twips;
+    spacingAfterTwips?: Twips;
+    lineSpacingTwips?: SignedTwips;
+    /** `auto` uses 240ths of a line; `exact` and `atLeast` use twips. */
+    lineSpacingRule?: 'auto' | 'exact' | 'atLeast';
+    indentLeftTwips?: SignedTwips;
+    indentRightTwips?: SignedTwips;
+    indentStartTwips?: SignedTwips;
+    indentEndTwips?: SignedTwips;
+    firstLineTwips?: Twips;
+    hangingTwips?: Twips;
+    /** Direct `w:numPr` on this paragraph; undefined may still inherit numbering through `style`. */
+    numbering?: {
+        numId: number;
+        level: number;
+    };
+    /** `w:pPr/w:pageBreakBefore`: forces this paragraph to start a new page. */
+    pageBreakBefore?: boolean;
+    /** Tracked insertion/deletion of the paragraph mark itself (the paragraph break). */
+    markRevision?: Revision;
+    /** Marks that `w:pPrChange` recorded a prior paragraph formatting snapshot; the snapshot itself is not modeled. */
+    formatRevision?: Revision;
+    /** Custom tab stops (`w:tabs`), in document order. */
+    tabStops?: TabStop[];
+    /** `w:keepNext`: keep this paragraph on the same page as the next. `false` cancels a style. */
+    keepNext?: boolean;
+    /** `w:keepLines`: never split this paragraph across pages. */
+    keepLines?: boolean;
+    /** `w:widowControl`: avoid single lines at a page's top or bottom (on unless turned off). */
+    widowControl?: boolean;
+    /** `w:contextualSpacing`: no spacing between paragraphs of the same style. */
+    contextualSpacing?: boolean;
+    /** `w:suppressLineNumbers`: omit this paragraph from line numbering; false overrides a style. */
+    suppressLineNumbers?: boolean;
+    /**
+     * `w:framePr/@w:dropCap`: this paragraph is a drop cap frame (the initial letter) for the
+     * paragraph that follows. `lines` is the number of text lines it spans.
+     */
+    dropCap?: {
+        style: 'drop' | 'margin';
+        lines: number;
+        distanceTwips?: Twips;
+    };
+    /** `w:pBdr`; read-only (preserved in the source XML, not written for new paragraphs). */
+    borders?: import('./table-model.js').ParagraphBorders;
+    /** `w:shd/@w:fill` as `#rrggbb`; read-only like `borders`. */
+    shadingFill?: string;
+    /**
+     * Bookmark names starting in this paragraph (`w:bookmarkStart/@w:name`). Added names are
+     * written around the whole paragraph; removed names lose their markers here. Exact character
+     * ranges are not modeled.
+     */
+    bookmarks?: string[];
+}
+/** Direct paragraph properties supported by the editor, in native Word units. */
+export type ParagraphFormatting = Pick<Paragraph, 'align' | 'justification' | 'direction' | 'spacingBeforeTwips' | 'spacingAfterTwips' | 'lineSpacingTwips' | 'lineSpacingRule' | 'indentLeftTwips' | 'indentRightTwips' | 'indentStartTwips' | 'indentEndTwips' | 'firstLineTwips' | 'hangingTwips' | 'keepNext' | 'keepLines' | 'widowControl' | 'contextualSpacing' | 'suppressLineNumbers' | 'borders' | 'shadingFill'>;
+export interface ParagraphStyleDefinition {
+    id: string;
+    name?: string;
+    basedOn?: string;
+    isDefault?: boolean;
+    formatting: ParagraphFormatting;
+    /** Numbering inherited by paragraphs using this style through `w:pPr/w:numPr` in `styles.xml`. */
+    numbering?: {
+        numId: number;
+        level: number;
+    };
+}
+/** Parsed source style data. It is retained for inheritance and never flattened on save. */
+export interface ParagraphStyleCatalog {
+    docDefaults: ParagraphFormatting;
+    styles: Record<string, ParagraphStyleDefinition>;
+    warnings: string[];
+}
+//# sourceMappingURL=model-paragraph.d.ts.map

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

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

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

@@ -0,0 +1,110 @@
+import type { StHighlightColor } from './generated/wml-simple-types.js';
+import type { HyperlinkInfo, InlineImage } from './inline-model.js';
+import type { ThemeColorReference, ThemeFontRole, ThemeFontScript, WordUnderlineStyle } from './theme-model.js';
+import type { HalfPoints, SignedTwips } from './units.js';
+/** A tracked-change revision recorded on a run or paragraph mark. */
+export interface Revision {
+    kind: 'insert' | 'delete' | 'moveFrom' | 'moveTo' | 'formatChange' | 'paragraphChange';
+    /**
+     * For `moveFrom`/`moveTo`: the move this text belongs to. Both sides share `name` (from
+     * `w:moveFromRangeStart`/`w:moveToRangeStart`); `rangeId` is that range marker's `w:id`.
+     */
+    move?: {
+        name: string;
+        rangeId?: string;
+    };
+    author: string;
+    date?: string;
+    /** Source `w:id`; not guaranteed unique outside the paragraph it was parsed from. */
+    id: string;
+}
+export interface TextRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    /** Word named highlight color, such as `yellow` or `lightGray`. */
+    highlight?: StHighlightColor;
+    verticalAlign?: 'baseline' | 'superscript' | 'subscript';
+    /** Direct Word run language tag (`w:lang/@w:val`), without automatic detection. */
+    language?: string;
+    /** Direct East Asian script language tag (`w:lang/@w:eastAsia`). */
+    eastAsiaLanguage?: string;
+    /** Direct complex-script language tag (`w:lang/@w:bidi`). */
+    bidiLanguage?: string;
+    /** Explicit run-level bidirectional override; `false` means direct off, undefined inherits. */
+    rtl?: boolean;
+    /** Font size in points (whole or half points, e.g. 10.5); `HalfPoints` is the on-disk `w:sz`. */
+    fontSize?: number;
+    fontFamily?: string;
+    /** Direct RGB color, e.g. #28665E. May coexist with `colorTheme` as Word's stored fallback. */
+    color?: string;
+    /**
+     * A run that is itself a page or column break marker (`w:br` type page/column) instead of
+     * visible text. `text` is empty on these runs; editors render a distinct visible marker.
+     */
+    break?: 'page' | 'column';
+    /**
+     * A run that is itself a footnote/endnote reference mark (`w:footnoteReference` /
+     * `w:endnoteReference`) instead of visible text. `text` is empty on these runs; the numeric
+     * mark is derived from document order, not stored here.
+     */
+    noteReference?: {
+        kind: 'footnote' | 'endnote';
+        id: string;
+    };
+    /** The automatic number mark (`w:footnoteRef`/`w:endnoteRef`) that starts a note's own text. */
+    noteMark?: 'footnote' | 'endnote';
+    /**
+     * Present on runs holding a field's displayed result (`w:fldSimple`, or text between a complex
+     * field's `separate` and `end`). Display metadata only: fields are not recalculated on save and
+     * paragraphs containing them stay protected from edits.
+     */
+    field?: {
+        instr: string;
+        simple?: boolean;
+    };
+    /** A complex field's `w:fldChar` marker run (begin, separate or end); `text` is empty. */
+    fieldChar?: 'begin' | 'separate' | 'end';
+    /** A complex field's instruction text run (`w:instrText`), e.g. ` TOC \o "1-3" `; `text` is empty. */
+    fieldCode?: string;
+    /** Tracked-change metadata for this run; absent means the run has no pending revision. */
+    revision?: Revision;
+    /** IDs of comments whose range covers this run. */
+    commentIds?: string[];
+    /** Direct `w:color/@w:themeColor` (+ themeTint/themeShade); resolution happens in a separate layer. */
+    colorTheme?: ThemeColorReference;
+    /** Character style reference (`w:rStyle/@w:val`); preserved and editable, not flattened. */
+    style?: string;
+    caps?: boolean;
+    smallCaps?: boolean;
+    /** `w:dstrike`; kept distinct from the single-line `strike` toggle. */
+    doubleStrike?: boolean;
+    /** Hidden text (`w:vanish`); the editor renders it dimmed rather than removing it. */
+    vanish?: boolean;
+    /** Non-single underline style, e.g. `double`/`wave`; `underline` stays the simple on/off toggle. */
+    underlineStyle?: WordUnderlineStyle;
+    underlineColor?: string;
+    /** `w:spacing/@w:val` character spacing, in twips (positive expands, negative condenses). */
+    characterSpacingTwips?: SignedTwips;
+    /** `w:w` horizontal text scaling, in whole percent; 100 explicitly cancels inherited scaling. */
+    textScalePercent?: number;
+    /** Office 2010 OpenType ligature selection; undefined inherits. */
+    ligatures?: import('./ligatures.js').Ligatures;
+    /** `w:kern` minimum font size for kerning, in half-points; zero explicitly disables it. */
+    kerningHalfPoints?: HalfPoints;
+    /** `w:position` baseline displacement, in signed half-points; positive raises, negative lowers. */
+    positionHalfPoints?: HalfPoints;
+    /** Direct `w:shd/@w:fill` run shading. */
+    shadingFill?: string;
+    /** Direct `w:shd` theme fill; kept alongside `shadingFill` without flattening. */
+    shadingThemeFill?: ThemeColorReference;
+    /** Direct `w:rFonts` theme font references, per script; resolved via the document theme. */
+    fontTheme?: Partial<Record<ThemeFontScript, ThemeFontRole>>;
+    /** Present when this run is an inline picture instead of text; `text` is empty. */
+    image?: InlineImage;
+    /** Hyperlink target for this run, from `w:hyperlink` (or a simple `HYPERLINK` field). */
+    link?: HyperlinkInfo;
+}
+//# sourceMappingURL=model-run.d.ts.map

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

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

package/dist/docx/model.d.ts

@@ -0,0 +1,114 @@
+import type { DocumentProperties } from './core-properties.js';
+import type { StJcTable, StNumberFormat } from './generated/wml-simple-types.js';
+import type { ParagraphStyleCatalog } from './model-paragraph.js';
+import type { NumberingCatalog } from './numbering-model.js';
+import type { SignedTwips, Twips } from './units.js';
+export type { Revision, TextRun } from './model-run.js';
+export type { Paragraph, ParagraphFormatting, ParagraphStyleCatalog, ParagraphStyleDefinition, TabStop, } from './model-paragraph.js';
+import type { Paragraph } from './model-paragraph.js';
+export type { HyperlinkInfo, InlineImage, PicturePlacement, WatermarkSpec, } from './inline-model.js';
+import type { Note, SectionProperties } from './section-model.js';
+export type { HeaderFooterContent, HeaderFooterSlots, LineNumberSettings, Note, PageBorders, PageBorderSide, SectionColumn, SectionColumns, SectionPageNumbering, SectionProperties, } from './section-model.js';
+/** A comment thread entry parsed from comments.xml / commentsExtended.xml. */
+export interface Comment {
+    id: string;
+    author: string;
+    initials?: string;
+    date?: string;
+    text: string;
+    /** commentsExtended.xml `w15:done`. */
+    resolved?: boolean;
+    /** commentsExtended.xml parent linkage for threaded replies. */
+    parentId?: string;
+}
+export type { ThemeColorSlot, ThemeColorToken, ThemeFontSet, ThemeCatalog, ThemeColorReference, ThemeFontScript, ThemeFontRole, WordUnderlineStyle, } from './theme-model.js';
+export type { RunFormatting, CharacterStyleDefinition, RunStyleCatalog, } from './run-style-model.js';
+import type { RunStyleCatalog } from './run-style-model.js';
+export type { TableBorderSide, TableBorders, TableCellMargins, NestedTablePreview, TableLook, TableConditionalRegion, TableStyleConditionalFormatting, TableStyleDefinition, TableStyleCatalog, } from './table-model.js';
+import type { TableCell as TableCellShape, TableStyleCatalog } from './table-model.js';
+export type TableCell = TableCellShape;
+export interface Table {
+    type: 'table';
+    id: string;
+    /** Whether row, cell and paragraph structure can be edited without losing unsupported table XML. */
+    structureEditable?: boolean;
+    rows: TableCell[][];
+    /** `w:tblGrid/w:gridCol` widths in twips, one per grid column. */
+    grid?: Twips[];
+    widthTwips?: Twips;
+    alignment?: 'left' | 'center' | 'right';
+    /** The exact `w:tblPr/w:jc` value (`ST_JcTable`, including `start`/`end`); `alignment` is derived from it. */
+    justification?: StJcTable;
+    indentTwips?: SignedTwips;
+    borders?: import('./table-model.js').TableBorders;
+    /** `w:tblStyle/@w:val`; conditional formatting resolves through `tableStyles` without flattening. */
+    style?: string;
+    look?: import('./table-model.js').TableLook;
+    /** Default cell margins (`w:tblCellMar`); cells' own `w:tcMar` override them. */
+    cellMargins?: import('./table-model.js').TableCellMargins;
+    /** Per-row properties, parallel to `rows` (read from `w:trPr`; preserved on save). */
+    rowProperties?: import('./table-model.js').TableRowProperties[];
+}
+export type Block = Paragraph | Table;
+export interface DocumentModel {
+    blocks: Block[];
+    /** CSS pixels at 96 DPI. Page height is currently a surface minimum, not pagination. */
+    page: {
+        width: number;
+        height: number;
+        marginTop: number;
+        marginRight: number;
+        marginBottom: number;
+        marginLeft: number;
+    };
+    warnings: string[];
+    /** Source paragraph defaults/styles; editing the catalog itself is not supported. */
+    paragraphStyles?: ParagraphStyleCatalog;
+    /** Parsed `word/numbering.xml`. Existing entries are read-only; new list definitions may be added. */
+    numberingCatalog?: NumberingCatalog;
+    /**
+     * Every parsed section in document order (paragraph-level section breaks, then the final
+     * body section). `page` above mirrors the last section's page geometry for backward compat.
+     */
+    sections?: SectionProperties[];
+    /** Package properties from `docProps/core.xml` (title, author, tags...). */
+    properties?: DocumentProperties;
+    /** Whether `settings.xml` requests separate even-page headers/footers (`w:evenAndOddHeaders`). */
+    evenAndOddHeaders?: boolean;
+    /** `w:autoHyphenation` in settings.xml: Word hyphenates words at line ends. */
+    autoHyphenation?: boolean;
+    /** Page colour (`w:document/w:background`), six uppercase hex digits without `#`; unset for none. */
+    pageColor?: string;
+    footnotes?: Note[];
+    endnotes?: Note[];
+    /** Raw `w:footnotePr/w:numFmt` token from settings.xml; defaults to `decimal`. */
+    footnoteNumFmt?: StNumberFormat;
+    /** Raw `w:endnotePr/w:numFmt` token from settings.xml; defaults to `lowerRoman`. */
+    endnoteNumFmt?: StNumberFormat;
+    /** Comment threads parsed from comments.xml / commentsExtended.xml. */
+    comments?: Comment[];
+    /** settings.xml `w:trackRevisions`; toggling this changes how the editor records new edits. */
+    trackChanges?: boolean;
+    /** Source run-level defaults/character styles; editing the catalog itself is not supported. */
+    characterStyles?: RunStyleCatalog;
+    /** Source table style catalog; editing the catalog itself is not supported. */
+    tableStyles?: TableStyleCatalog;
+    /** Parsed word/theme/theme1.xml and settings.xml color scheme mapping. */
+    theme?: import('./theme-model.js').ThemeCatalog;
+}
+/** Bytes for a media part staged for save but not yet part of the loaded package (e.g. a newly inserted picture). */
+export interface PendingMediaPart {
+    bytes: Uint8Array;
+    contentType: string;
+}
+export interface LoadedDocument {
+    model: DocumentModel;
+    /** Original image/media bytes keyed by package part name, kept off the JSON model so diffs stay small.
+     *  Absent (equivalent to empty) for loaders that never model inline media, such as legacy DOC. */
+    media?: ReadonlyMap<string, Uint8Array>;
+    /** Returns bytes in the original format; unsupported edits reject instead of silently degrading it.
+     *  `pendingMedia` supplies bytes for any `InlineImage.partName` newly referenced by `model` (e.g. inserted pictures). */
+    save(model?: DocumentModel, pendingMedia?: ReadonlyMap<string, PendingMediaPart>): Promise<Uint8Array>;
+}
+export declare function createDocument(): DocumentModel;
+//# sourceMappingURL=model.d.ts.map

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

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

package/dist/docx/notes.d.ts

@@ -0,0 +1,9 @@
+import type { Block, Note } from './model.js';
+import { type XmlElement } from './xml.js';
+/** Parses `word/footnotes.xml` or `word/endnotes.xml`, skipping Word's separator marks. */
+export declare function parseNotesPart(xml: string, kind: 'footnote' | 'endnote', parseBlocks: (container: XmlElement, idPrefix: string) => Block[]): Note[];
+/** Renders a 1-based note number in a Word `w:numFmt` display format. */
+export declare function formatNoteNumber(value: number, format: string | undefined): string;
+/** Assigns 1-based note numbers by first-reference order, the same order Word displays. */
+export declare function numberNotesInOrder(blocks: Block[], kind: 'footnote' | 'endnote'): Map<string, number>;
+//# sourceMappingURL=notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/docx/notes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAa,MAAM,YAAY,CAAC;AACzD,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAIrE,2FAA2F;AAC3F,wBAAgB,cAAc,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,WAAW,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,KAAK,EAAE,GAC/D,IAAI,EAAE,CAaR;AAuCD,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAelF;AAqBD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,KAAK,EAAE,EACf,IAAI,EAAE,UAAU,GAAG,SAAS,GAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAIrB"}

package/dist/docx/numbering-editing.d.ts

@@ -0,0 +1,30 @@
+import type { NumberingCatalog, NumberingLevelDefinition } from './numbering-model.js';
+import type { ParagraphStyleCatalog } from './model-paragraph.js';
+/**
+ * `multilevel` numbers 1., 1.1., 1.1.1. (every level shows its ancestors); `outline` cycles
+ * 1., a), i. by level, like Word's plain outline lists.
+ */
+export type ListKind = 'bullet' | 'decimal' | 'multilevel' | 'outline';
+/**
+ * Returns a catalog with one additional, independent list definition of the requested kind and
+ * its `numId`. Pure: never mutates `catalog`. Existing entries are always reused unchanged, so
+ * every call mints a fresh `abstractNum`/`num` pair with its own restart-from-1 counter, matching
+ * how Word starts a new list rather than continuing an unrelated one.
+ */
+export declare function ensureListDefinition(catalog: NumberingCatalog | undefined, kind: ListKind): {
+    catalog: NumberingCatalog;
+    numId: number;
+};
+/** Adds a validated independent definition without modifying any imported list. */
+export declare function createListDefinition(catalog: NumberingCatalog | undefined, levels: readonly NumberingLevelDefinition[]): {
+    catalog: NumberingCatalog;
+    numId: number;
+};
+/**
+ * Points each existing paragraph style named by a level's `paragraphStyleId` at that level of
+ * list `numId` (the style's `w:numPr`), as Word does for heading-linked outlines. Pure; styles that
+ * are not in the catalog are skipped. A style linked from two levels keeps the deepest-first
+ * assignment that appears last, so callers should keep style ids unique per list.
+ */
+export declare function linkStylesToList(styles: ParagraphStyleCatalog | undefined, levels: readonly NumberingLevelDefinition[], numId: number): ParagraphStyleCatalog | undefined;
+//# sourceMappingURL=numbering-editing.d.ts.map

package/dist/docx/numbering-editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-editing.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-editing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,gBAAgB,EAChB,wBAAwB,EAExB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;AAoDvE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,IAAI,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,MAAM,EAAE,SAAS,wBAAwB,EAAE,GACzC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0B9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,MAAM,EAAE,SAAS,wBAAwB,EAAE,EAC3C,KAAK,EAAE,MAAM,GACX,qBAAqB,GAAG,SAAS,CAQnC"}

package/dist/docx/numbering-format.d.ts

@@ -0,0 +1,17 @@
+import type { DocumentModel, Paragraph, ParagraphStyleCatalog } from './model.js';
+import type { NumberingCatalog, ParagraphListLabel } from './numbering-model.js';
+/** Formats one placeholder value using a level's numbering format. */
+export declare function formatListNumber(numFmt: string, value: number): string;
+/** Resolves the paragraph's effective `{ numId, level }`, direct or inherited through its style. */
+export declare function resolveParagraphNumbering(paragraph: Paragraph, styleCatalog: ParagraphStyleCatalog | undefined, numberingCatalog?: NumberingCatalog): {
+    numId: number;
+    level: number;
+} | undefined;
+/**
+ * Computes list markers for every numbered/bulleted paragraph in document order, tracking
+ * counter state across the document per `numId`/level. Purely derived from the model; never
+ * mutates it and is never itself part of the saved document.
+ */
+export declare function computeListLabels(model: DocumentModel): Map<string, ParagraphListLabel>;
+export declare function displayListLabel(text: string): string;
+//# sourceMappingURL=numbering-format.d.ts.map

package/dist/docx/numbering-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-format.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,aAAa,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EACX,gBAAgB,EAEhB,kBAAkB,EAClB,MAAM,sBAAsB,CAAC;AAY9B,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BtE;AAED,oGAAoG;AACpG,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,qBAAqB,GAAG,SAAS,EAC/C,gBAAgB,CAAC,EAAE,gBAAgB,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAgB9C;AAgGD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAkCvF;AAiBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}

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

@@ -0,0 +1,73 @@
+import type { StNumberFormat } from './generated/wml-simple-types.js';
+import type { SignedTwips, Twips } from './units.js';
+/** Character formatting of a level's marker (`w:lvl/w:rPr`); absent fields follow the paragraph's text. */
+export interface NumberingMarkerFormat {
+    fontFamily?: string;
+    /** `w:sz` in half-points. */
+    fontSizeHalfPoints?: number;
+    bold?: boolean;
+    italic?: boolean;
+    /** `#rrggbb`; automatic colour is represented by omission. */
+    color?: string;
+}
+/** A single `w:lvl` definition, fully resolved from an abstractNum (and any lvlOverride). */
+export interface NumberingLevelDefinition {
+    /** 0-based `w:ilvl`. */
+    level: number;
+    start: number;
+    /** `w:numFmt/@w:val` (`ST_NumberFormat`), such as `decimal`, `bullet`, `lowerRoman`. Invalid values fall back to `decimal` with a parse warning. */
+    numFmt: StNumberFormat;
+    /** Raw `w:lvlText/@w:val`, with `%1`..`%9` placeholders (1-based ancestor levels) or a bullet glyph. */
+    lvlText: string;
+    /** Paragraph style associated with this level (`w:pStyle`). */
+    paragraphStyleId?: string;
+    lvlJc?: 'left' | 'center' | 'right';
+    indentLeftTwips?: SignedTwips;
+    hangingTwips?: Twips;
+    firstLineTwips?: Twips;
+    /** `w:isLgl`: render every placeholder in this level's marker as Decimal Number regardless of format. */
+    isLgl?: boolean;
+    /** `w:lvlRestart/@w:val`: one-based higher-level restart trigger; 0 means never. Omitted defaults to the previous level. */
+    lvlRestart?: number;
+    /** Marker-to-text separator from `w:suff` (defaults to `tab`). */
+    suffix?: 'tab' | 'space' | 'none';
+    /** Explicit tab stop for the marker's tab suffix (`w:pPr/w:tabs/w:tab`, `w:val="num"`). */
+    tabStopTwips?: Twips;
+    /** Marker formatting from `w:rPr`. */
+    markerFormat?: NumberingMarkerFormat;
+}
+export interface AbstractNumDefinition {
+    id: string;
+    levels: Record<number, NumberingLevelDefinition>;
+}
+export interface NumLevelOverride {
+    startOverride?: number;
+    lvl?: NumberingLevelDefinition;
+}
+export interface NumDefinition {
+    id: string;
+    abstractNumId: string;
+    levelOverrides?: Record<number, NumLevelOverride>;
+}
+/** Parsed source `word/numbering.xml`. Existing entries are read-only; only additive entries can be saved. */
+export interface NumberingCatalog {
+    abstractNums: Record<string, AbstractNumDefinition>;
+    nums: Record<string, NumDefinition>;
+    warnings: string[];
+}
+/** A computed, render-only list marker for one paragraph. Never written back to the model. */
+export interface ParagraphListLabel {
+    numId: string;
+    level: number;
+    /** Marker text with `%n` placeholders already substituted (no trailing suffix). */
+    text: string;
+    suffix: 'tab' | 'space' | 'none';
+    /** Alignment of the marker around the paragraph's first-line position. */
+    alignment?: 'left' | 'center' | 'right';
+    indentLeftTwips?: SignedTwips;
+    hangingTwips?: Twips;
+    firstLineTwips?: Twips;
+    tabStopTwips?: Twips;
+    markerFormat?: NumberingMarkerFormat;
+}
+//# sourceMappingURL=numbering-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-model.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,2GAA2G;AAC3G,MAAM,WAAW,qBAAqB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AACD,6FAA6F;AAC7F,MAAM,WAAW,wBAAwB;IACxC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,oJAAoJ;IACpJ,MAAM,EAAE,cAAc,CAAC;IACvB,wGAAwG;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,yGAAyG;IACzG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4HAA4H;IAC5H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,sCAAsC;IACtC,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACrC;AACD,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CACjD;AACD,MAAM,WAAW,gBAAgB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,wBAAwB,CAAC;CAC/B;AACD,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAClD;AACD,8GAA8G;AAC9G,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AACD,8FAA8F;AAC9F,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,cAAc,CAAC,EAAE,KAAK,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACrC"}

package/dist/docx/numbering-package.d.ts

@@ -0,0 +1,12 @@
+import type JSZip from 'jszip';
+import type { DocumentModel } from './model.js';
+/**
+ * Applies additive changes to the numbering catalog onto the package's `word/numbering.xml`.
+ * Existing `abstractNum`/`num` entries are read-only: any difference from the loaded baseline is
+ * rejected. New entries are appended in schema order and the part/relationship/content-type are
+ * created the first time a document gains numbering.
+ */
+export declare function applyNumberingCatalog(zip: JSZip, model: DocumentModel, binding: {
+    base: DocumentModel;
+} | undefined): Promise<void>;
+//# sourceMappingURL=numbering-package.d.ts.map

package/dist/docx/numbering-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-package.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-package.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiHhD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,SAAS,GAC1C,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/docx/numbering-parse.d.ts

@@ -0,0 +1,8 @@
+import type { NumberingCatalog, NumberingLevelDefinition } from './numbering-model.js';
+import { type XmlElement } from './xml.js';
+export declare function parseNumberingLevel(lvl: XmlElement): NumberingLevelDefinition;
+/** Parses `word/numbering.xml` into a read-only catalog; editing existing entries is not supported. */
+export declare function parseNumberingCatalog(xml: string): NumberingCatalog;
+/** Resolves the effective level definition for a `numId`, applying any `lvlOverride`. */
+export declare function resolveNumberingLevel(catalog: NumberingCatalog, numId: string, level: number): NumberingLevelDefinition | undefined;
+//# sourceMappingURL=numbering-parse.d.ts.map

package/dist/docx/numbering-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-parse.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEX,gBAAgB,EAChB,wBAAwB,EAIxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AA6BnF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,wBAAwB,CAgC7E;AAkCD,uGAAuG;AACvG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAyBnE;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,wBAAwB,GAAG,SAAS,CAOtC"}

package/dist/docx/numbering-parts.d.ts

@@ -0,0 +1,4 @@
+import type JSZip from 'jszip';
+/** Adds the content-type override and word-part relationship for a newly created `word/numbering.xml`. */
+export declare function registerNumberingPart(zip: JSZip): Promise<void>;
+//# sourceMappingURL=numbering-parts.d.ts.map

package/dist/docx/numbering-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-parts.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-parts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,0GAA0G;AAC1G,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCrE"}

package/dist/docx/numbering-text.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Roman numeral conversion. Adapted from
+ * pptx-viewer-new packages/core/src/core/utils/auto-number-format.ts (romanNumeral),
+ * which documents the same clamp-to-[1,3999] behavior verified against real output.
+ */
+export declare function romanNumeral(n: number): string;
+/**
+ * Word's alphabetic label (lower-case): past `z` the letter repeats rather than
+ * counting spreadsheet-style. Adapted from the `repeatedLabel` rule in
+ * pptx-viewer-new packages/core/src/core/utils/auto-number-alphabets.ts
+ * (1 -> "a", 26 -> "z", 27 -> "aa", 52 -> "zz", 53 -> "aaa").
+ */
+export declare function letterLabel(n: number): string;
+/** `decimal` numeral immediately followed by its English ordinal suffix, e.g. `2nd`. */
+export declare function ordinalNumeral(n: number): string;
+/** English cardinal words for 0..999,999 (falls back to the decimal numeral outside that range). */
+export declare function cardinalWords(n: number): string;
+/** English ordinal words for 0..999,999, e.g. `twenty-first` (falls back to the ordinal numeral). */
+export declare function ordinalWords(n: number): string;
+//# sourceMappingURL=numbering-text.d.ts.map

package/dist/docx/numbering-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-text.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-text.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA0B9C;AAGD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7C;AAgBD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAyBD,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAuB/C;AAWD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9C"}

package/dist/docx/numbering-write.d.ts

@@ -0,0 +1,5 @@
+import type { Paragraph } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** Writes or removes `w:numPr` on a paragraph's `pPr`, diffed against the base paragraph. */
+export declare function writeNumberingProperties(doc: XmlDocument, props: XmlElement, paragraph: Paragraph, base?: Paragraph): void;
+//# sourceMappingURL=numbering-write.d.ts.map

package/dist/docx/numbering-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-write.d.ts","sourceRoot":"","sources":["../../src/docx/numbering-write.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAUvF,6FAA6F;AAC7F,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAYN"}

package/dist/docx/package-parts.d.ts

@@ -0,0 +1,4 @@
+export { buildRelationshipsXml, contentTypeForPart, ensureContentTypeDefault, parseContentTypes, parseRelationships, type ContentTypes, type Relationship, } from '../opc/index.js';
+/** Resolves a relationship target that is relative to `word/` (the only base part this codec writes into). */
+export declare function resolveInternalTarget(target: string): string;
+//# sourceMappingURL=package-parts.d.ts.map

package/dist/docx/package-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-parts.d.ts","sourceRoot":"","sources":["../../src/docx/package-parts.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GACjB,MAAM,iBAAiB,CAAC;AAEzB,8GAA8G;AAC9G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D"}

package/dist/docx/page-background.d.ts

@@ -0,0 +1,9 @@
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** The page colour of `w:document/w:background`, as uppercase hex without `#`. */
+export declare function parsePageBackground(root: XmlElement | null | undefined): string | undefined;
+/**
+ * Sets or clears the page colour. An unchanged colour leaves the element (and any theme
+ * attributes on it) as it was; a new one replaces it, ahead of `w:body` as the schema requires.
+ */
+export declare function applyPageBackground(doc: XmlDocument, color: string | undefined): void;
+//# sourceMappingURL=page-background.d.ts.map

package/dist/docx/page-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-background.d.ts","sourceRoot":"","sources":["../../src/docx/page-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAKpG,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG3F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAarF"}