ooxml-core 1.1.0 → 1.2.0

package/dist/opc/index.mjs

@@ -1,4 +1,5 @@
 import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+import JSZip from 'jszip';
 
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -399,6 +400,33 @@ function isStorableHyperlinkHref(href) {
 function isOpenableHyperlinkHref(href) {
   return hyperlinkPolicy(href).open;
 }
+async function listEmbeddedPackages(bytes) {
+  const zip = await JSZip.loadAsync(bytes);
+  const result = [];
+  for (const file of Object.values(zip.files)) {
+    if (file.dir || !/^(word|ppt|xl|visio)\/embeddings\/[^/]+$/u.test(file.name)) continue;
+    const ext = file.name.split(".").pop()?.toLowerCase();
+    const kind = ext === "docx" || ext === "xlsx" || ext === "pptx" || ext === "vsdx" ? ext : "unsupported";
+    result.push({
+      path: file.name,
+      name: file.name.split("/").pop(),
+      kind,
+      bytes: await file.async("uint8array")
+    });
+  }
+  return result;
+}
+async function replaceEmbeddedPackage(parent, path, child) {
+  if (!/^(word|ppt|xl|visio)\/embeddings\/[^/]+\.(docx|xlsx|pptx|vsdx)$/u.test(path))
+    throw new Error("Only native Office package embeddings can be saved back");
+  const zip = await JSZip.loadAsync(parent);
+  if (!zip.file(path)) throw new Error("The embedded document no longer exists");
+  const nested = await JSZip.loadAsync(child);
+  if (!nested.file("[Content_Types].xml"))
+    throw new Error("The replacement is not an Office package");
+  zip.file(path, child);
+  return zip.generateAsync({ type: "uint8array", compression: "DEFLATE" });
+}
 
 // opc/properties/types.ts
 var CUSTOM_PROPERTIES_FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}";
@@ -413,6 +441,175 @@ var PROPERTY_CONTENT_TYPES = {
   custom: "application/vnd.openxmlformats-officedocument.custom-properties+xml"
 };
 
