ooxml-core 1.22.0 → 1.23.0

package/dist/visio/collab/snapshot.d.ts

@@ -1,10 +1,14 @@
-import JSZip from 'jszip';
 import type { DrawingKeys } from './keys.js';
+import type { Piece } from './pieces.js';
 import type { ConnectEntry } from './schema.js';
+export { type Layout, type LocalItem, readLayout, readLocalItems, readZip, zipText, } from './snapshot-io.js';
 export interface ShapeSnapshot {
     key: string;
     id: string;
-    xml: string;
+    /** Key of the shape this one is nested in. */
+    parent?: string;
+    open: string;
+    pieces: Piece[];
 }
 export interface ConnectSnapshot {
     key: string;
@@ -18,14 +22,39 @@ export interface PageSnapshot {
     shell: string;
     rels?: string;
     path: string;
+    /** Every shape of the page, parents before the shapes nested in them. */
+    shapes: ShapeSnapshot[];
+    connects: ConnectSnapshot[];
+}
+export interface MasterSnapshot {
+    key: string;
+    id: string;
+    xml: string;
+    path: string;
+    /** The master part with its shapes and connects replaced by markers. */
+    part: Uint8Array;
+    rels?: string;
+    /** Every shape of the master's content, parents before the shapes nested in them. */
     shapes: ShapeSnapshot[];
     connects: ConnectSnapshot[];
 }
+export interface MediaSnapshot {
+    path: string;
+    hash: string;
+    ct: string;
+    d: boolean;
+    data: Uint8Array;
+}
 export interface DrawingSnapshot {
     pagesPath: string;
     pagesOpen: string;
     pagesClose: string;
     pages: PageSnapshot[];
+    mastersPath?: string;
+    mastersOpen?: string;
+    mastersClose?: string;
+    masters: MasterSnapshot[];
+    media: MediaSnapshot[];
     parts: Map<string, Uint8Array>;
 }
 export interface SnapshotOptions {
@@ -35,27 +64,5 @@ export interface SnapshotOptions {
 export declare const DEFAULT_MAX_PART_BYTES: number;
 /** The ids of a shape element and of every shape nested in it, outermost first. */
 export declare function shapeIds(xml: string): string[];
-export declare const readZip: (bytes: Uint8Array) => Promise<JSZip>;
-export declare const zipText: (zip: JSZip, path: string) => Promise<string | undefined>;
-export interface Layout {
-    documentPath: string;
-    pagesPath: string;
-}
-/** The document and pages parts of a package, through its relationships. */
-export declare function readLayout(zip: JSZip): Promise<Layout | undefined>;
-export interface LocalPage {
-    id: string;
-    text: string;
-    path: string;
-    rel: {
-        start: number;
-        end: number;
-    };
-}
-/** The `Page` elements of a pages part with the part each one points to. */
-export declare function readLocalPages(zip: JSZip, layout: Layout, pagesXml: string): Promise<{
-    box: import("./scan.js").Container;
-    pages: LocalPage[];
-} | undefined>;
 export declare function snapshotDrawing(bytes: Uint8Array, keys: DrawingKeys, options?: SnapshotOptions): Promise<DrawingSnapshot>;
 //# sourceMappingURL=snapshot.d.ts.map

package/dist/visio/collab/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../visio/collab/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAa1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACZ;AACD,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAGvD,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C;AAmBD,eAAO,MAAM,OAAO,UAAW,UAAU,KAAG,OAAO,CAAC,KAAK,CAA2B,CAAC;AACrF,eAAO,MAAM,OAAO,QAAe,KAAK,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CACnD,CAAC;AAEjC,MAAM,WAAW,MAAM;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,wBAAsB,UAAU,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAWxE;AAED,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;;;eA0BhF;AAED,wBAAsB,eAAe,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAgF1B"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../visio/collab/snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7C,OAAO,EACN,KAAK,MAAM,EACX,KAAK,SAAS,EACd,UAAU,EACV,cAAc,EACd,OAAO,EACP,OAAO,GACP,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,EAAE,CAAC;CAChB;AACD,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,OAAO,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAGvD,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C;AAED,wBAAsB,eAAe,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,eAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAkD1B"}

package/dist/visio/collab/write-parts.d.ts

@@ -0,0 +1,8 @@
+import type { DrawingSnapshot } from './snapshot.js';
+import { type WriteContext } from './write-shapes.js';
+export declare const mediaKey: (hash: string, path: string) => string;
+export declare function syncMasters(ctx: WriteContext, snapshot: DrawingSnapshot): void;
+export declare function syncMedia(ctx: WriteContext, snapshot: DrawingSnapshot): void;
+/** Writes every other part whole, last write wins; returns the number of deletions. */
+export declare function syncParts(ctx: WriteContext, snapshot: DrawingSnapshot): number;
+//# sourceMappingURL=write-parts.d.ts.map

package/dist/visio/collab/write-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-parts.d.ts","sourceRoot":"","sources":["../../../visio/collab/write-parts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAuC,MAAM,gBAAgB,CAAC;AAExF,eAAO,MAAM,QAAQ,SAAU,MAAM,QAAQ,MAAM,KAAG,MAA2B,CAAC;AAElF,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAgC9E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAiB5E;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAgB9E"}

package/dist/visio/collab/write-shapes.d.ts

@@ -0,0 +1,30 @@
+import * as Y from 'yjs';
+import type { DrawingKeys } from './keys.js';
+import { type SharedDrawing } from './schema.js';
+import type { ConnectSnapshot, ShapeSnapshot } from './snapshot.js';
+export interface WriteContext {
+    shared: SharedDrawing;
+    keys: DrawingKeys;
+    /** Baseline of what is written or kept by this pass. */
+    now: Map<string, string>;
+    /** Shared by every entry created or rewritten in this pass. */
+    batch: string;
+    write(map: Y.Map<unknown>, key: string, value: unknown): void;
+}
+/**
+ * Writes `local()` when it differs from this peer's baseline (a local edit) or the room has no
+ * entry; otherwise keeps the room's value (a collaborator's change not applied here yet), with the
+ * local position. `stamp` records the batch on an entry that is written.
+ */
+export declare function syncEntry<T extends {
+    pos?: number;
+    b?: string;
+}>(ctx: WriteContext, map: Y.Map<unknown>, mapKey: string, id: string, content: string, room: T | undefined, roomContent: () => string, local: () => T, stamp?: boolean): void;
+/** Writes the connects of a page or master that the room does not hold (or that are new here). */
+export declare function syncConnects(ctx: WriteContext, connects: readonly ConnectSnapshot[]): void;
+/** Writes the shapes of a page, or of a master's content (`page.key` is then its scope). */
+export declare function syncShapes(ctx: WriteContext, page: {
+    key: string;
+    shapes: readonly ShapeSnapshot[];
+}): void;
+//# sourceMappingURL=write-shapes.d.ts.map

package/dist/visio/collab/write-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-shapes.d.ts","sourceRoot":"","sources":["../../../visio/collab/write-shapes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,EAGN,KAAK,aAAa,EAGlB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,wDAAwD;IACxD,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EACnB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,GAAG,SAAS,EACnB,WAAW,EAAE,MAAM,MAAM,EACzB,KAAK,EAAE,MAAM,CAAC,EACd,KAAK,UAAQ,GACX,IAAI,CAWN;AAeD,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAM1F;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CACzB,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,GACrD,IAAI,CAgDN"}

package/dist/visio/collab/write.d.ts

@@ -1,20 +1,8 @@
+import { bodyContent, bodyId, connectId, pageContent, pageId } from './baseline.js';
 import type { DrawingKeys } from './keys.js';
-import type { DrawingSnapshot } from './snapshot.js';
 import { type SharedDrawing } from './schema.js';
-export declare const pageId: (key: string) => string;
-export declare const bodyId: (key: string) => string;
-export declare const shapeId: (page: string, key: string) => string;
-export declare const connectId: (key: string) => string;
-/** Baseline text of a page entry (its position excluded) and of a body. */
-export declare const pageContent: (e: {
-    id: string;
-    back?: string | undefined;
-    xml: string;
-}) => string;
-export declare const bodyContent: (e: {
-    shell: string;
-    rels?: string | undefined;
-}) => string;
-/** Writes `snapshot` into `shared`; returns the number of entries changed. */
+import type { DrawingSnapshot } from './snapshot.js';
+export { bodyId, connectId, pageContent, bodyContent, pageId };
+/** Writes `snapshot` into `shared`; returns the number of entries changed. Throws on another schema version. */
 export declare function writeSharedDrawing(shared: SharedDrawing, snapshot: DrawingSnapshot, keys: DrawingKeys): number;
 //# sourceMappingURL=write.d.ts.map

package/dist/visio/collab/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../visio/collab/write.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAGN,KAAK,aAAa,EAKlB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC1D,eAAO,MAAM,MAAM,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC1D,eAAO,MAAM,OAAO,SAAU,MAAM,OAAO,MAAM,KAAG,MAA4B,CAAC;AACjF,eAAO,MAAM,SAAS,QAAS,MAAM,KAAG,MAAoB,CAAC;AAC7D,2EAA2E;AAC3E,eAAO,MAAM,WAAW,MAAO;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,MACnC,CAAC;AACtD,eAAO,MAAM,WAAW,MAAO;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAAG,MAC7B,CAAC;AAElD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,GACf,MAAM,CAqGR"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../visio/collab/write.ts"],"names":[],"mappings":"AAOA,OAAO,EACN,WAAW,EACX,MAAM,EACN,SAAS,EAGT,WAAW,EACX,MAAM,EACN,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAIN,KAAK,aAAa,EAKlB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAe/D,gHAAgH;AAChH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,GACf,MAAM,CA4GR"}

