@miragon/wardley-renderer 0.13.0 → 0.15.0

package/README.md

@@ -5,7 +5,8 @@
 
 [diagram-js](https://github.com/bpmn-io/diagram-js)-based renderer for
 [Wardley Maps](https://learnwardleymapping.com/): `Viewer`, `NavigatedViewer`, and a full editable
-`Modeler`, plus OWM / JSON import and OWM / JSON / SVG / PNG export. Browser/DOM only.
+`Modeler`, plus OWM / JSON import and OWM / JSON / SVG export (a PNG through `svgToPng` of
+`@miragon/modeler-shell/export`). Browser/DOM only.
 
 ## Install
 
@@ -34,6 +35,27 @@ const { svg } = await viewer.saveSVG();
 
 Swap `NavigatedViewer` for `Modeler` to get the editable map (palette, context pad, undo/redo).
 
+For a host without the Miragon modeler shell, the `Modeler`'s palette is the toolbar of the Miragon
+design guide: a glass island at the top centre of the container (opaque in high contrast), in the
+second row, 64px from the top, in a container at most 760px wide, and ahead of the canvas in the
+tab order, with one tab stop that the arrow keys, Home and End move. Its tooltip names the entry
+and its key 8px below the palette, centred on the entry and at least 12px from the container's
+sides; it shows after 300ms of hover, at once on keyboard focus or for a neighbour, never for a
+tap, and hides on a press, on Escape and when the pointer or the focus leaves. Where the palette
+scrolls sideways, the tooltip moves with its entry and hides once the entry has left the view. The
+palette lies before the canvas `<svg>` in the container, so a host finds the canvas with
+`canvas.getContainer().querySelector(":scope > svg")`, not as the first `svg`. A palette a chrome
+skins (`data-chrome="palette"`) is left to that chrome.
+
+The lasso is pressed (`aria-pressed="true"`) only while it is armed, in every host: Enter or Space
+on the armed lasso puts it down, as Escape does, and so does arming the draw tool; a pointer's click
+on the lasso arms it again. One tool is armed at a time: arming the lasso (a click, Enter or Space
+on its entry, or L) puts the armed draw tool down, and a click, Enter or Space on the lasso's entry
+saves a line the draw tool holds, as Escape does; L does nothing while it holds one. While the
+read-only lock shows (below), the palette without the shell marks every entry but the lasso
+`aria-disabled="true"` and mutes it (guide §13.5): it stays focusable, and a click, drag, Enter or
+Space on it does nothing from the lock on.
+
 ## API
 
 | Member                                                                     | What it does                                                                                                                                        |
@@ -47,7 +69,7 @@ Swap `NavigatedViewer` for `Modeler` to get the editable map (palette, context p
 | `undo()` / `redo()` / `canUndo()` / `canRedo()`                            | `Modeler` only: the canvas command stack.                                                                                                           |
 | `commitPendingEdits()`                                                     | `Modeler` only: saves an open inline editor, e.g. before a save shortcut.                                                                           |
 | `on(event, callback)` / `off(event, callback)`                             | diagram-js events, see below.                                                                                                                       |
-| `svgToPng(svg, { scale, transparent })` / `blobToBase64`                   | Rasterizes an exported SVG (default 2×, paper background).                                                                                          |
+| `blobToBase64(blob)`                                                       | Encodes a Blob, such as the PNG of the shell's `svgToPng` (see below), as Base64 without the data-URL prefix.                                       |
 | `setAsideEditorState(modeler)` / `restoreEditorState(…)`                   | Keeps the selection and an open inline editor across a re-import of an externally changed map.                                                      |
 
 `setEvolutionLabels` turns an empty stage into its default label and `->` into `→`, so the labels
@@ -63,7 +85,8 @@ typed text across a view change, a scroll, a zoom or a host's fit, and moves wit
 Enter, leaving the field, or a click or drag on the canvas saves it. Shift+Enter breaks the line in
 a name (a note's Enter breaks it, and Cmd/Ctrl+Enter saves); the editor of a name is a `<textarea>`
 that grows with its lines, `textarea.wardley-label-input`. A name's line breaks are drawn as lines
-of the label and written to the DSL as a literal `\n` (`@miragon/wardley-dsl`).
+of the label and written to the DSL as a literal `\n` (`@miragon/wardley-dsl`). A backslash typed
+before an `n` in a name is saved as `∖` (U+2216), because the DSL would read `\n` back as a break.
 
 Options (the names of the `@miragon/modeler-api` 1.2 factory options):
 
@@ -80,7 +103,12 @@ Options (the names of the `@miragon/modeler-api` 1.2 factory options):
 The `wardleyReadOnly` service (`modeler.get<WardleyReadOnly>('wardleyReadOnly').setReadOnly(true)`)
 locks the canvas while its host cannot save an edit, e.g. while the document is invalid: every edit
 rule is vetoed, an open editor, popup or drag ends without saving, the handles hide, and selection,
-zoom, pan, select all and export stay. It fires `wardley.readOnly.changed`.
+zoom, pan, select all and export stay. `setReadOnly(true, { delayMs: 800 })` locks at once but marks
+the palette only once the delay has passed without `setReadOnly(false)`, so typing an invalid file
+in an editor beside the canvas does not flicker (guide §13.5); a call while the delay runs keeps
+its timer, `setReadOnly(false)` takes the marks off at once, and `isReadOnlyShown()` tells whether
+they show. It fires `wardley.readOnly.changed` with `{ readOnly, shown }` when the lock changes and
+once more when delayed marks show.
 
 The canvas's keys (undo and redo, delete, copy, paste and duplicate, select all, the arrows, Escape
 and the single-key tools C, U, N, P, L and A) act only while the canvas `<svg>` has the focus, as
@@ -91,8 +119,28 @@ Enter and Space on a palette tool (lasso, draw) leave the focus on the entry; on
 they place the element and hand the focus to the canvas, or to the new element's name editor; on a
 context-pad action they keep the focus in the pad, and an action that closes or redraws the pad
 (delete, line style, remove evolve) returns it to the canvas. A host that hides the canvas without
-destroying it makes the container `inert`, so the hidden canvas can neither keep the focus nor act
-on a key.
+destroying it makes the container `inert` or hides it with `display: none` or `visibility: hidden`,
+not only transparent: the browser moves the focus off the canvas at its next rendering update. A
+key that reaches the canvas or the map's own chrome before then stays with the page, for each way
+of hiding: the canvas acts on no key, the palette triggers no entry and moves no focus, a line the
+draw tool holds stays as it is, the context pad, the name, annotation and link editors, the colour
+picker and the map menu's popovers take no key, Enter on one of their buttons included, and the
+element settings menu picks no entry: nothing is saved or closed, and the focus stays where it is.
+
+Escape on the canvas ends every drag without a change, as it ends a diagram-js drag: also a label
+drag, the point drag of a drawing (the drawing stays selected) and the drag of a component's red
+evolve target. These drags and the colour picker take only an Escape aimed at the canvas (the
+picker also one on its swatches); one aimed at the palette, the context pad, a name editor or a
+host's field, menu, dialog or overlay, inside the canvas container or next to it, stays with that
+control. While the draw tool holds the points of a line, the single-key tools and Cmd/Ctrl+V (the
+paste attaches to the pointer) do nothing until the line is finished or cancelled, and the canvas
+takes them with `preventDefault()`. Enter and Space on the Draw entry save the line, as Enter on
+the canvas does. While a point of a drawing is dragged,
+the keys that would change the drawing under the drag or start a second gesture next to it do
+nothing until the release, and the canvas takes them with `preventDefault()`: the single-key tools,
+the arrow keys, paste and duplicate. Delete still removes the drawing, which ends the drag without a
+commit. An undo, a redo or any other command before the release ends the drag without a commit too,
+and the drawing stays selected, as after Escape.
 
 ## Collaborative hosts
 
@@ -112,47 +160,133 @@ modeler.onContentChanged(() => save(modeler.exportText()));
 
 An import is silent (no content change is reported back), keeps the selection and an open label
 editor and fits the view (unless `fitOnImport: false`); a host's view change (`setViewState`, a fit)
-never saves an open editor either. A gesture that runs during an import (a move, resize, connect or
-lasso drag, a create from the palette or the context pad, the evolve or plot-corner drag, the point
-drag of a drawing) is cancelled first, as Escape cancels it, so its release changes nothing. A tool
-that only waits for the user's next press stays armed: the lasso from the palette or `L`, and the
-draw tool. A drop whose change the host imports over at once, from its change listener, has applied
-and is left to finish, and the name editor of a create then stays closed, since the shape it would
-name is gone. `exportText()` is the committed document, never a live preview:
-while the plot corner is dragged or the size or axis-label popover previews a change, it returns the
-document as it was before, and the change event of the commit brings the new one. A command during a
+never saves an open editor either. A gesture that runs during an import ends first, so its release
+changes nothing. A diagram-js drag is cancelled as Escape cancels it: a move, resize, connect or
+lasso drag, a create from the palette, the context pad or a quick-create key (`C`, `U`, `N`, `P`
+with the pointer over the canvas), a connect started with `A`, the evolve drag the context pad
+starts and the plot-corner drag. A label drag, the point drag of a drawing and the drag of a
+component's red evolve target end when the import removes their element. A line the draw tool holds
+ends without a drawing, and the draw tool with it. A tool that only waits for the user's next press
+stays armed: the lasso from the palette or `L`, and the draw tool before its first point. An
+`importText` called while a user's action runs (a host that echoes its own change back through its
+store imports from the action's change listener) waits until the action has finished, then imports,
+and its Promise settles after that import; imports that wait keep their call order. A drop has
+finished once it has ended and the steps it defers to the next task have run (the name editor of a
+create or an append with the pointer). Any other command, undo or redo has finished once the code
+that ran it has returned, so an import from any listener it calls waits too: a create without a
+pointer (C, U, N, P, a palette entry with Enter or Space, the context pad's append with Enter), the
+save of a name editor (Enter, leaving the field), the save a press on the map or the palette
+makes, and a delete, an undo or a redo that deselects what it removes. The import keeps what the
+action left, as any import does: a create keeps its new element selected and its name editor open
+on it, with what was typed, and a saved name keeps its element selected. A drag that a press started
+after it saved a name ends with the import, as an accepted import ends a running gesture and a press
+below the drag threshold (L1, 1.5;
+[#285](https://github.com/Miragon/modeler-suite/issues/285),
+[#305](https://github.com/Miragon/modeler-suite/issues/305)). The start of a diagram-js drag is an
+action too, until diagram-js has activated the drag: the start clears the selection, so an import
+from the selection listener at the start of a move, a resize, a connect, the evolve placement or a
+create from the palette, the context pad or a quick-create key runs right after it and then ends
+that drag, without an error and without a change
+([#336](https://github.com/Miragon/modeler-suite/issues/336)). A `destroy()` from the selection
+listener there, or from `interaction.onChange` as the drag starts, throws nothing either, also at
+the start of the renderer's own drags (a label, a point of a drawing, the evolve target): the map is
+torn down once the code that started the drag has returned, and no listener of the host hears
+anything after `destroy()`, also not the selection the cancelled drag brings back
+([#346](https://github.com/Miragon/modeler-suite/issues/346)). The same holds for a `destroy()`
+from any listener at a drop or at Escape, the renderer's own drags included, at a create from the
+palette or the keyboard and at a paste placed with a click: the map is torn down once the handler
+of that input has returned, and the name editor a create opens a task later stays closed. No
+delivery calls a listener that an earlier listener of the same delivery unsubscribed
+([#380](https://github.com/Miragon/modeler-suite/issues/380),
+[#373](https://github.com/Miragon/modeler-suite/issues/373)). So does a `destroy()` from a listener
+that a host's own call reaches: the selection listener of `elements.reveal`, or the interaction and
+selection listeners of an import, which ends a held gesture, empties the selection as it clears the
+canvas and selects again what was selected before it. The map is torn down once that call has
+returned. The import still draws its map, which `exportText()` then returns
+([#415](https://github.com/Miragon/modeler-suite/issues/415)), and its Promise rejects with "The
+modeler was destroyed.", as an import does that waits when the modeler is destroyed.
+`exportText()` is the committed document, never a live preview: while the plot corner, an evolve target (its red circle
+or the evolve placement of the context pad) or a label is dragged, or the size or axis-label popover
+previews a change, it returns the document as it was before, and the change event of the commit
+brings the new one ([#347](https://github.com/Miragon/modeler-suite/issues/347)). A command during a
 size preview (an undo pressed mid-drag, a title the host sets) puts the preview back first, and a
-drag then ends without resizing, so the history stays in step with the document. `elements` names
-components, anchors, pipelines, submaps and accelerators by the id the document gives them
-(`cmp_kettle`), also right after a canvas edit, and `elements.bounds(id)` gives an element's live
-box in diagram coordinates; `getViewState` and `setViewState` carry the viewbox. `contentBounds()`
-(contract 1.3) gives the box a host fits the view to, in diagram coordinates and without padding:
-the plot with its axes and everything drawn beyond it (a long label at the commodity edge, a note in
-the margin), the box the pan constraint keeps in view. It follows every edit at once and stays the
-same across zoom and scroll. A map without elements still has its plot, so it is never `undefined`
-while the modeler lives (before the first import it is the default plot); tell an empty map by its
-elements. `diagram` is the wrapped `Modeler` or `NavigatedViewer` for host-specific wiring. Both
-factories take the options above (`additionalModules`, `freeArea`, `fitOnImport` and
-`undoRedoKeys`); the viewer never edits and ignores the undo keys. Both pass the
+drag then ends without resizing, so the history stays in step with the document. A drawing's point
+drag, the drag of an evolve target and a label drag end the same way, without a commit, when a
+command runs before their release (an undo pressed mid-drag, or an arrow-key nudge during the other
+two, since a point drag leaves the arrow keys without effect).
+`elements` names components, anchors, pipelines, submaps and accelerators by the id the document
+gives them (`cmp_kettle`), also right after a canvas edit, and `elements.bounds(id)` gives an
+element's live box in diagram coordinates; `getViewState` and `setViewState` carry the viewbox.
+`contentBounds()` (contract 1.3) gives the box a host fits the view to, in diagram coordinates and
+without padding: the plot with its axes and everything drawn beyond it (a long label at the
+commodity edge, a note in the margin), the box the pan constraint keeps in view. It follows every
+edit at once and stays the same across zoom and scroll. A map without elements still has its plot,
+so it is never `undefined` while the modeler lives (before the first import it is the default plot);
+tell an empty map by its elements. `diagram` is the wrapped `Modeler` or `NavigatedViewer` for
+host-specific wiring. Both factories take the options above (`additionalModules`, `freeArea`,
+`fitOnImport` and `undoRedoKeys`); the viewer never edits and ignores the undo keys. Both pass the
 contract's conformance kit (1.3) without skips.
 
+`interaction` (contract 1.5) tells a host whether the user holds a gesture, so it can defer a remote
+re-import until the gesture ends: `active()` is true from the moment a move, resize, connect or
+lasso drag, a label drag, the point drag of a drawing, the drag of an evolve target, the evolve or
+plot-corner drag, a create from the palette, the context pad or a quick-create key with the pointer
+over the canvas (also while its preview is over the palette) or a connect started with `A` starts,
+until its drop or cancel. It stays false while the lasso or the draw tool only waits for the next
+press, during a pan and on the viewer. `onChange(callback)` reports each change once, and may run
+inside `importText` (its cancel of a gesture), so a host queues its re-import instead of importing
+from the callback. A callback that throws is reported as an uncaught error a microtask later; the
+gesture and the other callbacks go on as if it had returned.
+
+`appearance` (contract 1.5) takes a host's mode: `themes` is `WARDLEY_THEMES`, `["light"]` until the
+Miragon modelers turn dark together, and `set({ theme, contrast })` writes `data-cd-theme` (the theme
+when `themes` lists it, else `themes[0]`) and, for `contrast: "high"`, `data-cd-kontrast="hoch"` on
+the map's container, so the design tokens resolve there and not from the page: on a dark page the
+map stays light, and the contrast the host asks for holds. It is view state: no change event, the
+same text and SVG export, and the history, view, selection and an open editor are left as they are.
+Until the first `set` the map takes its mode from the page, as before. `WARDLEY_THEMES` is also
+`@miragon/wardley-renderer/themes`, which loads no DOM code, for hosts outside the browser (the VS
+Code extension's theme bridge).
+
 ### Menu entries and dialogs for a host's chrome
 
 The map's entries of a chrome menu (Model: "Map title…" where the host passes `mapTitle`, "Map
 size…" and "X-axis labels…"; Export; Help) come from `mapMenu(actions)`, in the shape the menu
 groups of [`@miragon/modeler-shell`](https://www.npmjs.com/package/@miragon/modeler-shell) take.
 `createMapSizePopover(chrome, modeler)` and `createAxisLabelsPopover(chrome, modeler)` build the two
-popovers (a live preview, one undo step when done), `createTitleDialog(chrome, modeler)` the "Map
+popovers (a live preview, one undo step when done; an Escape that closes one keeps a tool armed from
+the palette, as the shell's own layers do), `createTitleDialog(chrome, modeler)` the "Map
 title…" dialog (one undo step on Apply, nothing for an unchanged title),
-`createShortcutsDialog(chrome, options)` the "Keyboard shortcuts…" dialog and
-`mapShortcuts(chrome, options)` its table. A web app that binds Cmd/Ctrl+O, Cmd/Ctrl+S, Cmd/Ctrl+V
-on the canvas and `?` itself passes `{ fileKeys: true, shortcutsKey: '?' }`, so the dialog lists
-them too, and `mapMenu({ …, shortcutsKey: '?' })` shows the key's chip on "Keyboard shortcuts…".
+`mapShortcuts(chrome, options)` the groups of its "Keyboard shortcuts…" dialog as data. A web app
+that binds Cmd/Ctrl+O, Cmd/Ctrl+S, Cmd/Ctrl+V on the canvas and `?` itself passes
+`{ fileKeys: true, shortcutsKey: '?' }`, so the dialog lists them too, and
+`mapMenu({ …, shortcutsKey: '?' })` shows the key's chip on "Keyboard shortcuts…". The shell opens
+the dialog: `shell.showShortcutsDialog(mapShortcuts(shell, options))`, or, in a host without a
+mounted shell, `showShortcutsDialog(mapShortcuts(chrome, options), { container })` of
+`@miragon/modeler-shell`.
 `createMapDialog(chrome, parts)` is the modal dialog all of them share (guide §8: header with Close,
 scrolling body, footer), for a host's own dialogs in the same look; `dialogButton(label, variant)`
 gives its buttons. `chrome` is the shell handle or anything of the same shape; the renderer never
 imports the shell itself.
 
+### PNG export
+
+The package draws no PNG itself: `svgToPng` of `@miragon/modeler-shell/export` rasterizes the SVG of
+`saveSVG()`, embeds Geist, loads the SVG as a data: URL and fills the background the caller names. A
+map has a plot, so its PNG lies on `--cd-ui-plot` (guide §10.7), which is `COLORS.plotBackground`:
+
+```ts
+import { COLORS } from "@miragon/wardley-renderer";
+import { svgToPng } from "@miragon/modeler-shell/export";
+
+const { svg } = await modeler.saveSVG();
+const png = await svgToPng(svg, { background: COLORS.plotBackground }); // 2×
+const forSlides = await svgToPng(svg, { background: "transparent", scale: 4 });
+```
+
+`blobToBase64(png)` gives the picture as Base64 without the data-URL prefix, e.g. to post it to a VS
+Code extension host.
+
 ## Events
 
 | Event                        | Payload                           | Notes                                                                                                                             |

package/dist/Modeler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modeler.d.ts","sourceRoot":"","sources":["../src/Modeler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAiB9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA6BvD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IA0CrD;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAK1B,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"Modeler.d.ts","sourceRoot":"","sources":["../src/Modeler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAiB9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA8BvD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IA2CrD;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAK1B,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,OAAO;CAGnB"}

package/dist/WardleyBaseViewer.d.ts.map

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

package/dist/a11y/canvasFocus.d.ts

@@ -1,6 +1,34 @@
 import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+import { default as PopupMenu } from 'diagram-js/lib/features/popup-menu/PopupMenu';
 /** The focusable canvas svg diagram-js renders into its container. */
 export declare function canvasSvg(canvas: Canvas): SVGElement | null;
+/**
+ * Whether a keydown is aimed at `root` or an element inside it and still free to act on. A keydown
+ * without a key (autofill), one a listener before this one took, and IME composition stay with the
+ * page, and so does a key inside an `inert` subtree or on a `root` that an ancestor with
+ * `display: none` or `visibility: hidden` hides: Chromium moves the focus off an element the host
+ * made inert or hid only at its next rendering update, so until then the key still reaches it.
+ */
+export declare function isKeyAimedAt(event: KeyboardEvent, root: Node | null | undefined): boolean;
+/**
+ * Whether a key reaches an element the host made inert or hid, before the browser moved the focus
+ * off it. The map's own chrome (context pad, editors, popovers, colour picker, popup menu) leaves
+ * such a key to the page, as the canvas and the palette do. Its buttons ask it of their click too:
+ * Enter on a focused button still clicks it once the host hid it.
+ */
+export declare function isKeyOnHiddenTarget(event: Event): boolean;
+/**
+ * diagram-js's popup menu runs its selected entry on Enter, also on one the browser still sends to
+ * a menu the host made inert or hid: such a key picks nothing and goes on to the page unprevented.
+ */
+export declare function leaveKeysOnHiddenMenuToPage(popupMenu: Pick<PopupMenu, "trigger">): void;
+/**
+ * A key is the canvas's only while the canvas `<svg>` has the focus, as with diagram-js' own
+ * keyboard: the svg holds no editor, palette, context pad or popup, so they keep their keys, and so
+ * do a host's controls inside the container or next to it, a page with nothing focused and a canvas
+ * the host made inert or hid.
+ */
+export declare function isCanvasKey(event: KeyboardEvent, canvas: Canvas): boolean;
 /**
  * Moves keyboard focus to the canvas after a pointer gesture or an editor commit. Pointer work
  * must not light up the keyboard focus ring around the whole viewport, and a press that suppressed

package/dist/a11y/canvasFocus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasFocus.d.ts","sourceRoot":"","sources":["../../src/a11y/canvasFocus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAErD,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAO3D;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAezC;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD"}
+{"version":3,"file":"canvasFocus.d.ts","sourceRoot":"","sources":["../../src/a11y/canvasFocus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,SAAS,MAAM,8CAA8C,CAAC;AAE1E,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAK3D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAWzF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAGzD;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,IAAI,CAMvF;AAOD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzE;AAcD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAO3D;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAezC;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD"}

package/dist/a11y/index.d.ts

@@ -1,5 +1,5 @@
 import { ModuleDeclaration } from 'didi';
 /** Names the canvas for assistive technology (role, role description, label). */
 export declare const canvasAccessibilityModule: ModuleDeclaration;
-export { canvasSvg, focusCanvasWithoutRing, lastInteractionWasPointer, trackInputModality, } from './canvasFocus.js';
+export { canvasSvg, focusCanvasWithoutRing, isCanvasKey, isKeyAimedAt, isKeyOnHiddenTarget, lastInteractionWasPointer, leaveKeysOnHiddenMenuToPage, trackInputModality, } from './canvasFocus.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a11y/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,EAAE,iBAEvC,CAAC;AAEF,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a11y/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,EAAE,iBAEvC,CAAC;AAEF,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/appearance/index.d.ts

@@ -0,0 +1,10 @@
+import { AppearanceTheme } from '@miragon/modeler-api';
+/**
+ * The themes a Wardley map can be drawn in (`appearance.themes` of `@miragon/modeler-api`): light
+ * only until the Miragon modelers turn dark together (guide §13.5). Both apps and the VS Code theme
+ * bridge read this one list, so the web app, the webview and an embedding host draw the same modes.
+ * The module touches no DOM, for hosts that read it outside the browser
+ * (`@miragon/wardley-renderer/themes`).
+ */
+export declare const WARDLEY_THEMES: readonly [AppearanceTheme, ...AppearanceTheme[]];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/appearance/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAEjE,CAAC"}

package/dist/appearance/index.js

@@ -0,0 +1,5 @@
+// src/appearance/index.ts
+var e = Object.freeze(["light"]);
+export { e as WARDLEY_THEMES };
+
+//# sourceMappingURL=index.js.map

package/dist/appearance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["WARDLEY_THEMES"],"sources":["../../src/appearance/index.ts"],"sourcesContent":["import type { AppearanceTheme } from \"@miragon/modeler-api\";\n\n/**\n * The themes a Wardley map can be drawn in (`appearance.themes` of `@miragon/modeler-api`): light\n * only until the Miragon modelers turn dark together (guide §13.5). Both apps and the VS Code theme\n * bridge read this one list, so the web app, the webview and an embedding host draw the same modes.\n * The module touches no DOM, for hosts that read it outside the browser\n * (`@miragon/wardley-renderer/themes`).\n */\nexport const WARDLEY_THEMES: readonly [AppearanceTheme, ...AppearanceTheme[]] = Object.freeze([\n  \"light\",\n] as const);\n"],"mappings":";AASA,IAAaA,IAAmE,OAAO,OAAO,CAC5F,OACF,CAAU"}

package/dist/append/WardleyAppendBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyAppendBehavior.d.ts","sourceRoot":"","sources":["../../src/append/WardleyAppendBehavior.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AA6CrC;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC,MAAM,CAAC,OAAO,WAA4B;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;CA0CnD"}
+{"version":3,"file":"WardleyAppendBehavior.d.ts","sourceRoot":"","sources":["../../src/append/WardleyAppendBehavior.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AA6CrC;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC,MAAM,CAAC,OAAO,WAA4B;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;CAkDnD"}

package/dist/collaborative/CollaborativeWardley.d.ts

@@ -1,4 +1,4 @@
-import { CollaborativeModeler, CollaborativeModelerOptions, ElementBounds, ElementsSurface } from '@miragon/modeler-api';
+import { AppearanceSurface, CollaborativeModeler, CollaborativeModelerOptions, ElementBounds, ElementsSurface, InteractionSurface } from '@miragon/modeler-api';
 import { ModuleDeclaration } from 'didi';
 import { Modeler } from '../Modeler.js';
 import { NavigatedViewer } from '../NavigatedViewer.js';
@@ -17,11 +17,13 @@ export interface WardleyElementsSurface extends ElementsSurface {
     bounds(id: string): ElementBounds | undefined;
 }
 /**
- * The contract surface, with the optional `contentBounds` of contract 1.3 always present, plus the
- * wrapped diagram for host-specific wiring.
+ * The contract surface, with the optional `contentBounds` of contract 1.3 and `interaction` and
+ * `appearance` of contract 1.5 always present, plus the wrapped diagram for host-specific wiring.
  */
 export interface CollaborativeWardleyModeler extends CollaborativeModeler {
     readonly elements: WardleyElementsSurface;
+    readonly interaction: InteractionSurface;
+    readonly appearance: AppearanceSurface;
     readonly diagram: Modeler | NavigatedViewer;
     contentBounds(): ElementBounds | undefined;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"CollaborativeWardley.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeWardley.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;CACrD;AAED,iGAAiG;AACjG,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;IAC5C,aAAa,IAAI,aAAa,GAAG,SAAS,CAAC;CAC5C;AA2BD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAQ7B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAE7B"}
+{"version":3,"file":"CollaborativeWardley.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeWardley.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EAExB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAaxD,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;CACrD;AAED,iGAAiG;AACjG,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;IAC5C,aAAa,IAAI,aAAa,GAAG,SAAS,CAAC;CAC5C;AA2BD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAQ7B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAE7B"}

package/dist/color-picker/WardleyColorPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyColorPicker.d.ts","sourceRoot":"","sources":["../../src/color-picker/WardleyColorPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAazD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAmBnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IArB3B,MAAM,CAAC,OAAO,WAAyD;IAEvE,OAAO,CAAC,OAAO,CAA0B;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAGF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;gBAGiB,MAAM,EAAE,MAAM,EAC/B,QAAQ,EAAE,QAAQ,EACD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,QAAQ;IASrC,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA+DjE,MAAM,IAAI,OAAO;IAIjB,KAAK,CAAC,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAUrD,OAAO,CAAC,aAAa;CAkBtB"}
+{"version":3,"file":"WardleyColorPicker.d.ts","sourceRoot":"","sources":["../../src/color-picker/WardleyColorPicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAczD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAoBnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAtB3B,MAAM,CAAC,OAAO,WAAyD;IAEvE,OAAO,CAAC,OAAO,CAA0B;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAIF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;gBAGiB,MAAM,EAAE,MAAM,EAC/B,QAAQ,EAAE,QAAQ,EACD,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,QAAQ;IASrC,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgEjE,MAAM,IAAI,OAAO;IAIjB,KAAK,CAAC,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAUrD,OAAO,CAAC,aAAa;CAmBtB"}

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

@@ -1 +1 @@
-{"version":3,"file":"WardleyRenderer.d.ts","sourceRoot":"","sources":["../../src/draw/WardleyRenderer.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;AAEzF,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAgCvE,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAMpE,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,sGAAsG;AACtG,eAAO,MAAM,cAAc,qBAAqB,CAAC;AACjD,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAKtD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,YAAY;IAKrD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IALlC,MAAM,CAAC,OAAO,WAAoD;gBAGhE,QAAQ,EAAE,QAAQ,EACD,IAAI,EAAE,aAAa,EACnB,eAAe,EAAE,eAAe;IAK1C,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIxC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU;IAyBvE,qFAAqF;IACrF,OAAO,CAAC,WAAW;IAiBV,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU;IAkDxE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAKtC,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAM9D,OAAO,CAAC,aAAa;IAuCrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IAmFpB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,YAAY;IAyDpB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,UAAU;CA8CnB"}
+{"version":3,"file":"WardleyRenderer.d.ts","sourceRoot":"","sources":["../../src/draw/WardleyRenderer.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;AAEzF,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAiCvE,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAMpE,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AACrD,sGAAsG;AACtG,eAAO,MAAM,cAAc,qBAAqB,CAAC;AACjD,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAKtD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,YAAY;IAKrD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IALlC,MAAM,CAAC,OAAO,WAAoD;gBAGhE,QAAQ,EAAE,QAAQ,EACD,IAAI,EAAE,aAAa,EACnB,eAAe,EAAE,eAAe;IAK1C,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIxC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,GAAG,UAAU;IAyBvE,qFAAqF;IACrF,OAAO,CAAC,WAAW;IAiBV,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU;IAkDxE,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAKtC,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAM9D,OAAO,CAAC,aAAa;IAsCrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IAmFpB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,YAAY;IAyDpB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,UAAU;CA8CnB"}

package/dist/draw/index.d.ts

@@ -2,5 +2,5 @@ import { ModuleDeclaration } from 'didi';
 /** SVG rendering of all Wardley types (BaseRenderer subclass, priority 1500). */
 export declare const wardleyDrawModule: ModuleDeclaration;
 export { default as WardleyRenderer, LABEL_HANDLE_CLASS, LABEL_ROLE_ATTRIBUTE, MOVEMENT_CLASS, NAME_LABEL_CLASS, } from './WardleyRenderer.js';
-export { componentLabelPlacement, componentLabelSlot, movementDeltaX, movementLabelPlacement, movementLabelSlot, normalizeLabelOffset, type LabelPlacement, } from './label-layout.js';
+export { componentLabelPlacement, componentLabelSlot, movementDeltaX, movementLabelPlacement, movementLabelSlot, nameLineGrowth, normalizeLabelOffset, type LabelPlacement, type LineGrowth, } from './label-layout.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;AAG9C,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,iBAG/B,CAAC;AAEF,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/draw/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,iBAG/B,CAAC;AAEF,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/draw/label-layout.d.ts

@@ -1,3 +1,4 @@
+import { default as ElementRegistry } from 'diagram-js/lib/core/ElementRegistry';
 import { LabelOffset } from '@miragon/wardley-schema-model';
 import { WardleyShape } from '../model/di-types.js';
 import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
@@ -31,14 +32,22 @@ export declare function movementDeltaX(shape: WardleyShape, grid: Pick<Evolution
 export declare function estimatedLabelWidth(text: string): number;
 export declare function nameLines(text: string | undefined): string[];
 /**
- * How the lines of a name that holds line breaks spread around the slot of its first line:
+ * How the lines of a name that holds line breaks spread around the slot of a one-line name:
  * `centered` keeps the block's middle on the slot (names beside a circle or a symbol), `up` keeps
- * the last line on it (a name above an icon, a pipeline's edge or an evolve arrow, which the lines
- * must stay clear of).
+ * the last line on it (a name above an icon, a pipeline's top edge or an evolve arrow, which the
+ * lines must stay clear of), `down` keeps the first line on it (a name below a pipeline's top edge).
  */
-export type LineGrowth = "centered" | "up";
+export type LineGrowth = "centered" | "up" | "down";
 export declare function firstLineBaseline(slotY: number, lineCount: number, growth: LineGrowth): number;
 export declare function lastLineBaseline(slotY: number, lineCount: number, growth: LineGrowth): number;
+/**
+ * How the lines of an element's own name grow, shared by the renderer and the name editor. A
+ * pipeline's dashed top edge runs through the centre of its anchor component, whose name grows
+ * upward as it does over an evolve arrow. The edge runs 11 px above the slot of a member's name:
+ * upward, its lines would straddle the edge and run into the anchor component's name, so they grow
+ * downward inside the box.
+ */
+export declare function nameLineGrowth(shape: WardleyShape, elementRegistry: Pick<ElementRegistry, "find">): LineGrowth;
 /** The canonical OWM slot of a component name — the origin of its `label [dx, dy]`. */
 export declare function componentLabelSlot(): {
     x: number;

package/dist/draw/label-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label-layout.d.ts","sourceRoot":"","sources":["../../src/draw/label-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAEpE;;;;;;;GAOG;AAEH,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,wDAAwD;AACxD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GACpC,MAAM,GAAG,SAAS,CASpB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAE5D;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC;AAE3C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAG9F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAE7F;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,IAAI;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAE7D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAK7F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,cAAc,CAchB;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAElF;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,cAAc,EAAE,MAAM,GACrB,cAAc,CAShB;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAOxE;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAKpF"}
+{"version":3,"file":"label-layout.d.ts","sourceRoot":"","sources":["../../src/draw/label-layout.ts"],"names":[],"mappings":"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"}

package/dist/draw-tool/WardleyDrawTool.d.ts

@@ -8,8 +8,11 @@ import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
 /**
  * Excalidraw-style polyline tool: activate, click point by point (rubber-band preview).
  * Finishing (like Excalidraw): click the LAST point again, double-click, Enter or Escape
- * commits the open line; clicking the FIRST point closes the shape. Escape with fewer than
- * two points cancels. The result is ONE undoable `drawing` shape that moves as a whole.
+ * commits the open line, and so does Space on the tool's palette entry; clicking the FIRST point
+ * closes the shape. Escape with fewer than two points cancels. The result is ONE undoable
+ * `drawing` shape that moves as a whole. An import cancels a line in progress without committing
+ * it and leaves a tool without points armed. Arming another tool (the lasso) puts it down and saves
+ * a held line as Escape does, so one tool is armed at a time.
  */
 export default class WardleyDrawTool {
     private readonly canvas;
@@ -26,6 +29,8 @@ export default class WardleyDrawTool {
     private layer;
     constructor(canvas: Canvas, eventBus: EventBus, modeling: Modeling, selection: Selection, factory: WardleyElementFactory, grid: EvolutionGrid, injector: Injector);
     isActive(): boolean;
+    /** True while the tool holds the points of a line it has not finished yet. */
+    holdsLine(): boolean;
     toggle(): void;
     /**
      * The OUTER viewer container — getContainer() returns the inner .djs-container, but the
@@ -35,6 +40,12 @@ export default class WardleyDrawTool {
     activate(): void;
     /** Finishes the current polyline (>= 2 points) and deactivates the tool. */
     finish(): void;
+    /**
+     * Another tool took the press: the line is saved as Escape saves it, and the release is not
+     * reported, which would show that tool released while it is armed.
+     */
+    private giveWay;
+    private finishLine;
     /** Closes the shape (polygon) using the collected points. */
     private finishClosed;
     /**
@@ -58,10 +69,18 @@ export default class WardleyDrawTool {
      * Enter and Escape end the drawing only when aimed at the canvas `<svg>`, or at the palette entry
      * that starts this tool, where a tool started with Enter leaves the focus (guide §5.5). Every
      * other target keeps them, inside the container too: a host's fields, buttons, menus and dialogs,
-     * its zoom panel, a focusable element in an overlay next to the canvas, and `<body>`. A capture
-     * listener on the document would otherwise take them from all of these.
+     * its zoom panel, a focusable element in an overlay next to the canvas, `<body>` and a canvas the
+     * host made inert or hid. A capture listener on the document would otherwise take them from all
+     * of these.
      */
     private ownsKey;
+    private targetsOwnPaletteEntry;
+    /**
+     * Enter and Space act alike on a palette entry (guide §5.5), and Space on this tool's entry would
+     * otherwise toggle the tool off and drop the line it holds, where Enter saves it. A Space with
+     * Alt, Ctrl or Meta activates no entry and stays the page's here too.
+     */
+    private savesWithSpace;
     private readonly onKeyDown;
     private renderPreview;
     private clearPreview;

package/dist/draw-tool/WardleyDrawTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyDrawTool.d.ts","sourceRoot":"","sources":["../../src/draw-tool/WardleyDrawTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAQrC,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AAGzE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAcpE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAiBhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAtB3B,MAAM,CAAC,OAAO,WAQZ;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA2B;gBAGrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,QAAQ;IAKrC,QAAQ,IAAI,OAAO;IAInB,MAAM,IAAI,IAAI;IAKd;;;OAGG;IACH,OAAO,CAAC,cAAc;IAKtB,QAAQ,IAAI,IAAI;IAgBhB,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAOd,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAOpB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAWd,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,UAAU;IAelB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB,sFAAsF;IACtF,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAsB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAKzB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,QAAQ,CAAC,SAAS,CAcxB;IAEF,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,YAAY;CAMrB"}
+{"version":3,"file":"WardleyDrawTool.d.ts","sourceRoot":"","sources":["../../src/draw-tool/WardleyDrawTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAQrC,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AAGzE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAgBpE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAiBhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAtB3B,MAAM,CAAC,OAAO,WAQZ;IAEF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA2B;gBAGrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,QAAQ;IAkBrC,QAAQ,IAAI,OAAO;IAInB,8EAA8E;IAC9E,SAAS,IAAI,OAAO;IAIpB,MAAM,IAAI,IAAI;IAKd;;;OAGG;IACH,OAAO,CAAC,cAAc;IAKtB,QAAQ,IAAI,IAAI;IAgBhB,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,UAAU;IAOlB,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAOpB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAWd,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,UAAU;IAelB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAYrB,sFAAsF;IACtF,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAsB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAKzB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,sBAAsB;IAQ9B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAcxB;IAEF,OAAO,CAAC,aAAa;IAiDrB,OAAO,CAAC,YAAY;CAMrB"}