+// opc/properties/patch.ts
+var XMLNS = "http://www.w3.org/2000/xmlns/";
+function tagEnd(xml, from) {
+  let quote = "";
+  for (let i = from + 1; i < xml.length; i++) {
+    const ch = xml[i];
+    if (quote) {
+      if (ch === quote) quote = "";
+    } else if (ch === '"' || ch === "'") quote = ch;
+    else if (ch === ">") return i + 1;
+  }
+  throw new Error("Unterminated tag in property part");
+}
+function skipMarkup(xml, at) {
+  if (xml.startsWith("<!--", at)) return xml.indexOf("-->", at) + 3;
+  if (xml.startsWith("<![CDATA[", at)) return xml.indexOf("]]>", at) + 3;
+  if (xml.startsWith("<?", at)) return xml.indexOf("?>", at) + 2;
+  return void 0;
+}
+function scan(xml) {
+  let i = 0;
+  let rootStart = -1;
+  while (rootStart < 0) {
+    const lt = xml.indexOf("<", i);
+    if (lt < 0) throw new Error("Property part has no root element");
+    const skipped = skipMarkup(xml, lt);
+    if (skipped !== void 0) i = skipped;
+    else rootStart = lt;
+  }
+  const openEnd = tagEnd(xml, rootStart);
+  if (xml[openEnd - 2] === "/") {
+    const root = {
+      start: rootStart,
+      openEnd,
+      closeStart: openEnd,
+      end: openEnd,
+      selfClosing: true
+    };
+    return { root, children: [] };
+  }
+  const children2 = [];
+  let depth = 0;
+  let child;
+  i = openEnd;
+  for (; ; ) {
+    const lt = xml.indexOf("<", i);
+    if (lt < 0) throw new Error("Property part root is not closed");
+    const skipped = skipMarkup(xml, lt);
+    if (skipped !== void 0) {
+      i = skipped;
+      continue;
+    }
+    const end = tagEnd(xml, lt);
+    i = end;
+    if (xml[lt + 1] === "/") {
+      if (depth === 0) {
+        const root = { start: rootStart, openEnd, closeStart: lt, end, selfClosing: false };
+        return { root, children: children2 };
+      }
+      depth--;
+      if (depth === 0 && child)
+        children2.push({ ...child, closeStart: lt, end, selfClosing: false });
+    } else if (xml[end - 2] === "/") {
+      if (depth === 0)
+        children2.push({ start: lt, openEnd: end, closeStart: end, end, selfClosing: true });
+    } else {
+      if (depth === 0) child = { start: lt, openEnd: end };
+      depth++;
+    }
+  }
+}
+var escapeText = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/\r/g, "&#xD;");
+var qualifiedName = (xml, span) => /^<([^\s/>]+)/.exec(xml.slice(span.start, span.openEnd))?.[1] ?? "";
+var PartPatch = class {
+  constructor(xml, rootElement) {
+    this.xml = xml;
+    const { root, children: children2 } = scan(xml);
+    const kids = elements(rootElement);
+    if (kids.length !== children2.length) throw new Error("Property part markup is not supported");
+    kids.forEach((kid, index) => this.spans.set(kid, children2[index]));
+    this.root = root;
+    for (const attribute of Array.from(rootElement.attributes)) {
+      if (attribute.name === "xmlns") this.defaultNs = attribute.value;
+      else if (attribute.namespaceURI === XMLNS || attribute.name.startsWith("xmlns:"))
+        this.prefixes.set(attribute.value, attribute.localName);
+    }
+  }
+  xml;
+  root;
+  spans = /* @__PURE__ */ new Map();
+  edits = [];
+  appended = [];
+  prefixes = /* @__PURE__ */ new Map();
+  defaultNs = null;
+  seq = 0;
+  add(start, end, text) {
+    this.edits.push({ start, end, text, seq: this.seq++ });
+  }
+  span(element) {
+    const span = this.spans.get(element);
+    if (!span) throw new Error("Element is not a child of the patched root");
+    return span;
+  }
+  /** The prefix bound to `ns` on the root, declaring `preferred` for it when none is. */
+  prefix(ns, preferred) {
+    const known = this.prefixes.get(ns);
+    if (known !== void 0) return known;
+    const taken = new Set(this.prefixes.values());
+    let prefix = preferred;
+    for (let n = 1; taken.has(prefix); n++) prefix = `${preferred}${n}`;
+    this.prefixes.set(ns, prefix);
+    const at = this.root.openEnd - (this.root.selfClosing ? 2 : 1);
+    this.add(at, at, ` xmlns:${prefix}="${ns}"`);
+    return prefix;
+  }
+  /** `local` qualified for an element in `ns`: unprefixed in the default namespace. */
+  qualify(ns, local, preferred) {
+    return this.defaultNs === ns && !this.prefixes.has(ns) ? local : `${this.prefix(ns, preferred)}:${local}`;
+  }
+  /** Replaces the element's content, keeping its start tag (and attributes) as written. */
+  setContent(element, content2) {
+    const span = this.span(element);
+    if (span.selfClosing)
+      this.add(span.openEnd - 2, span.openEnd, `>${content2}</${qualifiedName(this.xml, span)}>`);
+    else this.add(span.openEnd, span.closeStart, content2);
+  }
+  /** Adds ` name="value"` text to the element's start tag. */
+  addAttribute(element, attribute) {
+    const span = this.span(element);
+    const at = span.openEnd - (span.selfClosing ? 2 : 1);
+    this.add(at, at, attribute);
+  }
+  remove(element) {
+    const span = this.span(element);
+    this.add(span.start, span.end, "");
+  }
+  /** Inserts `markup` before `before`, or as the root's last child. */
+  insert(markup, before) {
+    if (before) {
+      const at = this.span(before).start;
+      this.add(at, at, markup);
+    } else this.appended.push(markup);
+  }
+  toString() {
+    const edits = [...this.edits];
+    if (this.appended.length) {
+      const text = this.appended.join("");
+      const root = this.root;
+      if (root.selfClosing) {
+        const name = qualifiedName(this.xml, root);
+        edits.push({
+          start: root.end - 2,
+          end: root.end,
+          text: `>${text}</${name}>`,
+          seq: this.seq
+        });
+      } else edits.push({ start: root.closeStart, end: root.closeStart, text, seq: this.seq });
+    }
+    edits.sort((a, b) => a.start - b.start || a.end - a.start - (b.end - b.start) || a.seq - b.seq);
+    let out = "";
+    let at = 0;
+    for (const edit of edits) {
+      out += this.xml.slice(at, edit.start) + edit.text;
+      at = Math.max(at, edit.end);
+    }
+    return out + this.xml.slice(at);
+  }
+};
+
 // opc/properties/core.ts
 var XSI = "http://www.w3.org/2001/XMLSchema-instance";
 var FIELDS = [
@@ -445,54 +642,79 @@ function parseCoreProperties(xml) {
   }
   return out;
 }
