ooxml.js 2.5.2 → 2.6.0

package/README.md

@@ -219,7 +219,7 @@ The package is layered from a lossless core outward to lossy convenience views:
 - **`src/codec.ts`** — the public round-trip surface: `packageCodec`/`xmlCodec` are `z.codec()` pairs, and `decodePackage`/`encodePackage` are the ergonomic wrappers around them.
 - **`src/compact.ts`** — the ooxml.js format: `compactCodec` (`z.codec(PackageSchema, CompactPackageSchema, …)`) maps `Package ⇄ CompactPackage`, with `toCompact`/`fromCompact` as the ergonomic wrappers. `compactPackageCodec` composes `packageCodec` and `compactCodec` into a direct bytes ⇄ `CompactPackage` codec (`decodeCompactPackage`/`encodeCompactPackage`), so all three format pairs — bytes/`Package`, `Package`/`CompactPackage`, bytes/`CompactPackage` — have a named codec rather than requiring callers to chain two.
 - **`src/typed/`** — one-way, lossy projections that read the generic `Package` into ergonomic document/presentation/workbook models. `docx/` and `pptx/` share one block content model — `ContentParagraph`/`ContentTable`/`ContentImageBlock`/`ContentPageBreak`, discriminated as `ContentBlock`, imported from the sibling [`document-schema.js`](https://github.com/ExaDev/document-schema.js) package rather than defined here (see below) — instead of each keeping its own, disjoint shape: `readDocx` resolves the full WordprocessingML style cascade (`docx/styles.ts`: `docDefaults` → named-style `basedOn` chains → paragraph-mark run properties → character styles → direct formatting) into ordered `sections` of paragraphs/tables/page-breaks (document order preserved, including inside tables), plus `comments`, `footnotes`, and `headers`/`footers`; `readPptx` resolves the placeholder → layout → master → theme inheritance cascade (`pptx/inherit.ts`) into `slides` of positioned, styled `shapes` (geometry, run/paragraph formatting, embedded images, tables, speaker notes) in presentation order (`p:sldIdLst`, never slide filename order); `readXlsx` covers cell values and formulas, merged ranges and defined names. `typed/shared/` holds the OOXML-specific primitives both `docx/` and `pptx/` build on: `drawingml.ts` (DrawingML `a:xfrm` geometry, theme/colour resolution, group-transform composition — including `ColorTransform`/`applyColorTransforms`, the shade/tint/lumMod/lumOff cascade maths, which stays here rather than in `document-schema.js` since it's OOXML-cascade-resolution logic, not a content-model shape), `units.ts` (OOXML unit conversions — EMU/twip/half-point), `metadata.ts` (`docProps/core.xml` + `docProps/app.xml` → `DocumentMetadata`, shared verbatim across docx/pptx/xlsx), and `source-path.ts` (stamps a deterministic, document-order path like `sections[0].blocks[2].runs[1]` onto every `ContentRun`/`ContentBlock`/`ContentShape`, so a downstream consumer can trace a rendered item back to where it came from — see `document-schema.js`'s own `sourcePath` field). Geometry (`Box`/`PageSize`/`Margins`), colour (`Color`/`ColorSchema`), and alignment (`Alignment`) types are imported from `document-schema.js`, not defined locally. `src/image/sniff.ts` (magic-byte PNG/JPEG detection) supports `readPptx`'s picture-shape reading. None of `readDocx`/`readPptx`/`readXlsx` can be encoded back to a `Package` — round-tripping those always goes through `decodePackage`/`encodePackage`, never through a typed view; see `src/typed/xlsx/` below for this package's one write-back exception. `typed/util.ts` holds the shared XML-walking helpers (`walk`, `elementsWithTag`, `childrenWithTag`, `attr`, `rootElement`, `textContent`, entity decoding, `resolveRelationships`) every typed reader builds on.
-- **`src/typed/xlsx/`** — a second, `ContentDocument`-shaped xlsx pair alongside the lossy `readXlsx` above, not a replacement for it (both stay exported; they serve different callers). `content.ts`'s `readXlsxContent` reads a `Package` straight into `ContentDocument` (`kind: 'spreadsheet'`): real column widths, row heights, hidden rows/columns, merged ranges (resolved onto the anchor cell's `colSpan`/`rowSpan`), every cell value kind xlsx itself distinguishes, and a genuinely populated `ContentSheetPrintSettings` — matching the bar the sibling `odf.js` package's own `readOds` already sets, rather than `readXlsx`'s flattened `XlsxWorkbook`/`XlsxCell` shape. `build.ts`'s `buildXlsxPackage` is `readXlsxContent`'s write-side inverse and this package's first writer of genuinely new content: given a `ContentDocument`, it constructs a complete xlsx `Package` from scratch — workbook, worksheets, a minimal-but-real `xl/styles.xml`, shared strings, core/app properties — via `xml/fragment.ts`'s `el`/`txt`, rather than editing whatever package `readXlsxContent` itself decoded. Both stay scoped to what `ContentDocument`'s `spreadsheet` variant models: no number-format engine (a numeric cell's percentage/currency/date semantics live in `xl/styles.xml`'s own `numFmt` codes, which neither side interprets) and no per-cell rich-text runs.
+- **`src/typed/xlsx/`** — a second, `ContentDocument`-shaped xlsx pair alongside the lossy `readXlsx` above, not a replacement for it (both stay exported; they serve different callers). `content.ts`'s `readXlsxContent` reads a `Package` straight into `ContentDocument` (`kind: 'spreadsheet'`): real column widths, row heights, hidden rows/columns, merged ranges (resolved onto the anchor cell's `colSpan`/`rowSpan`), every cell value kind xlsx itself distinguishes, and a genuinely populated `ContentSheetPrintSettings` — matching the bar the sibling `odf.js` package's own `readOds` already sets, rather than `readXlsx`'s flattened `XlsxWorkbook`/`XlsxCell` shape. `build.ts`'s `buildXlsxPackage` is `readXlsxContent`'s write-side inverse and this package's first writer of genuinely new content: given a `ContentDocument`, it constructs a complete xlsx `Package` from scratch — workbook, worksheets, a minimal-but-real `xl/styles.xml`, shared strings, core/app properties — via `xml/fragment.ts`'s `el`/`txt`, rather than editing whatever package `readXlsxContent` itself decoded. `number-format.ts`/`styles.ts`/`serial.ts` are the number-format engine, and run both ways: xlsx has no cell type for a percentage, an amount of money, a date, or a time — all four are plain numeric cells wearing a `numFmt` style — so, reading, `styles.ts` resolves a cell's own style index to a format code, `number-format.ts` tokenizes and classifies that code (its `BUILTIN_NUMBER_FORMATS` table for `numFmtId` 0-49 is fed through the same classifier as a producer-declared code, never a second table of pre-decided kinds), and `serial.ts` converts a date/time serial to the canonical ISO spelling `document-schema.js` fixes. Writing, the same three run in reverse: `number-format.ts` holds the small vocabulary of formats `buildXlsxPackage` emits (built-in ids for a percentage and a time of day; ISO-ordered date/dateTime codes; `[$GBP]#,##0.00` for a currency, so the ISO code itself survives where a bare symbol would not; LibreOffice's own `"TRUE";"TRUE";"FALSE"` for a boolean, so real Excel and Calc display one as TRUE/FALSE rather than as a bare 1/0), `styles.ts`'s `CellFormatTable` interns them on demand into a real `<numFmts>`/`<cellXfs>` pair (a `SharedStringTable` for cell formats — same format, same index; no custom format used, no `<numFmts>` element written at all), and `serial.ts` converts an ISO spelling back to the serial the cell actually carries. Every code the writer emits is fed back through the reader's own classifier in the test suite, so the two halves cannot drift. It classifies rather than renders: `displayText` stays the plain typed-value spelling, not the producer's own formatted string. The remaining scope limits: a `currency` value naming no ISO 4217 code writes as a plain amount format and so reads back as a `number` (nothing in `#,##0.00` says money, and prefixing every such amount with a generic ¤ to keep the kind would change a file's appearance for something its author never asked for); a temporal value that is not the canonical `ContentCellValue` spelling, or that names a moment with no serial, degrades to a text cell carrying the original string verbatim rather than to a fabricated serial; and no per-cell rich-text runs on either side.
 
 ## Conventions
 

