ooxml-ui 1.20.0 → 1.22.0

package/dist/pptx/render/morph-predicates.d.ts

@@ -39,6 +39,13 @@ export declare function conflictingMorphNames(a: PptxElement, b: PptxElement): b
 export declare function mediaIdentity(el: PptxElement): string | undefined;
 /** Euclidean distance between two elements' top-left corners (slide space). */
 export declare function centreDistance(a: PptxElement, b: PptxElement): number;
+/**
+ * Whether both elements are pictures painting provably different images. Two
+ * nearby pictures of different artwork are not the same object, and pairing
+ * them spins and stretches one into the other (a rotated icon turning into an
+ * unrelated flat picture). Unknown media on either side vetoes nothing.
+ */
+export declare function differentMedia(a: PptxElement, b: PptxElement): boolean;
 /** Whether two elements are the same kind of picture painting the same media. */
 export declare function sameMediaPicture(a: PptxElement, b: PptxElement): boolean;
 /** The `shapeStyle` paint fields that decide what an element looks like. */

package/dist/pptx/render/morph-predicates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"morph-predicates.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/morph-predicates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA8BnD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAMrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAO7E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,CAIrE;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAaxE;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,YAC3B,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,CACH,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAU3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAoBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,UAAU,EAAE,SAAS,WAAW,EAAE,EAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB,OAAO,CAQT"}
+{"version":3,"file":"morph-predicates.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/morph-predicates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA8BnD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAMrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAO7E;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,MAAM,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAOtE;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAaxE;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,YAC3B,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,CACH,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAU3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAyBxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,UAAU,EAAE,SAAS,WAAW,EAAE,EAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB,OAAO,CAQT"}

package/dist/pptx/render/viewer-props-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-props-manifest.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-props-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,eAAe,YAAI,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACnE;AAqBD,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,SAAS,kBAAkB,EAuErD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,kBAAkB,EA4CtD,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAExF;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAgBzF;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AA4CD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,GAC1D,kBAAkB,EAAE,CAKtB"}
+{"version":3,"file":"viewer-props-manifest.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-props-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,eAAe,YAAI,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACnE;AAqBD,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,SAAS,kBAAkB,EAuErD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,kBAAkB,EA+CtD,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAExF;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAgBzF;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AA4CD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,GAC1D,kBAAkB,EAAE,CAKtB"}

package/dist/pptx/types.d.ts

@@ -6,6 +6,7 @@ import type { PptxElement, PptxSlide } from 'ooxml-core/pptx';
  * packages; this is the canonical copy. Each binding layers its own
  * framework-specific prop/event/handle types on top of these.
  */
+import type { ProviderFactory, WebrtcOptions, WriteBackRetry } from 'ooxml-core/collab';
 import type { ExternalCollaborationSession } from './render/collaboration-external-session.js';
 import type { ElementUpdate, ElementUpdateOptions } from './render/element-update-batch.js';
 /** Canvas dimensions in pixels. */
@@ -180,7 +181,9 @@ export type CollaborationSessionIntent = 'create' | 'join';
  * shared `CollaborationOptions` contract (`session`, `user`, `intent`) that Word, Excel
  * and Visio take; see `CollaborationInput` and `resolveCollaborationConfig`. A host
  * `CollabSession` from `ooxml-core/collab` is borrowed (never destroyed) and becomes