+var formatW3cdtf = (date) => date.toISOString().replace(/\.\d{3}Z$/, "Z");
 function writeCoreProperties(props, sourceXml) {
-  const doc = parseXml(sourceXml ?? EMPTY_CORE, { label: "core properties" });
-  const root = doc.documentElement;
+  const xml = sourceXml ?? EMPTY_CORE;
+  const root = parseXml(xml, { label: "core properties" }).documentElement;
+  const patch = new PartPatch(xml, root);
   for (const [field, prefix, isDate] of FIELDS) {
     const ns = NS[prefix];
     const value = props[field];
-    let element = first(root, field, ns);
+    const element = first(root, field, ns);
     if (value === void 0 || value === "") {
-      if (element && (element.textContent ?? "") !== "") root.removeChild(element);
+      if (element && (element.textContent ?? "") !== "") patch.remove(element);
       continue;
     }
-    if (!element) {
-      element = doc.createElementNS(ns, `${prefix}:${field}`);
-      if (isDate) element.setAttributeNS(XSI, "xsi:type", "dcterms:W3CDTF");
-      root.appendChild(element);
+    if (element && element.textContent === value) continue;
+    const typed = () => ` ${patch.prefix(XSI, "xsi")}:type="${patch.prefix(NS.dcterms, "dcterms")}:W3CDTF"`;
+    if (element) {
+      if (isDate && !element.getAttributeNS(XSI, "type")) patch.addAttribute(element, typed());
+      patch.setContent(element, escapeText(value));
+      continue;
     }
-    if (element.textContent !== value) element.textContent = value;
+    const name = patch.qualify(ns, field, prefix);
+    patch.insert(`<${name}${isDate ? typed() : ""}>${escapeText(value)}</${name}>`);
   }
-  const out = buildXml(doc);
-  return out.startsWith("<?xml") ? out : `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-${out}`;
+  return patch.toString();
 }
 
 // opc/properties/app.ts
 var FIELDS2 = [
   ["template", "Template", "text"],
   ["totalTime", "TotalTime", "int"],
+  ["pages", "Pages", "int"],
+  ["words", "Words", "int"],
+  ["characters", "Characters", "int"],
   ["application", "Application", "text"],
   ["docSecurity", "DocSecurity", "int"],
+  ["presentationFormat", "PresentationFormat", "text"],
+  ["lines", "Lines", "int"],
+  ["paragraphs", "Paragraphs", "int"],
+  ["slides", "Slides", "int"],
+  ["notes", "Notes", "int"],
+  ["hiddenSlides", "HiddenSlides", "int"],
+  ["mmClips", "MMClips", "int"],
   ["scaleCrop", "ScaleCrop", "bool"],
   ["headingPairs", "HeadingPairs", "pairs"],
   ["titlesOfParts", "TitlesOfParts", "titles"],
   ["manager", "Manager", "text"],
   ["company", "Company", "text"],
   ["linksUpToDate", "LinksUpToDate", "bool"],
+  ["charactersWithSpaces", "CharactersWithSpaces", "int"],
   ["sharedDoc", "SharedDoc", "bool"],
   ["hyperlinkBase", "HyperlinkBase", "text"],
   ["hyperlinksChanged", "HyperlinksChanged", "bool"],
   ["appVersion", "AppVersion", "text"]
 ];
+var STRICT_APP_NAMESPACES = {
+  extendedProperties: "http://purl.oclc.org/ooxml/officeDocument/extendedProperties",
+  vt: "http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
+};
 var EMPTY_APP = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Properties xmlns="${NS.extendedProperties}" xmlns:vt="${NS.vt}"/>`;
-function vectorItems(element) {
-  const vector = first(element, "vector", NS.vt);
+function namespacesOf(root) {
+  if (root.localName !== "Properties") return void 0;
+  if (root.namespaceURI === NS.extendedProperties) return { app: NS.extendedProperties, vt: NS.vt };
+  if (root.namespaceURI === STRICT_APP_NAMESPACES.extendedProperties)
+    return { app: STRICT_APP_NAMESPACES.extendedProperties, vt: STRICT_APP_NAMESPACES.vt };
+  return void 0;
+}
+function vectorItems(element, vt) {
+  const vector = first(element, "vector", vt);
   return vector ? elements(vector) : [];
 }
-function readPairs(element) {
-  const variants = vectorItems(element).map((variant) => elements(variant)[0]);
+function readPairs(element, vt) {
+  const variants = vectorItems(element, vt).map((variant) => elements(variant)[0]);
   const out = [];
   for (let i = 0; i + 1 < variants.length; i += 2) {
     const name = variants[i]?.textContent ?? "";
@@ -501,10 +723,10 @@ function readPairs(element) {
   }
   return out;
 }
-function readField(element, kind) {
+function readField(element, kind, vt) {
   const text = element.textContent ?? "";
-  if (kind === "pairs") return readPairs(element);
-  if (kind === "titles") return vectorItems(element).map((item) => item.textContent ?? "");
+  if (kind === "pairs") return readPairs(element, vt);
+  if (kind === "titles") return vectorItems(element, vt).map((item) => item.textContent ?? "");
   if (kind === "bool") return text.trim() === "true" || text.trim() === "1";
   if (kind === "int") {
     const value = Number.parseInt(text, 10);
@@ -512,69 +734,61 @@ function readField(element, kind) {
   }
   return text === "" ? void 0 : text;
 }
-function parseAppProperties(xml) {
+function readKnown(root, ns) {
   const out = {};
-  if (!xml) return out;
-  const root = parseXml(xml, { label: "app properties" }).documentElement;
   for (const [field, local, kind] of FIELDS2) {
-    const element = first(root, local, NS.extendedProperties);
+    const element = first(root, local, ns.app);
     if (!element) continue;
-    const value = readField(element, kind);
+    const value = readField(element, kind, ns.vt);
     if (value !== void 0) out[field] = value;
   }
   return out;
 }
+function parseAppProperties(xml) {
+  if (!xml) return {};
+  const root = parseXml(xml, { label: "app properties" }).documentElement;
+  const ns = namespacesOf(root);
+  return ns ? readKnown(root, ns) : {};
+}
 var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
-function fill(doc, element, kind, value) {
-  while (element.firstChild) element.removeChild(element.firstChild);
-  const vt = (local, text) => {
-    const node = doc.createElementNS(NS.vt, `vt:${local}`);
-    if (text !== void 0) node.textContent = text;
-    return node;
-  };
-  if (kind === "pairs" || kind === "titles") {
-    const items = kind === "pairs" ? value.flatMap((pair) => [
-      vt("lpstr", pair.name),
-      vt("i4", String(Math.trunc(pair.count)))
-    ]) : value.map((title) => vt("lpstr", title));
-    const vector = vt("vector");
-    vector.setAttribute("size", String(items.length));
-    vector.setAttribute("baseType", kind === "pairs" ? "variant" : "lpstr");
-    for (const item of items) {
-      if (kind === "pairs") {
-        const variant = vt("variant");
-        variant.appendChild(item);
-        vector.appendChild(variant);
-      } else vector.appendChild(item);
-    }
-    element.appendChild(vector);
-    return;
-  }
-  element.textContent = kind === "bool" ? value ? "true" : "false" : String(value);
+function content(kind, value, vt) {
+  if (kind === "bool") return value ? "true" : "false";
+  if (kind === "int") return String(Math.trunc(value));
+  if (kind === "text") return escapeText(String(value));
+  const item = (local, text) => `<${vt}:${local}>${escapeText(text)}</${vt}:${local}>`;
+  const items = kind === "pairs" ? value.flatMap((pair) => [
+    `<${vt}:variant>${item("lpstr", pair.name)}</${vt}:variant>`,
+    `<${vt}:variant>${item("i4", String(Math.trunc(pair.count)))}</${vt}:variant>`
+  ]) : value.map((title) => item("lpstr", title));
+  const baseType = kind === "pairs" ? "variant" : "lpstr";
+  return `<${vt}:vector size="${items.length}" baseType="${baseType}">${items.join("")}</${vt}:vector>`;
 }
 function writeAppProperties(props, sourceXml) {
-  const doc = parseXml(sourceXml ?? EMPTY_APP, { label: "app properties" });
-  const root = doc.documentElement;
-  const prior = parseAppProperties(sourceXml);
+  const xml = sourceXml ?? EMPTY_APP;
+  const root = parseXml(xml, { label: "app properties" }).documentElement;
+  const ns = namespacesOf(root);
+  if (!ns) throw new Error("app properties root is not an extended-properties element");
+  const patch = new PartPatch(xml, root);
+  const prior = readKnown(root, ns);
+  const ownPrefix = root.prefix ? `${root.prefix}:` : "";
   FIELDS2.forEach(([field, local, kind], index) => {
     const value = props[field];
-    const existing = first(root, local, NS.extendedProperties);
+    const existing = first(root, local, ns.app);
     if (value === void 0 || kind === "text" && value === "") {
-      if (existing && (existing.textContent ?? "") !== "") root.removeChild(existing);
+      if (existing && (existing.textContent ?? "") !== "") patch.remove(existing);
       return;
     }
     if (existing && same(prior[field], value)) return;
-    let element = existing;
-    if (!element) {
-      element = doc.createElementNS(NS.extendedProperties, local);
-      const next = FIELDS2.slice(index + 1).map(([, name]) => first(root, name, NS.extendedProperties)).find((node) => node !== void 0);
-      root.insertBefore(element, next ?? null);
+    const vt = kind === "pairs" || kind === "titles" ? patch.prefix(ns.vt, "vt") : "";
+    const body = content(kind, value, vt);
+    if (existing) {
+      patch.setContent(existing, body);
+      return;
     }
-    fill(doc, element, kind, value);
+    const next = FIELDS2.slice(index + 1).map(([, name]) => first(root, name, ns.app)).find((node) => node !== void 0);
+    patch.insert(`<${ownPrefix}${local}>${body}</${ownPrefix}${local}>`, next);
   });
-  const out = buildXml(doc);
-  return out.startsWith("<?xml") ? out : `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-${out}`;
+  return patch.toString();
 }
 
 // opc/properties/custom.ts
@@ -673,6 +887,74 @@ function writeCustomProperties(properties) {
   return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Properties xmlns="${NS.customProperties}" xmlns:vt="${NS.vt}">${body}</Properties>`;
 }
