orcasvn-react-diagrams 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 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

package/README.md

@@ -30,12 +30,13 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.8)
+## Release Highlights (v0.2.9)
 
-- Includes all completed `v0.2.1` through `v0.2.7` work, plus `v0.2.8` updates.
-- `v0.2.8` grid auto-layout fix:
-  - direct grid children that are themselves non-manual layout parents now keep the owner-assigned slot size for the active layout cycle, even when they are empty
-  - enabled `layout.gridChildWidthResizeEnabled` resize flows now preserve that assigned size instead of collapsing the nested layout parent back to padding-only bounds
+- 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-24"
+  "updatedAt": "2026-05-27"
 }