@miragon/context-maps-renderer 0.1.0 → 0.3.0

package/README.md

@@ -8,10 +8,13 @@ and full editor for strategic Domain-Driven Design [Context Maps](https://contex
 diagrams, built on [diagram-js](https://github.com/bpmn-io/diagram-js) (MIT).
 
 It renders the canonical document from
-[`@miragon/context-maps-schema-model`](../schema-model) and gives you palette, move, resize,
+[`@miragon/context-maps-schema-model`](../schema-model) and gives you palette, move,
 connect-by-relationship, context pad, inline label editing and undo/redo — with no UI framework
-required. Mount it into any `<div>`; the web app (React) and the VS Code extension both wrap this
-exact package.
+required. Mount it into any `<div>`; the web app and the VS Code extension both wrap this
+exact package. It implements the collaborative-modeler contract of
+[`@miragon/modeler-api`](https://www.npmjs.com/package/@miragon/modeler-api), and it hands a chrome
+such as [`@miragon/modeler-shell`](https://www.npmjs.com/package/@miragon/modeler-shell) its legend,
+menu entries and shortcuts dialog without importing it.
 
 ## Install
 
@@ -21,11 +24,11 @@ npm install @miragon/context-maps-renderer @miragon/context-maps-schema-model
 
 ## Three entry points
 
-| Class             | Use it for                                                                     |
-| ----------------- | ------------------------------------------------------------------------------ |
-| `Viewer`          | Read-only rendering, no interaction (thumbnails, static embeds).               |
-| `NavigatedViewer` | Read-only + zoom (scroll), pan (drag) and selection.                           |
-| `Modeler`         | The full editor: palette, move, resize, context pad, label editing, undo/redo. |
+| Class             | Use it for                                                             |
+| ----------------- | ---------------------------------------------------------------------- |
+| `Viewer`          | Read-only rendering, no interaction (thumbnails, static embeds).       |
+| `NavigatedViewer` | Read-only + zoom (scroll), pan (drag) and selection.                   |
+| `Modeler`         | The full editor: palette, move, context pad, label editing, undo/redo. |
 
 All three share a common base (`CmBaseViewer`) with the same import/export and lifecycle API.
 
@@ -38,7 +41,7 @@ import { SAMPLE_DOCUMENT } from "@miragon/context-maps-schema-model";
 
 const modeler = new Modeler({ container: document.querySelector("#canvas")! });
 
-// Load a document (auto-fits the viewport)
+// Load a document (fits the content, never above 100 %; an empty map shows 100 %)
 const { warnings } = modeler.importDocument(SAMPLE_DOCUMENT);
 
 // Read the live canvas back as the canonical model
@@ -66,26 +69,87 @@ new Modeler({
   width?: number | string,           // canvas width  (default "100%")
   height?: number | string,          // canvas height (default "100%", or "600px" with no container)
   additionalModules?: ModuleDeclaration[], // extra diagram-js modules
+  undoRedoKeys?: boolean,            // bind Cmd/Ctrl+Z, Shift+Z, Y to the canvas (default true)
+  freeRectInsets?: () => { top: number; right: number; bottom: number; left: number },
 });
 ```
 
+- `undoRedoKeys: false` leaves the undo and redo keys unbound and unprevented, for a host whose
+  document owns the history (the VS Code extension).
+- `freeRectInsets` are the margins of the container a host's chrome covers. The fit after an import
+  centres the content in what is left, and Enter or Space on a palette entry (a click with
+  `detail === 0`) places the new context in its centre, 24px further down and right while that spot
+  is taken, selected and with its name editor open. Without it the renderer keeps room for its own
+  palette.
+
 ### Shared methods (`Viewer` / `NavigatedViewer` / `Modeler`)
 
 | Method                             | Returns                         | Purpose                                           |
 | ---------------------------------- | ------------------------------- | ------------------------------------------------- |
-| `importDocument(doc)`              | `{ warnings: ImportWarning[] }` | Replace canvas content and auto-fit.              |
+| `importDocument(doc)`              | `{ warnings: ImportWarning[] }` | Replace canvas content and fit (see below).       |
+| `importText(text)`                 | `{ warnings: ImportWarning[] }` | Parse a `.cm` text and import it; throws if not.  |
 | `exportDocument()`                 | `CmDocument`                    | Rebuild the canonical model from the live canvas. |
+| `exportText()`                     | `string`                        | The canonical `.cm` text (ends in a line break).  |
 | `saveSVG()`                        | `{ svg: string }`               | Self-contained SVG snapshot (fitted viewBox).     |
-| `setMeta(partial)` / `getMeta()`   | — / `RootBusinessObject`        | Read/write diagram-level metadata (e.g. `title`). |
+| `setMeta(partial)` / `getMeta()`   | — / `RootBusinessObject`        | Rename the map (an undoable command) / read it.   |
 | `attachTo(el)` / `detach()`        | `void`                          | Move the canvas in/out of the DOM (keeps state).  |
 | `clear()` / `destroy()`            | `void`                          | Empty the canvas / tear it down.                  |
 | `on(event, cb)` / `off(event, cb)` | `void`                          | Subscribe to diagram-js events.                   |
 | `get<T>(name)`                     | `T`                             | Resolve a diagram-js service (advanced).          |
 
+An import is **silent**: the previous document's undo history goes without a
+`commandStack.changed`, so a host that saves on every change never writes an import back. It
+**rejects without a trace**: a document with a duplicate id or an id of the engine's roots throws
+before anything is removed. It is **lossless**: keys the model does not know and relationships whose
+ends are not on the map come back on export. A label edit open during an import is taken down and
+reopened on the element with the same id, with the typed text.
+
 ### Modeler-only
 
 `undo()`, `redo()`, `canUndo()`, `canRedo()`.
 
+## Collaborative modeler
+
+```ts
+import { createCollaborativeModeler } from "@miragon/context-maps-renderer";
+
+const modeler = createCollaborativeModeler({ additionalModules: [], undoRedoKeys: true });
+modeler.attachTo(host); // attached to the document, with a size
+await modeler.importText(text); // silent; rejects (and changes nothing) for a non-importable text
+modeler.onContentChanged(() => save(modeler.exportText()));
+```
+
+`createCollaborativeModeler` and `createCollaborativeViewer` implement the `CollaborativeModeler`
+contract of `@miragon/modeler-api` 1.1 (`meta.notation` is `"context-maps"`): the canonical JSON text
+as the text lane, `onContentChanged` for every user-visible change (element commands, the title,
+undo, redo) and never for an import, the viewbox as view state, and the `elements` surface over the
+context and relationship ids (their labels as names). `modeler.diagram` is the wrapped `Modeler` or
+`NavigatedViewer`. The contract's conformance kit runs in this package's browser tests, every case
+and every hook, without a skip or an advisory.
+
+## Around the canvas
+
+What a chrome around the canvas shows, typed structurally (a `@miragon/modeler-shell` handle fits):
+
+- `renderLegend(body, { tooltip })` renders the notation legend (subdomain types, integration roles,
+  relationship patterns) into a chrome's legend card, each row explained in the chrome's tooltip.
+  Hosts without such a chrome add `cmLegendModule`, a legend card on the canvas.
+- `contextMapMenu({ exports, showKeyboardShortcuts, editTitle })` builds the Model group's "Map
+  title…" (with `editTitle`), the Export group (PNG, SVG, JSON, CML; an export's `shortcut` shows as
+  its chip) and the Help group's "Keyboard shortcuts…". `createShortcutsDialog(chrome, { fileKeys })`
+  is that dialog, with a File group (Open… and Export as JSON on Cmd/Ctrl+O and S) for a web app
+  that binds those keys; `createTitleDialog(chrome, { title, setTitle })` renames the map in a
+  modal dialog with one field, Cancel and Apply. Both dialogs live in the chrome's root and go with
+  `destroy()`.
+- While a drag runs on the canvas, the chrome's legend island (`[data-chrome="legend"]`) lets the
+  pointer through, so a connect drag released on a context behind it still connects.
+- `cmReadOnly` (part of the `Modeler`) locks every edit while a host cannot take edits from the
+  canvas, an invalid file in an IDE: no context pad, move, create, connect, delete or label editor;
+  selection, zoom, pan, select all and export stay.
+- The keyboard listens on the document but only acts on keys aimed at the canvas: keys someone
+  already handled (`defaultPrevented`) and keys from outside the canvas container pass. `Cmd/Ctrl+A`
+  selects every element.
+
 ### Helpers & types
 
 - **Type guards:** `isCmElement`, `isCmContext`, `isCmRelationship`.
@@ -100,19 +164,23 @@ The package is a set of [didi](https://github.com/nikku/didi) modules layered on
 exported (e.g. `cmDrawModule`, `cmPaletteModule`, `cmModelingModule`) so you can compose your own
 viewer via `additionalModules`:
 
-| Module                 | Responsibility                                                                      |
-| ---------------------- | ----------------------------------------------------------------------------------- |
-| `cmModelModule`        | Element factory with notation defaults (`CmElementFactory`).                        |
-| `cmDrawModule`         | Custom SVG rendering of contexts and relationships (`ContextMapsRenderer`).         |
-| `ioModule`             | Document ↔ canvas bridge (`CmImporter`, `CmExporter`, `saveSVG`).                   |
-| `cmModelingModule`     | High-level mutations — label, subdomain type, relationship pattern, roles, colours. |
-| `cmRulesModule`        | Editing rules (what can move / resize / be created / connected).                    |
-| `cmBehaviorsModule`    | Keeps the model **flat** — shapes never nest.                                       |
-| `cmPaletteModule`      | The drag-to-create tool palette.                                                    |
-| `cmContextPadModule`   | Per-element actions (rename, delete, connect).                                      |
-| `cmLabelEditingModule` | Double-click inline label editing.                                                  |
-| `cmKeyboardModule`     | Undo / redo / delete shortcuts.                                                     |
-| `cmZOrderModule`       | Fixed stacking order (relationships behind, contexts on top).                       |
+| Module                   | Responsibility                                                                                                                                                                   |
+| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cmModelModule`          | Element factory with notation defaults (`CmElementFactory`).                                                                                                                     |
+| `cmDrawModule`           | Custom SVG rendering of contexts and relationships (`ContextMapsRenderer`).                                                                                                      |
+| `ioModule`               | Document ↔ canvas bridge (`CmImporter`, `CmExporter`, `saveSVG`).                                                                                                                |
+| `cmModelingModule`       | High-level mutations — label, subdomain type, relationship pattern, roles, colours.                                                                                              |
+| `cmRulesModule`          | Editing rules (what can move / be created / connected; no resize).                                                                                                               |
+| `cmBehaviorsModule`      | Keeps the model **flat** — shapes never nest.                                                                                                                                    |
+| `cmPaletteModule`        | The tool palette: lasso tool + create contexts (drag, click, or Enter/Space into the free rectangle).                                                                            |
+| `cmConnectHandlesModule` | Opt-in (not in the default `Modeler`): four outward connect arrows around the selected context.                                                                                  |
+| `cmContextPadModule`     | Per-element quick actions: append a connected context, connect, subdomain-type / pattern / integration-role menus, owning team, description, in-place rename, swap ends, delete. |
+| `cmLegendModule`         | Opt-in: the notation legend as a collapsible card (bottom-left), for hosts without a chrome that renders `renderLegend`.                                                         |
+| `cmHoverTooltipModule`   | An element's own data (description, team, technology) on hover, inside the canvas container.                                                                                     |
+| `cmReadOnlyModule`       | The canvas lock (`cmReadOnly`) every editing feature consults.                                                                                                                   |
+| `cmLabelEditingModule`   | In-place direct name editing (double-click / pad), bpmn.io style.                                                                                                                |
+| `cmKeyboardModule`       | Select all / undo / redo / delete for keys aimed at the canvas (`undoRedoKeys` option).                                                                                          |
+| `cmZOrderModule`         | Fixed stacking order (relationships behind, contexts on top).                                                                                                                    |
 
 ### Rendering
 
@@ -145,4 +213,8 @@ npm run typecheck
 
 ## License
 
-[MIT](../../LICENSE). diagram-js and its dependencies are MIT / ISC / Apache-2.0.
+[MIT](../../LICENSE). diagram-js and its dependencies are MIT / ISC / Apache-2.0. The icons of the
+context pad, the connect handles, the validation markers, the lasso and the shortcuts dialog are
+[Lucide](https://lucide.dev) icons (lucide-static 1.59.0, ISC, © Lucide Icons and Contributors),
+copied into `src/draw/lucide.ts`; `arrow-right`, `circle-x`, `trash`, `triangle-alert` and `x` derive
+from [Feather](https://feathericons.com) (MIT, © Cole Bemis).

package/dist/CmBaseViewer.d.ts

@@ -1,13 +1,32 @@
 import { ModuleDeclaration } from 'didi';
 import { CmDocument } from '@miragon/context-maps-schema-model';
 import { ImportWarning, RootBusinessObject } from './io/types.js';
+/** Container margins in screen px that a host's chrome covers. */
+export interface FreeRectInsets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
 export interface CmViewerOptions {
     /** Host element. When absent, a detached <div> is created (attach later). */
-    container?: HTMLElement;
-    width?: number | string;
-    height?: number | string;
+    container?: HTMLElement | undefined;
+    width?: number | string | undefined;
+    height?: number | string | undefined;
     /** Appended to the module list (extension point). */
-    additionalModules?: ModuleDeclaration[];
+    additionalModules?: ModuleDeclaration[] | undefined;
+    /**
+     * Bind Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and Cmd/Ctrl+Y to the canvas undo/redo (default true).
+     * Pass false when the host owns the history (the VS Code document), so the keys reach it.
+     */
+    undoRedoKeys?: boolean | undefined;
+    /**
+     * The margins of the container the host's chrome covers (palette row, zoom panel, legend). The
+     * fit after an import centres the content in what is left, and an element created from the
+     * palette with Enter or Space lands in its centre (guide §5.5, §5.9). Default: room for the
+     * renderer's own palette.
+     */
+    freeRectInsets?: (() => FreeRectInsets) | undefined;
 }
 export type EventCallback<T = unknown> = (event: T) => void;
 export declare abstract class CmBaseViewer {
@@ -20,23 +39,51 @@ export declare abstract class CmBaseViewer {
     private _ensureDiagram;
     /** Resolve a diagram-js service from the didi injector. */
     get<T>(name: string): T;
+    /** The margins the host's chrome covers right now. */
+    private readonly freeRectInsets;
+    /** A service only some of the viewers have (the Modeler's editing services), else null. */
+    private _optional;
     on<T = unknown>(event: string, callback: EventCallback<T>, priority?: number): void;
     off(event: string, callback: EventCallback): void;
-    /** Load a document into the canvas (replaces existing content). */
+    /**
+     * Load a document into the canvas (replaces existing content). Silent: the previous document's
+     * undo history goes without a `commandStack.changed`, so a host that saves on every change does
+     * not write the import back. Throws before anything changes when the document cannot be drawn.
+     */
     importDocument(doc: CmDocument): {
         warnings: ImportWarning[];
     };
+    /**
+     * Load the text of a `.cm`/`.cm.json` file. Throws (and changes nothing) when the text is no
+     * importable document.
+     */
+    importText(text: string): {
+        warnings: ImportWarning[];
+    };
     /** Current canvas state as a canonical document. */
     exportDocument(): CmDocument;
-    /** Update diagram-level metadata (title / flow-of-change) on the root. */
+    /** Current canvas state as the canonical file text (ends in one line break). */
+    exportText(): string;
+    /**
+     * Update diagram-level metadata on the root. In an editor a title change is an undoable command
+     * (`cmModeling.setTitle`); a viewer has no history and writes it directly. A locked editor
+     * (`cmReadOnly`) changes nothing: its host takes no edits, and the next import would silently
+     * revert the title.
+     */
     setMeta(partial: Partial<RootBusinessObject>): void;
-    /** Read diagram-level metadata (title / flow-of-change) from the root. */
+    /** Read diagram-level metadata from the root; undefined before the first import. */
     getMeta(): RootBusinessObject | undefined;
+    /** Through the registry: asking the canvas would create an implicit root before an import. */
+    private _documentRoot;
     /** Standalone, self-contained SVG snapshot. */
     saveSVG(): {
         svg: string;
     };
-    /** Fit the content into the viewport, leaving room at the top for the palette. */
+    /**
+     * Centres the content in the container minus room for the chrome, at the largest zoom that
+     * shows all of it and never above 100 % (guide §5.9); an empty map shows 100 %. The same view
+     * for the same document and container (the contract's fitted view after an import).
+     */
     private _fit;
     /** Attach the container into `target`. */
     attachTo(target: HTMLElement): void;

package/dist/CmBaseViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmBaseViewer.d.ts","sourceRoot":"","sources":["../src/CmBaseViewer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE,OAAO,EAAW,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAErF,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAQ5D,8BAAsB,YAAY;IAChC,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,CAAkB;gBAE/B,OAAO,GAAE,eAAoB;IAKzC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAQtB,2DAA2D;IAC3D,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,mEAAmE;IACnE,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE;IAW9D,oDAAoD;IACpD,cAAc,IAAI,UAAU;IAI5B,0EAA0E;IAC1E,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAanD,0EAA0E;IAC1E,OAAO,IAAI,kBAAkB,GAAG,SAAS;IASzC,+CAA+C;IAC/C,OAAO,IAAI;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAI1B,kFAAkF;IAClF,OAAO,CAAC,IAAI;IA0CZ,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKnC,2DAA2D;IAC3D,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,IAAI,SAAS,IAAI,WAAW,CAE3B;CACF"}
+{"version":3,"file":"CmBaseViewer.d.ts","sourceRoot":"","sources":["../src/CmBaseViewer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAQ9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAOrE,OAAO,EAAW,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAErF,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAsB5D,8BAAsB,YAAY;IAChC,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,CAAkB;gBAE/B,OAAO,GAAE,eAAoB;IAKzC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAatB,2DAA2D;IAC3D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIvB,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CACgC;IAE/D,2FAA2F;IAC3F,OAAO,CAAC,SAAS;IAIjB,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;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE;IAsB9D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE;IAMvD,oDAAoD;IACpD,cAAc,IAAI,UAAU;IAI5B,gFAAgF;IAChF,UAAU,IAAI,MAAM;IAIpB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAUnD,oFAAoF;IACpF,OAAO,IAAI,kBAAkB,GAAG,SAAS;IAIzC,8FAA8F;IAC9F,OAAO,CAAC,aAAa;IAIrB,+CAA+C;IAC/C,OAAO,IAAI;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAI1B;;;;OAIG;IACH,OAAO,CAAC,IAAI;IA6CZ,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKnC,2DAA2D;IAC3D,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,IAAI,SAAS,IAAI,WAAW,CAE3B;CACF"}

package/dist/Modeler.d.ts

@@ -1,8 +1,10 @@
 import { ModuleDeclaration } from 'didi';
 import { NavigatedViewer } from './NavigatedViewer.js';
 /**
- * Full Context Maps editor: palette/create, move, resize, connect with
- * rules, context pad, inline label editing, undo/redo.
+ * Full Context Maps editor: palette/create, move, connect with rules,
+ * context pad, inline label editing, undo/redo, and the edit lock for a
+ * document the host cannot take edits for (`cmReadOnly`). Boxes are
+ * fixed-size — no resize feature.
  */
 export declare class Modeler extends NavigatedViewer {
     protected _getModules(): ModuleDeclaration[];

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;AAS9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAWvD;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IAsBrD,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;AAQ9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAYvD;;;;;GAKG;AACH,qBAAa,OAAQ,SAAQ,eAAe;cACvB,WAAW,IAAI,iBAAiB,EAAE;IAsBrD,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,OAAO;CAGnB"}

package/dist/NavigatedViewer.d.ts

@@ -1,6 +1,6 @@
 import { ModuleDeclaration } from 'didi';
 import { Viewer } from './Viewer.js';
-/** Read-only + navigation: zoom (scroll), pan (drag), selection. */
+/** Read-only + navigation: zoom (scroll), pan (drag), selection, the elements' own data on hover. */
 export declare class NavigatedViewer extends Viewer {
     protected _getModules(): ModuleDeclaration[];
 }

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;AAI9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,oEAAoE;AACpE,qBAAa,eAAgB,SAAQ,MAAM;cACtB,WAAW,IAAI,iBAAiB,EAAE;CAGtD"}
+{"version":3,"file":"NavigatedViewer.d.ts","sourceRoot":"","sources":["../src/NavigatedViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,qGAAqG;AACrG,qBAAa,eAAgB,SAAQ,MAAM;cACtB,WAAW,IAAI,iBAAiB,EAAE;CAStD"}

package/dist/behaviors/CmFlatModelBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmFlatModelBehavior.d.ts","sourceRoot":"","sources":["../../src/behaviors/CmFlatModelBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,MAAM,2CAA2C,CAAC;AAC3E,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAQtE,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,kBAAkB;IACjE,OAAgB,OAAO,WAAsC;gBAEjD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CA6BnE"}
+{"version":3,"file":"CmFlatModelBehavior.d.ts","sourceRoot":"","sources":["../../src/behaviors/CmFlatModelBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,MAAM,2CAA2C,CAAC;AAC3E,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AACrD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAQtE,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,kBAAkB;IACjE,OAAgB,OAAO,WAAsC;gBAEjD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAwDnE"}

package/dist/chrome/ShortcutsDialog.d.ts

@@ -0,0 +1,13 @@
+import { ChromeDialog, DialogChrome } from './dialog.js';
+import { ContextMapShortcutOptions, 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 = ChromeDialog;
+/**
+ * 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.
+ */
+export declare function createShortcutsDialog(chrome: ShortcutsDialogChrome, options?: ContextMapShortcutOptions): ShortcutsDialog;
+//# sourceMappingURL=ShortcutsDialog.d.ts.map

package/dist/chrome/ShortcutsDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutsDialog.d.ts","sourceRoot":"","sources":["../../src/chrome/ShortcutsDialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAEL,KAAK,yBAAyB,EAE9B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAKxB,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,YAAY,CAAC;AAsB3C;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,yBAA8B,GACtC,eAAe,CAWjB"}

package/dist/chrome/TitleDialog.d.ts

@@ -0,0 +1,15 @@
+import { ChromeDialog, DialogChrome } from './dialog.js';
+/** The map's title, read when the dialog opens and written when it applies. */
+export interface MapTitle {
+    title(): string;
+    setTitle(title: string): void;
+}
+export type TitleDialogChrome = DialogChrome;
+export type TitleDialog = ChromeDialog;
+/**
+ * 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 cancels;
+ * an unchanged title writes nothing, so the map's history gets no empty step.
+ */
+export declare function createTitleDialog(chrome: TitleDialogChrome, mapTitle: MapTitle): TitleDialog;
+//# sourceMappingURL=TitleDialog.d.ts.map

package/dist/chrome/TitleDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TitleDialog.d.ts","sourceRoot":"","sources":["../../src/chrome/TitleDialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhG,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AASvC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAwC5F"}

package/dist/chrome/dialog.d.ts

@@ -0,0 +1,39 @@
+/** What a dialog needs of the chrome around the map; a `@miragon/modeler-shell` handle fits. */
+export interface DialogChrome {
+    /** Where the dialog lives (the shell root), so it shares the chrome's mode and fonts. */
+    readonly root: HTMLElement;
+    readonly messages: {
+        readonly close: string;
+    };
+    /** The control the focus returns to once the dialog closes. */
+    readonly menu: {
+        readonly trigger: HTMLElement;
+    };
+}
+export interface ChromeDialog {
+    open(): void;
+    isOpen(): boolean;
+    close(): void;
+    destroy(): void;
+}
+export interface ChromeDialogSpec {
+    /** Class of the `<dialog>` next to `cm-dialog`, for the dialog's own rules. */
+    readonly className: string;
+    readonly titleId: string;
+    readonly title: string;
+    /** The parts below the header, built once on the first open. */
+    content(close: () => void): Node[];
+    /** Runs before every open, while the dialog is still closed. */
+    beforeOpen?(): void;
+    /** Runs after every open, once the dialog shows and holds the focus. */
+    afterOpen?(): void;
+}
+export declare function element<K extends keyof HTMLElementTagNameMap>(tag: K, className: string, text?: string): HTMLElementTagNameMap[K];
+/**
+ * A dialog of the map's chrome (guide §8, "Modeler dialogs" of the shell's API): a native modal
+ * <dialog> inside the chrome's root, so the browser keeps the focus inside it and closes it on
+ * Escape. Built on the first open and kept (closed) afterwards; `destroy()` removes it. The host
+ * calls it with the diagram's teardown, since the chrome removes only what it added itself.
+ */
+export declare function createChromeDialog(chrome: DialogChrome, spec: ChromeDialogSpec): ChromeDialog;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/chrome/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/chrome/dialog.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,OAAO,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;IACnC,gEAAgE;IAChE,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,IAAI,IAAI,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAC3D,GAAG,EAAE,CAAC,EACN,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,qBAAqB,CAAC,CAAC,CAAC,CAK1B;AAeD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAsC7F"}

package/dist/chrome/index.d.ts

@@ -0,0 +1,10 @@
+export { contextMapMenu, JSON_EXPORT_LABEL } from './menu.js';
+export type { MapExport, MapExports, MapMenu, MapMenuAction, MapMenuActions, MapMenuDialog, MapMenuEntry, MapMenuIcon, } from './menu.js';
+export { contextMapShortcuts } from './shortcuts.js';
+export type { ContextMapShortcutOptions, ShortcutGroup, ShortcutKeyNames, ShortcutPlatform, ShortcutRow, ShortcutsChrome, } from './shortcuts.js';
+export { createShortcutsDialog } from './ShortcutsDialog.js';
+export type { ShortcutsDialog, ShortcutsDialogChrome } from './ShortcutsDialog.js';
+export { createTitleDialog } from './TitleDialog.js';
+export type { MapTitle, TitleDialog, TitleDialogChrome } from './TitleDialog.js';
+export type { ChromeDialog, DialogChrome } from './dialog.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chrome/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,YAAY,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EACV,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/chrome/menu.d.ts

@@ -0,0 +1,50 @@
+/** The icons the guide gives these entries (guide §5.14, the shell's common set). */
+export type MapMenuIcon = "file-image" | "file-code-corner" | "keyboard";
+interface MapMenuItem {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: MapMenuIcon;
+    readonly keepEnabledWhenReadOnly?: boolean;
+}
+export interface MapMenuAction extends MapMenuItem {
+    readonly kind: "action";
+    readonly shortcut?: string;
+    onSelect(): void;
+}
+export interface MapMenuDialog extends MapMenuItem {
+    readonly kind: "dialog";
+    onSelect(): void;
+}
+export type MapMenuEntry = MapMenuAction | MapMenuDialog;
+export interface MapMenu {
+    readonly model: readonly MapMenuEntry[];
+    readonly export: readonly MapMenuEntry[];
+    readonly help: readonly MapMenuEntry[];
+}
+export interface MapExport {
+    onSelect(): void;
+    /** The chip of an app key that runs the same export, e.g. "⌘S". */
+    readonly shortcut?: string | undefined;
+}
+/**
+ * The exports a host offers, in the guide's order: PNG first (the more frequent target), then
+ * SVG, then the map's own JSON and Context Mapper's CML.
+ */
+export interface MapExports {
+    readonly png: MapExport;
+    readonly svg: MapExport;
+    readonly json: MapExport;
+    readonly cml: MapExport;
+}
+export interface MapMenuActions {
+    readonly exports: MapExports;
+    showKeyboardShortcuts(): void;
+    /** Opens the dialog that renames the map; without it the Model group has no title entry. */
+    editTitle?: (() => void) | undefined;
+}
+/** The map's native file in the Export group and in the shortcuts dialog. */
+export declare const JSON_EXPORT_LABEL = "Export as JSON";
+/** The menu groups of the context map (guide §5.4): Model, Export with PNG first, Help. */
+export declare function contextMapMenu(actions: MapMenuActions): MapMenu;
+export {};
+//# sourceMappingURL=menu.d.ts.map

package/dist/chrome/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/chrome/menu.ts"],"names":[],"mappings":"AAOA,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAEzE,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC;AAEzD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,IAAI,IAAI,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,qBAAqB,IAAI,IAAI,CAAC;IAC9B,4FAA4F;IAC5F,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACtC;AAED,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAkBlD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAsB/D"}

package/dist/chrome/shortcuts.d.ts

@@ -0,0 +1,41 @@
+export type ShortcutPlatform = "mac" | "other";
+export interface ShortcutKeyNames {
+    readonly ctrl: string;
+    readonly shift: string;
+    readonly plus: string;
+    readonly minus: string;
+}
+/** What the shortcuts need of the chrome around the map. */
+export interface ShortcutsChrome {
+    readonly platform: ShortcutPlatform;
+    /** The tool's UI language, for the percentage in "Zoom to 100%". */
+    readonly lang: string;
+    readonly messages: {
+        readonly zoomIn: string;
+        readonly zoomOut: string;
+        zoomToActual(percent: string): string;
+        readonly fit: string;
+        /** The File group's "Open…" (the shell's `messages.openFile`); default "Open…". */
+        readonly openFile?: string | undefined;
+        readonly keyNames: ShortcutKeyNames;
+    };
+}
+export interface ShortcutRow {
+    readonly action: string;
+    /** Alternative key combinations, each shown as its own chip. */
+    readonly keys: readonly string[];
+}
+export interface ShortcutGroup {
+    readonly title: string;
+    readonly rows: readonly ShortcutRow[];
+}
+export interface ContextMapShortcutOptions {
+    /** The web app's file keys: Cmd/Ctrl+O opens a file, Cmd/Ctrl+S exports the map as JSON. */
+    readonly fileKeys?: boolean | undefined;
+}
+/**
+ * Every shortcut of the map, grouped as guide §5.4 asks (View, Edit, Tools), after the web app's
+ * File keys where it binds them.
+ */
+export declare function contextMapShortcuts(chrome: ShortcutsChrome, options?: ContextMapShortcutOptions): ShortcutGroup[];
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/chrome/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../src/chrome/shortcuts.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,mFAAmF;QACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KACrC,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAqED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,yBAA8B,GACtC,aAAa,EAAE,CAuCjB"}

package/dist/collaborative/CollaborativeContextMaps.d.ts

@@ -0,0 +1,28 @@
+import { CollaborativeModeler, ElementsSurface } from '@miragon/modeler-api';
+import { ModuleDeclaration } from 'didi';
+import { FreeRectInsets } from '../CmBaseViewer.js';
+import { Modeler } from '../Modeler.js';
+import { NavigatedViewer } from '../NavigatedViewer.js';
+/** Stable notation id in `meta.notation` of the collaborative-modeler contract. */
+export declare const CONTEXT_MAPS_NOTATION = "context-maps";
+export interface CollaborativeContextMapsOptions {
+    /** Appended to the renderer's own modules (e.g. a host's chrome module). */
+    additionalModules?: ModuleDeclaration[] | undefined;
+    /** See `CmViewerOptions.undoRedoKeys` (default true). */
+    undoRedoKeys?: boolean | undefined;
+    /** See `CmViewerOptions.freeRectInsets`. */
+    freeRectInsets?: (() => FreeRectInsets) | undefined;
+}
+/** The contract surface plus the wrapped diagram for host-specific wiring. */
+export interface CollaborativeContextMapsModeler extends CollaborativeModeler {
+    readonly elements: ElementsSurface;
+    readonly diagram: Modeler | NavigatedViewer;
+}
+/**
+ * The editing mount (`meta.editable: true`) of the collaborative-modeler contract: the text lane
+ * is the canonical JSON of a `.cm`/`.cm.json` file (`serializeDocumentText`).
+ */
+export declare function createCollaborativeModeler(options?: CollaborativeContextMapsOptions): CollaborativeContextMapsModeler;
+/** The read-only mount (`meta.editable: false`): imports, exports and reveals, never edits. */
+export declare function createCollaborativeViewer(options?: Omit<CollaborativeContextMapsOptions, "undoRedoKeys">): CollaborativeContextMapsModeler;
+//# sourceMappingURL=CollaborativeContextMaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollaborativeContextMaps.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeContextMaps.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,MAAM,WAAW,+BAA+B;IAC9C,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,8EAA8E;AAC9E,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IAC3E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AASD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,+BAAoC,GAC5C,+BAA+B,CASjC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,IAAI,CAAC,+BAA+B,EAAE,cAAc,CAAM,GAClE,+BAA+B,CAQjC"}

package/dist/collaborative/index.d.ts

@@ -0,0 +1,2 @@
+export { CONTEXT_MAPS_NOTATION, createCollaborativeModeler, createCollaborativeViewer, type CollaborativeContextMapsModeler, type CollaborativeContextMapsOptions, } from './CollaborativeContextMaps.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,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,+BAA+B,CAAC"}

package/dist/connect-handles/CmConnectHandles.d.ts

@@ -3,13 +3,15 @@ import { default as Overlays } from 'diagram-js/lib/features/overlays/Overlays';
 import { default as Selection } from 'diagram-js/lib/features/selection/Selection';
 import { default as Connect } from 'diagram-js/lib/features/connect/Connect';
 import { default as Dragging } from 'diagram-js/lib/features/dragging/Dragging';
+import { CmReadOnly } from '../read-only/index.js';
 export default class CmConnectHandles {
     private readonly eventBus;
     private readonly selection;
     private readonly overlays;
     private readonly dragging;
+    private readonly readOnly;
     static $inject: string[];
-    constructor(eventBus: EventBus, selection: Selection, overlays: Overlays, connect: Connect, dragging: Dragging);
+    constructor(eventBus: EventBus, selection: Selection, overlays: Overlays, connect: Connect, dragging: Dragging, readOnly: Pick<CmReadOnly, "isReadOnly">);
     private refresh;
 }
 //# sourceMappingURL=CmConnectHandles.d.ts.map

package/dist/connect-handles/CmConnectHandles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CmConnectHandles.d.ts","sourceRoot":"","sources":["../../src/connect-handles/CmConnectHandles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AACzE,OAAO,KAAK,OAAO,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAuCtE,MAAM,CAAC,OAAO,OAAO,gBAAgB;IAIjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,MAAM,CAAC,OAAO,WAAgE;gBAG3D,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EACnC,OAAO,EAAE,OAAO,EACC,QAAQ,EAAE,QAAQ;IAYrC,OAAO,CAAC,OAAO;CA8ChB"}
+{"version":3,"file":"CmConnectHandles.d.ts","sourceRoot":"","sources":["../../src/connect-handles/CmConnectHandles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AACtE,OAAO,KAAK,SAAS,MAAM,6CAA6C,CAAC;AACzE,OAAO,KAAK,OAAO,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,QAAQ,MAAM,2CAA2C,CAAC;AAKtE,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAmCjF,MAAM,CAAC,OAAO,OAAO,gBAAgB;IAIjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,MAAM,CAAC,OAAO,WAA8E;gBAGzE,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EACnC,OAAO,EAAE,OAAO,EACC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IAa3D,OAAO,CAAC,OAAO;CAoDhB"}

package/dist/connect-handles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connect-handles/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,iBAIpC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connect-handles/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAO9C,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,iBAIpC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}