@miragon/wardley-renderer 0.9.1 → 0.10.0

package/README.md

@@ -107,11 +107,16 @@ size preview (an undo pressed mid-drag, a title the host sets) puts the preview
 drag then ends without resizing, so the history stays in step with the document. `elements` names
 components, anchors, pipelines, submaps and accelerators by the id the document gives them
 (`cmp_kettle`), also right after a canvas edit, and `elements.bounds(id)` gives an element's live
-box in diagram coordinates; `getViewState` and `setViewState` carry the viewbox. `diagram` is the
-wrapped `Modeler` or `NavigatedViewer` for host-specific wiring. Both factories take the options
-above (`additionalModules`, `freeArea`, `fitOnImport`, `undoRedoKeys` and the deprecated aliases);
-the viewer never edits and ignores the undo keys. Both pass the contract's conformance kit (1.2)
-without skips.
+box in diagram coordinates; `getViewState` and `setViewState` carry the viewbox. `contentBounds()`
+(contract 1.3) gives the box a host fits the view to, in diagram coordinates and without padding:
+the plot with its axes and everything drawn beyond it (a long label at the commodity edge, a note in
+the margin), the box the pan constraint keeps in view. It follows every edit at once and stays the
+same across zoom and scroll. A map without elements still has its plot, so it is never `undefined`
+while the modeler lives (before the first import it is the default plot); tell an empty map by its
+elements. `diagram` is the wrapped `Modeler` or `NavigatedViewer` for host-specific wiring. Both
+factories take the options above (`additionalModules`, `freeArea`, `fitOnImport`, `undoRedoKeys`
+and the deprecated aliases); the viewer never edits and ignores the undo keys. Both pass the
+contract's conformance kit (1.3) without skips.
 
 ### Menu entries and dialogs for a host's chrome
 
@@ -124,7 +129,7 @@ title…" dialog (one undo step on Apply, nothing for an unchanged title),
 `createShortcutsDialog(chrome, options)` the "Keyboard shortcuts…" dialog and
 `mapShortcuts(chrome, options)` its table. A web app that binds Cmd/Ctrl+O, Cmd/Ctrl+S, Cmd/Ctrl+V
 on the canvas and `?` itself passes `{ fileKeys: true, shortcutsKey: '?' }`, so the dialog lists
-them too.
+them too, and `mapMenu({ …, shortcutsKey: '?' })` shows the key's chip on "Keyboard shortcuts…".
 `createMapDialog(chrome, parts)` is the modal dialog all of them share (guide §8: header with Close,
 scrolling body, footer), for a host's own dialogs in the same look; `dialogButton(label, variant)`
 gives its buttons. `chrome` is the shell handle or anything of the same shape; the renderer never

package/dist/collaborative/CollaborativeWardley.d.ts

@@ -23,10 +23,14 @@ export interface CollaborativeWardleyOptions extends CollaborativeModelerOptions
 export interface WardleyElementsSurface extends ElementsSurface {
     bounds(id: string): ElementBounds | undefined;
 }
-/** The contract surface plus the wrapped diagram for host-specific wiring. */
+/**
+ * The contract surface, with the optional `contentBounds` of contract 1.3 always present, plus the
+ * wrapped diagram for host-specific wiring.
+ */
 export interface CollaborativeWardleyModeler extends CollaborativeModeler {
     readonly elements: WardleyElementsSurface;
     readonly diagram: Modeler | NavigatedViewer;
+    contentBounds(): ElementBounds | undefined;
 }
 /** The editing mount (`meta.editable: true`) of the collaborative-modeler contract. */
 export declare function createCollaborativeModeler(options?: CollaborativeWardleyOptions): CollaborativeWardleyModeler;

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

@@ -1 +1 @@
-{"version":3,"file":"CollaborativeWardley.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeWardley.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAC9C,oGAAoG;IACpG,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,iGAAiG;AACjG,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED,8EAA8E;AAC9E,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AA2BD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAS7B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAE7B"}
+{"version":3,"file":"CollaborativeWardley.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeWardley.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAM9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAC9C,oGAAoG;IACpG,cAAc,CAAC,EAAE,CAAC,MAAM,cAAc,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,iGAAiG;AACjG,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;IAC5C,aAAa,IAAI,aAAa,GAAG,SAAS,CAAC;CAC5C;AA2BD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAS7B;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,2BAAgC,GACxC,2BAA2B,CAE7B"}