@miragon/event-storming-renderer 0.4.0 → 0.5.0

package/README.md

@@ -31,6 +31,7 @@ Place Order -> Order Placed`);
 const board = viewer.exportMap(); // canonical JSON model
 const dsl = viewer.exportDSL(); // back to .storm text
 const { svg } = await viewer.saveSVG();
+const box = viewer.contentBounds(); // the board's tight box, undefined while it is empty
 ```
 
 Swap `NavigatedViewer` for `Modeler` to get the editable board (sticky palette, context pad,
@@ -56,7 +57,7 @@ chrome covers, or `{ center: () => ({ x, y }) }`, the free centre in diagram coo
 (`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;
+name of `freeArea: { insets }`, is deprecated: still accepted through 0.5.x and removed in 0.6.0;
 given both, `freeArea` wins. Pass `fitOnImport: false` when the host sets the view after every
 import itself.
 
@@ -70,9 +71,24 @@ listener already handled (`defaultPrevented`) and keys typed into text fields ar
 the canvas container gets no `tabindex` of its own. Cmd/Ctrl+A selects the whole board. An import
 erases the undo history without firing `commandStack.changed`, and fires `import.parse.start`,
 `import.render.start` and `import.done` in that order. It frames the content centred at the
-largest zoom that shows all of it, never above 100%; an empty board shows at 100%. A label being
+largest zoom that shows all of it, never above 100%; an empty board shows at 100%. A board with
+arrow annotations is imported once the font they are set in has loaded (or failed to), so that the
+fit on import, and a host's fit after the import resolves, frame them as drawn and not as the
+fallback font would set them; imports still run in the order they were called. A label being
 typed when an import arrives is reopened on the same element afterwards, with the typed text.
 
+`contentBounds()` gives the tight box around what the board draws (`{ x, y, width, height }` in
+board coordinates, which zoom and scroll leave alone): every sticky, note and drawing, a hotspot
+with its tilt, and every arrow's annotation, which can reach far past the two stickies it stands
+between. It reads the live canvas and measures the annotations on a 2D canvas, so a zoom never
+changes it, and gives `undefined` while the board has no element. The annotations are drawn with
+`text-rendering: geometricPrecision`, as they are measured: without it Chromium lays SVG text out
+at the zoomed font size, and where it rounds glyph advances to whole pixels (Linux) the drawn text
+grows and shrinks with the zoom. A host that fits the view itself fits to it and adds its own
+margins; the importer's fit and the SVG export frame the same box with padding. A sticky's label
+wider than the sticky can overhang it, since the wrapping goes by an estimated character width;
+that overhang is not part of the box.
+
 Enter or Space on a creating palette entry (a click without a pointer, `detail` 0) places the
 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
@@ -90,7 +106,7 @@ drawing keeps literal light colours in its SVG attributes, so exports look the s
 
 ### Collaborative hosts
 
-The package implements the collaborative-modeler contract 1.2 of
+The package implements the collaborative-modeler contract 1.3 of
 [`@miragon/modeler-api`](https://www.npmjs.com/package/@miragon/modeler-api) (notation
 `event-storming`) and runs its conformance kit in CI, every case and no advisory:
 
@@ -112,7 +128,8 @@ const viewer = createCollaborativeViewer(); // meta.editable: false, never chang
   `rawPassthrough` (with a diagnostic, returned as a `warning`), gives a sticky that claims a
   reserved id (`event-storming-root`, `__implicitroot…`) a fresh one, and reads a coordinate or
   size beyond ±1e38 (more than the canvas's SVG transforms hold) as an unreadable line. A board
-  passed to `diagram.importMap` that uses a reserved id rejects before the canvas changes.
+  passed to `diagram.importMap` that uses a reserved id, or a coordinate or size beyond ±1e38
+  (`UndrawableBoardError` from the schema model), rejects before the canvas changes.
 - `onContentChanged` fires for every command-stack change, undo and redo included (also the
   workshop level), never for imports, view options (type captions) or the viewport.
 - `getViewState()` / `setViewState()` read and set the diagram-js viewbox (`x`, `y`, `width`,
@@ -131,13 +148,19 @@ const viewer = createCollaborativeViewer(); // meta.editable: false, never chang
   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.
+- `contentBounds()` (contract 1.3) is the board's tight box, as on the `Modeler` and the viewers
+  above: it covers every `elements.bounds` box, the notes and drawings, a hotspot's tilt and every
+  arrow's annotation, and is `undefined` for a board without elements, before the first import and
+  after `destroy()`. The modeler shell's `connectDiagramJs(shell, diagram, { modeler })` fits to
+  it. 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` 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.
+  viewer ignores those two); the deprecated `freeRectInsets` still works through 0.5.x and goes
+  in 0.6.0.
 - After `destroy()`, `exportText()` returns the last state and `importText()` rejects.
 
 #### Migrating a host

package/dist/EventStormingBaseViewer.d.ts

@@ -1,5 +1,6 @@
 import { ModuleDeclaration } from 'didi';
 import { EventStormingBoard } from '@miragon/event-storming-schema-model';
+import { Bounds } from './board-bounds/BoardBounds.js';
 import { ImportWarning } from './io/types.js';
 import { FreeArea, FreeRectInsets } from './palette/EventStormingPaletteProvider.js';
 export interface EventStormingViewerOptions {
@@ -22,8 +23,8 @@ export interface EventStormingViewerOptions {
      */
     freeArea?: FreeArea | undefined;
     /**
-     * @deprecated Pass `freeArea: { insets }` instead. Accepted until the next minor release;
-     * `freeArea` wins when both are given.
+     * @deprecated Pass `freeArea: { insets }` instead. Accepted through renderer 0.5.x and removed
+     * in 0.6.0; `freeArea` wins when both are given.
      */
     freeRectInsets?: (() => FreeRectInsets) | undefined;
     /**
@@ -46,16 +47,28 @@ export declare abstract class EventStormingBaseViewer {
     private _diagram;
     private readonly _container;
     private readonly _options;
+    /** The last import still waiting for its turn; a later one queues behind it. */
+    private _waitingImport;
     constructor(options?: EventStormingViewerOptions);
     private _createContainer;
     private _ensureDiagram;
     get<T>(name: string): T;
     on<T = unknown>(event: string, callback: EventCallback<T>, priority?: number): void;
     off(event: string, callback: EventCallback): void;
-    /** Load a board into the canvas (replaces existing content). */
+    /**
+     * Load a board into the canvas (replaces existing content). Resolves once the board stands
+     * fitted on its final content box: an annotated board waits for its annotations' font first.
+     */
     importMap(board: EventStormingBoard): Promise<{
         warnings: ImportWarning[];
     }>;
+    /**
+     * What an import waits for, `undefined` when it can run at once. The fit on import (the
+     * importer's and every host's after it) frames the annotations as measured, so they are measured
+     * in their own font, not in the fallback a board opened before it loaded would get; imports
+     * still run in call order, the waiting one before a later one that would not have to wait.
+     */
+    private _importTurn;
     /** Load `.storm` DSL text (internally parse -> importMap). Parser findings land in the warnings. */
     importDSL(text: string): Promise<{
         warnings: ImportWarning[];
@@ -63,6 +76,13 @@ export declare abstract class EventStormingBaseViewer {
     /** Current state as the canonical model (from the DI properties). */
     exportMap(): EventStormingBoard;
     exportDSL(): string;
+    /**
+     * The tight box around what the board draws, in diagram coordinates, which zoom and scroll leave
+     * alone: every sticky, note and drawing, a hotspot with its tilt and every arrow annotation.
+     * `undefined` while the board has no element. What a host fits its view to (modeler-api 1.3
+     * `contentBounds`); read from the live canvas, so an element created or moved counts at once.
+     */
+    contentBounds(): Bounds | undefined;
     /** Static, standalone SVG — framed by the content bounds of the free canvas. */
     saveSVG(): Promise<{
         svg: string;

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,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"}
+{"version":3,"file":"EventStormingBaseViewer.d.ts","sourceRoot":"","sources":["../src/EventStormingBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAM/F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAE5D,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;AAsB5D;;;;;;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;IACtD,gFAAgF;IAChF,OAAO,CAAC,cAAc,CAA+B;gBAEzC,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;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IA6BlF;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAUnB,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;;;;;OAKG;IACH,aAAa,IAAI,MAAM,GAAG,SAAS;IAOnC,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/board-bounds/BoardBounds.d.ts

@@ -6,21 +6,22 @@ export interface Bounds {
     height: number;
 }
 /**
- * Content bounds of the free Event Storming canvas — no rendering, no constraint. The single
- * bounds source for the SVG export viewBox and the apps' fitView (connections always run
- * between shapes, so the shape bbox covers everything).
+ * Content bounds of the free Event Storming canvas: every shape, a hotspot with its tilt, and every
+ * arrow's annotation, which stands between two stickies and can reach far past both. The single
+ * bounds source for the SVG export viewBox, the importer's fit and `contentBounds()`.
  */
 export default class BoardBounds {
     private readonly elementRegistry;
     static $inject: string[];
     constructor(elementRegistry: ElementRegistry);
     /**
-     * Bounding box over all elements, padded on every side. An empty board falls back to the
-     * schema-model default framing so fitView/export behave sensibly before the first sticky.
+     * Bounding box over everything the board draws, padded on every side. An empty board falls back
+     * to the schema-model default framing so fitView/export behave sensibly before the first sticky.
      */
     contentBounds(padding?: number): Bounds;
     /** No element on the board: `contentBounds` is only the default framing then. */
     isEmpty(): boolean;
+    private drawnBoxes;
     private positionedShapes;
 }
 //# sourceMappingURL=BoardBounds.d.ts.map

package/dist/board-bounds/BoardBounds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoardBounds.d.ts","sourceRoot":"","sources":["../../src/board-bounds/BoardBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAIvE,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAGlB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAF5C,MAAM,CAAC,OAAO,WAAuB;gBAER,eAAe,EAAE,eAAe;IAE7D;;;OAGG;IACH,aAAa,CAAC,OAAO,SAAM,GAAG,MAAM;IAgBpC,iFAAiF;IACjF,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"BoardBounds.d.ts","sourceRoot":"","sources":["../../src/board-bounds/BoardBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAKvE,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAyBD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAGlB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAF5C,MAAM,CAAC,OAAO,WAAuB;gBAER,eAAe,EAAE,eAAe;IAE7D;;;OAGG;IACH,aAAa,CAAC,OAAO,SAAM,GAAG,MAAM;IAgBpC,iFAAiF;IACjF,OAAO,IAAI,OAAO;IAIlB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/collaborative/CollaborativeEventStorming.d.ts

@@ -1,4 +1,4 @@
-import { CollaborativeModeler, CollaborativeModelerOptions, ElementsSurface } from '@miragon/modeler-api';
+import { CollaborativeModeler, CollaborativeModelerOptions, ElementBounds, ElementsSurface } from '@miragon/modeler-api';
 import { ModuleDeclaration } from 'didi';
 import { Modeler } from '../Modeler.js';
 import { NavigatedViewer } from '../NavigatedViewer.js';
@@ -14,8 +14,8 @@ export interface CollaborativeEventStormingOptions extends CollaborativeModelerO
     /** Appended to the renderer's own modules (e.g. a host's chrome module). */
     additionalModules?: ModuleDeclaration[] | undefined;
     /**
-     * @deprecated Pass `freeArea: { insets }` instead. Accepted until the next minor release;
-     * `freeArea` wins when both are given.
+     * @deprecated Pass `freeArea: { insets }` instead. Accepted through renderer 0.5.x and removed
+     * in 0.6.0; `freeArea` wins when both are given.
      */
     freeRectInsets?: (() => FreeRectInsets) | undefined;
 }
@@ -23,6 +23,11 @@ export interface CollaborativeEventStormingOptions extends CollaborativeModelerO
 export type EventStormingElementsSurface = ElementsSurface & Required<Pick<ElementsSurface, 'bounds'>>;
 /** The contract surface plus the wrapped diagram for host-specific wiring. */
 export interface CollaborativeEventStormingModeler extends CollaborativeModeler {
+    /**
+     * The tight box around what the board draws, arrow annotations and a hotspot's tilt included;
+     * `undefined` while it has no element (contract 1.3).
+     */
+    contentBounds(): ElementBounds | undefined;
     readonly elements: EventStormingElementsSurface;
     readonly diagram: Modeler | NavigatedViewer;
 }

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,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"}
+{"version":3,"file":"CollaborativeEventStorming.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeEventStorming.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,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;;;OAGG;IACH,aAAa,IAAI,aAAa,GAAG,SAAS,CAAC;IAC3C,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/draw/EventStormingRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventStormingRenderer.d.ts","sourceRoot":"","sources":["../../src/draw/EventStormingRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAE5D,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAsBzF,OAAO,KAAK,wBAAwB,MAAM,6CAA6C,CAAC;AAQxF,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAiBhE,iGAAiG;AACjG,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAoCtE,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,YAAY;IAK3D,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,MAAM,CAAC,OAAO,WAA4C;gBAGxD,QAAQ,EAAE,QAAQ,EACD,WAAW,EAAE,wBAAwB;IAK/C,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIxC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU;IAMvE,2FAA2F;IAC3F,OAAO,CAAC,WAAW;IAiBnB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA8DT,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU;IA+BxE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAKtC,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;CAK/D"}
+{"version":3,"file":"EventStormingRenderer.d.ts","sourceRoot":"","sources":["../../src/draw/EventStormingRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,kCAAkC,CAAC;AAE5D,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AA6BzF,OAAO,KAAK,wBAAwB,MAAM,6CAA6C,CAAC;AAKxF,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAiBhE,iGAAiG;AACjG,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAoCtE,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,YAAY;IAK3D,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,MAAM,CAAC,OAAO,WAA4C;gBAGxD,QAAQ,EAAE,QAAQ,EACD,WAAW,EAAE,wBAAwB;IAK/C,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIxC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU;IAMvE,2FAA2F;IAC3F,OAAO,CAAC,WAAW;IAiBnB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA8DT,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU;IA+BxE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAKtC,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;CAK/D"}

package/dist/draw/extent.d.ts

@@ -0,0 +1,47 @@
+import { Point } from 'diagram-js/lib/util/Types';
+import { EventStormingConnection } from '../model/di-types.js';
+/** Hotspots stand out with a slight tilt (rotated around the sticky center). */
+export declare const HOTSPOT_ROTATION_DEG = -3;
+/** The arrow annotation (`; …`): small italic text centred above the arrow's midpoint. */
+export declare const LINK_LABEL_FONT_SIZE = 11;
+export declare const LINK_LABEL_RISE = 5;
+/**
+ * Chromium lays SVG text out at the zoomed font size and, where it snaps glyph advances to whole
+ * pixels (Linux), the annotation's width changes with the zoom, by up to a fifth. With geometric
+ * precision it lays the text out at its own size and scales the glyphs, so the canvas measure,
+ * taken with the same setting, holds at every zoom.
+ */
+export declare const LINK_LABEL_TEXT_RENDERING = "geometricPrecision";
+export interface DrawnBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface PositionedShape {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    eventStormingType?: unknown;
+}
+/**
+ * Connection endpoints from the CURRENT shape centers, cropped at the rectangle boundary
+ * (line ends at the sticky's edge, arrowhead visible — independent of z-order, and correct
+ * after moving, since recomputed on every render).
+ */
+export declare function connectionEndpoints(connection: EventStormingConnection): [Point, Point];
+/** Where the arrow annotation's baseline is centred. */
+export declare function linkLabelAnchor(connection: EventStormingConnection): Point;
+/** The box a shape covers on the canvas: a hotspot's tilt reaches past its own box. */
+export declare function drawnShapeBox(shape: PositionedShape): DrawnBox;
+/** The box of an arrow's annotation, `undefined` for an arrow without one. */
+export declare function linkLabelBox(connection: EventStormingConnection): DrawnBox | undefined;
+/**
+ * Resolves once the font faces the annotations `texts` are set in have loaded (or failed to);
+ * `undefined` when none is pending. Their box is measured in that font: before it arrives, the
+ * fallback's widths, several px off, would be what a fit frames.
+ */
+export declare function linkLabelFontLoading(texts: readonly string[]): Promise<void> | undefined;
+export {};
+//# sourceMappingURL=extent.d.ts.map

package/dist/draw/extent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extent.d.ts","sourceRoot":"","sources":["../../src/draw/extent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAsB,MAAM,sBAAsB,CAAC;AAExF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAG9D,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAqBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,uBAAuB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAkBvF;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,UAAU,EAAE,uBAAuB,GAAG,KAAK,CAG1E;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAS9D;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,UAAU,EAAE,uBAAuB,GAAG,QAAQ,GAAG,SAAS,CAMtF;AAsBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAUxF"}

package/dist/draw/index.d.ts

@@ -3,4 +3,5 @@ import { ModuleDeclaration } from 'didi';
 export declare const eventStormingDrawModule: ModuleDeclaration;
 export { default as EventStormingRenderer } from './EventStormingRenderer.js';
 export { parseNoteMarkdown, serializeNoteMarkdown, plainNoteText, type NoteLine, type NoteRun, } from './note-markdown.js';
+export { drawnShapeBox, linkLabelBox, type DrawnBox } from './extent.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/draw/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,EAAE,iBAMrC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/draw/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,EAAE,iBAMrC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC"}