package/dist/index.cjs

@@ -15,6 +15,7 @@ const require_typed_util = require("./typed/util.cjs");
 const require_typed_shared_color = require("./typed/shared/color.cjs");
 const require_typed_shared_metadata = require("./typed/shared/metadata.cjs");
 const require_image_sniff = require("./image/sniff.cjs");
+const require_typed_docx_numbering = require("./typed/docx/numbering.cjs");
 const require_typed_docx_read = require("./typed/docx/read.cjs");
 const require_typed_pptx_read = require("./typed/pptx/read.cjs");
 const require_typed_xlsx = require("./typed/xlsx.cjs");
@@ -63,6 +64,18 @@ Object.defineProperty(exports, "ContentBlockSchema", {
 		return document_schema_js.ContentBlockSchema;
 	}
 });
+Object.defineProperty(exports, "ContentBorderSchema", {
+	enumerable: true,
+	get: function() {
+		return document_schema_js.ContentBorderSchema;
+	}
+});
+Object.defineProperty(exports, "ContentCellBordersSchema", {
+	enumerable: true,
+	get: function() {
+		return document_schema_js.ContentCellBordersSchema;
+	}
+});
 Object.defineProperty(exports, "ContentCellValueSchema", {
 	enumerable: true,
 	get: function() {
@@ -171,6 +184,12 @@ Object.defineProperty(exports, "ContentSlideSchema", {
 		return document_schema_js.ContentSlideSchema;
 	}
 });
+Object.defineProperty(exports, "ContentStrokeStyleSchema", {
+	enumerable: true,
+	get: function() {
+		return document_schema_js.ContentStrokeStyleSchema;
+	}
+});
 Object.defineProperty(exports, "ContentTableCellSchema", {
 	enumerable: true,
 	get: function() {
@@ -199,6 +218,8 @@ Object.defineProperty(exports, "MarginsSchema", {
 		return document_schema_js.MarginsSchema;
 	}
 });
+exports.NumberingDefinitionSchema = require_typed_docx_numbering.NumberingDefinitionSchema;
+exports.NumberingLevelSchema = require_typed_docx_numbering.NumberingLevelSchema;
 Object.defineProperty(exports, "PAGE_SIZE_A4", {
 	enumerable: true,
 	get: function() {
@@ -279,6 +300,7 @@ exports.packageCodec = require_codec.packageCodec;
 exports.parsePackage = require_package_io_read.parsePackage;
 exports.parseXml = require_xml_parse.parseXml;
 exports.readDocx = require_typed_docx_read.readDocx;
+exports.readNumberingDefinitions = require_typed_docx_numbering.readNumberingDefinitions;
 exports.readPptx = require_typed_pptx_read.readPptx;
 exports.readXlsx = require_typed_xlsx.readXlsx;
 exports.readXlsxContent = require_typed_xlsx_content.readXlsxContent;

package/dist/index.d.cts

@@ -15,9 +15,10 @@ import { Relationship, attr, childrenWithTag, decodeEntities, elementsWithTag, r
 import { ColorTransform, applyColorTransforms } from "./typed/shared/color.cjs";
 import { DocumentMetadata, DocumentMetadataSchema } from "./typed/shared/metadata.cjs";
 import { Comment, CommentSchema, DocxDocument, DocxDocumentSchema, Footnote, FootnoteSchema, readDocx } from "./typed/docx/read.cjs";
+import { NumberingDefinition, NumberingDefinitionSchema, NumberingDefinitions, NumberingLevel, NumberingLevelSchema, readNumberingDefinitions } from "./typed/docx/numbering.cjs";
 import { PptxDocument, PptxDocumentSchema, readPptx } from "./typed/pptx/read.cjs";
 import { DefinedName, DefinedNameSchema, XlsxCell, XlsxCellSchema, XlsxSheet, XlsxSheetSchema, XlsxWorkbook, XlsxWorkbookSchema, readXlsx } from "./typed/xlsx.cjs";
 import { readXlsxContent } from "./typed/xlsx/content.cjs";
 import { buildXlsxPackage } from "./typed/xlsx/build.cjs";
-import { Alignment, AlignmentSchema, Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, Color, ColorSchema, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValueSchema, ContentDocument, ContentDocumentSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, type Color, ColorSchema, type ColorTransform, type Comment, CommentSchema, type CompactAttrPairs, type CompactPackage, CompactPackageSchema, type CompactPart, CompactPartSchema, type CompactXmlNode, CompactXmlNodeSchema, type ContentBlock, ContentBlockSchema, type ContentCellValue, ContentCellValueSchema, type ContentDocument, ContentDocumentSchema, type ContentImageBlock, ContentImageBlockSchema, type ContentListMembership, ContentListMembershipSchema, type ContentPageBreak, ContentPageBreakSchema, type ContentParagraph, ContentParagraphSchema, type ContentRun, ContentRunSchema, type ContentSection, ContentSectionSchema, type ContentShape, ContentShapeSchema, type ContentSheet, type ContentSheetCell, ContentSheetCellSchema, type ContentSheetColumn, ContentSheetColumnSchema, type ContentSheetImage, ContentSheetImageSchema, type ContentSheetPrintRange, ContentSheetPrintRangeSchema, type ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, type ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, type ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, type ContentSlide, ContentSlideSchema, type ContentTable, type ContentTableCell, ContentTableCellSchema, type ContentTableRow, ContentTableRowSchema, ContentTableSchema, type DefinedName, DefinedNameSchema, type DocumentMetadata, DocumentMetadataSchema, type DocxDocument, DocxDocumentSchema, type Footnote, FootnoteSchema, type ImageFormat, type Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, type Package, PackageSchema, type PageSize, PageSizeSchema, type Part, PartSchema, type PptxDocument, PptxDocumentSchema, type Relationship, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, type XlsxCell, XlsxCellSchema, type XlsxSheet, XlsxSheetSchema, type XlsxWorkbook, XlsxWorkbookSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };
+import { Alignment, AlignmentSchema, Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, Color, ColorSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellValue, ContentCellValueSchema, ContentDocument, ContentDocumentSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, type Color, ColorSchema, type ColorTransform, type Comment, CommentSchema, type CompactAttrPairs, type CompactPackage, CompactPackageSchema, type CompactPart, CompactPartSchema, type CompactXmlNode, CompactXmlNodeSchema, type ContentBlock, ContentBlockSchema, type ContentBorder, ContentBorderSchema, type ContentCellBorders, ContentCellBordersSchema, type ContentCellValue, ContentCellValueSchema, type ContentDocument, ContentDocumentSchema, type ContentImageBlock, ContentImageBlockSchema, type ContentListMembership, ContentListMembershipSchema, type ContentPageBreak, ContentPageBreakSchema, type ContentParagraph, ContentParagraphSchema, type ContentRun, ContentRunSchema, type ContentSection, ContentSectionSchema, type ContentShape, ContentShapeSchema, type ContentSheet, type ContentSheetCell, ContentSheetCellSchema, type ContentSheetColumn, ContentSheetColumnSchema, type ContentSheetImage, ContentSheetImageSchema, type ContentSheetPrintRange, ContentSheetPrintRangeSchema, type ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, type ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, type ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, type ContentSlide, ContentSlideSchema, type ContentStrokeStyle, ContentStrokeStyleSchema, type ContentTable, type ContentTableCell, ContentTableCellSchema, type ContentTableRow, ContentTableRowSchema, ContentTableSchema, type DefinedName, DefinedNameSchema, type DocumentMetadata, DocumentMetadataSchema, type DocxDocument, DocxDocumentSchema, type Footnote, FootnoteSchema, type ImageFormat, type Margins, MarginsSchema, type NumberingDefinition, NumberingDefinitionSchema, type NumberingDefinitions, type NumberingLevel, NumberingLevelSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, type Package, PackageSchema, type PageSize, PageSizeSchema, type Part, PartSchema, type PptxDocument, PptxDocumentSchema, type Relationship, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, type XlsxCell, XlsxCellSchema, type XlsxSheet, XlsxSheetSchema, type XlsxWorkbook, XlsxWorkbookSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readNumberingDefinitions, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };

package/dist/index.d.ts

@@ -15,9 +15,10 @@ import { Relationship, attr, childrenWithTag, decodeEntities, elementsWithTag, r
 import { ColorTransform, applyColorTransforms } from "./typed/shared/color.js";
 import { DocumentMetadata, DocumentMetadataSchema } from "./typed/shared/metadata.js";
 import { Comment, CommentSchema, DocxDocument, DocxDocumentSchema, Footnote, FootnoteSchema, readDocx } from "./typed/docx/read.js";
+import { NumberingDefinition, NumberingDefinitionSchema, NumberingDefinitions, NumberingLevel, NumberingLevelSchema, readNumberingDefinitions } from "./typed/docx/numbering.js";
 import { PptxDocument, PptxDocumentSchema, readPptx } from "./typed/pptx/read.js";
 import { DefinedName, DefinedNameSchema, XlsxCell, XlsxCellSchema, XlsxSheet, XlsxSheetSchema, XlsxWorkbook, XlsxWorkbookSchema, readXlsx } from "./typed/xlsx.js";
 import { readXlsxContent } from "./typed/xlsx/content.js";
 import { buildXlsxPackage } from "./typed/xlsx/build.js";
-import { Alignment, AlignmentSchema, Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, Color, ColorSchema, ContentBlock, ContentBlockSchema, ContentCellValue, ContentCellValueSchema, ContentDocument, ContentDocumentSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
-export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, type Color, ColorSchema, type ColorTransform, type Comment, CommentSchema, type CompactAttrPairs, type CompactPackage, CompactPackageSchema, type CompactPart, CompactPartSchema, type CompactXmlNode, CompactXmlNodeSchema, type ContentBlock, ContentBlockSchema, type ContentCellValue, ContentCellValueSchema, type ContentDocument, ContentDocumentSchema, type ContentImageBlock, ContentImageBlockSchema, type ContentListMembership, ContentListMembershipSchema, type ContentPageBreak, ContentPageBreakSchema, type ContentParagraph, ContentParagraphSchema, type ContentRun, ContentRunSchema, type ContentSection, ContentSectionSchema, type ContentShape, ContentShapeSchema, type ContentSheet, type ContentSheetCell, ContentSheetCellSchema, type ContentSheetColumn, ContentSheetColumnSchema, type ContentSheetImage, ContentSheetImageSchema, type ContentSheetPrintRange, ContentSheetPrintRangeSchema, type ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, type ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, type ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, type ContentSlide, ContentSlideSchema, type ContentTable, type ContentTableCell, ContentTableCellSchema, type ContentTableRow, ContentTableRowSchema, ContentTableSchema, type DefinedName, DefinedNameSchema, type DocumentMetadata, DocumentMetadataSchema, type DocxDocument, DocxDocumentSchema, type Footnote, FootnoteSchema, type ImageFormat, type Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, type Package, PackageSchema, type PageSize, PageSizeSchema, type Part, PartSchema, type PptxDocument, PptxDocumentSchema, type Relationship, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, type XlsxCell, XlsxCellSchema, type XlsxSheet, XlsxSheetSchema, type XlsxWorkbook, XlsxWorkbookSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };
+import { Alignment, AlignmentSchema, Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, Color, ColorSchema, ContentBlock, ContentBlockSchema, ContentBorder, ContentBorderSchema, ContentCellBorders, ContentCellBordersSchema, ContentCellValue, ContentCellValueSchema, ContentDocument, ContentDocumentSchema, ContentImageBlock, ContentImageBlockSchema, ContentListMembership, ContentListMembershipSchema, ContentPageBreak, ContentPageBreakSchema, ContentParagraph, ContentParagraphSchema, ContentRun, ContentRunSchema, ContentSection, ContentSectionSchema, ContentShape, ContentShapeSchema, ContentSheet, ContentSheetCell, ContentSheetCellSchema, ContentSheetColumn, ContentSheetColumnSchema, ContentSheetImage, ContentSheetImageSchema, ContentSheetPrintRange, ContentSheetPrintRangeSchema, ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, ContentSlide, ContentSlideSchema, ContentStrokeStyle, ContentStrokeStyleSchema, ContentTable, ContentTableCell, ContentTableCellSchema, ContentTableRow, ContentTableRowSchema, ContentTableSchema, Margins, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSize, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
+export { type Alignment, AlignmentSchema, type Attribute, AttributeSchema, type BinaryPart, BinaryPartSchema, type Box, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, type Color, ColorSchema, type ColorTransform, type Comment, CommentSchema, type CompactAttrPairs, type CompactPackage, CompactPackageSchema, type CompactPart, CompactPartSchema, type CompactXmlNode, CompactXmlNodeSchema, type ContentBlock, ContentBlockSchema, type ContentBorder, ContentBorderSchema, type ContentCellBorders, ContentCellBordersSchema, type ContentCellValue, ContentCellValueSchema, type ContentDocument, ContentDocumentSchema, type ContentImageBlock, ContentImageBlockSchema, type ContentListMembership, ContentListMembershipSchema, type ContentPageBreak, ContentPageBreakSchema, type ContentParagraph, ContentParagraphSchema, type ContentRun, ContentRunSchema, type ContentSection, ContentSectionSchema, type ContentShape, ContentShapeSchema, type ContentSheet, type ContentSheetCell, ContentSheetCellSchema, type ContentSheetColumn, ContentSheetColumnSchema, type ContentSheetImage, ContentSheetImageSchema, type ContentSheetPrintRange, ContentSheetPrintRangeSchema, type ContentSheetPrintSettings, ContentSheetPrintSettingsSchema, type ContentSheetRepeatRange, ContentSheetRepeatRangeSchema, type ContentSheetRow, ContentSheetRowSchema, ContentSheetSchema, type ContentSlide, ContentSlideSchema, type ContentStrokeStyle, ContentStrokeStyleSchema, type ContentTable, type ContentTableCell, ContentTableCellSchema, type ContentTableRow, ContentTableRowSchema, ContentTableSchema, type DefinedName, DefinedNameSchema, type DocumentMetadata, DocumentMetadataSchema, type DocxDocument, DocxDocumentSchema, type Footnote, FootnoteSchema, type ImageFormat, type Margins, MarginsSchema, type NumberingDefinition, NumberingDefinitionSchema, type NumberingDefinitions, type NumberingLevel, NumberingLevelSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, type Package, PackageSchema, type PageSize, PageSizeSchema, type Part, PartSchema, type PptxDocument, PptxDocumentSchema, type Relationship, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, type XlsxCell, XlsxCellSchema, type XlsxSheet, XlsxSheetSchema, type XlsxWorkbook, XlsxWorkbookSchema, type XmlCdata, XmlCdataSchema, type XmlComment, XmlCommentSchema, type XmlDeclaration, XmlDeclarationSchema, type XmlElement, XmlElementSchema, type XmlNode, XmlNodeSchema, type XmlPart, XmlPartSchema, type XmlPi, XmlPiSchema, type XmlText, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readNumberingDefinitions, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };

package/dist/index.js

@@ -14,10 +14,11 @@ import { attr, childrenWithTag, decodeEntities, elementsWithTag, resolveRelation
 import { applyColorTransforms } from "./typed/shared/color.js";
 import { DocumentMetadataSchema } from "./typed/shared/metadata.js";
 import { sniffImageFormat } from "./image/sniff.js";
+import { NumberingDefinitionSchema, NumberingLevelSchema, readNumberingDefinitions } from "./typed/docx/numbering.js";
 import { CommentSchema, DocxDocumentSchema, FootnoteSchema, readDocx } from "./typed/docx/read.js";
 import { PptxDocumentSchema, readPptx } from "./typed/pptx/read.js";
 import { DefinedNameSchema, XlsxCellSchema, XlsxSheetSchema, XlsxWorkbookSchema, readXlsx } from "./typed/xlsx.js";
 import { readXlsxContent } from "./typed/xlsx/content.js";
 import { buildXlsxPackage } from "./typed/xlsx/build.js";
-import { AlignmentSchema, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, ColorSchema, ContentBlockSchema, ContentCellValueSchema, ContentDocumentSchema, ContentImageBlockSchema, ContentListMembershipSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
-export { AlignmentSchema, AttributeSchema, BinaryPartSchema, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, ColorSchema, CommentSchema, CompactPackageSchema, CompactPartSchema, CompactXmlNodeSchema, ContentBlockSchema, ContentCellValueSchema, ContentDocumentSchema, ContentImageBlockSchema, ContentListMembershipSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, DefinedNameSchema, DocumentMetadataSchema, DocxDocumentSchema, FootnoteSchema, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PackageSchema, PageSizeSchema, PartSchema, PptxDocumentSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, XlsxCellSchema, XlsxSheetSchema, XlsxWorkbookSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };
+import { AlignmentSchema, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, ColorSchema, ContentBlockSchema, ContentBorderSchema, ContentCellBordersSchema, ContentCellValueSchema, ContentDocumentSchema, ContentImageBlockSchema, ContentListMembershipSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentStrokeStyleSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, MarginsSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PageSizeSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, colorToRgbHex, isContentBlock, rgbHexToColor } from "document-schema.js";
+export { AlignmentSchema, AttributeSchema, BinaryPartSchema, BoxSchema, COLOR_BLACK, CONTENT_FORMAT_VERSION, ColorSchema, CommentSchema, CompactPackageSchema, CompactPartSchema, CompactXmlNodeSchema, ContentBlockSchema, ContentBorderSchema, ContentCellBordersSchema, ContentCellValueSchema, ContentDocumentSchema, ContentImageBlockSchema, ContentListMembershipSchema, ContentPageBreakSchema, ContentParagraphSchema, ContentRunSchema, ContentSectionSchema, ContentShapeSchema, ContentSheetCellSchema, ContentSheetColumnSchema, ContentSheetImageSchema, ContentSheetPrintRangeSchema, ContentSheetPrintSettingsSchema, ContentSheetRepeatRangeSchema, ContentSheetRowSchema, ContentSheetSchema, ContentSlideSchema, ContentStrokeStyleSchema, ContentTableCellSchema, ContentTableRowSchema, ContentTableSchema, DefinedNameSchema, DocumentMetadataSchema, DocxDocumentSchema, FootnoteSchema, MarginsSchema, NumberingDefinitionSchema, NumberingLevelSchema, PAGE_SIZE_A4, PAGE_SIZE_LETTER, PackageSchema, PageSizeSchema, PartSchema, PptxDocumentSchema, SLIDE_SIZE_STANDARD, SLIDE_SIZE_WIDESCREEN, XlsxCellSchema, XlsxSheetSchema, XlsxWorkbookSchema, XmlCdataSchema, XmlCommentSchema, XmlDeclarationSchema, XmlElementSchema, XmlNodeSchema, XmlPartSchema, XmlPiSchema, XmlTextSchema, applyColorTransforms, attr, base64ToBytes, buildXlsxPackage, buildXml, bytesToBase64, childrenWithTag, colorToRgbHex, compactCodec, compactPackageCodec, decodeCompactPackage, decodeEntities, decodePackage, el, elementsWithTag, encodeCompactPackage, encodePackage, encodeXmlText, fromCompact, isCompactXmlNode, isContentBlock, isXmlNode, packageCodec, parsePackage, parseXml, readDocx, readNumberingDefinitions, readPptx, readXlsx, readXlsxContent, resolveRelationships, rgbHexToColor, rootElement, serializePackage, sniffImageFormat, textContent, toCompact, txt, unzipPackage, walk, xmlCodec, zipPackage };

package/dist/typed/docx/numbering.cjs

@@ -0,0 +1,86 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_typed_util = require("../util.cjs");
+let zod = require("zod");
+//#region src/typed/docx/numbering.ts
+const NumberingLevelSchema = zod.z.object({
+	format: zod.z.string(),
+	text: zod.z.string(),
+	startAt: zod.z.number(),
+	restart: zod.z.number().optional()
+});
+const NumberingDefinitionSchema = zod.z.object({ levels: zod.z.record(zod.z.string(), NumberingLevelSchema) });
+const NUMBERING_PART_PATH = "word/numbering.xml";
+function readLevel(lvl) {
+	const numFmtEl = require_typed_util.childrenWithTag(lvl, "w:numFmt")[0];
+	const lvlTextEl = require_typed_util.childrenWithTag(lvl, "w:lvlText")[0];
+	const format = numFmtEl === void 0 ? void 0 : require_typed_util.attr(numFmtEl, "w:val");
+	const text = lvlTextEl === void 0 ? void 0 : require_typed_util.attr(lvlTextEl, "w:val");
+	if (format === void 0 || text === void 0) return;
+	const startEl = require_typed_util.childrenWithTag(lvl, "w:start")[0];
+	const startVal = startEl === void 0 ? void 0 : require_typed_util.attr(startEl, "w:val");
+	const restartEl = require_typed_util.childrenWithTag(lvl, "w:lvlRestart")[0];
+	const restartVal = restartEl === void 0 ? void 0 : require_typed_util.attr(restartEl, "w:val");
+	const level = {
+		format,
+		text,
+		startAt: startVal === void 0 ? 1 : Number(startVal)
+	};
+	if (restartVal !== void 0) level.restart = Number(restartVal);
+	return level;
+}
+function readAbstractNumLevels(abstractNum) {
+	const levels = {};
+	for (const lvl of require_typed_util.childrenWithTag(abstractNum, "w:lvl")) {
+		const ilvl = require_typed_util.attr(lvl, "w:ilvl");
+		if (ilvl === void 0) continue;
+		const level = readLevel(lvl);
+		if (level !== void 0) levels[ilvl] = level;
+	}
+	return levels;
+}
+function applyLevelOverrides(baseLevels, num) {
+	const levels = { ...baseLevels };
+	for (const override of require_typed_util.childrenWithTag(num, "w:lvlOverride")) {
+		const ilvl = require_typed_util.attr(override, "w:ilvl");
+		if (ilvl === void 0) continue;
+		const nestedLvl = require_typed_util.childrenWithTag(override, "w:lvl")[0];
+		if (nestedLvl !== void 0) {
+			const level = readLevel(nestedLvl);
+			if (level !== void 0) levels[ilvl] = level;
+			continue;
+		}
+		const startOverrideEl = require_typed_util.childrenWithTag(override, "w:startOverride")[0];
+		const startOverrideVal = startOverrideEl === void 0 ? void 0 : require_typed_util.attr(startOverrideEl, "w:val");
+		const base = levels[ilvl];
+		if (startOverrideVal !== void 0 && base !== void 0) levels[ilvl] = {
+			...base,
+			startAt: Number(startOverrideVal)
+		};
+	}
+	return levels;
+}
+function readNumberingDefinitions(pkg) {
+	const root = require_typed_util.rootElement(pkg.parts[NUMBERING_PART_PATH]);
+	if (root === void 0) return {};
+	const abstractNums = /* @__PURE__ */ new Map();
+	for (const abstractNum of require_typed_util.childrenWithTag(root, "w:abstractNum")) {
+		const abstractNumId = require_typed_util.attr(abstractNum, "w:abstractNumId");
+		if (abstractNumId === void 0) continue;
+		abstractNums.set(abstractNumId, readAbstractNumLevels(abstractNum));
+	}
+	const definitions = {};
+	for (const num of require_typed_util.childrenWithTag(root, "w:num")) {
+		const numId = require_typed_util.attr(num, "w:numId");
+		const abstractNumIdEl = require_typed_util.childrenWithTag(num, "w:abstractNumId")[0];
+		const abstractNumId = abstractNumIdEl === void 0 ? void 0 : require_typed_util.attr(abstractNumIdEl, "w:val");
+		if (numId === void 0 || abstractNumId === void 0) continue;
+		const baseLevels = abstractNums.get(abstractNumId);
+		if (baseLevels === void 0) continue;
+		definitions[numId] = { levels: applyLevelOverrides(baseLevels, num) };
+	}
+	return definitions;
+}
+//#endregion
+exports.NumberingDefinitionSchema = NumberingDefinitionSchema;
+exports.NumberingLevelSchema = NumberingLevelSchema;
+exports.readNumberingDefinitions = readNumberingDefinitions;

package/dist/typed/docx/numbering.d.cts

@@ -0,0 +1,23 @@
+import { r as Package } from "../../package-L24lkba-.cjs";
+import { z } from "zod";
+//#region src/typed/docx/numbering.d.ts
+declare const NumberingLevelSchema: z.ZodObject<{
+  format: z.ZodString;
+  text: z.ZodString;
+  startAt: z.ZodNumber;
+  restart: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type NumberingLevel = z.infer<typeof NumberingLevelSchema>;
+declare const NumberingDefinitionSchema: z.ZodObject<{
+  levels: z.ZodRecord<z.ZodString, z.ZodObject<{
+    format: z.ZodString;
+    text: z.ZodString;
+    startAt: z.ZodNumber;
+    restart: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type NumberingDefinition = z.infer<typeof NumberingDefinitionSchema>;
+type NumberingDefinitions = Readonly<Record<string, NumberingDefinition>>;
+declare function readNumberingDefinitions(pkg: Package): NumberingDefinitions;
+//#endregion
+export { NumberingDefinition, NumberingDefinitionSchema, NumberingDefinitions, NumberingLevel, NumberingLevelSchema, readNumberingDefinitions };

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

@@ -0,0 +1,23 @@
+import { r as Package } from "../../package-BUojjTXf.js";
+import { z } from "zod";
+//#region src/typed/docx/numbering.d.ts
+declare const NumberingLevelSchema: z.ZodObject<{
+  format: z.ZodString;
+  text: z.ZodString;
+  startAt: z.ZodNumber;
+  restart: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type NumberingLevel = z.infer<typeof NumberingLevelSchema>;
+declare const NumberingDefinitionSchema: z.ZodObject<{
+  levels: z.ZodRecord<z.ZodString, z.ZodObject<{
+    format: z.ZodString;
+    text: z.ZodString;
+    startAt: z.ZodNumber;
+    restart: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type NumberingDefinition = z.infer<typeof NumberingDefinitionSchema>;
+type NumberingDefinitions = Readonly<Record<string, NumberingDefinition>>;
+declare function readNumberingDefinitions(pkg: Package): NumberingDefinitions;
+//#endregion
+export { NumberingDefinition, NumberingDefinitionSchema, NumberingDefinitions, NumberingLevel, NumberingLevelSchema, readNumberingDefinitions };

package/dist/typed/docx/numbering.js

@@ -0,0 +1,83 @@
+import { attr, childrenWithTag, rootElement } from "../util.js";
+import { z } from "zod";
+//#region src/typed/docx/numbering.ts
+const NumberingLevelSchema = z.object({
+	format: z.string(),
+	text: z.string(),
+	startAt: z.number(),
+	restart: z.number().optional()
+});
+const NumberingDefinitionSchema = z.object({ levels: z.record(z.string(), NumberingLevelSchema) });
+const NUMBERING_PART_PATH = "word/numbering.xml";
+function readLevel(lvl) {
+	const numFmtEl = childrenWithTag(lvl, "w:numFmt")[0];
+	const lvlTextEl = childrenWithTag(lvl, "w:lvlText")[0];
+	const format = numFmtEl === void 0 ? void 0 : attr(numFmtEl, "w:val");
+	const text = lvlTextEl === void 0 ? void 0 : attr(lvlTextEl, "w:val");
+	if (format === void 0 || text === void 0) return;
+	const startEl = childrenWithTag(lvl, "w:start")[0];
+	const startVal = startEl === void 0 ? void 0 : attr(startEl, "w:val");
+	const restartEl = childrenWithTag(lvl, "w:lvlRestart")[0];
+	const restartVal = restartEl === void 0 ? void 0 : attr(restartEl, "w:val");
+	const level = {
+		format,
+		text,
+		startAt: startVal === void 0 ? 1 : Number(startVal)
+	};
+	if (restartVal !== void 0) level.restart = Number(restartVal);
+	return level;
+}
+function readAbstractNumLevels(abstractNum) {
+	const levels = {};
+	for (const lvl of childrenWithTag(abstractNum, "w:lvl")) {
+		const ilvl = attr(lvl, "w:ilvl");
+		if (ilvl === void 0) continue;
+		const level = readLevel(lvl);
+		if (level !== void 0) levels[ilvl] = level;
+	}
+	return levels;
+}
+function applyLevelOverrides(baseLevels, num) {
+	const levels = { ...baseLevels };
+	for (const override of childrenWithTag(num, "w:lvlOverride")) {
+		const ilvl = attr(override, "w:ilvl");
+		if (ilvl === void 0) continue;
+		const nestedLvl = childrenWithTag(override, "w:lvl")[0];
+		if (nestedLvl !== void 0) {
+			const level = readLevel(nestedLvl);
+			if (level !== void 0) levels[ilvl] = level;
+			continue;
+		}
+		const startOverrideEl = childrenWithTag(override, "w:startOverride")[0];
+		const startOverrideVal = startOverrideEl === void 0 ? void 0 : attr(startOverrideEl, "w:val");
+		const base = levels[ilvl];
+		if (startOverrideVal !== void 0 && base !== void 0) levels[ilvl] = {
+			...base,
+			startAt: Number(startOverrideVal)
+		};
+	}
+	return levels;
+}
+function readNumberingDefinitions(pkg) {
+	const root = rootElement(pkg.parts[NUMBERING_PART_PATH]);
+	if (root === void 0) return {};
+	const abstractNums = /* @__PURE__ */ new Map();
+	for (const abstractNum of childrenWithTag(root, "w:abstractNum")) {
+		const abstractNumId = attr(abstractNum, "w:abstractNumId");
+		if (abstractNumId === void 0) continue;
+		abstractNums.set(abstractNumId, readAbstractNumLevels(abstractNum));
+	}
+	const definitions = {};
+	for (const num of childrenWithTag(root, "w:num")) {
+		const numId = attr(num, "w:numId");
+		const abstractNumIdEl = childrenWithTag(num, "w:abstractNumId")[0];
+		const abstractNumId = abstractNumIdEl === void 0 ? void 0 : attr(abstractNumIdEl, "w:val");
+		if (numId === void 0 || abstractNumId === void 0) continue;
+		const baseLevels = abstractNums.get(abstractNumId);
+		if (baseLevels === void 0) continue;
+		definitions[numId] = { levels: applyLevelOverrides(baseLevels, num) };
+	}
+	return definitions;
+}
+//#endregion
+export { NumberingDefinitionSchema, NumberingLevelSchema, readNumberingDefinitions };

package/dist/typed/docx/read.cjs

@@ -1,10 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_util_base64 = require("../../util/base64.cjs");
 const require_typed_util = require("../util.cjs");
 const require_typed_shared_metadata = require("../shared/metadata.cjs");
+const require_image_sniff = require("../../image/sniff.cjs");
 const require_typed_shared_units = require("../shared/units.cjs");
 const require_typed_shared_drawingml = require("../shared/drawingml.cjs");
 const require_typed_shared_source_path = require("../shared/source-path.cjs");
 const require_typed_docx_styles = require("./styles.cjs");
+const require_typed_docx_numbering = require("./numbering.cjs");
 let zod = require("zod");
 let document_schema_js = require("document-schema.js");
 //#region src/typed/docx/read.ts
@@ -22,7 +25,8 @@ const DocxDocumentSchema = zod.z.object({
 	comments: zod.z.array(CommentSchema),
 	footnotes: zod.z.array(FootnoteSchema),
 	headers: zod.z.array(zod.z.string()),
-	footers: zod.z.array(zod.z.string())
+	footers: zod.z.array(zod.z.string()),
+	numbering: zod.z.record(zod.z.string(), require_typed_docx_numbering.NumberingDefinitionSchema)
 });
 const DOCUMENT_PART_PATH = "word/document.xml";
 const STYLES_PART_PATH = "word/styles.xml";
@@ -89,6 +93,53 @@ function readRunText(run) {
 	}
 	return text;
 }
+function readDrawingImage(drawing, rels, pkg) {
+	const container = require_typed_util.childrenWithTag(drawing, "wp:inline")[0] ?? require_typed_util.childrenWithTag(drawing, "wp:anchor")[0];
+	if (container === void 0) return;
+	const extent = require_typed_util.childrenWithTag(container, "wp:extent")[0];
+	const cx = extent === void 0 ? void 0 : require_typed_util.attr(extent, "cx");
+	const cy = extent === void 0 ? void 0 : require_typed_util.attr(extent, "cy");
+	if (cx === void 0 || cy === void 0) return;
+	const docPr = require_typed_util.childrenWithTag(container, "wp:docPr")[0];
+	const altText = docPr === void 0 ? void 0 : require_typed_util.attr(docPr, "descr") ?? require_typed_util.attr(docPr, "title");
+	const blip = require_typed_util.elementsWithTag(container.children, "a:blip")[0];
+	const rId = blip === void 0 ? void 0 : require_typed_util.attr(blip, "r:embed");
+	const rel = rId === void 0 ? void 0 : rels.get(rId);
+	const mediaPart = rel === void 0 ? void 0 : pkg.parts[rel.target];
+	if (mediaPart?.kind !== "binary") return;
+	const format = require_image_sniff.sniffImageFormat(require_util_base64.base64ToBytes(mediaPart.base64));
+	if (format === void 0) return;
+	const image = {
+		kind: "image",
+		format,
+		base64: mediaPart.base64,
+		widthPt: require_typed_shared_units.emuToPt(Number(cx)),
+		heightPt: require_typed_shared_units.emuToPt(Number(cy))
+	};
+	if (altText !== void 0) image.altText = altText;
+	return image;
+}
+function collectDrawings(nodes, out) {
+	for (const node of nodes) {
+		if (node.type !== "element") continue;
+		if (node.tag === "w:del") continue;
+		if (node.tag === "w:drawing") {
+			out.push(node);
+			continue;
+		}
+		collectDrawings(node.children, out);
+	}
+}
+function readParagraphImages(paragraph, rels, pkg) {
+	const drawings = [];
+	collectDrawings(paragraph.children, drawings);
+	const images = [];
+	for (const drawing of drawings) {
+		const image = readDrawingImage(drawing, rels, pkg);
+		if (image !== void 0) images.push(image);
+	}
+	return images;
+}
 function readRun(run, paragraph, context) {
 	const props = require_typed_docx_styles.resolveRunProperties(run, paragraph, context);
 	return {
@@ -156,7 +207,51 @@ function readCellShading(tcPr) {
 	const fill = shd === void 0 ? void 0 : require_typed_util.attr(shd, "w:fill");
 	return fill === void 0 || fill === "auto" || fill === "none" ? void 0 : (0, document_schema_js.rgbHexToColor)(fill);
 }
-function readRawCell(tc, context, rels) {
+const BORDER_STYLE_MAP = /* @__PURE__ */ new Map([
+	["single", "solid"],
+	["thick", "solid"],
+	["triple", "solid"],
+	["outset", "solid"],
+	["inset", "solid"],
+	["threeDEmboss", "solid"],
+	["threeDEngrave", "solid"],
+	["dashed", "dashed"],
+	["dashSmallGap", "dashed"],
+	["dashDotStroked", "dashed"],
+	["dotDash", "dashed"],
+	["dotted", "dotted"],
+	["dotDotDash", "dotted"],
+	["double", "double"],
+	["doubleWave", "double"]
+]);
+const DEFAULT_BORDER_WIDTH_EIGHTH_POINTS = 4;
+function readCellBorderEdge(tcBorders, tag) {
+	const edge = tcBorders === void 0 ? void 0 : require_typed_util.childrenWithTag(tcBorders, tag)[0];
+	const val = edge === void 0 ? void 0 : require_typed_util.attr(edge, "w:val");
+	if (edge === void 0 || val === void 0 || val === "nil" || val === "none") return;
+	const sz = require_typed_util.attr(edge, "w:sz");
+	const colorVal = require_typed_util.attr(edge, "w:color");
+	return {
+		color: colorVal === void 0 || colorVal === "auto" ? document_schema_js.COLOR_BLACK : (0, document_schema_js.rgbHexToColor)(colorVal),
+		widthPt: require_typed_shared_units.eighthPointsToPt(sz === void 0 ? DEFAULT_BORDER_WIDTH_EIGHTH_POINTS : Number(sz)),
+		style: BORDER_STYLE_MAP.get(val) ?? "solid"
+	};
+}
+function readCellBorders(tcPr) {
+	const tcBorders = tcPr === void 0 ? void 0 : require_typed_util.childrenWithTag(tcPr, "w:tcBorders")[0];
+	if (tcBorders === void 0) return;
+	const borders = {};
+	const left = readCellBorderEdge(tcBorders, "w:left") ?? readCellBorderEdge(tcBorders, "w:start");
+	const right = readCellBorderEdge(tcBorders, "w:right") ?? readCellBorderEdge(tcBorders, "w:end");
+	const top = readCellBorderEdge(tcBorders, "w:top");
+	const bottom = readCellBorderEdge(tcBorders, "w:bottom");
+	if (left !== void 0) borders.left = left;
+	if (right !== void 0) borders.right = right;
+	if (top !== void 0) borders.top = top;
+	if (bottom !== void 0) borders.bottom = bottom;
+	return Object.keys(borders).length === 0 ? void 0 : borders;
+}
+function readRawCell(tc, context, rels, pkg) {
 	const tcPr = require_typed_util.childrenWithTag(tc, "w:tcPr")[0];
 	const gridSpanEl = tcPr === void 0 ? void 0 : require_typed_util.childrenWithTag(tcPr, "w:gridSpan")[0];
 	const gridSpanVal = gridSpanEl === void 0 ? void 0 : require_typed_util.attr(gridSpanEl, "w:val");
@@ -166,13 +261,14 @@ function readRawCell(tc, context, rels) {
 		gridSpan: gridSpanVal === void 0 ? 1 : Number(gridSpanVal),
 		isVMergeContinuation: vMergeVal === "continue",
 		background: readCellShading(tcPr),
-		blocks: readBodyBlocks(tc.children, context, rels)
+		borders: readCellBorders(tcPr),
+		blocks: readBodyBlocks(tc.children, context, rels, pkg)
 	};
 }
-function readTable(tbl, context, rels) {
+function readTable(tbl, context, rels, pkg) {
 	const tblGrid = require_typed_util.childrenWithTag(tbl, "w:tblGrid")[0];
 	const columnWidthsPt = tblGrid === void 0 ? [] : require_typed_util.childrenWithTag(tblGrid, "w:gridCol").map((col) => require_typed_shared_units.twipsToPt(Number(require_typed_util.attr(col, "w:w") ?? "0")));
-	const rawRows = require_typed_util.childrenWithTag(tbl, "w:tr").map((tr) => require_typed_util.childrenWithTag(tr, "w:tc").map((tc) => readRawCell(tc, context, rels)));
+	const rawRows = require_typed_util.childrenWithTag(tbl, "w:tr").map((tr) => require_typed_util.childrenWithTag(tr, "w:tc").map((tc) => readRawCell(tc, context, rels, pkg)));
 	const rowColumnIndices = rawRows.map((row) => {
 		const indices = [];
 		let col = 0;
@@ -198,31 +294,33 @@ function readTable(tbl, context, rels) {
 				blocks: cell.blocks,
 				colSpan: cell.gridSpan > 1 ? cell.gridSpan : void 0,
 				rowSpan: rowSpan > 1 ? rowSpan : void 0,
-				background: cell.background
+				background: cell.background,
+				borders: cell.borders
 			};
 		}) }))
 	};
 }
-function readBodyBlocks(nodes, context, rels) {
+function readBodyBlocks(nodes, context, rels, pkg) {
 	const blocks = [];
 	for (const node of nodes) {
 		if (node.type !== "element") continue;
 		if (node.tag === "w:p") {
 			if (hasPageBreakBefore(node)) blocks.push({ kind: "pageBreak" });
 			blocks.push(readParagraph(node, context, rels));
-		} else if (node.tag === "w:tbl") blocks.push(readTable(node, context, rels));
+			blocks.push(...readParagraphImages(node, rels, pkg));
+		} else if (node.tag === "w:tbl") blocks.push(readTable(node, context, rels, pkg));
 		else if (node.tag === "w:sdt") {
 			const sdtContent = require_typed_util.childrenWithTag(node, "w:sdtContent")[0];
-			if (sdtContent !== void 0) blocks.push(...readBodyBlocks(sdtContent.children, context, rels));
-		} else if (node.tag === "w:ins") blocks.push(...readBodyBlocks(node.children, context, rels));
+			if (sdtContent !== void 0) blocks.push(...readBodyBlocks(sdtContent.children, context, rels, pkg));
+		} else if (node.tag === "w:ins") blocks.push(...readBodyBlocks(node.children, context, rels, pkg));
 		else if (node.tag === "mc:AlternateContent") {
 			const target = require_typed_util.childrenWithTag(node, "mc:Fallback")[0] ?? require_typed_util.childrenWithTag(node, "mc:Choice")[0];
-			if (target !== void 0) blocks.push(...readBodyBlocks(target.children, context, rels));
+			if (target !== void 0) blocks.push(...readBodyBlocks(target.children, context, rels, pkg));
 		}
 	}
 	return blocks;
 }
-function readSections(body, context, rels) {
+function readSections(body, context, rels, pkg) {
 	const sections = [];
 	let currentBlocks = [];
 	for (const node of body.children) {
@@ -241,6 +339,7 @@ function readSections(body, context, rels) {
 			const sectPr = pPr === void 0 ? void 0 : require_typed_util.childrenWithTag(pPr, "w:sectPr")[0];
 			if (hasPageBreakBefore(node)) currentBlocks.push({ kind: "pageBreak" });
 			currentBlocks.push(readParagraph(node, context, rels));
+			currentBlocks.push(...readParagraphImages(node, rels, pkg));
 			if (sectPr !== void 0) {
 				sections.push({
 					pageSize: readPageSize(sectPr),
@@ -251,7 +350,7 @@ function readSections(body, context, rels) {
 			}
 			continue;
 		}
-		currentBlocks.push(...readBodyBlocks([node], context, rels));
+		currentBlocks.push(...readBodyBlocks([node], context, rels, pkg));
 	}
 	if (currentBlocks.length > 0 || sections.length === 0) sections.push({
 		pageSize: document_schema_js.PAGE_SIZE_LETTER,
@@ -318,11 +417,12 @@ function readDocx(pkg) {
 	};
 	return {
 		metadata: require_typed_shared_metadata.readCoreProperties(pkg),
-		sections: readSections(body, context, docRels),
+		sections: readSections(body, context, docRels, pkg),
 		comments: readComments(pkg),
 		footnotes: readFootnotes(pkg),
 		headers: readHeaderFooterText(pkg, "word/header"),
-		footers: readHeaderFooterText(pkg, "word/footer")
+		footers: readHeaderFooterText(pkg, "word/footer"),
+		numbering: require_typed_docx_numbering.readNumberingDefinitions(pkg)
 	};
 }
 //#endregion

package/dist/typed/docx/read.d.cts

@@ -45,6 +45,14 @@ declare const DocxDocumentSchema: z.ZodObject<{
   }, z.core.$strip>>;
   headers: z.ZodArray<z.ZodString>;
   footers: z.ZodArray<z.ZodString>;
+  numbering: z.ZodRecord<z.ZodString, z.ZodObject<{
+    levels: z.ZodRecord<z.ZodString, z.ZodObject<{
+      format: z.ZodString;
+      text: z.ZodString;
+      startAt: z.ZodNumber;
+      restart: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type DocxDocument = z.infer<typeof DocxDocumentSchema>;
 declare function readDocx(pkg: Package): DocxDocument;

package/dist/typed/docx/read.d.ts

@@ -45,6 +45,14 @@ declare const DocxDocumentSchema: z.ZodObject<{
   }, z.core.$strip>>;
   headers: z.ZodArray<z.ZodString>;
   footers: z.ZodArray<z.ZodString>;
+  numbering: z.ZodRecord<z.ZodString, z.ZodObject<{
+    levels: z.ZodRecord<z.ZodString, z.ZodObject<{
+      format: z.ZodString;
+      text: z.ZodString;
+      startAt: z.ZodNumber;
+      restart: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type DocxDocument = z.infer<typeof DocxDocumentSchema>;
 declare function readDocx(pkg: Package): DocxDocument;