package/dist/visio/index.cjs

@@ -24216,6 +24216,7 @@ async function parseVsdx(input, options2 = {}) {
     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 +24226,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 +24336,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 +24353,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 +33882,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 +48948,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;

package/dist/visio/index.d.ts

@@ -8,6 +8,7 @@ export { parseVsdx, getVisioPageLayers, type ParseVsdxOptions } from './parser.j
 export { readVisioStencil, type VisioStencilFile } from './stencil-file.js';
 export { visioPrintTileCount, VISIO_PRINT_COUNT_LIMITS, type VisioPrintTileCountResult, } from './print-count.js';
 export { loadVisio } from './load.js';
+export { mergeVisioPages, parseVsdxPages } from './parse-incremental.js';
 export { parseLegacyVsd, type ParseLegacyVsdOptions } from './legacy.js';
 export { VisioPackageError, type VisioPackageLimits } from './package.js';
 export { resolveVisioPageVisibility, VISIO_VISIBILITY_LIMITS, type VisioVisibilityOptions, type VisioResolvedShapeVisibility, } from './visibility.js';

package/dist/visio/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../visio/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../visio/index.ts"],"names":[],"mappings":"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"}

package/dist/visio/index.mjs

@@ -24210,6 +24210,7 @@ async function parseVsdx(input, options2 = {}) {
     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);
@@ -24219,6 +24220,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 });
@@ -24328,16 +24330,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(
@@ -24345,7 +24347,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.",
@@ -33874,6 +33876,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,
@@ -48802,4 +48853,4 @@ function checkVisioAlternativeText(document) {
   return issues;
 }
 
-export { EmfBitmapError, VISIO_ARROW_SHAPES, VISIO_BACKGROUND_STYLES, VISIO_BASIC_SHAPES, VISIO_BASIC_STENCIL, VISIO_BORDER_STYLES, VISIO_BUILT_IN_STENCILS, VISIO_BUILT_IN_THEMES, VISIO_BUILT_IN_THEME_IDS, VISIO_CALLOUT_STYLES, VISIO_CHART_OBJECT_MAX_BYTES, VISIO_CLIPBOARD_MAGIC, VISIO_CLIPBOARD_MAX_CHARS, VISIO_COMMENT_AUTHOR_LIMIT, VISIO_COMMENT_LIMIT, VISIO_COMMENT_TEXT_LIMIT, VISIO_CONNECTOR_ROUTES, VISIO_CONTAINER_HEADING, VISIO_CONTAINER_MARGIN, VISIO_CONTAINER_STYLES, VISIO_DATA_LIMITS, VISIO_EMF_ADMISSION_LIMITS, VISIO_FIELD_FORMATS, VISIO_FIELD_FUNCTIONS, VISIO_FLOWCHART_SHAPES, VISIO_FOREIGN_VECTOR_LIMITS, VISIO_GLOW_SIZES, VISIO_GLOW_TRANSPARENCY, VISIO_GLUE, VISIO_GRID_DENSITIES, VISIO_LAYER_NAME_LIMIT, VISIO_LINE_JUMP_LIMITS, VISIO_LINE_JUMP_WIDTH, VISIO_MANAGED_BACKGROUND, VISIO_METADATA_TEXT_LIMIT, VISIO_PAGE_LAYOUT_DEFAULTS, VISIO_PATH_SEGMENT_LIMIT, VISIO_PICTURE_MAX_BYTES, VISIO_PRINT_COUNT_LIMITS, VISIO_QUICK_STYLE_COLORS, VISIO_QUICK_STYLE_VARIANT_COLORS, VISIO_RASTER_IMAGE_LIMITS, VISIO_REFLECTION_PRESETS, VISIO_RULER_DENSITIES, VISIO_SCALE_UNITS, VISIO_SHADOW_PRESETS, VISIO_SHAPE_DATA_TYPES, VISIO_SNAP, VISIO_SNAP_GLUE_DEFAULTS, VISIO_SOFT_EDGE_SIZES, VISIO_STENCILS, VISIO_STENCIL_FILES, VISIO_TEXT_CASES, VISIO_TEXT_POSITIONS, VISIO_THEME_COLOR_SLOTS, VISIO_UNTHEMED_COLORS, VISIO_VISIBILITY_LIMITS, VisioForeignVectorError, VisioFormulaError, VisioImageError, VisioPackageError, analyzeVisioFormula, canonicalShapeDataValue, captureVisioClipboard, checkVisioAlternativeText, convertVisioMetafile, createVsdx, deserializeVisioClipboard, designTextMeasurer, editVsdx, encodeBitmapEmf, evaluateVisioFormula, evaluateVisioTextField, formatVisioFieldValue, getVisioPageLayers, inspectVisioEmfAdmission, inspectVisioRasterImage, isVisioBasicShape, isVisioBuiltInThemeId, isVisioChangeShapeTarget, isVisioDiagramPartEdit, isVisioLayerName, isVisioOutlineShape, isVisioQuickStyleColor, isVisioShadowPreset, isVisioStencilShape, isVisioThemeColorRef, layoutVisioFilledArrowLine, loadVisio, parseLegacyVsd, parseVisioFormula, parseVisioThemeColorFormula, parseVsdx, readVisioStencil, resolveVisioPageVisibility, resolveVisioThemeColor, sanitizeVisioForeignVectorTree, serializeVisioClipboard, setVisioTextMeasurer, trimVisioArrowLine, validateVisioForeignVector, visioBackgroundShapes, visioBasicShapeOutline, visioBorderShapes, visioBuiltInMaster, visioBuiltInStencil, visioBuiltInTheme, visioCircleThrough, visioCurvedRoute, visioDecorationName, visioFallbackQuickStyle, visioFilledArrow, visioFitFreeform, visioFitPencil, visioFontAssumed, visioFormulaCachedValue, visioLineJumpPaths, visioLinkedRowNames, visioOpenArrowExtent, visioOpenArrowPath, visioOrthogonalRoute, visioOutlineShape, visioPageLayout, visioPageThemeColors, visioPathBounds, visioPathSamples, visioPrintTileCount, visioQuarterArc, visioShade, visioShadowPresetGeometry, visioShapeDataRowName, visioShapeStructure, visioSimplifyPath, visioSnapGlue, visioStencilMaster, visioStencilShapeOutline, visioTextExtents, visioThemeColorFormula, visioThemeVariantColors, visioThemeXml };
+export { EmfBitmapError, VISIO_ARROW_SHAPES, VISIO_BACKGROUND_STYLES, VISIO_BASIC_SHAPES, VISIO_BASIC_STENCIL, VISIO_BORDER_STYLES, VISIO_BUILT_IN_STENCILS, VISIO_BUILT_IN_THEMES, VISIO_BUILT_IN_THEME_IDS, VISIO_CALLOUT_STYLES, VISIO_CHART_OBJECT_MAX_BYTES, VISIO_CLIPBOARD_MAGIC, VISIO_CLIPBOARD_MAX_CHARS, VISIO_COMMENT_AUTHOR_LIMIT, VISIO_COMMENT_LIMIT, VISIO_COMMENT_TEXT_LIMIT, VISIO_CONNECTOR_ROUTES, VISIO_CONTAINER_HEADING, VISIO_CONTAINER_MARGIN, VISIO_CONTAINER_STYLES, VISIO_DATA_LIMITS, VISIO_EMF_ADMISSION_LIMITS, VISIO_FIELD_FORMATS, VISIO_FIELD_FUNCTIONS, VISIO_FLOWCHART_SHAPES, VISIO_FOREIGN_VECTOR_LIMITS, VISIO_GLOW_SIZES, VISIO_GLOW_TRANSPARENCY, VISIO_GLUE, VISIO_GRID_DENSITIES, VISIO_LAYER_NAME_LIMIT, VISIO_LINE_JUMP_LIMITS, VISIO_LINE_JUMP_WIDTH, VISIO_MANAGED_BACKGROUND, VISIO_METADATA_TEXT_LIMIT, VISIO_PAGE_LAYOUT_DEFAULTS, VISIO_PATH_SEGMENT_LIMIT, VISIO_PICTURE_MAX_BYTES, VISIO_PRINT_COUNT_LIMITS, VISIO_QUICK_STYLE_COLORS, VISIO_QUICK_STYLE_VARIANT_COLORS, VISIO_RASTER_IMAGE_LIMITS, VISIO_REFLECTION_PRESETS, VISIO_RULER_DENSITIES, VISIO_SCALE_UNITS, VISIO_SHADOW_PRESETS, VISIO_SHAPE_DATA_TYPES, VISIO_SNAP, VISIO_SNAP_GLUE_DEFAULTS, VISIO_SOFT_EDGE_SIZES, VISIO_STENCILS, VISIO_STENCIL_FILES, VISIO_TEXT_CASES, VISIO_TEXT_POSITIONS, VISIO_THEME_COLOR_SLOTS, VISIO_UNTHEMED_COLORS, VISIO_VISIBILITY_LIMITS, VisioForeignVectorError, VisioFormulaError, VisioImageError, VisioPackageError, analyzeVisioFormula, canonicalShapeDataValue, captureVisioClipboard, checkVisioAlternativeText, convertVisioMetafile, createVsdx, deserializeVisioClipboard, designTextMeasurer, editVsdx, encodeBitmapEmf, evaluateVisioFormula, evaluateVisioTextField, formatVisioFieldValue, getVisioPageLayers, inspectVisioEmfAdmission, inspectVisioRasterImage, isVisioBasicShape, isVisioBuiltInThemeId, isVisioChangeShapeTarget, isVisioDiagramPartEdit, isVisioLayerName, isVisioOutlineShape, isVisioQuickStyleColor, isVisioShadowPreset, isVisioStencilShape, isVisioThemeColorRef, layoutVisioFilledArrowLine, loadVisio, mergeVisioPages, parseLegacyVsd, parseVisioFormula, parseVisioThemeColorFormula, parseVsdx, parseVsdxPages, readVisioStencil, resolveVisioPageVisibility, resolveVisioThemeColor, sanitizeVisioForeignVectorTree, serializeVisioClipboard, setVisioTextMeasurer, trimVisioArrowLine, validateVisioForeignVector, visioBackgroundShapes, visioBasicShapeOutline, visioBorderShapes, visioBuiltInMaster, visioBuiltInStencil, visioBuiltInTheme, visioCircleThrough, visioCurvedRoute, visioDecorationName, visioFallbackQuickStyle, visioFilledArrow, visioFitFreeform, visioFitPencil, visioFontAssumed, visioFormulaCachedValue, visioLineJumpPaths, visioLinkedRowNames, visioOpenArrowExtent, visioOpenArrowPath, visioOrthogonalRoute, visioOutlineShape, visioPageLayout, visioPageThemeColors, visioPathBounds, visioPathSamples, visioPrintTileCount, visioQuarterArc, visioShade, visioShadowPresetGeometry, visioShapeDataRowName, visioShapeStructure, visioSimplifyPath, visioSnapGlue, visioStencilMaster, visioStencilShapeOutline, visioTextExtents, visioThemeColorFormula, visioThemeVariantColors, visioThemeXml };

package/dist/visio/parse-incremental.d.ts

@@ -0,0 +1,16 @@
+import type { VisioDocument } from './model.js';
+import { type ParseVsdxOptions } from './parser.js';
+/**
+ * `previous` with the pages of `partial` (read with `pages`) in place of the same pages. Only
+ * valid when the pages part, the masters, styles, theme, media and every other part are the ones
+ * `previous` was read from. Returns undefined when the merge cannot match a whole read.
+ */
+export declare function mergeVisioPages(previous: VisioDocument, partial: VisioDocument, pageIds: readonly string[], options?: {
+    maxShapes?: number;
+}): VisioDocument | undefined;
+/**
+ * Reads the pages `pageIds` of `input` and merges them into `previous`; undefined means read the
+ * whole package. Never throws for a merge that does not apply (a parse error still propagates).
+ */
+export declare function parseVsdxPages(input: Uint8Array | ArrayBuffer, previous: VisioDocument, pageIds: readonly string[], options?: ParseVsdxOptions): Promise<VisioDocument | undefined>;
+//# sourceMappingURL=parse-incremental.d.ts.map

package/dist/visio/parse-incremental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-incremental.d.ts","sourceRoot":"","sources":["../../visio/parse-incremental.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAe5D;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,aAAa,GAAG,SAAS,CAoB3B;AA4BD;;;GAGG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAKpC"}

package/dist/visio/parser.d.ts

@@ -24,6 +24,13 @@ export interface ParseVsdxOptions {
      * packages stay refused.
      */
     stencil?: boolean;
+    /**
+     * Read only the pages with these ids (every other page is skipped after its id is checked).
+     * The result lists just those pages and leaves out what is not per page (comments, data
+     * recordsets, stencil windows, background validation); {@link mergeVisioPages} splices it into
+     * the document read earlier from a package in which only those page parts changed.
+     */
+    pages?: readonly string[];
 }
 /** Read-only VSDX import. This uses cached ShapeSheet values, not a formula engine. */
 export declare function parseVsdx(input: Uint8Array | ArrayBuffer, options?: ParseVsdxOptions): Promise<VisioDocument>;

package/dist/visio/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../visio/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMjD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAGN,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAyBrF,MAAM,WAAW,gBAAgB;IAChC,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAYD,uFAAuF;AACvF,wBAAsB,SAAS,CAC9B,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA6VxB;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAYvF"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../visio/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMjD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAGN,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAyBrF,MAAM,WAAW,gBAAgB;IAChC,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAYD,uFAAuF;AACvF,wBAAsB,SAAS,CAC9B,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA+VxB;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAYvF"}

