orcasvn-react-diagrams 0.2.4 → 0.2.6

package/CHANGELOG.md

@@ -2,11 +2,52 @@
 
 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
+- Auto-layout `grid` mode with template rows/columns (`gridTemplate`) and weighted track sizing support.
+- Auto-layout parent resize policy (`autoResize`) with `grow` and `grow-shrink` modes.
+- Explicit auto-layout child size aliases (`childMinWidth`, `childMaxWidth`, `childMinHeight`, `childMaxHeight`).
+- Grid auto-layout child resize behavior that locks horizontal child resizing while preserving vertical child resizing and parent resize responsiveness.
+- Direct resize handling for non-manual layout parents that preserves explicit resized parent bounds for the resize cycle before child reflow.
+- Optional redraw-time link route refresh policy (`linkRouteRefreshPolicy`) for two-endpoint-change checks.
+- Cross-parent first common-ancestor corridor preference for auto-routed links across parent branches.
+- Optional random link color assignment policy (`linkColorPoolPolicy`) with built-in default 20-color pool.
+
+### Fixed
+- Stabilized `element-hover` nested hover-control ownership near child boundaries to prevent child/parent control flicker.
+
+### Docs
+- Updated `README.md` release highlights for `v0.2.5`.
+- Updated public API and machine-readable contract docs for new `v0.2.5` config and layout options.
+
 ## [0.2.4] - 2026-05-06
 
 ### Added
 - Directional parent-child attach mode support for hierarchy-aware linking flows.
-- Port position-limit normalization coverage in DisplayBox demos for add/load/move entry points.
 
 ### Changed
 - Unified child-port movement restrictions across all engine entry points (move, add, load, link-session creation, resize reprojection).
@@ -30,7 +71,6 @@ All notable changes to this project are documented in this file.
 
 ### Changed
 - Asymmetric SVG-path multi-anchor transform/orientation behavior for deterministic border-side placement.
-- DisplayBox demo coverage consolidated for auto-layout and vertex-control scenarios.
 - Vertex-control session logs in demo flows improved for collapse/scroll stability.
 
 ### Fixed
@@ -50,7 +90,6 @@ All notable changes to this project are documented in this file.
 - Discrete port anchor constraints with anchor-based movement support.
 - Shape hover controls for edge and vertex targets with configurable trigger modes.
 - Ellipse midpoint control enumeration support.
-- DisplayBox demos for discrete anchors, hover controls, and ellipse midpoints.
 
 ### Changed
 - Refactored built-in shape behavior to class-based implementations.
@@ -66,4 +105,3 @@ All notable changes to this project are documented in this file.
 - Improved shape-aware endpoint edge detection for link routing.
 
 ### Docs
-- Refreshed DisplayBox verification coverage for shape class and rotation behavior.

package/README.md

@@ -30,38 +30,21 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.4)
-
-- Includes all completed `v0.2.1`, `v0.2.2`, and `v0.2.3` work, plus `v0.2.4` updates.
-- `v0.2.4` port-constraint and movement consistency updates:
-  - unified child-port restriction enforcement across move/add/load/link-session/resize entry points
-  - deterministic border-host constraint resolution when `positionLimits` are also active
-  - default invalid child-port positions now normalize consistently in add and load flows
-- `v0.2.4` routing and hierarchy updates:
-  - directional parent-child attach mode support
-  - sibling external and parent-child stub routing rule refinements
-  - manual link points now translate with subtree moves
-- `v0.2.4` demo coverage updates:
-  - expanded port-position limits scenarios including border + limits and default-position normalization
-  - refreshed parent/child internal-external anchor coverage
-  - corrected nested multi-anchor routing demonstration stability
-- 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

@@ -29,7 +29,9 @@
         "onElementShapeHoverControlInteraction": "(event: ElementShapeHoverControlInteractionEvent) => void",
         "onElementShapeHoverControlActivated": "(event: ElementShapeHoverControlActivationEvent) => void",
         "onChange": "(event: EngineChangeEvent) => void",
