@miragon/value-chain-renderer 0.5.0 → 0.6.1

package/README.md

@@ -19,7 +19,9 @@ collaborative hosts.
 npm install @miragon/value-chain-renderer @miragon/value-chain-schema-model
 ```
 
-ESM only, for browsers and bundlers.
+ESM only, for browsers and bundlers. `diagram-js` (^15.28.0), `didi`, `tiny-svg` and `zod` are peer
+dependencies: an app that already has them shares its copy with the renderer, since a second
+diagram-js or Zod breaks the dependency injection and `instanceof` checks.
 
 ## Quick start
 
@@ -62,7 +64,7 @@ loads its own stylesheet after this one.
 | `NavigatedViewer` | Read-only plus zoom and pan.                                        |
 | `Modeler`         | The full editor, plus `undo()` / `redo()` on top of the shared API. |
 
-All three take `{ container?, width?, height?, additionalModules?, freeRectCenter?, undoRedoKeys? }`
+All three take `{ container?, width?, height?, additionalModules?, freeArea?, fitOnImport?, undoRedoKeys? }`
 and share `importDocument`, `exportDocument`, `saveSVG`, `fitViewport`, `clear`, `attachTo`,
 `detach`, `destroy`, `on`/`off` and `get` (DI lookup). `additionalModules` extends the DI
 container as in bpmn-js; the feature modules (`vcDrawModule`, `vcRulesModule`, `vcPaletteModule`,
@@ -71,16 +73,22 @@ container as in bpmn-js; the feature modules (`vcDrawModule`, `vcRulesModule`, `
 - `importDocument(document)` validates the document before it touches the canvas (a rejected one
   throws and leaves the previous diagram, its ids and its undo history as they were), erases the
   undo history silently (no `commandStack.changed`), and fits the view: the content centred at the
-  largest zoom that shows all of it, never above 100 %. A label being typed is taken down without
-  committing and reopened afterwards on the element with the same id.
+  largest zoom that shows all of it, never above 100 % (`fitOnImport: false` leaves the view to a
+  host that fits itself). A label being typed is taken down without committing and reopened
+  afterwards on the element with the same id.
+- A label being typed stays open across every view change, a host's fit or restore as much as a
+  wheel zoom, and moves along with its element; only Enter, leaving the text box or a click or drag
+  on the canvas commits it.
 - `exportDocument()` writes back every key the schema does not define (vendor extensions on the
   document, its meta, its elements and connections).
 - New elements get random ids (`step_k3x9q2mf`, `org_…`, `sequence_…`), so two people adding an
   element to one document at the same time never pick the same id.
