ooxml-core 1.23.0 → 1.24.0

package/dist/visio/layers.d.ts

@@ -4,6 +4,9 @@ import { type Resources } from './style.js';
 export interface LayerBudget {
     consumeCharacters(count: number): void;
     consumeMemberships(count: number): void;
+    /** What has been consumed so far, to be put back with {@link restore}. */
+    state(): [memberships: number, characters: number];
+    restore(state: readonly [number, number]): void;
 }
 /** Share across pages and inherited instances to bound normalization work and arrays. */
 export declare function createLayerBudget(): LayerBudget;

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

@@ -1 +1 @@
-{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../visio/layers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGlE,OAAO,EAAuB,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC3B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AACD,yFAAyF;AACzF,wBAAgB,iBAAiB,IAAI,WAAW,CAkB/C;AACD,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAI1F;AACD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAqB3F;AACD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,WAAiC,GACvC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,sBAAsB,CAAA;CAAE,CAoD/E"}
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../visio/layers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGlE,OAAO,EAAuB,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC3B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,0EAA0E;IAC1E,KAAK,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAChD;AACD,yFAAyF;AACzF,wBAAgB,iBAAiB,IAAI,WAAW,CAsB/C;AACD,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAI1F;AACD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAqB3F;AACD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,WAAiC,GACvC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,sBAAsB,CAAA;CAAE,CAoD/E"}

package/dist/visio/package.d.ts

@@ -10,11 +10,20 @@ export declare class VisioPackage {
     private readonly relationshipCache;
     private readonly byteCache;
     private readonly decodedNames;
+    private noted;
     private totalOutput;
     private totalXmlNodes;
     private constructor();
     private check;
     static open(input: Uint8Array | ArrayBuffer, options?: Partial<VisioPackageLimits>): Promise<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(): () => [string, string][];
+    /** The declared CRC-32 and size of a part, or an empty string when the package lacks it. */
+    printOf(path: string): string;
     has(path: string): boolean;
     paths(): string[];
     readXml(path: string, expectedRoot?: string): Promise<Element>;

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

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../visio/package.ts"],"names":[],"mappings":"AAEA,OAAO,EAQN,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC7B,MAAM,kBAAkB,CAAC;AAiB1B,sFAAsF;AACtF,qBAAa,YAAY;IAWvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAb1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IACJ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,eAQN;IACD,OAAO,CAAC,KAAK,CAGX;IAEF,OAAa,IAAI,CAChB,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,OAAO,CAAC,YAAY,CAAC,CA+BvB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IACD,KAAK,IAAI,MAAM,EAAE,CAIhB;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAanE;IAED,wFAAwF;IACxF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtC;IACD,0EAA0E;IACpE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAWjD;YAEa,SAAS;YA8ET,OAAO;IA0Bf,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAQtF;YACa,iBAAiB;CAoC/B"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../visio/package.ts"],"names":[],"mappings":"AAEA,OAAO,EAQN,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC7B,MAAM,kBAAkB,CAAC;AAiB1B,sFAAsF;AACtF,qBAAa,YAAY;IAYvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAd1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IACJ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,eAQN;IACD,OAAO,CAAC,KAAK,CAGX;IAEF,OAAa,IAAI,CAChB,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,OAAO,CAAC,YAAY,CAAC,CA+BvB;IAED;;;;OAIG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAOjC;IACD,4FAA4F;IAC5F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5B;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzB;IACD,KAAK,IAAI,MAAM,EAAE,CAIhB;IAEK,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcnE;IAED,wFAAwF;IACxF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtC;IACD,0EAA0E;IACpE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAYjD;YAEa,SAAS;YA8ET,OAAO;IA0Bf,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAYtF;YACa,iBAAiB;CAqC/B"}

package/dist/visio/parser.d.ts

