ooxml-core 1.0.0 → 1.1.0

package/dist/docx/embedded.mjs

@@ -867,9 +867,101 @@ function isValidLanguageTag(value) {
   return /^(?:[A-Za-z]{2,8})(?:-[A-Za-z0-9]{1,8})*$/.test(value);
 }
 
-// docx/theme.ts
-var DRAWING_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
-var SCHEME_ORDER = [
+// color/color-primitives.ts
+function toHex(value) {
+  return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase();
+}
+
+// drawingml/dom.ts
+function attributeReader(element) {
+  return (name) => {
+    if (!element) return void 0;
+    const direct = element.getAttribute(name);
+    if (direct !== null) return direct;
+    const attributes = element.attributes;
+    for (let index = 0; index < attributes.length; index++) {
+      const candidate = attributes.item(index);
+      if (candidate && candidate.localName === name) return candidate.value;
+    }
+    return void 0;
+  };
+}
+function stringAttribute(element, name) {
+  const value = attributeReader(element)(name)?.trim();
+  return value ? value : void 0;
+}
+function integerAttribute(element, name) {
+  const parsed = Number.parseInt(attributeReader(element)(name) ?? "", 10);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function booleanAttribute(element, name) {
+  const value = attributeReader(element)(name)?.trim().toLowerCase();
+  if (value === "1" || value === "true") return true;
+  if (value === "0" || value === "false") return false;
+  return void 0;
+}
+function descendants(root, local) {
+  const result = [];
+  const visit = (node) => {
+    for (const child3 of Array.from(node.childNodes)) {
+      if (!isElement(child3)) continue;
+      if (child3.localName === local) result.push(child3);
+      visit(child3);
+    }
+  };
+  visit(root);
+  return result;
+}
+
+// drawingml/drawing-color.ts
+var COLOR_ELEMENTS = {
+  srgbClr: "srgb",
+  schemeClr: "scheme",
+  sysClr: "system",
+  prstClr: "preset",
+  scrgbClr: "scrgb",
+  hslClr: "hsl"
+};
+function colorValue(kind, element) {
+  const attribute = (name) => element.getAttribute(name) ?? "";
+  if (kind === "scrgb") return `${attribute("r")},${attribute("g")},${attribute("b")}`;
+  if (kind === "hsl") return `${attribute("hue")},${attribute("sat")},${attribute("lum")}`;
+  return attribute("val");
+}
+function parseDrawingColorIn(container) {
+  if (!container) return void 0;
+  for (const element of elements(container)) {
+    const kind = COLOR_ELEMENTS[element.localName];
+    if (!kind || element.namespaceURI && element.namespaceURI !== NS.a) continue;
+    return parseDrawingColor(element);
+  }
+  return void 0;
+}
+function parseDrawingColor(element) {
+  const kind = COLOR_ELEMENTS[element.localName];
+  if (!kind) return void 0;
+  const color = {
+    kind,
+    value: colorValue(kind, element),
+    transforms: elements(element).map((child3) => ({
+      name: child3.localName,
+      value: child3.getAttribute("val") ?? ""
+    }))
+  };
+  const fallback = kind === "system" ? element.getAttribute("lastClr") : null;
+  if (fallback) color.fallback = fallback;
+  return color;
+}
+function parseDrawingColorList(container) {
+  if (!container) return [];
+  return elements(container).flatMap((element) => {
+    const color = parseDrawingColor(element);
+    return color ? [color] : [];
+  });
+}
+
+// drawingml/theme-model.ts
+var THEME_COLOR_SLOTS = [
   "dk1",
   "lt1",
   "dk2",
@@ -883,46 +975,89 @@ var SCHEME_ORDER = [
   "hlink",
   "folHlink"
 ];
-function drawingChild(parent, local) {
-  if (!parent) return void 0;
-  for (const node of Array.from(parent.childNodes)) {
-    const element = node;
-    if (element.nodeType === 1 && element.localName === local && element.namespaceURI === DRAWING_NS)
-      return element;
+
+// drawingml/theme.ts
+new Set(THEME_COLOR_SLOTS);
+function nonEmpty(value) {
+  return value ? value : void 0;
+}
+function parseThemeColorScheme(scheme) {
+  const result = { colors: {} };
+  if (!scheme) return result;
+  const name = nonEmpty(scheme.getAttribute("name"));
+  if (name) result.name = name;
+  for (const slot2 of THEME_COLOR_SLOTS) {
+    const color = parseDrawingColorIn(first(scheme, slot2, NS.a));
+    if (color) result.colors[slot2] = color;
   }
-  return void 0;
+  return result;
 }
-function colorOf(slot2) {
-  const srgb = drawingChild(slot2, "srgbClr");
-  if (srgb) return srgb.getAttribute("val")?.toUpperCase() || void 0;
-  const sys = drawingChild(slot2, "sysClr");
-  if (sys) return sys.getAttribute("lastClr")?.toUpperCase() || void 0;
-  return void 0;
+function parseFontCollection(collection) {
+  const result = { scripts: {} };
+  if (!collection) return result;
+  const typeface = (local) => nonEmpty(first(collection, local, NS.a)?.getAttribute("typeface"));
+  const latin = typeface("latin");
+  const eastAsia = typeface("ea");
+  const complexScript = typeface("cs");
+  if (latin) result.latin = latin;
+  if (eastAsia) result.eastAsia = eastAsia;
+  if (complexScript) result.complexScript = complexScript;
+  for (const font of elements(collection)) {
+    if (font.localName !== "font") continue;
+    const script = nonEmpty(font.getAttribute("script"));
+    const face = nonEmpty(font.getAttribute("typeface"));
+    if (script && face && !Object.hasOwn(result.scripts, script)) result.scripts[script] = face;
+  }
+  return result;
 }
-function fontSetOf(element) {
-  if (!element) return {};
-  const latin = drawingChild(element, "latin")?.getAttribute("typeface") || void 0;
-  const ea = drawingChild(element, "ea")?.getAttribute("typeface") || void 0;
-  const cs = drawingChild(element, "cs")?.getAttribute("typeface") || void 0;
+function parseThemeFontScheme(scheme) {
+  const result = {
+    major: parseFontCollection(first(scheme, "majorFont", NS.a)),
+    minor: parseFontCollection(first(scheme, "minorFont", NS.a))
+  };
+  const name = nonEmpty(scheme?.getAttribute("name"));
+  if (name) result.name = name;
+  return result;
+}
+function rootOf(source) {
+  return "documentElement" in source ? source.documentElement : source;
+}
+function parseTheme(source) {
+  const root = rootOf(source);
+  const holder = first(root, "themeElements", NS.a) ?? root;
+  const theme = {
+    colorScheme: parseThemeColorScheme(first(holder, "clrScheme", NS.a)),
+    fontScheme: parseThemeFontScheme(first(holder, "fontScheme", NS.a))
+  };
+  const name = nonEmpty(root.getAttribute("name"));
+  if (name) theme.name = name;
+  return theme;
+}
+
+// drawingml/theme-color.ts
+function themeSlotHex(color) {
+  if (!color) return void 0;
+  const value = color.kind === "srgb" ? color.value : color.kind === "system" ? color.fallback : void 0;
+  return value ? value.toUpperCase() : void 0;
+}
+
+// docx/theme.ts
+function fontSetOf(collection) {
+  const { latin, eastAsia, complexScript } = collection;
   return {
     ...latin ? { latin } : {},
-    ...ea ? { eastAsia: ea } : {},
-    ...cs ? { complexScript: cs } : {}
+    ...eastAsia ? { eastAsia } : {},
+    ...complexScript ? { complexScript } : {}
   };
 }
-function parseTheme(xml) {
-  const document = parseXml2(xml);
-  const root = document.documentElement;
-  const clrScheme = Array.from(root.getElementsByTagNameNS(DRAWING_NS, "clrScheme"))[0];
+function parseTheme2(xml) {
+  const theme = parseTheme(parseXml2(xml));
   const colors = {};
-  for (const slotName of SCHEME_ORDER) {
-    const slot2 = drawingChild(clrScheme, slotName);
-    const value = colorOf(slot2);
-    if (value) colors[slotName] = value;
-  }
-  const fontScheme = Array.from(root.getElementsByTagNameNS(DRAWING_NS, "fontScheme"))[0];
-  const major = drawingChild(fontScheme, "majorFont");
-  const minor = drawingChild(fontScheme, "minorFont");
+  for (const slot2 of THEME_COLOR_SLOTS) {
+    const value = themeSlotHex(theme.colorScheme.colors[slot2]);
+    if (value) colors[slot2] = value;
+  }
+  const { major, minor } = theme.fontScheme;
   return { colors, colorMapping: {}, fonts: { major: fontSetOf(major), minor: fontSetOf(minor) } };
 }
 var MAPPING_KEYS = ["bg1", "tx1", "bg2", "tx2"];
@@ -960,9 +1095,6 @@ function parseColorSchemeMapping(xml) {
 function isThemeColorToken(value) {
   return isStThemeColor(value);
 }
-function toHex(value) {
-  return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase();
-}
 function fractionToThemeByte(fraction) {
   return toHex(Math.round(Math.min(1, Math.max(0, fraction)) * 255));
 }
@@ -2998,7 +3130,7 @@ var NAMED = {
 var POINT_TO_PX = 96 / 72;
 var WATERMARK_PREFIX = "PowerPlusWaterMarkObject";
 var DEFAULT_WATERMARK_COLOR = "#c0c0c0";
-function colorOf2(value) {
+function colorOf(value) {
   const text = (value ?? "").trim().toLowerCase().split(/\s/)[0] ?? "";
   if (NAMED[text]) return NAMED[text];
   const hex = /^#?([0-9a-f]{6})$/.exec(text);
@@ -3019,7 +3151,7 @@ function parseWatermarkShape(shape) {
   const rotation = /rotation:\s*(-?[\d.]+)/i.exec(style);
   const spec = {
     text: path.getAttribute("string") ?? "",
-    color: colorOf2(shape.getAttribute("fillcolor")),
+    color: colorOf(shape.getAttribute("fillcolor")),
     semitransparent: opacity !== null && opacity !== "" && opacity !== "1",
     layout: rotation && Math.abs(Number(rotation[1]) % 360) > 1 ? "diagonal" : "horizontal",
     ...family ? { fontFamily: family.trim() } : {}
@@ -3131,7 +3263,7 @@ var add = (parent, ...items) => {
   return parent;
 };
 var emu = (px2) => String(Math.max(1, Math.round(px2 * EMU_PER_PIXEL)));
-var descendants = (root, ns, local) => Array.from(root.getElementsByTagNameNS(ns, local));
+var descendants2 = (root, ns, local) => Array.from(root.getElementsByTagNameNS(ns, local));
 function paragraphsFor(doc, lines) {
   return (lines.length ? lines : [""]).map((line) => {
     const paragraph = makeW(doc, "p");
@@ -3223,23 +3355,23 @@ function buildTextBoxDrawing(doc, image, docPrId) {
 }
 function isSimpleTextBox(graphicData, anchored) {
   if (!graphicData || anchored) return false;
-  const content = descendants(graphicData, W_NS, "txbxContent")[0];
+  const content = descendants2(graphicData, W_NS, "txbxContent")[0];
   if (!content) return false;
   const plain = (node, allowed) => Array.from(node.childNodes).filter(isElement).every((child3) => child3.namespaceURI === W_NS && allowed.includes(child3.localName));
-  return plain(content, ["p"]) && descendants(content, W_NS, "p").every(
-    (paragraph) => plain(paragraph, ["r"]) && descendants(paragraph, W_NS, "r").every((run) => plain(run, ["t"]))
+  return plain(content, ["p"]) && descendants2(content, W_NS, "p").every(
+    (paragraph) => plain(paragraph, ["r"]) && descendants2(paragraph, W_NS, "r").every((run) => plain(run, ["t"]))
   );
 }
 function textBoxHasBorder(graphicData) {
-  const spPr = graphicData && descendants(graphicData, WPS_NS, "spPr")[0];
+  const spPr = graphicData && descendants2(graphicData, WPS_NS, "spPr")[0];
   const ln = spPr && Array.from(spPr.getElementsByTagNameNS(A_NS, "ln"))[0];
   return Boolean(ln && !ln.getElementsByTagNameNS(A_NS, "noFill").length);
 }
 function patchTextBox(doc, drawing, image, base) {
   if (image.widthPx !== base.widthPx || image.heightPx !== base.heightPx)
     for (const node of [
-      ...descendants(drawing, WP_NS, "extent"),
-      ...descendants(drawing, A_NS, "ext").filter(
+      ...descendants2(drawing, WP_NS, "extent"),
+      ...descendants2(drawing, A_NS, "ext").filter(
         (ext) => ext.parentNode?.localName === "xfrm"
       )
     ]) {
@@ -3247,14 +3379,14 @@ function patchTextBox(doc, drawing, image, base) {
       node.setAttribute("cy", emu(image.heightPx));
     }
   if (JSON.stringify(image.textBoxText) !== JSON.stringify(base.textBoxText)) {
-    const content = descendants(drawing, W_NS, "txbxContent")[0];
+    const content = descendants2(drawing, W_NS, "txbxContent")[0];
     if (content) {
       for (const child3 of Array.from(content.childNodes)) content.removeChild(child3);
       add(content, ...paragraphsFor(doc, image.textBoxText ?? []));
     }
   }
   if (image.textBoxBorder !== false !== (base.textBoxBorder !== false)) {
-    const spPr = descendants(drawing, WPS_NS, "spPr")[0];
+    const spPr = descendants2(drawing, WPS_NS, "spPr")[0];
     if (spPr) {
       for (const old of Array.from(spPr.childNodes).filter(
         (node) => isElement(node) && node.localName === "ln"
@@ -3417,47 +3549,6 @@ var DIAGRAM_RELATIONSHIP_TYPES = {
   drawing: RELATIONSHIP_TYPES.diagramDrawing
 };
 
-// diagram/dom.ts
-function attributeReader(element) {
-  return (name) => {
-    if (!element) return void 0;
-    const direct = element.getAttribute(name);
-    if (direct !== null) return direct;
-    const attributes = element.attributes;
-    for (let index = 0; index < attributes.length; index++) {
-      const candidate = attributes.item(index);
-      if (candidate && candidate.localName === name) return candidate.value;
-    }
-    return void 0;
-  };
-}
-function stringAttribute(element, name) {
-  const value = attributeReader(element)(name)?.trim();
-  return value ? value : void 0;
-}
-function integerAttribute(element, name) {
-  const parsed = Number.parseInt(attributeReader(element)(name) ?? "", 10);
-  return Number.isFinite(parsed) ? parsed : void 0;
-}
-function booleanAttribute(element, name) {
-  const value = attributeReader(element)(name)?.trim().toLowerCase();
-  if (value === "1" || value === "true") return true;
-  if (value === "0" || value === "false") return false;
-  return void 0;
-}
-function descendants2(root, local) {
-  const result = [];
-  const visit = (node) => {
-    for (const child3 of Array.from(node.childNodes)) {
-      if (!isElement(child3)) continue;
-      if (child3.localName === local) result.push(child3);
-      visit(child3);
-    }
-  };
-  visit(root);
-  return result;
-}
-
 // diagram/data-model.ts
 var TRANSITION_TYPES = /* @__PURE__ */ new Set(["parTrans", "sibTrans"]);
 var STRUCTURAL_TYPES = /* @__PURE__ */ new Set(["doc", "pres", "parTrans", "sibTrans"]);
@@ -3481,7 +3572,7 @@ function connectionLabel(connection, transitionText) {
 function textBodyParagraphs(body) {
   if (!body) return [];
   return children(body, "p", NS.a).map(
-    (paragraph) => descendants2(paragraph, "t").map((run) => run.textContent ?? "").join("")
+    (paragraph) => descendants(paragraph, "t").map((run) => run.textContent ?? "").join("")
   );
 }
 function parsePoint(element) {
@@ -3561,7 +3652,7 @@ function parseDiagramDataModel(source, part) {
     if ((!connection.type || connection.type === "parOf") && !parentById.has(connection.destId))
       parentById.set(connection.destId, connection.sourceId);
   }
-  const ext = descendants2(root, "dataModelExt")[0];
+  const ext = descendants(root, "dataModelExt")[0];
   const drawingRelId = stringAttribute(ext, "relId");
   return {
     points,
@@ -3573,55 +3664,8 @@ function parseDiagramDataModel(source, part) {
   };
 }
 
-// diagram/drawing-color.ts
-var COLOR_ELEMENTS = {
-  srgbClr: "srgb",
-  schemeClr: "scheme",
-  sysClr: "system",
-  prstClr: "preset",
-  scrgbClr: "scrgb",
-  hslClr: "hsl"
-};
-function colorValue(kind, element) {
-  const attribute = (name) => element.getAttribute(name) ?? "";
-  if (kind === "scrgb") return `${attribute("r")},${attribute("g")},${attribute("b")}`;
-  if (kind === "hsl") return `${attribute("hue")},${attribute("sat")},${attribute("lum")}`;
-  return attribute("val");
-}
-function parseDrawingColorIn(container) {
-  if (!container) return void 0;
-  for (const element of elements(container)) {
-    const kind = COLOR_ELEMENTS[element.localName];
-    if (!kind || element.namespaceURI && element.namespaceURI !== NS.a) continue;
-    return parseDrawingColor(element);
-  }
-  return void 0;
-}
-function parseDrawingColor(element) {
-  const kind = COLOR_ELEMENTS[element.localName];
-  if (!kind) return void 0;
-  const color = {
-    kind,
-    value: colorValue(kind, element),
-    transforms: elements(element).map((child3) => ({
-      name: child3.localName,
-      value: child3.getAttribute("val") ?? ""
-    }))
-  };
-  const fallback = kind === "system" ? element.getAttribute("lastClr") : null;
-  if (fallback) color.fallback = fallback;
-  return color;
-}
-function parseDrawingColorList(container) {
-  if (!container) return [];
-  return elements(container).flatMap((element) => {
-    const color = parseDrawingColor(element);
-    return color ? [color] : [];
-  });
-}
-
 // diagram/definitions.ts
-var rootOf = (source) => (typeof source === "string" ? parseXml(source, { label: "DiagramML" }) : source).documentElement;
+var rootOf2 = (source) => (typeof source === "string" ? parseXml(source, { label: "DiagramML" }) : source).documentElement;
 function parseDefinitionHeader(root) {
   const header = {
     uniqueId: stringAttribute(root, "uniqueId") ?? "",
@@ -3642,7 +3686,7 @@ function colorList(container) {
   return { ...method ? { method } : {}, colors: parseDrawingColorList(container) };
 }
 function parseDiagramColors(source) {
-  const root = rootOf(source);
+  const root = rootOf2(source);
   const labels = children(root, "styleLbl", NS.dgm).map((label) => ({
     name: stringAttribute(label, "name") ?? "",
     fill: colorList(first(label, "fillClrLst", NS.dgm)),
@@ -3682,7 +3726,7 @@ function parseStyleReferences(style) {
 }
 var hasContent = (element) => Boolean(element && (element.attributes.length > 0 || elements(element).length > 0));
 function parseDiagramQuickStyle(source) {
-  const root = rootOf(source);
+  const root = rootOf2(source);
   const labels = children(root, "styleLbl", NS.dgm).map((label) => ({
     name: stringAttribute(label, "name") ?? "",
     ...parseStyleReferences(first(label, "style", NS.dgm)),
@@ -3696,7 +3740,7 @@ function parseDiagramQuickStyle(source) {
   };
 }
 function parseDiagramLayoutSummary(source) {
-  const root = rootOf(source);
+  const root = rootOf2(source);
   const header = parseDefinitionHeader(root);
   const family = resolveDiagramLayoutCategory(
     header.uniqueId,
@@ -3708,11 +3752,11 @@ function parseDiagramLayoutSummary(source) {
     ...header,
     ...family ? { family } : {},
     ...rootAlgorithm ? { rootAlgorithm } : {},
-    layoutNodeCount: descendants2(root, "layoutNode").length
+    layoutNodeCount: descendants(root, "layoutNode").length
   };
 }
 
-// diagram/drawing-fill.ts
+// drawingml/drawing-fill.ts
 var FILL_ELEMENTS = /* @__PURE__ */ new Set([
   "noFill",
   "solidFill",
@@ -3804,7 +3848,7 @@ function parseDrawingLine(ln) {
   return line;
 }
 
-// diagram/drawing-text.ts
+// drawingml/drawing-text.ts
 function parseSpacing(parent) {
   for (const [name, unit, divisor] of [
     ["spcPts", "points", 100],
@@ -3883,7 +3927,7 @@ function parseDrawingTextBody(body) {
   return result;
 }
 
-// diagram/drawing-geometry.ts
+// drawingml/drawing-geometry.ts
 var int = (element, name) => Number.parseInt(element?.getAttribute(name) ?? "", 10);
 function parseFrame(container) {
   const off = first(container, "off", NS.a);
@@ -4685,6 +4729,23 @@ function parseRunPropertiesSnapshot(xml) {
   return parsePropertiesSnapshot(xml, "rPr");
 }
 
+// docx/field-flags.ts
+function parseFieldFlags(element) {
+  const locked = onOffAttribute(element, "fldLock");
+  const dirty = onOffAttribute(element, "dirty");
+  if (locked === void 0 && dirty === void 0) return void 0;
+  return { ...locked !== void 0 && { locked }, ...dirty !== void 0 && { dirty } };
+}
+function writeFieldFlags(element, flags) {
+  for (const [name, value] of [
+    ["fldLock", flags?.locked],
+    ["dirty", flags?.dirty]
+  ]) {
+    if (value === void 0) element.removeAttributeNS(WORD_NS, name);
+    else element.setAttributeNS(WORD_NS, `w:${name}`, value ? "true" : "false");
+  }
+}
+
 // docx/write-run.ts
 function setAttribute6(element, local, value) {
   element.setAttributeNS(WORD_NS, `w:${local}`, value);
@@ -4870,6 +4931,7 @@ function createRun(doc, run, base, old, allocator) {
   if (run.fieldChar) {
     const marker = makeW(doc, "fldChar");
     setAttribute6(marker, "fldCharType", run.fieldChar);
+    writeFieldFlags(marker, run.fieldFlags);
     node.appendChild(marker);
     return node;
   }
@@ -4950,6 +5012,11 @@ function takeSimpleFieldCommentEdges(doc, runs, start, end, opens, closes) {
     after: take(closes, end - 1).reverse().flatMap((edge) => rangeEndNodes(doc, edge))
   };
 }
+
+// docx/field-lock.ts
+function sameFieldFlags(a, b) {
+  return a?.locked === b?.locked && a?.dirty === b?.dirty;
+}
 var MATH_NAMESPACES = /* @__PURE__ */ new Set([
   "http://schemas.openxmlformats.org/officeDocument/2006/math",
   "http://purl.oclc.org/ooxml/officeDocument/math"
@@ -5274,6 +5341,7 @@ function buildInlineContent(doc, runs, base, slots, allocator, ranges) {
       container = makeW(doc, "fldSimple");
       setW6(container, "instr", ` ${group.instr} `);
     }
+    if (group.kind === "simpleField") writeFieldFlags(container, runAt(start).fieldFlags);
     const edges = group.kind === "simpleField" ? takeSimpleFieldCommentEdges(doc, runs, start, index, opens, closes) : { before: [], after: [] };
     for (let item = start; item < index; item++)
       for (const node of nodesFor(item)) container.appendChild(node);
@@ -5284,13 +5352,18 @@ function buildInlineContent(doc, runs, base, slots, allocator, ranges) {
 function containerGroup(run) {
   if (run.link) return { kind: "link", link: run.link };
   if (run.field?.simple)
-    return { kind: "simpleField", instr: run.field.instr, instanceId: run.fieldInstanceId };
+    return {
+      kind: "simpleField",
+      instr: run.field.instr,
+      instanceId: run.fieldInstanceId,
+      fieldFlags: run.fieldFlags
+    };
   return void 0;
 }
 function sameGroup(a, b) {
   if (!a || !b) return a === b;
   if (a.kind === "link" && b.kind === "link") return sameLink(a.link, b.link);
-  return a.kind === "simpleField" && b.kind === "simpleField" && a.instr === b.instr && a.instanceId === b.instanceId;
+  return a.kind === "simpleField" && b.kind === "simpleField" && a.instr === b.instr && a.instanceId === b.instanceId && sameFieldFlags(a.fieldFlags, b.fieldFlags);
 }
 
 // docx/paragraph-properties.ts
@@ -6214,6 +6287,217 @@ async function registerNumberingPart(zip) {
   zip.file(relsPath, buildXml(relsDoc));
 }
 
+// docx/numbering-parse.ts
+var integer2 = (value, fallback) => parseInteger(value) ?? fallback;
+var flag = (element) => onOffElement(element) === true;
+function byName(root, local) {
+  return Array.from(root.getElementsByTagName("*")).filter(
+    (node) => node.nodeType === 1 && named2(node, local)
+  );
+}
+function parseMarkerFormat(rPr) {
+  if (!rPr) return void 0;
+  const format = {};
+  const family = getW(first2(rPr, "rFonts"), "ascii");
+  if (family) format.fontFamily = family;
+  const size = parseInteger(getW(first2(rPr, "sz"), "val"));
+  if (size !== void 0 && size > 0) format.fontSizeHalfPoints = size;
+  if (onOffElement(first2(rPr, "b")) === true) format.bold = true;
+  if (onOffElement(first2(rPr, "i")) === true) format.italic = true;
+  const color = getW(first2(rPr, "color"), "val");
+  if (color && /^[0-9a-f]{6}$/i.test(color)) format.color = `#${color.toLowerCase()}`;
+  return Object.keys(format).length ? format : void 0;
+}
+function parseNumberingLevel(lvl) {
+  const level = integer2(getW(lvl, "ilvl"), 0);
+  const start = integer2(getW(first2(lvl, "start"), "val"), 1);
+  const numFmt = enumValue(isStNumberFormat, getW(first2(lvl, "numFmt"), "val"), "w:numFmt") ?? "decimal";
+  const lvlText = getW(first2(lvl, "lvlText"), "val") ?? "";
+  const jc = getW(first2(lvl, "lvlJc"), "val");
+  const ind = first2(first2(lvl, "pPr"), "ind");
+  const suffRaw = getW(first2(lvl, "suff"), "val");
+  const result = { level, start, numFmt, lvlText };
+  if (!first2(lvl, "start")) result.startWasOmitted = true;
+  const paragraphStyleId = getW(first2(lvl, "pStyle"), "val");
+  if (paragraphStyleId) result.paragraphStyleId = paragraphStyleId;
+  if (jc === "left" || jc === "center" || jc === "right") result.lvlJc = jc;
+  const left = getW(ind, "left") ?? getW(ind, "start");
+  if (left !== void 0) result.indentLeftTwips = parseSignedTwips(left) ?? signedTwips(0);
+  const hanging = getW(ind, "hanging");
+  if (hanging !== void 0) result.hangingTwips = parseTwips(hanging) ?? twips(0);
+  const firstLine = getW(ind, "firstLine");
+  if (firstLine !== void 0) result.firstLineTwips = parseTwips(firstLine) ?? twips(0);
+  const tabs = first2(first2(lvl, "pPr"), "tabs");
+  const tab = tabs ? children2(tabs, "tab").find((stop) => getW(stop, "val") !== "clear") : void 0;
+  const tabPos = tab ? parseTwips(getW(tab, "pos")) : void 0;
+  if (tabPos !== void 0) result.tabStopTwips = tabPos;
+  if (flag(first2(lvl, "isLgl"))) result.isLgl = true;
+  const restart = getW(first2(lvl, "lvlRestart"), "val");
+  if (restart !== void 0) result.lvlRestart = integer2(restart, 0);
+  const marker = parseMarkerFormat(first2(lvl, "rPr"));
+  if (marker) result.markerFormat = marker;
+  result.suffix = suffRaw === "space" ? "space" : suffRaw === "nothing" ? "none" : "tab";
+  return result;
+}
+function parseAbstractNum(element) {
+  const id = getW(element, "abstractNumId");
+  if (!id) return void 0;
+  const levels = {};
+  for (const lvl of children2(element, "lvl")) {
+    const parsed = parseNumberingLevel(lvl);
+    levels[parsed.level] = parsed;
+  }
+  return { id, levels };
+}
+function parseNum(element) {
+  const id = getW(element, "numId");
+  if (!id) return void 0;
+  const abstractNumId = getW(first2(element, "abstractNumId"), "val") ?? "";
+  const levelOverrides = {};
+  for (const override of children2(element, "lvlOverride")) {
+    const level = integer2(getW(override, "ilvl"), 0);
+    const entry = {};
+    const startOverride = getW(first2(override, "startOverride"), "val");
+    if (startOverride !== void 0) entry.startOverride = integer2(startOverride, 1);
+    const lvl = first2(override, "lvl");
+    if (lvl) entry.lvl = parseNumberingLevel(lvl);
+    if (Object.keys(entry).length) levelOverrides[level] = entry;
+  }
+  return {
+    id,
+    abstractNumId,
+    ...Object.keys(levelOverrides).length ? { levelOverrides } : {}
+  };
+}
+function parseNumberingCatalog(xml) {
+  const document = parseXml2(xml);
+  const root = document.documentElement;
+  const abstractNums = {};
+  const warnings = [];
+  for (const element of byName(root, "abstractNum")) {
+    const parsed = parseAbstractNum(element);
+    if (!parsed) continue;
+    abstractNums[parsed.id] = parsed;
+    const link = getW(first2(element, "numStyleLink"), "val");
+    if (link)
+      warnings.push(
+        `Numbering definition abstractNum ${parsed.id} links to style "${link}"; style-linked numbering levels are not resolved.`
+      );
+    if (byName(element, "lvlPicBulletId").length)
+      warnings.push(
+        `Numbering definition abstractNum ${parsed.id} uses a picture bullet; picture bullets are not rendered.`
+      );
+  }
+  const nums = {};
+  for (const element of byName(root, "num")) {
+    const parsed = parseNum(element);
+    if (parsed) nums[parsed.id] = parsed;
+  }
+  return { abstractNums, nums, warnings: [...new Set(warnings)] };
+}
+function resolveNumberingLevel(catalog, numId, level) {
+  const num = catalog.nums[numId];
+  if (!num) return void 0;
+  const override = num.levelOverrides?.[level];
+  const sourceAbstract = catalog.abstractNums[num.abstractNumId]?.levels[level];
+  const abstract = sourceAbstract?.startWasOmitted && sourceAbstract.start === 1 ? { ...sourceAbstract, start: 0 } : sourceAbstract;
+  let base = override?.lvl ?? abstract;
+  if (!base) return void 0;
+  if (override?.lvl) {
+    const { lvlRestart: _ignored, ...properties } = base;
+    base = {
+      ...properties,
+      ...abstract?.lvlRestart !== void 0 ? { lvlRestart: abstract.lvlRestart } : {}
+    };
+  }
+  let start = override?.startOverride ?? base.start;
+  if (override?.lvl) {
+    if (abstract?.lvlRestart === 0 && override.startOverride === void 0) start = abstract.start;
+    else if (!override.lvl.startWasOmitted || override.lvl.start !== 1) start = override.lvl.start;
+    else start = override.startOverride ?? 0;
+  }
+  return start !== base.start ? { ...base, start } : base;
+}
+
+// docx/numbering-start-edit.ts
+function assertListStartValue(level, start) {
+  if (!Number.isInteger(level) || level < 0 || level > 8)
+    throw new Error("List level must be an integer from 0 through 8.");
+  if (!Number.isInteger(start) || start < 0 || start > 2147483647)
+    throw new Error("List start must be an integer from 0 through 2147483647.");
+}
+
+// docx/numbering-start-patch.ts
+function withoutStarts(num) {
+  const { levelOverrides, ...properties } = num;
+  const kept = {};
+  for (const [level, override] of Object.entries(levelOverrides ?? {})) {
+    const { startOverride: _start, ...rest } = override;
+    if (Object.keys(rest).length) kept[level] = rest;
+  }
+  return { ...properties, ...Object.keys(kept).length ? { levelOverrides: kept } : {} };
+}
+function numberingStartChanges(prior, next) {
+  const changes = [];
+  for (const [id, previous] of Object.entries(prior?.nums ?? {})) {
+    const current = next.nums[id];
+    if (!current || JSON.stringify(withoutStarts(current)) !== JSON.stringify(withoutStarts(previous)))
+      throw new Error(
+        `Cannot edit numbering definition num "${id}" except its supported start overrides.`
+      );
+    for (const key of /* @__PURE__ */ new Set([
+      ...Object.keys(previous.levelOverrides ?? {}),
+      ...Object.keys(current.levelOverrides ?? {})
+    ])) {
+      const level = Number(key);
+      const old = previous.levelOverrides?.[level];
+      const value = current.levelOverrides?.[level];
+      if (old?.startOverride === value?.startOverride) continue;
+      if (value?.startOverride === void 0)
+        throw new Error("Removing a list start override is unsupported.");
+      assertListStartValue(level, value.startOverride);
+      if (String(level) !== key || !prior || !resolveNumberingLevel(prior, id, level))
+        throw new Error("List instance or level does not exist.");
+      if (old?.lvl || value.lvl)
+        throw new Error("Changing starts with a full level override is unsupported.");
+      changes.push({ numId: id, level, start: value.startOverride });
+    }
+  }
+  return changes;
+}
+function patchNumberingStarts(doc, changes) {
+  const sameNumber = (source, expected) => source !== void 0 && /^[+-]?\d+$/.test(source) && Number(source) === Number(expected);
+  const prepared = changes.map((change) => {
+    const nums = children2(doc.documentElement, "num").filter(
+      (num2) => sameNumber(getW(num2, "numId"), change.numId)
+    );
+    if (nums.length !== 1 || getW(nums[0], "numId") !== change.numId)
+      throw new Error("Cannot patch an ambiguous or missing source list instance.");
+    const num = nums[0];
+    const overrides = children2(num, "lvlOverride").filter(
+      (node) => sameNumber(getW(node, "ilvl"), String(change.level))
+    );
+    if (overrides.length > 1) throw new Error("Cannot patch duplicate source level overrides.");
+    const override = overrides[0];
+    if (override && getW(override, "ilvl") !== String(change.level))
+      throw new Error("Cannot patch a noncanonical source level override.");
+    if (override && (children2(override, "lvl").length || children2(override, "startOverride").length > 1))
+      throw new Error("Cannot patch a full or ambiguous source level override.");
+    return { change, num, override };
+  });
+  for (const { change, num, override: existing } of prepared) {
+    const override = existing ?? makeW(doc, "lvlOverride");
+    if (!existing) {
+      override.setAttributeNS(WORD_NS, "w:ilvl", String(change.level));
+      const after = children2(num, "lvlOverride").at(-1) ?? children2(num, "abstractNumId")[0];
+      num.insertBefore(override, after?.nextSibling ?? null);
+    }
+    const start = children2(override, "startOverride")[0] ?? makeW(doc, "startOverride");
+    start.setAttributeNS(WORD_NS, "w:val", String(change.start));
+    if (!start.parentNode) override.insertBefore(start, override.firstChild);
+  }
+}
+
 // docx/numbering-package.ts
 function setAttribute8(element, local, value) {
   element.setAttributeNS(WORD_NS, `w:${local}`, value);
@@ -6318,17 +6602,14 @@ async function applyNumberingCatalog(zip, model, binding) {
       throw new Error(
         `Cannot edit numbering definition abstractNum "${id}"; the original numbering.xml is preserved unchanged.`
       );
-  for (const id of Object.keys(prior?.nums ?? {}))
-    if (JSON.stringify(next.nums[id]) !== JSON.stringify(prior?.nums[id]))
-      throw new Error(
-        `Cannot edit numbering definition num "${id}"; the original numbering.xml is preserved unchanged.`
-      );
+  const startChanges = numberingStartChanges(prior, next);
   const newAbstractIds = Object.keys(next.abstractNums).filter((id) => !prior?.abstractNums[id]);
   const newNumIds = Object.keys(next.nums).filter((id) => !prior?.nums[id]);
-  if (!newAbstractIds.length && !newNumIds.length) return;
+  if (!newAbstractIds.length && !newNumIds.length && !startChanges.length) return;
   const existingFile = zip.file("word/numbering.xml");
   const doc = existingFile ? parseXml2(await existingFile.async("string")) : parseXml2(`<w:numbering xmlns:w="${WORD_NS}"/>`);
   const root = doc.documentElement;
+  patchNumberingStarts(doc, startChanges);
   const cleanup = children2(root, "numIdMacAtCleanup")[0] ?? null;
   const firstNum = children2(root, "num")[0] ?? cleanup;
   for (const id of newAbstractIds) {
@@ -7194,23 +7475,31 @@ function createFieldTracker() {
   const stack = [];
   return (element, run) => {
     let resultInstr;
+    let resultLocked;
     for (const child3 of Array.from(element.childNodes)) {
       if (!isElement(child3)) continue;
       if (named2(child3, "fldChar")) {
         const type = getW(child3, "fldCharType");
-        if (type === "begin") stack.push({ instr: "", inResult: false });
-        else if (type === "separate") {
+        if (type === "begin") {
+          const locked = parseFieldFlags(child3)?.locked;
+          stack.push({ instr: "", inResult: false, ...locked !== void 0 && { locked } });
+        } else if (type === "separate") {
           const top = stack.at(-1);
           if (top) top.inResult = true;
         } else if (type === "end") stack.pop();
       } else {
         const top = stack.at(-1);
         if (named2(child3, "instrText") && top && !top.inResult) top.instr += textContent(child3);
-        else if ((named2(child3, "t") || named2(child3, "delText")) && top?.inResult)
+        else if ((named2(child3, "t") || named2(child3, "delText")) && top?.inResult) {
           resultInstr = top.instr.trim();
+          resultLocked = top.locked;
+        }
       }
     }
-    if (resultInstr) run.field = { instr: resultInstr };
+    if (resultInstr) {
+      run.field = { instr: resultInstr };
+      if (resultLocked !== void 0) run.fieldFlags = { locked: resultLocked };
+    }
     return run;
   };
 }
@@ -7221,7 +7510,11 @@ function storyFieldResults(container) {
     if (named2(element, "fldSimple") || named2(element, "txbxContent")) return;
     if (named2(element, "r")) {
       const run = trackField(element, { text: "" });
-      if (run.field) metadata.set(element, run.field);
+      if (run.field)
+        metadata.set(element, {
+          field: run.field,
+          ...run.fieldFlags && { fieldFlags: run.fieldFlags }
+        });
       return;
     }
     for (const child3 of Array.from(element.childNodes)) if (isElement(child3)) visit(child3);
@@ -7313,7 +7606,11 @@ function parseRun2(node, revision) {
   if (breakKind) run.break = breakKind;
   if (noteReference) run.noteReference = noteReference;
   if (noteMark) run.noteMark = noteMark;
-  if (fieldChar) run.fieldChar = fieldChar;
+  if (fieldChar) {
+    run.fieldChar = fieldChar;
+    const flags = parseFieldFlags(only);
+    if (flags) run.fieldFlags = flags;
+  }
   if (fieldCode !== void 0) run.fieldCode = fieldCode;
   const runRevision = revision ?? runFormatRevision(props);
   if (runRevision) run.revision = runRevision;
@@ -7332,8 +7629,11 @@ function parseParagraph2(node, id, fields) {
     (element, revision) => {
       const run = parseRun2(element, revision);
       if (!fields) return trackField(element, run);
-      const field = fields.get(element);
-      if (field) run.field = { ...field };
+      const metadata = fields.get(element);
+      if (metadata) {
+        run.field = { ...metadata.field };
+        if (metadata.fieldFlags) run.fieldFlags = { ...metadata.fieldFlags };
+      }
       return run;
     },
     (item) => {
@@ -7355,20 +7655,23 @@ function parseParagraph2(node, id, fields) {
       );
       if (link) return results.map((run) => ({ ...run, link }));
       const field = { instr: instr.trim(), simple: true };
+      const flags = parseFieldFlags(item);
+      const fieldState = flags ? { fieldFlags: flags } : {};
       const fieldInstanceId = `${id}:simple-field-${simpleFieldIndex++}`;
-      if (!results.length) return [{ text: fieldPlaceholderText(instr), field, fieldInstanceId }];
+      if (!results.length)
+        return [{ text: fieldPlaceholderText(instr), field, fieldInstanceId, ...fieldState }];
       if (results.every(
         (run) => !run.text && !run.equation && !run.image && !run.break && !run.noteReference && !run.noteMark && !run.fieldChar && run.fieldCode === void 0
       )) {
         return [
-          { text: "", fieldChar: "begin" },
+          { text: "", fieldChar: "begin", ...fieldState },
           { text: "", fieldCode: instr },
           { text: "", fieldChar: "separate" },
           ...results,
           { text: "", fieldChar: "end" }
         ];
       }
-      return results.map((run) => ({ ...run, field, fieldInstanceId }));
+      return results.map((run) => ({ ...run, field, fieldInstanceId, ...fieldState }));
     },
     (hyperlink) => {
       if (!activeContext) return void 0;
@@ -7670,115 +7973,6 @@ async function parseDocumentParts(zip, body, blocks, drawings) {
   };
 }
 
-// docx/numbering-parse.ts
-var integer2 = (value, fallback) => parseInteger(value) ?? fallback;
-var flag = (element) => onOffElement(element) === true;
-function byName(root, local) {
-  return Array.from(root.getElementsByTagName("*")).filter(
-    (node) => node.nodeType === 1 && named2(node, local)
-  );
-}
-function parseMarkerFormat(rPr) {
-  if (!rPr) return void 0;
-  const format = {};
-  const family = getW(first2(rPr, "rFonts"), "ascii");
-  if (family) format.fontFamily = family;
-  const size = parseInteger(getW(first2(rPr, "sz"), "val"));
-  if (size !== void 0 && size > 0) format.fontSizeHalfPoints = size;
-  if (onOffElement(first2(rPr, "b")) === true) format.bold = true;
-  if (onOffElement(first2(rPr, "i")) === true) format.italic = true;
-  const color = getW(first2(rPr, "color"), "val");
-  if (color && /^[0-9a-f]{6}$/i.test(color)) format.color = `#${color.toLowerCase()}`;
-  return Object.keys(format).length ? format : void 0;
-}
-function parseNumberingLevel(lvl) {
-  const level = integer2(getW(lvl, "ilvl"), 0);
-  const start = integer2(getW(first2(lvl, "start"), "val"), 1);
-  const numFmt = enumValue(isStNumberFormat, getW(first2(lvl, "numFmt"), "val"), "w:numFmt") ?? "decimal";
-  const lvlText = getW(first2(lvl, "lvlText"), "val") ?? "";
-  const jc = getW(first2(lvl, "lvlJc"), "val");
-  const ind = first2(first2(lvl, "pPr"), "ind");
-  const suffRaw = getW(first2(lvl, "suff"), "val");
-  const result = { level, start, numFmt, lvlText };
-  if (!first2(lvl, "start")) result.startWasOmitted = true;
-  const paragraphStyleId = getW(first2(lvl, "pStyle"), "val");
-  if (paragraphStyleId) result.paragraphStyleId = paragraphStyleId;
-  if (jc === "left" || jc === "center" || jc === "right") result.lvlJc = jc;
-  const left = getW(ind, "left") ?? getW(ind, "start");
-  if (left !== void 0) result.indentLeftTwips = parseSignedTwips(left) ?? signedTwips(0);
-  const hanging = getW(ind, "hanging");
-  if (hanging !== void 0) result.hangingTwips = parseTwips(hanging) ?? twips(0);
-  const firstLine = getW(ind, "firstLine");
-  if (firstLine !== void 0) result.firstLineTwips = parseTwips(firstLine) ?? twips(0);
-  const tabs = first2(first2(lvl, "pPr"), "tabs");
-  const tab = tabs ? children2(tabs, "tab").find((stop) => getW(stop, "val") !== "clear") : void 0;
-  const tabPos = tab ? parseTwips(getW(tab, "pos")) : void 0;
-  if (tabPos !== void 0) result.tabStopTwips = tabPos;
-  if (flag(first2(lvl, "isLgl"))) result.isLgl = true;
-  const restart = getW(first2(lvl, "lvlRestart"), "val");
-  if (restart !== void 0) result.lvlRestart = integer2(restart, 0);
-  const marker = parseMarkerFormat(first2(lvl, "rPr"));
-  if (marker) result.markerFormat = marker;
-  result.suffix = suffRaw === "space" ? "space" : suffRaw === "nothing" ? "none" : "tab";
-  return result;
-}
-function parseAbstractNum(element) {
-  const id = getW(element, "abstractNumId");
-  if (!id) return void 0;
-  const levels = {};
-  for (const lvl of children2(element, "lvl")) {
-    const parsed = parseNumberingLevel(lvl);
-    levels[parsed.level] = parsed;
-  }
-  return { id, levels };
-}
-function parseNum(element) {
-  const id = getW(element, "numId");
-  if (!id) return void 0;
-  const abstractNumId = getW(first2(element, "abstractNumId"), "val") ?? "";
-  const levelOverrides = {};
-  for (const override of children2(element, "lvlOverride")) {
-    const level = integer2(getW(override, "ilvl"), 0);
-    const entry = {};
-    const startOverride = getW(first2(override, "startOverride"), "val");
-    if (startOverride !== void 0) entry.startOverride = integer2(startOverride, 1);
-    const lvl = first2(override, "lvl");
-    if (lvl) entry.lvl = parseNumberingLevel(lvl);
-    if (Object.keys(entry).length) levelOverrides[level] = entry;
-  }
-  return {
-    id,
-    abstractNumId,
-    ...Object.keys(levelOverrides).length ? { levelOverrides } : {}
-  };
-}
-function parseNumberingCatalog(xml) {
-  const document = parseXml2(xml);
-  const root = document.documentElement;
-  const abstractNums = {};
-  const warnings = [];
-  for (const element of byName(root, "abstractNum")) {
-    const parsed = parseAbstractNum(element);
-    if (!parsed) continue;
-    abstractNums[parsed.id] = parsed;
-    const link = getW(first2(element, "numStyleLink"), "val");
-    if (link)
-      warnings.push(
-        `Numbering definition abstractNum ${parsed.id} links to style "${link}"; style-linked numbering levels are not resolved.`
-      );
-    if (byName(element, "lvlPicBulletId").length)
-      warnings.push(
-        `Numbering definition abstractNum ${parsed.id} uses a picture bullet; picture bullets are not rendered.`
-      );
-  }
-  const nums = {};
-  for (const element of byName(root, "num")) {
-    const parsed = parseNum(element);
-    if (parsed) nums[parsed.id] = parsed;
-  }
-  return { abstractNums, nums, warnings: [...new Set(warnings)] };
-}
-
 // docx/comments.ts
 var W14_NS2 = "http://schemas.microsoft.com/office/word/2010/wordml";
 var W15_NS2 = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -8013,7 +8207,7 @@ async function readPackage(input) {
   const themeFile = zip.file("word/theme/theme1.xml");
   const settingsFile = zip.file("word/settings.xml");
   if (themeFile) {
-    model.theme = parseTheme(await themeFile.async("string"));
+    model.theme = parseTheme2(await themeFile.async("string"));
     if (settingsFile) {
       const settingsXml = await settingsFile.async("string");
       model.theme.colorMapping = withParseWarnings(