@miragon/value-chain-renderer 0.6.0 → 0.7.0

package/README.md

@@ -121,11 +121,15 @@ modeler.onContentChanged(() => save(modeler.exportText())); // canonical JSON
 ```
 
 `createCollaborativeModeler` and `createCollaborativeViewer` implement the `CollaborativeModeler`
-contract 1.2 (`meta.notation` `"value-chain"`): blank text opens as an empty diagram,
+contract 1.3 (`meta.notation` `"value-chain"`): blank text opens as an empty diagram,
 `onContentChanged` fires for every edit and undo/redo and never for an import, view state is the
-diagram-js viewbox, a host's `setViewState` or fit never commits a label being typed, and the
+diagram-js viewbox, a host's `setViewState` or fit never commits a label being typed, the
 `elements` surface lists steps and organizational units (name = label) with `reveal`, selection and
-`bounds(id)`, the live box of a step or an organizational unit in diagram coordinates. Both take
+`bounds(id)`, the live box of a step or an organizational unit in diagram coordinates, and
+`contentBounds()` is the live, tight box around every step, organizational unit and connection in
+diagram coordinates (`undefined` while the diagram is empty): what a host that fits the view itself
+fits to, as `connectDiagramJs(shell, diagram, { modeler, isEmpty })` of `@miragon/modeler-shell`
+does. Label text that overflows its shape is not part of the box, as in the SVG export. Both take
 the contract's factory options `freeArea`, `fitOnImport` and `undoRedoKeys` (the viewer ignores
 the two that need editing) and the deprecated `freeRectCenter`. The browser test suite runs the
 contract's conformance kit on every law, with no case skipped and no advisory. `diagram` is the
@@ -138,7 +142,8 @@ renderer never imports the shell): `diagramMenu()` (Export as PNG, then SVG, opt
 with "Keyboard shortcuts…"), `createShortcutsDialog(shell)` (a modal `<dialog>` in the chrome's
 root, with the high-contrast and forced-colours rules of the design system; `{ fileKeys: true }`
 adds the web app's File keys, Cmd/Ctrl+O and Cmd/Ctrl+S), `svgToPng()` and
-`blobToBase64()` for the PNG export, and `vcBounds.contentBounds(padding)` for a host's fit.
+`blobToBase64()` for the PNG export, and `vcBounds.isEmpty()`, a cheap emptiness test for the
+shell's empty-file hint.
 
 ## Notation
 

package/dist/collaborative/CollaborativeValueChain.d.ts

@@ -1,4 +1,4 @@
-import { CollaborativeModeler, CollaborativeModelerOptions, ElementsSurface } from '@miragon/modeler-api';
+import { CollaborativeModeler, CollaborativeModelerOptions, ElementBounds, ElementsSurface } from '@miragon/modeler-api';
 import { ModuleDeclaration } from 'didi';
 import { Point } from '@miragon/value-chain-schema-model';
 import { Modeler } from '../Modeler.js';
@@ -23,6 +23,12 @@ export interface CollaborativeValueChainOptions extends CollaborativeModelerOpti
 /** The contract surface plus the wrapped diagram for host-specific wiring. */
 export interface CollaborativeValueChainModeler extends CollaborativeModeler {
     readonly elements: ElementsSurface & Required<Pick<ElementsSurface, 'bounds'>>;
+    /**
+     * The tight box around every step, org unit and connection (waypoints included) in diagram
+     * coordinates, without a margin of its own; undefined while the diagram has no element. Label
+     * text that overflows its shape is not part of the box, as in the SVG export.
+     */
+    contentBounds(): ElementBounds | undefined;
     readonly diagram: Modeler | NavigatedViewer;
 }
 /** The editing mount (`meta.editable: true`) of the collaborative-modeler contract. */

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

@@ -1 +1 @@
-{"version":3,"file":"CollaborativeValueChain.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeValueChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAGhC,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAIL,KAAK,KAAK,EAEX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIxD,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACxD;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AASD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,8BAAmC,GAC3C,8BAA8B,CAUhC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,8BAAmC,GAC3C,8BAA8B,CAEhC"}
+{"version":3,"file":"CollaborativeValueChain.d.ts","sourceRoot":"","sources":["../../src/collaborative/CollaborativeValueChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAElB,KAAK,eAAe,EAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAK9C,OAAO,EAIL,KAAK,KAAK,EAEX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACxD;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC/E;;;;OAIG;IACH,aAAa,IAAI,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AASD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,8BAAmC,GAC3C,8BAA8B,CAUhC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,8BAAmC,GAC3C,8BAA8B,CAEhC"}

package/dist/index.js

@@ -1810,29 +1810,29 @@ function Kn(e) {
 	return e.trim() === "" ? o(Hn) : u(e);
 }
 function qn(e, t) {
-	let n = e.get("eventBus"), r = e.get("canvas"), i = e.get("elementRegistry"), a = e.get("selection"), o = /* @__PURE__ */ new Set(), s = !1, c = "", l = {
+	let n = e.get("eventBus"), r = e.get("canvas"), i = e.get("elementRegistry"), a = e.get("selection"), o = e.get("vcBounds"), s = /* @__PURE__ */ new Set(), c = !1, l = "", u = {
 		notation: Vn,
 		apiVersion: Ge,
 		editable: t
 	};
 	return t && n.on("commandStack.changed", () => {
-		for (let e of [...o]) e();
+		for (let e of [...s]) e();
 	}), {
-		meta: l,
+		meta: u,
 		elements: {
-			list: () => s ? [] : i.getAll().filter(S).map(Jn),
+			list: () => c ? [] : i.getAll().filter(S).map(Jn),
 			reveal(e) {
-				if (s) return !1;
+				if (c) return !1;
 				let t = i.get(e);
 				return S(t) ? (a.select(t), r.scrollToElement(t), !0) : !1;
 			},
-			selection: () => s ? [] : K(a.get()),
+			selection: () => c ? [] : K(a.get()),
 			onSelection(e) {
 				let t = (t) => e(K(t.newSelection ?? []));
 				return n.on("selection.changed", t), () => n.off("selection.changed", t);
 			},
 			bounds(e) {
-				if (s) return;
+				if (c) return;
 				let t = i.get(e);
 				if (!S(t)) return;
 				let { x: n, y: r, width: a, height: o } = t;
@@ -1849,7 +1849,7 @@ function qn(e, t) {
 			t.appendChild(e.container), r.resized();
 		},
 		importText(t) {
-			if (s) return Promise.reject(/* @__PURE__ */ Error("The modeler was destroyed."));
+			if (c) return Promise.reject(/* @__PURE__ */ Error("The modeler was destroyed."));
 			try {
 				let n = e.importDocument(Kn(t));
 				return Promise.resolve({ warnings: n.map((e) => e.message) });
@@ -1858,13 +1858,13 @@ function qn(e, t) {
 			}
 		},
 		exportText() {
-			return s ? c : d(e.exportDocument());
+			return c ? l : d(e.exportDocument());
 		},
 		onContentChanged(e) {
-			return t ? (o.add(e), () => o.delete(e)) : () => void 0;
+			return t ? (s.add(e), () => s.delete(e)) : () => void 0;
 		},
 		getViewState() {
-			if (!s) try {
+			if (!c) try {
 				let { x: e, y: t, width: n, height: i } = r.viewbox(), a = {
 					x: e,
 					y: t,
@@ -1877,21 +1877,24 @@ function qn(e, t) {
 			}
 		},
 		setViewState(e) {
-			!s && Yn(e) && r.viewbox({
+			!c && Yn(e) && r.viewbox({
 				x: e.x,
 				y: e.y,
 				width: e.width,
 				height: e.height
 			});
 		},
+		contentBounds() {
+			return c ? void 0 : o.contentBounds(0);
+		},
 		destroy() {
-			if (!s) {
+			if (!c) {
 				try {
-					c = d(e.exportDocument());
+					l = d(e.exportDocument());
 				} catch {
-					c = "";
+					l = "";
 				}
-				s = !0, o.clear(), e.destroy();
+				c = !0, s.clear(), e.destroy();
 			}
 		}
 	};