ooxml.js 2.5.2 → 2.6.1

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
 
@@ -231,7 +231,8 @@ The package is layered from a lossless core outward to lossy convenience views:
 
 ## Gotchas and quirks
 
-- **`readDocx`/`readPptx` are richer than a flat text/shape dump, but still not a round-trip path — here is what's still not captured.** Not modelled: numbering *definitions* themselves (glyph, format, restart-at-level, from `word/numbering.xml`) — only each paragraph's own `numId`/`level` *membership* is captured, so a consumer can group paragraphs into a list but can't render the list's own markers without separately reading `word/numbering.xml`; table cell border styling (`w:tcBorders`, `a:tcPr` line properties — only cell shading/fill is read); docx's own `w:themeColor` run-colour references (real-world runs overwhelmingly use direct `w:val` hex instead); live `PAGE`/`NUMPAGES` field re-evaluation (fields resolve to Word's own cached result text, correct unless a different pagination would change the value); and docx inline/floating images (`w:drawing`) — `readPptx`'s picture-shape reading (`p:pic`) has no docx-side equivalent yet. On the pptx side specifically: connector shapes (`p:cxnSp`) are skipped entirely (decorative, no text); a shape's rotation is passed through from its own local `a:xfrm/@rot` rather than composed through a rotated or flipped parent group (ECMA-376's real composition rule there is one of DrawingML's more arcane corners); and non-table graphic frames (chart/SmartArt/OLE) come through with correct geometry but empty content.
+- **`readDocx`/`readPptx` are richer than a flat text/shape dump, but still not a round-trip path — here is what's still not captured.** `word/numbering.xml`'s own `abstractNum`/`num` level definitions (glyph, format, restart-at-level) are now modelled (`numbering.ts`'s `readNumberingDefinitions`, surfaced as `DocxDocument.numbering`, keyed by `w:numId`) alongside each paragraph's own `numId`/`level` *membership*, so a consumer can both group paragraphs into a list and render the list's own markers. Table cell border styling (`w:tcBorders`) is now read too, alongside cell shading/fill. docx's own `w:themeColor` run-colour references are now resolved against the theme's colour scheme (`w:themeShade`/`w:themeTint` refinement of an already-resolved theme colour is the one piece still not read). docx inline/floating images (`w:drawing`) are now read into `ContentImageBlock` — sniffed from the actual media-part bytes, placed in block flow at the point the drawing was encountered, though a floating image's own `wp:anchor` position (page/margin/paragraph-relative offset) is not recorded, since `ContentImageBlock` has no absolute-positioning field to hold it. Still not modelled: live `PAGE`/`NUMPAGES` field re-evaluation (fields resolve to Word's own cached result text, correct unless a different pagination would change the value). On the pptx side specifically: connector shapes (`p:cxnSp`) are skipped entirely (decorative, no text); a shape's rotation is now composed through every enclosing group's own rotation/flip (`composeShapeRotationDeg`, `typed/shared/drawingml.ts`), not merely passed through from its own local `a:xfrm/@rot`; and non-table graphic frames (chart/SmartArt/OLE) come through with correct geometry but empty content.
+- **xlsx has no native percentage/currency/date/time cell type — both directions of that gap are now closed.** Reading, `typed/xlsx/styles.ts` resolves a cell's style index to a number-format code and `typed/xlsx/number-format.ts` classifies it, so a plain numeric cell wearing the right `numFmt` reads as `ContentCellValue`'s `percentage`/`currency`/`date`/`time`/`dateTime` kind rather than a bare `number` (a currency only carries an ISO 4217 code when the format names one explicitly; a symbol-only format like `[$£-809]` leaves it absent rather than guessing). Writing, `buildXlsxPackage` emits real `numFmt` codes for the same five kinds (including LibreOffice's own `"TRUE";"TRUE";"FALSE"` boolean format, so Excel/Calc display `TRUE`/`FALSE` rather than a bare `1`/`0`), interned on demand into a real `<numFmts>`/`<cellXfs>` pair — every code the writer emits is fed back through the reader's own classifier in the test suite, so the two halves cannot drift. The classifier is not a formatter: `displayText` stays a plain typed-value spelling (`0.4256`, not `"42.56%"`), never the producer's own rendered string.
 - **`test:smoke` depends on a fresh build.** It runs `tsdown && vitest run --project smoke`, so it always rebuilds `dist/` first — don't run it expecting to test a stale build.
 - **`--project` matters for `test/smoke.test.mjs`.** `vitest.config.ts` defines `unit` and `smoke` as separate projects; `pnpm test`/`test:watch`/`test:smoke` always pass the right `--project` flag. A bare `vitest`/`vitest run` with no `--project` filter runs both projects, and `smoke` fails loudly (`Cannot find module '../dist/index.js'`) if `dist/` hasn't been built yet — a clear failure pointing at the cause, not a silent false pass, but still worth knowing if you invoke `vitest` directly instead of through the npm scripts.
 - **Binary-vs-XML part classification is a byte sniff, not an extension check.** `package-io/read.ts`'s `looksLikeXml` looks for a leading `<` after skipping a UTF-8 BOM and whitespace; this is deliberate (no standard OOXML binary part starts with `<`) but means any future binary format starting with `<` would misclassify.

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