ooxml-core 1.23.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,125 +22470,469 @@ function diagnosticCollector(maxCount) {
   };
 }
 
-// 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";
-var VISIO_COMMENT_LIMIT = 1e4;
-var VISIO_COMMENT_TEXT_LIMIT = 16384;
-var VISIO_COMMENT_AUTHOR_LIMIT = 256;
-var unsigned = (value3) => value3 !== void 0 && /^(0|[1-9]\d{0,9})$/.test(value3) && Number(value3) <= 4294967295 ? value3 : void 0;
-function visioCommentId(entry3, index2) {
-  return unsigned(attribute2(entry3, "CommentID")) ?? `n${index2}`;
-}
-async function readVisioComments(pkg, documentPart2, report) {
-  const path2 = await related(pkg, documentPart2, "comments", false);
-  if (!path2) return [];
-  const root2 = await visioXml(pkg, path2, "Comments");
-  const authors = /* @__PURE__ */ new Map();
-  for (const author of children2(child(root2, "AuthorList"), "AuthorEntry")) {
-    const id3 = unsigned(attribute2(author, "ID"));
-    if (id3 === void 0) continue;
-    const initials = attribute2(author, "Initials");
-    authors.set(id3, {
-      name: (attribute2(author, "Name") ?? "").slice(0, VISIO_COMMENT_AUTHOR_LIMIT),
-      ...initials ? { initials: initials.slice(0, 64) } : {}
-    });
-  }
-  const entries = children2(child(root2, "CommentList"), "CommentEntry");
-  if (entries.length > VISIO_COMMENT_LIMIT) {
-    report("comment-limit", `Only the first ${VISIO_COMMENT_LIMIT} comments are shown.`, {
-      part: path2
-    });
+// 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;
   }
-  const comments = [];
-  const ids = /* @__PURE__ */ new Set();
-  let characters = 0;
-  entries.slice(0, VISIO_COMMENT_LIMIT).forEach((entry3, index2) => {
-    const pageId2 = unsigned(attribute2(entry3, "PageID"));
-    const id3 = visioCommentId(entry3, index2);
-    const text6 = entry3.textContent ?? "";
-    characters += text6.length;
-    if (pageId2 === void 0 || ids.has(id3) || characters > 1e6) {
-      report(
-        "invalid-comment",
-        "A comment without a page, with a repeated ID or over the text budget was omitted.",
-        {
-          part: path2
-        }
-      );
-      return;
-    }
-    ids.add(id3);
-    const shapeId2 = unsigned(attribute2(entry3, "ShapeID"));
-    const author = authors.get(attribute2(entry3, "AuthorID") ?? "");
-    const date2 = attribute2(entry3, "Date");
-    const editDate = attribute2(entry3, "EditDate");
-    comments.push({
-      id: id3,
-      pageId: pageId2,
-      ...shapeId2 && shapeId2 !== "0" ? { shapeId: shapeId2 } : {},
-      author: author?.name ?? "",
-      ...author?.initials ? { initials: author.initials } : {},
-      ...date2 ? { date: date2.slice(0, 64) } : {},
-      ...editDate ? { editDate: editDate.slice(0, 64) } : {},
-      text: text6.slice(0, VISIO_COMMENT_TEXT_LIMIT),
-      ...yes(attribute2(entry3, "Done")) ? { done: true } : {}
-    });
-  });
-  return comments;
+  return { cells: cells4, duplicate };
 }
-function readVisioAnnotations(sheet, pageId2) {
-  return sectionRows(sheet, "Annotation").slice(0, 1e3).flatMap((row2, index2) => {
-    const text6 = row2.cells.get("Comment")?.value;
-    if (!text6) return [];
-    return [
-      {
-        id: `a${pageId2}-${index2}`,
-        pageId: pageId2,
-        author: "",
-        text: text6.slice(0, VISIO_COMMENT_TEXT_LIMIT),
-        legacy: true
-      }
-    ];
-  });
+function createVisioPrintSettingsReader(documentSheets, rootStyles) {
+  const indexes = { document: indexCells2(documentSheets[0]), root: indexCells2(rootStyles[0]) };
+  return (pageSheets) => readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes);
 }