package/dist/visio/ui/collab-options.d.ts

@@ -1,16 +1,21 @@
-import type { CollabSession, CollaborationOptions } from '../../collab/index.js';
+import type { CollabSession, CollaborationOptions, WriteBackRetry } from '../../collab/index.js';
 import type { VisioPresence } from './collab-presence.js';
 /** Write-back settings of {@link VisioCollaborationOptions}. */
 export interface VisioWriteBackOptions {
     /**
      * Called with the saved VSDX bytes, debounced, after local and remote changes, only in the
-     * window whose `user.role` is `owner`. Returning is not a durable-storage acknowledgement: the
-     * viewer cannot tell whether the host stored the bytes, and a pending write-back is flushed
-     * once when the viewer leaves the room, not retried.
+     * window whose `user.role` is `owner`. Return a promise to acknowledge durable storage: the
+     * viewer then reports `saving`, `saved` or `failed` in `collaborationState.writeBack`, and
+     * retries a rejection as `writeBackRetry` says. A plain return counts as acknowledged at once.
+     * A pending write-back is flushed when the viewer leaves the room and when the page is hidden
+     * or closing; browsers do not wait for asynchronous work then, so a write that needs a network
+     * round trip should use `navigator.sendBeacon` or `fetch(url, { keepalive: true })`.
      */
-    onWriteBack?: (bytes: Uint8Array) => void;
+    onWriteBack?: (bytes: Uint8Array) => void | Promise<void>;
     /** Quiet time after the last change before `onWriteBack` fires. Default 5000. */
     writeBackDebounceMs?: number;
+    /** Retries of a rejected `onWriteBack` with exponential backoff. Default: none. */
+    writeBackRetry?: WriteBackRetry;
 }
 /**
  * The options of `<visio-viewer>.collaboration`. A host-owned `session` should be created with

package/dist/visio/ui/collab-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collab-options.d.ts","sourceRoot":"","sources":["../../../visio/ui/collab-options.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,GAC3F,qBAAqB,GAAG;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CACvD,CAAC"}
+{"version":3,"file":"collab-options.d.ts","sourceRoot":"","sources":["../../../visio/ui/collab-options.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACrC;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mFAAmF;IACnF,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,GAC3F,qBAAqB,GAAG;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CACvD,CAAC"}

package/dist/visio/ui/index.cjs

@@ -27157,6 +27157,7 @@ async function parseVsdx(input, options2 = {}) {
     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 +27167,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 +27277,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 +27294,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.",

package/dist/visio/ui/index.mjs

@@ -27151,6 +27151,7 @@ async function parseVsdx(input, options2 = {}) {
     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);
@@ -27160,6 +27161,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 });
@@ -27269,16 +27271,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(
@@ -27286,7 +27288,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.",