ooxml-core 1.22.0 → 1.24.0

package/dist/visio/index.cjs

@@ -740,6 +740,7 @@ var VisioPackage = class _VisioPackage {
   relationshipCache = /* @__PURE__ */ new Map();
   byteCache = /* @__PURE__ */ new Map();
   decodedNames = /* @__PURE__ */ new Map();
+  noted;
   totalOutput = 0;
   totalXmlNodes = 0;
   check = () => {
@@ -774,7 +775,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() {
@@ -782,6 +802,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) {
@@ -797,6 +818,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}`);
@@ -805,6 +827,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) {
@@ -898,6 +921,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);
@@ -931,6 +958,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;
@@ -22204,6 +22232,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;
     }
   };
 }
@@ -22275,97 +22307,6 @@ function shapeLayers(sheet, layers, report, budget = createLayerBudget()) {
   };
 }
 
-// visio/theme.ts
-var VISIO_SCHEME_SLOTS = [
-  "dk1",
-  "lt1",
-  "accent1",
-  "accent2",
-  "accent3",
-  "accent4",
-  "accent5",
-  "accent6"
-];
-var componentId = (node3) => integer3(themeChild(node3, "schemeID", THEME_NS)?.getAttribute("schemeEnum"));
-async function loadVisioThemes(pkg, source, report) {
-  const result2 = [];
-  for (const rel of (await pkg.relationships(source)).values()) {
-    if (rel.type !== "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" || rel.mode === "External")
-      continue;
-    const root2 = await pkg.readXml(rel.target, "theme");
-    if (root2.namespaceURI !== DRAWING_NS) {
-      report("unsupported-theme", "A theme uses an unsupported XML namespace.", {
-        part: rel.target
-      });
-      continue;
-    }
-    const base2 = themeChild(root2, "themeElements");
-    const palette = themeChild(base2, "clrScheme");
-    const scheme = parseTheme(root2).colorScheme.colors;
-    const colors = /* @__PURE__ */ new Map();
-    for (const name4 of VISIO_SCHEME_SLOTS) {
-      const color2 = scheme[name4];
-      if (color2 && parsedColorChoice(themeChild(palette, name4))) colors.set(name4, color2);
-    }
-    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 index2 = 1; index2 <= 7; index2++) {
-        const choice2 = parsedColorChoice(themeChild(variant, `varColor${index2}`, THEME_NS));
-        if (choice2) entries.set(String(index2), choice2);
-      }
-      return entries;
-    });
-    const format5 = themeChild(base2, "fmtScheme");
-    const connector2 = extension(base2, "fmtConnectorScheme");
-    const fonts = extension(base2, "fontStylesGroup");
-    const name3 = root2.getAttribute("name");
-    result2.push({
-      ...name3 ? { name: name3.slice(0, 256) } : {},
-      colorId: integer3(extension(palette, "schemeID")?.getAttribute("schemeEnum")),
-      effectId: componentId(extension(base2, "fmtSchemeEx")),
-      connectorId: componentId(extension(base2, "fmtConnectorSchemeEx")),
-      colors,
-      variants,
-      variationStyles: themeChildren(
-        extension(base2, "variationStyleSchemeLst"),
-        "variationStyleScheme",
-        THEME_NS
-      ).slice(0, 4).map((variant) => themeChildren(variant, "varStyle", THEME_NS).slice(0, 4)),
-      fills: formatList(format5, "fillStyleLst"),
-      effects: themeChildren(themeChild(format5, "effectStyleLst"), "effectStyle").slice(0, 6),
-      lines: themeChildren(themeChild(format5, "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(
-    (node3) => node3.nodeType === 1 && node3.namespaceURI === DRAWING_NS
-  ).slice(0, 6) : [];
-}
-
 // visio/theme-builtins.ts
 var VISIO_BUILT_IN_THEME_IDS = [
   "office",
@@ -22529,6 +22470,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 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 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 root2 = rootStyles[0];
+  if (!root2 || attribute2(root2, "ID") !== "0" || attribute2(root2, "NameU") !== "No Style")
+    refuse4("unsupported-print-style");
+  for (const sheet of [...pageSheets, ...documentSheets])
+    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+      if (attribute2(sheet, name3) !== "0") refuse4("unsupported-print-style");
+  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
+    if (attribute2(root2, name3) !== void 0) refuse4("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)
+    refuse4("duplicate-setting");
+  const local = localIndex.cells, inherited = rootIndex.cells;
+  const read = (node3, name3, origin) => {
+    const invalid4 = () => {
+      refuse4(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
+      return void 0;
+    };
+    if (node3.hasAttribute("E")) return invalid4();
+    let raw = (attribute2(node3, "V") ?? "").trim();
+    if (!raw || raw.length > 128) return invalid4();
+    if (BOOLEAN.has(name3)) {
+      if (!["0", "1", "false", "true"].includes(raw)) return invalid4();
+      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 invalid4();
+      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 invalid4();
+        } else {
+          if (!source || source === "Inh") return invalid4();
+          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) {
+            refuse4("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 invalid4();
+        }
+      }
+      return value3.value;
+    } catch {
+      return invalid4();
+    }
+  };
+  const values = /* @__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) 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))
+      refuse4("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)
+    refuse4(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)
+    refuse4(
+      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)))
+    refuse4("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))
+        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 = 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",
+  "lt1",
+  "accent1",
+  "accent2",
+  "accent3",
+  "accent4",
+  "accent5",
+  "accent6"
+];
+var componentId = (node3) => integer3(themeChild(node3, "schemeID", THEME_NS)?.getAttribute("schemeEnum"));
+async function loadVisioThemes(pkg, source, report) {
+  const result2 = [];
+  for (const rel of (await pkg.relationships(source)).values()) {
+    if (rel.type !== "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" || rel.mode === "External")
+      continue;
+    const root2 = await pkg.readXml(rel.target, "theme");
+    if (root2.namespaceURI !== DRAWING_NS) {
+      report("unsupported-theme", "A theme uses an unsupported XML namespace.", {
+        part: rel.target
+      });
+      continue;
+    }
+    const base2 = themeChild(root2, "themeElements");
+    const palette = themeChild(base2, "clrScheme");
+    const scheme = parseTheme(root2).colorScheme.colors;
+    const colors = /* @__PURE__ */ new Map();
+    for (const name4 of VISIO_SCHEME_SLOTS) {
+      const color2 = scheme[name4];
+      if (color2 && parsedColorChoice(themeChild(palette, name4))) colors.set(name4, color2);
+    }
+    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 index2 = 1; index2 <= 7; index2++) {
+        const choice2 = parsedColorChoice(themeChild(variant, `varColor${index2}`, THEME_NS));
+        if (choice2) entries.set(String(index2), choice2);
+      }
+      return entries;
+    });
+    const format5 = themeChild(base2, "fmtScheme");
+    const connector2 = extension(base2, "fmtConnectorScheme");
+    const fonts = extension(base2, "fontStylesGroup");
+    const name3 = root2.getAttribute("name");
+    result2.push({
+      ...name3 ? { name: name3.slice(0, 256) } : {},
+      colorId: integer3(extension(palette, "schemeID")?.getAttribute("schemeEnum")),
+      effectId: componentId(extension(base2, "fmtSchemeEx")),
+      connectorId: componentId(extension(base2, "fmtConnectorSchemeEx")),
+      colors,
+      variants,
+      variationStyles: themeChildren(
+        extension(base2, "variationStyleSchemeLst"),
+        "variationStyleScheme",
+        THEME_NS
+      ).slice(0, 4).map((variant) => themeChildren(variant, "varStyle", THEME_NS).slice(0, 4)),
+      fills: formatList(format5, "fillStyleLst"),
+      effects: themeChildren(themeChild(format5, "effectStyleLst"), "effectStyle").slice(0, 6),
+      lines: themeChildren(themeChild(format5, "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(
+    (node3) => node3.nodeType === 1 && node3.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(([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 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 });
+    }
+  }
+  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";
@@ -22629,6 +22910,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;
     }
   };
 }
@@ -23601,177 +23886,6 @@ function readVisioPageSetup(cells4) {
   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 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 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 root2 = rootStyles[0];
-  if (!root2 || attribute2(root2, "ID") !== "0" || attribute2(root2, "NameU") !== "No Style")
-    refuse4("unsupported-print-style");
-  for (const sheet of [...pageSheets, ...documentSheets])
-    for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-      if (attribute2(sheet, name3) !== "0") refuse4("unsupported-print-style");
-  for (const name3 of ["LineStyle", "FillStyle", "TextStyle"])
-    if (attribute2(root2, name3) !== void 0) refuse4("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)
-    refuse4("duplicate-setting");
-  const local = localIndex.cells, inherited = rootIndex.cells;
-  const read = (node3, name3, origin) => {
-    const invalid4 = () => {
-      refuse4(origin === "local" ? "invalid-local-setting" : "invalid-document-setting");
-      return void 0;
-    };
-    if (node3.hasAttribute("E")) return invalid4();
-    let raw = (attribute2(node3, "V") ?? "").trim();
-    if (!raw || raw.length > 128) return invalid4();
-    if (BOOLEAN.has(name3)) {
-      if (!["0", "1", "false", "true"].includes(raw)) return invalid4();
-      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 invalid4();
-      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 invalid4();
-        } else {
-          if (!source || source === "Inh") return invalid4();
-          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) {
-            refuse4("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 invalid4();
-        }
-      }
-      return value3.value;
-    } catch {
-      return invalid4();
-    }
-  };
-  const values = /* @__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) 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))
-      refuse4("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)
-    refuse4(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)
-    refuse4(
-      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)))
-    refuse4("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))
-        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 = values.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]);
@@ -24091,69 +24205,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),
@@ -24207,15 +24270,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);
@@ -24225,6 +24325,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 });
@@ -24334,16 +24435,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(
@@ -24351,7 +24452,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.",
@@ -33880,6 +33981,55 @@ async function loadVisio(input, options2 = {}) {
   );
 }
 
+// visio/parse-incremental.ts
+var BACKGROUND_CODES = /* @__PURE__ */ new Set(["background-cycle", "missing-background-page"]);
+var MAX_SPLICED_DIAGNOSTICS = 1e3;
+var DEFAULT_MAX_SHAPES = 25e3;
+var countShapes = (shapes) => shapes.reduce((sum, shape) => sum + 1 + countShapes(shape.children), 0);
+var isPageDiagnostic = (d) => d.pageId !== void 0 && !BACKGROUND_CODES.has(d.code);
+function mergeVisioPages(previous, partial, pageIds2, options2 = {}) {
+  if (previous.format !== "vsdx" || partial.format !== "vsdx") return void 0;
+  const wanted = new Set(pageIds2);
+  const fresh = new Map(partial.pages.map((page) => [page.id, page]));
+  if (fresh.size !== wanted.size || ![...wanted].every((id3) => fresh.has(id3))) return void 0;
+  const before = new Map(previous.pages.map((page) => [page.id, page]));
+  if (![...wanted].every((id3) => before.has(id3))) return void 0;
+  for (const [id3, page] of fresh)
+    if (before.get(id3).backgroundPageId === void 0) delete page.backgroundPageId;
+  const pages = previous.pages.map((page) => fresh.get(page.id) ?? page);
+  if (pages.reduce((sum, page) => sum + countShapes(page.shapes), 0) > (options2.maxShapes ?? DEFAULT_MAX_SHAPES))
+    return void 0;
+  const diagnostics = spliceDiagnostics(previous.diagnostics, partial.diagnostics, wanted);
+  if (!diagnostics) return void 0;
+  return { ...previous, pages, diagnostics };
+}
+function spliceDiagnostics(previous, partial, wanted) {
+  const truncated = (list2) => list2.some((d) => d.code === "diagnostics-truncated");
+  if (truncated(previous) || truncated(partial)) return void 0;
+  const fresh = partial.filter((d) => isPageDiagnostic(d) && wanted.has(d.pageId));
+  if (previous.length + fresh.length > MAX_SPLICED_DIAGNOSTICS) return void 0;
+  let out = [...previous];
+  for (const id3 of wanted) {
+    const next = fresh.filter((d) => d.pageId === id3);
+    const at2 = out.flatMap((d, i) => isPageDiagnostic(d) && d.pageId === id3 ? [i] : []);
+    if (!at2.length) {
+      if (next.length) return void 0;
+      continue;
+    }
+    const first2 = at2[0];
+    const last = at2[at2.length - 1];
+    if (last - first2 + 1 !== at2.length) return void 0;
+    out = [...out.slice(0, first2), ...next, ...out.slice(last + 1)];
+  }
+  return out;
+}
+async function parseVsdxPages(input, previous, pageIds2, options2 = {}) {
+  const partial = await parseVsdx(input, { ...options2, pages: pageIds2 });
+  return mergeVisioPages(previous, partial, pageIds2, {
+    ...options2.maxShapes !== void 0 ? { maxShapes: options2.maxShapes } : {}
+  });
+}
+
 // visio/visibility.ts
 var VISIO_VISIBILITY_LIMITS = Object.freeze({
   maxShapes: 25e3,
@@ -48897,10 +49047,12 @@ exports.isVisioStencilShape = isVisioStencilShape;
 exports.isVisioThemeColorRef = isVisioThemeColorRef;
 exports.layoutVisioFilledArrowLine = layoutVisioFilledArrowLine;
 exports.loadVisio = loadVisio;
+exports.mergeVisioPages = mergeVisioPages;
 exports.parseLegacyVsd = parseLegacyVsd;
 exports.parseVisioFormula = parseVisioFormula;
 exports.parseVisioThemeColorFormula = parseVisioThemeColorFormula;
 exports.parseVsdx = parseVsdx;
+exports.parseVsdxPages = parseVsdxPages;
 exports.readVisioStencil = readVisioStencil;
 exports.resolveVisioPageVisibility = resolveVisioPageVisibility;
 exports.resolveVisioThemeColor = resolveVisioThemeColor;