-        "onSelection": "(event: EngineSelectionEvent) => void"
+        "onSelection": "(event: EngineSelectionEvent) => void",
+        "linkRouteRefreshPolicy": "LinkRouteRefreshPolicy",
+        "linkColorPoolPolicy": "LinkColorPoolPolicy"
       },
       "defaults": {
         "width": 900,
@@ -46,7 +48,9 @@
         "router": "RouterStrategy",
         "snapper": "SnapStrategy",
         "shapeRegistry": "ShapeRegistry",
-        "textMeasurer": "TextMeasurer"
+        "textMeasurer": "TextMeasurer",
+        "linkRouteRefreshPolicy": "LinkRouteRefreshPolicy",
+        "linkColorPoolPolicy": "LinkColorPoolPolicy"
       },
       "defaults": {
         "scheduler": "RenderScheduler",
@@ -103,6 +107,11 @@
         "moveMode",
         "anchorCenter",
         "orientToHostBorder",
+        "placementPoint",
+        "linkAttachPoint",
+        "externalLinkAttachPoint",
+        "internalLinkAttachPoint",
+        "rotationPivot",
         "currentAnchorId"
       ],
       "defaults": {
@@ -139,6 +148,7 @@
         "style",
         "ownerId",
         "layout",
+        "interaction",
         "displayContent",
         "displayOffset",
         "displayClipSize"
@@ -151,12 +161,33 @@
       "padding": 12,
       "gap": 12,
       "align": "center"
+    },
+    "elementLayout": {
+      "mode": "'manual' | 'horizontal' | 'vertical' | 'grid'",
+      "optional": [
+        "padding",
+        "gap",
+        "align",
+        "autoResize",
+        "gridTemplate",
+        "gridChildWidthResizeEnabled",
+        "childFitMainAxis",
+        "childFitCrossAxis",
+        "childMinWidth",
+        "childMaxWidth",
+        "childMinHeight",
+        "childMaxHeight",
+        "childFitMinSize",
+        "childFitMaxSize",
+        "labelReservedSpace"
+      ]
     }
   },
   "additionalContracts": {
     "portMovementPolicy": {
       "moveMode": "'free' | 'inside' | 'border' | 'anchors'",
-      "anchorConstraint": "PortAnchorConstraint"
+      "anchorConstraint": "PortAnchorConstraint",
+      "positionLimits": "PortPositionLimits"
     },
     "portAnchorConstraint": {
       "preset": "'vertices' | 'cardinal'",
@@ -170,6 +201,14 @@
       "maxLines": "number",
       "fixedSize": "Size"
     },
+    "textInteractionPolicy": {
+      "movable": "boolean",
+      "editable": "boolean",
+      "defaults": {
+        "movable": true,
+        "editable": true
+      }
+    },
     "shapeHoverControls": {
       "targetKinds": [
         "vertex",
@@ -187,6 +226,44 @@
         "drag-move",
         "drag-end"
       ]
+    },
+    "linkRouteRefreshPolicy": {
+      "mode": "'mutation-only' | 'redraw-two-endpoint-change'",
+      "includeManual": "boolean"
+    },
+    "linkColorPoolPolicy": {
+      "enabled": "boolean",
+      "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",
+      "pixelRatio": "number",
+      "x": "number",
+      "y": "number",
+      "width": "number",
+      "height": "number",
+      "fitToContent": "boolean | { padding?: number }"
     }
   },
   "handleMethods": {
@@ -223,6 +300,13 @@
       "render"
     ],
     "editorOnly": [
+      "startLinkFromPort",
+      "updateLinkPreview",
+      "completeLinkToPort",
+      "completeLinkToElement",
+      "cancelLink",
+      "zoomToFitElements",
+      "exportImage",
       "resize",
       "setElementShapeHoverControls",
       "destroy"
@@ -243,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-04-25"
+  "updatedAt": "2026-05-14"
 }