+function parseCustomPropertyTexts(xml) {
+  if (!xml) return [];
+  const root = parseXml(xml, { label: "custom properties" }).documentElement;
+  const out = [];
+  for (const property of children(root, "property", NS.customProperties)) {
+    const name = property.getAttribute("name") ?? "";
+    if (!name) continue;
+    const variant = elements(property)[0];
+    const pid = Number.parseInt(property.getAttribute("pid") ?? "", 10);
+    out.push({
+      name,
+      type: variant && isVt(variant) ? variant.localName : "",
+      text: variant?.textContent ?? "",
+      ...Number.isFinite(pid) ? { pid } : {}
+    });
+  }
+  return out;
+}
+var INT32 = /^-?\d+$/;
+function customPropertyFromText(name, type, text) {
+  switch (type) {
+    case "lpwstr":
+    case "filetime":
+      return { name, type, value: text };
+    case "i4": {
+      const value = Number.parseInt(text, 10);
+      if (INT32.test(text) && String(value) === text && value === (value | 0))
+        return { name, type, value };
+      break;
+    }
+    case "r8": {
+      const value = Number(text);
+      if (text.trim() !== "" && String(value) === text) return { name, type, value };
+      break;
+    }
+    case "bool":
+      if (text === "true" || text === "false") return { name, type, value: text === "true" };
+      break;
+    default:
+      if (!/^[A-Za-z][A-Za-z0-9]*$/.test(type)) return { name, type: "lpwstr", value: text };
+  }
+  return { name, type: "raw", xml: `<vt:${type}>${escape(text)}</vt:${type}>` };
+}
+
+// opc/properties/title-groups.ts
+function titleGroups(headingPairs, titlesOfParts) {
+  let offset = 0;
+  return headingPairs.map((pair) => {
+    const count = Math.max(0, pair.count);
+    const titles = titlesOfParts.slice(offset, offset + count);
+    offset += count;
+    return { name: pair.name, titles };
+  });
+}
+function fromTitleGroups(groups) {
+  return {
+    headingPairs: groups.map((group) => ({ name: group.name, count: group.titles.length })),
+    titlesOfParts: groups.flatMap((group) => group.titles)
+  };
+}
+function replaceTitleGroup(headingPairs, titlesOfParts, group) {
+  const match = group.match ?? ((name) => name === group.name);
+  const groups = titleGroups(headingPairs, titlesOfParts);
+  const target = groups.find((entry) => match(entry.name));
+  if (target) target.titles = [...group.titles];
+  else groups.push({ name: group.name, titles: [...group.titles] });
+  return fromTitleGroups(groups);
+}
 
 // opc/signature/index.ts
 var signature_exports = {};
