orcasvn-react-diagrams 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -2,11 +2,29 @@
 
 All notable changes to this project are documented in this file.
 
+## [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 +48,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 +67,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 +82,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,21 +30,23 @@ 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
+## 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

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",
@@ -151,6 +155,25 @@
       "padding": 12,
       "gap": 12,
       "align": "center"
+    },
+    "elementLayout": {
+      "mode": "'manual' | 'horizontal' | 'vertical' | 'grid'",
+      "optional": [
+        "padding",
+        "gap",
+        "align",
+        "autoResize",
+        "gridTemplate",
+        "childFitMainAxis",
+        "childFitCrossAxis",
+        "childMinWidth",
+        "childMaxWidth",
+        "childMinHeight",
+        "childMaxHeight",
+        "childFitMinSize",
+        "childFitMaxSize",
+        "labelReservedSpace"
+      ]
     }
   },
   "additionalContracts": {
@@ -187,6 +210,25 @@
         "drag-move",
         "drag-end"
       ]
+    },
+    "linkRouteRefreshPolicy": {
+      "mode": "'mutation-only' | 'redraw-two-endpoint-change'",
+      "includeManual": "boolean"
+    },
+    "linkColorPoolPolicy": {
+      "enabled": "boolean",
+      "colors": "string[]",
+      "defaultPoolSize": 20
+    },
+    "diagramImageExportOptions": {
+      "mimeType": "string",
+      "quality": "number",
+      "pixelRatio": "number",
+      "x": "number",
+      "y": "number",
+      "width": "number",
+      "height": "number",
+      "fitToContent": "boolean | { padding?: number }"
     }
   },
   "handleMethods": {
@@ -223,6 +265,12 @@
       "render"
     ],
     "editorOnly": [
+      "startLinkFromPort",
+      "updateLinkPreview",
+      "completeLinkToPort",
+      "completeLinkToElement",
+      "cancelLink",
+      "exportImage",
       "resize",
       "setElementShapeHoverControls",
       "destroy"

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-10"
 }