@miragon/wardley-renderer 0.6.3 → 0.8.0

package/dist/io/WardleyExporter.d.ts

@@ -2,6 +2,7 @@ import { default as Canvas } from 'diagram-js/lib/core/Canvas';
 import { default as ElementRegistry } from 'diagram-js/lib/core/ElementRegistry';
 import { WardleyMap } from '@miragon/wardley-schema-model';
 import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
+import { default as WardleySourceOrder } from './WardleySourceOrder.js';
 /**
  * Reconstructs a WardleyMap from the diagram-js runtime model. The source of truth for positions are
  * the DI properties `evolution`/`visibility`; editable fields (label, decorators, movement,
@@ -12,8 +13,9 @@ export default class WardleyExporter {
     private readonly elementRegistry;
     private readonly canvas;
     private readonly grid;
+    private readonly sourceOrder;
     static $inject: string[];
-    constructor(elementRegistry: ElementRegistry, canvas: Canvas, grid: EvolutionGrid);
+    constructor(elementRegistry: ElementRegistry, canvas: Canvas, grid: EvolutionGrid, sourceOrder: WardleySourceOrder);
     export(): WardleyMap;
     /** Builds a MapElement from the DI properties (common types) or the businessObject (the rest). */
     private buildElement;

package/dist/io/WardleyExporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyExporter.d.ts","sourceRoot":"","sources":["../../src/io/WardleyExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAaL,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AASpE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAIhC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,MAAM,CAAC,OAAO,WAAkD;gBAG7C,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa;IAGtC,MAAM,IAAI,UAAU;IAyDpB,kGAAkG;IAClG,OAAO,CAAC,YAAY;CA2HrB"}
+{"version":3,"file":"WardleyExporter.d.ts","sourceRoot":"","sources":["../../src/io/WardleyExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAcL,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAS9D;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAIhC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B,MAAM,CAAC,OAAO,WAAwE;gBAGnE,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,kBAAkB;IAGlD,MAAM,IAAI,UAAU;IA2DpB,kGAAkG;IAClG,OAAO,CAAC,YAAY;CA2HrB"}

package/dist/io/WardleyImporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyImporter.d.ts","sourceRoot":"","sources":["../../src/io/WardleyImporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,cAAc,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAW,KAAK,aAAa,EAA2B,MAAM,YAAY,CAAC;AAiBlF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAWhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAflC,MAAM,CAAC,OAAO,WAOZ;gBAGiB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,eAAe;IAGnD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,EAAE;IAsFxC,OAAO,CAAC,WAAW;IA4BnB,KAAK,IAAI,IAAI;CAYd"}
+{"version":3,"file":"WardleyImporter.d.ts","sourceRoot":"","sources":["../../src/io/WardleyImporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,cAAc,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAuB,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAW,KAAK,aAAa,EAA2B,MAAM,YAAY,CAAC;AAiBlF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAWhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAflC,MAAM,CAAC,OAAO,WAOZ;gBAGiB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,eAAe;IAGnD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,EAAE;IAmGxC,OAAO,CAAC,WAAW;IAInB,KAAK,IAAI,IAAI;CAed"}

package/dist/io/WardleySourceOrder.d.ts

@@ -0,0 +1,23 @@
+import { default as EventBus } from 'diagram-js/lib/core/EventBus';
+import { WardleyMap } from '@miragon/wardley-schema-model';
+interface Identified {
+    readonly id: string;
+}
+/**
+ * Remembers the order in which elements and edges appeared in the imported map, so the export can
+ * write them back in that order. The registry/DOM order cannot serve: it is the z-order (frames,
+ * connections, nodes), and exporting in it reshuffles every hand-written file on the first edit.
+ */
+export default class WardleySourceOrder {
+    static $inject: string[];
+    private elementIndex;
+    private edgeIndex;
+    constructor(eventBus: EventBus);
+    remember(map: Pick<WardleyMap, 'elements' | 'edges'>): void;
+    /** Imported elements in source order, followed by the rest in their given (creation) order. */
+    sortElements<T extends Identified>(elements: readonly T[]): T[];
+    /** Imported edges in source order, followed by the rest in their given (creation) order. */
+    sortEdges<T extends Identified>(edges: readonly T[]): T[];
+}
+export {};
+//# sourceMappingURL=WardleySourceOrder.d.ts.map

package/dist/io/WardleySourceOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WardleySourceOrder.d.ts","sourceRoot":"","sources":["../../src/io/WardleySourceOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC,MAAM,CAAC,OAAO,WAAgB;IAE9B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,SAAS,CAA6B;gBAElC,QAAQ,EAAE,QAAQ;IAK9B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,IAAI;IAK3D,+FAA+F;IAC/F,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;IAI/D,4FAA4F;IAC5F,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE;CAG1D"}

package/dist/io/exportBounds.d.ts

@@ -0,0 +1,15 @@
+import { default as Canvas } from 'diagram-js/lib/core/Canvas';
+import { SvgBounds } from './saveSvg.js';
+/** Covers what getBBox ignores, chiefly the label halo stroke. */
+export declare const EXPORT_CONTENT_PADDING = 12;
+interface OuterBoundsSource {
+    outerBounds(): SvgBounds;
+}
+/**
+ * The area an image export must cover: the plot frame plus everything drawn on the element layer
+ * and the axes. Labels of commodity components (evolution near 1) and notes run past the plot's
+ * right edge, so exporting only the plot frame crops them.
+ */
+export declare function exportBounds(canvas: Canvas, grid: OuterBoundsSource, padding?: number): SvgBounds;
+export {};
+//# sourceMappingURL=exportBounds.d.ts.map

package/dist/io/exportBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportBounds.d.ts","sourceRoot":"","sources":["../../src/io/exportBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQ9C,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,UAAU,iBAAiB;IACzB,WAAW,IAAI,SAAS,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,OAAO,SAAyB,GAC/B,SAAS,CA0BX"}

package/dist/io/index.d.ts

@@ -2,7 +2,12 @@ import { ModuleDeclaration } from 'didi';
 export declare const ioModule: ModuleDeclaration;
 export { default as WardleyImporter } from './WardleyImporter.js';
 export { default as WardleyExporter } from './WardleyExporter.js';
+export { default as WardleySourceOrder } from './WardleySourceOrder.js';
 export { saveSVG } from './saveSvg.js';
+export type { SvgBounds } from './saveSvg.js';
+export { exportBounds, EXPORT_CONTENT_PADDING } from './exportBounds.js';
+export { svgToPng, blobToBase64 } from './rasterize.js';
+export type { SvgToPngOptions } from './rasterize.js';
 export { ROOT_ID } from './types.js';
 export type { ImportWarning, RootBusinessObject } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,eAAO,MAAM,QAAQ,EAAE,iBAGtB,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,eAAO,MAAM,QAAQ,EAAE,iBAMtB,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/io/rasterize.d.ts

@@ -0,0 +1,25 @@
+export interface SvgToPngOptions {
+    /**
+     * Pixel density factor relative to the SVG's own size (default 2). Lowered automatically where
+     * the PNG would exceed the browser's canvas size limits.
+     */
+    readonly scale?: number;
+    /** Leave the background transparent instead of filling it with the paper colour (slides, docs). */
+    readonly transparent?: boolean;
+}
+/**
+ * Rasterizes a standalone SVG (e.g. from `saveSVG()`) into a PNG picture. Browser-only: needs
+ * `Image`, `<canvas>` and object URLs. The PNG carries no embedded map source.
+ */
+export declare function svgToPng(svg: string, options?: SvgToPngOptions): Promise<Blob>;
+/**
+ * Pixel size of the PNG: the SVG size times `scale`, reduced proportionally where it would exceed
+ * the browser's canvas limits, so a huge map still exports, just at a lower density.
+ */
+export declare function rasterSize(width: number, height: number, scale: number): {
+    width: number;
+    height: number;
+};
+/** Blob -> Base64 without the data-URL prefix, e.g. to post an export to a VS Code extension host. */
+export declare function blobToBase64(blob: Blob): Promise<string>;
+//# sourceMappingURL=rasterize.d.ts.map

package/dist/io/rasterize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterize.d.ts","sourceRoot":"","sources":["../../src/io/rasterize.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAYD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCxF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWnC;AAED,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxD"}

package/dist/io/saveSvg.d.ts

@@ -7,7 +7,7 @@ export interface SvgBounds {
 }
 /**
  * Serializes the current canvas into standalone SVG (snapshot/export).
- * `bounds` is the outer plot boundary (typically `EvolutionGrid.outerBounds()`), so that
+ * `bounds` is the outer plot boundary (typically `exportBounds(canvas, grid)`), so that
  * maps enlarged via `config.size` are exported completely; if omitted, the default plot
  * area is used. Independent of the current zoom/scroll.
  */

package/dist/io/saveSvg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveSvg.d.ts","sourceRoot":"","sources":["../../src/io/saveSvg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAGrD,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAyB3E"}
+{"version":3,"file":"saveSvg.d.ts","sourceRoot":"","sources":["../../src/io/saveSvg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAGrD,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CA0C3E"}

package/dist/io/types.d.ts

@@ -2,8 +2,13 @@ import { MapConfig } from '@miragon/wardley-schema-model';
 /** ID of the diagram-js root element of the Wardley map. */
 export declare const ROOT_ID = "wardley-root";
 export interface ImportWarning {
+    /** Human-readable, already including the line and source text for DSL findings. */
     readonly message: string;
     readonly elementId?: string;
+    /** 1-based line of the DSL finding, for listing or jumping to the offending line. */
+    readonly line?: number;
+    /** The offending DSL source line as written. */
+    readonly source?: string;
 }
 /** Map metadata stored on the root element (config + lossless passthrough). */
 export interface RootBusinessObject {

package/dist/io/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/io/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,4DAA4D;AAC5D,eAAO,MAAM,OAAO,iBAAiB,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/io/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,4DAA4D;AAC5D,eAAO,MAAM,OAAO,iBAAiB,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C"}

package/dist/keyboard/WardleyKeyboard.d.ts

@@ -1,20 +1,63 @@
 import { default as Canvas } from 'diagram-js/lib/core/Canvas';
 import { default as CommandStack } from 'diagram-js/lib/command/CommandStack';
+import { default as ElementRegistry } from 'diagram-js/lib/core/ElementRegistry';
 import { default as EventBus } from 'diagram-js/lib/core/EventBus';
 import { default as Create } from 'diagram-js/lib/features/create/Create';
 import { default as LassoTool } from 'diagram-js/lib/features/lasso-tool/LassoTool';
 import { default as Mouse } from 'diagram-js/lib/features/mouse/Mouse';
 import { default as Selection } from 'diagram-js/lib/features/selection/Selection';
 import { default as Modeling } from 'diagram-js/lib/features/modeling/Modeling';
+import { Injector } from 'didi';
 import { default as WardleyCopyPaste } from '../modeling/WardleyCopyPaste.js';
 import { default as WardleyElementFactory } from '../model/WardleyElementFactory.js';
+/** Diagram config `wardleyKeyboard` (Modeler option `keyboard`). */
+export interface WardleyKeyboardConfig {
+    /**
+     * Handle Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and Cmd/Ctrl+Y on the canvas (default true). Hosts that own
+     * undo themselves (VS Code custom editors) set this to false and receive the keys untouched.
+     */
+    undoRedo?: boolean;
+}
+/**
+ * Decides whether a keydown belongs to the host page rather than the canvas. Canvas shortcuts
+ * only run when focus is on the canvas, the palette, or nowhere in particular (body) — so a
+ * focused host button or select never deletes or nudges map elements. A focused plain button
+ * (zoom, share, menu) still lets undo/redo and the single-key tools through, unless the host's
+ * chrome owns every key aimed at it (`canvasTargetsOnly`, the Miragon modeler shell: its zoom
+ * panel's buttons do not stop the keys they leave alone).
+ */
+export declare function shouldIgnoreKeyEvent(event: KeyboardEvent, canvasContainer: HTMLElement, canvasTargetsOnly?: boolean): boolean;
 /**
- * Minimal keyboard binding on the canvas container: undo/redo, delete, copy/paste/duplicate,
- * arrow-key nudge of the selection, plus the single-key tools C (component), U (user) and
- * L (lasso). Deliberately a DOM listener (no diagram-js keyboard-service binding needed).
+ * Keyboard binding: undo/redo, delete, copy/paste/duplicate, arrow-key nudge, Escape (deselect),
+ * Cmd/Ctrl+A (select all), the single-key tools C (component), U (user), N (note), P (pipeline),
+ * L (lasso) and A (connect from the selected node). Deliberately a DOM listener (no diagram-js
+ * keyboard-service binding needed).
  */
 export default class WardleyKeyboard {
+    private readonly canvas;
+    private readonly selection;
+    private readonly modeling;
+    private readonly factory;
+    private readonly create;
+    private readonly mouse;
+    private readonly elementRegistry;
     static $inject: string[];
-    constructor(canvas: Canvas, commandStack: CommandStack, selection: Selection, modeling: Modeling, copyPaste: WardleyCopyPaste, factory: WardleyElementFactory, create: Create, mouse: Mouse, lassoTool: LassoTool, eventBus: EventBus);
+    private pointerOverCanvas;
+    private readonly labelEditing;
+    private readonly grid;
+    private readonly freeRect;
+    constructor(canvas: Canvas, commandStack: CommandStack, selection: Selection, modeling: Modeling, copyPaste: WardleyCopyPaste, factory: WardleyElementFactory, create: Create, mouse: Mouse, lassoTool: LassoTool, eventBus: EventBus, elementRegistry: ElementRegistry, injector: Injector, config: WardleyKeyboardConfig | undefined);
+    /**
+     * With the pointer over the canvas the new node attaches to it (like palette create; placing it
+     * opens the name editor). Without one — keyboard only — it lands in the centre of the free
+     * rectangle (within the plot) and the name editor opens right away.
+     */
+    private quickCreate;
+    private insetPlotBounds;
+    private visiblePlotCenter;
+    private freeSpotNear;
+    private singleSelectedShape;
+    /** The real pointer event, or a synthetic one at `canvasPoint` when the pointer is elsewhere. */
+    private pointerEventOr;
 }
 //# sourceMappingURL=WardleyKeyboard.d.ts.map

package/dist/keyboard/WardleyKeyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyKeyboard.d.ts","sourceRoot":"","sources":["../../src/keyboard/WardleyKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,uCAAuC,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,8CAA8C,CAAC;AAC1E,OAAO,KAAK,KAAK,MAAM,qCAAqC,CAAC;AAC7D,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AACzE,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAEtE,OAAO,KAAK,gBAAgB,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAa3E;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,MAAM,CAAC,OAAO,WAWZ;gBAGA,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ;CAiErB"}
+{"version":3,"file":"WardleyKeyboard.d.ts","sourceRoot":"","sources":["../../src/keyboard/WardleyKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,eAAe,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,MAAM,MAAM,uCAAuC,CAAC;AAEhE,OAAO,KAAK,SAAS,MAAM,8CAA8C,CAAC;AAC1E,OAAO,KAAK,KAAK,MAAM,qCAAqC,CAAC;AAG7D,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AACzE,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,gBAAgB,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAa3E,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,WAAW,EAC5B,iBAAiB,UAAQ,GACxB,OAAO,CAYT;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAuBhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAGtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAhClC,MAAM,CAAC,OAAO,WAcZ;IAEF,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAGxB,MAAM,EAAE,MAAM,EAC/B,YAAY,EAAE,YAAY,EACT,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EACnC,SAAS,EAAE,gBAAgB,EACV,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EAC7B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EACD,eAAe,EAAE,eAAe,EACjD,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,qBAAqB,GAAG,SAAS;IAwJ3C;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,mBAAmB;IAK3B,iGAAiG;IACjG,OAAO,CAAC,cAAc;CAUvB"}

package/dist/label-drag/WardleyLabelDragging.d.ts

@@ -0,0 +1,58 @@
+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 ElementRegistry } from 'diagram-js/lib/core/ElementRegistry';
+import { default as Selection } from 'diagram-js/lib/features/selection/Selection';
+import { default as EvolutionGrid } from '../evolution-grid/EvolutionGrid.js';
+import { default as WardleyModeling } from '../modeling/WardleyModeling.js';
+import { WardleyShape } from '../model/di-types.js';
+/** Which offset a label writes: the node's own `label [dx, dy]` or its evolve line's. */
+export type LabelRole = 'name' | 'movement';
+/**
+ * OWM-style draggable labels: drag a component/anchor name or an evolve target name to store an
+ * OWM `label [dx, dy]` offset (integers, clamped to ±200px) as ONE undoable command. A press without
+ * movement selects the owner; double-click still edits the name.
+ *
+ * Reset paths: Alt+double-click on a label, dropping it back onto its default slot, or
+ * `resetLabelOffset(shape, role)`.
+ */
+export default class WardleyLabelDragging {
+    private readonly eventBus;
+    private readonly canvas;
+    private readonly elementRegistry;
+    private readonly modeling;
+    private readonly selection;
+    private readonly grid;
+    private readonly injector;
+    static $inject: string[];
+    private active;
+    constructor(eventBus: EventBus, canvas: Canvas, elementRegistry: ElementRegistry, modeling: WardleyModeling, selection: Selection, grid: EvolutionGrid, injector: Injector);
+    /** Puts a label back into its default slot (undoable). */
+    resetLabelOffset(shape: WardleyShape, role?: LabelRole): void;
+    private readonly onMouseDown;
+    private readonly onMouseMove;
+    private readonly onMouseUp;
+    /** The click that ends a drag would toggle the owner's selection off again. */
+    private suppressNextClick;
+    private readonly onKeyDown;
+    private readonly onDoubleClick;
+    private cancel;
+    /** Ends the gesture and restores the pre-drag state (commits run through the command stack). */
+    private finish;
+    private preview;
+    private snapHome;
+    private commitNameOffset;
+    private commitMovementOffset;
+    /**
+     * The offset that reproduces the label exactly where it is drawn now, in the OWM frame (relative to
+     * the canonical slot). Automatic placements (left of the circle, inertia shift) are converted so
+     * the first drag doesn't make the label jump.
+     */
+    private renderedOffset;
+    /** The offset (OWM frame) of the label's automatic, offset-free position. */
+    private defaultOffset;
+    private labelTarget;
+    /** The `.wardley-container` the viewer mounts into (diagram-js renders into a child of it). */
+    private outerContainer;
+}
+//# sourceMappingURL=WardleyLabelDragging.d.ts.map

package/dist/label-drag/WardleyLabelDragging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WardleyLabelDragging.d.ts","sourceRoot":"","sources":["../../src/label-drag/WardleyLabelDragging.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,qCAAqC,CAAC;AACvE,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AAEzE,OAAO,KAAK,aAAa,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAczE,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAsB5C;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IAcrC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAnB3B,MAAM,CAAC,OAAO,WAQZ;IAEF,OAAO,CAAC,MAAM,CAA0B;gBAGrB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,QAAQ;IAmBrC,0DAA0D;IAC1D,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,GAAE,SAAkB,GAAG,IAAI;IAQrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CA6B1B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAe1B;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAgBxB;IAEF,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIxB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,OAAO,CAAC,MAAM;IAId,gGAAgG;IAChG,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,oBAAoB;IAS5B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAUtB,6EAA6E;IAC7E,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;IAiBnB,+FAA+F;IAC/F,OAAO,CAAC,cAAc;CAIvB"}

package/dist/label-drag/index.d.ts

@@ -0,0 +1,5 @@
+import { ModuleDeclaration } from 'didi';
+/** OWM-style draggable labels persisted as `label [dx, dy]` (undoable). */
+export declare const wardleyLabelDragModule: ModuleDeclaration;
+export { default as WardleyLabelDragging, type LabelRole } from './WardleyLabelDragging.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/label-drag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/label-drag/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,EAAE,iBAGpC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/label-editing/WardleyLabelEditing.d.ts

@@ -1,27 +1,84 @@
 import { default as Canvas } from 'diagram-js/lib/core/Canvas';
 import { default as EventBus } from 'diagram-js/lib/core/EventBus';
+import { Injector } from 'didi';
 import { WardleyConnection, WardleyShape } from '../model/di-types.js';
 import { default as WardleyModeling } from '../modeling/WardleyModeling.js';
 import { default as WardleyElementFactory } from '../model/WardleyElementFactory.js';
+/** Text selection (caret when start = end) inside an editor field. */
+export interface FieldSelection {
+    start: number;
+    end: number;
+}
+/** Snapshot of an open name editor (hosts use it to survive a re-import). */
+export interface ActiveLabelEdit {
+    elementId: string;
+    value: string;
+    /** Where the caret or text selection was. */
+    selection?: FieldSelection;
+    /** A link annotation or flow value editor instead of a name editor. */
+    connection?: boolean;
+}
+export interface ActivateOptions {
+    /** Initial field content instead of the element's current label (e.g. restoring an edit). */
+    value?: string;
+    /** Caret or selection to restore; without it the whole text is selected. */
+    selection?: FieldSelection;
+}
+/** Fired when a name was changed to a free variant because the requested one is taken. */
+export interface LabelDeduplicatedEvent {
+    element: WardleyShape;
+    requested: string;
+    applied: string;
+}
+export declare const NOTE_EDIT_HINT = "Cmd/Ctrl+Enter to save \u00B7 Esc to cancel";
+export declare function duplicateNameMessage(name: string): string;
 /**
  * Custom inline label editing as an HTML overlay (deliberately not diagram-js direct-editing, §8.5).
- * Commit goes through `wardleyModeling.updateLabel` -> commandStack (undo, P4).
- * Notes are edited in a `<textarea>` (multiline: Enter = line break, Cmd/Ctrl+Enter or click outside
- * = save); everything else in an `<input>` (Enter = save).
+ * The field sits exactly over the label it replaces (which is hidden meanwhile), scales with the
+ * zoom and grows with its content. Commit goes through `wardleyModeling.updateLabel` ->
+ * commandStack (undo, P4). Notes are edited in a `<textarea>` over the note itself (multiline:
+ * Enter = line break, Cmd/Ctrl+Enter or click outside = save); everything else in an `<input>`
+ * (Enter = save). Escape always discards.
  */
 export default class WardleyLabelEditing {
+    private readonly eventBus;
     private readonly canvas;
     private readonly modeling;
     private readonly factory;
     static $inject: string[];
     private active;
-    constructor(eventBus: EventBus, canvas: Canvas, modeling: WardleyModeling, factory: WardleyElementFactory);
-    activate(element: WardleyShape): void;
+    private readonly contextPad;
+    private readonly selection;
+    private readonly locked;
+    constructor(eventBus: EventBus, canvas: Canvas, modeling: WardleyModeling, factory: WardleyElementFactory, injector: Injector);
+    /** Opens the in-place name editor for `element` (no-op for regions and drawings). */
+    activate(element: WardleyShape, options?: ActivateOptions): void;
     /**
      * Inline editing for connections: a flow edits its value (`+'value'>`), a dependency its
      * `; annotation` text. An empty input clears the field. Undo-safe via updateProperties.
      */
-    activateConnection(conn: WardleyConnection): void;
+    activateConnection(conn: WardleyConnection, options?: ActivateOptions): void;
+    /** Discards the open edit (if any) without saving. */
     cancel(): void;
+    /**
+     * Saves the open edit (if any) as if focus had left the field, e.g. before the host saves or
+     * exports the map, so the file contains the text the user sees.
+     */
+    commitActiveEdit(): void;
+    /** The open editor's element and current (unsaved) text, or null when nothing is edited. */
+    getActiveEdit(): ActiveLabelEdit | null;
+    /**
+     * After Enter/Escape the removed field leaves focus on <body>; hand it back to the canvas so
+     * keyboard users keep their place, and bring back the context pad the editor had closed.
+     */
+    private returnToCanvas;
+    /**
+     * The <text> nodes showing the element's name. Falls back to matching by content when the
+     * renderer does not mark them; the LAST match skips a component's movement target label, which
+     * is drawn first and may repeat the name. Fallback matches carry the class only while editing so
+     * the CSS hides them.
+     */
+    private nameLabelElements;
+    private labelGeometry;
 }
 //# sourceMappingURL=WardleyLabelEditing.d.ts.map

package/dist/label-editing/WardleyLabelEditing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WardleyLabelEditing.d.ts","sourceRoot":"","sources":["../../src/label-editing/WardleyLabelEditing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAuB3E;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAOpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,MAAM,CAAC,OAAO,WAAsE;IAEpF,OAAO,CAAC,MAAM,CAA2B;gBAGvC,QAAQ,EAAE,QAAQ,EACD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,qBAAqB;IAYjD,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAuErC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAuEjD,MAAM,IAAI,IAAI;CAGf"}
+{"version":3,"file":"WardleyLabelEditing.d.ts","sourceRoot":"","sources":["../../src/label-editing/WardleyLabelEditing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,qBAAqB,MAAM,mCAAmC,CAAC;AAuB3E,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAeD,0FAA0F;AAC1F,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,eAAO,MAAM,cAAc,gDAA2C,CAAC;AAEvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAsCD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IASpC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,MAAM,CAAC,OAAO,WAAkF;IAEhG,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAGpB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,qBAAqB,EAC/C,QAAQ,EAAE,QAAQ;IAsBpB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAiIpE;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAuEhF,sDAAsD;IACtD,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAIxB,4FAA4F;IAC5F,aAAa,IAAI,eAAe,GAAG,IAAI;IAWvC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,aAAa;CAoDtB"}

package/dist/label-editing/fieldError.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A refused value in an inline editor: the field turns red and a caption under it says why. One look
+ * and one accessible pattern (role=alert, aria-describedby) for every editor, also for keyboard and
+ * touch users who never see a tooltip.
+ */
+export interface FieldError {
+    show(message: string): void;
+    clear(): void;
+    /** The caption while shown, for hosts that lay out further captions below it. */
+    readonly caption: HTMLElement | undefined;
+}
+export declare function createFieldError(container: HTMLElement, field: HTMLInputElement | HTMLTextAreaElement, id: string, place: (caption: HTMLElement) => void): FieldError;
+//# sourceMappingURL=fieldError.d.ts.map

package/dist/label-editing/fieldError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldError.d.ts","sourceRoot":"","sources":["../../src/label-editing/fieldError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,EAC7C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GACpC,UAAU,CA6BZ"}

package/dist/label-editing/index.d.ts

@@ -2,4 +2,5 @@ import { ModuleDeclaration } from 'didi';
 /** Custom inline label editing (HTML overlay). */
 export declare const labelEditingModule: ModuleDeclaration;
 export { default as WardleyLabelEditing } from './WardleyLabelEditing.js';
+export { createFieldError, type FieldError } from './fieldError.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/label-editing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/label-editing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,EAAE,iBAGhC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/label-editing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,EAAE,iBAGhC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/link-editing/WardleyLinkEditing.d.ts

@@ -0,0 +1,40 @@
+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 { WardleyShape } from '../model/di-types.js';
+import { default as WardleyModeling } from '../modeling/WardleyModeling.js';
+/** Element types that carry an OWM `url(...)` reference. */
+export declare function canHaveLink(shape: WardleyShape): boolean;
+/** The stored address: `url` on components, `urlRef` on submaps (both live on the businessObject). */
+export declare function linkOf(shape: WardleyShape): string | undefined;
+/**
+ * Inline editor for the link of a component or submap (OWM `url Name [address]` + `url(Name)`).
+ * Commits exactly one undoable `updateProperties`; addresses outside the allowlist (http, https,
+ * mailto, relative) are rejected and the field stays open marked invalid.
+ */
+export default class WardleyLinkEditing {
+    private readonly canvas;
+    private readonly modeling;
+    private readonly injector;
+    static $inject: string[];
+    private active;
+    constructor(eventBus: EventBus, canvas: Canvas, modeling: WardleyModeling, injector: Injector);
+    /**
+     * Sets (or with an empty value removes) the link. Returns false when the address is not allowed.
+     * The exporter reads the link from the businessObject, which palette-created shapes do not have
+     * yet — so a minimal one is built from the shape.
+     */
+    setLink(shape: WardleyShape, rawUrl: string | undefined): boolean;
+    /** @param options.value field content to restore instead of the current link (re-import). */
+    activate(shape: WardleyShape, options?: {
+        value?: string;
+    }): void;
+    cancel(): void;
+    /** Saves the open link edit (if any) as if focus had left the field; a rejected address is dropped. */
+    commitActiveEdit(): void;
+    getActiveEdit(): {
+        elementId: string;
+        value: string;
+    } | null;
+}
+//# sourceMappingURL=WardleyLinkEditing.d.ts.map

package/dist/link-editing/WardleyLinkEditing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WardleyLinkEditing.d.ts","sourceRoot":"","sources":["../../src/link-editing/WardleyLinkEditing.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;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAmBlE,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAExD;AAED,sGAAsG;AACtG,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAM9D;AAED;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAOnC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,MAAM,CAAC,OAAO,WAAyD;IAEvE,OAAO,CAAC,MAAM,CAA+B;gBAG3C,QAAQ,EAAE,QAAQ,EACD,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,QAAQ;IAQrC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IA0BjE,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAgFrE,MAAM,IAAI,IAAI;IAId,uGAAuG;IACvG,gBAAgB,IAAI,IAAI;IAIxB,aAAa,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAK7D"}

package/dist/link-editing/index.d.ts

@@ -0,0 +1,6 @@
+import { ModuleDeclaration } from 'didi';
+/** Inline link (url) editing for components and submaps. */
+export declare const linkEditingModule: ModuleDeclaration;
+export { default as WardleyLinkEditing, canHaveLink, linkOf } from './WardleyLinkEditing.js';
+export { sanitizeLinkUrl, isAllowedLinkUrl, safeLinkUrl } from './link-url.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/link-editing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/link-editing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,EAAE,iBAG/B,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/link-editing/link-url.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Normalises user or file input into an address the OWM DSL can carry losslessly:
+ * `url Name [address]` ends at `]`, and a line break would end the definition line.
+ */
+export declare function sanitizeLinkUrl(raw: string): string;
+/**
+ * Allowlist for addresses the modeler stores or opens: http(s), mailto, or a relative reference.
+ * Shared maps arrive through URLs and files, so a `javascript:` or `data:` address must never reach
+ * `window.open`.
+ */
+export declare function isAllowedLinkUrl(url: string): boolean;
+/** Sanitised address if it is non-empty and allowed, otherwise `undefined`. */
+export declare function safeLinkUrl(raw: string | undefined): string | undefined;
+//# sourceMappingURL=link-url.d.ts.map

package/dist/link-editing/link-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-url.d.ts","sourceRoot":"","sources":["../../src/link-editing/link-url.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIvE"}

package/dist/map-menu/AxisLabelsPopover.d.ts

@@ -0,0 +1,10 @@
+import { Modeler } from '../Modeler.js';
+import { PopoverChrome, PopoverHandle } from './popover.js';
+/**
+ * "X-axis labels…" (guide §5.4): a preset or four free stage names. Typing previews on the axis
+ * without touching the document; closing commits ONE edit, so the document gets one change and
+ * an IDE one undo step per session. An import while it is open closes it without committing, and
+ * so does a canvas that turns read-only, after putting the previous labels back.
+ */
+export declare function createAxisLabelsPopover(chrome: PopoverChrome, modeler: Modeler): PopoverHandle;
+//# sourceMappingURL=AxisLabelsPopover.d.ts.map

package/dist/map-menu/AxisLabelsPopover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxisLabelsPopover.d.ts","sourceRoot":"","sources":["../../src/map-menu/AxisLabelsPopover.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAWtB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAuF9F"}

package/dist/map-menu/MapSizePopover.d.ts

@@ -0,0 +1,10 @@
+import { Modeler } from '../Modeler.js';
+import { PopoverChrome, PopoverHandle } from './popover.js';
+/**
+ * "Map size…" (guide §5.4): presets, a custom width × height and a reset to the default size. Every
+ * choice is drawn at once as a preview without an undo step; closing writes ONE edit (none when the
+ * map ends at the size it had). An import while it is open closes it without writing, and so does
+ * a canvas that turns read-only, after putting the previous size back.
+ */
+export declare function createMapSizePopover(chrome: PopoverChrome, modeler: Modeler): PopoverHandle;
+//# sourceMappingURL=MapSizePopover.d.ts.map

package/dist/map-menu/MapSizePopover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapSizePopover.d.ts","sourceRoot":"","sources":["../../src/map-menu/MapSizePopover.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAiBtB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CA+F3F"}

package/dist/map-menu/ShortcutsDialog.d.ts

@@ -0,0 +1,14 @@
+import { DialogChrome, MapDialog } from './dialog.js';
+import { MapShortcutOptions, ShortcutsChrome } from './shortcuts.js';
+/** What the dialog needs of the chrome around the map; a `@miragon/modeler-shell` handle fits. */
+export interface ShortcutsDialogChrome extends ShortcutsChrome, DialogChrome {
+    readonly messages: ShortcutsChrome['messages'] & DialogChrome['messages'];
+}
+export type ShortcutsDialog = MapDialog;
+/**
+ * The "Keyboard shortcuts…" dialog of the Help group (guide §5.4, §8): one table per group, the
+ * keys as chips like the chrome tooltip's. A web app that binds keys of its own (Open…, the map
+ * file's export, `?`) passes them in `options`, so the dialog lists them as well.
+ */
+export declare function createShortcutsDialog(chrome: ShortcutsDialogChrome, options?: MapShortcutOptions): ShortcutsDialog;
+//# sourceMappingURL=ShortcutsDialog.d.ts.map

package/dist/map-menu/ShortcutsDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsDialog.d.ts","sourceRoot":"","sources":["../../src/map-menu/ShortcutsDialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB,kGAAkG;AAClG,MAAM,WAAW,qBAAsB,SAAQ,eAAe,EAAE,YAAY;IAC1E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;CAC3E;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC;AAqBxC;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,kBAAuB,GAC/B,eAAe,CAejB"}

package/dist/map-menu/TitleDialog.d.ts

@@ -0,0 +1,12 @@
+import { Modeler } from '../Modeler.js';
+import { DialogChrome, MapDialog } from './dialog.js';
+export type TitleDialogChrome = DialogChrome;
+export type TitleDialog = MapDialog;
+/**
+ * The "Map title…" dialog of the Model group: guide §5.4 keeps form fields out of the menu, so the
+ * entry opens a dialog (§8) with the title field, Cancel and Apply. Enter applies, Escape and
+ * Cancel keep the title; an unchanged title writes nothing, so the map's history gets no empty
+ * step. A canvas that turns read-only closes it without writing, as it locks the entry.
+ */
+export declare function createTitleDialog(chrome: TitleDialogChrome, modeler: Modeler): TitleDialog;
+//# sourceMappingURL=TitleDialog.d.ts.map

package/dist/map-menu/TitleDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TitleDialog.d.ts","sourceRoot":"","sources":["../../src/map-menu/TitleDialog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG/F,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAMpC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CA0D1F"}