@@ -1,6 +1,7 @@
 import type { VisioMetafileTreeConverter } from './convert-metafile.js';
 import type { VisioImageOptions } from './media.js';
 import type { VisioDocument, VisioPage } from './model.js';
+import { type VisioDocumentCache } from './document-level.js';
 import { type VisioMetadataOptions } from './shape-metadata.js';
 import { type VisioPackageLimits } from './package.js';
 export interface ParseVsdxOptions {
@@ -31,6 +32,12 @@ export interface ParseVsdxOptions {
      * the document read earlier from a package in which only those page parts changed.
      */
     pages?: readonly string[];
+    /**
+     * Reuse the styles, themes and masters of an earlier read of this drawing when none of the
+     * parts they were read from changed (see {@link VisioDocumentCache}). The result is the one a
+     * read without it gives.
+     */
+    documentCache?: VisioDocumentCache;
 }
 /** 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;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"}
+{"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;AAKjD,OAAO,KAAK,EAAE,aAAa,EAAe,SAAS,EAAE,MAAM,SAAS,CAAC;AAErE,OAAO,EAEN,KAAK,kBAAkB,EAIvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAGN,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAmC,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAuBrF,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;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAYD,uFAAuF;AACvF,wBAAsB,SAAS,CAC9B,KAAK,EAAE,UAAU,GAAG,WAAW,EAC/B,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA8UxB;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAYvF"}

package/dist/visio/shape-metadata.d.ts

@@ -51,6 +51,9 @@ export interface VisioMetadataOptions {
 export interface VisioMetadataBudget {
     consumeRow(): void;
     retain(value: string): string;
+    /** What has been consumed so far, to be put back with {@link restore}. */
+    state(): [rows: number, characters: number];
+    restore(state: readonly [number, number]): void;
 }
 /** Share one budget across every page and inherited shape in a document. */
 export declare function createMetadataBudget(options?: VisioMetadataOptions): VisioMetadataBudget;

package/dist/visio/shape-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape-metadata.d.ts","sourceRoot":"","sources":["../../visio/shape-metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAS,MAAM,EAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAGzD,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EACN,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,eAAe,GACf,MAAM,GACN,UAAU,GACV,UAAU,GACV,UAAU,CAAC;IACd,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,MAAM,EACH;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAClC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AACD,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,mBAAmB;IACnC,UAAU,IAAI,IAAI,CAAC;IACnB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AACD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAoB5F;AAyMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,GACzB;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAgB3D;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,sBAAyB,GAC7B;IACF,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB,CAwBA"}
+{"version":3,"file":"shape-metadata.d.ts","sourceRoot":"","sources":["../../visio/shape-metadata.ts"],"names":[],"mappings":"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"}

package/dist/visio/ui/contract.d.ts

@@ -1,9 +1,14 @@
 import type { RibbonAddInCommandDetail, RibbonAddInTab } from '../../ribbon/index.js';
 import type { CollaborationState } from '../../collab/index.js';
+import type { DocumentStorage, FileCommandDetail, VisioFileCommand } from '../../embedding/index.js';
 import type { VisioCollaborationOptions } from './collab-options.js';
 import type { VisioDocument } from '../index.js';
