orcasvn-react-diagrams 0.2.0 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@ Diagram editor library with a Konva-backed editor (`createDiagramEditor`) and an
 npm install orcasvn-react-diagrams
 ```
 
-Node engine for this repository/toolchain: `>=18.17.0 <19.0.0`.
+Node engine for this repository/toolchain: `>=20.17.0 <21.0.0`.
 
 ## Quick Start
 
@@ -30,6 +30,27 @@ editor.addElement({
 });
 ```
 
+## Release Highlights (v0.2.2)
+
+- Includes all completed `v0.2.1` work plus `v0.2.2` additions in one release.
+- Shape system upgrade:
+  - class-based built-in shape behaviors
+  - runtime removal of `boundaryKind` branching
+  - additive rotation (`baseRotation` + instance rotation style)
+- Port movement enhancements:
+  - shape-aware border projection
+  - optional anchor-constrained movement (`portMovement.moveMode = 'anchors'`)
+  - orientation support with host-border normals and resize reprojection
+- Shape hover controls:
+  - generic control definitions with `targetKind` (`edge`, `vertex`, `midpoint`, `ellipse-midpoint`)
+  - trigger modes (`element-hover`, `target-hover`)
+  - interaction callbacks for click and drag lifecycle
+- Text layout improvements:
+  - owner/fixed bounds modes, wrap and overflow controls, and layout padding
+  - `textUpdated` lifecycle event with rendered display content
+- Additional lifecycle events:
+  - `portDeleted`, `linkDeleted`, `textDeleted`
+
 ## API Docs
 
 - Human-first docs index: `docs/INDEX.md`

package/ai/api-contract.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "1.1.0",
+  "schemaVersion": "1.2.0",
   "typeSource": "src/api/types.ts",
   "entrypoints": [
     {
@@ -25,6 +25,9 @@
         "elementShapes": "SimpleShape[]",
         "portShapes": "SimpleShape[]",
         "panKey": "'Control' | 'Shift' | 'Alt' | 'Meta'",
+        "elementShapeHoverControls": "ElementShapeHoverControls",
+        "onElementShapeHoverControlInteraction": "(event: ElementShapeHoverControlInteractionEvent) => void",
+        "onElementShapeHoverControlActivated": "(event: ElementShapeHoverControlActivationEvent) => void",
         "onChange": "(event: EngineChangeEvent) => void",
         "onSelection": "(event: EngineSelectionEvent) => void"
       },
@@ -77,7 +80,8 @@
         "parentId",
         "moveMode",
         "anchorCenter",
-        "layout"
+        "layout",
+        "portMovement"
       ],
       "defaults": {
         "portIds": [],
@@ -97,11 +101,14 @@
         "style",
         "textIds",
         "moveMode",
-        "anchorCenter"
+        "anchorCenter",
+        "orientToHostBorder",
+        "currentAnchorId"
       ],
       "defaults": {
         "textIds": [],
-        "anchorCenter": true
+        "anchorCenter": true,
+        "orientToHostBorder": true
       }
     },
     "linkData": {
@@ -130,7 +137,11 @@
       "optional": [
         "size",
         "style",
-        "ownerId"
+        "ownerId",
+        "layout",
+        "displayContent",
+        "displayOffset",
+        "displayClipSize"
       ],
       "defaults": {
         "ownerId": null
@@ -142,6 +153,42 @@
       "align": "center"
     }
   },
+  "additionalContracts": {
+    "portMovementPolicy": {
+      "moveMode": "'free' | 'inside' | 'border' | 'anchors'",
+      "anchorConstraint": "PortAnchorConstraint"
+    },
+    "portAnchorConstraint": {
+      "preset": "'vertices' | 'cardinal'",
+      "fallback": "'nearest'"
+    },
+    "textLayout": {
+      "boundsMode": "'owner-width' | 'owner-box' | 'fixed'",
+      "wrap": "'none' | 'word' | 'char'",
+      "overflow": "'clip' | 'ellipsis-end' | 'ellipsis-middle' | 'ellipsis-start'",
+      "padding": "number",
+      "maxLines": "number",
+      "fixedSize": "Size"
+    },
+    "shapeHoverControls": {
+      "targetKinds": [
+        "vertex",
+        "edge",
+        "midpoint",
+        "ellipse-midpoint"
+      ],
+      "visibilityTriggers": [
+        "element-hover",
+        "target-hover"
+      ],
+      "interactionEventTypes": [
+        "click",
+        "drag-start",
+        "drag-move",
+        "drag-end"
+      ]
+    }
+  },
   "handleMethods": {
     "shared": [
       "load",
@@ -177,6 +224,7 @@
     ],
     "editorOnly": [
       "resize",
+      "setElementShapeHoverControls",
       "destroy"
     ]
   },
@@ -196,6 +244,10 @@
     "elementMoved": "ElementMovedEvent",
     "elementResized": "ElementResizedEvent",
     "elementDeleted": "ElementDeletedEvent",
+    "portDeleted": "PortDeletedEvent",
+    "linkDeleted": "LinkDeletedEvent",
+    "textDeleted": "TextDeletedEvent",
+    "textUpdated": "TextUpdatedEvent",
     "elementSelected": "ElementSelectedEvent",
     "elementLinkStarted": "ElementLinkStartedEvent",
     "elementLinkConnecting": "ElementLinkConnectingEvent",

package/ai/invariants.json

@@ -7,6 +7,7 @@
   ],
   "defaults": {
     "port.anchorCenter": true,
+    "port.orientToHostBorder": true,
     "link.routing": "auto"
   },
   "entityRules": {
@@ -16,7 +17,8 @@
     ],
     "port": [
       "port positions are relative to element",
-      "moving a port can be constrained by moveMode/moveAxis/moveBounds"
+      "moving a port can be constrained by moveMode/moveAxis/moveBounds",
+      "element portMovement policy can enforce anchor-constrained movement with discrete shape anchors"
     ],
     "link": [
       "manual routing preserves interior bend points on endpoint updates",
@@ -24,7 +26,8 @@
     ],
     "text": [
       "owner-bound text stores owner-relative position",
-      "orphan owner references are tolerated as standalone world text"
+      "orphan owner references are tolerated as standalone world text",
+      "displayContent/displayOffset/displayClipSize may be derived from text layout rules"
     ]
   },
   "eventRules": [
@@ -38,4 +41,3 @@
     "src/renderer/konva/__tests__/KonvaInteraction.test.ts"
   ]
 }
-

package/ai/manifest.json

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