orcasvn-react-diagrams 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 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.
+
+### Changed
+- Unified child-port movement restrictions across all engine entry points (move, add, load, link-session creation, resize reprojection).
+- Border-host port constraints now resolve deterministically when combined with `positionLimits`, while preserving border placement invariants.
+- Routing stub behavior for sibling external links and parent-child links updated for consistent obstacle routing outcomes.
+
+### Fixed
+- Manual link points now translate correctly when moving an element subtree.
+- Multi-anchor nested routing demo behavior corrected for stable path previews.
+
+### Docs
+- Updated release highlights in `README.md` for `v0.2.4`.
+
 ## [0.2.3] - 2026-05-03
 
 ### Added
@@ -12,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
@@ -32,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.
@@ -48,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,17 +30,23 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.3)
-
-- Includes all completed `v0.2.1` and `v0.2.2` work, plus `v0.2.3` updates.
-- `v0.2.3` interaction and stability updates:
-  - restored port-selection priority over vertex controls
-  - suppressed occupied-vertex controls where ports already own the anchor
-  - hardened invalid vertex-control link-drop cancellation to prevent re-entrant stack overflow
-- `v0.2.3` demo and behavior updates:
-  - asymmetric multi-anchor demo now aligns initial external link endpoints deterministically
-  - added multiple asymmetric SVG glyph variants for multi-anchor comparison
-  - consolidated auto-layout demo coverage with label-visibility fixes
+## 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"
 }