-
-// visio/shape-metadata.ts
-function createMetadataBudget(options2 = {}) {
-  const maxRows = options2.maxRows ?? 1e5, maxCharacters = options2.maxCharacters ?? 5e6;
-  if (![maxRows, maxCharacters].every((v) => Number.isSafeInteger(v) && v > 0))
-    throw new VisioPackageError("INVALID_LIMIT", "Metadata limits must be positive safe integers.");
-  let rows = 0, characters = 0;
-  return {
-    consumeRow() {
-      if (++rows > maxRows)
-        throw new VisioPackageError("METADATA_LIMIT", "Shape metadata row budget exceeded.");
-    },
-    retain(value3) {
-      metadata(value3, 8192, "Shape metadata string");
-      characters += value3.length;
-      if (characters > maxCharacters)
-        throw new VisioPackageError("METADATA_LIMIT", "Shape metadata character budget exceeded.");
-      return value3;
-    }
+function readVisioPrintCountSettings(pageSheets, documentSheets, rootStyles, indexes) {
+  let refusal;
+  const refuse4 = (reason) => {
+    refusal ??= reason;
   };
-}
-var kinds = [
-  "string",
-  "fixed-list",
-  "number",
-  "boolean",
-  "variable-list",
-  "date",
-  "duration",
-  "currency"
-];
-var numeric3 = (text6) => {
-  if (text6 === void 0 || text6.length > 128 || !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(text6.trim()))
-    return void 0;
-  const value3 = Number(text6);
-  return Number.isFinite(value3) ? value3 : void 0;
-};
+  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";
+var VISIO_COMMENT_LIMIT = 1e4;
+var VISIO_COMMENT_TEXT_LIMIT = 16384;
+var VISIO_COMMENT_AUTHOR_LIMIT = 256;
+var unsigned = (value3) => value3 !== void 0 && /^(0|[1-9]\d{0,9})$/.test(value3) && Number(value3) <= 4294967295 ? value3 : void 0;
+function visioCommentId(entry3, index2) {
+  return unsigned(attribute2(entry3, "CommentID")) ?? `n${index2}`;
+}
+async function readVisioComments(pkg, documentPart2, report) {
+  const path2 = await related(pkg, documentPart2, "comments", false);
+  if (!path2) return [];
+  const root2 = await visioXml(pkg, path2, "Comments");
+  const authors = /* @__PURE__ */ new Map();
+  for (const author of children2(child(root2, "AuthorList"), "AuthorEntry")) {
+    const id3 = unsigned(attribute2(author, "ID"));
+    if (id3 === void 0) continue;
+    const initials = attribute2(author, "Initials");
+    authors.set(id3, {
+      name: (attribute2(author, "Name") ?? "").slice(0, VISIO_COMMENT_AUTHOR_LIMIT),
+      ...initials ? { initials: initials.slice(0, 64) } : {}
+    });
+  }
+  const entries = children2(child(root2, "CommentList"), "CommentEntry");
+  if (entries.length > VISIO_COMMENT_LIMIT) {
+    report("comment-limit", `Only the first ${VISIO_COMMENT_LIMIT} comments are shown.`, {
+      part: path2
+    });
+  }
+  const comments = [];
+  const ids = /* @__PURE__ */ new Set();
+  let characters = 0;
+  entries.slice(0, VISIO_COMMENT_LIMIT).forEach((entry3, index2) => {
+    const pageId2 = unsigned(attribute2(entry3, "PageID"));
+    const id3 = visioCommentId(entry3, index2);
+    const text6 = entry3.textContent ?? "";
+    characters += text6.length;
+    if (pageId2 === void 0 || ids.has(id3) || characters > 1e6) {
+      report(
+        "invalid-comment",
+        "A comment without a page, with a repeated ID or over the text budget was omitted.",
+        {
+          part: path2
+        }
+      );
+      return;
+    }
+    ids.add(id3);
+    const shapeId2 = unsigned(attribute2(entry3, "ShapeID"));
+    const author = authors.get(attribute2(entry3, "AuthorID") ?? "");
+    const date2 = attribute2(entry3, "Date");
+    const editDate = attribute2(entry3, "EditDate");
+    comments.push({
+      id: id3,
+      pageId: pageId2,
+      ...shapeId2 && shapeId2 !== "0" ? { shapeId: shapeId2 } : {},
+      author: author?.name ?? "",
+      ...author?.initials ? { initials: author.initials } : {},
+      ...date2 ? { date: date2.slice(0, 64) } : {},
+      ...editDate ? { editDate: editDate.slice(0, 64) } : {},
+      text: text6.slice(0, VISIO_COMMENT_TEXT_LIMIT),
+      ...yes(attribute2(entry3, "Done")) ? { done: true } : {}
+    });
+  });
+  return comments;
+}
+function readVisioAnnotations(sheet, pageId2) {
+  return sectionRows(sheet, "Annotation").slice(0, 1e3).flatMap((row2, index2) => {
+    const text6 = row2.cells.get("Comment")?.value;
+    if (!text6) return [];
+    return [
+      {
+        id: `a${pageId2}-${index2}`,
+        pageId: pageId2,
+        author: "",
+        text: text6.slice(0, VISIO_COMMENT_TEXT_LIMIT),
+        legacy: true
+      }
+    ];
+  });
+}
+
+// visio/shape-metadata.ts
+function createMetadataBudget(options2 = {}) {
+  const maxRows = options2.maxRows ?? 1e5, maxCharacters = options2.maxCharacters ?? 5e6;
+  if (![maxRows, maxCharacters].every((v) => Number.isSafeInteger(v) && v > 0))
+    throw new VisioPackageError("INVALID_LIMIT", "Metadata limits must be positive safe integers.");
+  let rows = 0, characters = 0;
+  return {
+    consumeRow() {
+      if (++rows > maxRows)
+        throw new VisioPackageError("METADATA_LIMIT", "Shape metadata row budget exceeded.");
+    },
+    retain(value3) {
+      metadata(value3, 8192, "Shape metadata string");
+      characters += value3.length;
+      if (characters > maxCharacters)
+        throw new VisioPackageError("METADATA_LIMIT", "Shape metadata character budget exceeded.");
+      return value3;
+    },
+    state: () => [rows, characters],
+    restore(state) {
+      [rows, characters] = state;
+    }
+  };
+}
+var kinds = [
+  "string",
+  "fixed-list",
+  "number",
+  "boolean",
+  "variable-list",
+  "date",
+  "duration",
+  "currency"
+];
+var numeric3 = (text6) => {
+  if (text6 === void 0 || text6.length > 128 || !/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(text6.trim()))
+    return void 0;
+  const value3 = Number(text6);
+  return Number.isFinite(value3) ? value3 : void 0;
+};
 function cached(cells4, key2, budget, report) {
   const cell = cells4.get(key2);
   if (!cell) return void 0;
@@ -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,10 +24270,46 @@ 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.");