orcasvn-react-diagrams 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.6] - 2026-05-14
+
+### Added
+- Editor viewport helper `zoomToFitElements(options?)` with `padding`, `minZoom`, and `maxZoom` fit controls.
+- Grid auto-layout opt-in child width topology editing through `layout.gridChildWidthResizeEnabled`.
+- Dedicated `gridLayoutChanged` host event for resize-driven grid row split/redistribution changes.
+- Per-text interaction policy via `TextData.interaction` with `movable` and `editable` controls for built-in text behavior.
+
+### Changed
+- Grid auto-layout now keeps overflow rows on the established fallback model while deriving row occupancy from flat slot templates.
+- Partial grid rows keep proportional occupied width when children are added, and direct child move/resize relayout now preserves parent width unless topology actually changes.
+- Resize-handle interaction now applies bounds changes directly without routing through move semantics.
+- Auto routing now preserves endpoint-host interior avoidance for offset attach anchors by treating projected border-equivalent endpoints like boundary endpoints.
+- Built-in text drag and built-in double-click/tap editing now respect per-text interaction policy while leaving programmatic `moveTextTo(...)` and `updateText(...)` unchanged.
+
+### Fixed
+- Prevented dramatic grid parent width growth when adding children into partially occupied derived rows.
+- Prevented resize gestures that update top-left position from emitting move-specific behavior/events.
+
+### Docs
+- Updated `README.md` release highlights for `v0.2.6`.
+- Updated public API and machine-readable contract docs for `zoomToFitElements`, `ViewportFitOptions`, grid child width resize policy, `gridLayoutChanged`, and per-text interaction policy.
+
 ## [0.2.5] - 2026-05-10
 
 ### Added

package/README.md

@@ -30,40 +30,21 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.5)
-
-- Includes all completed `v0.2.1` through `v0.2.4` work, plus `v0.2.5` updates.
-- `v0.2.5` auto-layout updates:
-  - new `grid` mode with template rows/columns and weighted track layouts
-  - parent `autoResize` policy (`grow` and `grow-shrink`)
-  - explicit child size aliases (`childMinWidth`, `childMaxWidth`, `childMinHeight`, `childMaxHeight`)
-  - grid-child horizontal resize lock while preserving vertical resize and parent resize responsiveness
-- `v0.2.5` routing updates:
-  - cross-parent links now prefer first common-ancestor corridor travel
-  - optional redraw-time reroute checks when both link endpoints changed (`linkRouteRefreshPolicy`)
-- `v0.2.5` styling update:
-  - optional random link stroke assignment from configurable color pools (`linkColorPoolPolicy`)
-- `v0.2.5` interaction update:
-  - stabilized nested `element-hover` controls near child boundaries to reduce child/parent flicker
-- `v0.2.5` demo coverage updates:
-  - expanded DisplayBox scenarios for grid auto-layout behaviors, corridor routing, redraw policy, and color-pool link creation
-- 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`
+## Release Highlights (v0.2.6)
+
+- Includes all completed `v0.2.1` through `v0.2.5` work, plus `v0.2.6` updates.
+- `v0.2.6` viewport update:
+  - new `editor.zoomToFitElements(options?)` helper for centered fit-to-elements navigation
+  - additive `ViewportFitOptions` with `padding`, `minZoom`, and `maxZoom`
+- `v0.2.6` grid auto-layout updates:
+  - opt-in grid child width topology editing via `layout.gridChildWidthResizeEnabled`
+  - dedicated `gridLayoutChanged` event for resize-driven row split/redistribution
+  - proportional partial-row parent sizing on child add, with stable parent width on child move/resize relayout
+- `v0.2.6` routing update:
+  - offset external/internal attach anchors now preserve endpoint-host interior avoidance through projected boundary metadata
+- `v0.2.6` interaction update:
+  - resize handle drags no longer route through move semantics before resize is applied
+  - per-text interaction policy can suppress built-in drag and/or built-in editing with `TextData.interaction`
 
 ## API Docs
 

package/ai/api-contract.json

@@ -107,6 +107,11 @@
         "moveMode",
         "anchorCenter",
         "orientToHostBorder",
+        "placementPoint",
+        "linkAttachPoint",
+        "externalLinkAttachPoint",
+        "internalLinkAttachPoint",
+        "rotationPivot",
         "currentAnchorId"
       ],
       "defaults": {
@@ -143,6 +148,7 @@
         "style",
         "ownerId",
         "layout",
+        "interaction",
         "displayContent",
         "displayOffset",
         "displayClipSize"
@@ -164,6 +170,7 @@
         "align",
         "autoResize",
         "gridTemplate",
+        "gridChildWidthResizeEnabled",
         "childFitMainAxis",
         "childFitCrossAxis",
         "childMinWidth",
@@ -179,7 +186,8 @@
   "additionalContracts": {
     "portMovementPolicy": {
       "moveMode": "'free' | 'inside' | 'border' | 'anchors'",
-      "anchorConstraint": "PortAnchorConstraint"
+      "anchorConstraint": "PortAnchorConstraint",
+      "positionLimits": "PortPositionLimits"
     },
     "portAnchorConstraint": {
       "preset": "'vertices' | 'cardinal'",
@@ -193,6 +201,14 @@
       "maxLines": "number",
       "fixedSize": "Size"
     },
+    "textInteractionPolicy": {
+      "movable": "boolean",
+      "editable": "boolean",
+      "defaults": {
+        "movable": true,
+        "editable": true
+      }
+    },
     "shapeHoverControls": {
       "targetKinds": [
         "vertex",
@@ -220,6 +236,25 @@
       "colors": "string[]",
       "defaultPoolSize": 20
     },
+    "viewportFitOptions": {
+      "padding": "number",
+      "minZoom": "number",
+      "maxZoom": "number",
+      "defaults": {
+        "padding": 24,
+        "minZoom": 0.2,
+        "maxZoom": 3
+      }
+    },
+    "gridLayoutChangedEvent": {
+      "parentId": "string",
+      "triggerChildId": "string",
+      "reason": "'child-resize-split' | 'child-resize-redistribute'",
+      "beforeRows": "{ childIds: string[] }[]",
+      "afterRows": "{ childIds: string[] }[]",
+      "beforeGridTemplate": "number[]",
+      "afterGridTemplate": "number[]"
+    },
     "diagramImageExportOptions": {
       "mimeType": "string",
       "quality": "number",
@@ -270,6 +305,7 @@
       "completeLinkToPort",
       "completeLinkToElement",
       "cancelLink",
+      "zoomToFitElements",
       "exportImage",
       "resize",
       "setElementShapeHoverControls",
@@ -291,6 +327,7 @@
     "elementDragged": "ElementDropEvent",
     "elementMoved": "ElementMovedEvent",
     "elementResized": "ElementResizedEvent",
+    "gridLayoutChanged": "GridLayoutChangedEvent",
     "elementDeleted": "ElementDeletedEvent",
     "portDeleted": "PortDeletedEvent",
     "linkDeleted": "LinkDeletedEvent",

package/ai/manifest.json

@@ -30,5 +30,5 @@
     "analysis/White paper/Overview.md",
     "analysis/White paper/Requirements-Functional.md"
   ],
-  "updatedAt": "2026-05-10"
+  "updatedAt": "2026-05-14"
 }