ooxml-core 1.22.0 → 1.24.0

package/dist/automation/index.mjs

@@ -58139,7 +58139,7 @@ function isValidSpinCount(spinCount, maxSpinCount = DEFAULT_MAX_SPIN_COUNT) {
   const limit3 = Math.min(maxSpinCount, MAX_SPIN_COUNT);
   return spinCount === void 0 || Number.isInteger(spinCount) && spinCount >= 0 && spinCount <= limit3;
 }
-function spinPasswordHash(password, salt, spinCount, digest) {
+function spinPasswordHash(password, salt, spinCount, digest2) {
   const input2 = new Uint8Array(salt.length + password.length * 2);
   input2.set(salt);
   for (let i2 = 0; i2 < password.length; i2++) {
@@ -58147,21 +58147,21 @@ function spinPasswordHash(password, salt, spinCount, digest) {
     input2[salt.length + i2 * 2] = code & 255;
     input2[salt.length + i2 * 2 + 1] = code >> 8;
   }
-  let value3 = digest(input2);
+  let value3 = digest2(input2);
   const buffer = new Uint8Array(value3.length + 4);
   const view = new DataView(buffer.buffer);
   for (let i2 = 0; i2 < spinCount; i2++) {
     buffer.set(value3);
     view.setUint32(value3.length, i2, true);
-    value3 = digest(buffer);
+    value3 = digest2(buffer);
   }
   return value3;
 }
 function hashBytes(password, { algorithmName, saltValue, spinCount }, limits) {
-  const digest = digestFunction(algorithmName);
+  const digest2 = digestFunction(algorithmName);
   const salt = decodeBase64(saltValue);
-  if (!digest || !salt || !isValidSpinCount(spinCount, limits.maxSpinCount)) return void 0;
-  return spinPasswordHash(password, salt, spinCount ?? 0, digest);
+  if (!digest2 || !salt || !isValidSpinCount(spinCount, limits.maxSpinCount)) return void 0;
+  return spinPasswordHash(password, salt, spinCount ?? 0, digest2);
 }
 function verifyPasswordHash(password, hash2, limits = {}) {
   if (!digestFunction(hash2.algorithmName)) return void 0;
@@ -61223,6 +61223,7 @@ var VisioPackage = class _VisioPackage {
   relationshipCache = /* @__PURE__ */ new Map();
   byteCache = /* @__PURE__ */ new Map();
   decodedNames = /* @__PURE__ */ new Map();
+  noted;
   totalOutput = 0;
   totalXmlNodes = 0;
   check = () => {
@@ -61257,7 +61258,26 @@ var VisioPackage = class _VisioPackage {
       );
     }
   }
+  /**
+   * Starts noting every part this package is asked about (read, listed in a relationship, or
+   * checked for). The returned function stops noting and gives each part with a print of its
+   * declared CRC-32 and size (empty when absent), which is what {@link printOf} compares.
+   */
+  record() {
+    const noted = /* @__PURE__ */ new Set();
+    this.noted = noted;
+    return () => {
+      if (this.noted === noted) this.noted = void 0;
+      return [...noted].sort().map((path3) => [path3, this.printOf(path3)]);
+    };
+  }
+  /** The declared CRC-32 and size of a part, or an empty string when the package lacks it. */
+  printOf(path3) {
+    const entry3 = this.entries.get(path3);
+    return entry3 && !entry3.directory ? `${entry3.crc}:${entry3.size}` : "";
+  }
   has(path3) {
+    this.noted?.add(path3);
     return this.entries.get(path3)?.directory === false;
   }
   paths() {
@@ -61265,6 +61285,7 @@ var VisioPackage = class _VisioPackage {
   }
   async readXml(path3, expectedRoot) {
     this.check();
+    this.noted?.add(path3);
     safePath(path3);
     let pending2 = this.cache.get(path3);
     if (!pending2) {
@@ -61280,6 +61301,7 @@ var VisioPackage = class _VisioPackage {
   /** Validated declared size, so resource-specific limits can reject before inflation. */
   getPartByteLength(path3) {
     this.check();
+    this.noted?.add(path3);
     safePath(path3);
     const entry3 = this.entries.get(path3);
     if (!entry3 || entry3.directory) fail3("MISSING_PART", `Missing package part: ${path3}`);
@@ -61288,6 +61310,7 @@ var VisioPackage = class _VisioPackage {
   /** Shared package-owned bytes. Treat the returned buffer as immutable. */
   async readBytes(path3) {
     this.check();
+    this.noted?.add(path3);
     safePath(path3);
     let pending2 = this.byteCache.get(path3);
     if (!pending2) {
@@ -61381,6 +61404,10 @@ var VisioPackage = class _VisioPackage {
   }
   async relationships(sourcePart) {
     this.check();
+    if (this.noted && sourcePart) {
+      const slash = sourcePart.lastIndexOf("/");
+      this.noted.add(`${sourcePart.slice(0, slash + 1)}_rels/${sourcePart.slice(slash + 1)}.rels`);
+    } else this.noted?.add("_rels/.rels");
     let pending2 = this.relationshipCache.get(sourcePart);
     if (!pending2) {
       pending2 = this.loadRelationships(sourcePart);
@@ -61414,6 +61441,7 @@ var VisioPackage = class _VisioPackage {
       const actual = mode === "Internal" ? this.decodedNames.get(resolved) : void 0;
       if (mode === "Internal" && !actual)
         fail3("INVALID_RELATIONSHIP", `Missing relationship target: ${resolved}`);
+      if (actual) this.noted?.add(actual);
       result2.set(id4, { id: id4, type, target: actual ?? resolved, mode });
     }
     return result2;
@@ -67768,6 +67796,10 @@ function createLayerBudget() {
       memberships += count3;
       if (memberships > 1e5)
         throw new VisioPackageError("METADATA_LIMIT", "Layer membership budget exceeded.");
+    },
+    state: () => [memberships, characters],
+    restore(state) {
+      [memberships, characters] = state;
     }
   };
 }
@@ -67839,97 +67871,6 @@ function shapeLayers(sheet2, layers, report, budget = createLayerBudget()) {
   };
 }
 
-// visio/theme.ts
-var VISIO_SCHEME_SLOTS = [
-  "dk1",
-  "lt1",
-  "accent1",
-  "accent2",
-  "accent3",
-  "accent4",
-  "accent5",
-  "accent6"
-];
-var componentId = (node4) => integer5(themeChild(node4, "schemeID", THEME_NS)?.getAttribute("schemeEnum"));
-async function loadVisioThemes(pkg, source2, report) {
-  const result2 = [];
-  for (const rel of (await pkg.relationships(source2)).values()) {
-    if (rel.type !== "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" || rel.mode === "External")
-      continue;
-    const root = await pkg.readXml(rel.target, "theme");
-    if (root.namespaceURI !== DRAWING_NS) {
-      report("unsupported-theme", "A theme uses an unsupported XML namespace.", {
-        part: rel.target
-      });
-      continue;
-    }
-    const base3 = themeChild(root, "themeElements");
-    const palette = themeChild(base3, "clrScheme");
-    const scheme = parseTheme(root).colorScheme.colors;
-    const colors = /* @__PURE__ */ new Map();
-    for (const name4 of VISIO_SCHEME_SLOTS) {
-      const color3 = scheme[name4];
-      if (color3 && parsedColorChoice(themeChild(palette, name4))) colors.set(name4, color3);
-    }
-    const background2 = parsedColorChoice(extension(palette, "bkgnd"));
-    if (background2) colors.set("bkgnd", background2);
-    const variants = themeChildren(
-      extension(palette, "variationClrSchemeLst"),
-      "variationClrScheme",
-      THEME_NS
-    ).slice(0, 4).map((variant) => {
-      const entries = /* @__PURE__ */ new Map();
-      for (let index4 = 1; index4 <= 7; index4++) {
-        const choice2 = parsedColorChoice(themeChild(variant, `varColor${index4}`, THEME_NS));
-        if (choice2) entries.set(String(index4), choice2);
-      }
-      return entries;
-    });
-    const format8 = themeChild(base3, "fmtScheme");
-    const connector2 = extension(base3, "fmtConnectorScheme");
-    const fonts = extension(base3, "fontStylesGroup");
-    const name3 = root.getAttribute("name");
-    result2.push({
-      ...name3 ? { name: name3.slice(0, 256) } : {},
-      colorId: integer5(extension(palette, "schemeID")?.getAttribute("schemeEnum")),
-      effectId: componentId(extension(base3, "fmtSchemeEx")),
-      connectorId: componentId(extension(base3, "fmtConnectorSchemeEx")),
-      colors,
-      variants,
-      variationStyles: themeChildren(
-        extension(base3, "variationStyleSchemeLst"),
-        "variationStyleScheme",
-        THEME_NS
-      ).slice(0, 4).map((variant) => themeChildren(variant, "varStyle", THEME_NS).slice(0, 4)),
-      fills: formatList(format8, "fillStyleLst"),
-      effects: themeChildren(themeChild(format8, "effectStyleLst"), "effectStyle").slice(0, 6),
-      lines: themeChildren(themeChild(format8, "lnStyleLst"), "ln").slice(0, 6),
-      fonts: themeChildren(themeChild(fonts, "fontStyles", THEME_NS), "fontProps", THEME_NS).slice(
-        0,
-        6
-      ),
-      connectorFills: formatList(connector2, "fillStyleLst"),
-      connectorEffects: themeChildren(themeChild(connector2, "effectStyleLst"), "effectStyle").slice(
-        0,
-        6
-      ),
-      connectorLines: themeChildren(themeChild(connector2, "lnStyleLst"), "ln").slice(0, 6),
-      connectorFonts: themeChildren(
-        themeChild(fonts, "connectorFontStyles", THEME_NS),
-        "fontProps",
-        THEME_NS
-      ).slice(0, 6)
-    });
-  }
-  return result2;
-}
-function formatList(parent, name3) {
-  const list2 = themeChild(parent, name3);
-  return list2 ? Array.from(list2.childNodes).filter(
-    (node4) => node4.nodeType === 1 && node4.namespaceURI === DRAWING_NS
-  ).slice(0, 6) : [];
-}
-
 // visio/theme-builtins.ts
 var VISIO_BUILT_IN_THEME_IDS = [
   "office",
@@ -68093,6 +68034,346 @@ function diagnosticCollector(maxCount) {
   };
 }
 
+// visio/print-settings.ts
+var NAMES = [
+  "PaperKind",
+  "PrintPageOrientation",
+  "PageLeftMargin",
+  "PageRightMargin",
+  "PageTopMargin",
+  "PageBottomMargin",
+  "ScaleX",
+  "ScaleY",
+  "OnPage",
+  "PagesX",
+  "PagesY",
+  "CenterX",
+  "CenterY"
+];
+var BOOLEAN = /* @__PURE__ */ new Set(["OnPage", "CenterX", "CenterY"]);
+var LENGTH = /* @__PURE__ */ new Set(["PageLeftMargin", "PageRightMargin", "PageTopMargin", "PageBottomMargin"]);
+var CANONICAL = new Map(
+  [...NAMES, "PageWidth", "PageHeight", "PageScale", "DrawingScale"].map((name3) => [
+    name3.toLowerCase(),
+    name3
+  ])
+);
+function indexCells(sheet2) {
+  const cells3 = /* @__PURE__ */ new Map();
+  let duplicate = false;
+  for (const node4 of children3(sheet2, "Cell")) {
+    const name3 = attribute3(node4, "N") ?? "", canonical3 = CANONICAL.get(name3.toLowerCase());
+    if (!canonical3) continue;
+    if (canonical3 !== name3) duplicate = true;
+    const values2 = cells3.get(canonical3) ?? [];
+    if (values2.length < 2) values2.push(node4);
+    cells3.set(canonical3, values2);
+    if (values2.length > 1) duplicate = true;
+  }
+  return { cells: cells3, duplicate };
+}
+function createVisioPrintSettingsReader(documentSheets, rootStyles) {
+  const indexes2 = { document: indexCells(documentSheets[0]), root: indexCells(rootStyles[0]) };
+  return (pageSheets) => readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes2);
+}
+function readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes2) {
+  let refusal;
+  const refuse4 = (reason) => {
+    refusal ??= reason;
+  };
+  if (pageSheets.length !== 1) refuse4("ambiguous-page-sheet");
+  if (documentSheets.length > 1) refuse4("ambiguous-document-sheet");
+  if (!documentSheets.length) refuse4("missing-setting");
+  if (rootStyles.length > 1) refuse4("duplicate-setting");
+  const root = rootStyles[0];
+  if (!root || attribute3(root, "ID") !== "0" || attribute3(root, "NameU") !== "No Style")
+    refuse4("unsupported-print-style");
+  for (const sheet2 of [...pageSheets, ...documentSheets])
+    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+      if (attribute3(sheet2, name3) !== "0") refuse4("unsupported-print-style");
+  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+    if (attribute3(root, name3) !== void 0) refuse4("unsupported-print-style");
+  const localIndex = indexCells(pageSheets[0]), rootIndex = indexes2?.root ?? indexCells(root);
+  const documentIndex = indexes2?.document ?? indexCells(documentSheets[0]);
+  if (localIndex.duplicate || rootIndex.duplicate || documentIndex.duplicate)
+    refuse4("duplicate-setting");
+  const local = localIndex.cells, inherited = rootIndex.cells;
+  const read = (node4, name3, origin) => {
+    const invalid3 = () => {
+      refuse4(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
+      return void 0;
+    };
+    if (node4.hasAttribute("E")) return invalid3();
+    let raw2 = (attribute3(node4, "V") ?? "").trim();
+    if (!raw2 || raw2.length > 128) return invalid3();
+    if (BOOLEAN.has(name3)) {
+      if (!["0", "1", "false", "true"].includes(raw2)) return invalid3();
+      raw2 = raw2 === "true" ? "1" : raw2 === "false" ? "0" : raw2;
+    }
+    try {
+      const value3 = visioFormulaCachedValue(raw2, attribute3(node4, "U"));
+      const length = LENGTH.has(name3) || /^(PageWidth|PageHeight|PageScale|DrawingScale)$/.test(name3);
+      if (!["scalar", ...length ? ["length"] : []].includes(value3.unit) || Math.abs(value3.value) > 1e9)
+        return invalid3();
+      const formula = attribute3(node4, "F");
+      if (formula !== void 0) {
+        const source2 = formula.trim();
+        if (/^(true|false)$/i.test(source2)) {
+          if ((source2.toLowerCase() === "true" ? 1 : 0) !== value3.value) return invalid3();
+        } else {
+          if (!source2 || source2 === "Inh") return invalid3();
+          const limits = { maxLength: 512, maxNodes: 64, maxDepth: 16, maxSteps: 128 };
+          const analysis = analyzeVisioFormula(source2, limits);
+          if (analysis.dynamic || analysis.guarded || analysis.references.length || analysis.unsupportedFunctions.length) {
+            refuse4("dynamic-setting");
+            return void 0;
+          }
+          const evaluated = evaluateVisioFormula(
+            source2,
+            () => {
+              throw new Error("Unexpected reference");
+            },
+            limits
+          );
+          if (evaluated.value !== value3.value || !["scalar", ...length ? ["length"] : []].includes(evaluated.unit))
+            return invalid3();
+        }
+      }
+      return value3.value;
+    } catch {
+      return invalid3();
+    }
+  };
+  const values2 = /* @__PURE__ */ new Map();
+  for (const name3 of NAMES) {
+    const nodes = local.get(name3) ?? inherited.get(name3);
+    if (!nodes?.length) continue;
+    if (nodes.length !== 1) continue;
+    const value3 = read(nodes[0], name3, local.has(name3) ? "local" : "document");
+    if (value3 !== void 0) values2.set(name3, value3);
+  }
+  for (const name3 of ["PageWidth", "PageHeight", "PageScale", "DrawingScale"]) {
+    const nodes = local.get(name3);
+    if (!nodes || nodes.length !== 1 || !(read(nodes[0], name3, "local") > 0))
+      refuse4("unusable-drawing-scale");
+  }
+  const setup = {};
+  const paper = values2.get("PaperKind");
+  if (paper !== void 0 && Number.isSafeInteger(paper) && paper >= 0 && paper <= 65535)
+    setup.paperKind = paper;
+  else if (paper !== void 0)
+    refuse4(local.has("PaperKind") ? "invalid-local-setting" : "invalid-document-setting");
+  const orientation = values2.get("PrintPageOrientation");
+  if (orientation === 0 || orientation === 1 || orientation === 2)
+    setup.printPageOrientation = orientation;
+  else if (orientation !== void 0)
+    refuse4(
+      local.has("PrintPageOrientation") ? "invalid-local-setting" : "invalid-document-setting"
+    );
+  const margins = ["Left", "Right", "Top", "Bottom"].map((side2) => values2.get(`Page${side2}Margin`));
+  if (margins.every((n) => n !== void 0 && n >= 0 && n <= 1e3))
+    setup.margins = {
+      left: margins[0],
+      right: margins[1],
+      top: margins[2],
+      bottom: margins[3]
+    };
+  else if (margins.some((n) => n !== void 0 && (n < 0 || n > 1e3)))
+    refuse4("unusable-print-area");
+  for (const [name3, key2] of [
+    ["ScaleX", "printZoom"],
+    ["ScaleY", "printZoomY"],
+    ["PagesX", "printPagesAcross"],
+    ["PagesY", "printPagesDown"]
+  ]) {
+    const value3 = values2.get(name3);
+    if (value3 !== void 0) {
+      if ((name3 === "PagesX" || name3 === "PagesY") && (!Number.isSafeInteger(value3) || value3 < 1))
+        refuse4(local.has(name3) ? "invalid-local-setting" : "invalid-document-setting");
+      else setup[key2] = value3;
+    }
+  }
+  for (const [name3, key2] of [
+    ["OnPage", "printFitToPages"],
+    ["CenterX", "printCenterX"],
+    ["CenterY", "printCenterY"]
+  ]) {
+    const value3 = values2.get(name3);
+    if (value3 !== void 0) setup[key2] = value3 === 1;
+  }
+  if (refusal) setup.printCountRefusal = refusal;
+  return setup;
+}
+
+// visio/theme.ts
+var VISIO_SCHEME_SLOTS = [
+  "dk1",
+  "lt1",
+  "accent1",
+  "accent2",
+  "accent3",
+  "accent4",
+  "accent5",
+  "accent6"
+];
+var componentId = (node4) => integer5(themeChild(node4, "schemeID", THEME_NS)?.getAttribute("schemeEnum"));
+async function loadVisioThemes(pkg, source2, report) {
+  const result2 = [];
+  for (const rel of (await pkg.relationships(source2)).values()) {
+    if (rel.type !== "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" || rel.mode === "External")
+      continue;
+    const root = await pkg.readXml(rel.target, "theme");
+    if (root.namespaceURI !== DRAWING_NS) {
+      report("unsupported-theme", "A theme uses an unsupported XML namespace.", {
+        part: rel.target
+      });
+      continue;
+    }
+    const base3 = themeChild(root, "themeElements");
+    const palette = themeChild(base3, "clrScheme");
+    const scheme = parseTheme(root).colorScheme.colors;
+    const colors = /* @__PURE__ */ new Map();
+    for (const name4 of VISIO_SCHEME_SLOTS) {
+      const color3 = scheme[name4];
+      if (color3 && parsedColorChoice(themeChild(palette, name4))) colors.set(name4, color3);
+    }
+    const background2 = parsedColorChoice(extension(palette, "bkgnd"));
+    if (background2) colors.set("bkgnd", background2);
+    const variants = themeChildren(
+      extension(palette, "variationClrSchemeLst"),
+      "variationClrScheme",
+      THEME_NS
+    ).slice(0, 4).map((variant) => {
+      const entries = /* @__PURE__ */ new Map();
+      for (let index4 = 1; index4 <= 7; index4++) {
+        const choice2 = parsedColorChoice(themeChild(variant, `varColor${index4}`, THEME_NS));
+        if (choice2) entries.set(String(index4), choice2);
+      }
+      return entries;
+    });
+    const format8 = themeChild(base3, "fmtScheme");
+    const connector2 = extension(base3, "fmtConnectorScheme");
+    const fonts = extension(base3, "fontStylesGroup");
+    const name3 = root.getAttribute("name");
+    result2.push({
+      ...name3 ? { name: name3.slice(0, 256) } : {},
+      colorId: integer5(extension(palette, "schemeID")?.getAttribute("schemeEnum")),
+      effectId: componentId(extension(base3, "fmtSchemeEx")),
+      connectorId: componentId(extension(base3, "fmtConnectorSchemeEx")),
+      colors,
+      variants,
+      variationStyles: themeChildren(
+        extension(base3, "variationStyleSchemeLst"),
+        "variationStyleScheme",
+        THEME_NS
+      ).slice(0, 4).map((variant) => themeChildren(variant, "varStyle", THEME_NS).slice(0, 4)),
+      fills: formatList(format8, "fillStyleLst"),
+      effects: themeChildren(themeChild(format8, "effectStyleLst"), "effectStyle").slice(0, 6),
+      lines: themeChildren(themeChild(format8, "lnStyleLst"), "ln").slice(0, 6),
+      fonts: themeChildren(themeChild(fonts, "fontStyles", THEME_NS), "fontProps", THEME_NS).slice(
+        0,
+        6
+      ),
+      connectorFills: formatList(connector2, "fillStyleLst"),
+      connectorEffects: themeChildren(themeChild(connector2, "effectStyleLst"), "effectStyle").slice(
+        0,
+        6
+      ),
+      connectorLines: themeChildren(themeChild(connector2, "lnStyleLst"), "ln").slice(0, 6),
+      connectorFonts: themeChildren(
+        themeChild(fonts, "connectorFontStyles", THEME_NS),
+        "fontProps",
+        THEME_NS
+      ).slice(0, 6)
+    });
+  }
+  return result2;
+}
+function formatList(parent, name3) {
+  const list2 = themeChild(parent, name3);
+  return list2 ? Array.from(list2.childNodes).filter(
+    (node4) => node4.nodeType === 1 && node4.namespaceURI === DRAWING_NS
+  ).slice(0, 6) : [];
+}
+
+// visio/document-level.ts
+function optionsKey(options2) {
+  const { metafileConverter: _converter, pages: _pages, documentCache: _cache, ...rest } = options2;
+  return JSON.stringify(rest);
+}
+var cacheMatches = (entry3, pkg, options2) => entry3 !== void 0 && entry3.options === optionsKey(options2) && entry3.converter === options2.metafileConverter && entry3.reads.every(([path3, print]) => pkg.printOf(path3) === print);
+async function readDocumentLevel(pkg, documentPart, options2, checkTime, forward) {
+  const reports = [];
+  const report = (...args) => {
+    reports.push(args);
+    forward(...args);
+  };
+  const documentRoot = await visioXml(pkg, documentPart, "VisioDocument");
+  const resources = {
+    colors: /* @__PURE__ */ new Map(),
+    fonts: /* @__PURE__ */ new Map(),
+    themes: await loadVisioThemes(pkg, documentPart, report)
+  };
+  for (const color3 of children3(child6(documentRoot, "Colors"), "ColorEntry"))
+    resources.colors.set(attribute3(color3, "IX") ?? "", attribute3(color3, "RGB") ?? "");
+  const faceNames = children3(child6(documentRoot, "FaceNames"), "FaceName");
+  if (faceNames.length > 1e4)
+    throw new VisioPackageError(
+      "METADATA_LIMIT",
+      "Document font count exceeds its metadata limit."
+    );
+  let fontCharacters = 0;
+  faceNames.forEach((font, index4) => {
+    checkTime();
+    fontCharacters += (attribute3(font, "Name") ?? attribute3(font, "NameU") ?? "Arial").length;
+    if (fontCharacters > 1e6)
+      throw new VisioPackageError(
+        "METADATA_LIMIT",
+        "Document fonts exceed aggregate metadata limits."
+      );
+    resources.fonts.set(
+      metadata(attribute3(font, "ID") ?? String(index4), 256, "Font ID"),
+      metadata(attribute3(font, "Name") ?? attribute3(font, "NameU") ?? "Arial", 1024, "Font name")
+    );
+  });
+  const styles = /* @__PURE__ */ new Map();
+  for (const style3 of children3(child6(documentRoot, "StyleSheets"), "StyleSheet"))
+    styles.set(metadata(attribute3(style3, "ID") ?? "", 256, "Style ID"), {
+      sheet: readSheet(style3),
+      attributes: metadataAttributes(style3)
+    });
+  const rootStyle = styles.get("0");
+  if (rootStyle?.attributes.get("NameU") === "No Style") resources.rootSheet = rootStyle.sheet;
+  const printStyleGroups = children3(documentRoot, "StyleSheets");
+  const readPrintSettings = createVisioPrintSettingsReader(
+    children3(documentRoot, "DocumentSheet"),
+    printStyleGroups.length === 1 ? children3(printStyleGroups[0], "StyleSheet").filter((node4) => attribute3(node4, "ID") === "0") : []
+  );
+  const masters = /* @__PURE__ */ new Map();
+  const masterRecords = [];
+  const mastersPart = await related(pkg, documentPart, "masters", false);
+  if (mastersPart) {
+    for (const master2 of children3(await visioXml(pkg, mastersPart, "Masters"), "Master")) {
+      const part = await indexedPart(pkg, mastersPart, master2, "master");
+      const id4 = metadata(attribute3(master2, "ID") ?? "", 256, "Master ID");
+      if (!id4 || masters.has(id4))
+        throw new VisioPackageError("INVALID_MASTER_ID", "Master IDs must be present and unique.");
+      const masterShapes2 = readShapes(await visioXml(pkg, part, "MasterContents"));
+      await prepareImages(
+        masterShapes2,
+        pkg,
+        part,
+        report,
+        options2.images,
+        options2.metafileConverter
+      );
+      masters.set(id4, masterShapes2);
+      masterRecords.push({ id: id4, node: master2, shapes: masterShapes2 });
+    }
+  }
+  return { documentRoot, resources, styles, readPrintSettings, masters, masterRecords, reports };
+}
+
 // visio/comments.ts
 var VISIO_COMMENTS_CONTENT_TYPE = "application/vnd.ms-visio.comments+xml";
 var VISIO_COMMENTS_RELATIONSHIP = "http://schemas.microsoft.com/visio/2010/relationships/comments";
@@ -68193,6 +68474,10 @@ function createMetadataBudget(options2 = {}) {
       if (characters > maxCharacters)
         throw new VisioPackageError("METADATA_LIMIT", "Shape metadata character budget exceeded.");
       return value3;
+    },
+    state: () => [rows, characters],
+    restore(state) {
+      [rows, characters] = state;
     }
   };
 }
@@ -69313,177 +69598,6 @@ function readVisioPageSetup(cells3) {
   return Object.keys(result2).length ? result2 : void 0;
 }
 
-// visio/print-settings.ts
-var NAMES = [
-  "PaperKind",
-  "PrintPageOrientation",
-  "PageLeftMargin",
-  "PageRightMargin",
-  "PageTopMargin",
-  "PageBottomMargin",
-  "ScaleX",
-  "ScaleY",
-  "OnPage",
-  "PagesX",
-  "PagesY",
-  "CenterX",
-  "CenterY"
-];
-var BOOLEAN = /* @__PURE__ */ new Set(["OnPage", "CenterX", "CenterY"]);
-var LENGTH = /* @__PURE__ */ new Set(["PageLeftMargin", "PageRightMargin", "PageTopMargin", "PageBottomMargin"]);
-var CANONICAL = new Map(
-  [...NAMES, "PageWidth", "PageHeight", "PageScale", "DrawingScale"].map((name3) => [
-    name3.toLowerCase(),
-    name3
-  ])
-);
-function indexCells(sheet2) {
-  const cells3 = /* @__PURE__ */ new Map();
-  let duplicate = false;
-  for (const node4 of children3(sheet2, "Cell")) {
-    const name3 = attribute3(node4, "N") ?? "", canonical3 = CANONICAL.get(name3.toLowerCase());
-    if (!canonical3) continue;
-    if (canonical3 !== name3) duplicate = true;
-    const values2 = cells3.get(canonical3) ?? [];
-    if (values2.length < 2) values2.push(node4);
-    cells3.set(canonical3, values2);
-    if (values2.length > 1) duplicate = true;
-  }
-  return { cells: cells3, duplicate };
-}
-function createVisioPrintSettingsReader(documentSheets, rootStyles) {
-  const indexes2 = { document: indexCells(documentSheets[0]), root: indexCells(rootStyles[0]) };
-  return (pageSheets) => readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes2);
-}
-function readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes2) {
-  let refusal;
-  const refuse4 = (reason) => {
-    refusal ??= reason;
-  };
-  if (pageSheets.length !== 1) refuse4("ambiguous-page-sheet");
-  if (documentSheets.length > 1) refuse4("ambiguous-document-sheet");
-  if (!documentSheets.length) refuse4("missing-setting");
-  if (rootStyles.length > 1) refuse4("duplicate-setting");
-  const root = rootStyles[0];
-  if (!root || attribute3(root, "ID") !== "0" || attribute3(root, "NameU") !== "No Style")
-    refuse4("unsupported-print-style");
-  for (const sheet2 of [...pageSheets, ...documentSheets])
-    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-      if (attribute3(sheet2, name3) !== "0") refuse4("unsupported-print-style");
-  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-    if (attribute3(root, name3) !== void 0) refuse4("unsupported-print-style");
-  const localIndex = indexCells(pageSheets[0]), rootIndex = indexes2?.root ?? indexCells(root);
-  const documentIndex = indexes2?.document ?? indexCells(documentSheets[0]);
-  if (localIndex.duplicate || rootIndex.duplicate || documentIndex.duplicate)
-    refuse4("duplicate-setting");
-  const local = localIndex.cells, inherited = rootIndex.cells;
-  const read = (node4, name3, origin) => {
-    const invalid3 = () => {
-      refuse4(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
-      return void 0;
-    };
-    if (node4.hasAttribute("E")) return invalid3();
-    let raw2 = (attribute3(node4, "V") ?? "").trim();
-    if (!raw2 || raw2.length > 128) return invalid3();
-    if (BOOLEAN.has(name3)) {
-      if (!["0", "1", "false", "true"].includes(raw2)) return invalid3();
-      raw2 = raw2 === "true" ? "1" : raw2 === "false" ? "0" : raw2;
-    }
-    try {
-      const value3 = visioFormulaCachedValue(raw2, attribute3(node4, "U"));
-      const length = LENGTH.has(name3) || /^(PageWidth|PageHeight|PageScale|DrawingScale)$/.test(name3);
-      if (!["scalar", ...length ? ["length"] : []].includes(value3.unit) || Math.abs(value3.value) > 1e9)
-        return invalid3();
-      const formula = attribute3(node4, "F");
-      if (formula !== void 0) {
-        const source2 = formula.trim();
-        if (/^(true|false)$/i.test(source2)) {
-          if ((source2.toLowerCase() === "true" ? 1 : 0) !== value3.value) return invalid3();
-        } else {
-          if (!source2 || source2 === "Inh") return invalid3();
-          const limits = { maxLength: 512, maxNodes: 64, maxDepth: 16, maxSteps: 128 };
-          const analysis = analyzeVisioFormula(source2, limits);
-          if (analysis.dynamic || analysis.guarded || analysis.references.length || analysis.unsupportedFunctions.length) {
-            refuse4("dynamic-setting");
-            return void 0;
-          }
-          const evaluated = evaluateVisioFormula(
-            source2,
-            () => {
-              throw new Error("Unexpected reference");
-            },
-            limits
-          );
-          if (evaluated.value !== value3.value || !["scalar", ...length ? ["length"] : []].includes(evaluated.unit))
-            return invalid3();
-        }
-      }
-      return value3.value;
-    } catch {
-      return invalid3();
-    }
-  };
-  const values2 = /* @__PURE__ */ new Map();
-  for (const name3 of NAMES) {
-    const nodes = local.get(name3) ?? inherited.get(name3);
-    if (!nodes?.length) continue;
-    if (nodes.length !== 1) continue;
-    const value3 = read(nodes[0], name3, local.has(name3) ? "local" : "document");
-    if (value3 !== void 0) values2.set(name3, value3);
-  }
-  for (const name3 of ["PageWidth", "PageHeight", "PageScale", "DrawingScale"]) {
-    const nodes = local.get(name3);
-    if (!nodes || nodes.length !== 1 || !(read(nodes[0], name3, "local") > 0))
-      refuse4("unusable-drawing-scale");
-  }
-  const setup = {};
-  const paper = values2.get("PaperKind");
-  if (paper !== void 0 && Number.isSafeInteger(paper) && paper >= 0 && paper <= 65535)
-    setup.paperKind = paper;
-  else if (paper !== void 0)
-    refuse4(local.has("PaperKind") ? "invalid-local-setting" : "invalid-document-setting");
-  const orientation = values2.get("PrintPageOrientation");
-  if (orientation === 0 || orientation === 1 || orientation === 2)
-    setup.printPageOrientation = orientation;
-  else if (orientation !== void 0)
-    refuse4(
-      local.has("PrintPageOrientation") ? "invalid-local-setting" : "invalid-document-setting"
-    );
-  const margins = ["Left", "Right", "Top", "Bottom"].map((side2) => values2.get(`Page${side2}Margin`));
-  if (margins.every((n) => n !== void 0 && n >= 0 && n <= 1e3))
-    setup.margins = {
-      left: margins[0],
-      right: margins[1],
-      top: margins[2],
-      bottom: margins[3]
-    };
-  else if (margins.some((n) => n !== void 0 && (n < 0 || n > 1e3)))
-    refuse4("unusable-print-area");
-  for (const [name3, key2] of [
-    ["ScaleX", "printZoom"],
-    ["ScaleY", "printZoomY"],
-    ["PagesX", "printPagesAcross"],
-    ["PagesY", "printPagesDown"]
-  ]) {
-    const value3 = values2.get(name3);
-    if (value3 !== void 0) {
-      if ((name3 === "PagesX" || name3 === "PagesY") && (!Number.isSafeInteger(value3) || value3 < 1))
-        refuse4(local.has(name3) ? "invalid-local-setting" : "invalid-document-setting");
-      else setup[key2] = value3;
-    }
-  }
-  for (const [name3, key2] of [
-    ["OnPage", "printFitToPages"],
-    ["CenterX", "printCenterX"],
-    ["CenterY", "printCenterY"]
-  ]) {
-    const value3 = values2.get(name3);
-    if (value3 !== void 0) setup[key2] = value3 === 1;
-  }
-  if (refusal) setup.printCountRefusal = refusal;
-  return setup;
-}
-
 // visio/page-layout.ts
 var VISIO_GRID_DENSITIES = Object.freeze([0, 2, 4, 8]);
 var VISIO_RULER_DENSITIES = Object.freeze([8, 16, 32]);
@@ -69786,69 +69900,18 @@ async function parseVsdx(input2, options2 = {}) {
         );
     }
   }
-  const documentRoot = await visioXml(pkg, documentPart, "VisioDocument");
-  const resources = {
-    colors: /* @__PURE__ */ new Map(),
-    fonts: /* @__PURE__ */ new Map(),
-    themes: await loadVisioThemes(pkg, documentPart, report)
-  };
-  for (const color3 of children3(child6(documentRoot, "Colors"), "ColorEntry"))
-    resources.colors.set(attribute3(color3, "IX") ?? "", attribute3(color3, "RGB") ?? "");
-  const faceNames = children3(child6(documentRoot, "FaceNames"), "FaceName");
-  if (faceNames.length > 1e4)
-    throw new VisioPackageError(
-      "METADATA_LIMIT",
-      "Document font count exceeds its metadata limit."
-    );
-  let fontCharacters = 0;
-  faceNames.forEach((font, index4) => {
-    checkTime();
-    fontCharacters += (attribute3(font, "Name") ?? attribute3(font, "NameU") ?? "Arial").length;
-    if (fontCharacters > 1e6)
-      throw new VisioPackageError(
-        "METADATA_LIMIT",
-        "Document fonts exceed aggregate metadata limits."
-      );
-    resources.fonts.set(
-      metadata(attribute3(font, "ID") ?? String(index4), 256, "Font ID"),
-      metadata(attribute3(font, "Name") ?? attribute3(font, "NameU") ?? "Arial", 1024, "Font name")
-    );
-  });
-  const styles = /* @__PURE__ */ new Map();
-  for (const style3 of children3(child6(documentRoot, "StyleSheets"), "StyleSheet"))
-    styles.set(metadata(attribute3(style3, "ID") ?? "", 256, "Style ID"), {
-      sheet: readSheet(style3),
-      attributes: metadataAttributes(style3)
-    });
-  const rootStyle = styles.get("0");
-  if (rootStyle?.attributes.get("NameU") === "No Style") resources.rootSheet = rootStyle.sheet;
-  const printStyleGroups = children3(documentRoot, "StyleSheets");
-  const readPrintSettings = createVisioPrintSettingsReader(
-    children3(documentRoot, "DocumentSheet"),
-    printStyleGroups.length === 1 ? children3(printStyleGroups[0], "StyleSheet").filter((node4) => attribute3(node4, "ID") === "0") : []
-  );
-  const masters = /* @__PURE__ */ new Map();
-  const masterRecords = [];
-  const mastersPart = await related(pkg, documentPart, "masters", false);
-  if (mastersPart) {
-    for (const master2 of children3(await visioXml(pkg, mastersPart, "Masters"), "Master")) {
-      const part = await indexedPart(pkg, mastersPart, master2, "master");
-      const id4 = metadata(attribute3(master2, "ID") ?? "", 256, "Master ID");
-      if (!id4 || masters.has(id4))
-        throw new VisioPackageError("INVALID_MASTER_ID", "Master IDs must be present and unique.");
-      const masterShapes2 = readShapes(await visioXml(pkg, part, "MasterContents"));
-      await prepareImages(
-        masterShapes2,
-        pkg,
-        part,
-        report,
-        options2.images,
-        options2.metafileConverter
-      );
-      masters.set(id4, masterShapes2);
-      masterRecords.push({ id: id4, node: master2, shapes: masterShapes2 });
-    }
-  }
+  const cache3 = options2.documentCache;
+  const cached7 = cacheMatches(cache3?.entry, pkg, options2) ? cache3.entry : void 0;
+  const stopRecording = cache3 && !cached7 ? pkg.record() : void 0;
+  let level2;
+  if (cached7) {
+    level2 = cached7.level;
+    for (const args of level2.reports) report(...args);
+  } else level2 = await readDocumentLevel(pkg, documentPart, options2, checkTime, report);
+  const { documentRoot, styles, readPrintSettings, masters, masterRecords } = level2;
+  const resources = { ...level2.resources };
+  delete resources.pageCells;
+  delete resources.fieldContext;
   let geometryCount = 0, textCount = 0, expansionCount = 0, textRuns = 0, paragraphCount = 0;
   const context = {
     metadataBudget: createMetadataBudget(options2.metadata),
@@ -69902,15 +69965,52 @@ async function parseVsdx(input2, options2 = {}) {
         throw new VisioPackageError("TEXT_LIMIT", "Text character limit exceeded.");
     }
   };
-  const documentMasters = listVisioMasters(masterRecords, context, {
-    metadataBudget: createMetadataBudget(options2.metadata),
-    layerBudget: createLayerBudget()
-  });
+  let documentMasters;
+  if (cached7) {
+    const { counters } = cached7.listed;
+    curveWork = counters.curveWork;
+    geometryCount = counters.geometry;
+    textCount = counters.text;
+    expansionCount = counters.expansion;
+    textRuns = counters.textRuns;
+    paragraphCount = counters.paragraphs;
+    context.shapeCount = counters.shapes;
+    context.metadataBudget.restore(counters.metadata);
+    context.layerBudget.restore(counters.layers);
+    documentMasters = cached7.listed.documentMasters;
+  } else {
+    documentMasters = listVisioMasters(masterRecords, context, {
+      metadataBudget: createMetadataBudget(options2.metadata),
+      layerBudget: createLayerBudget()
+    });
+    if (cache3 && stopRecording)
+      cache3.entry = {
+        options: optionsKey(options2),
+        converter: options2.metafileConverter,
+        reads: stopRecording(),
+        level: { ...level2, resources: { ...resources } },
+        listed: {
+          documentMasters,
+          counters: {
+            curveWork,
+            geometry: geometryCount,
+            text: textCount,
+            expansion: expansionCount,
+            textRuns,
+            paragraphs: paragraphCount,
+            shapes: context.shapeCount,
+            metadata: context.metadataBudget.state(),
+            layers: context.layerBudget.state()
+          }
+        }
+      };
+  }
   const pagesPart = await related(pkg, documentPart, "pages", !options2.stencil);
   if (!pagesPart && !options2.stencil)
     throw new VisioPackageError("INVALID_DOCUMENT", "Missing Visio pages part.");
   const pages = [], pageIds2 = /* @__PURE__ */ new Set();
   const comments = [];
+  const only = options2.pages ? new Set(options2.pages) : void 0;
   const pageNodes = pagesPart ? children3(await visioXml(pkg, pagesPart, "Pages"), "Page") : [];
   const foreground = pageNodes.filter((page) => !yes(attribute3(page, "Background")));
   const fieldProperties = await readVisioFieldProperties(pkg);
@@ -69920,6 +70020,7 @@ async function parseVsdx(input2, options2 = {}) {
     if (!id4 || pageIds2.has(id4))
       throw new VisioPackageError("INVALID_PAGE_ID", "Page IDs must be present and unique.");
     pageIds2.add(id4);
+    if (only && !only.has(id4)) continue;
     const part = await indexedPart(pkg, pagesPart, page, "page");
     const root = await visioXml(pkg, part, "PageContents");
     const localReport = (code, message, extra) => report(code, message, { part, pageId: id4, ...extra });
@@ -70029,16 +70130,16 @@ async function parseVsdx(input2, options2 = {}) {
     });
   }
   checkTime();
-  validateBackgrounds(pages, report);
+  if (!only) validateBackgrounds(pages, report);
   try {
-    comments.push(...await readVisioComments(pkg, documentPart, report));
+    if (!only) comments.push(...await readVisioComments(pkg, documentPart, report));
   } catch (error62) {
     if (!(error62 instanceof VisioPackageError) || error62.code === "LIMIT_RUNTIME") throw error62;
     report("invalid-comments", "The comments part could not be read; comments are not shown.");
   }
   let dataRecordsets = [];
   try {
-    dataRecordsets = await readDataRecordsets(pkg, documentPart, checkTime);
+    if (!only) dataRecordsets = await readDataRecordsets(pkg, documentPart, checkTime);
   } catch (error62) {
     if (error62 instanceof VisioPackageError && error62.code === "LIMIT_RUNTIME") throw error62;
     report(
@@ -70046,7 +70147,7 @@ async function parseVsdx(input2, options2 = {}) {
       `Saved external data could not be read and is preserved unchanged: ${error62 instanceof Error ? error62.message : String(error62)}`
     );
   }
-  const stencils = await readVisioStencilWindows(pkg, documentPart);
+  const stencils = only ? [] : await readVisioStencilWindows(pkg, documentPart);
   report(
     "cached-values-only",
     "ShapeSheet formulas, automatic connector routing, and external data are not evaluated; saved cached values and supported theme records are used.",
@@ -107507,4 +107608,121 @@ function findAutomationTool(name3) {
   return void 0;
 }
 
-export { UNTRUSTED_NOTE, XLSX_EDIT_LIMITS, applyXlsxEdits, applyXlsxProposal, automationTools, checkEditProposal, createDocx, createDocxFromOutline, createEditProposal, createXlsx, createXlsxFromSheets, documentDigest, docxTools, editVsdx as editVisio, fillDocxFormFields, findAutomationTool, findXlsxCells, inspectDocx, inspectVisio, inspectXlsx, listDocxFormFields, proposeXlsxEdits, readXlsxFilledCells, readXlsxRange, readXlsxTable, setDocxRunText, setXlsxCells, suggestDocxRunText, visioTools, xlsxTools };
+// automation/live.ts
+var digest = (bytes) => Array.from(sha256(bytes), (byte) => byte.toString(16).padStart(2, "0")).join("");
+function createLiveToolHost(tools, options2 = {}) {
+  const editors = /* @__PURE__ */ new Map();
+  const serve = tools.filter((tool) => tool.kind !== "create");
+  const queues = /* @__PURE__ */ new Map();
+  function editorFor(target3) {
+    if (typeof target3 !== "string" || target3 === "")
+      throw new Error("Every call needs a target: the id of the document to act on.");
+    const editor = editors.get(target3);
+    if (!editor) throw new Error(`No open document is registered as "${target3}".`);
+    return editor;
+  }
+  async function run2(name3, call) {
+    const tool = serve.find((candidate) => candidate.name === name3);
+    if (!tool) throw new Error(`Unknown tool "${name3}".`);
+    const editor = editorFor(call?.target);
+    const target3 = call.target;
+    if (tool.format !== editor.format)
+      throw new Error(
+        `${name3} works on ${tool.format} documents, but "${target3}" is a ${editor.format} document.`
+      );
+    const before = new Uint8Array(await editor.save());
+    if (tool.kind === "read")
+      return { target: target3, tool: name3, result: await tool.run(before, call.params), changed: false };
+    if (editor.readOnly) throw new Error(`"${target3}" is read-only, so it cannot be edited.`);
+    const { bytes: after, ...result2 } = await tool.run(before, call.params);
+    if (!after) return { target: target3, tool: name3, result: result2, changed: false };
+    if (options2.review) {
+      const accepted = await options2.review({
+        target: target3,
+        tool: name3,
+        params: call.params,
+        result: result2,
+        before,
+        after
+      });
+      if (!accepted)
+        return { target: target3, tool: name3, result: { ...result2, discarded: true }, changed: false };
+    }
+    if (editor.readOnly)
+      throw new Error(`"${target3}" became read-only, so the edit was not applied.`);
+    if (digest(new Uint8Array(await editor.save())) !== digest(before))
+      throw new Error(`"${target3}" changed while the edit was prepared; read it again and retry.`);
+    await editor.load(after);
+    return { target: target3, tool: name3, result: result2, changed: true };
+  }
+  return {
+    register(id4, editor) {
+      if (editors.has(id4)) throw new Error(`A document is already registered as "${id4}".`);
+      editors.set(id4, editor);
+      return () => {
+        if (editors.get(id4) === editor) editors.delete(id4);
+      };
+    },
+    targets: () => [...editors].map(([id4, editor]) => ({
+      id: id4,
+      format: editor.format,
+      readOnly: Boolean(editor.readOnly)
+    })),
+    describe() {
+      const open2 = new Set([...editors.values()].map((editor) => editor.format));
+      return serve.filter((tool) => open2.has(tool.format)).map((tool) => {
+        const schema = tool.jsonSchema();
+        return {
+          name: tool.name,
+          description: tool.description,
+          kind: tool.kind,
+          format: tool.format,
+          inputSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+              target: {
+                type: "string",
+                description: "The id of the open document to act on."
+              },
+              params: schema
+            },
+            required: ["target"]
+          }
+        };
+      });
+    },
+    call(name3, call) {
+      const key2 = typeof call?.target === "string" ? call.target : "";
+      const next = (queues.get(key2) ?? Promise.resolve()).then(
+        () => run2(name3, call),
+        () => run2(name3, call)
+      );
+      queues.set(
+        key2,
+        next.catch(() => void 0)
+      );
+      return next;
+    }
+  };
+}
+function liveEditorFromElement(format8, element3, name3) {
+  return {
+    format: format8,
+    save: async () => {
+      if (element3.commitEdit && !element3.commitEdit())
+        throw new Error("Finish the current cell edit before using the document.");
+      if (format8 === "visio" && element3.exportVsdx) return (await element3.exportVsdx()).bytes;
+      if (!element3.saveBytes) throw new Error("The editor cannot save its document.");
+      return element3.saveBytes();
+    },
+    load: async (bytes) => {
+      await element3.load(bytes, name3);
+    },
+    get readOnly() {
+      return element3.readOnly === true;
+    }
+  };
+}
+
+export { UNTRUSTED_NOTE, XLSX_EDIT_LIMITS, applyXlsxEdits, applyXlsxProposal, automationTools, checkEditProposal, createDocx, createDocxFromOutline, createEditProposal, createLiveToolHost, createXlsx, createXlsxFromSheets, documentDigest, docxTools, editVsdx as editVisio, fillDocxFormFields, findAutomationTool, findXlsxCells, inspectDocx, inspectVisio, inspectXlsx, listDocxFormFields, liveEditorFromElement, proposeXlsxEdits, readXlsxFilledCells, readXlsxRange, readXlsxTable, setDocxRunText, setXlsxCells, suggestDocxRunText, visioTools, xlsxTools };