+import type { VisioCustomization } from './customization.js';
 export interface ViewerProperties {
+    /** The inverse of `readOnly`; false makes the drawing read-only. Default true. */
     canEdit?: boolean;
+    /** Makes the drawing read-only (default false). True wins over `canEdit`. */
+    readOnly?: boolean;
     document: VisioDocument | null;
     pageIndex: number;
     zoom: number;
@@ -12,6 +17,17 @@ export interface ViewerProperties {
     ribbonAddIns: readonly RibbonAddInTab[];
     /** Shares the open drawing in a room while set; null leaves it (the shared embedding contract). */
     collaboration: VisioCollaborationOptions | null;
+    /**
+     * Host-owned storage: File > Save hands the drawing to `storage.save()` instead of downloading
+     * a copy, File > Open asks `storage.open()` when it has one, and AutoRecover keeps its copies
+     * through the storage's recovery methods instead of IndexedDB. null restores the defaults.
+     */
+    storage: DocumentStorage | null;
+    /**
+     * Capabilities, host File tab pages and host menu commands (the shared embedding contract of
+     * `ooxml-core/embedding`); null restores the defaults.
+     */
+    customization: VisioCustomization | null;
 }
 /** A page-scoped shape identity. Omitted pageId means the currently displayed page. */
 export interface VisioShapeSelection {
@@ -36,12 +52,21 @@ export interface ViewerEvents {
     'office-ribbon-add-in': RibbonAddInCommandDetail;
     /** Sharing started, stopped or its status, sync or people changed. */
     'collaboration-change': CollaborationState;
+    /**
+     * Cancelable: New, Open and Save announce themselves first. Call `preventDefault()` on the
+     * event (or return `false` from the binding callback) to handle the command yourself.
+     */
+    'file-command': FileCommandDetail<VisioFileCommand>;
 }
+/**
+ * Binding callbacks. A `file-command` callback that returns `false` cancels the command (a
+ * function returning a boolean is assignable to these void-returning types).
+ */
 export type ViewerCallbacks = {
     [K in keyof ViewerEvents]?: (detail: ViewerEvents[K]) => void;
 };
-export declare const propertyKeys: readonly ["canEdit", "document", "pageIndex", "zoom", "showToolbar", "ribbonAddIns", "collaboration"];
-export declare const eventKeys: readonly ["document-load", "document-change", "document-error", "page-change", "zoom-change", "shape-select", "selection-change", "office-ribbon-add-in", "collaboration-change"];
+export declare const propertyKeys: readonly ["canEdit", "readOnly", "document", "pageIndex", "zoom", "showToolbar", "ribbonAddIns", "collaboration", "storage", "customization"];
+export declare const eventKeys: readonly ["document-load", "document-change", "document-error", "page-change", "zoom-change", "shape-select", "selection-change", "office-ribbon-add-in", "collaboration-change", "file-command"];
 export type VsdxSource = ArrayBuffer | Uint8Array | Blob;
 export interface ViewerOptions extends Partial<ViewerProperties> {
     events?: ViewerCallbacks;

package/dist/visio/ui/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../visio/ui/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,mGAAmG;IACnG,aAAa,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAChD;AACD,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,YAAY;IAC5B,eAAe,EAAE,aAAa,CAAC;IAC/B,iBAAiB,EAAE;QAClB,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;KACnD,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,iFAAiF;IACjF,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,2DAA2D;IAC3D,sBAAsB,EAAE,wBAAwB,CAAC;IACjD,sEAAsE;IACtE,sBAAsB,EAAE,kBAAkB,CAAC;CAC3C;AACD,MAAM,MAAM,eAAe,GAAG;KAC5B,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI;CAC7D,CAAC;AACF,eAAO,MAAM,YAAY,uGAQ+B,CAAC;AACzD,eAAO,MAAM,SAAS,mLAU8B,CAAC;AASrD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AACzD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../visio/ui/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAChC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,mGAAmG;IACnG,aAAa,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAChD;;;;OAIG;IACH,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACzC;AACD,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,YAAY;IAC5B,eAAe,EAAE,aAAa,CAAC;IAC/B,iBAAiB,EAAE;QAClB,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;KACnD,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,iFAAiF;IACjF,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,2DAA2D;IAC3D,sBAAsB,EAAE,wBAAwB,CAAC;IACjD,sEAAsE;IACtE,sBAAsB,EAAE,kBAAkB,CAAC;IAC3C;;;OAGG;IACH,cAAc,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CACpD;AACD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;KAC5B,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI;CAC7D,CAAC;AACF,eAAO,MAAM,YAAY,+IAW+B,CAAC;AACzD,eAAO,MAAM,SAAS,mMAW8B,CAAC;AASrD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AACzD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/visio/ui/customization.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Visio's half of the shared customization contract (`ooxml-core/embedding`): the capabilities
+ * `<visio-viewer>` honours, what each one removes, and the `customization` property's type every
+ * binding forwards. The renderer of a host page receives an `HTMLElement` container, as in the
+ * other editors; nothing here touches the DOM.
+ */
+import type { CapabilityActionMap, EditorCapabilities, EditorCapabilityId, EditorCustomization, HostBackstagePage, HostMenuCommand, HostRegionContextBase, HostRegionRenderer } from '../../embedding/index.js';
+import type { VisioShapeSelection } from './contract.js';
+/** The capabilities Visio honours. */
+export type VisioCapabilityId = Extract<EditorCapabilityId, 'edit' | 'export' | 'print' | 'share' | 'copy' | 'comment' | 'find' | 'open' | 'save' | 'settings'>;
+/** Every Visio capability, for hosts that build a policy screen. */
+export declare const VISIO_CAPABILITY_IDS: readonly ["edit", "export", "print", "share", "copy", "comment", "find", "open", "save", "settings"];
+/** Per-capability switches of `<visio-viewer>`. */
+export type VisioCapabilities = EditorCapabilities<VisioCapabilityId>;
+/** The File tab entries each disabled capability removes. */
+export declare const VISIO_CAPABILITY_BACKSTAGE_PAGES: CapabilityActionMap<VisioCapabilityId, string>;
+/**
+ * The ribbon, context-menu and File tab commands (their `command`, menu or File tab action ids) each disabled capability
+ * hides. The editor also refuses the matching actions however they are raised (a shortcut, a
+ * menu, the API).
+ */
+export declare const VISIO_CAPABILITY_COMMANDS: CapabilityActionMap<VisioCapabilityId, string>;
+/** What a host region (a File tab page) of `<visio-viewer>` receives. */
+export interface VisioRegionContext extends HostRegionContextBase {
+    /** The `<visio-viewer>` element: its whole public API. */
+    readonly viewer: HTMLElement;
+    /** The zero-based index of the page on screen. */
+    readonly pageIndex: number;
+    readonly pageCount: number;
+}
+/** What a host context-menu command of `<visio-viewer>` receives. */
+export interface VisioMenuContext {
+    /** `shape` when the menu opened on a shape, `page` on empty paper. */
+    readonly target: 'shape' | 'page';
+    readonly pageIndex: number;
+    /** The page's id, when a drawing is open. */
+    readonly pageId?: string;
+    /** The selection the menu acts on (empty on the page menu). */
+    readonly shapes: readonly VisioShapeSelection[];
+}
+export type VisioRegionRenderer = HostRegionRenderer<HTMLElement, VisioRegionContext>;
+export type VisioBackstagePage = HostBackstagePage<VisioRegionRenderer>;
+export type VisioMenuCommand = HostMenuCommand<VisioMenuContext>;
+/** The whole `customization` object of `<visio-viewer>`. Every field is optional. */
+export type VisioCustomization = EditorCustomization<VisioCapabilityId, VisioRegionRenderer, VisioMenuContext>;
+//# sourceMappingURL=customization.d.ts.map

package/dist/visio/ui/customization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization.d.ts","sourceRoot":"","sources":["../../../visio/ui/customization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACX,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACtC,kBAAkB,EAClB,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAClG,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,sGAWgB,CAAC;AAElD,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;AAEtE,6DAA6D;AAC7D,eAAO,MAAM,gCAAgC,EAAE,mBAAmB,CAAC,iBAAiB,EAAE,MAAM,CAO3F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAAmB,CAAC,iBAAiB,EAAE,MAAM,CASpF,CAAC;AAEF,yEAAyE;AACzE,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAChE,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;AACtF,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAEjE,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CACnD,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,CAChB,CAAC"}