@miragon/wardley-renderer 0.6.3 → 0.8.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,88 @@ 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, { transient })` / `resetMapSize({ transient })` | Changes the plot size (rounded and clamped to 480–5000 × 320–5000). In the `Modeler` one undo step, no re-import; `transient` previews without one. |
+| `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`.
+
+An import validates the whole map first: a map that is not importable rejects before the canvas
+changes, and a rendering failure puts the previous map back.
+
+Options: `new Modeler({ container, keyboard: { undoRedo: false } })` leaves Cmd/Ctrl+Z/Y to the
+host (VS Code owns its document's undo stack). `freeRectInsets: () => ({ top, right, bottom, left })`
+names the canvas edges a host's chrome covers, so fitting, panning and keyboard creation keep to
+the free rectangle. `additionalModules` adds diagram-js modules; every Wardley feature module is
+exported for custom editors.
+
+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`.
+
+## Collaborative hosts
+
+`createCollaborativeModeler()` and `createCollaborativeViewer()` implement the
+[`@miragon/modeler-api`](https://www.npmjs.com/package/@miragon/modeler-api) collaborative-modeler
+contract (notation `wardley`), for hosts that keep the map text in a shared document:
+
+```ts
+import { createCollaborativeModeler } from '@miragon/wardley-renderer';
+import '@miragon/wardley-renderer/assets/wardley.css';
+
+const modeler = createCollaborativeModeler();
+modeler.attachTo(document.querySelector('#canvas')!);
+await modeler.importText(documentText);
+modeler.onContentChanged(() => save(modeler.exportText()));
+```
+
+An import is silent (no content change is reported back) and keeps the selection, the viewbox and
+an open label editor. `elements` names components, anchors, pipelines, submaps and accelerators by
+the id the document gives them (`cmp_kettle`), also right after a canvas edit; `getViewState` and
+`setViewState` carry the viewbox. `diagram` is the wrapped `Modeler` or `NavigatedViewer` for
+host-specific wiring. The modeler takes `additionalModules`, `keyboard` and `freeRectInsets` as
+above; the viewer never edits. Both pass the contract's conformance kit without skips.
+
+### 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
+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.
+`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.
+
+## 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,8 +126,56 @@ 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
 
 MIT
+
+The tool icons of the palette (`square-dashed-mouse-pointer`, and for Draw `spline` with a
+straight segment) and the Close icon of the dialogs (`x`) are copied from
+[Lucide](https://lucide.dev) (`lucide-static` 1.59.0):
+
+> ISC License
+>
+> Copyright (c) 2026 Lucide Icons and Contributors
+>
+> Permission to use, copy, modify, and/or distribute this software for any purpose with or without
+> fee is hereby granted, provided that the above copyright notice and this permission notice
+> appear in all copies.
+>
+> THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
+> SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
+> AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+> WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+> NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+> PERFORMANCE OF THIS SOFTWARE.
+
+`x` is derived from [Feather](https://feathericons.com):
+
+> The MIT License (MIT)
+>
+> Copyright (c) 2013-present Cole Bemis
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+> associated documentation files (the "Software"), to deal in the Software without restriction,
+> including without limitation the rights to use, copy, modify, merge, publish, distribute,
+> sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all copies or
+> substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+> BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+> NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+> DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The other icons (the context pad, and the `ICON_*` exports with `iconMarkup`, which are deprecated
+since the chrome's icons come from `@miragon/modeler-shell` and go in a later minor) are
+[Material Icons](https://fonts.google.com/icons) by Google, under the Apache License 2.0.

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;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"}

package/dist/NavigatedViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigatedViewer.d.ts","sourceRoot":"","sources":["../src/NavigatedViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,MAAM;cACtB,WAAW,IAAI,iBAAiB,EAAE;CAUtD"}
+{"version":3,"file":"NavigatedViewer.d.ts","sourceRoot":"","sources":["../src/NavigatedViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,MAAM;cACtB,WAAW,IAAI,iBAAiB,EAAE;CAWtD"}

package/dist/WardleyBaseViewer.d.ts

@@ -1,6 +1,7 @@
 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';
+import { FreeRectInsets } from './free-rect/index.js';
 export interface WardleyViewerOptions {
     /** Host element. If missing, a detached <div> is created (can be attached later via attachTo). */
     container?: HTMLElement;
@@ -8,8 +9,43 @@ 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;
+    };
+    /**
+     * What the host's chrome covers along the container's edges, in px, read whenever it is needed
+     * (e.g. `() => shell.fitInsets()` of the Miragon modeler shell). Keyboard creation then places
+     * elements in the centre of the free rectangle, and panning keeps the map reachable around it.
+     * Without it the whole container counts.
+     */
+    freeRectInsets?: () => FreeRectInsets;
 }
 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;
+}
+export interface SetMapSizeOptions {
+    /** Live preview: drawn at once, 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,18 +57,24 @@ 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;
+    /** The map before the first transient size preview, put back before the size is committed. */
+    private _sizePreview;
     constructor(options?: WardleyViewerOptions);
     private _createContainer;
     private _ensureDiagram;
     get<T>(name: string): T;
     on<T = unknown>(event: string, callback: EventCallback<T>, priority?: number): void;
     off(event: string, callback: EventCallback): void;
-    /** Load a model into the canvas (replaces existing content). */
+    /**
+     * Load a model into the canvas (replaces existing content). Rejects a map the canvas cannot
+     * hold (invalid, or ids the canvas reserves for itself) before anything changes, so the current
+     * map, its rendering and its undo history stay as they were.
+     */
     importMap(map: WardleyMap): Promise<{
         warnings: ImportWarning[];
     }>;
-    /** DSL `style` directive as a CSS class on the container (`wardley-dark` etc., concept §8.1). */
-    private _applyStyleClass;
     /** Load OWM DSL text (internally parse -> importMap). Parser findings land in the warnings. */
     importDSL(text: string): Promise<{
         warnings: ImportWarning[];
@@ -40,21 +82,57 @@ 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. In the Modeler `{ transient: true }` shows
+     * a live preview without an undo step, and the next call without it commits ONE step from the
+     * size before the preview (none when the size ends where the preview started), like
+     * `setEvolutionLabels`.
      */
-    setMapSize(width: number, height: number): Promise<{
+    setMapSize(width: number, height: number, options?: SetMapSizeOptions): Promise<{
+        warnings: ImportWarning[];
+    }>;
+    /** Removes the `size` line: the map is drawn at the default plot size again. */
+    resetMapSize(options?: SetMapSizeOptions): Promise<{
         warnings: ImportWarning[];
     }>;
+    private _resizeMap;
+    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(labels: readonly [string, string, string, string] | undefined): void;
+    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.
+     */
+    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/collaborative/CollaborativeWardley.d.ts

@@ -0,0 +1,27 @@
+import { CollaborativeModeler, ElementsSurface } from '@miragon/modeler-api';
+import { ModuleDeclaration } from 'didi';
+import { Modeler } from '../Modeler.js';
+import { NavigatedViewer } from '../NavigatedViewer.js';
+import { FreeRectInsets } from '../free-rect/index.js';
+/** Stable notation id in `meta.notation` of the collaborative-modeler contract. */
+export declare const WARDLEY_NOTATION = "wardley";
+export interface CollaborativeWardleyOptions {
+    /** Appended to the renderer's own modules (e.g. a host's chrome module). */
+    additionalModules?: ModuleDeclaration[] | undefined;
+    /** See `WardleyViewerOptions.keyboard` (default: the canvas handles undo and redo). */
+    keyboard?: {
+        undoRedo?: boolean;
+    } | undefined;
+    /** See `WardleyViewerOptions.freeRectInsets`. */
+    freeRectInsets?: (() => FreeRectInsets) | undefined;
+}
+/** The contract surface plus the wrapped diagram for host-specific wiring. */
+export interface CollaborativeWardleyModeler extends CollaborativeModeler {
+    readonly elements: ElementsSurface;
+    readonly diagram: Modeler | NavigatedViewer;
+}
+/** The editing mount (`meta.editable: true`) of the collaborative-modeler contract. */
+export declare function createCollaborativeModeler(options?: CollaborativeWardleyOptions): CollaborativeWardleyModeler;
+/** The read-only mount (`meta.editable: false`): imports, exports and reveals, never edits. */
+export declare function createCollaborativeViewer(options?: Pick<CollaborativeWardleyOptions, 'additionalModules'>): CollaborativeWardleyModeler;
+//# sourceMappingURL=CollaborativeWardley.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollaborativeWardley.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeWardley.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,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;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD,uFAAuF;IACvF,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAC9C,iDAAiD;IACjD,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,8EAA8E;AAC9E,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AA2BD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAS7B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,IAAI,CAAC,2BAA2B,EAAE,mBAAmB,CAAM,GACnE,2BAA2B,CAE7B"}

package/dist/collaborative/index.d.ts

@@ -0,0 +1,2 @@
+export { WARDLEY_NOTATION, createCollaborativeModeler, createCollaborativeViewer, type CollaborativeWardleyModeler, type CollaborativeWardleyOptions, } from './CollaborativeWardley.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collaborative/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,2BAA2B,CAAC"}

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

@@ -1,4 +1,5 @@
 import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+import { Injector } from 'didi';
 import { default as EventBus } from 'diagram-js/lib/core/EventBus';
 import { default as WardleyModeling } from '../modeling/WardleyModeling.js';
 import { WardleyShape } from '../model/di-types.js';
@@ -6,18 +7,24 @@ 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;
     private readonly modeling;
+    private readonly injector;
     static $inject: string[];
     private popover;
     private readonly onDocPointer;
     private readonly onKey;
-    constructor(canvas: Canvas, eventBus: EventBus, modeling: WardleyModeling);
+    constructor(canvas: Canvas, eventBus: EventBus, modeling: WardleyModeling, injector: Injector);
     /** 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,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;IAiBnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,MAAM,CAAC,OAAO,WAAyD;IAEvE,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,EACzB,QAAQ,EAAE,QAAQ;IAMrC,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA6DjE,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;AA6C5E,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;IAkBzD,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"}