ooxml-core 0.4.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/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) {

package/dist/docx/load/index.mjs

@@ -1028,6 +1028,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) {
@@ -1076,8 +1093,6 @@ var CELL_DESCRIPTOR_KEYS = [
   "verticalMerge",
   "widthTwips",
   "verticalAlign",
-  "shadingFill",
-  "shadingThemeFill",
   "margins"
 ];
 function pick(source, keys) {
@@ -1105,7 +1120,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."
         );
     }
 }
@@ -1174,6 +1189,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;
@@ -6458,14 +6474,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;
@@ -6534,7 +6550,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/parse-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-table.d.ts","sourceRoot":"","sources":["../../src/docx/parse-table.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAyB,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAgH3E,8FAA8F;AAC9F,wBAAgB,UAAU,CACzB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,GACtD,KAAK,CA4CP"}
+{"version":3,"file":"parse-table.d.ts","sourceRoot":"","sources":["../../src/docx/parse-table.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAyB,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAkH3E,8FAA8F;AAC9F,wBAAgB,UAAU,CACzB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,GACtD,KAAK,CA8CP"}

package/dist/docx/write-table-properties.d.ts

@@ -1,4 +1,4 @@
-import type { Table } from './model.js';
+import type { Table, TableCell } from './model.js';
 import type { TableBorders, TableRowProperties } from './table-model.js';
 import { type XmlDocument, type XmlElement } from './xml.js';
 /** Changes only modeled row fields, preserving unmodeled trPr children and attributes. */
@@ -10,4 +10,6 @@ export declare function patchTableMargins(doc: XmlDocument, table: Table, node:
  * (width, shading, margins, extensions) and untouched sides exactly as they were.
  */
 export declare function patchCellBorders(doc: XmlDocument, tc: XmlElement, next: TableBorders | undefined, base: TableBorders | undefined): void;
+/** Replaces only changed cell shading, preserving widths, borders, margins and extension XML. */
+export declare function patchCellShading(doc: XmlDocument, tc: XmlElement, next: TableCell, base?: TableCell): void;
 //# sourceMappingURL=write-table-properties.d.ts.map

package/dist/docx/write-table-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-table-properties.d.ts","sourceRoot":"","sources":["../../src/docx/write-table-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIzE,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAwCrF,0FAA0F;AAC1F,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAClC,IAAI,CAmBN;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,KAAK,GACV,IAAI,CAqBN;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC5B,IAAI,CA0BN"}
+{"version":3,"file":"write-table-properties.d.ts","sourceRoot":"","sources":["../../src/docx/write-table-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIzE,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAwCrF,0FAA0F;AAC1F,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAClC,IAAI,CAmBN;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,KAAK,GACV,IAAI,CAqBN;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC5B,IAAI,CA0BN;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAmBN"}

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

@@ -1 +1 @@
-{"version":3,"file":"write-table.d.ts","sourceRoot":"","sources":["../../src/docx/write-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAa,MAAM,YAAY,CAAC;AAM9D,OAAO,EAMN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,KAAK,eAAe,GAAG,CACtB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,SAAS,KACZ,UAAU,CAAC;AAChB,KAAK,WAAW,GAAG,CAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,UAAU,EAAE,EACjB,IAAI,EAAE,UAAU,EAAE,KACd,IAAI,CAAC;AAEV,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAiChE;AAgED,wBAAgB,UAAU,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,cAAc,EAAE,eAAe,EAC/B,YAAY,EAAE,WAAW,GACvB,UAAU,CAqHZ"}
+{"version":3,"file":"write-table.d.ts","sourceRoot":"","sources":["../../src/docx/write-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAa,MAAM,YAAY,CAAC;AAO9D,OAAO,EAMN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,KAAK,eAAe,GAAG,CACtB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,SAAS,KACZ,UAAU,CAAC;AAChB,KAAK,WAAW,GAAG,CAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,UAAU,EAAE,EACjB,IAAI,EAAE,UAAU,EAAE,KACd,IAAI,CAAC;AAEV,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAiChE;AA8DD,wBAAgB,UAAU,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,cAAc,EAAE,eAAe,EAC/B,YAAY,EAAE,WAAW,GACvB,UAAU,CAsHZ"}