-- `freeRectCenter: () => Point | undefined`: where Enter or Space on a creating palette entry places
-  the element, in diagram coordinates (a host chrome passes the centre of the canvas area it leaves
-  free; default: the centre of the visible canvas). The element is selected, the canvas focused and
-  its label editor opened.
+- `freeArea`: the canvas area the host's chrome leaves free, as `{ insets: () => FreeAreaInsets }`
+  (px from the container's edges) or `{ center: () => Point | undefined }` (diagram coordinates).
+  Enter or Space on a creating palette entry places the element in its centre (default: the centre
+  of the visible canvas), selected, with the canvas focused and its label editor open.
+  `freeRectCenter` is the deprecated name of `freeArea: { center }`, accepted until the next minor
+  release; given both, `freeArea` wins.
 - `undoRedoKeys: false` leaves Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and Ctrl+Y unbound and unprevented, for
   a host that owns the history (the VS Code document).
 
@@ -113,11 +121,15 @@ modeler.onContentChanged(() => save(modeler.exportText())); // canonical JSON
 ```
 
 `createCollaborativeModeler` and `createCollaborativeViewer` implement the `CollaborativeModeler`
-contract 1.1 (`meta.notation` `"value-chain"`): blank text opens as an empty diagram,
+contract 1.2 (`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, and the `elements` surface lists steps and organizational units (name = label)
-with `reveal` and selection. The browser test suite runs the contract's conformance kit on every
-law, with no case skipped. `diagram` is the wrapped `Modeler` or `NavigatedViewer` for host wiring.
+diagram-js viewbox, a host's `setViewState` or fit never commits a label being typed, and 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
+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
+wrapped `Modeler` or `NavigatedViewer` for host wiring.
 
 ## Chrome content for hosts
 

package/dist/VcBaseViewer.d.ts

@@ -1,8 +1,17 @@
 import { ModuleDeclaration } from 'didi';
+import { CollaborativeModelerOptions } from '@miragon/modeler-api';
 import { EventBusEventCallback } from 'diagram-js/lib/core/EventBus';
 import { Point, ValueChainDocument } from '@miragon/value-chain-schema-model';
 import { ImportWarning } from './io/types.js';
-export interface VcViewerOptions {
+/**
+ * `freeArea`, `fitOnImport` and `undoRedoKeys` as `@miragon/modeler-api` 1.2 names them:
+ * `freeArea` is where Enter or Space on a creating palette entry places the element (the centre of
+ * the canvas area the host's chrome leaves free, guide §5.5; default the centre of the visible
+ * canvas), `fitOnImport: false` leaves the view after an import to the host, and
+ * `undoRedoKeys: false` leaves Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and Ctrl+Y to a host that owns the
+ * history (the VS Code document).
+ */
+export interface VcViewerOptions extends CollaborativeModelerOptions {
     /** Host element. If missing, a detached <div> is created (attach later via attachTo). */
     container?: HTMLElement;
     width?: number | string;
@@ -10,16 +19,10 @@ export interface VcViewerOptions {
     /** Concatenated to the end of the module list (extension point). */
     additionalModules?: ModuleDeclaration[];
     /**
-     * Where Enter or Space on a creating palette entry places the element, in diagram coordinates:
-     * the centre of the canvas area the host's chrome leaves free (guide §5.5). Default: the centre
-     * of the visible canvas.
+     * @deprecated Use `freeArea: { center }`; accepted until the next minor release. Given both,
+     * `freeArea` wins.
      */
     freeRectCenter?: (() => Point | undefined) | undefined;
-    /**
-     * Bind Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z and 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;
 }
 /**
  * DI bootstrap and lifecycle shared by Viewer/NavigatedViewer/Modeler. The diagram is

package/dist/VcBaseViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VcBaseViewer.d.ts","sourceRoot":"","sources":["../src/VcBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAI9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACvD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAUD;;;;GAIG;AACH,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,IAAI,SAAS,IAAI,WAAW,CAE3B;IAED,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIvB,mFAAmF;IACnF,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAItC,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAO,GAAG,IAAI;IAIzF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzE;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,aAAa,EAAE;IAmB7D,cAAc,IAAI,kBAAkB;IAIpC,OAAO,IAAI;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAI1B,kDAAkD;IAClD,WAAW,IAAI,IAAI;IAYnB,KAAK,IAAI,IAAI;IAKb,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAMnC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;CAYvB"}
+{"version":3,"file":"VcBaseViewer.d.ts","sourceRoot":"","sources":["../src/VcBaseViewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAIxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,2BAA2B;IAClE,yFAAyF;IACzF,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACxD;AAUD;;;;GAIG;AACH,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,IAAI,SAAS,IAAI,WAAW,CAE3B;IAED,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAIvB,mFAAmF;IACnF,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAItC,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,QAAQ,SAAO,GAAG,IAAI;IAIzF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI;IAIzE;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,aAAa,EAAE;IAmB7D,cAAc,IAAI,kBAAkB;IAIpC,OAAO,IAAI;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;IAI1B,kDAAkD;IAClD,WAAW,IAAI,IAAI;IAYnB,KAAK,IAAI,IAAI;IAKb,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAMnC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/collaborative/CollaborativeValueChain.d.ts

@@ -1,4 +1,4 @@
-import { CollaborativeModeler, ElementsSurface } from '@miragon/modeler-api';
+import { CollaborativeModeler, CollaborativeModelerOptions, ElementsSurface } from '@miragon/modeler-api';
 import { ModuleDeclaration } from 'didi';
 import { Point } from '@miragon/value-chain-schema-model';
 import { Modeler } from '../Modeler.js';
@@ -7,21 +7,26 @@ import { NavigatedViewer } from '../NavigatedViewer.js';
 export declare const VALUE_CHAIN_NOTATION = "value-chain";
 /** What a blank text (a file just created in the explorer) opens as. */
 export declare const BLANK_DOCUMENT_NAME = "New value chain";
-export interface CollaborativeValueChainOptions {
+/**
+ * The contract's factory options (`freeArea`, `fitOnImport`, `undoRedoKeys`, see
+ * `VcViewerOptions`) plus the renderer's own. The viewer ignores the two that need editing.
+ */
+export interface CollaborativeValueChainOptions extends CollaborativeModelerOptions {
     /** Appended to the renderer's own modules (e.g. a host's chrome module). */
     additionalModules?: ModuleDeclaration[] | undefined;
-    /** See `VcViewerOptions.undoRedoKeys` (default true). */
-    undoRedoKeys?: boolean | undefined;
-    /** See `VcViewerOptions.freeRectCenter`. */
+    /**
+     * @deprecated Use `freeArea: { center }`; accepted until the next minor release. Given both,
+     * `freeArea` wins.
+     */
     freeRectCenter?: (() => Point | undefined) | undefined;
 }
 /** The contract surface plus the wrapped diagram for host-specific wiring. */
 export interface CollaborativeValueChainModeler extends CollaborativeModeler {
-    readonly elements: ElementsSurface;
+    readonly elements: ElementsSurface & Required<Pick<ElementsSurface, 'bounds'>>;
     readonly diagram: Modeler | NavigatedViewer;
 }
 /** The editing mount (`meta.editable: true`) of the collaborative-modeler contract. */
 export declare function createCollaborativeModeler(options?: CollaborativeValueChainOptions): CollaborativeValueChainModeler;
 /** The read-only mount (`meta.editable: false`): imports, exports and reveals, never edits. */
-export declare function createCollaborativeViewer(options?: Pick<CollaborativeValueChainOptions, 'additionalModules'>): CollaborativeValueChainModeler;
+export declare function createCollaborativeViewer(options?: CollaborativeValueChainOptions): CollaborativeValueChainModeler;
 //# sourceMappingURL=CollaborativeValueChain.d.ts.map

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,EAEzB,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,MAAM,WAAW,8BAA8B;IAC7C,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,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACxD;AAED,8EAA8E;AAC9E,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC;CAC7C;AASD,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,8BAAmC,GAC3C,8BAA8B,CAShC;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,IAAI,CAAC,8BAA8B,EAAE,mBAAmB,CAAM,GACtE,8BAA8B,CAEhC"}
+{"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"}

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { Modeler } from './Modeler.js';
 export { isOrgUnit, isStep, isVcConnection, isVcElement, isVcShape, type VcConnection, type VcShape, type VcShapeType, } from './model/di-types.js';
 export { vcModelModule, VcElementFactory, VcDiagramElementFactory } from './model/index.js';
 export { vcDrawModule, VcRenderer, chevronPath, chevronPathAt, ellipsePathAt, notchDepth, COLORS, COLOR_OPTIONS, FONT, } from './draw/index.js';
-export { ioModule, VcImporter, VcExporter, saveSVG, svgToPng, blobToBase64, ROOT_ID, } from './io/index.js';
+export { ioModule, VcImporter, VcExporter, type VcImportConfig, saveSVG, svgToPng, blobToBase64, ROOT_ID, } from './io/index.js';
 export { vcBoundsModule, VcBounds } from './bounds/index.js';
 export { BLANK_DOCUMENT_NAME, VALUE_CHAIN_NOTATION, createCollaborativeModeler, createCollaborativeViewer, type CollaborativeValueChainModeler, type CollaborativeValueChainOptions, } from './collaborative/index.js';
 export type { ImportWarning, RootBusinessObject } from './io/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -168,8 +168,12 @@ var Ye = class {
 			this._diagram = new e({
 				canvas: { container: this._container },
 				modules: t,
-				vcPalette: { freeRectCenter: this._options.freeRectCenter },
-				vcKeyboard: { undoRedoKeys: this._options.undoRedoKeys ?? !0 }
+				vcPalette: {
+					freeArea: this._options.freeArea,
+					freeRectCenter: this._options.freeRectCenter
+				},
+				vcKeyboard: { undoRedoKeys: this._options.undoRedoKeys ?? !0 },
+				vcImport: { fitOnImport: this._options.fitOnImport ?? !0 }
 			});
 		}
 		return this._diagram;
@@ -496,16 +500,18 @@ var ot = {
 	elementRegistry;
 	eventBus;
 	vcBounds;
+	config;
 	static $inject = [
 		"canvas",
 		"elementFactory",
 		"vcElementFactory",
 		"elementRegistry",
 		"eventBus",
-		"vcBounds"
+		"vcBounds",
+		"config.vcImport"
 	];
-	constructor(e, t, n, r, i, a) {
-		this.canvas = e, this.elementFactory = t, this.vcElementFactory = n, this.elementRegistry = r, this.eventBus = i, this.vcBounds = a;
+	constructor(e, t, n, r, i, a, o) {
+		this.canvas = e, this.elementFactory = t, this.vcElementFactory = n, this.elementRegistry = r, this.eventBus = i, this.vcBounds = a, this.config = o;
 	}
 	import(e) {
 		let t = [];
@@ -534,7 +540,7 @@ var ot = {
 			let s = this.vcElementFactory.createConnection(a, e, o);
 			this.canvas.addConnection(s, n, i), i += 1;
 		}
-		return this.fitToContent(), this.eventBus.fire("import.render.done", {
+		return this.config?.fitOnImport !== !1 && this.fitToContent(), this.eventBus.fire("import.render.done", {
 			document: e,
 			warnings: t
 		}), t;
@@ -1221,7 +1227,7 @@ var dn = 24, fn = class {
 		};
 	}
 	placeInFreeRect(e) {
-		let t = this.config?.freeRectCenter?.() ?? this.visibleCentre(), n = {
+		let t = this.freeAreaCentre() ?? this.visibleCentre(), n = {
 			x: t.x,
 			y: t.y
 		};
@@ -1229,6 +1235,19 @@ var dn = 24, fn = class {
 		let r = this.modeling.createShape(e, n, this.canvas.getRootElement());
 		this.selection.select(r), this.canvas.focus(), this.injector.get("directEditing", !1)?.activate(r);
 	}
+	freeAreaCentre() {
+		let e = this.config?.freeArea;
+		return e?.center ? e.center() : e?.insets ? this.centreWithin(e.insets()) : this.config?.freeRectCenter?.();
+	}
+	centreWithin(e) {
+		let { width: t, height: n } = this.canvas.getSize();
+		if (!(t > 0 && n > 0)) return;
+		let r = (e, t, n) => t + n < e ? t + (e - t - n) / 2 : e / 2, { x: i, y: a, scale: o } = this.canvas.viewbox();
+		return {
+			x: i + r(t, e.left, e.right) / o,
+			y: a + r(n, e.top, e.bottom) / o
+		};
+	}
 	visibleCentre() {
 		let { x: e, y: t, width: n, height: r } = this.canvas.viewbox();
 		return {
@@ -1494,12 +1513,11 @@ var W = {
 		}), n.on([
 			"element.mousedown",
 			"drag.init",
-			"canvas.viewbox.changing",
 			"autoPlace.start",
 			"popupMenu.open"
 		], () => {
 			e.isActive() && e.complete();
-		}), n.on("commandStack.changed", () => {
+		}), n.on("canvas.viewbox.changed", () => this.followView()), n.on("commandStack.changed", () => {
 			e.isActive() && e.cancel();
 		}), n.on("diagram.destroy", 1500, () => {
 			clearTimeout(this.resumeTimer), this.suspended = null, e.isActive() && e.cancel();
@@ -1535,6 +1553,19 @@ var W = {
 		let r = n.ownerDocument.getSelection();
 		r?.selectAllChildren(n), r?.collapseToEnd();
 	}
+	followView() {
+		let e = this.directEditing._active, t = this.directEditing._textbox;
+		if (!e || !t) return;
+		let n = this.activate(e.element);
+		if (!n) return;
+		let { x: r, y: i, width: a, height: o } = n.bounds;
+		Object.assign(t.parent.style, {
+			left: `${r}px`,
+			top: `${i}px`,
+			width: `${a}px`,
+			height: `${o}px`
+		}), t.content.style.fontSize = n.style?.fontSize ?? "", e.context.bounds = n.bounds;
+	}
 	activate(e) {
 		if (!S(e)) return;
 		let t = e, n = this.canvas.getAbsoluteBBox(t), r = this.canvas.zoom(), i = (w(t) ? 12 : at(t.width, t.height)) * r;
@@ -1760,6 +1791,7 @@ function Un(e = {}) {
 	return qn(new Bn({
 		...Gn(e),
 		undoRedoKeys: e.undoRedoKeys ?? !0,
+		freeArea: e.freeArea,
 		freeRectCenter: e.freeRectCenter
 	}), !0);
 }
@@ -1770,7 +1802,8 @@ function Gn(e) {
 	return {
 		width: "100%",
 		height: "100%",
-		additionalModules: e.additionalModules ?? []
+		additionalModules: e.additionalModules ?? [],
+		fitOnImport: e.fitOnImport ?? !0
 	};
 }
 function Kn(e) {
@@ -1797,6 +1830,18 @@ function qn(e, t) {
 			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;
+				let t = i.get(e);
+				if (!S(t)) return;
+				let { x: n, y: r, width: a, height: o } = t;
+				return {
+					x: n,
+					y: r,
+					width: a,
+					height: o
+				};
 			}
 		},
 		diagram: e,