orcasvn-react-diagrams 0.2.12 → 0.2.13

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.13] - 2026-07-07
+
+### Added
+- Host-callable `focusElement(elementId, options?)` editor helper for centering one target element and optionally applying an explicit zoom.
+- Observational `elementDoubleClick` event for element-body double click / double tap without replacing ordinary click selection or text-edit precedence.
+- Cancellable `elementDeleting`, `portDeleting`, `linkDeleting`, and `textDeleting` lifecycle events that fire before direct, selection-driven, or cascade removals commit.
+
+### Changed
+- Delete requests now evaluate the full cascade plan before mutation commit, so a veto from any dependent `...Deleting` handler aborts that root delete request while unrelated selected roots can still continue deleting.
+- `focusElement(...)` resolves nested and hidden elements by explicit id, preserves the current zoom by default, and uses the same viewport patch path as `setViewport(...)`.
+
+### Docs
+- Updated release highlights, architecture/API/event docs, integration guidance, and machine-readable contract/invariant metadata for `v0.2.13`.
+
 ## [0.2.12] - 2026-06-26
 
 ### Added

package/README.md

@@ -30,17 +30,21 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.12)
-
-- Includes all completed `v0.2.1` through `v0.2.11` work, plus `v0.2.12` updates.
-- `v0.2.12` link labels via owned text:
-  - create a link label with `addText({ ..., ownerId: linkId })`
-  - link-owned text is stored midpoint-relative, so labels stay attached when the link reroutes or endpoints move
-  - no separate `LinkData.label` or `LinkData.labels` field is required
-- `v0.2.12` link-created target port customization:
-  - `createDiagramEditor({ onCreateLinkTargetPort })` lets hosts shape auto-created destination ports for link-to-element completion
-  - the callback runs for both pointer drag and programmatic `completeLinkToElement(...)`, in `preview` and `commit` phases
-  - `elementLinkConnecting` remains the cancellation surface; the callback customizes the target-port draft only
+## Release Highlights (v0.2.13)
+
+- Includes all completed `v0.2.1` through `v0.2.12` work, plus `v0.2.13` updates.
+- `v0.2.13` delete lifecycle guards:
+  - subscribe to `elementDeleting`, `portDeleting`, `linkDeleting`, or `textDeleting` to inspect a delete request before it commits
+  - each guard receives `trigger`, `root`, `cancel()`, and `cancelled` so hosts can veto direct, selection, or cascade removals
+  - a veto aborts the current root delete request without preventing unrelated selected roots from continuing
+- `v0.2.13` viewport navigation helper:
+  - `focusElement(elementId, options?)` centers one target element by id
+  - current zoom is preserved by default, or hosts may pass `zoom`
+  - nested and hidden elements still resolve through the same world-position logic as the rest of the editor
+- `v0.2.13` element double click event:
+  - subscribe to `elementDoubleClick` to observe double click / double tap on element bodies
+  - ordinary click selection still works as before
+  - text double click continues to prioritize built-in text editing
 
 ## API Docs
 

package/ai/api-contract.json

@@ -304,6 +304,13 @@
         "textDeleted"
       ]
     },
+    "focusElementOptions": {
+      "zoom": "number",
+      "behavior": [
+        "omitted zoom preserves the current viewport zoom",
+        "provided zoom is clamped to the same normalized fit-zoom bounds"
+      ]
+    },
     "viewportFitOptions": {
       "padding": "number",
       "minZoom": "number",
@@ -323,6 +330,40 @@
       "beforeGridTemplate": "number[]",
       "afterGridTemplate": "number[]"
     },
+    "elementDoubleClickEvent": {
+      "elementId": "string",
+      "pointer": "EnginePointerInfo",
+      "isMulti": "boolean"
+    },
+    "deletionLifecycle": {
+      "trigger": "'direct' | 'selection' | 'cascade'",
+      "root": {
+        "entity": "'element' | 'port' | 'link' | 'text'",
+        "id": "string"
+      },
+      "sharedFields": [
+        "trigger",
+        "root",
+        "cancel",
+        "cancelled"
+      ],
+      "elementDeleting": {
+        "elementId": "string"
+      },
+      "portDeleting": {
+        "portId": "string",
+        "elementId": "string"
+      },
+      "linkDeleting": {
+        "linkId": "string",
+        "sourcePortId": "string",
+        "targetPortId": "string"
+      },
+      "textDeleting": {
+        "textId": "string",
+        "ownerId": "string | null"
+      }
+    },
     "diagramImageExportOptions": {
       "mimeType": "string",
       "quality": "number",
@@ -374,6 +415,7 @@
       "completeLinkToElement",
       "cancelLink",
       "zoomToFitElements",
+      "focusElement",
       "exportImage",
       "resize",
       "setElementShapeHoverControls",
@@ -392,13 +434,18 @@
     "portMoved": "PortMovedEvent",
     "portSelected": "PortSelectedEvent",
     "elementClick": "ElementPointerEvent",
+    "elementDoubleClick": "ElementDoubleClickEvent",
     "elementDragged": "ElementDropEvent",
     "elementMoved": "ElementMovedEvent",
     "elementResized": "ElementResizedEvent",
     "gridLayoutChanged": "GridLayoutChangedEvent",
+    "elementDeleting": "ElementDeletingEvent",
     "elementDeleted": "ElementDeletedEvent",
+    "portDeleting": "PortDeletingEvent",
     "portDeleted": "PortDeletedEvent",
+    "linkDeleting": "LinkDeletingEvent",
     "linkDeleted": "LinkDeletedEvent",
+    "textDeleting": "TextDeletingEvent",
     "textDeleted": "TextDeletedEvent",
     "textUpdated": "TextUpdatedEvent",
     "elementSelected": "ElementSelectedEvent",

package/ai/invariants.json

@@ -28,10 +28,12 @@
     "link": [
       "link visible-state requires both endpoint ports to remain visible",
       "manual routing preserves interior bend points on endpoint updates",
-      "auto routing normalizes first/last points to source/target port world positions"
+      "auto routing normalizes first/last points to source/target port world positions",
+      "deleting a link removes any link-owned text"
     ],
     "text": [
       "owner-bound text stores owner-relative position",
+      "link-owned text stores position as an offset from the owning link midpoint",
       "owned text visible-state follows its resolved owner visibility",
       "orphan owner references are tolerated as standalone world text",
       "displayContent/displayOffset/displayClipSize may be derived from text layout rules"
@@ -41,7 +43,9 @@
     "mutations emit change with patches and full state snapshot",
     "setSelection/toggleSelection normalize away hidden element bodies, direct-owned hidden artifacts, and selectable=false element ids before emitting selection",
     "setSelection emits selection plus derived selected entity events",
-    "setViewport emits viewport patch without immediate render"
+    "setViewport emits viewport patch without immediate render",
+    "delete mutators emit cancellable elementDeleting/portDeleting/linkDeleting/textDeleting before commit and matching deleted events after successful removal",
+    "deleteSelection can skip a vetoed selected root while continuing unrelated selected roots"
   ],
   "verificationTests": [
     "src/models/__tests__/DiagramModel.test.ts",

package/ai/manifest.json

@@ -30,5 +30,5 @@
     "analysis/White paper/Overview.md",
     "analysis/White paper/Requirements-Functional.md"
   ],
-  "updatedAt": "2026-06-26"
+  "updatedAt": "2026-07-07"
 }