orcasvn-react-diagrams 0.2.11 → 0.2.12

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.12] - 2026-06-26
+
+### Added
+- Optional `onCreateLinkTargetPort(context)` editor config callback for customizing the auto-created destination port when a link completes onto an element body.
+- Supported link labels through ordinary link-owned `TextData` (`ownerId = link.id`) without introducing a separate `LinkData.label` field.
+
+### Changed
+- Link-to-element placeholder preview, pointer-drop commit, and programmatic `completeLinkToElement(...)` now share the same target-port draft resolution and normalization flow before `elementLinkConnecting` runs.
+- Link-owned text now behaves as an explicit public label contract: midpoint-relative positioning is preserved across drag, reroute, export-fit bounds, and link-removal cascade deletion.
+
+### Docs
+- Updated release highlights, API/integration docs, state invariants, and machine-readable contract metadata for `v0.2.12`.
+
 ## [0.2.11] - 2026-06-20
 
 ### Added

package/README.md

@@ -30,13 +30,17 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.11)
-
-- Includes all completed `v0.2.1` through `v0.2.10` work, plus `v0.2.11` updates.
-- `v0.2.11` link color pool load-time fill:
-  - `linkColorPoolPolicy.assignOnLoadWhenMissingStroke = true` backfills loaded links whose `style.stroke` is missing, `null`, or blank after trimming
-  - explicit non-empty loaded `style.stroke` values are preserved exactly as loaded
-  - the fill uses normalized custom `colors` when provided, otherwise the built-in 20-color pool
+## 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
 
 ## API Docs
 

package/ai/api-contract.json

@@ -28,6 +28,7 @@
         "elementShapeHoverControls": "ElementShapeHoverControls",
         "onElementShapeHoverControlInteraction": "(event: ElementShapeHoverControlInteractionEvent) => void",
         "onElementShapeHoverControlActivated": "(event: ElementShapeHoverControlActivationEvent) => void",
+        "onCreateLinkTargetPort": "(context: LinkTargetPortCreationContext) => Partial<LinkTargetPortDraft> | void",
         "onChange": "(event: EngineChangeEvent) => void",
         "onSelection": "(event: EngineSelectionEvent) => void",
         "linkRouteRefreshPolicy": "LinkRouteRefreshPolicy",
@@ -138,6 +139,11 @@
       "defaults": {
         "routing": "auto",
         "textIds": []
+      },
+      "ownershipSemantics": {
+        "linkLabels": "Represent link labels as TextData with ownerId = link.id",
+        "linkTextIds": "LinkData.textIds is the owner-side index only",
+        "dedicatedLabelField": "No LinkData.label or LinkData.labels field"
       }
     },
     "textData": {
@@ -158,6 +164,12 @@
       ],
       "defaults": {
         "ownerId": null
+      },
+      "ownershipSemantics": {
+        "elementOwnedPosition": "owner-relative local position",
+        "portOwnedPosition": "owner-relative local position",
+        "linkOwnedPosition": "local offset from the owning link midpoint",
+        "missingOwner": "falls back to standalone world-position text"
       }
     },
     "elementLayoutDefaults": {
@@ -202,7 +214,8 @@
       "overflow": "'clip' | 'ellipsis-end' | 'ellipsis-middle' | 'ellipsis-start'",
       "padding": "number",
       "maxLines": "number",
-      "fixedSize": "Size"
+      "fixedSize": "Size",
+      "linkOwnedDefault": "link-owned text does not implicitly default to owner-width or owner-box bounds"
     },
     "textInteractionPolicy": {
       "movable": "boolean",
@@ -262,6 +275,35 @@
       "assignOnLoadWhenMissingStroke": "boolean",
       "defaultPoolSize": 20
     },
+    "linkTargetPortCreation": {
+      "phase": "'preview' | 'commit'",
+      "draft": "Omit<PortData, 'id' | 'elementId'>",
+      "context": {
+        "phase": "LinkTargetPortCreationPhase",
+        "pointer": "Point",
+        "sourcePortId": "string",
+        "sourceElementId": "string",
+        "targetElementId": "string",
+        "sourcePort": "PortData",
+        "targetElement": "ElementData",
+        "defaultPort": "LinkTargetPortDraft"
+      },
+      "result": "Partial<LinkTargetPortDraft> | void",
+      "behavior": [
+        "runs only for link-to-element completion, not port-to-port linking or direct addPortToElement",
+        "preview and commit both invoke the callback before final target-port normalization against the target element",
+        "elementLinkConnecting remains the only cancellation surface"
+      ]
+    },
+    "linkLabelOwnership": {
+      "creation": "Create a link label with addText({ ownerId: linkId, ... })",
+      "storage": "Persist TextData.position as midpoint-relative local offset for link-owned text",
+      "rerouteBehavior": "Keep the stored local offset and recompute world position from the latest link midpoint",
+      "events": [
+        "textUpdated",
+        "textDeleted"
+      ]
+    },
     "viewportFitOptions": {
       "padding": "number",
       "minZoom": "number",

package/ai/manifest.json

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