ooxml-core 1.6.2 → 1.8.0

package/dist/visio/ui/connection-points.d.ts

@@ -13,6 +13,11 @@ export declare function visioSceneToLocal(shape: VisioShape, point: VisioScenePo
  * Master instances keep their master's points; groups and 1D shapes are refused.
  */
 export declare function visioConnectableShape(shape: VisioShape | undefined): shape is VisioShape;
+/**
+ * A top-level shape a connector end can glue to: a drawn 2D shape, or a stencil shape (master
+ * instance) made of one shape, whose size and connection points the core reads through its master.
+ */
+export declare function visioGlueableShape(shape: VisioShape | undefined): shape is VisioShape;
 /** A connection point in page coordinates. */
 export interface VisioConnectionPointHit {
     shapeId: string;
@@ -38,8 +43,8 @@ export declare function visioConnectorEndHandles(shape: VisioShape): {
     end: VisioScenePoint;
 } | undefined;
 /**
- * The route of a local dynamic connector whose route Design > Connectors can change: one with
- * route cells (drawn by the Connector tool). Plain lines have none.
+ * The route of a dynamic connector whose route Design > Connectors can change: one with route
+ * cells (drawn by the Connector tool) or a stencil connector. Plain lines have none.
  */
 export declare function visioConnectorRouteOf(shape: VisioShape): VisioConnectorRoute | undefined;
 //# sourceMappingURL=connection-points.d.ts.map

package/dist/visio/ui/connection-points.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-points.d.ts","sourceRoot":"","sources":["../../../visio/ui/connection-points.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAKD,iGAAiG;AACjG,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,GACpB,eAAe,GAAG,SAAS,CAO7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CAUxF;AAED,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CACjB;AACD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAoB,GACnD,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,EAAE,CAU7C;AACD,oFAAoF;AACpF,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAA+B,GAC9D,uBAAuB,GAAG,SAAS,CAQrC;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC,GAAG,SAAS,CAgB1E;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,UAAU,GACf;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,eAAe,CAAA;CAAE,GAAG,SAAS,CAW9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAIxF"}
+{"version":3,"file":"connection-points.d.ts","sourceRoot":"","sources":["../../../visio/ui/connection-points.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAKD,iGAAiG;AACjG,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,GACpB,eAAe,GAAG,SAAS,CAO7B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CAUxF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CASrF;AAED,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CACjB;AACD,kFAAkF;AAClF,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAoB,GACnD,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,EAAE,CAU7C;AACD,oFAAoF;AACpF,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAA4B,GAC3D,uBAAuB,GAAG,SAAS,CAQrC;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC,GAAG,SAAS,CAgB1E;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,UAAU,GACf;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,eAAe,CAAA;CAAE,GAAG,SAAS,CAe9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,GAAG,SAAS,CAOxF"}

package/dist/visio/ui/connector-preview.d.ts

@@ -12,8 +12,9 @@ export interface VisioConnectorPreview {
 }
 /**
  * While shapes are dragged, the connectors glued to them re-routed for the translated shapes,
- * with the same site choice and router the core uses when the move is committed. Connectors that
- * move themselves, are not local, or cannot be resolved are left out.
+ * with the same site choice and router the core uses when the move is committed, including the
+ * detour a right-angle connector takes around the other shapes of the page. Connectors that move
+ * themselves or cannot be resolved are left out.
  */
 export declare function visioConnectorMovePreviews(page: VisioPage, moved: ReadonlySet<string>, delta: {
     x: number;

package/dist/visio/ui/connector-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-preview.d.ts","sourceRoot":"","sources":["../../../visio/ui/connector-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAUtE,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,yEAAyE;IACzE,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,qBAAqB,EAAE,CA8CzB;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAOhF"}
+{"version":3,"file":"connector-preview.d.ts","sourceRoot":"","sources":["../../../visio/ui/connector-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAatE,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,yEAAyE;IACzE,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,qBAAqB,EAAE,CA2EzB;AAED,6CAA6C;AAC7C,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAOhF"}

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

@@ -1,9 +1,12 @@
+import type { RibbonAddInCommandDetail, RibbonAddInTab } from '../../ribbon/index.js';
 import type { VisioDocument } from '../index.js';
 export interface ViewerProperties {
     document: VisioDocument | null;
     pageIndex: number;
     zoom: number;
     showToolbar: boolean;
+    /** Tabs the host adds after Help, as an Office add-in does. */
+    ribbonAddIns: readonly RibbonAddInTab[];
 }
 /** A page-scoped shape identity. Omitted pageId means the currently displayed page. */
 export interface VisioShapeSelection {
@@ -24,12 +27,14 @@ export interface ViewerEvents {
     'shape-select': VisioShapeSelection | null;
     /** Ordered immutable selection; the first entry is the primary selectedShape. */
     'selection-change': readonly VisioShapeSelection[];
+    /** A command of a host tab (`ribbonAddIns`) was chosen. */
+    'office-ribbon-add-in': RibbonAddInCommandDetail;
 }
 export type ViewerCallbacks = {
     [K in keyof ViewerEvents]?: (detail: ViewerEvents[K]) => void;
 };
-export declare const propertyKeys: readonly ["document", "pageIndex", "zoom", "showToolbar"];
-export declare const eventKeys: readonly ["document-load", "document-change", "document-error", "page-change", "zoom-change", "shape-select", "selection-change"];
+export declare const propertyKeys: readonly ["document", "pageIndex", "zoom", "showToolbar", "ribbonAddIns"];
+export declare const eventKeys: readonly ["document-load", "document-change", "document-error", "page-change", "zoom-change", "shape-select", "selection-change", "office-ribbon-add-in"];
 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,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACrB;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,CAAC;KAC1C,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;CACnD;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,2DAK+B,CAAC;AACzD,eAAO,MAAM,SAAS,mIAQ8B,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,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAChC,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;CACxC;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,CAAC;KAC1C,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;CACjD;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,2EAM+B,CAAC;AACzD,eAAO,MAAM,SAAS,2JAS8B,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/data-graphics.d.ts

@@ -10,6 +10,10 @@ export declare function visioRemoveDataGraphicEdits(page: VisioPage, shapeIds: r
  * when it moves); Color by Value changes the shape's own fill and remembers the old one.
  */
 export declare function visioDataGraphicEdits(page: VisioPage, shapeIds: readonly string[], options: VisioDataGraphicOptions): VisioEdit[];
-/** A legend for Color by Value: a title and one swatch and label per rule, grouped. */
-export declare function visioLegendEdits(page: VisioPage, title: string, rules: readonly VisioColorRule[]): VisioEdit[];
+/**
+ * A legend for Color by Value: a title and one swatch and label per rule, grouped, at the top
+ * right of the page. Vertical lists the rules under the title; horizontal puts them in a row
+ * beside it and starts another row when the page is not wide enough.
+ */
+export declare function visioLegendEdits(page: VisioPage, title: string, rules: readonly VisioColorRule[], orientation?: 'vertical' | 'horizontal'): VisioEdit[];
 //# sourceMappingURL=data-graphics.d.ts.map

package/dist/visio/ui/data-graphics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-graphics.d.ts","sourceRoot":"","sources":["../../../visio/ui/data-graphics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EAUN,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AAWrC,gGAAgG;AAChG,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,CAAC,EAAE,oBAAoB,GACzB,SAAS,EAAE,CA4Bb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,uBAAuB,GAC9B,SAAS,EAAE,CA6Ib;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,cAAc,EAAE,GAC9B,SAAS,EAAE,CA6Eb"}
+{"version":3,"file":"data-graphics.d.ts","sourceRoot":"","sources":["../../../visio/ui/data-graphics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,OAAO,EAUN,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AAWrC,gGAAgG;AAChG,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,IAAI,CAAC,EAAE,oBAAoB,GACzB,SAAS,EAAE,CA4Bb;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,uBAAuB,GAC9B,SAAS,EAAE,CA6Ib;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,WAAW,GAAE,UAAU,GAAG,YAAyB,GACjD,SAAS,EAAE,CAoFb"}

package/dist/visio/ui/edit-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-commands.d.ts","sourceRoot":"","sources":["../../../visio/ui/edit-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA+B1C,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CA+KtE"}
+{"version":3,"file":"edit-commands.d.ts","sourceRoot":"","sources":["../../../visio/ui/edit-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAkC1C,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAoLtE"}

package/dist/visio/ui/edit-error.d.ts

@@ -1,4 +1,7 @@
-/** Core error codes remain visible for a refused transaction; document content is plain text. */
+/**
+ * What a refused edit says to the user: the plain reason. The stable code stays on the error
+ * (`error.code`) for programs; it is not shown in the interface. Document content is plain text.
+ */
 export declare function editErrorMessage(error: unknown): string;
 /** Superseded worker/load operations are cancellation, not a refused document edit. */
 export declare function isEditCancellation(error: unknown): boolean;

package/dist/visio/ui/edit-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-error.d.ts","sourceRoot":"","sources":["../../../visio/ui/edit-error.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"edit-error.d.ts","sourceRoot":"","sources":["../../../visio/ui/edit-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D"}

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

@@ -1,5 +1,32 @@
 import type { VisioDocument, VisioPage, VisioShape } from '../model.js';
 import type { VisioTextFormatEdit } from '../edit-formatting-commands.js';
+/**
+ * A top-level shape drawn here: no master, group, picture or layer. Stencil shapes take their
+ * own paths: `visioStencilInstanceShape` for formatting and geometry, `visioStencilShape` for
+ * whole-shape commands.
+ */
+export declare function visioLocalFormattingShape(page: VisioPage, shapeId: string): VisioShape | undefined;
+/**
+ * A shape dropped from a stencil (a master instance): one plain 2D shape, or a group whose
+ * sub-shapes all come from the master. Its formatting, size and position are saved as local
+ * values over the master. Stencil shapes sit on their stencil's layer, which only matters when
+ * that layer is locked. Pictures, lines and connectors from a stencil are not edited yet.
+ */
+export declare function visioStencilInstanceShape(page: VisioPage, shapeId: string): VisioShape | undefined;
+/**
+ * A sub-shape of a stencil group (Visio's sub-selection: a second click inside the selected
+ * group). It takes fill, line and text formatting and text of its own; its size and place belong
+ * to the group.
+ */
+export declare function visioStencilSubShape(page: VisioPage, shapeId: string): VisioShape | undefined;
+/** A shape a fill, line or text formatting command may target, sub-selected parts included. */
+export declare function visioFormatTargetShape(page: VisioPage, shapeId: string): VisioShape | undefined;
+/**
+ * A top-level shape dropped from a stencil that whole-shape commands (Duplicate, Copy, Group,
+ * ordering) take as it is: a 2D shape or group that stays an instance of its master. Lines and
+ * connectors from a stencil are left out, and so is a shape on a locked layer.
+ */
+export declare function visioStencilShape(page: VisioPage, shapeId: string): VisioShape | undefined;
 /** Scene-level candidate only; source formulas, rich markup and locks remain authoritative. */
 export declare function visioStyleFormattingShape(page: VisioPage, shapeId: string): VisioShape | undefined;
 /** Mixed runs can be formatted together; source row admission remains authoritative. */

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

@@ -1 +1 @@
-{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../visio/ui/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAA2B,MAAM,UAAU,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAexB;AACD,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7F;AACD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAE5E;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,eAAe,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACxD,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACpD,iBAAiB,EAAE,OAAO,CAAC;CAC3B;AACD,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,wBAAwB,CAmChG;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GAAG,UAAU,GAChC,mBAAmB,GAAG,SAAS,CAcjC;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GAAG,UAAU,GAChC,mBAAmB,GAAG,SAAS,CAkBjC"}
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../visio/ui/formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAA2B,MAAM,UAAU,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAexB;AAWD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAexB;AACD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAc7F;AACD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE/F;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAe1F;AACD,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACb,UAAU,GAAG,SAAS,CAExB;AACD,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7F;AACD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,MAAM,EAAE,CAE5E;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,eAAe,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACxD,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACpD,iBAAiB,EAAE,OAAO,CAAC;CAC3B;AACD,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,wBAAwB,CAmChG;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GAAG,UAAU,GAChC,mBAAmB,GAAG,SAAS,CAcjC;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GAAG,UAAU,GAChC,mBAAmB,GAAG,SAAS,CAkBjC"}

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

@@ -22,6 +22,20 @@ export interface VisioSnapOptions {
     guides: boolean;
     /** Page inches; a snap happens within this distance. */
     threshold: number;
+    /**
+     * Snap to Grid: the grid step in page inches. On an axis that did not snap to a shape or guide,
+     * the selection's nearer edge lands on a grid line. Omitted or zero leaves the grid out. A
+     * page whose axes differ, or whose grid does not start at the page corner, gives each axis its
+     * step and the position of one line (`VisioGridSteps`).
+     */
+    grid?: number | VisioSnapGrid;
+}
+/** A grid's step and one line's position per axis, in page inches (y up). */
+export interface VisioSnapGrid {
+    x: number;
+    y: number;
+    originX?: number;
+    originY?: number;
 }
 export interface VisioSnapResult {
     /** Adjusted drag delta (x right, y up), as `visioPageDragDelta` returns it. */

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

@@ -1 +1 @@
-{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../../../visio/ui/guides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,EAAE,CAYjE;AAUD,iGAAiG;AACjG,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,YAAY,GAAG,UAAU,EACtC,QAAQ,EAAE,MAAM,GACd,cAAc,CAQhB;AACD,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GACd,cAAc,CAEhB;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAiBxE;AAED,MAAM,WAAW,gBAAgB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,KAAK,EAAE,cAAc,CAAC;IACtB,8EAA8E;IAC9E,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACvB,eAAe,CAgCjB"}
+{"version":3,"file":"guides.d.ts","sourceRoot":"","sources":["../../../visio/ui/guides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEvE,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,EAAE,CAYjE;AAUD,iGAAiG;AACjG,wBAAgB,uBAAuB,CACtC,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,YAAY,GAAG,UAAU,EACtC,QAAQ,EAAE,MAAM,GACd,cAAc,CAQhB;AACD,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GACd,cAAc,CAEhB;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAiBxE;AAED,MAAM,WAAW,gBAAgB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CAC9B;AACD,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,KAAK,EAAE,cAAc,CAAC;IACtB,8EAA8E;IAC9E,KAAK,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACvB,eAAe,CAiDjB"}