- * `externalSession`. `provider` and the BroadcastChannel fallback are not supported here.
+ * `externalSession`. A `provider`, or a room with neither `serverUrl` nor `transport: 'webrtc'`
+ * (a BroadcastChannel between windows of this browser), is opened by the viewer as a session it
+ * owns and destroys; see `openOwnedCollaboration`.
  */
 export interface CollaborationConfig {
     /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
@@ -199,6 +202,17 @@ export interface CollaborationConfig {
      * these resources. Keep this object stable and report readiness via subscribe.
      */
     externalSession?: ExternalCollaborationSession;
+    /**
+     * A provider factory of your own (the shared `CollaborationOptions.provider`). Wins over
+     * `serverUrl`; the viewer creates and destroys the session around it.
+     */
+    provider?: ProviderFactory;
+    /**
+     * Peer-to-peer over the host's own `y-webrtc` class (the shared `CollaborationOptions.webrtc`).
+     * After `provider`, before `serverUrl`; the viewer creates and destroys the session around it,
+     * with `authToken` as the room password unless `webrtc.password` is set.
+     */
+    webrtc?: WebrtcOptions;
     /**
      * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
      * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
@@ -230,13 +244,22 @@ export interface CollaborationConfig {
      * callback so the host can persist the snapshot. Only one writer (the owner)
      * does this; other collaborators never trigger write-back, eliminating the
      * last-save-wins problem.
+     *
+     * Return a promise to acknowledge durable storage: the viewer 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 on
+     * `pagehide` and when the page is hidden, but browsers do not wait for asynchronous work
+     * then: a write that needs a network round trip should use `navigator.sendBeacon` or
+     * `fetch(url, { keepalive: true })` to survive a close.
      */
-    onWriteBack?: (bytes: Uint8Array) => void;
+    onWriteBack?: (bytes: Uint8Array) => void | Promise<void>;
     /**
      * Debounce delay (ms) between the last Y.Doc change and the write-back
      * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
      * (not recommended for large documents).
      */
     writeBackDebounceMs?: number;
+    /** Retries of a rejected `onWriteBack` with exponential backoff. Default: none. */
+    writeBackRetry?: WriteBackRetry;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/pptx/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pptx/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC9D;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAEzF,mCAAmC;AACnC,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAMD,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAMnE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAEnC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAGtC,wDAAwD;IACxD,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,kCAAkC;IAClC,MAAM,EAAE,MAAM,IAAI,CAAC;IAGnB,gEAAgE;IAChE,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,OAAO,CAAC;IAGvB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,sDAAsD;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,2BAA2B;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,IAAI,CAAC;IAGtB,mCAAmC;IACnC,OAAO,EAAE,MAAM,UAAU,CAAC;IAC1B,kEAAkE;IAClE,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAGpC,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,gEAAgE;IAChE,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,sCAAsC;IACtC,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,gDAAgD;IAChD,OAAO,EAAE,MAAM,OAAO,CAAC;IAGvB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,SAAS,SAAS,EAAE,CAAC;IACtC,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,CAAC;IACnD,sCAAsC;IACtC,cAAc,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IAG5C,sEAAsE;IACtE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iFAAiF;IACjF,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,wDAAwD;IACxD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7C,iDAAiD;IACjD,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAG9C;;;;OAIG;IACH,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,SAAS,WAAW,EAAE,CAAC;IAC7D,+EAA+E;IAC/E,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAGpF;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD;;;OAGG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC1E,sGAAsG;IACtG,cAAc,EAAE,CACf,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,CAAC,EAAE,oBAAoB,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,0DAA0D;IAC1D,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C;;;OAGG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAG5D,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,MAAM,EAAE,CAAC;IACtC,qDAAqD;IACrD,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACxC,mCAAmC;IACnC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC3B;AAMD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,4BAA4B;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2BAA2B;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,gBAAgB,EAAE,UAAU,CAAC;IAC7B,2BAA2B;IAC3B,aAAa,EAAE,UAAU,CAAC;IAC1B,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,iCAAiC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oCAAoC;IACpC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,eAAe,EAAE,IAAI,CAAC;IACtB,+BAA+B;IAC/B,aAAa,EAAE,IAAI,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D,0DAA0D;AAC1D,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IACnC,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,4BAA4B,CAAC;IAC/C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pptx/types.ts"],"names":[],"mappings":"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"}

package/dist/pptx/web-components/office-aliases.d.ts

@@ -5,7 +5,7 @@ import type { OFFICE_ALIAS_TAGS } from './office-token-bridge.js';
  * subclass of the shared element, registered under the published pptx name so bindings, tests
  * and hosts keep the same attributes, properties, events and test ids. Differences are translated
  * here, never in callers: event names and test ids through the shared elements' static fields,
- * i18n keys and positioning through the `state` setter. See `docs/ooxml-ui-plan.md` in ooxml.
+ * i18n keys and positioning through the `state` setter. The alias decision is recorded in `docs/ooxml-ui-plan.md` (pptx tags).
  */
 type Ctor = CustomElementConstructor;
 export declare function base(registry: CustomElementRegistry, define: (r: CustomElementRegistry) => void, tag: string): Ctor;

package/dist/teams.js

@@ -1,4 +1,4 @@
-export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, activityTime, applyTeamsProps, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-4XPAPETH.js';
+export { EMOJI, OfficeUiActivityFeed, OfficeUiAppRail, OfficeUiAvatar, OfficeUiCalendarAgenda, OfficeUiCalendarView, OfficeUiCallControls, OfficeUiCallGrid, OfficeUiChannelList, OfficeUiChatComposer, OfficeUiChatList, OfficeUiChatSidebar, OfficeUiPeoplePicker, OfficeUiPrejoin, QUICK_REACTIONS, TEAMS_TAGS, TeamsApp, TeamsChannelTab, TeamsContentPreview, TeamsController, TeamsElement, TeamsFilesPanel, TeamsSettings, activityTime, applyTeamsProps, colorFor, createTeams, dayKind, dayLabel, defineActivityFeed, defineAppRail, defineAvatar, defineCalendarAgenda, defineCalendarView, defineCallControls, defineCallGrid, defineChannelList, defineChatComposer, defineChatList, defineChatSidebar, definePeoplePicker, definePrejoin, defineTeamsApp, defineTeamsChannelTab, defineTeamsContentPreview, defineTeamsFilesPanel, defineTeamsSettings, formatElapsed, formatSize, formatTime, formatWhen, icon, listenTeamsEvents, loadConfig, loadIdentity, parseIceLines, registerTeams, safeStorage, saveConfig, saveIdentity, withStyles } from './chunk-DRBAJ5UO.js';
 export { TeamsPresentationPreview, defineTeamsPresentationPreview } from './chunk-FHO7TEWA.js';
 import './chunk-T5ARELU2.js';
 import './chunk-TJ245GDD.js';

package/dist/visio/building-blocks-shapes.d.ts

@@ -0,0 +1,9 @@
+import type { ViewerController } from './controller.js';
+/**
+ * The Shapes window (Search shapes, the drawing's own stencil and the built-in stencils), mounted
+ * on its own. Dragging a master onto the mounted canvas, or pressing Enter on it, creates the shape
+ * through the same flow as the full viewer, so it obeys the same edit permission.
+ */
+export declare function mountDiagramShapes(host: HTMLElement, controller: ViewerController, options?: {
+    locale?: string | undefined;
+}): () => void;

package/dist/visio/building-blocks-toolbar.d.ts

@@ -0,0 +1,87 @@
+import { type ViewerController, type ViewerState } from './controller.js';
+import { type DiagramTool } from './diagram-tool.js';
+/** Every label a custom toolbar may show; each has an entry in every Visio locale. */
+export declare const DIAGRAM_TOOLBAR_LABEL_KEYS: readonly ['Undo', 'Redo', 'Fit to Window', 'Page', 'Zoom In', 'Zoom Out', 'Duplicate', 'Group', 'Ungroup', 'Delete', 'Cut', 'Copy', 'Paste', 'Find', 'Previous Result', 'Next Result', 'Shapes', 'Pointer Tool', 'Rectangle', 'Ellipse', 'Line', 'Freeform', 'Arc', 'Pencil', 'Text', 'Connector', 'Open', 'Page Setup', 'Options', 'Share'];
+export type DiagramToolbarLabelKey = (typeof DIAGRAM_TOOLBAR_LABEL_KEYS)[number];
+export type DiagramToolbarLabels = Readonly<Record<DiagramToolbarLabelKey, string>>;
+/** What the host may do with the diagram right now: 'view' also covers legacy, source-less files. */
+export type DiagramMode = 'edit' | 'view';
+/**
+ * Dialogs are host-owned, as in the PowerPoint building blocks: the library never opens one in
+ * surface mode. A workflow whose callback is omitted reports not-enabled (`canOpen...` is false
+ * and no `onOpen...` is returned).
+ */
+export interface DiagramToolbarHostCallbacks {
+    onOpenFile?: (() => void) | undefined;
+    onOpenPageSetup?: (() => void) | undefined;
+    onOpenSettings?: (() => void) | undefined;
+    onOpenShareDialog?: (() => void) | undefined;
+}
+export interface DiagramToolSummary {
+    readonly id: DiagramTool;
+    readonly label: string;
+    readonly active: boolean;
+}
+/** Whether the diagram can be edited at all: host permission and a source-backed drawing. */
+export declare function diagramMode(state: Pick<ViewerState, 'canEdit' | 'edit'>): DiagramMode;
+export declare function diagramToolbarProps(controller: ViewerController, fit: () => void, locale?: string, callbacks?: DiagramToolbarHostCallbacks): {
+    labels: Readonly<Record<"Arc" | "Connector" | "Copy" | "Cut" | "Delete" | "Duplicate" | "Ellipse" | "Find" | "Fit to Window" | "Freeform" | "Group" | "Line" | "Next Result" | "Open" | "Options" | "Page" | "Page Setup" | "Paste" | "Pencil" | "Pointer Tool" | "Previous Result" | "Rectangle" | "Redo" | "Shapes" | "Share" | "Text" | "Undo" | "Ungroup" | "Zoom In" | "Zoom Out", string>>;
+    mode: DiagramMode;
+    canEdit: boolean;
+    pageIndex: number;
+    pages: {
+        id: string;
+        name: string;
+    }[];
+    zoom: number;
+    selection: readonly import("ooxml-core/visio/ui").VisioShapeSelection[];
+    canUndo: boolean;
+    canRedo: boolean;
+    canDuplicate: boolean;
+    canGroup: boolean;
+    canUngroup: boolean;
+    canDelete: boolean;
+    canCut: boolean;
+    canCopy: boolean;
+    canPaste: boolean;
+    /** Whether the shape-creation tools and the shapes pane may add shapes. */
+    canDraw: boolean;
+    canZoomIn: boolean;
+    canZoomOut: boolean;
+    tool: DiagramTool;
+    tools: DiagramToolSummary[];
+    search: {
+        query: string;
+        resultCount: number;
+        activeIndex: number;
+        truncated: boolean;
+    };
+    onPageChange: (index: number) => void;
+    onZoomChange: (zoom: number) => void;
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onFit: () => void;
+    onUndo: () => Promise<void>;
+    onRedo: () => Promise<void>;
+    onDuplicate: () => Promise<void>;
+    onGroup: () => Promise<void>;
+    onUngroup: () => Promise<void>;
+    onDelete: () => Promise<void>;
+    onCut: () => Promise<void>;
+    onCopy: () => Promise<void>;
+    onPaste: () => Promise<void>;
+    onToolChange: (tool: DiagramTool) => void;
+    onTextChange: (pageId: string, shapeId: string, text: string) => Promise<void>;
+    onSearchChange: (query: string) => void;
+    onNextSearchResult: () => void;
+    onPreviousSearchResult: () => void;
+    canOpenFile: boolean;
+    canOpenPageSetup: boolean;
+    canOpenSettings: boolean;
+    canOpenShareDialog: boolean;
+    onOpenFile?: () => void;
+    onOpenPageSetup?: () => void;
+    onOpenSettings?: () => void;
+    onOpenShareDialog?: () => void;
+};
+export type DiagramToolbarProps = ReturnType<typeof diagramToolbarProps>;

package/dist/visio/building-blocks.d.ts

@@ -1,37 +1,14 @@
 import type { ViewerController } from './controller.js';
+export { diagramToolbarProps, diagramMode } from './building-blocks-toolbar.js';
+export type { DiagramToolbarProps, DiagramToolbarLabels, DiagramToolbarHostCallbacks, DiagramMode, DiagramToolSummary, } from './building-blocks-toolbar.js';
+export { mountDiagramShapes } from './building-blocks-shapes.js';
+export { DIAGRAM_DRAW_TOOLS, DIAGRAM_OBJECT_TOOLS, DIAGRAM_TOOLS, type DiagramTool, type DiagramDrawTool, type DiagramObjectTool, } from './diagram-tool.js';
 export declare function fitDiagramCanvas(host: HTMLElement, controller: ViewerController, mode?: 'page' | 'width'): void;
 /** The existing non-mutating selection inspector, independently mounted. */
 export declare function mountDiagramInspector(host: HTMLElement, controller: ViewerController): () => void;
-/** The shared drawing engine, without application chrome or file/settings handlers. */
+/**
+ * The shared drawing engine, without application chrome or file/settings handlers. Moving,
+ * inline text, resize, rotate, line end points and the draw tools are the full viewer's own
+ * gestures, and all of them stand down unless the controller may edit.
+ */
 export declare function mountDiagramCanvas(host: HTMLElement, controller: ViewerController): () => void;
-export declare function diagramToolbarProps(controller: ViewerController, fit: () => void, locale?: string): {
-    labels: {
-        [k: string]: string;
-    };
-    canEdit: boolean;
-    pageIndex: number;
-    pages: {
-        id: string;
-        name: string;
-    }[];
-    zoom: number;
-    selection: readonly import("ooxml-core/visio/ui").VisioShapeSelection[];
-    canUndo: boolean;
-    canRedo: boolean;
-    canDuplicate: boolean;
-    canGroup: boolean;
-    canUngroup: boolean;
-    onPageChange: (index: number) => void;
-    onZoomChange: (zoom: number) => void;
-    onFit: () => void;
-    onUndo: () => Promise<void>;
-    onRedo: () => Promise<void>;
-    onDuplicate: () => Promise<void>;
-    onGroup: () => Promise<void>;
-    onUngroup: () => Promise<void>;
-    onTextChange: (pageId: string, shapeId: string, text: string) => Promise<void>;
-    onSearchChange: (query: string) => void;
-    onNextSearchResult: () => void;
-    onPreviousSearchResult: () => void;
-};
-export type DiagramToolbarProps = ReturnType<typeof diagramToolbarProps>;

package/dist/visio/canvas-editing.d.ts

@@ -0,0 +1,45 @@
+import type { ViewerController, ViewerState } from './controller.js';
+import { ViewerInlineText } from './viewer-inline-text.js';
+import { ViewerLineEndpoints } from './viewer-line-endpoints.js';
+import { ViewerPointerGestures } from './viewer-pointer-gestures.js';
+import { ViewerResizeHandles } from './viewer-resize-handles.js';
+import { ViewerRotationHandle } from './viewer-rotation-handle.js';
+import { ShapeDrawTool } from './viewer-draw-tool.js';
+import { ViewerTextTool } from './viewer-text-tool.js';
+import { ViewerConnectorTool } from './viewer-connector-tool.js';
+import type { DiagramTool } from './diagram-tool.js';
+export interface CanvasEditingOptions {
+    /** Whether the pointer tool is the active one: handles and gestures stand down otherwise. */
+    pointerActive(): boolean;
+    announce(message: string): void;
+    snap?: ConstructorParameters<typeof ViewerPointerGestures>[2]['snap'];
+    clearSnap?: ConstructorParameters<typeof ViewerPointerGestures>[2]['clearSnap'];
+    /**
+     * The active tool, present only where the tools live in this wiring (the standalone canvas).
+     * The full viewer owns its tools in its commands and leaves this out.
+     */
+    tool?: () => DiagramTool;
+}
+/**
+ * The editing gestures every canvas shares: moving, inline text, line end points, rotation and
+ * resize handles, plus ordinary shape drawing when a draw tool is supplied. The full viewer and
+ * the standalone building-block canvas both build their surface from this, so the two behave alike
+ * and both stay behind the controller's edit permission.
+ */
+export declare function createCanvasEditing(viewport: HTMLElement, controller: ViewerController, options: CanvasEditingOptions): {
+    pointer: ViewerPointerGestures;
+    lineEndpoints: ViewerLineEndpoints;
+    rotation: ViewerRotationHandle;
+    resize: ViewerResizeHandles;
+    edit: ViewerInlineText;
+    draw: ShapeDrawTool | undefined;
+    text: ViewerTextTool | undefined;
+    connector: ViewerConnectorTool | undefined;
+    /** Stop any gesture in progress, as when the tool changes or Escape is pressed. */
+    cancelTools(): void;
+    /** Redraw the selection handles after a state or tool change. */
+    renderHandles(state: ViewerState): void;
+    render(state: ViewerState): void;
+    wire(): () => void;
+};
+export type CanvasEditing = ReturnType<typeof createCanvasEditing>;

package/dist/visio/canvas-keys.d.ts

@@ -0,0 +1,9 @@
+import { type ViewerController } from './controller.js';
+import type { CanvasEditing } from './canvas-editing.js';
+/** Delete the selection through the controller; false when there is nothing deletable. */
+export declare function deleteDiagramSelection(controller: ViewerController, announce: (message: string) => void): Promise<void>;
+/**
+ * The few keys a bare drawing surface answers, gated like the full viewer's: Delete removes the
+ * selection, Escape drops the draw tool, Ctrl+Z and Ctrl+Y walk the history.
+ */
+export declare function wireCanvasKeys(viewport: HTMLElement, controller: ViewerController, editing: CanvasEditing, announce: (message: string) => void): () => void;

package/dist/visio/canvas-services.d.ts

@@ -0,0 +1,18 @@
+import type { ViewerController } from './controller.js';
+import type { ClipboardOperation } from './viewer-clipboard.js';
+/**
+ * What a mounted standalone canvas can do beyond the controller: the browser clipboard transport
+ * and the drawing surface. Toolbar props and the shapes pane look these up by controller, so a
+ * custom UI never reaches into the canvas element.
+ */
+export interface CanvasServices {
+    readonly viewport: HTMLElement;
+    /** Run a clipboard operation; rejects with the reason when it is unavailable. */
+    clipboard(operation: ClipboardOperation): Promise<void>;
+    announce(message: string): void;
+}
+export declare function registerCanvasServices(controller: ViewerController, services: CanvasServices): () => void;
+/** Follow the canvas mounted on a controller: called now, and whenever one mounts or unmounts. */
+export declare function watchCanvasServices(controller: ViewerController, watcher: (services: CanvasServices | undefined) => void): () => void;
+/** The services of the canvas mounted on this controller, if any. */
+export declare function canvasServices(controller: ViewerController): CanvasServices | undefined;

package/dist/visio/collaboration-types.d.ts

@@ -1,3 +1,3 @@
-import type { CollaborationOptions, CollaborationState } from 'ooxml-core/collab';
-export type VisioCollaborationOptions = CollaborationOptions;
+import type { CollaborationState } from 'ooxml-core/collab';
+export type { VisioCollaborationOptions, VisioPresence, VisioWriteBackOptions, } from 'ooxml-core/visio/ui';
 export type VisioCollaborationState = CollaborationState;

package/dist/visio/controller.d.ts

@@ -7,6 +7,7 @@ import { type CancellableClipboardCapture } from './worker-clipboard.js';
 import { type ViewerCreationToken } from './creation-token.js';
 import { type LayerVisibilityOverride } from './viewer-layers.js';
 import type { CancellableParser } from './worker-parser.js';
+import type { DiagramTool } from './diagram-tool.js';
 import type { ViewerEvents, VisioShapeSelection } from 'ooxml-core/visio/ui';
 import { type TextSearchState } from 'ooxml-core/visio/ui';
 import { type ViewerTextReplaceToken, type ViewerTextReplaceScope, type ViewerTextReplacementInput } from './replacement-token.js';
@@ -28,11 +29,25 @@ export interface ViewerState {
     readonly selectedShapes: readonly VisioShapeSelection[];
     /** Prepared source selection availability for native clipboard gestures. Payload stays private. */
     readonly clipboard: ViewerClipboardState;
+    /** The standalone canvas's active tool; it falls back to the pointer whenever editing stops. */
+    readonly tool: DiagramTool;
 }
 /** Effective mutation availability shared by every diagram UI tool. */
 export declare function canEditDiagram(state: Pick<ViewerState, 'canEdit' | 'edit'>): boolean;
 type Parser = CancellableParser;
 type EventListener = <K extends keyof ViewerEvents>(name: K, detail: ViewerEvents[K]) => void;
+/** What differs between the open drawing and a shared package, when only page content does. */
+export interface RemoteSourceChange {
+    /** Ids of the pages whose content changed. */
+    readonly pages: readonly string[];
+}
+/** Undo and redo of a shared drawing: they act on the local user's edits only. */
+export interface SharedHistory {
+    undo(): Promise<boolean>;
+    redo(): Promise<boolean>;
+    canUndo(): boolean;
+    canRedo(): boolean;
+}
 export declare class ViewerController {
     #private;
     private readonly parser;
@@ -47,6 +62,8 @@ export declare class ViewerController {
     subscribe(listener: (state: ViewerState) => void): () => void;
     get canEdit(): boolean;
     set canEdit(value: boolean);
+    /** Pick the canvas tool. A drawing tool needs edit permission and a source-backed drawing. */
+    setTool(tool: DiagramTool): void;
     onEvent(listener: EventListener): () => void;
     setDocument(document: VisioDocument | null): void;
     setPage(index: number): void;
@@ -127,14 +144,27 @@ export declare class ViewerController {
     /** Number of undo steps kept (File > Options > Advanced); applies to the open drawing at once. */
     get undoLevels(): number | undefined;
     set undoLevels(levels: number | undefined);
+    /**
+     * While set (a shared drawing), undo and redo go to `history` instead of the package history,
+     * and the edit state reports its stacks. Pass null to restore the package history.
+     */
+    setSharedHistory(history: SharedHistory | null): void;
+    /** Re-reads the undo and redo availability of a shared history. */
+    refreshHistory(): void;
     undo(): Promise<void>;
     /**
      * Adopt a package from a shared session as one undoable history step. Emits `document-change`
      * with kind `remote`, which a session must not publish back.
      */
-    applyRemoteSource(bytes: Uint8Array): Promise<void>;
+    applyRemoteSource(bytes: Uint8Array, change?: RemoteSourceChange): Promise<void>;
     redo(): Promise<void>;
     cancelEdit(): void;
+    /**
+     * Declare the current content saved, for hosts that persist `exportVsdx()` themselves. Clears
+     * `edit.dirty` and emits `document-change` with `dirty: false` and kind `save`. Later edits
+     * and undo steps are measured against this point.
+     */
+    markClean(): void;
     exportVsdx(): VsdxExportResult;
 }
 export {};

package/dist/visio/diagram-tool.d.ts

@@ -0,0 +1,11 @@
+/** The drawing tools a standalone diagram canvas offers; every one needs edit permission. */
+export declare const DIAGRAM_DRAW_TOOLS: readonly ['rectangle', 'ellipse', 'line', 'freeform', 'arc', 'pencil'];
+export type DiagramDrawTool = (typeof DIAGRAM_DRAW_TOOLS)[number];
+/** The text box and connector tools: the full viewer's own, beside the shape drawing tools. */
+export declare const DIAGRAM_OBJECT_TOOLS: readonly ['text', 'connector'];
+export type DiagramObjectTool = (typeof DIAGRAM_OBJECT_TOOLS)[number];
+/** Every non-pointer tool a standalone canvas offers, in toolbar order. */
+export declare const DIAGRAM_TOOLS: readonly ["rectangle", "ellipse", "line", "freeform", "arc", "pencil", "text", "connector"];
+/** The active canvas tool: the pointer, a drawing tool, the text tool or the connector tool. */
+export type DiagramTool = 'pointer' | DiagramDrawTool | DiagramObjectTool;
+export declare function isDiagramTool(value: unknown): value is DiagramTool;

package/dist/visio/index.d.ts

@@ -1,5 +1,5 @@
 export { ViewerController, type ViewerState } from './controller.js';
-export { mountDiagramCanvas, fitDiagramCanvas, mountDiagramInspector, diagramToolbarProps, type DiagramToolbarProps, } from './building-blocks.js';
+export { mountDiagramCanvas, fitDiagramCanvas, mountDiagramInspector, mountDiagramShapes, diagramToolbarProps, diagramMode, DIAGRAM_DRAW_TOOLS, DIAGRAM_OBJECT_TOOLS, DIAGRAM_TOOLS, type DiagramToolbarProps, type DiagramToolbarLabels, type DiagramToolbarHostCallbacks, type DiagramMode, type DiagramToolSummary, type DiagramTool, type DiagramDrawTool, type DiagramObjectTool, } from './building-blocks.js';
 export type { CreateVsdxOptions } from 'ooxml-core/visio';
 export type { ViewerClipboardState, ViewerClipboardToken } from './clipboard-capture.js';
 export { mountViewer, type MountedViewer } from './binding.js';

package/dist/visio/viewer-clipboard.d.ts

@@ -14,8 +14,14 @@ export declare class ViewerClipboard {
     private baseReason;
     private selectionReason;
     private hasPromiseWrite;
+    /** Why the operation is unavailable now, or an empty string when it can run. */
+    reason(operation: ClipboardOperation, state: ViewerState): string;
     private operationReason;
     run(operation: ClipboardOperation, event?: ClipboardEvent): Promise<void>;
-    wire(): () => void;
+    /**
+     * Listen for the browser's clipboard events. By default they become ribbon actions; a surface
+     * without a ribbon passes its own `dispatch`.
+     */
+    wire(dispatch?: (operation: ClipboardOperation, event: ClipboardEvent) => void): () => void;
     render(state: ViewerState): void;
 }

package/dist/visio/viewer-delete.d.ts

@@ -0,0 +1,10 @@
+import type { VisioEdit } from 'ooxml-core/visio';
+import type { ViewerState } from './controller.js';
+/**
+ * The edits that delete the current selection, with the generated graphics and callout leaders
+ * that belong to it, and the sentence to announce. Undefined when nothing can be deleted.
+ */
+export declare function planDeleteSelection(state: ViewerState): {
+    edits: VisioEdit[];
+    message: string;
+} | undefined;

package/dist/visio/viewer-presence-overlay.d.ts

@@ -0,0 +1,12 @@
+import type { VisioPage } from 'ooxml-core/visio';
+import type { RemotePresence } from 'ooxml-core/collab';
+import { type VisioPresence } from 'ooxml-core/visio/ui';
+export type PeerPresence = RemotePresence<VisioPresence>;
+/** Pixels per drawing unit of `svg`, from its screen matrix (96 per inch at 100% as fallback). */
+export declare function presenceScale(svg: SVGSVGElement, zoom: number): number;
+/**
+ * Draws the collaborators on `page` into one `<g data-presence-overlay>` of the page SVG, in
+ * drawing units so zoom and pan move it with the drawing; pixel sizes are divided by `scale`.
+ * Replaces any previous overlay and removes it when nobody is on the page.
+ */
+export declare function renderPresenceOverlay(svg: SVGSVGElement, page: VisioPage, peers: readonly PeerPresence[], scale: number): void;

package/dist/visio/viewer-presence.d.ts

@@ -0,0 +1,19 @@
+import type { VisioPresence } from 'ooxml-core/visio/ui';
+import type { CollabSession } from 'ooxml-core/collab';
+import type { ViewerController } from './controller.js';
+import { type PeerPresence } from './viewer-presence-overlay.js';
+/**
+ * Live cursors and selections of one shared drawing: publishes this window's page, pointer and
+ * selection through the session's presence (already throttled there) and draws the peers that
+ * are on the same page over the canvas. It borrows the session; the caller owns its lifetime.
+ */
+export declare class ViewerPresence {
+    #private;
+    private readonly session;
+    private readonly controller;
+    private readonly viewport;
+    constructor(session: CollabSession<VisioPresence>, controller: ViewerController, viewport: HTMLElement | null);
+    /** The remote collaborators currently drawn (same page or not). */
+    get peers(): readonly PeerPresence[];
+    dispose(): void;
+}

package/dist/visio/viewer-share-sync.d.ts

@@ -1,23 +1,28 @@
+import type { CollabSession } from 'ooxml-core/collab';
+import type { DrawingEditor } from 'ooxml-core/visio/collab';
 import type { ViewerController } from './controller.js';
 export type Collab = typeof import('ooxml-core/collab');
+export type DrawingCollab = typeof import('ooxml-core/visio/collab');
 export type Session = ReturnType<Collab['createCollabSession']>;
-export interface PackageSyncOptions {
+export interface DrawingSyncOptions {
     /** `join` never seeds an empty room with the drawing this window already has open. */
     join: boolean;
-    /** Reports an adoption failure. */
+    /** Reports a failure to share or apply a change. */
     fail(message: string): void;
 }
+/** The DOM-free editor the shared-drawing binding drives, over a viewer controller. */
+export declare function controllerEditor(controller: ViewerController): DrawingEditor;
 /**
- * Whole-package sync of one drawing over a shared session: the VSDX bytes live in
- * `session.doc.getMap('package')` and the last writer wins. Remote changes arrive as one undoable
- * history step. It borrows the session; the caller owns its lifetime.
+ * Property-level sync of one drawing over a shared session (`ooxml-core/visio/collab`): pages,
+ * shapes (per cell, row and section), connectors, masters and media merge per item; styles, theme
+ * and document settings are shared whole. Undo and redo act on this
+ * window's own edits. It borrows the session; the caller owns its lifetime.
  */
-export declare class PackageSync {
+export declare class DrawingSync {
     #private;
-    private readonly collab;
-    private readonly session;
     private readonly controller;
-    private readonly options;
-    constructor(collab: Collab, session: Session, controller: ViewerController, options: PackageSyncOptions);
+    constructor(drawing: DrawingCollab, session: Pick<CollabSession<object>, 'doc' | 'synced' | 'canWrite' | 'on'>, controller: ViewerController, options: DrawingSyncOptions);
+    /** Resolves when queued publishing and applying has finished. */
+    idle(): Promise<void>;
     dispose(): void;
 }

package/dist/visio/viewer-share.d.ts

@@ -1,30 +1,32 @@
-import type { CollaborationOptions, CollaborationState } from 'ooxml-core/collab';
+import type { CollaborationState } from 'ooxml-core/collab';
 import type { OfficeProfile } from '../controls.js';
 import type { ViewerController } from './controller.js';
-import { type Collab } from './viewer-share-sync.js';
+import { type Collab, type DrawingCollab } from './viewer-share-sync.js';
+import type { VisioCollaborationOptions } from './collaboration-types.js';
 /** Not sharing: what `collaborationState` reports before a join and after a leave. */
 export declare const NOT_SHARING: CollaborationState;
 /**
  * Sharing of one `<visio-viewer>` over `ooxml-core/collab` (Yjs): the File > Share panel and the
- * host's `collaboration` property drive the same session. Peers share the whole VSDX package
- * (see `PackageSync`). The collab runtime loads only when sharing starts.
+ * host's `collaboration` property drive the same session. Peers merge pages, shapes and
+ * connectors item by item (see `DrawingSync`). The collab runtime loads only when sharing starts.
  */
 export declare class ViewerShare {
     #private;
     private readonly controller;
     private readonly profile;
     private readonly loadCollab;
+    private readonly loadDrawing;
     /** Called whenever `state` may have changed. */
     onChange: (state: CollaborationState) => void;
     /** Called with the failure of a declarative join. */
     onError: (error: Error) => void;
-    constructor(root: ShadowRoot, controller: ViewerController, profile: () => OfficeProfile, loadCollab?: () => Promise<Collab>);
+    constructor(root: ShadowRoot, controller: ViewerController, profile: () => OfficeProfile, loadCollab?: () => Promise<Collab>, loadDrawing?: () => Promise<DrawingCollab>);
     get active(): boolean;
     /** The options of the declarative `collaboration` property, if set. */
-    get wanted(): CollaborationOptions | null;
+    get wanted(): VisioCollaborationOptions | null;
     get state(): CollaborationState;
     /** Declarative sharing: while set, the drawing is shared; null leaves the room. */
-    want(options: CollaborationOptions | null): void;
+    want(options: VisioCollaborationOptions | null): void;
     /** Leaves the room and forgets the `collaboration` property. */
     stop(): void;
     reconnect(): void;

package/dist/visio/viewer-stencil.d.ts

@@ -7,3 +7,11 @@ import type { ViewerController } from './controller.js';
  * Stencil and the stencils it docks.
  */
 export declare function wireStencil(pane: HTMLElement, viewport: HTMLElement, controller: ViewerController, announce: (message: string) => void): () => void;
+/**
+ * The Shapes window without a fixed page: `attach` makes a canvas the one masters are dropped on
+ * (and placed by), so a pane mounted on its own can follow whichever canvas is mounted.
+ */
+export declare function wireStencilPane(pane: HTMLElement, controller: ViewerController, announce: (message: string) => void): {
+    attach(viewport: HTMLElement): () => void;
+    dispose(): void;
+};