ooxml-core 0.3.0 → 0.5.0

package/NOTICE

@@ -1,3 +1,5 @@
 ooxml-core contains modern OOXML modules extracted from ChristopherVR/docx-viewer and ChristopherVR/pptx-viewer, Copyright ChristopherVR, licensed under the Apache License, Version 2.0. The Apache License text is included in LICENSE. PROVENANCE.md records where each module came from.
 
 The pptx area also contains PowerPoint glyph-advance measurements (font-advance-widths*.generated.ts: numeric widths measured through COM automation; no font software is included). Third-party runtime dependencies are listed in THIRD-PARTY-LICENSES.
+
+The math area includes Apache-2.0 equation conversion modules extracted from ChristopherVR/pptx-viewer. Their source paths and modifications are recorded in PROVENANCE.md.

package/README.md

@@ -3,7 +3,7 @@
 # ooxml-core
 
 **Read, edit, validate and write Office Open XML documents in TypeScript.**
-One package, one XML model, every format: Word, PowerPoint and the shared building blocks beneath them. Spreadsheets, Visio and more are planned.
+One package, one XML model, every format: Word, PowerPoint, Excel and the shared building blocks beneath them. Visio and more are planned.
 
 [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 [![CI](https://github.com/ChristopherVR/ooxml/actions/workflows/ci.yml/badge.svg)](https://github.com/ChristopherVR/ooxml/actions/workflows/ci.yml)
@@ -28,24 +28,25 @@ One package, one XML model, every format: Word, PowerPoint and the shared buildi
 
 ## One package, many areas
 
-`ooxml-core` is a **single published package**. Every area is a subpath import, so you only load what you use, and the formats are symmetrical: `docx` and `pptx` are each imported through their own subpaths, and the root entry groups only the shared building blocks by namespace.
+`ooxml-core` is a **single published package**. Every area is a subpath import, so you only load what you use, and the formats are symmetrical: `docx`, `pptx` and `xlsx` are each imported through their own subpaths, and the root entry groups only the shared building blocks by namespace.
 
 ```ts
 import { parseXml } from 'ooxml-core/xml'; // one area
 import { xml, opc } from 'ooxml-core'; // or by namespace (shared building blocks)
 ```
 
-| Area       | What it is                                                                                                                                                                                                                                                          |
-| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `xml`      | The shared XML model: strict DOM parsing and serialization, namespaces, namespace-aware helpers.                                                                                                                                                                    |
-| `opc`      | Open Packaging Conventions: relationships, content types, part paths, zip helpers, safe hyperlinks.                                                                                                                                                                 |
-| `units`    | Branded EMU, twip and point types, constants and conversions.                                                                                                                                                                                                       |
-| `color`    | Hex, RGB, HSL and linear colour primitives, OOXML percent and angle parsing.                                                                                                                                                                                        |
-| `geometry` | DrawingML preset shapes, connection sites, clip paths, callouts and boolean shape operations.                                                                                                                                                                       |
-| `diagram`  | SmartArt (DiagramML), format-neutral: data model, layout/colour/quick-style parts, the cached `dsp:drawing` shape tree, relationship resolution and a loader. Used by `docx`; `pptx` re-imports its parsers.                                                        |
-| `collab`   | Format-neutral real-time collaboration on Yjs: session and provider lifecycle, awareness/presence, transport-neutral sync (WebSocket, in-memory, any byte channel), update codecs, ordering helpers, asset sync and the product adapter seam. See `docs/collab-area.md`. |
-| `docx`     | WordprocessingML: model, parser, preserving serializer, editing, validation. Also `/docx/embedded`. `/docx/layout` is the DOM-free pagination engine (an approximation of Word, not parity) and `/docx/load` detects and loads DOCX and legacy .doc (ole2 inlined). |
-| `pptx`     | PresentationML: model, parser, serializer, editing, charts, SmartArt, converters, CLI, signatures. Subpaths `/pptx/converter`, `/pptx/cli`, `/pptx/signature-node`.                                                                                                 |
+| Area       | What it is                                                                                                                                                                                                                                                                                                                                                                                                         |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `xml`      | The shared XML model: strict DOM parsing and serialization, namespaces, namespace-aware helpers.                                                                                                                                                                                                                                                                                                                   |
+| `opc`      | Open Packaging Conventions: relationships, content types, part paths, zip helpers, safe hyperlinks.                                                                                                                                                                                                                                                                                                                |
+| `units`    | Branded EMU, twip and point types, constants and conversions.                                                                                                                                                                                                                                                                                                                                                      |
+| `color`    | Hex, RGB, HSL and linear colour primitives, OOXML percent and angle parsing.                                                                                                                                                                                                                                                                                                                                       |
+| `geometry` | DrawingML preset shapes, connection sites, clip paths, callouts and boolean shape operations.                                                                                                                                                                                                                                                                                                                      |
+| `diagram`  | SmartArt (DiagramML), format-neutral: data model, layout/colour/quick-style parts, the cached `dsp:drawing` shape tree, relationship resolution and a loader. Used by `docx`; `pptx` re-imports its parsers.                                                                                                                                                                                                       |
+| `collab`   | Format-neutral real-time collaboration on Yjs: session and provider lifecycle, awareness/presence, transport-neutral sync (WebSocket, in-memory, any byte channel), update codecs, ordering helpers, asset sync and the product adapter seam. See `docs/collab-area.md`.                                                                                                                                           |
+| `docx`     | WordprocessingML: model, parser, preserving serializer, editing, validation. Also `/docx/embedded`. `/docx/layout` is the DOM-free pagination engine (an approximation of Word, not parity) and `/docx/load` detects and loads DOCX and legacy .doc (ole2 inlined).                                                                                                                                                |
+| `pptx`     | PresentationML: model, parser, serializer, editing, charts, SmartArt, converters, CLI, signatures. Subpaths `/pptx/converter`, `/pptx/cli`, `/pptx/signature-node`.                                                                                                                                                                                                                                                |
+| `xlsx`     | SpreadsheetML: workbook model, `.xlsx`/`.xlsm` reader and preserving writer, formula engine (dependency graph, dynamic arrays, 380+ functions), Excel number formats, editing commands with undo, and the DOM-free grid layout (sizes, colours, conditional formats, charts as SVG). `/xlsx/load` detects and loads `.xlsx`, `.xlsm`, legacy `.xls` (ole2 inlined) and CSV. An approximation of Excel, not parity. |
 
 Legacy binary formats (`.doc`, `.xls`, `.ppt`) and the compound-file container live in the sibling package [`ole2`](https://github.com/ChristopherVR/ole2); this package never contains binary codecs, and `ole2` never contains modern OOXML.
 
@@ -96,7 +97,7 @@ const part = resolvePartPath('word/document.xml', rels.get('rId5')!.target);
 The shared areas come first, then more formats on the same foundation:
 
 - **Shared layers:** DrawingML (fills, lines, effects, text, theme), charts, diagrams (SmartArt), maths, encryption primitives and schema-generated types, each as an area, written once for every format.
-- **More formats:** `xlsx` (SpreadsheetML), Visio (`.vsdx`, also an OPC package), and further Office Open XML parts as they are needed. Each arrives as its own area.
+- **More formats:** Visio (`.vsdx`, also an OPC package), and further Office Open XML parts as they are needed. Each arrives as its own area.
 - **One XML model:** the `pptx` area still uses its own XML object model and is compiled with relaxed TypeScript flags while it is migrated onto the shared `xml` area and tightened. New code is strict.
 - **Collaboration:** the Yjs and sync protocol that the viewers share will live here as a `collab` area.
 

package/dist/docx/embedded.cjs

@@ -1788,6 +1788,23 @@ function patchCellBorders(doc, tc, next, base) {
   orderChildren(props, CELL_ORDER);
   if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
 }
+function patchCellShading(doc, tc, next, base) {
+  if (next.shadingFill === base?.shadingFill && JSON.stringify(next.shadingThemeFill) === JSON.stringify(base?.shadingThemeFill))
+    return;
+  if (next.shadingFill && next.shadingFill !== "auto" && !/^#?[0-9a-f]{6}$/i.test(next.shadingFill))
+    throw new Error("Cell shading must be a six-digit RGB color or auto.");
+  let props = first2(tc, "tcPr");
+  if (!props) {
+    props = makeW(doc, "tcPr");
+    tc.insertBefore(props, tc.firstChild);
+  }
+  for (const old of children2(props, "shd")) props.removeChild(old);
+  const built = buildCellProperties(doc, next);
+  const replacement = built && first2(built, "shd");
+  if (replacement) props.appendChild(replacement);
+  orderChildren(props, CELL_ORDER);
+  if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
+}
 
 // src/docx/write-table.ts
 function canEditTableStructure(table) {
@@ -1836,8 +1853,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -1865,7 +1880,7 @@ function assertNoDescriptorEdits(table, base) {
       if (!source) continue;
       if (JSON.stringify(pick(cell, CELL_DESCRIPTOR_KEYS)) !== JSON.stringify(pick(source, CELL_DESCRIPTOR_KEYS)))
         throw new Error(
-          "Cannot edit table cell width, merge, vertical alignment, shading, or margins on an existing cell; only cell text and borders are supported. The original DOCX package remains unchanged."
+          "Cannot edit table cell width, merge, vertical alignment, or margins on an existing cell; only cell text, borders and shading are supported. The original DOCX package remains unchanged."
         );
     }
 }
@@ -1934,6 +1949,7 @@ function writeTable(doc, table, node, base, writeParagraph, replaceSlots2) {
         throw new Error("Moving paragraphs between table cells is not supported.");
       const tc = source?.cell ?? makeW(doc, "tc");
       patchCellBorders(doc, tc, cell.borders, source?.model.borders);
+      patchCellShading(doc, tc, cell, source?.model);
       const oldParagraphs = children2(tc, "p");
       const nextParagraphs = cell.paragraphs.map((paragraph) => {
         const index = source?.paragraphs.findIndex((p) => p.id === paragraph.id) ?? -1;
@@ -6553,14 +6569,14 @@ function parseCell(cell, parseParagraph3, id) {
   const vMerge = first2(props, "vMerge");
   if (vMerge) result.verticalMerge = getW(vMerge, "val") === "restart" ? "restart" : "continue";
   const tcW = first2(props, "tcW");
-  if (getW(tcW, "type") !== "nil") {
+  if ((getW(tcW, "type") ?? "dxa") === "dxa") {
     const width = dxa(getW(tcW, "w"));
     if (width !== void 0) result.widthTwips = width;
   }
   const vAlign = enumValue(isStVerticalJc, getW(first2(props, "vAlign"), "val"), "w:tcPr/w:vAlign");
   if (vAlign) result.verticalAlign = vAlign;
   const shd = first2(props, "shd");
-  const fill = parseShadingFill(shd);
+  const fill = parseShadingFill(shd) ?? (getW(shd, "fill") === "auto" && !getW(shd, "themeFill") ? "auto" : void 0);
   if (fill) result.shadingFill = fill;
   const themeFill = parseShadingThemeFill(shd);
   if (themeFill) result.shadingThemeFill = themeFill;
@@ -6629,7 +6645,8 @@ function parseTable(node, id, parseParagraph3) {
   }) : [];
   if (grid.length) table.grid = grid;
   const tblPr = first2(node, "tblPr");
-  const width = dxa(getW(first2(tblPr, "tblW"), "w"));
+  const tableWidth = first2(tblPr, "tblW");
+  const width = (getW(tableWidth, "type") ?? "dxa") === "dxa" ? dxa(getW(tableWidth, "w")) : void 0;
   if (width !== void 0) table.widthTwips = width;
   const justification = enumValue(isStJcTable, getW(first2(tblPr, "jc"), "val"), "w:tblPr/w:jc");
   if (justification) {

package/dist/docx/embedded.mjs

@@ -1782,6 +1782,23 @@ function patchCellBorders(doc, tc, next, base) {
   orderChildren(props, CELL_ORDER);
   if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
 }
+function patchCellShading(doc, tc, next, base) {
+  if (next.shadingFill === base?.shadingFill && JSON.stringify(next.shadingThemeFill) === JSON.stringify(base?.shadingThemeFill))
+    return;
+  if (next.shadingFill && next.shadingFill !== "auto" && !/^#?[0-9a-f]{6}$/i.test(next.shadingFill))
+    throw new Error("Cell shading must be a six-digit RGB color or auto.");
+  let props = first2(tc, "tcPr");
+  if (!props) {
+    props = makeW(doc, "tcPr");
+    tc.insertBefore(props, tc.firstChild);
+  }
+  for (const old of children2(props, "shd")) props.removeChild(old);
+  const built = buildCellProperties(doc, next);
+  const replacement = built && first2(built, "shd");
+  if (replacement) props.appendChild(replacement);
+  orderChildren(props, CELL_ORDER);
+  if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
+}
 
 // src/docx/write-table.ts
 function canEditTableStructure(table) {
@@ -1830,8 +1847,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -1859,7 +1874,7 @@ function assertNoDescriptorEdits(table, base) {
       if (!source) continue;
       if (JSON.stringify(pick(cell, CELL_DESCRIPTOR_KEYS)) !== JSON.stringify(pick(source, CELL_DESCRIPTOR_KEYS)))
         throw new Error(
-          "Cannot edit table cell width, merge, vertical alignment, shading, or margins on an existing cell; only cell text and borders are supported. The original DOCX package remains unchanged."
+          "Cannot edit table cell width, merge, vertical alignment, or margins on an existing cell; only cell text, borders and shading are supported. The original DOCX package remains unchanged."
         );
     }
 }
@@ -1928,6 +1943,7 @@ function writeTable(doc, table, node, base, writeParagraph, replaceSlots2) {
         throw new Error("Moving paragraphs between table cells is not supported.");
       const tc = source?.cell ?? makeW(doc, "tc");
       patchCellBorders(doc, tc, cell.borders, source?.model.borders);
+      patchCellShading(doc, tc, cell, source?.model);
       const oldParagraphs = children2(tc, "p");
       const nextParagraphs = cell.paragraphs.map((paragraph) => {
         const index = source?.paragraphs.findIndex((p) => p.id === paragraph.id) ?? -1;
@@ -6547,14 +6563,14 @@ function parseCell(cell, parseParagraph3, id) {
   const vMerge = first2(props, "vMerge");
   if (vMerge) result.verticalMerge = getW(vMerge, "val") === "restart" ? "restart" : "continue";
   const tcW = first2(props, "tcW");
-  if (getW(tcW, "type") !== "nil") {
+  if ((getW(tcW, "type") ?? "dxa") === "dxa") {
     const width = dxa(getW(tcW, "w"));
     if (width !== void 0) result.widthTwips = width;
   }
   const vAlign = enumValue(isStVerticalJc, getW(first2(props, "vAlign"), "val"), "w:tcPr/w:vAlign");
   if (vAlign) result.verticalAlign = vAlign;
   const shd = first2(props, "shd");
-  const fill = parseShadingFill(shd);
+  const fill = parseShadingFill(shd) ?? (getW(shd, "fill") === "auto" && !getW(shd, "themeFill") ? "auto" : void 0);
   if (fill) result.shadingFill = fill;
   const themeFill = parseShadingThemeFill(shd);
   if (themeFill) result.shadingThemeFill = themeFill;
@@ -6623,7 +6639,8 @@ function parseTable(node, id, parseParagraph3) {
   }) : [];
   if (grid.length) table.grid = grid;
   const tblPr = first2(node, "tblPr");
-  const width = dxa(getW(first2(tblPr, "tblW"), "w"));
+  const tableWidth = first2(tblPr, "tblW");
+  const width = (getW(tableWidth, "type") ?? "dxa") === "dxa" ? dxa(getW(tableWidth, "w")) : void 0;
   if (width !== void 0) table.widthTwips = width;
   const justification = enumValue(isStJcTable, getW(first2(tblPr, "jc"), "val"), "w:tblPr/w:jc");
   if (justification) {

package/dist/docx/index.cjs

@@ -2433,6 +2433,23 @@ function patchCellBorders(doc, tc, next, base) {
   orderChildren(props, CELL_ORDER);
   if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
 }
+function patchCellShading(doc, tc, next, base) {
+  if (next.shadingFill === base?.shadingFill && JSON.stringify(next.shadingThemeFill) === JSON.stringify(base?.shadingThemeFill))
+    return;
+  if (next.shadingFill && next.shadingFill !== "auto" && !/^#?[0-9a-f]{6}$/i.test(next.shadingFill))
+    throw new Error("Cell shading must be a six-digit RGB color or auto.");
+  let props = first2(tc, "tcPr");
+  if (!props) {
+    props = makeW(doc, "tcPr");
+    tc.insertBefore(props, tc.firstChild);
+  }
+  for (const old of children2(props, "shd")) props.removeChild(old);
+  const built = buildCellProperties(doc, next);
+  const replacement = built && first2(built, "shd");
+  if (replacement) props.appendChild(replacement);
+  orderChildren(props, CELL_ORDER);
+  if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
+}
 
 // src/docx/write-table.ts
 function canEditTableStructure(table) {
@@ -2481,8 +2498,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -2510,7 +2525,7 @@ function assertNoDescriptorEdits(table, base) {
       if (!source) continue;
       if (JSON.stringify(pick(cell, CELL_DESCRIPTOR_KEYS)) !== JSON.stringify(pick(source, CELL_DESCRIPTOR_KEYS)))
         throw new Error(
-          "Cannot edit table cell width, merge, vertical alignment, shading, or margins on an existing cell; only cell text and borders are supported. The original DOCX package remains unchanged."
+          "Cannot edit table cell width, merge, vertical alignment, or margins on an existing cell; only cell text, borders and shading are supported. The original DOCX package remains unchanged."
         );
     }
 }
@@ -2579,6 +2594,7 @@ function writeTable(doc, table, node, base, writeParagraph, replaceSlots2) {
         throw new Error("Moving paragraphs between table cells is not supported.");
       const tc = source?.cell ?? makeW(doc, "tc");
       patchCellBorders(doc, tc, cell.borders, source?.model.borders);
+      patchCellShading(doc, tc, cell, source?.model);
       const oldParagraphs = children2(tc, "p");
       const nextParagraphs = cell.paragraphs.map((paragraph) => {
         const index = source?.paragraphs.findIndex((p) => p.id === paragraph.id) ?? -1;
@@ -7442,14 +7458,14 @@ function parseCell(cell, parseParagraph3, id) {
   const vMerge = first2(props, "vMerge");
   if (vMerge) result.verticalMerge = getW(vMerge, "val") === "restart" ? "restart" : "continue";
   const tcW = first2(props, "tcW");
-  if (getW(tcW, "type") !== "nil") {
+  if ((getW(tcW, "type") ?? "dxa") === "dxa") {
     const width = dxa(getW(tcW, "w"));
     if (width !== void 0) result.widthTwips = width;
   }
   const vAlign = enumValue(isStVerticalJc, getW(first2(props, "vAlign"), "val"), "w:tcPr/w:vAlign");
   if (vAlign) result.verticalAlign = vAlign;
   const shd = first2(props, "shd");
-  const fill = parseShadingFill(shd);
+  const fill = parseShadingFill(shd) ?? (getW(shd, "fill") === "auto" && !getW(shd, "themeFill") ? "auto" : void 0);
   if (fill) result.shadingFill = fill;
   const themeFill = parseShadingThemeFill(shd);
   if (themeFill) result.shadingThemeFill = themeFill;
@@ -7518,7 +7534,8 @@ function parseTable(node, id, parseParagraph3) {
   }) : [];
   if (grid.length) table.grid = grid;
   const tblPr = first2(node, "tblPr");
-  const width = dxa(getW(first2(tblPr, "tblW"), "w"));
+  const tableWidth = first2(tblPr, "tblW");
+  const width = (getW(tableWidth, "type") ?? "dxa") === "dxa" ? dxa(getW(tableWidth, "w")) : void 0;
   if (width !== void 0) table.widthTwips = width;
   const justification = enumValue(isStJcTable, getW(first2(tblPr, "jc"), "val"), "w:tblPr/w:jc");
   if (justification) {

package/dist/docx/index.mjs

@@ -2427,6 +2427,23 @@ function patchCellBorders(doc, tc, next, base) {
   orderChildren(props, CELL_ORDER);
   if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
 }
+function patchCellShading(doc, tc, next, base) {
+  if (next.shadingFill === base?.shadingFill && JSON.stringify(next.shadingThemeFill) === JSON.stringify(base?.shadingThemeFill))
+    return;
+  if (next.shadingFill && next.shadingFill !== "auto" && !/^#?[0-9a-f]{6}$/i.test(next.shadingFill))
+    throw new Error("Cell shading must be a six-digit RGB color or auto.");
+  let props = first2(tc, "tcPr");
+  if (!props) {
+    props = makeW(doc, "tcPr");
+    tc.insertBefore(props, tc.firstChild);
+  }
+  for (const old of children2(props, "shd")) props.removeChild(old);
+  const built = buildCellProperties(doc, next);
+  const replacement = built && first2(built, "shd");
+  if (replacement) props.appendChild(replacement);
+  orderChildren(props, CELL_ORDER);
+  if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
+}
 
 // src/docx/write-table.ts
 function canEditTableStructure(table) {
@@ -2475,8 +2492,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -2504,7 +2519,7 @@ function assertNoDescriptorEdits(table, base) {
       if (!source) continue;
       if (JSON.stringify(pick(cell, CELL_DESCRIPTOR_KEYS)) !== JSON.stringify(pick(source, CELL_DESCRIPTOR_KEYS)))
         throw new Error(
-          "Cannot edit table cell width, merge, vertical alignment, shading, or margins on an existing cell; only cell text and borders are supported. The original DOCX package remains unchanged."
+          "Cannot edit table cell width, merge, vertical alignment, or margins on an existing cell; only cell text, borders and shading are supported. The original DOCX package remains unchanged."
         );
     }
 }
@@ -2573,6 +2588,7 @@ function writeTable(doc, table, node, base, writeParagraph, replaceSlots2) {
         throw new Error("Moving paragraphs between table cells is not supported.");
       const tc = source?.cell ?? makeW(doc, "tc");
       patchCellBorders(doc, tc, cell.borders, source?.model.borders);
+      patchCellShading(doc, tc, cell, source?.model);
       const oldParagraphs = children2(tc, "p");
       const nextParagraphs = cell.paragraphs.map((paragraph) => {
         const index = source?.paragraphs.findIndex((p) => p.id === paragraph.id) ?? -1;
@@ -7436,14 +7452,14 @@ function parseCell(cell, parseParagraph3, id) {
   const vMerge = first2(props, "vMerge");
   if (vMerge) result.verticalMerge = getW(vMerge, "val") === "restart" ? "restart" : "continue";
   const tcW = first2(props, "tcW");
-  if (getW(tcW, "type") !== "nil") {
+  if ((getW(tcW, "type") ?? "dxa") === "dxa") {
     const width = dxa(getW(tcW, "w"));
     if (width !== void 0) result.widthTwips = width;
   }
   const vAlign = enumValue(isStVerticalJc, getW(first2(props, "vAlign"), "val"), "w:tcPr/w:vAlign");
   if (vAlign) result.verticalAlign = vAlign;
   const shd = first2(props, "shd");
-  const fill = parseShadingFill(shd);
+  const fill = parseShadingFill(shd) ?? (getW(shd, "fill") === "auto" && !getW(shd, "themeFill") ? "auto" : void 0);
   if (fill) result.shadingFill = fill;
   const themeFill = parseShadingThemeFill(shd);
   if (themeFill) result.shadingThemeFill = themeFill;
@@ -7512,7 +7528,8 @@ function parseTable(node, id, parseParagraph3) {
   }) : [];
   if (grid.length) table.grid = grid;
   const tblPr = first2(node, "tblPr");
-  const width = dxa(getW(first2(tblPr, "tblW"), "w"));
+  const tableWidth = first2(tblPr, "tblW");
+  const width = (getW(tableWidth, "type") ?? "dxa") === "dxa" ? dxa(getW(tableWidth, "w")) : void 0;
   if (width !== void 0) table.widthTwips = width;
   const justification = enumValue(isStJcTable, getW(first2(tblPr, "jc"), "val"), "w:tblPr/w:jc");
   if (justification) {

package/dist/docx/load/index.cjs

@@ -1034,6 +1034,23 @@ function patchCellBorders(doc, tc, next, base) {
   orderChildren(props, CELL_ORDER);
   if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
 }
+function patchCellShading(doc, tc, next, base) {
+  if (next.shadingFill === base?.shadingFill && JSON.stringify(next.shadingThemeFill) === JSON.stringify(base?.shadingThemeFill))
+    return;
+  if (next.shadingFill && next.shadingFill !== "auto" && !/^#?[0-9a-f]{6}$/i.test(next.shadingFill))
+    throw new Error("Cell shading must be a six-digit RGB color or auto.");
+  let props = first2(tc, "tcPr");
+  if (!props) {
+    props = makeW(doc, "tcPr");
+    tc.insertBefore(props, tc.firstChild);
+  }
+  for (const old of children2(props, "shd")) props.removeChild(old);
+  const built = buildCellProperties(doc, next);
+  const replacement = built && first2(built, "shd");
+  if (replacement) props.appendChild(replacement);
+  orderChildren(props, CELL_ORDER);
+  if (!Array.from(props.childNodes).some((node) => node.nodeType === 1)) tc.removeChild(props);
+}
 
 // src/docx/write-table.ts
 function canEditTableStructure(table) {
@@ -1082,8 +1099,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -1111,7 +1126,7 @@ function assertNoDescriptorEdits(table, base) {
       if (!source) continue;
       if (JSON.stringify(pick(cell, CELL_DESCRIPTOR_KEYS)) !== JSON.stringify(pick(source, CELL_DESCRIPTOR_KEYS)))
         throw new Error(
-          "Cannot edit table cell width, merge, vertical alignment, shading, or margins on an existing cell; only cell text and borders are supported. The original DOCX package remains unchanged."
+          "Cannot edit table cell width, merge, vertical alignment, or margins on an existing cell; only cell text, borders and shading are supported. The original DOCX package remains unchanged."
         );
     }
 }
@@ -1180,6 +1195,7 @@ function writeTable(doc, table, node, base, writeParagraph, replaceSlots2) {
         throw new Error("Moving paragraphs between table cells is not supported.");
       const tc = source?.cell ?? makeW(doc, "tc");
       patchCellBorders(doc, tc, cell.borders, source?.model.borders);
+      patchCellShading(doc, tc, cell, source?.model);
       const oldParagraphs = children2(tc, "p");
       const nextParagraphs = cell.paragraphs.map((paragraph) => {
         const index = source?.paragraphs.findIndex((p) => p.id === paragraph.id) ?? -1;
@@ -6464,14 +6480,14 @@ function parseCell(cell, parseParagraph3, id) {
   const vMerge = first2(props, "vMerge");
   if (vMerge) result.verticalMerge = getW(vMerge, "val") === "restart" ? "restart" : "continue";
   const tcW = first2(props, "tcW");
-  if (getW(tcW, "type") !== "nil") {
+  if ((getW(tcW, "type") ?? "dxa") === "dxa") {
     const width = dxa(getW(tcW, "w"));
     if (width !== void 0) result.widthTwips = width;
   }
   const vAlign = enumValue(isStVerticalJc, getW(first2(props, "vAlign"), "val"), "w:tcPr/w:vAlign");
   if (vAlign) result.verticalAlign = vAlign;
   const shd = first2(props, "shd");
-  const fill = parseShadingFill(shd);
+  const fill = parseShadingFill(shd) ?? (getW(shd, "fill") === "auto" && !getW(shd, "themeFill") ? "auto" : void 0);
   if (fill) result.shadingFill = fill;
   const themeFill = parseShadingThemeFill(shd);
   if (themeFill) result.shadingThemeFill = themeFill;
@@ -6540,7 +6556,8 @@ function parseTable(node, id, parseParagraph3) {
   }) : [];
   if (grid.length) table.grid = grid;
   const tblPr = first2(node, "tblPr");
-  const width = dxa(getW(first2(tblPr, "tblW"), "w"));
+  const tableWidth = first2(tblPr, "tblW");
+  const width = (getW(tableWidth, "type") ?? "dxa") === "dxa" ? dxa(getW(tableWidth, "w")) : void 0;
   if (width !== void 0) table.widthTwips = width;
   const justification = enumValue(isStJcTable, getW(first2(tblPr, "jc"), "val"), "w:tblPr/w:jc");
   if (justification) {
@@ -7634,7 +7651,7 @@ function createDocument() {
   };
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-fib.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-fib.js
 var FC_LCB_INDEX = {
   plcfbteChpx: 12,
   plcfbtePapx: 13,
@@ -7703,7 +7720,7 @@ function patchDocFib(wordDoc, fib, patch) {
   view.setUint32(papxOff + 4, patch.plcfbtePapx.lcb, true);
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole2-parser-types.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole2-parser-types.js
 var OLE_MAGIC = new Uint8Array([208, 207, 17, 224, 161, 177, 26, 225]);
 var ENDOFCHAIN = 4294967294;
 var FREESECT = 4294967295;
@@ -7721,7 +7738,7 @@ var Ole2ParseError = class extends Error {
   }
 };
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole2-parser-read.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole2-parser-read.js
 function parseOle2(buffer) {
   const data = new Uint8Array(buffer);
   const view = new DataView(buffer);
@@ -7899,7 +7916,7 @@ function parseOle2(buffer) {
   return { entries, getStream };
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole2-parser-write-helpers.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole2-parser-write-helpers.js
 function compareDirEntryNames(a, b) {
   if (a.length !== b.length) {
     return a.length - b.length;
@@ -7945,7 +7962,7 @@ function writeInt32Sectors(outBytes, int32Data, firstSector, numSectors, sectorS
   }
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole2-parser-write-serialize.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole2-parser-write-serialize.js
 function writeHeader(outView, outBytes, params) {
   outBytes.set(OLE_MAGIC, 0);
   outView.setUint16(24, 62, true);
@@ -8037,7 +8054,7 @@ function writeStreamSectors(outBytes, streamData, chain, sectorSize) {
   }
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole2-parser-write.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole2-parser-write.js
 function buildOle2(streams, rootClsid, miniStreamCutoff = 4096) {
   const sectorSize = 512;
   const miniSectorSize = 64;
@@ -8203,7 +8220,7 @@ function buildOle2(streams, rootClsid, miniStreamCutoff = 4096) {
   return output;
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-cfb.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-cfb.js
 function unwrapDocBytes(bytes) {
   if (bytes.length < 8 || bytes[0] !== 208 || bytes[1] !== 207 || bytes[2] !== 17 || bytes[3] !== 224 || bytes[4] !== 161 || bytes[5] !== 177 || bytes[6] !== 26 || bytes[7] !== 225) {
     return void 0;
@@ -8244,7 +8261,7 @@ function unwrapDocBytes(bytes) {
   }
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-fkp.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-fkp.js
 var PAGE_SIZE = 512;
 function parseBteTable(tableStream, at) {
   const view = new DataView(tableStream.buffer, tableStream.byteOffset, tableStream.byteLength);
@@ -8352,7 +8369,7 @@ function buildSingleRunChpxPage(fcStart, fcEnd, blob) {
   return page;
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-cp1252.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-cp1252.js
 var CP1252_HIGH_BLOCK = [
   8364,
   129,
@@ -8420,7 +8437,7 @@ function encodeCp1252(text) {
   return Uint8Array.from(bytes);
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-pieces.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-pieces.js
 var CLXT_PRC = 1;
 var CLXT_PCDT = 2;
 function parsePieceTable(tableStream, clx) {
@@ -8582,7 +8599,7 @@ function buildClxBytes(pieces) {
   return bytes;
 }
 
-// node_modules/.bun/@christophervr+ole2@0.3.0/node_modules/@christophervr/ole2/dist/ole-document-doc-editor.js
+// node_modules/.bun/@christophervr+ole2@0.4.0/node_modules/@christophervr/ole2/dist/ole-document-doc-editor.js
 var RISKY_PLCF_INDICES = [3, 4, 5, 16, 17, 18, 19, 20];
 var RISKY_STTB_INDICES = [21, 22, 23];
 function hasUnsupportedFeatures(wordDoc, fib) {