@miragon/wardley-renderer 0.6.3 → 0.7.0

package/README.md

@@ -5,7 +5,7 @@
 
 [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 / SVG / PNG import and export. Browser/DOM only.
+`Modeler`, plus OWM / JSON import and OWM / JSON / SVG / PNG export. Browser/DOM only.
 
 ## Install
 
@@ -34,6 +34,38 @@ const { svg } = await viewer.saveSVG();
 
 Swap `NavigatedViewer` for `Modeler` to get the editable map (palette, context pad, undo/redo).
 
+## API
+
+| Member                                                   | What it does                                                                                                      |
+| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `importDSL(text)` / `importMap(map)`                     | Loads a map (replaces the content, clears the undo history). Resolves to `{ warnings }`.                          |
+| `exportDSL()` / `exportMap()` / `saveSVG()`              | The map as canonical OWM text, as the JSON model, or as a standalone SVG (never shows selection or hover state).  |
+| `setTitle(title)`                                        | Sets the map title (one undo step in the `Modeler`).                                                              |
+| `getMapSize()`                                           | The plot size as drawn, whether the map writes it (`size [w, h]`) and the matching preset.                        |
+| `setMapSize(width, height)` / `resetMapSize()`           | Changes the plot size (rounded and clamped to 480–5000 × 320–5000). In the `Modeler` one undo step, no re-import. |
+| `setEvolutionLabels(labels, { transient })`              | Sets the four X-axis stage labels (normalized, see below); `transient` previews without an undo step.             |
+| `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).                                                        |
+| `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
+always write a valid `evolution` line; the default set is stored as `undefined`.
+
+Options: `new Modeler({ container, keyboard: { undoRedo: false } })` leaves Cmd/Ctrl+Z/Y to the
+host (VS Code owns its document's undo stack). `additionalModules` adds diagram-js modules; every
+Wardley feature module is exported for custom editors.
+
+## Events
+
+| Event                        | Payload                           | Notes                                                                                                                             |
+| ---------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `import.done`                | `{ warnings }`                    | After every import.                                                                                                               |
+| `commandStack.changed`       | `{ trigger }`                     | `Modeler`: after every committed edit, undo and redo, including size, title and label changes.                                    |
+| `wardley.config.changed`     | `WardleyConfigChangedEvent`       | Title, size or axis labels changed. `transient` events are live previews (typing, dragging the plot corner): do not persist them. |
+| `wardley.label.deduplicated` | `{ element, requested, applied }` | A typed name was taken and a free variant (`Tea 2`) was used instead.                                                             |
+
 ### Fonts
 
 The package ships no fonts and uses no CDN. The canvas typeface is **Geist** (Miragon corporate
@@ -44,6 +76,10 @@ identity); provide it yourself — recommended self-hosted via [`@fontsource`](h
 import '@fontsource-variable/geist/wght.css';
 ```
 
+That package registers the family as `'Geist Variable'`; the renderer's font stack starts with
+`'Geist Variable', 'Geist', …` so it matches either that package or a locally installed Geist. Use
+`'Geist Variable'` in your own CSS too — `'Geist'` alone never matches the self-hosted face.
+
 Part of the [Wardley Maps](https://github.com/Miragon/wardley-maps-modeler) monorepo.
 
 ## License

package/dist/Modeler.d.ts

@@ -6,6 +6,11 @@ import { NavigatedViewer } from './NavigatedViewer.js';
  */
 export declare class Modeler extends NavigatedViewer {
     protected _getModules(): ModuleDeclaration[];
+    /**
+     * Saves any open inline editor (name, note, link annotation, flow value, link address). Call it
+     * before saving or exporting from a keyboard shortcut, which does not take focus off the editor.
+     */
+    commitPendingEdits(): void;
     undo(): void;
     redo(): void;
     canUndo(): boolean;

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;AAc9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAkBvD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IAgCrD,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;AA4BvD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IAyCrD;;;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

@@ -1,5 +1,5 @@
 import { ModuleDeclaration } from 'didi';
-import { WardleyMap } from '@miragon/wardley-schema-model';
+import { MapConfig, MapSizePresetId, WardleyMap } from '@miragon/wardley-schema-model';
 import { ImportWarning } from './io/types.js';
 export interface WardleyViewerOptions {
     /** Host element. If missing, a detached <div> is created (can be attached later via attachTo). */
@@ -8,8 +8,32 @@ export interface WardleyViewerOptions {
     height?: number | string;
     /** Concatenated to the end of the module list (extension point, §12). */
     additionalModules?: ModuleDeclaration[];
+    /**
+     * Modeler keyboard behaviour. `undoRedo: false` leaves Cmd/Ctrl+Z/Y to the host (e.g. VS Code,
+     * which owns the document's undo stack). Default: the canvas handles undo/redo.
+     */
+    keyboard?: {
+        undoRedo?: boolean;
+    };
 }
 export type EventCallback<T = unknown> = (event: T) => void;
+/** The plot size as drawn, plus whether the map writes it explicitly (`size [w, h]`). */
+export interface MapSizeInfo {
+    width: number;
+    height: number;
+    isExplicit: boolean;
+    presetId?: MapSizePresetId;
+}
+/** Payload of `wardley.config.changed`: title, size or axis labels changed. */
+export interface WardleyConfigChangedEvent {
+    config: MapConfig;
+    /** A live preview (typing, dragging the plot corner): not a change to persist. */
+    transient?: true;
+}
+export interface SetEvolutionLabelsOptions {
+    /** Live preview: applied directly, without an undo step (commit later without this flag). */
+    transient?: boolean;
+}
 /**
  * Shared lifecycle & DI bootstrap for all Wardley viewers (analogous to bpmn-js BaseViewer, but OUR
  * OWN code — no bpmn-js as a dependency, §3.3). Subclasses only override `_getModules()` (a method
@@ -21,6 +45,8 @@ export declare abstract class WardleyBaseViewer {
     private _diagram;
     private readonly _container;
     private readonly _options;
+    /** Labels before the first transient preview, so the commit becomes one undo step from there. */
+    private _labelsBeforePreview;
     constructor(options?: WardleyViewerOptions);
     private _createContainer;
     private _ensureDiagram;
@@ -40,21 +66,53 @@ export declare abstract class WardleyBaseViewer {
     /** Current state as the canonical model (from the DI properties). */
     exportMap(): WardleyMap;
     /**
-     * Changes the map's logical plot size (in diagram-px) and re-projects all elements.
-     * Sets `config.size` and re-imports the current state (normalized coordinates stay the truth).
+     * Sets the plot size in diagram-px. The size is normalized first (whole pixels, clamped to
+     * PLOT_MIN..PLOT_MAX); non-finite input throws a RangeError before anything changes. In the
+     * Modeler this is one undoable step that re-projects the shapes in place (selection, viewport and
+     * history survive); the read-only viewers re-import. An explicit size line is written even for
+     * the default size — only `resetMapSize` removes it.
      */
     setMapSize(width: number, height: number): Promise<{
         warnings: ImportWarning[];
     }>;
+    /** Removes the `size` line: the map is drawn at the default plot size again. */
+    resetMapSize(): Promise<{
+        warnings: ImportWarning[];
+    }>;
+    getMapSize(): MapSizeInfo;
+    private _reimportWithSize;
+    /**
+     * Sets the map title (one undoable step in the Modeler). Line breaks become spaces so the DSL
+     * `title` line stays one line; an empty title falls back to the default.
+     */
+    setTitle(title: string): void;
     /**
      * Sets the four X-axis stage labels (`undefined` = default Genesis/Custom/Product/Commodity).
-     * Changes only the labeling, not the geometry: updates the map config in-place and re-renders only
-     * the axis background (no re-import -> no view jump, no selection loss). Fires
-     * `wardley.config.changed` for consumers' URL/persistence sync.
+     * Empty stages fall back to their default and a `->` becomes `→`, so the labels always write a
+     * valid `evolution` line; the default set is stored as `undefined`.
+     * Changes only the labeling, not the geometry (no re-import -> no view jump, no selection loss).
+     * In the Modeler this is one undoable step; `{ transient: true }` applies a live preview without
+     * an undo step, and the next non-transient call commits it as ONE step from the state before the
+     * preview (no step at all when the labels end where the preview started). Fires
+     * `wardley.config.changed` (`{ config, transient? }`): transient events are live previews and
+     * must not be persisted; in the Modeler every committed change is followed by
+     * `commandStack.changed`.
+     */
+    setEvolutionLabels(requested: readonly string[] | undefined, options?: SetEvolutionLabelsOptions): void;
+    /**
+     * Config change without the command stack (read-only viewers, live previews): updates the root
+     * config in place and re-renders only the axis background.
      */
-    setEvolutionLabels(labels: readonly [string, string, string, string] | undefined): void;
+    private _applyConfigDirectly;
+    /** The Modeler's command API, or null in the read-only viewers. */
+    private _wardleyModeling;
+    private _root;
+    private _rootBusinessObject;
     exportDSL(): string;
-    /** Static, standalone SVG. */
+    /**
+     * Static, standalone SVG covering the whole plot (at its actual `config.size`) plus any content
+     * drawn beyond it, such as long labels of commodity components.
+     */
     saveSVG(): Promise<{
         svg: string;
     }>;

package/dist/WardleyBaseViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyBaseViewer.d.ts","sourceRoot":"","sources":["../src/WardleyBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAM3E,OAAO,EAAW,KAAK,aAAa,EAA2B,MAAM,eAAe,CAAC;AAErF,MAAM,WAAW,oBAAoB;IACnC,kGAAkG;IAClG,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAM5D;;;;;GAKG;AACH,8BAAsB,iBAAiB;IACrC,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,CAAuB;gBAEpC,OAAO,GAAE,oBAAyB;IAK9C,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAQtB,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,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAcxE,iGAAiG;IACjG,OAAO,CAAC,gBAAgB;IAMxB,+FAA+F;IACzF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAcrE,qEAAqE;IACrE,SAAS,IAAI,UAAU;IAIvB;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAKvF;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI;IAqBvF,SAAS,IAAI,MAAM;IAInB,8BAA8B;IACxB,OAAO,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IASzC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKnC,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,IAAI,SAAS,IAAI,WAAW,CAE3B;CACF"}
+{"version":3,"file":"WardleyBaseViewer.d.ts","sourceRoot":"","sources":["../src/WardleyBaseViewer.ts"],"names":[],"mappings":"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"}

package/dist/a11y/canvasFocus.d.ts

@@ -0,0 +1,17 @@
+import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+/** The focusable canvas svg diagram-js renders into its container. */
+export declare function canvasSvg(canvas: Canvas): SVGElement | null;
+/**
+ * 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
+ * the browser's own focus change must still take focus away from host inputs (title, size
+ * fields), or Delete/Undo would edit those instead of the map.
+ */
+export declare function focusCanvasWithoutRing(canvas: Canvas): void;
+/**
+ * Starts following whether the user last used the pointer or the keyboard (idempotent). Editors
+ * opened with the pointer hand focus back without the keyboard focus ring.
+ */
+export declare function trackInputModality(): void;
+export declare function lastInteractionWasPointer(): boolean;
+//# sourceMappingURL=canvasFocus.d.ts.map

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

@@ -0,0 +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"}

package/dist/a11y/describeCanvas.d.ts

@@ -0,0 +1,8 @@
+import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+/** Names the focusable canvas for assistive technology (it is otherwise an anonymous svg). */
+declare function describeCanvas(canvas: Canvas): void;
+declare namespace describeCanvas {
+    var $inject: string[];
+}
+export default describeCanvas;
+//# sourceMappingURL=describeCanvas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describeCanvas.d.ts","sourceRoot":"","sources":["../../src/a11y/describeCanvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAGrD,8FAA8F;AAC9F,iBAAwB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM3D;kBANuB,cAAc;;;eAAd,cAAc"}

package/dist/a11y/index.d.ts

@@ -0,0 +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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/append/WardleyAppendBehavior.d.ts

@@ -1,12 +1,13 @@
 import { default as EventBus } from 'diagram-js/lib/core/EventBus';
 import { Injector } from 'didi';
 /**
- * Behavior for "append component" (`create.start` with `context.source`):
- *  1. LIVE arrow preview from the source to the cursor (analogous to diagram-js ConnectPreview, but
- *     in the create flow) — requires the `connectionPreview` service (ConnectionPreviewModule).
- *  2. After creation, automatically opens the new component's label editor so it can be named
- *     (uniquely) right away.
- * Both only when `context.source` is set; ordinary palette-create stays untouched.
+ * Create behavior for palette, keyboard and "append component" (`create.start`, the latter with
+ * `context.source`):
+ *  1. Append only: LIVE arrow preview from the source to the cursor (analogous to diagram-js
+ *     ConnectPreview, but in the create flow) — requires the `connectionPreview` service.
+ *  2. After placing a single named element (component, user, submap, pipeline, accelerator, note)
+ *     the label editor opens with the placeholder selected, so typing names it right away.
+ *     Regions, drawings and pasted copies are left alone.
  */
 export default class WardleyAppendBehavior {
     static $inject: string[];

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;AAgCrC;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC,MAAM,CAAC,OAAO,WAA4B;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;CAyCnD"}
+{"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"}

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

@@ -6,7 +6,8 @@ import { WardleyShape } from '../model/di-types.js';
  * Compact color picker (bpmn.io-style): a 3x3 grid of small color squares (no text), opened from a
  * note's context pad. Uses its own popover (instead of diagram-js PopupMenu) so the swatch grid can
  * be rendered exactly and without text. Sets the color via `wardleyModeling` (undo/redo). First
- * cell = "no color".
+ * cell = "no color". Keyboard: focus starts on the active swatch, arrow keys move through the grid,
+ * Enter/Space picks, Escape closes; focus then returns to the canvas.
  */
 export default class WardleyColorPicker {
     private readonly canvas;
@@ -18,6 +19,10 @@ export default class WardleyColorPicker {
     constructor(canvas: Canvas, eventBus: EventBus, modeling: WardleyModeling);
     /** Opens the swatch grid for `shape` at the click position (viewport coordinates). */
     open(shape: WardleyShape, clientX: number, clientY: number): void;
-    close(): void;
+    isOpen(): boolean;
+    close(options?: {
+        restoreFocus?: boolean;
+    }): void;
+    private onGridKeydown;
 }
 //# sourceMappingURL=WardleyColorPicker.d.ts.map

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,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAanC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAd3B,MAAM,CAAC,OAAO,WAA6C;IAE3D,OAAO,CAAC,OAAO,CAA0B;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAEpB;gBAGiB,MAAM,EAAE,MAAM,EAC/B,QAAQ,EAAE,QAAQ,EACD,QAAQ,EAAE,eAAe;IAM5C,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA+CjE,KAAK,IAAI,IAAI;CAOd"}
+{"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,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;IAiBnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAlB3B,MAAM,CAAC,OAAO,WAA6C;IAE3D,OAAO,CAAC,OAAO,CAA0B;IAEzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;gBAGiB,MAAM,EAAE,MAAM,EAC/B,QAAQ,EAAE,QAAQ,EACD,QAAQ,EAAE,eAAe;IAM5C,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA4DjE,MAAM,IAAI,OAAO;IAIjB,KAAK,CAAC,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAUrD,OAAO,CAAC,aAAa;CAkBtB"}

package/dist/context-pad/WardleyContextPad.d.ts

@@ -0,0 +1,30 @@
+import { default as ContextPad } from 'diagram-js/lib/features/context-pad/ContextPad';
+import { Element } from 'diagram-js/lib/model/Types';
+interface TargetBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Anchors the pad to a node and its own label instead of the whole graphics group: an evolving
+ * component's group also holds the evolve arrow, target circle and target name, which would push the
+ * pad hundreds of pixels away from the node the user selected. When the evolve target lies where
+ * the pad would open, the pad clears the whole movement instead — otherwise it would hide the target
+ * circle, which is the evolve's drag handle.
+ *
+ * Overrides diagram-js's private `_getTargetBounds` (guarded by a browser test).
+ */
+export default class WardleyContextPad extends ContextPad {
+    _getTargetBounds(target: Element | Element[]): TargetBounds;
+    private internals;
+    private padWidth;
+    private movementTargetRects;
+    private visualRects;
+}
+export {};
+//# sourceMappingURL=WardleyContextPad.d.ts.map

package/dist/context-pad/WardleyContextPad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WardleyContextPad.d.ts","sourceRoot":"","sources":["../../src/context-pad/WardleyContextPad.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,gDAAgD,CAAC;AAExE,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,4BAA4B,CAAC;AAGrE,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,UAAU;IACvD,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,YAAY;IAkB3D,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/context-pad/WardleyContextPadProvider.d.ts

@@ -1,3 +1,5 @@
+import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+import { default as EventBus } from 'diagram-js/lib/core/EventBus';
 import { default as ContextPad } from 'diagram-js/lib/features/context-pad/ContextPad';
 import { default as Modeling } from 'diagram-js/lib/features/modeling/Modeling';
 import { default as Connect } from 'diagram-js/lib/features/connect/Connect';
@@ -5,6 +7,7 @@ import { default as Create } from 'diagram-js/lib/features/create/Create';
 import { default as PopupMenu } from 'diagram-js/lib/features/popup-menu/PopupMenu';
 import { ContextPadEntries, default as ContextPadProvider } from 'diagram-js/lib/features/context-pad/ContextPadProvider';
 import { Element } from 'diagram-js/lib/model/Types';
+import { Injector } from 'didi';
 import { default as WardleyModeling } from '../modeling/WardleyModeling.js';
 import { default as WardleyLabelEditing } from '../label-editing/WardleyLabelEditing.js';
 import { default as WardleyEvolveDragging } from '../evolve/WardleyEvolveDragging.js';
@@ -12,6 +15,7 @@ import { default as WardleyElementFactory } from '../model/WardleyElementFactory
 import { default as WardleyColorPicker } from '../color-picker/WardleyColorPicker.js';
 /** Context actions per element (concept doc §5.5). */
 export default class WardleyContextPadProvider implements ContextPadProvider {
+    private readonly contextPad;
     private readonly modeling;
     private readonly connect;
     private readonly create;
@@ -21,8 +25,26 @@ export default class WardleyContextPadProvider implements ContextPadProvider {
     private readonly evolveDragging;
     private readonly factory;
     private readonly colorPicker;
+    private readonly canvas;
+    private readonly injector;
     static $inject: string[];
-    constructor(contextPad: ContextPad, modeling: Modeling, connect: Connect, create: Create, popupMenu: PopupMenu, wardleyModeling: WardleyModeling, labelEditing: WardleyLabelEditing, evolveDragging: WardleyEvolveDragging, factory: WardleyElementFactory, colorPicker: WardleyColorPicker);
+    /** Synthetic clicks created for Enter/Space, so actions can pick a pointer-free variant. */
+    private readonly keyboardEvents;
+    constructor(contextPad: ContextPad, modeling: Modeling, connect: Connect, create: Create, popupMenu: PopupMenu, wardleyModeling: WardleyModeling, labelEditing: WardleyLabelEditing, evolveDragging: WardleyEvolveDragging, factory: WardleyElementFactory, colorPicker: WardleyColorPicker, eventBus: EventBus, canvas: Canvas, injector: Injector);
     getContextPadEntries(element: Element): ContextPadEntries;
+    /** Connections: edit the annotation (or the flow value of an imported flow link) + delete. */
+    private connectionEntries;
+    /** Row 1: edit label, append, connect, evolve. */
+    private addPrimaryEntries;
+    /** Row 2: settings, line style, colour, link. */
+    private addPropertyEntries;
+    /** Enter/Space on a focused entry = a click at the element's centre. */
+    private onPadKeydown;
+    private clientCenterOf;
+    /**
+     * Keyboard append: there is no pointer to drag the new component to, so it is placed one step
+     * further down the value chain, connected, selected and opened for naming.
+     */
+    private appendBelow;
 }
 //# sourceMappingURL=WardleyContextPadProvider.d.ts.map

package/dist/context-pad/WardleyContextPadProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyContextPadProvider.d.ts","sourceRoot":"","sources":["../../src/context-pad/WardleyContextPadProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,gDAAgD,CAAC;AAC7E,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,OAAO,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,uCAAuC,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,8CAA8C,CAAC;AAC1E,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,IAAI,kBAAkB,EAC9B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAQ1D,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,mBAAmB,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,qBAAqB,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,kBAAkB,MAAM,uCAAuC,CAAC;AAuB5E,sDAAsD;AACtD,MAAM,CAAC,OAAO,OAAO,yBAA0B,YAAW,kBAAkB;IAgBxE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAvB9B,MAAM,CAAC,OAAO,WAWZ;gBAGA,UAAU,EAAE,UAAU,EACL,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,mBAAmB,EACjC,cAAc,EAAE,qBAAqB,EACrC,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,kBAAkB;IAKlD,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;CA+J1D"}
+{"version":3,"file":"WardleyContextPadProvider.d.ts","sourceRoot":"","sources":["../../src/context-pad/WardleyContextPadProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,UAAU,MAAM,gDAAgD,CAAC;AAC7E,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,OAAO,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,uCAAuC,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,8CAA8C,CAAC;AAC1E,OAAO,KAAK,EACV,iBAAiB,EACjB,OAAO,IAAI,kBAAkB,EAC9B,MAAM,wDAAwD,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAOrC,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,mBAAmB,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,qBAAqB,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,kBAAkB,MAAM,uCAAuC,CAAC;AA4C5E,sDAAsD;AACtD,MAAM,CAAC,OAAO,OAAO,yBAA0B,YAAW,kBAAkB;IAqBxE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAhC3B,MAAM,CAAC,OAAO,WAcZ;IAEF,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAGpC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,mBAAmB,EACjC,cAAc,EAAE,qBAAqB,EACrC,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,kBAAkB,EAChD,QAAQ,EAAE,QAAQ,EACD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ;IAUrC,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;IAiBzD,8FAA8F;IAC9F,OAAO,CAAC,iBAAiB;IAmBzB,kDAAkD;IAClD,OAAO,CAAC,iBAAiB;IA4EzB,iDAAiD;IACjD,OAAO,CAAC,kBAAkB;IA0E1B,wEAAwE;IACxE,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAuBpB"}

package/dist/context-pad/index.d.ts

@@ -2,4 +2,5 @@ import { ModuleDeclaration } from 'didi';
 /** Context actions per element. */
 export declare const wardleyContextPadModule: ModuleDeclaration;
 export { default as WardleyContextPadProvider } from './WardleyContextPadProvider.js';
+export { default as WardleyContextPad } from './WardleyContextPad.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/context-pad/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-pad/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,EAAE,iBAGrC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-pad/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,mCAAmC;AACnC,eAAO,MAAM,uBAAuB,EAAE,iBAMrC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/draw/WardleyRenderer.d.ts

@@ -3,6 +3,14 @@ import { default as EventBus } from 'diagram-js/lib/core/EventBus';
 import { ElementLike, ShapeLike, ConnectionLike } from 'diagram-js/lib/model/Types';
 import { default as ElementRegistry } from 'diagram-js/lib/core/ElementRegistry';
 import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
+/** Primary name text of a node (contract shared with other modules and consumers' CSS). */
+export declare const NAME_LABEL_CLASS = "wardley-name-label";
+/** Groups every evolve visual so tools (e.g. the context pad) can tell the node from its movement. */
+export declare const MOVEMENT_CLASS = "wardley-movement";
+/** Labels the user may drag to set an OWM `label [dx, dy]` offset (see the label-drag module). */
+export declare const LABEL_HANDLE_CLASS = "wardley-label-handle";
+/** Which offset a dragged label writes: the node's own `labelOffset` or its evolve's. */
+export declare const LABEL_ROLE_ATTRIBUTE = "data-label-role";
 export default class WardleyRenderer extends BaseRenderer {
     private readonly grid;
     private readonly elementRegistry;

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;AAkBvE,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AAQpE,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;IA8BrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IAoDpB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,YAAY;IAiDpB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,YAAY;IAmCpB,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,UAAU;CAsCnB"}
+{"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;AA2BvE,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;IA+BrB,kFAAkF;IAClF,OAAO,CAAC,YAAY;IAsEpB,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,cAAc;IA4BtB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,UAAU;CAuCnB"}

package/dist/draw/icons.d.ts

@@ -15,8 +15,6 @@ export declare const ICON_DOUBLE_ARROW = "M15.5 5H11l5 7-5 7h4.5l5-7zM8.5 5H4l5
 export declare const ICON_BLOCK = "M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.42 0-8-3.58-8-8 0-1.85.63-3.55 1.69-4.9L16.9 18.31C15.55 19.37 13.85 20 12 20zm6.31-3.1L7.1 5.69C8.45 4.63 10.15 4 12 4c4.42 0 8 3.58 8 8 0 1.85-.63 3.55-1.69 4.9z";
 export declare const ICON_EDIT = "M3 17.25V21h3.75L17.81 9.94l-3.75-3.75L3 17.25zM20.71 7.04c.39-.39.39-1.02 0-1.41l-2.34-2.34c-.39-.39-1.02-.39-1.41 0l-1.83 1.83 3.75 3.75 1.83-1.83z";
 export declare const ICON_DELETE = "M6 19c0 1.1.9 2 2 2h8c1.1 0 2-.9 2-2V7H6v12zM19 4h-3.5l-1-1h-5l-1 1H5v2h14V4z";
-/** close — remove evolve. */
-export declare const ICON_CLOSE = "M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z";
 /** description — note. */
 export declare const ICON_NOTE = "M14 2H6c-1.1 0-1.99.9-1.99 2L4 20c0 1.1.89 2 1.99 2H18c1.1 0 2-.9 2-2V8l-6-6zm2 16H8v-2h8v2zm0-4H8v-2h8v2zm-3-5V3.5L18.5 9H13z";
 export declare const ICON_UNDO = "M12.5 8c-2.65 0-5.05.99-6.9 2.6L2 7v9h9l-3.62-3.62c1.39-1.16 3.16-1.88 5.12-1.88 3.54 0 6.55 2.31 7.6 5.5l2.37-.78C21.08 11.03 17.15 8 12.5 8z";
@@ -59,6 +57,10 @@ export declare const ICON_LAYERS = "M11.99 18.54l-7.37-5.73L3 14.07l9 7 9-7-1.63
 export declare const ICON_AUTORENEW = "M12 6v3l4-4-4-4v3c-4.42 0-8 3.58-8 8 0 1.57.46 3.03 1.24 4.26L6.7 14.8c-.45-.83-.7-1.79-.7-2.8 0-3.31 2.69-6 6-6zm6.76 1.74L17.3 9.2c.44.84.7 1.79.7 2.8 0 3.31-2.69 6-6 6v-3l-4 4 4 4v-3c4.42 0 8-3.58 8-8 0-1.57-.46-3.03-1.24-4.26z";
 /** aspect_ratio — map size. */
 export declare const ICON_ASPECT_RATIO = "M19 12h-2v3h-3v2h5v-5zM7 9h3V7H5v5h2V9zm14-6H3c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h18c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm0 16.01H3V4.99h18v14.02z";
+/** open_in_new — open the element's link in a new tab. */
+export declare const ICON_OPEN_IN_NEW = "M19 19H5V5h7V3H5c-1.11 0-2 .9-2 2v14c0 1.1.89 2 2 2h14c1.1 0 2-.9 2-2v-7h-2v7zM14 3v2h3.59l-9.83 9.83 1.41 1.41L19 6.41V10h2V3h-7z";
+/** link — set the element's link (url). */
+export declare const ICON_LINK = "M3.9 12c0-1.71 1.39-3.1 3.1-3.1h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-1.9H7c-1.71 0-3.1-1.39-3.1-3.1zM8 13h8v-2H8v2zm9-6h-4v1.9h4c1.71 0 3.1 1.39 3.1 3.1s-1.39 3.1-3.1 3.1h-4V17h4c2.76 0 5-2.24 5-5s-2.24-5-5-5z";
 /** menu — hamburger (main menu). */
 export declare const ICON_MENU = "M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z";
 /** add — append component. */
@@ -67,6 +69,11 @@ export declare const ICON_ADD = "M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z";
 export declare const ICON_VISIBILITY = "M12 4.5C7 4.5 2.73 7.61 1 12c1.73 4.39 6 7.5 11 7.5s9.27-3.11 11-7.5c-1.73-4.39-6-7.5-11-7.5zM12 17c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z";
 /** Draws a 24x24 icon as an SVG group centered on (cx, cy), scaled to `size`. */
 export declare function drawIcon(path: string, cx: number, cy: number, size: number, fill: string): SVGElement;
+/**
+ * Like `iconMarkup`, but crossed out by a diagonal stroke (e.g. "remove evolve" = struck double
+ * arrow). The mask cuts a gap around the stroke so it stays legible over the filled glyph.
+ */
+export declare function struckIconMarkup(path: string, size?: number): string;
 /** Returns an icon as an HTML SVG string (for palette/context pad/buttons), color = currentColor. */
 export declare function iconMarkup(path: string, size?: number): string;
 //# sourceMappingURL=icons.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/draw/icons.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,kHACyF,CAAC;AAClH,eAAO,MAAM,UAAU,sSAC8Q,CAAC;AAEtS,yDAAyD;AACzD,eAAO,MAAM,WAAW,iIACwG,CAAC;AACjI,eAAO,MAAM,kBAAkB,8DAA8D,CAAC;AAC9F,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,yDAAyD,CAAC;AACxF,8CAA8C;AAC9C,eAAO,MAAM,UAAU,mPAC2N,CAAC;AACnP,eAAO,MAAM,SAAS,0JACmI,CAAC;AAC1J,eAAO,MAAM,WAAW,kFACyD,CAAC;AAClF,6BAA6B;AAC7B,eAAO,MAAM,UAAU,0GACkF,CAAC;AAC1G,0BAA0B;AAC1B,eAAO,MAAM,SAAS,mIAC4G,CAAC;AACnI,eAAO,MAAM,SAAS,mJAC4H,CAAC;AACnJ,eAAO,MAAM,SAAS,oJAC6H,CAAC;AACpJ,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,+YACiX,CAAC;AAC/Y,kBAAkB;AAClB,eAAO,MAAM,SAAS,+FACwE,CAAC;AAC/F,yBAAyB;AACzB,eAAO,MAAM,aAAa,8CAA8C,CAAC;AACzE,0BAA0B;AAC1B,eAAO,MAAM,UAAU,oWAC4U,CAAC;AACpW,qCAAqC;AACrC,eAAO,MAAM,eAAe,spBACynB,CAAC;AACtpB,oCAAoC;AACpC,eAAO,MAAM,WAAW,iTACwR,CAAC;AACjT,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,gHACkF,CAAC;AAChH,yBAAyB;AACzB,eAAO,MAAM,UAAU,6HACqG,CAAC;AAC7H,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,yIACmH,CAAC;AACzI,kDAAkD;AAClD,eAAO,MAAM,aAAa,gsBACqqB,CAAC;AAChsB,4BAA4B;AAC5B,eAAO,MAAM,YAAY,ycAC+a,CAAC;AACzc,mCAAmC;AACnC,eAAO,MAAM,UAAU,+JACuI,CAAC;AAC/J,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAC3E,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,gDAAgD,CAAC;AAC9E,iEAAiE;AACjE,eAAO,MAAM,eAAe,4EAC+C,CAAC;AAC5E,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,iGACgE,CAAC;AACjG,oCAAoC;AACpC,eAAO,MAAM,WAAW,gHACuF,CAAC;AAChH,kEAAkE;AAClE,eAAO,MAAM,cAAc,2OAC+M,CAAC;AAC3O,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,iJACkH,CAAC;AACjJ,oCAAoC;AACpC,eAAO,MAAM,SAAS,kDAAkD,CAAC;AACzE,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,wCAAwC,CAAC;AAC9D,uCAAuC;AACvC,eAAO,MAAM,eAAe,sNACyL,CAAC;AAEtN,iFAAiF;AACjF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,UAAU,CAUZ;AAED,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAE1D"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/draw/icons.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,kHACyF,CAAC;AAClH,eAAO,MAAM,UAAU,sSAC8Q,CAAC;AAEtS,yDAAyD;AACzD,eAAO,MAAM,WAAW,iIACwG,CAAC;AACjI,eAAO,MAAM,kBAAkB,8DAA8D,CAAC;AAC9F,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,yDAAyD,CAAC;AACxF,8CAA8C;AAC9C,eAAO,MAAM,UAAU,mPAC2N,CAAC;AACnP,eAAO,MAAM,SAAS,0JACmI,CAAC;AAC1J,eAAO,MAAM,WAAW,kFACyD,CAAC;AAClF,0BAA0B;AAC1B,eAAO,MAAM,SAAS,mIAC4G,CAAC;AACnI,eAAO,MAAM,SAAS,mJAC4H,CAAC;AACnJ,eAAO,MAAM,SAAS,oJAC6H,CAAC;AACpJ,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,+YACiX,CAAC;AAC/Y,kBAAkB;AAClB,eAAO,MAAM,SAAS,+FACwE,CAAC;AAC/F,yBAAyB;AACzB,eAAO,MAAM,aAAa,8CAA8C,CAAC;AACzE,0BAA0B;AAC1B,eAAO,MAAM,UAAU,oWAC4U,CAAC;AACpW,qCAAqC;AACrC,eAAO,MAAM,eAAe,spBACynB,CAAC;AACtpB,oCAAoC;AACpC,eAAO,MAAM,WAAW,iTACwR,CAAC;AACjT,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,gHACkF,CAAC;AAChH,yBAAyB;AACzB,eAAO,MAAM,UAAU,6HACqG,CAAC;AAC7H,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,yIACmH,CAAC;AACzI,kDAAkD;AAClD,eAAO,MAAM,aAAa,gsBACqqB,CAAC;AAChsB,4BAA4B;AAC5B,eAAO,MAAM,YAAY,ycAC+a,CAAC;AACzc,mCAAmC;AACnC,eAAO,MAAM,UAAU,+JACuI,CAAC;AAC/J,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,4CAA4C,CAAC;AAC3E,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,gDAAgD,CAAC;AAC9E,iEAAiE;AACjE,eAAO,MAAM,eAAe,4EAC+C,CAAC;AAC5E,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,iGACgE,CAAC;AACjG,oCAAoC;AACpC,eAAO,MAAM,WAAW,gHACuF,CAAC;AAChH,kEAAkE;AAClE,eAAO,MAAM,cAAc,2OAC+M,CAAC;AAC3O,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,iJACkH,CAAC;AACjJ,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,uIACyG,CAAC;AACvI,2CAA2C;AAC3C,eAAO,MAAM,SAAS,wNACiM,CAAC;AACxN,oCAAoC;AACpC,eAAO,MAAM,SAAS,kDAAkD,CAAC;AACzE,8BAA8B;AAC9B,eAAO,MAAM,QAAQ,wCAAwC,CAAC;AAC9D,uCAAuC;AACvC,eAAO,MAAM,eAAe,sNACyL,CAAC;AAEtN,iFAAiF;AACjF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,UAAU,CAUZ;AAeD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAUhE;AAED,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAE1D"}

package/dist/draw/index.d.ts

@@ -1,5 +1,6 @@
 import { ModuleDeclaration } from 'didi';
 /** SVG rendering of all Wardley types (BaseRenderer subclass, priority 1500). */
 export declare const wardleyDrawModule: ModuleDeclaration;
-export { default as WardleyRenderer } from './WardleyRenderer.js';
+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';
 //# 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,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,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,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,59 @@
+import { LabelOffset } from '@miragon/wardley-schema-model';
+import { WardleyShape } from '../model/di-types.js';
+import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
+/**
+ * Where the renderer puts component, anchor and evolve-target labels. Shared by the renderer and the
+ * label-drag interaction so a dragged label lands exactly where the stored offset renders it.
+ *
+ * All positions are relative to the owning node's centre. An explicit OWM `label [dx, dy]` offset is
+ * always relative to the canonical OWM slot (right of the circle, or centred above an anchor) — the
+ * automatic placements below only apply while no offset is set, so imported OWM maps keep their look.
+ */
+export declare const LABEL_GAP = 7;
+/** Rough average advance of a 13px/500 label glyph; the renderer never measures text (jsdom). */
+export declare const LABEL_CHAR_WIDTH = 7.5;
+/** Keeps the default label clear of the inertia bar (drawn right next to the circle). */
+export declare const INERTIA_LABEL_SHIFT = 6;
+export declare const LABEL_BASELINE_SHIFT = -4;
+/** Second line (sourcing method) below a name label. */
+export declare const LABEL_METHOD_LINE_SHIFT = 15;
+export declare const LABEL_OFFSET_LIMIT = 200;
+export type TextAnchor = 'start' | 'middle' | 'end';
+export interface LabelPlacement {
+    x: number;
+    y: number;
+    anchor: TextAnchor;
+}
+/** px from a component to its evolve target along the evolution axis (undefined without evolve). */
+export declare function movementDeltaX(shape: WardleyShape, grid: Pick<EvolutionGrid, 'toCanvas'>): number | undefined;
+export declare function estimatedLabelWidth(text: string): number;
+/** The canonical OWM slot of a component name — the origin of its `label [dx, dy]`. */
+export declare function componentLabelSlot(): {
+    x: number;
+    y: number;
+};
+/**
+ * A short rightward evolve would run the arrow, the target circle and the red target name into the
+ * source name, so the source name moves to the left of its circle.
+ */
+export declare function isShortRightwardMovement(shape: WardleyShape, movementDeltaX: number): boolean;
+/**
+ * @param movementDeltaX px from the component to its evolve target (undefined without an evolve).
+ */
+export declare function componentLabelPlacement(shape: WardleyShape, movementDeltaX: number | undefined): LabelPlacement;
+/** The canonical OWM slot of the evolve target name — the origin of the evolve's `label [dx, dy]`. */
+export declare function movementLabelSlot(movementDeltaX: number): {
+    x: number;
+    y: number;
+};
+/** A leftward evolve puts the target name on the far side, away from the arrow. */
+export declare function movementLabelPlacement(labelOffset: LabelOffset | undefined, movementDeltaX: number): LabelPlacement;
+/** The canonical slot of an anchor name: centred above the person icon. */
+export declare function anchorLabelSlot(): {
+    x: number;
+    y: number;
+};
+export declare function anchorLabelPlacement(shape: WardleyShape): LabelPlacement;
+/** Integer px, clamped to ±LABEL_OFFSET_LIMIT; `undefined` when the label is back in its slot. */
+export declare function normalizeLabelOffset(dx: number, dy: number): LabelOffset | undefined;
+//# sourceMappingURL=label-layout.d.ts.map

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

@@ -0,0 +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,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,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"}

package/dist/draw/palette-icons.d.ts

@@ -1,3 +1,4 @@
 export declare const PALETTE_ICONS: Record<string, string>;
+/** Region glyph; the initial letter tells the three kinds apart without relying on colour. */
 export declare function attitudeIcon(kind: string): string;
 //# sourceMappingURL=palette-icons.d.ts.map

package/dist/draw/palette-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette-icons.d.ts","sourceRoot":"","sources":["../../src/draw/palette-icons.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+ChD,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD"}
+{"version":3,"file":"palette-icons.d.ts","sourceRoot":"","sources":["../../src/draw/palette-icons.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoDhD,CAAC;AAQF,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD"}