orcasvn-react-diagrams 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.9] - 2026-05-27
+
+### Added
+- Element-level visibility and selectability policy through `ElementData.visible` and `ElementData.selectable`.
+
+### Changed
+- Built-in element-body hit testing, click selection, marquee selection, and persisted selection normalization now honor element visibility/selectability state.
+- Hidden-scene propagation now suppresses owned ports, owned texts, and links whose endpoint ports belong to hidden elements.
+- `zoomToFitElements` and `exportImage({ fitToContent: ... })` now ignore hidden scene members when deriving bounds.
+
+### Docs
+- Updated release highlights, API/invariant docs, integration guidance, and machine-readable contract artifacts for `v0.2.9`.
+
+## [0.2.8] - 2026-05-24
+
+### Fixed
+- Grid auto-layout now preserves the owner-assigned slot size of a direct child that is itself an empty non-manual layout parent during the active layout cycle.
+- Enabled `layout.gridChildWidthResizeEnabled` resize redistribution now keeps that nested layout parent at its resolved slot size instead of collapsing it back to empty padding bounds.
+
+### Docs
+- Updated `README.md` release highlights for `v0.2.8`.
+- Refreshed release workflow metadata for `v0.2.8`.
+
 ## [0.2.7] - 2026-05-18
 
 ### Added
@@ -30,6 +53,7 @@ All notable changes to this project are documented in this file.
 
 ### Changed
 - Grid auto-layout now keeps overflow rows on the established fallback model while deriving row occupancy from flat slot templates.
+- Grid auto-layout `gridTemplate` now uses a flat one-level slot array shape such as `[12,4,8]` instead of nested row arrays, with rows derived greedily during layout.
 - 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.

package/README.md

@@ -30,18 +30,13 @@ editor.addElement({
 });
 ```
 
-## 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
+## Release Highlights (v0.2.9)
+
+- Includes all completed `v0.2.1` through `v0.2.8` work, plus `v0.2.9` updates.
+- `v0.2.9` element visibility/selectability policy:
+  - `ElementData.visible = false` keeps the element in state while removing it from built-in render, hit testing, selection, and fit/export bounds
+  - `ElementData.selectable = false` keeps the element visible while preventing built-in element-body click/marquee/programmatic selection from retaining that element id
+  - owned ports/texts and endpoint-dependent links now follow the same hidden-scene visibility rules
 
 ## API Docs
 

package/ai/api-contract.json

@@ -81,6 +81,8 @@
         "style",
         "portIds",
         "textIds",
+        "visible",
+        "selectable",
         "parentId",
         "moveMode",
         "anchorCenter",
@@ -216,6 +218,20 @@
         "movable": true
       }
     },
+    "elementVisibilitySelectionPolicy": {
+      "visible": "boolean",
+      "selectable": "boolean",
+      "defaults": {
+        "visible": true,
+        "selectable": true
+      },
+      "semantics": [
+        "visible=false hides the element body from built-in render, hit testing, marquee selection, persisted selection, zoomToFitElements, and exportImage fit-to-content bounds",
+        "hidden-scene propagation also hides owned ports, owned texts, and links whose endpoint ports belong to hidden elements",
+        "selectable=false blocks built-in element-body click selection, marquee selection, and programmatic setSelection/toggleSelection from retaining that element id",
+        "selectable=false does not hide the element"
+      ]
+    },
     "shapeHoverControls": {
       "targetKinds": [
         "vertex",

package/ai/invariants.json

@@ -6,6 +6,8 @@
     "texts[]"
   ],
   "defaults": {
+    "element.visible": true,
+    "element.selectable": true,
     "port.anchorCenter": true,
     "port.orientToHostBorder": true,
     "link.routing": "auto"
@@ -13,25 +15,31 @@
   "entityRules": {
     "element": [
       "child element positions are parent-relative when parentId is set",
+      "element visible-state is enabled by default and hidden ancestors suppress descendant element visibility",
+      "element selectable-state is enabled by default and selectable=false prevents the element id from persisting in selection state",
       "deleting an element removes its ports, links via ports, and owned texts"
     ],
     "port": [
       "port positions are relative to element",
+      "port visible-state follows owning element visibility",
       "moving a port can be constrained by moveMode/moveAxis/moveBounds",
       "element portMovement policy can enforce anchor-constrained movement with discrete shape anchors"
     ],
     "link": [
+      "link visible-state requires both endpoint ports to remain visible",
       "manual routing preserves interior bend points on endpoint updates",
       "auto routing normalizes first/last points to source/target port world positions"
     ],
     "text": [
       "owner-bound text stores owner-relative position",
+      "owned text visible-state follows its resolved owner visibility",
       "orphan owner references are tolerated as standalone world text",
       "displayContent/displayOffset/displayClipSize may be derived from text layout rules"
     ]
   },
   "eventRules": [
     "mutations emit change with patches and full state snapshot",
+    "setSelection/toggleSelection normalize away hidden scene members and selectable=false element ids before emitting selection",
     "setSelection emits selection plus derived selected entity events",
     "setViewport emits viewport patch without immediate render"
   ],

package/ai/manifest.json

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