@miragon/event-storming-renderer 0.3.0 → 0.4.0

package/README.md

@@ -47,8 +47,18 @@ freeform drawings on an unbounded canvas.
 | `container`         | a detached `<div>` | Host element; without one, mount later with `attachTo(host)` |
 | `width`, `height`   | `100%`, `600px`    | Container size (`100%` high when a `container` is given)     |
 | `additionalModules` | `[]`               | diagram-js modules appended after the renderer's own         |
+| `fitOnImport`       | `true`             | Fit the board into the view after every import               |
 | `undoRedoKeys`      | `true`             | `Modeler` only: bind Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and Ctrl+Y |
-| `freeRectInsets`    | none               | `Modeler` only: `() => ({ top, right, bottom, left })` in px |
+| `freeArea`          | none               | `Modeler` only: the part of the canvas no chrome covers      |
+
+`freeArea` is `{ insets: () => ({ top, right, bottom, left }) }`, the margins in px that the
+chrome covers, or `{ center: () => ({ x, y }) }`, the free centre in diagram coordinates
+(`undefined` while there is none). `freeArea`, `fitOnImport` and `undoRedoKeys` are the names of
+the [`@miragon/modeler-api`](https://www.npmjs.com/package/@miragon/modeler-api) factory options
+(contract 1.2), the same for every Miragon renderer. `freeRectInsets: () => insets`, the earlier
+name of `freeArea: { insets }`, is deprecated and still accepted until the next minor release;
+given both, `freeArea` wins. Pass `fitOnImport: false` when the host sets the view after every
+import itself.
 
 Pass `undoRedoKeys: false` when the host owns the history, as the VS Code extension does: the keys
 then reach the host untouched and the host undoes the document, while copy, paste, delete, the
@@ -64,8 +74,9 @@ largest zoom that shows all of it, never above 100%; an empty board shows at 100
 typed when an import arrives is reopened on the same element afterwards, with the typed text.
 
 Enter or Space on a creating palette entry (a click without a pointer, `detail` 0) places the
-element in the centre of the container minus `freeRectInsets` (the margins a host's chrome covers),
-24px down and right while that spot is taken, selects it and opens its label editor.
+element in the centre of `freeArea` (the container minus the margins a host's chrome covers, or the
+centre the host names; without it the container's centre), 24px down and right while that spot is
+taken, selects it and opens its label editor.
 
 `eventStormingReadOnly` locks every edit while a host cannot save from the canvas (an invalid file
 in an IDE): `diagram.get('eventStormingReadOnly').setReadOnly(true)` vetoes moves, resizes,
@@ -79,9 +90,9 @@ drawing keeps literal light colours in its SVG attributes, so exports look the s
 
 ### Collaborative hosts
 
-The package implements the collaborative-modeler contract of
+The package implements the collaborative-modeler contract 1.2 of
 [`@miragon/modeler-api`](https://www.npmjs.com/package/@miragon/modeler-api) (notation
-`event-storming`) and runs its conformance kit in CI:
+`event-storming`) and runs its conformance kit in CI, every case and no advisory:
 
 ```ts
 import {
@@ -107,18 +118,26 @@ const viewer = createCollaborativeViewer(); // meta.editable: false, never chang
 - `getViewState()` / `setViewState()` read and set the diagram-js viewbox (`x`, `y`, `width`,
   `height`); an import fits the board, never above 100% and never below 0.1% (a board too wide to
   show whole at 0.1% is centred there instead).
+- A view change never commits an open label editor: `setViewState`, a host's fit and the user's own
+  scroll or zoom leave it open with the typed text, and it moves with its element. A click or a
+  drag on the canvas, Cmd/Ctrl+Enter (Enter on an arrow label) or leaving the field commits it;
+  Escape discards it.
 - `elements` lists the stickies with their ids and labels, reveals (selects and scrolls to) one
   and reports the selection. Sticky ids survive a save and a re-open: the DSL writes `(id …)`
   back for every sticky whose id the parser would not derive again from its label at that line (one
   created on the canvas, a renamed one). Notes, drawings and arrows have no id in the text yet (theirs
   derive from their text or position), so they are not addressable.
-- New sticky ids are not collision-free across peers: a sticky created on the canvas takes the
-  lowest free `<prefix>_<n>` of its own instance, so two peers that each add one at the same time
-  both write `(id event_1)`. When their texts merge, the parser gives the second sticky a fresh id,
-  and whatever was linked to it points at the first. Contract 1.1 only recommends collision-free
-  ids; the conformance test accepts this as its one advisory.
+- `elements.bounds(id)` gives a sticky's box in board coordinates (`{ x, y, width, height }`, the
+  top-left corner and the size, which zoom and scroll leave alone), read from the live canvas: a
+  sticky created or moved in the session has its current box. Any other id gives `undefined`. The
+  viewer answers it too.
+- New sticky ids are random: a sticky created on the canvas (palette, keyboard, append, paste) gets
+  `<prefix>_<8 characters of [0-9a-z]>`, such as `(id event_k3x9q2ab)`, so two peers that each add
+  one at the same time do not pick the same id. Ids already in a text are read as they are.
 - `diagram` is the wrapped `Modeler` or `NavigatedViewer`, for everything outside the contract.
-  `createCollaborativeModeler` accepts `additionalModules`, `undoRedoKeys` and `freeRectInsets`.
+  `createCollaborativeModeler` and `createCollaborativeViewer` accept the same options:
+  `additionalModules`, `fitOnImport`, and for the modeler `undoRedoKeys` and `freeArea` (the
+  viewer ignores those two); the deprecated `freeRectInsets` still works for one minor release.
 - After `destroy()`, `exportText()` returns the last state and `importText()` rejects.
 
 #### Migrating a host

package/dist/EventStormingBaseViewer.d.ts

@@ -1,7 +1,7 @@
 import { ModuleDeclaration } from 'didi';
 import { EventStormingBoard } from '@miragon/event-storming-schema-model';
 import { ImportWarning } from './io/types.js';
-import { FreeRectInsets } from './palette/EventStormingPaletteProvider.js';
+import { FreeArea, FreeRectInsets } from './palette/EventStormingPaletteProvider.js';
 export interface EventStormingViewerOptions {
     /** Host element. If missing, a detached <div> is created (can be attached later via attachTo). */
     container?: HTMLElement;
@@ -15,11 +15,23 @@ export interface EventStormingViewerOptions {
      */
     undoRedoKeys?: boolean | undefined;
     /**
-     * The margins of the container that chrome covers (palette row, zoom panel). An element created
-     * from the palette with Enter or Space lands in the centre of what is left (guide §5.5); without
-     * it, in the centre of the container.
+     * Where the host's chrome leaves the canvas free (palette row, zoom panel), as the margins it
+     * covers (`{ insets }`) or the free centre in diagram coordinates (`{ center }`). An element
+     * created from the palette with Enter or Space lands in that centre (guide §5.5); without it, in
+     * the centre of the container. The modeler-api name.
+     */
+    freeArea?: FreeArea | undefined;
+    /**
+     * @deprecated Pass `freeArea: { insets }` instead. Accepted until the next minor release;
+     * `freeArea` wins when both are given.
      */
     freeRectInsets?: (() => FreeRectInsets) | undefined;
+    /**
+     * Fit the board into the view after every import (default true). A host whose chrome fits the
+     * content itself (the modeler shell's viewport, into the free area) passes false and sets the
+     * view after the import.
+     */
+    fitOnImport?: boolean | undefined;
 }
 export type EventCallback<T = unknown> = (event: T) => void;
 /**

package/dist/EventStormingBaseViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventStormingBaseViewer.d.ts","sourceRoot":"","sources":["../src/EventStormingBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAO/E,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,WAAW,0BAA0B;IACzC,kGAAkG;IAClG,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAkB5D;;;;;;GAMG;AACH,8BAAsB,uBAAuB;IAC3C,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,iBAAiB,EAAE;IAErD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,GAAE,0BAA+B;IAKpD,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAatB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIvB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAO,GAAG,IAAI;IAIjF,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIjD,gEAAgE;IAC1D,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAoBlF,oGAAoG;IAC9F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAkBrE,qEAAqE;IACrE,SAAS,IAAI,kBAAkB;IAI/B,SAAS,IAAI,MAAM;IAInB,gFAAgF;IAC1E,OAAO,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAK/B,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,IAAI,SAAS,IAAI,WAAW,CAE3B;CACF"}
+{"version":3,"file":"EventStormingBaseViewer.d.ts","sourceRoot":"","sources":["../src/EventStormingBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAO/E,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,2CAA2C,CAAC;AAEnD,MAAM,WAAW,0BAA0B;IACzC,kGAAkG;IAClG,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;IACpD;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAkB5D;;;;;;GAMG;AACH,8BAAsB,uBAAuB;IAC3C,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,iBAAiB,EAAE;IAErD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;gBAE1C,OAAO,GAAE,0BAA+B;IAKpD,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IActB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIvB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAO,GAAG,IAAI;IAIjF,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIjD,gEAAgE;IAC1D,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAoBlF,oGAAoG;IAC9F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAkBrE,qEAAqE;IACrE,SAAS,IAAI,kBAAkB;IAI/B,SAAS,IAAI,MAAM;IAInB,gFAAgF;IAC1E,OAAO,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAK/B,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,IAAI,SAAS,IAAI,WAAW,CAE3B;CACF"}

package/dist/collaborative/CollaborativeEventStorming.d.ts

@@ -1,25 +1,33 @@
-import { CollaborativeModeler, ElementsSurface } from '@miragon/modeler-api';
+import { CollaborativeModeler, CollaborativeModelerOptions, ElementsSurface } from '@miragon/modeler-api';
 import { ModuleDeclaration } from 'didi';
 import { Modeler } from '../Modeler.js';
 import { NavigatedViewer } from '../NavigatedViewer.js';
 import { FreeRectInsets } from '../palette/EventStormingPaletteProvider.js';
 /** Stable notation id in `meta.notation` of the collaborative-modeler contract. */
 export declare const EVENT_STORMING_NOTATION = "event-storming";
-export interface CollaborativeEventStormingOptions {
+/**
+ * The modeler-api factory options (`freeArea`, `fitOnImport`, `undoRedoKeys`) plus the renderer's
+ * own. The viewer takes the same object and ignores what only editing uses (`undoRedoKeys`,
+ * `freeArea`).
+ */
+export interface CollaborativeEventStormingOptions extends CollaborativeModelerOptions {
     /** Appended to the renderer's own modules (e.g. a host's chrome module). */
     additionalModules?: ModuleDeclaration[] | undefined;
-    /** See `EventStormingViewerOptions.undoRedoKeys` (default true). */
-    undoRedoKeys?: boolean | undefined;
-    /** See `EventStormingViewerOptions.freeRectInsets`. */
+    /**
+     * @deprecated Pass `freeArea: { insets }` instead. Accepted until the next minor release;
+     * `freeArea` wins when both are given.
+     */
     freeRectInsets?: (() => FreeRectInsets) | undefined;
 }
+/** The elements surface with `bounds`, which every Event Storming mount answers. */
+export type EventStormingElementsSurface = ElementsSurface & Required<Pick<ElementsSurface, 'bounds'>>;
 /** The contract surface plus the wrapped diagram for host-specific wiring. */
 export interface CollaborativeEventStormingModeler extends CollaborativeModeler {
-    readonly elements: ElementsSurface;
+    readonly elements: EventStormingElementsSurface;
     readonly diagram: Modeler | NavigatedViewer;
 }
 /** The editing mount (`meta.editable: true`) of the collaborative-modeler contract. */
 export declare function createCollaborativeModeler(options?: CollaborativeEventStormingOptions): CollaborativeEventStormingModeler;
 /** The read-only mount (`meta.editable: false`): imports, exports and reveals, never edits. */
-export declare function createCollaborativeViewer(options?: Omit<CollaborativeEventStormingOptions, 'undoRedoKeys' | 'freeRectInsets'>): CollaborativeEventStormingModeler;
+export declare function createCollaborativeViewer(options?: CollaborativeEventStormingOptions): CollaborativeEventStormingModeler;
 //# sourceMappingURL=CollaborativeEventStorming.d.ts.map

package/dist/collaborative/CollaborativeEventStorming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollaborativeEventStorming.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeEventStorming.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD,MAAM,WAAW,iCAAiC;IAChD,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,uDAAuD;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,8EAA8E;AAC9E,MAAM,WAAW,iCAAkC,SAAQ,oBAAoB;IAC7E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AAgBD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,iCAAiC,CASnC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,IAAI,CAAC,iCAAiC,EAAE,cAAc,GAAG,gBAAgB,CAAM,GACvF,iCAAiC,CAEnC"}
+{"version":3,"file":"CollaborativeEventStorming.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeEventStorming.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAGhC,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAGjF,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,iCAAkC,SAAQ,2BAA2B;IACpF,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,oFAAoF;AACpF,MAAM,MAAM,4BAA4B,GAAG,eAAe,GACxD,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,WAAW,iCAAkC,SAAQ,oBAAoB;IAC7E,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AAgBD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,iCAAiC,CASnC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,iCAAsC,GAC9C,iCAAiC,CAEnC"}

package/dist/collaborative/index.d.ts

@@ -1,2 +1,2 @@
-export { EVENT_STORMING_NOTATION, createCollaborativeModeler, createCollaborativeViewer, type CollaborativeEventStormingModeler, type CollaborativeEventStormingOptions, } from './CollaborativeEventStorming.js';
+export { EVENT_STORMING_NOTATION, createCollaborativeModeler, createCollaborativeViewer, type CollaborativeEventStormingModeler, type CollaborativeEventStormingOptions, type EventStormingElementsSurface, } from './CollaborativeEventStorming.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collaborative/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,GACvC,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collaborative/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,GAClC,MAAM,iCAAiC,CAAC"}

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { Modeler } from './Modeler.js';
 export { EventStormingBaseViewer } from './EventStormingBaseViewer.js';
 export type { EventStormingViewerOptions, EventCallback } from './EventStormingBaseViewer.js';
 export { EVENT_STORMING_NOTATION, createCollaborativeModeler, createCollaborativeViewer, } from './collaborative/index.js';
-export type { CollaborativeEventStormingModeler, CollaborativeEventStormingOptions, } from './collaborative/index.js';
+export type { CollaborativeEventStormingModeler, CollaborativeEventStormingOptions, EventStormingElementsSurface, } from './collaborative/index.js';
 export { eventStormingModelModule, EventStormingElementFactory } from './model/index.js';
 export { boardBoundsModule, BoardBounds } from './board-bounds/index.js';
 export { eventStormingDrawModule, EventStormingRenderer } from './draw/index.js';
@@ -28,7 +28,7 @@ export { eventStormingAttachModule, EventStormingAttachBehavior } from './attach
 export { eventStormingColorPickerModule, EventStormingColorPicker } from './color-picker/index.js';
 export { eventStormingResizeModule, EventStormingResizeBehavior } from './resize/index.js';
 export { eventStormingReadOnlyModule, EventStormingReadOnly, READ_ONLY_CHANGED_EVENT, } from './read-only/index.js';
-export type { FreeRectInsets } from './palette/EventStormingPaletteProvider.js';
+export type { FreeArea, FreeRectInsets } from './palette/EventStormingPaletteProvider.js';
 export { boardMenu, BOARD_LEVELS, STORM_EXPORT_LABEL, boardShortcuts, commandKeyLabel, createShortcutsDialog, } from './board-menu/index.js';
 export type { BoardExport, BoardExports, BoardLevels, BoardMenu, BoardMenuAction, BoardMenuActions, BoardMenuCheckbox, BoardMenuDialog, BoardMenuEntry, BoardMenuIcon, BoardMenuRadioGroup, BoardShortcutOptions, ShortcutGroup, ShortcutKeyNames, ShortcutPlatform, ShortcutRow, ShortcutsChrome, ShortcutsDialog, ShortcutsDialogChrome, TypeCaptions, } from './board-menu/index.js';
 export { isEventStormingShape, isEventStormingConnection, isSticky, isStickyKind, isAttachableKind, isHostKind, isAttachableSticky, isHostSticky, STICKY_KINDS, } from './model/di-types.js';

package/dist/index.d.ts.map

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