orcasvn-react-diagrams 0.2.9 → 0.2.11

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.2.11] - 2026-06-20
+
+### Added
+- `LinkColorPoolPolicy.assignOnLoadWhenMissingStroke` for opt-in load-time random `style.stroke` assignment on links that load without a usable stroke value.
+
+### Changed
+- Load-time link color fill now preserves explicit loaded `style.stroke` values, treats missing/`null`/blank strokes as fill candidates, and uses the active custom-or-default color pool only when the policy is enabled.
+
+### Docs
+- Updated release highlights, public API/docs contract text, integration guidance, and machine-readable contract metadata for `v0.2.11`.
+
+## [0.2.10] - 2026-05-27
+
+### Changed
+- `ElementData.visible = false` now hides only the element body from built-in render, hit testing, selection persistence, and fit/export helpers instead of suppressing descendant elements through hidden ancestors.
+- Visible descendants under hidden parents now remain rendered, selectable, draggable, and included in fit/export bounds, while direct-owned parent ports/texts still follow the hidden parent and links remain visible when their endpoint ports are visible.
+
+### Docs
+- Updated release highlights, API/invariant docs, integration guidance, commands/events notes, and machine-readable contract artifacts for `v0.2.10`.
+
 ## [0.2.9] - 2026-05-27
 
 ### Added

package/README.md

@@ -30,13 +30,13 @@ editor.addElement({
 });
 ```
 
-## Release Highlights (v0.2.9)
+## Release Highlights (v0.2.11)
 
-- 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
+- Includes all completed `v0.2.1` through `v0.2.10` work, plus `v0.2.11` updates.
+- `v0.2.11` link color pool load-time fill:
+  - `linkColorPoolPolicy.assignOnLoadWhenMissingStroke = true` backfills loaded links whose `style.stroke` is missing, `null`, or blank after trimming
+  - explicit non-empty loaded `style.stroke` values are preserved exactly as loaded
+  - the fill uses normalized custom `colors` when provided, otherwise the built-in 20-color pool
 
 ## API Docs
 

package/ai/api-contract.json

@@ -227,7 +227,9 @@
       },
       "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",
+        "descendant elements keep resolving visibility from their own visible flag even when an ancestor element is hidden",
+        "direct-owned ports and direct-owned texts still hide with their hidden parent element",
+        "links remain visible whenever both endpoint ports remain visible, including links attached to visible descendants under hidden parents",
         "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"
       ]
@@ -257,6 +259,7 @@
     "linkColorPoolPolicy": {
       "enabled": "boolean",
       "colors": "string[]",
+      "assignOnLoadWhenMissingStroke": "boolean",
       "defaultPoolSize": 20
     },
     "viewportFitOptions": {

package/ai/invariants.json

@@ -15,7 +15,7 @@
   "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 visible-state is enabled by default and visible=false hides only that element body while descendants resolve visibility from their own visible flag",
       "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"
     ],
@@ -39,7 +39,7 @@
   },
   "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/toggleSelection normalize away hidden element bodies, direct-owned hidden artifacts, 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-27"
+  "updatedAt": "2026-06-20"
 }