@@ -872,12 +1154,12 @@ async function verifySignatureDigests(signature, getPartContent) {
     } else {
       continue;
     }
-    const content = await getPartContent(ref.uri);
-    if (!content) {
+    const content2 = await getPartContent(ref.uri);
+    if (!content2) {
       continue;
     }
     try {
-      const digest = await crypto.subtle.digest(hashAlgo, content);
+      const digest = await crypto.subtle.digest(hashAlgo, content2);
       const digestBase64 = arrayBufferToBase64(digest);
       if (digestBase64 !== ref.digestValue) {
         return "invalid";
@@ -986,7 +1268,7 @@ function resolveReferenceUriToPart(uri) {
 }
 
 // opc/signature/digest.ts
-async function computeDigestBase64(content, digestAlgorithmUri) {
+async function computeDigestBase64(content2, digestAlgorithmUri) {
   const webCryptoAlgo = DIGEST_ALGORITHM_TO_WEB_CRYPTO[digestAlgorithmUri];
   if (!webCryptoAlgo) {
     return void 0;
@@ -994,8 +1276,8 @@ async function computeDigestBase64(content, digestAlgorithmUri) {
   if (typeof globalThis.crypto?.subtle === "undefined") {
     return void 0;
   }
-  const buf = new ArrayBuffer(content.byteLength);
-  new Uint8Array(buf).set(content);
+  const buf = new ArrayBuffer(content2.byteLength);
+  new Uint8Array(buf).set(content2);
   const digest = await globalThis.crypto.subtle.digest(webCryptoAlgo, buf);
   return uint8ArrayToBase64(new Uint8Array(digest));
 }
@@ -1062,4 +1344,4 @@ function computeVerificationStatus(details) {
   return hasInvalidSignature ? "signature-invalid" : hasRevoked ? "certificate-revoked" : hasTimestampInvalid ? "timestamp-invalid" : hasTimestampUntrusted ? "timestamp-untrusted" : hasMissing ? "reference-missing" : hasMismatch ? "digest-mismatch" : allVerified ? "verified-trusted" : hasUntrusted ? "verified-untrusted" : "present-not-verified";
 }
 
-export { CORE_PROPERTY_FIELDS, CUSTOM_PROPERTIES_FMTID, PROPERTY_CONTENT_TYPES, PROPERTY_PART_NAMES, RELATIONSHIP_TYPES, allocateCustomPropertyIds, buildContentTypesXml, buildRelationshipsXml, clonePartGraph, contentTypeForPart, ensureContentTypeDefault, ensureContentTypeOverride, ensureRelationship, findOfficeDocumentPart, getRelationshipId, hyperlinkPolicy, isOpenableHyperlinkHref, isSafeHyperlinkHref, isStorableHyperlinkHref, nextRelationshipId, parseAppProperties, parseContentTypes, parseCoreProperties, parseCustomProperties, parseRelationships, relationshipsPartFor, relativePartTarget, resolvePartPath, signature_exports as signature, writeAppProperties, writeCoreProperties, writeCustomProperties };
+export { CORE_PROPERTY_FIELDS, CUSTOM_PROPERTIES_FMTID, PROPERTY_CONTENT_TYPES, PROPERTY_PART_NAMES, RELATIONSHIP_TYPES, STRICT_APP_NAMESPACES, allocateCustomPropertyIds, buildContentTypesXml, buildRelationshipsXml, clonePartGraph, contentTypeForPart, customPropertyFromText, ensureContentTypeDefault, ensureContentTypeOverride, ensureRelationship, findOfficeDocumentPart, formatW3cdtf, fromTitleGroups, getRelationshipId, hyperlinkPolicy, isOpenableHyperlinkHref, isSafeHyperlinkHref, isStorableHyperlinkHref, listEmbeddedPackages, nextRelationshipId, parseAppProperties, parseContentTypes, parseCoreProperties, parseCustomProperties, parseCustomPropertyTexts, parseRelationships, relationshipsPartFor, relativePartTarget, replaceEmbeddedPackage, replaceTitleGroup, resolvePartPath, signature_exports as signature, titleGroups, writeAppProperties, writeCoreProperties, writeCustomProperties };

package/dist/opc/properties/app.d.ts

@@ -1,10 +1,16 @@
 import type { AppProperties } from './types.js';
-/** Reads the known fields of `docProps/app.xml`. */
+/** ISO/IEC 29500 Strict names of the extended-properties and variant-type namespaces. */
+export declare const STRICT_APP_NAMESPACES: {
+    readonly extendedProperties: 'http://purl.oclc.org/ooxml/officeDocument/extendedProperties';
+    readonly vt: 'http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes';
+};
+/** Reads the known fields of `docProps/app.xml` (Transitional or Strict). */
 export declare function parseAppProperties(xml: string | undefined): AppProperties;
 /**
  * Writes `docProps/app.xml`. With `sourceXml` the source part is patched: an element whose
- * value is unchanged is left byte for byte, a changed one is rewritten, an unset one removed,
- * and every element the model does not know (statistics, `DigSig`, `HLinks`...) is kept.
+ * value is unchanged is left byte for byte, a changed one has its content rewritten, an unset
+ * one is removed, and everything the model does not know (`DigSig`, `HLinks`...) is kept
+ * exactly (see `PartPatch`). A Strict source is written in its own namespaces.
  */
 export declare function writeAppProperties(props: AppProperties, sourceXml?: string): string;
 //# sourceMappingURL=app.d.ts.map

package/dist/opc/properties/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../opc/properties/app.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,SAAS,CAAC;AAuD1D,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAWzE;AAmCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA2BnF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../opc/properties/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,SAAS,CAAC;AAsC1D,yFAAyF;AACzF,eAAO,MAAM,qBAAqB;aACjC,kBAAkB,EAAE,8DAA8D;aAClF,EAAE,EAAE,0DAA0D;CACrD,CAAC;AAsDX,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAKzE;AAqBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BnF"}

package/dist/opc/properties/core.d.ts

@@ -4,9 +4,13 @@ type CoreField = keyof CoreProperties;
 export declare const CORE_PROPERTY_FIELDS: readonly CoreField[];
 /** Reads `docProps/core.xml`. Empty elements count as unset; text is not trimmed. */
 export declare function parseCoreProperties(xml: string | undefined): CoreProperties;
+/** `date` as W3CDTF at second precision in UTC (`2026-10-08T09:30:00Z`), as Office writes it. */
+export declare const formatW3cdtf: (date: Date) => string;
 /**
  * Writes `docProps/core.xml`. With `sourceXml` the source part is patched: known fields are
- * set, replaced or removed to match `props`, and every element the model does not know is kept.
+ * set, replaced or removed to match `props`, and everything else is kept byte for byte (see
+ * `PartPatch`). A date that is written carries `xsi:type="dcterms:W3CDTF"` as ECMA-376 Part 2
+ * requires, and any `xsi` or `dcterms` declaration that needs is added to the root.
  */
 export declare function writeCoreProperties(props: CoreProperties, sourceXml?: string): string;
 export {};

package/dist/opc/properties/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../opc/properties/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,KAAK,SAAS,GAAG,MAAM,cAAc,CAAC;AAqBtC,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,SAAS,SAAS,EAAmC,CAAC;AAMzF,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAS3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAsBrF"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../opc/properties/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,KAAK,SAAS,GAAG,MAAM,cAAc,CAAC;AAqBtC,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAAE,SAAS,SAAS,EAAmC,CAAC;AAMzF,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAS3E;AAED,iGAAiG;AACjG,eAAO,MAAM,YAAY,SAAU,IAAI,KAAG,MAAsD,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBrF"}

package/dist/opc/properties/custom.d.ts

@@ -12,4 +12,23 @@ export declare function allocateCustomPropertyIds(properties: readonly CustomPro
  * a later duplicate is dropped.
  */
 export declare function writeCustomProperties(properties: readonly CustomProperty[]): string | undefined;
+/**
+ * A custom property seen as text, for editors that show every variant type as a string: the
+ * variant element's local name (`lpwstr`, `i4`, `ui4`, `lpstr`...) and its text content.
+ */
+export interface CustomPropertyText {
+    name: string;
+    type: string;
+    text: string;
+    pid?: number;
+}
+/** Reads `docProps/custom.xml` as text; `type` is empty for a value outside the `vt` namespace. */
+export declare function parseCustomPropertyTexts(xml: string | undefined): CustomPropertyText[];
+/**
+ * The property `name` holding `text` as a `vt:<type>` value. It is typed when the text survives
+ * the typed value unchanged (`i4` `42`, `r8` `2.5`, `bool` `true`), and raw otherwise (`i4`
+ * `042`, `ui4`, `lpstr`...), so the written text is always exactly `text`. An unusable type
+ * name falls back to `lpwstr`.
+ */
+export declare function customPropertyFromText(name: string, type: string, text: string): CustomProperty;
 //# sourceMappingURL=custom.d.ts.map

package/dist/opc/properties/custom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../opc/properties/custom.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAkCvE,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,EAAE,CAuB/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAUzF;AAmBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAoB/F"}
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../../opc/properties/custom.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAkCvE,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,EAAE,CAuB/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAUzF;AAmBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAoB/F;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,mGAAmG;AACnG,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,EAAE,CAiBtF;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAuB/F"}

package/dist/opc/properties/index.d.ts

@@ -1,5 +1,8 @@
 export * from './types.js';
-export { CORE_PROPERTY_FIELDS, parseCoreProperties, writeCoreProperties } from './core.js';
-export { parseAppProperties, writeAppProperties } from './app.js';
-export { allocateCustomPropertyIds, parseCustomProperties, writeCustomProperties, } from './custom.js';
+export { CORE_PROPERTY_FIELDS, formatW3cdtf, parseCoreProperties, writeCoreProperties, } from './core.js';
+export { STRICT_APP_NAMESPACES, parseAppProperties, writeAppProperties } from './app.js';
+export { allocateCustomPropertyIds, customPropertyFromText, parseCustomProperties, parseCustomPropertyTexts, writeCustomProperties, } from './custom.js';
+export type { CustomPropertyText } from './custom.js';
+export { fromTitleGroups, replaceTitleGroup, titleGroups } from './title-groups.js';
+export type { TitleGroup } from './title-groups.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/opc/properties/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../opc/properties/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EACN,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../opc/properties/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}