orcasvn-react-diagrams 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.7] - 2026-05-18
+
+### Added
+- Parent-owned child drag lock via `ElementData.childElementInteraction.movable`, allowing direct child elements to remain selectable while suppressing built-in pointer drag.
+
+### Changed
+- Built-in empty-paper panning now starts from plain primary-button drag without requiring `Ctrl`, and the applied pan direction now follows pointer movement.
+- Marquee selection now uses `Shift + primary drag` on empty paper so paper-drag panning and box selection do not conflict.
+- Enabled grid child width topology editing (`layout.gridChildWidthResizeEnabled`) now applies consistently to all direct grid children, including nested layout-container children.
+
+### Fixed
+- Preserved disabled grid-child resize compatibility so nested layout-parent children stay directly horizontally resizable unless the grid width-topology capability is explicitly enabled.
+- Prevented built-in child drag suppression from blocking programmatic `moveElementTo(...)`, layout reflow, or ancestor-driven repositioning.
+
+### Docs
+- Updated `README.md` release highlights for `v0.2.7`.
+- Updated public API and machine-readable contract docs for `ElementChildInteractionPolicy`, `childElementInteraction`, and `v0.2.7` interaction behavior.
+
+## [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,18 @@ 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.7)
+
+- Includes all completed `v0.2.1` through `v0.2.6` work, plus `v0.2.7` updates.
+- `v0.2.7` child interaction update:
+  - parent elements can suppress built-in drag for direct child elements with `childElementInteraction.movable = false`
+  - locked child elements remain selectable, while programmatic movement and layout-driven repositioning still work
+- `v0.2.7` viewport gesture update:
+  - empty-paper primary drag now pans without requiring `Ctrl`
+  - pan direction now follows pointer movement
+  - marquee selection now uses `Shift + drag` on empty paper
+- `v0.2.7` grid auto-layout update:
+  - enabled `layout.gridChildWidthResizeEnabled` now applies the same 12-unit width-topology behavior to all direct grid children, including nested layout parents
 
 ## API Docs
 

package/ai/api-contract.json

@@ -85,6 +85,7 @@
         "moveMode",
         "anchorCenter",
         "layout",
+        "childElementInteraction",
         "portMovement"
       ],
       "defaults": {
@@ -107,6 +108,11 @@
         "moveMode",
         "anchorCenter",
         "orientToHostBorder",
+        "placementPoint",
+        "linkAttachPoint",
+        "externalLinkAttachPoint",
+        "internalLinkAttachPoint",
+        "rotationPivot",
         "currentAnchorId"
       ],
       "defaults": {
@@ -143,6 +149,7 @@
         "style",
         "ownerId",
         "layout",
+        "interaction",
         "displayContent",
         "displayOffset",
         "displayClipSize"
@@ -164,6 +171,7 @@
         "align",
         "autoResize",
         "gridTemplate",
+        "gridChildWidthResizeEnabled",
         "childFitMainAxis",
         "childFitCrossAxis",
         "childMinWidth",
@@ -179,7 +187,8 @@
   "additionalContracts": {
     "portMovementPolicy": {
       "moveMode": "'free' | 'inside' | 'border' | 'anchors'",
-      "anchorConstraint": "PortAnchorConstraint"
+      "anchorConstraint": "PortAnchorConstraint",
+      "positionLimits": "PortPositionLimits"
     },
     "portAnchorConstraint": {
       "preset": "'vertices' | 'cardinal'",
@@ -193,6 +202,20 @@
       "maxLines": "number",
       "fixedSize": "Size"
     },
+    "textInteractionPolicy": {
+      "movable": "boolean",
+      "editable": "boolean",
+      "defaults": {
+        "movable": true,
+        "editable": true
+      }
+    },
+    "elementChildInteractionPolicy": {
+      "movable": "boolean",
+      "defaults": {
+        "movable": true
+      }
+    },
     "shapeHoverControls": {
       "targetKinds": [
         "vertex",
@@ -220,6 +243,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 +312,7 @@
       "completeLinkToPort",
       "completeLinkToElement",
       "cancelLink",
+      "zoomToFitElements",
       "exportImage",
       "resize",
       "setElementShapeHoverControls",
@@ -291,6 +334,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-18"
 }