ooxml-core 1.22.0 → 1.24.0

package/dist/visio/ui/index.cjs

@@ -10,12 +10,15 @@ var JSZip__default = /*#__PURE__*/_interopDefault(JSZip);
 // visio/ui/contract.ts
 var propertyKeys = [
   "canEdit",
+  "readOnly",
   "document",
   "pageIndex",
   "zoom",
   "showToolbar",
   "ribbonAddIns",
-  "collaboration"
+  "collaboration",
+  "storage",
+  "customization"
 ];
 var eventKeys = [
   "document-load",
@@ -26,9 +29,42 @@ var eventKeys = [
   "shape-select",
   "selection-change",
   "office-ribbon-add-in",
-  "collaboration-change"
+  "collaboration-change",
+  "file-command"
 ];
 
+// visio/ui/customization.ts
+var VISIO_CAPABILITY_IDS = [
+  "edit",
+  "export",
+  "print",
+  "share",
+  "copy",
+  "comment",
+  "find",
+  "open",
+  "save",
+  "settings"
+];
+var VISIO_CAPABILITY_BACKSTAGE_PAGES = {
+  open: ["new", "open"],
+  save: ["save", "save-as"],
+  export: ["export"],
+  print: ["print"],
+  share: ["share"],
+  settings: ["options"]
+};
+var VISIO_CAPABILITY_COMMANDS = {
+  copy: ["cut", "copy", "ctx-cut", "ctx-copy"],
+  comment: ["new-comment", "ctx-comment", "ctx-page-comment"],
+  find: ["find", "find-item", "replace"],
+  open: ["open", "new-blank"],
+  save: ["download"],
+  export: ["export-svg", "export-png", "export-pdf"],
+  print: ["print"],
+  share: ["email"]
+};
+
 // visio/ui/collab-presence.ts
 var VISIO_PRESENCE_MAX_SELECTION = 64;
 var VISIO_PRESENCE_MAX_ID = 128;
@@ -1766,6 +1802,7 @@ var VisioPackage = class _VisioPackage {
   relationshipCache = /* @__PURE__ */ new Map();
   byteCache = /* @__PURE__ */ new Map();
   decodedNames = /* @__PURE__ */ new Map();
+  noted;
   totalOutput = 0;
   totalXmlNodes = 0;
   check = () => {
@@ -1800,7 +1837,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((path2) => [path2, this.printOf(path2)]);
+    };
+  }
+  /** The declared CRC-32 and size of a part, or an empty string when the package lacks it. */
+  printOf(path2) {
+    const entry3 = this.entries.get(path2);
+    return entry3 && !entry3.directory ? `${entry3.crc}:${entry3.size}` : "";
+  }
   has(path2) {
+    this.noted?.add(path2);
     return this.entries.get(path2)?.directory === false;
   }
   paths() {
@@ -1808,6 +1864,7 @@ var VisioPackage = class _VisioPackage {
   }
   async readXml(path2, expectedRoot) {
     this.check();
+    this.noted?.add(path2);
     safePath(path2);
     let pending2 = this.cache.get(path2);
     if (!pending2) {
@@ -1823,6 +1880,7 @@ var VisioPackage = class _VisioPackage {
   /** Validated declared size, so resource-specific limits can reject before inflation. */
   getPartByteLength(path2) {
     this.check();
+    this.noted?.add(path2);
     safePath(path2);
     const entry3 = this.entries.get(path2);
     if (!entry3 || entry3.directory) fail("MISSING_PART", `Missing package part: ${path2}`);
@@ -1831,6 +1889,7 @@ var VisioPackage = class _VisioPackage {
   /** Shared package-owned bytes. Treat the returned buffer as immutable. */
   async readBytes(path2) {
     this.check();
+    this.noted?.add(path2);
     safePath(path2);
     let pending2 = this.byteCache.get(path2);
     if (!pending2) {
@@ -1924,6 +1983,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);
@@ -1957,6 +2020,7 @@ var VisioPackage = class _VisioPackage {
       const actual = mode === "Internal" ? this.decodedNames.get(resolved) : void 0;
       if (mode === "Internal" && !actual)
         fail("INVALID_RELATIONSHIP", `Missing relationship target: ${resolved}`);
+      if (actual) this.noted?.add(actual);
       result2.set(id3, { id: id3, type, target: actual ?? resolved, mode });
     }
     return result2;
@@ -25505,6 +25569,10 @@ function createLayerBudget() {
       memberships += count;
       if (memberships > 1e5)
         throw new VisioPackageError("METADATA_LIMIT", "Layer membership budget exceeded.");
+    },
+    state: () => [memberships, characters],
+    restore(state) {
+      [memberships, characters] = state;
     }
   };
 }
@@ -25576,6 +25644,259 @@ function shapeLayers(sheet, layers2, report, budget = createLayerBudget()) {
   };
 }
 
+// visio/page-theme.ts
+function visioPageTheme(themes, pageCells) {
+  const id3 = integer3(pageCells.get("ColorSchemeIndex")?.value);
+  if (!themes || id3 === void 0 || id3 === 0 || id3 >= 65534) return void 0;
+  const matches2 = themes.filter((theme3) => theme3.colorId === id3);
+  if (matches2.length !== 1) return void 0;
+  const theme2 = matches2[0];
+  const variant = Math.min(3, integer3(pageCells.get("VariationColorIndex")?.value) ?? 0);
+  const accents = [1, 2, 3, 4, 5, 6].map(
+    (index2) => drawingColor(theme2.colors.get(`accent${index2}`), theme2.colors) ?? "#808080"
+  );
+  const light = drawingColor(theme2.colors.get("lt1"), theme2.colors);
+  const dark = drawingColor(theme2.colors.get("dk1"), theme2.colors);
+  const builtIn = VISIO_BUILT_IN_THEMES.find(
+    (entry3) => entry3.schemeId === id3 && entry3.name === theme2.name
+  );
+  return {
+    name: theme2.name ?? `Theme ${id3}`,
+    ...builtIn ? { builtIn: builtIn.id } : {},
+    variant,
+    accents,
+    ...light ? { light } : {},
+    ...dark ? { dark } : {},
+    variants: theme2.variants.map(
+      (colors) => [1, 2, 3, 4, 5, 6, 7].map(
+        (index2) => drawingColor(colors.get(String(index2)), theme2.colors) ?? "#808080"
+      )
+    )
+  };
+}
+
+// visio/diagnostics.ts
+var MAX_CHARACTERS = 1e6;
+var marker2 = {
+  code: "diagnostics-truncated",
+  severity: "warning",
+  message: "Additional diagnostic content was omitted by the configured count or character limits."
+};
+function diagnosticCollector(maxCount) {
+  const diagnostics = [], keys = /* @__PURE__ */ new Set();
+  let characters = 0, truncated = false;
+  const bounded6 = (value3, max) => {
+    if (value3.length <= max) return value3;
+    truncated = true;
+    return value3.slice(0, max - 1) + "\u2026";
+  };
+  const report = (code, message, context = {}) => {
+    if (diagnostics.length >= maxCount) {
+      truncated = true;
+      return;
+    }
+    const item = {
+      code: bounded6(code, 64),
+      severity: context.severity ?? "warning",
+      message: bounded6(message, 2048),
+      ...context.part === void 0 ? {} : { part: bounded6(context.part, 1024) },
+      ...context.pageId === void 0 ? {} : { pageId: bounded6(context.pageId, 256) },
+      ...context.shapeId === void 0 ? {} : { shapeId: bounded6(context.shapeId, 1024) }
+    };
+    const key2 = JSON.stringify(item);
+    if (keys.has(key2)) return;
+    const size3 = Object.values(item).reduce((sum, value3) => sum + value3.length, 0);
+    if (characters + size3 > MAX_CHARACTERS - 256) {
+      truncated = true;
+      return;
+    }
+    characters += size3;
+    keys.add(key2);
+    diagnostics.push(item);
+  };
+  return {
+    report,
+    finish: () => {
+      if (truncated) {
+        if (diagnostics.length >= maxCount) diagnostics.pop();
+        diagnostics.push({ ...marker2 });
+      }
+      return diagnostics;
+    }
+  };
+}
+
+// visio/print-settings.ts
+var NAMES2 = [
+  "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(
+  [...NAMES2, "PageWidth", "PageHeight", "PageScale", "DrawingScale"].map((name3) => [
+    name3.toLowerCase(),
+    name3
+  ])
+);
+function indexCells2(sheet) {
+  const cells4 = /* @__PURE__ */ new Map();
+  let duplicate = false;
+  for (const node3 of children2(sheet, "Cell")) {
+    const name3 = attribute2(node3, "N") ?? "", canonical2 = CANONICAL.get(name3.toLowerCase());
+    if (!canonical2) continue;
+    if (canonical2 !== name3) duplicate = true;
+    const values = cells4.get(canonical2) ?? [];
+    if (values.length < 2) values.push(node3);
+    cells4.set(canonical2, values);
+    if (values.length > 1) duplicate = true;
+  }
+  return { cells: cells4, duplicate };
+}
+function createVisioPrintSettingsReader(documentSheets, rootStyles) {
+  const indexes = { document: indexCells2(documentSheets[0]), root: indexCells2(rootStyles[0]) };
+  return (pageSheets) => readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes);
+}
+function readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes) {
+  let refusal;
+  const refuse5 = (reason) => {
+    refusal ??= reason;
+  };
+  if (pageSheets.length !== 1) refuse5("ambiguous-page-sheet");
+  if (documentSheets.length > 1) refuse5("ambiguous-document-sheet");
+  if (!documentSheets.length) refuse5("missing-setting");
+  if (rootStyles.length > 1) refuse5("duplicate-setting");
+  const root2 = rootStyles[0];
+  if (!root2 || attribute2(root2, "ID") !== "0" || attribute2(root2, "NameU") !== "No Style")
+    refuse5("unsupported-print-style");
+  for (const sheet of [...pageSheets, ...documentSheets])
+    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+      if (attribute2(sheet, name3) !== "0") refuse5("unsupported-print-style");
+  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+    if (attribute2(root2, name3) !== void 0) refuse5("unsupported-print-style");
+  const localIndex = indexCells2(pageSheets[0]), rootIndex = indexes?.root ?? indexCells2(root2);
+  const documentIndex = indexes?.document ?? indexCells2(documentSheets[0]);
+  if (localIndex.duplicate || rootIndex.duplicate || documentIndex.duplicate)
+    refuse5("duplicate-setting");
+  const local = localIndex.cells, inherited = rootIndex.cells;
+  const read = (node3, name3, origin) => {
+    const invalid5 = () => {
+      refuse5(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
+      return void 0;
+    };
+    if (node3.hasAttribute("E")) return invalid5();
+    let raw = (attribute2(node3, "V") ?? "").trim();
+    if (!raw || raw.length > 128) return invalid5();
+    if (BOOLEAN.has(name3)) {
+      if (!["0", "1", "false", "true"].includes(raw)) return invalid5();
+      raw = raw === "true" ? "1" : raw === "false" ? "0" : raw;
+    }
+    try {
+      const value3 = visioFormulaCachedValue(raw, attribute2(node3, "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 invalid5();
+      const formula = attribute2(node3, "F");
+      if (formula !== void 0) {
+        const source = formula.trim();
+        if (/^(true|false)$/i.test(source)) {
+          if ((source.toLowerCase() === "true" ? 1 : 0) !== value3.value) return invalid5();
+        } else {
+          if (!source || source === "Inh") return invalid5();
+          const limits = { maxLength: 512, maxNodes: 64, maxDepth: 16, maxSteps: 128 };
+          const analysis = analyzeVisioFormula(source, limits);
+          if (analysis.dynamic || analysis.guarded || analysis.references.length || analysis.unsupportedFunctions.length) {
+            refuse5("dynamic-setting");
+            return void 0;
+          }
+          const evaluated = evaluateVisioFormula(
+            source,
+            () => {
+              throw new Error("Unexpected reference");
+            },
+            limits
+          );
+          if (evaluated.value !== value3.value || !["scalar", ...length ? ["length"] : []].includes(evaluated.unit))
+            return invalid5();
+        }
+      }
+      return value3.value;
+    } catch {
+      return invalid5();
+    }
+  };
+  const values = /* @__PURE__ */ new Map();
+  for (const name3 of NAMES2) {
+    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) values.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))
+      refuse5("unusable-drawing-scale");
+  }
+  const setup = {};
+  const paper = values.get("PaperKind");
+  if (paper !== void 0 && Number.isSafeInteger(paper) && paper >= 0 && paper <= 65535)
+    setup.paperKind = paper;
+  else if (paper !== void 0)
+    refuse5(local.has("PaperKind") ? "invalid-local-setting" : "invalid-document-setting");
+  const orientation = values.get("PrintPageOrientation");
+  if (orientation === 0 || orientation === 1 || orientation === 2)
+    setup.printPageOrientation = orientation;
+  else if (orientation !== void 0)
+    refuse5(
+      local.has("PrintPageOrientation") ? "invalid-local-setting" : "invalid-document-setting"
+    );
+  const margins = ["Left", "Right", "Top", "Bottom"].map((side2) => values.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)))
+    refuse5("unusable-print-area");
+  for (const [name3, key2] of [
+    ["ScaleX", "printZoom"],
+    ["ScaleY", "printZoomY"],
+    ["PagesX", "printPagesAcross"],
+    ["PagesY", "printPagesDown"]
+  ]) {
+    const value3 = values.get(name3);
+    if (value3 !== void 0) {
+      if ((name3 === "PagesX" || name3 === "PagesY") && (!Number.isSafeInteger(value3) || value3 < 1))
+        refuse5(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 = values.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",
@@ -25667,86 +25988,82 @@ function formatList(parent, name3) {
   ).slice(0, 6) : [];
 }
 
-// visio/page-theme.ts
-function visioPageTheme(themes, pageCells) {
-  const id3 = integer3(pageCells.get("ColorSchemeIndex")?.value);
-  if (!themes || id3 === void 0 || id3 === 0 || id3 >= 65534) return void 0;
-  const matches2 = themes.filter((theme3) => theme3.colorId === id3);
-  if (matches2.length !== 1) return void 0;
-  const theme2 = matches2[0];
-  const variant = Math.min(3, integer3(pageCells.get("VariationColorIndex")?.value) ?? 0);
-  const accents = [1, 2, 3, 4, 5, 6].map(
-    (index2) => drawingColor(theme2.colors.get(`accent${index2}`), theme2.colors) ?? "#808080"
-  );
-  const light = drawingColor(theme2.colors.get("lt1"), theme2.colors);
-  const dark = drawingColor(theme2.colors.get("dk1"), theme2.colors);
-  const builtIn = VISIO_BUILT_IN_THEMES.find(
-    (entry3) => entry3.schemeId === id3 && entry3.name === theme2.name
-  );
-  return {
-    name: theme2.name ?? `Theme ${id3}`,
-    ...builtIn ? { builtIn: builtIn.id } : {},
-    variant,
-    accents,
-    ...light ? { light } : {},
-    ...dark ? { dark } : {},
-    variants: theme2.variants.map(
-      (colors) => [1, 2, 3, 4, 5, 6, 7].map(
-        (index2) => drawingColor(colors.get(String(index2)), theme2.colors) ?? "#808080"
-      )
-    )
-  };
+// visio/document-level.ts
+function optionsKey(options2) {
+  const { metafileConverter: _converter, pages: _pages, documentCache: _cache, ...rest } = options2;
+  return JSON.stringify(rest);
 }
-
-// visio/diagnostics.ts
-var MAX_CHARACTERS = 1e6;
-var marker2 = {
-  code: "diagnostics-truncated",
-  severity: "warning",
-  message: "Additional diagnostic content was omitted by the configured count or character limits."
-};
-function diagnosticCollector(maxCount) {
-  const diagnostics = [], keys = /* @__PURE__ */ new Set();
-  let characters = 0, truncated = false;
-  const bounded6 = (value3, max) => {
-    if (value3.length <= max) return value3;
-    truncated = true;
-    return value3.slice(0, max - 1) + "\u2026";
+var cacheMatches = (entry3, pkg, options2) => entry3 !== void 0 && entry3.options === optionsKey(options2) && entry3.converter === options2.metafileConverter && entry3.reads.every(([path2, print]) => pkg.printOf(path2) === print);
+async function readDocumentLevel(pkg, documentPart2, options2, checkTime, forward) {
+  const reports = [];
+  const report = (...args) => {
+    reports.push(args);
+    forward(...args);
   };
-  const report = (code, message, context = {}) => {
-    if (diagnostics.length >= maxCount) {
-      truncated = true;
-      return;
-    }
-    const item = {
-      code: bounded6(code, 64),
-      severity: context.severity ?? "warning",
-      message: bounded6(message, 2048),
-      ...context.part === void 0 ? {} : { part: bounded6(context.part, 1024) },
-      ...context.pageId === void 0 ? {} : { pageId: bounded6(context.pageId, 256) },
-      ...context.shapeId === void 0 ? {} : { shapeId: bounded6(context.shapeId, 1024) }
-    };
-    const key2 = JSON.stringify(item);
-    if (keys.has(key2)) return;
-    const size3 = Object.values(item).reduce((sum, value3) => sum + value3.length, 0);
-    if (characters + size3 > MAX_CHARACTERS - 256) {
-      truncated = true;
-      return;
-    }
-    characters += size3;
-    keys.add(key2);
-    diagnostics.push(item);
+  const documentRoot = await visioXml(pkg, documentPart2, "VisioDocument");
+  const resources = {
+    colors: /* @__PURE__ */ new Map(),
+    fonts: /* @__PURE__ */ new Map(),
+    themes: await loadVisioThemes(pkg, documentPart2, report)
   };
-  return {
-    report,
-    finish: () => {
-      if (truncated) {
-        if (diagnostics.length >= maxCount) diagnostics.pop();
-        diagnostics.push({ ...marker2 });
-      }
-      return diagnostics;
+  for (const color2 of children2(child(documentRoot, "Colors"), "ColorEntry"))
+    resources.colors.set(attribute2(color2, "IX") ?? "", attribute2(color2, "RGB") ?? "");
+  const faceNames = children2(child(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, index2) => {
+    checkTime();
+    fontCharacters += (attribute2(font, "Name") ?? attribute2(font, "NameU") ?? "Arial").length;
+    if (fontCharacters > 1e6)
+      throw new VisioPackageError(
+        "METADATA_LIMIT",
+        "Document fonts exceed aggregate metadata limits."
+      );
+    resources.fonts.set(
+      metadata(attribute2(font, "ID") ?? String(index2), 256, "Font ID"),
+      metadata(attribute2(font, "Name") ?? attribute2(font, "NameU") ?? "Arial", 1024, "Font name")
+    );
+  });
+  const styles = /* @__PURE__ */ new Map();
+  for (const style2 of children2(child(documentRoot, "StyleSheets"), "StyleSheet"))
+    styles.set(metadata(attribute2(style2, "ID") ?? "", 256, "Style ID"), {
+      sheet: readSheet(style2),
+      attributes: metadataAttributes(style2)
+    });
+  const rootStyle = styles.get("0");
+  if (rootStyle?.attributes.get("NameU") === "No Style") resources.rootSheet = rootStyle.sheet;
+  const printStyleGroups = children2(documentRoot, "StyleSheets");
+  const readPrintSettings = createVisioPrintSettingsReader(
+    children2(documentRoot, "DocumentSheet"),
+    printStyleGroups.length === 1 ? children2(printStyleGroups[0], "StyleSheet").filter((node3) => attribute2(node3, "ID") === "0") : []
+  );
+  const masters = /* @__PURE__ */ new Map();
+  const masterRecords = [];
+  const mastersPart = await related(pkg, documentPart2, "masters", false);
+  if (mastersPart) {
+    for (const master2 of children2(await visioXml(pkg, mastersPart, "Masters"), "Master")) {
+      const part = await indexedPart(pkg, mastersPart, master2, "master");
+      const id3 = metadata(attribute2(master2, "ID") ?? "", 256, "Master ID");
+      if (!id3 || masters.has(id3))
+        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(id3, masterShapes2);
+      masterRecords.push({ id: id3, node: master2, shapes: masterShapes2 });
     }
-  };
+  }
+  return { documentRoot, resources, styles, readPrintSettings, masters, masterRecords, reports };
 }
 
 // visio/shape-metadata.ts
@@ -25766,6 +26083,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;
     }
   };
 }
@@ -26664,177 +26985,6 @@ function readVisioPageSetup(cells4) {
   return Object.keys(result2).length ? result2 : void 0;
 }
 
-// visio/print-settings.ts
-var NAMES2 = [
-  "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(
-  [...NAMES2, "PageWidth", "PageHeight", "PageScale", "DrawingScale"].map((name3) => [
-    name3.toLowerCase(),
-    name3
-  ])
-);
-function indexCells2(sheet) {
-  const cells4 = /* @__PURE__ */ new Map();
-  let duplicate = false;
-  for (const node3 of children2(sheet, "Cell")) {
-    const name3 = attribute2(node3, "N") ?? "", canonical2 = CANONICAL.get(name3.toLowerCase());
-    if (!canonical2) continue;
-    if (canonical2 !== name3) duplicate = true;
-    const values = cells4.get(canonical2) ?? [];
-    if (values.length < 2) values.push(node3);
-    cells4.set(canonical2, values);
-    if (values.length > 1) duplicate = true;
-  }
-  return { cells: cells4, duplicate };
-}
-function createVisioPrintSettingsReader(documentSheets, rootStyles) {
-  const indexes = { document: indexCells2(documentSheets[0]), root: indexCells2(rootStyles[0]) };
-  return (pageSheets) => readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes);
-}
-function readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes) {
-  let refusal;
-  const refuse5 = (reason) => {
-    refusal ??= reason;
-  };
-  if (pageSheets.length !== 1) refuse5("ambiguous-page-sheet");
-  if (documentSheets.length > 1) refuse5("ambiguous-document-sheet");
-  if (!documentSheets.length) refuse5("missing-setting");
-  if (rootStyles.length > 1) refuse5("duplicate-setting");
-  const root2 = rootStyles[0];
-  if (!root2 || attribute2(root2, "ID") !== "0" || attribute2(root2, "NameU") !== "No Style")
-    refuse5("unsupported-print-style");
-  for (const sheet of [...pageSheets, ...documentSheets])
-    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-      if (attribute2(sheet, name3) !== "0") refuse5("unsupported-print-style");
-  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-    if (attribute2(root2, name3) !== void 0) refuse5("unsupported-print-style");
-  const localIndex = indexCells2(pageSheets[0]), rootIndex = indexes?.root ?? indexCells2(root2);
-  const documentIndex = indexes?.document ?? indexCells2(documentSheets[0]);
-  if (localIndex.duplicate || rootIndex.duplicate || documentIndex.duplicate)
-    refuse5("duplicate-setting");
-  const local = localIndex.cells, inherited = rootIndex.cells;
-  const read = (node3, name3, origin) => {
-    const invalid5 = () => {
-      refuse5(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
-      return void 0;
-    };
-    if (node3.hasAttribute("E")) return invalid5();
-    let raw = (attribute2(node3, "V") ?? "").trim();
-    if (!raw || raw.length > 128) return invalid5();
-    if (BOOLEAN.has(name3)) {
-      if (!["0", "1", "false", "true"].includes(raw)) return invalid5();
-      raw = raw === "true" ? "1" : raw === "false" ? "0" : raw;
-    }
-    try {
-      const value3 = visioFormulaCachedValue(raw, attribute2(node3, "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 invalid5();
-      const formula = attribute2(node3, "F");
-      if (formula !== void 0) {
-        const source = formula.trim();
-        if (/^(true|false)$/i.test(source)) {
-          if ((source.toLowerCase() === "true" ? 1 : 0) !== value3.value) return invalid5();
-        } else {
-          if (!source || source === "Inh") return invalid5();
-          const limits = { maxLength: 512, maxNodes: 64, maxDepth: 16, maxSteps: 128 };
-          const analysis = analyzeVisioFormula(source, limits);
-          if (analysis.dynamic || analysis.guarded || analysis.references.length || analysis.unsupportedFunctions.length) {
-            refuse5("dynamic-setting");
-            return void 0;
-          }
-          const evaluated = evaluateVisioFormula(
-            source,
-            () => {
-              throw new Error("Unexpected reference");
-            },
-            limits
-          );
-          if (evaluated.value !== value3.value || !["scalar", ...length ? ["length"] : []].includes(evaluated.unit))
-            return invalid5();
-        }
-      }
-      return value3.value;
-    } catch {
-      return invalid5();
-    }
-  };
-  const values = /* @__PURE__ */ new Map();
-  for (const name3 of NAMES2) {
-    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) values.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))
-      refuse5("unusable-drawing-scale");
-  }
-  const setup = {};
-  const paper = values.get("PaperKind");
-  if (paper !== void 0 && Number.isSafeInteger(paper) && paper >= 0 && paper <= 65535)
-    setup.paperKind = paper;
-  else if (paper !== void 0)
-    refuse5(local.has("PaperKind") ? "invalid-local-setting" : "invalid-document-setting");
-  const orientation = values.get("PrintPageOrientation");
-  if (orientation === 0 || orientation === 1 || orientation === 2)
-    setup.printPageOrientation = orientation;
-  else if (orientation !== void 0)
-    refuse5(
-      local.has("PrintPageOrientation") ? "invalid-local-setting" : "invalid-document-setting"
-    );
-  const margins = ["Left", "Right", "Top", "Bottom"].map((side2) => values.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)))
-    refuse5("unusable-print-area");
-  for (const [name3, key2] of [
-    ["ScaleX", "printZoom"],
-    ["ScaleY", "printZoomY"],
-    ["PagesX", "printPagesAcross"],
-    ["PagesY", "printPagesDown"]
-  ]) {
-    const value3 = values.get(name3);
-    if (value3 !== void 0) {
-      if ((name3 === "PagesX" || name3 === "PagesY") && (!Number.isSafeInteger(value3) || value3 < 1))
-        refuse5(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 = values.get(name3);
-    if (value3 !== void 0) setup[key2] = value3 === 1;
-  }
-  if (refusal) setup.printCountRefusal = refusal;
-  return setup;
-}
-
 // visio/master-list.ts
 var MAX_LISTED_MASTERS = 500;
 var PREVIEW_SHAPES = 5e3;
@@ -27032,69 +27182,18 @@ async function parseVsdx(input, options2 = {}) {
         );
     }
   }
-  const documentRoot = await visioXml(pkg, documentPart2, "VisioDocument");
-  const resources = {
-    colors: /* @__PURE__ */ new Map(),
-    fonts: /* @__PURE__ */ new Map(),
-    themes: await loadVisioThemes(pkg, documentPart2, report)
-  };
-  for (const color2 of children2(child(documentRoot, "Colors"), "ColorEntry"))
-    resources.colors.set(attribute2(color2, "IX") ?? "", attribute2(color2, "RGB") ?? "");
-  const faceNames = children2(child(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, index2) => {
-    checkTime();
-    fontCharacters += (attribute2(font, "Name") ?? attribute2(font, "NameU") ?? "Arial").length;
-    if (fontCharacters > 1e6)
-      throw new VisioPackageError(
-        "METADATA_LIMIT",
-        "Document fonts exceed aggregate metadata limits."
-      );
-    resources.fonts.set(
-      metadata(attribute2(font, "ID") ?? String(index2), 256, "Font ID"),
-      metadata(attribute2(font, "Name") ?? attribute2(font, "NameU") ?? "Arial", 1024, "Font name")
-    );
-  });
-  const styles = /* @__PURE__ */ new Map();
-  for (const style2 of children2(child(documentRoot, "StyleSheets"), "StyleSheet"))
-    styles.set(metadata(attribute2(style2, "ID") ?? "", 256, "Style ID"), {
-      sheet: readSheet(style2),
-      attributes: metadataAttributes(style2)
-    });
-  const rootStyle = styles.get("0");
-  if (rootStyle?.attributes.get("NameU") === "No Style") resources.rootSheet = rootStyle.sheet;
-  const printStyleGroups = children2(documentRoot, "StyleSheets");
-  const readPrintSettings = createVisioPrintSettingsReader(
-    children2(documentRoot, "DocumentSheet"),
-    printStyleGroups.length === 1 ? children2(printStyleGroups[0], "StyleSheet").filter((node3) => attribute2(node3, "ID") === "0") : []
-  );
-  const masters = /* @__PURE__ */ new Map();
-  const masterRecords = [];
-  const mastersPart = await related(pkg, documentPart2, "masters", false);
-  if (mastersPart) {
-    for (const master2 of children2(await visioXml(pkg, mastersPart, "Masters"), "Master")) {
-      const part = await indexedPart(pkg, mastersPart, master2, "master");
-      const id3 = metadata(attribute2(master2, "ID") ?? "", 256, "Master ID");
-      if (!id3 || masters.has(id3))
-        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(id3, masterShapes2);
-      masterRecords.push({ id: id3, node: master2, shapes: masterShapes2 });
-    }
-  }
+  const cache2 = options2.documentCache;
+  const cached5 = cacheMatches(cache2?.entry, pkg, options2) ? cache2.entry : void 0;
+  const stopRecording = cache2 && !cached5 ? pkg.record() : void 0;
+  let level2;
+  if (cached5) {
+    level2 = cached5.level;
+    for (const args of level2.reports) report(...args);
+  } else level2 = await readDocumentLevel(pkg, documentPart2, 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),
@@ -27148,15 +27247,52 @@ async function parseVsdx(input, options2 = {}) {
         throw new VisioPackageError("TEXT_LIMIT", "Text character limit exceeded.");
     }
   };
-  const documentMasters = listVisioMasters(masterRecords, context, {
-    metadataBudget: createMetadataBudget(options2.metadata),
-    layerBudget: createLayerBudget()
-  });
+  let documentMasters;
+  if (cached5) {
+    const { counters } = cached5.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 = cached5.listed.documentMasters;
+  } else {
+    documentMasters = listVisioMasters(masterRecords, context, {
+      metadataBudget: createMetadataBudget(options2.metadata),
+      layerBudget: createLayerBudget()
+    });
+    if (cache2 && stopRecording)
+      cache2.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, documentPart2, "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 ? children2(await visioXml(pkg, pagesPart, "Pages"), "Page") : [];
   const foreground = pageNodes.filter((page) => !yes(attribute2(page, "Background")));
   const fieldProperties = await readVisioFieldProperties(pkg);
@@ -27166,6 +27302,7 @@ async function parseVsdx(input, options2 = {}) {
     if (!id3 || pageIds2.has(id3))
       throw new VisioPackageError("INVALID_PAGE_ID", "Page IDs must be present and unique.");
     pageIds2.add(id3);
+    if (only && !only.has(id3)) continue;
     const part = await indexedPart(pkg, pagesPart, page, "page");
     const root2 = await visioXml(pkg, part, "PageContents");
     const localReport = (code, message, extra) => report(code, message, { part, pageId: id3, ...extra });
@@ -27275,16 +27412,16 @@ async function parseVsdx(input, options2 = {}) {
     });
   }
   checkTime();
-  validateBackgrounds(pages, report);
+  if (!only) validateBackgrounds(pages, report);
   try {
-    comments.push(...await readVisioComments(pkg, documentPart2, report));
+    if (!only) comments.push(...await readVisioComments(pkg, documentPart2, report));
   } catch (error) {
     if (!(error instanceof VisioPackageError) || error.code === "LIMIT_RUNTIME") throw error;
     report("invalid-comments", "The comments part could not be read; comments are not shown.");
   }
   let dataRecordsets = [];
   try {
-    dataRecordsets = await readDataRecordsets(pkg, documentPart2, checkTime);
+    if (!only) dataRecordsets = await readDataRecordsets(pkg, documentPart2, checkTime);
   } catch (error) {
     if (error instanceof VisioPackageError && error.code === "LIMIT_RUNTIME") throw error;
     report(
@@ -27292,7 +27429,7 @@ async function parseVsdx(input, options2 = {}) {
       `Saved external data could not be read and is preserved unchanged: ${error instanceof Error ? error.message : String(error)}`
     );
   }
-  const stencils = await readVisioStencilWindows(pkg, documentPart2);
+  const stencils = only ? [] : await readVisioStencilWindows(pkg, documentPart2);
   report(
     "cached-values-only",
     "ShapeSheet formulas, automatic connector routing, and external data are not evaluated; saved cached values and supported theme records are used.",
@@ -45205,6 +45342,9 @@ exports.VISIO_AUTO_CONNECT_DIRECTIONS = VISIO_AUTO_CONNECT_DIRECTIONS;
 exports.VISIO_AUTO_CONNECT_GAP = VISIO_AUTO_CONNECT_GAP;
 exports.VISIO_AUTO_CONNECT_REACH = VISIO_AUTO_CONNECT_REACH;
 exports.VISIO_BULLET_STYLES = VISIO_BULLET_STYLES;
+exports.VISIO_CAPABILITY_BACKSTAGE_PAGES = VISIO_CAPABILITY_BACKSTAGE_PAGES;
+exports.VISIO_CAPABILITY_COMMANDS = VISIO_CAPABILITY_COMMANDS;
+exports.VISIO_CAPABILITY_IDS = VISIO_CAPABILITY_IDS;
 exports.VISIO_CHART_OBJECT_SIZE = VISIO_CHART_OBJECT_SIZE;
 exports.VISIO_DATA_GRAPHIC_FILL_ROW = VISIO_DATA_GRAPHIC_FILL_ROW;
 exports.VISIO_DATA_GRAPHIC_ICONS = VISIO_DATA_GRAPHIC_ICONS;