@almadar/std 16.200.0 → 16.201.0

package/behaviors/registry/ui/core/organisms/ui-dock-layout.orb

@@ -0,0 +1,521 @@
+{
+  "description": "DockLayout — UI factory (1:1 with the @almadar/ui dock-layout pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M1JMH80EX2T34WXWMHXFCBNA": {
+        "bakedName": "DockLayoutItem",
+        "curName": "DockLayoutItem",
+        "id": "ent_01M1JMH80EX2T34WXWMHXFCBNA",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1JMH80E1T1QHWW9EH6GR8P5": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1JMH80E1T1QHWW9EH6GR8P5",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "evt_01M1JMH80E77DP5G44HKZR4YX7": {
+        "bakedName": "@config.onBottomPanelCollapsedChange",
+        "curName": "@config.onBottomPanelCollapsedChange",
+        "id": "evt_01M1JMH80E77DP5G44HKZR4YX7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "evt_01M1JMH80EHN4T32MAW809THGC": {
+        "bakedName": "@config.onBottomPanelHeightChange",
+        "curName": "@config.onBottomPanelHeightChange",
+        "id": "evt_01M1JMH80EHN4T32MAW809THGC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "evt_01M1JMH80ESFPDX9DJYCFSS4R1": {
+        "bakedName": "@config.onSidebarWidthChange",
+        "curName": "@config.onSidebarWidthChange",
+        "id": "evt_01M1JMH80ESFPDX9DJYCFSS4R1",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "evt_01M1JMH80ETHHX7ZXYD68H0RM3": {
+        "bakedName": "@config.onSidebarCollapsedChange",
+        "curName": "@config.onSidebarCollapsedChange",
+        "id": "evt_01M1JMH80ETHHX7ZXYD68H0RM3",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "evt_01M1JMH80EXYMF5E5X9M9EDVNQ": {
+        "bakedName": "@config.onSecondarySidebarCollapsedChange",
+        "curName": "@config.onSecondarySidebarCollapsedChange",
+        "id": "evt_01M1JMH80EXYMF5E5X9M9EDVNQ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "renames": []
+      },
+      "orb_01M1JMH80E834DKQR4Y5VPXQ3W": {
+        "bakedName": "DockLayoutOrbital",
+        "curName": "DockLayoutOrbital",
+        "id": "orb_01M1JMH80E834DKQR4Y5VPXQ3W",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1JMH80ET524GW0953SAJGG0": {
+        "bakedName": "DockLayoutPage",
+        "curName": "DockLayoutPage",
+        "id": "pag_01M1JMH80ET524GW0953SAJGG0",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1JMH80EFEHFZRD9GXCC10NX": {
+        "bakedName": "DockLayoutRender",
+        "curName": "DockLayoutRender",
+        "id": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-dock-layout",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M1JMH80EX2T34WXWMHXFCBNA",
+        "name": "DockLayoutItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M1JMH80E834DKQR4Y5VPXQ3W",
+      "name": "DockLayoutOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1JMH80ET524GW0953SAJGG0",
+          "name": "DockLayoutPage",
+          "path": "/dock-layout",
+          "traits": [
+            {
+              "ref": "DockLayoutRender",
+              "refId": "trt_01M1JMH80EFEHFZRD9GXCC10NX"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "bottomPanel": {
+              "description": "Collapsible, resizable-height bottom panel.",
+              "label": "Bottom Panel",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "bottomPanelClassName": {
+              "description": "bottomPanelClassName prop",
+              "label": "Bottom Panel Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "bottomPanelCollapsed": {
+              "default": false,
+              "description": "Whether `bottomPanel` is collapsed. @default false",
+              "label": "Bottom Panel Collapsed",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "bottomPanelHeight": {
+              "default": 30.0,
+              "description": "Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30",
+              "label": "Bottom Panel Height",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "bottomPanelMinSize": {
+              "default": 120.0,
+              "description": "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120",
+              "label": "Bottom Panel Min Size",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "className": {
+              "description": "Additional CSS classes on the root frame.",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "main": {
+              "default": [],
+              "description": "Required center region.",
+              "label": "Main",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "mainClassName": {
+              "description": "mainClassName prop",
+              "label": "Main Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "onBottomPanelCollapsedChange": {
+              "default": "BOTTOM_PANEL_COLLAPSED_CHANGE",
+              "description": "onBottomPanelCollapsedChange prop",
+              "label": "On Bottom Panel Collapsed Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onBottomPanelHeightChange": {
+              "default": "BOTTOM_PANEL_HEIGHT_CHANGE",
+              "description": "onBottomPanelHeightChange prop",
+              "label": "On Bottom Panel Height Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onSecondarySidebarCollapsedChange": {
+              "default": "SECONDARY_SIDEBAR_COLLAPSED_CHANGE",
+              "description": "onSecondarySidebarCollapsedChange prop",
+              "label": "On Secondary Sidebar Collapsed Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onSidebarCollapsedChange": {
+              "default": "SIDEBAR_COLLAPSED_CHANGE",
+              "description": "onSidebarCollapsedChange prop",
+              "label": "On Sidebar Collapsed Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onSidebarWidthChange": {
+              "default": "SIDEBAR_WIDTH_CHANGE",
+              "description": "onSidebarWidthChange prop",
+              "label": "On Sidebar Width Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "rail": {
+              "description": "Fixed-width far-left vertical strip (e.g. an icon nav rail).",
+              "label": "Rail",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "railClassName": {
+              "description": "railClassName prop",
+              "label": "Rail Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "railWidth": {
+              "default": 56.0,
+              "description": "Width of `rail` in pixels. @default 56",
+              "label": "Rail Width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "secondarySidebar": {
+              "description": "Collapsible right sidebar.",
+              "label": "Secondary Sidebar",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "secondarySidebarClassName": {
+              "description": "secondarySidebarClassName prop",
+              "label": "Secondary Sidebar Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "secondarySidebarCollapsed": {
+              "default": false,
+              "description": "Whether `secondarySidebar` is collapsed. @default false",
+              "label": "Secondary Sidebar Collapsed",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "secondarySidebarWidth": {
+              "default": 280.0,
+              "description": "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280",
+              "label": "Secondary Sidebar Width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "sidebar": {
+              "description": "Collapsible, resizable left sidebar.",
+              "label": "Sidebar",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "sidebarClassName": {
+              "description": "sidebarClassName prop",
+              "label": "Sidebar Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "sidebarCollapsed": {
+              "default": false,
+              "description": "Whether `sidebar` is collapsed. @default false",
+              "label": "Sidebar Collapsed",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "sidebarMinSize": {
+              "default": 160.0,
+              "description": "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160",
+              "label": "Sidebar Min Size",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "sidebarWidth": {
+              "default": 20.0,
+              "description": "Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20",
+              "label": "Sidebar Width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "statusBar": {
+              "description": "Slim strip pinned to the bottom of the frame, below the bottom panel.",
+              "label": "Status Bar",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "statusBarClassName": {
+              "description": "statusBarClassName prop",
+              "label": "Status Bar Class Name",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "definerKnob": "onSidebarCollapsedChange",
+              "description": "onSidebarCollapsedChange prop",
+              "event": "@config.onSidebarCollapsedChange",
+              "eventId": "evt_01M1JMH80ETHHX7ZXYD68H0RM3",
+              "payloadSchema": [
+                {
+                  "name": "collapsed",
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onSidebarWidthChange",
+              "description": "onSidebarWidthChange prop",
+              "event": "@config.onSidebarWidthChange",
+              "eventId": "evt_01M1JMH80ESFPDX9DJYCFSS4R1",
+              "payloadSchema": [
+                {
+                  "name": "width",
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onBottomPanelCollapsedChange",
+              "description": "onBottomPanelCollapsedChange prop",
+              "event": "@config.onBottomPanelCollapsedChange",
+              "eventId": "evt_01M1JMH80E77DP5G44HKZR4YX7",
+              "payloadSchema": [
+                {
+                  "name": "collapsed",
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onBottomPanelHeightChange",
+              "description": "onBottomPanelHeightChange prop",
+              "event": "@config.onBottomPanelHeightChange",
+              "eventId": "evt_01M1JMH80EHN4T32MAW809THGC",
+              "payloadSchema": [
+                {
+                  "name": "height",
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onSecondarySidebarCollapsedChange",
+              "description": "onSecondarySidebarCollapsedChange prop",
+              "event": "@config.onSecondarySidebarCollapsedChange",
+              "eventId": "evt_01M1JMH80EXYMF5E5X9M9EDVNQ",
+              "payloadSchema": [
+                {
+                  "name": "collapsed",
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DockLayoutItem": "ent_01M1JMH80EX2T34WXWMHXFCBNA"
+          },
+          "id": "trt_01M1JMH80EFEHFZRD9GXCC10NX",
+          "linkedEntity": "DockLayoutItem",
+          "linkedEntityId": "ent_01M1JMH80EX2T34WXWMHXFCBNA",
+          "name": "DockLayoutRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1JMH80E1T1QHWW9EH6GR8P5",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "onSidebarCollapsedChange prop",
+                "id": "evt_01M1JMH80ETHHX7ZXYD68H0RM3",
+                "key": "@config.onSidebarCollapsedChange",
+                "name": "@config.on sidebar collapsed change",
+                "payloadSchema": [
+                  {
+                    "name": "collapsed",
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "onSidebarWidthChange prop",
+                "id": "evt_01M1JMH80ESFPDX9DJYCFSS4R1",
+                "key": "@config.onSidebarWidthChange",
+                "name": "@config.on sidebar width change",
+                "payloadSchema": [
+                  {
+                    "name": "width",
+                    "type": "number"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "onBottomPanelCollapsedChange prop",
+                "id": "evt_01M1JMH80E77DP5G44HKZR4YX7",
+                "key": "@config.onBottomPanelCollapsedChange",
+                "name": "@config.on bottom panel collapsed change",
+                "payloadSchema": [
+                  {
+                    "name": "collapsed",
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "onBottomPanelHeightChange prop",
+                "id": "evt_01M1JMH80EHN4T32MAW809THGC",
+                "key": "@config.onBottomPanelHeightChange",
+                "name": "@config.on bottom panel height change",
+                "payloadSchema": [
+                  {
+                    "name": "height",
+                    "type": "number"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "onSecondarySidebarCollapsedChange prop",
+                "id": "evt_01M1JMH80EXYMF5E5X9M9EDVNQ",
+                "key": "@config.onSecondarySidebarCollapsedChange",
+                "name": "@config.on secondary sidebar collapsed change",
+                "payloadSchema": [
+                  {
+                    "name": "collapsed",
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "bottomPanel": "@config.bottomPanel",
+                      "bottomPanelClassName": "@config.bottomPanelClassName",
+                      "bottomPanelCollapsed": "@config.bottomPanelCollapsed",
+                      "bottomPanelHeight": "@config.bottomPanelHeight",
+                      "bottomPanelMinSize": "@config.bottomPanelMinSize",
+                      "className": "@config.className",
+                      "main": "@config.main",
+                      "mainClassName": "@config.mainClassName",
+                      "onBottomPanelCollapsedChange": "@config.onBottomPanelCollapsedChange",
+                      "onBottomPanelHeightChange": "@config.onBottomPanelHeightChange",
+                      "onSecondarySidebarCollapsedChange": "@config.onSecondarySidebarCollapsedChange",
+                      "onSidebarCollapsedChange": "@config.onSidebarCollapsedChange",
+                      "onSidebarWidthChange": "@config.onSidebarWidthChange",
+                      "rail": "@config.rail",
+                      "railClassName": "@config.railClassName",
+                      "railWidth": "@config.railWidth",
+                      "secondarySidebar": "@config.secondarySidebar",
+                      "secondarySidebarClassName": "@config.secondarySidebarClassName",
+                      "secondarySidebarCollapsed": "@config.secondarySidebarCollapsed",
+                      "secondarySidebarWidth": "@config.secondarySidebarWidth",
+                      "sidebar": "@config.sidebar",
+                      "sidebarClassName": "@config.sidebarClassName",
+                      "sidebarCollapsed": "@config.sidebarCollapsed",
+                      "sidebarMinSize": "@config.sidebarMinSize",
+                      "sidebarWidth": "@config.sidebarWidth",
+                      "statusBar": "@config.statusBar",
+                      "statusBarClassName": "@config.statusBarClassName",
+                      "type": "dock-layout"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1JMH80E1T1QHWW9EH6GR8P5",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/core/organisms/ui-split-pane.orb

@@ -19,6 +19,24 @@
         "parent": "trt_01KXG04SZQZQTYV05GPN6HEPVA",
         "renames": []
       },
+      "evt_01M1JMH852A3KDZRKMEBY5RZ23": {
+        "bakedName": "RATIO_CHANGE",
+        "curName": "RATIO_CHANGE",
+        "id": "evt_01M1JMH852A3KDZRKMEBY5RZ23",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SZQZQTYV05GPN6HEPVA",
+        "renames": []
+      },
+      "evt_01M1JMH852AWVKHSRQDJYCBMBR": {
+        "bakedName": "@config.onRatioChange",
+        "curName": "@config.onRatioChange",
+        "id": "evt_01M1JMH852AWVKHSRQDJYCBMBR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04SZQZQTYV05GPN6HEPVA",
+        "renames": []
+      },
       "orb_01KXG04SZQ0QSZT2WW4D62B2AK": {
         "bakedName": "SplitPaneOrbital",
         "curName": "SplitPaneOrbital",
@@ -55,6 +73,10 @@
             "name": "id",
             "required": true,
             "type": "string"
+          },
+          {
+            "name": "ratio",
+            "type": "number"
           }
         ],
         "id": "ent_01KXG04SZQ7G8R7PH46DZWE8P9",
@@ -117,6 +139,13 @@
               "tier": "presentation",
               "type": "number"
             },
+            "onRatioChange": {
+              "default": "RATIO_CHANGE",
+              "description": "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior.",
+              "label": "On Ratio Change",
+              "tier": "presentation",
+              "type": "event"
+            },
             "ratio": {
               "description": "Initial ratio (0-100, percentage of first pane)",
               "label": "Ratio",
@@ -144,8 +173,26 @@
               "type": "string"
             }
           },
+          "emits": [
+            {
+              "definerKnob": "onRatioChange",
+              "description": "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior.",
+              "event": "@config.onRatioChange",
+              "eventId": "evt_01M1JMH852AWVKHSRQDJYCBMBR",
+              "payloadSchema": [
+                {
+                  "name": "ratio",
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
-            "provides": [],
+            "provides": [
+              "ratio"
+            ],
             "requires": []
           },
           "entityRebindable": true,
@@ -163,6 +210,30 @@
                 "id": "evt_01KXG04SZQHBYQ7QDGS6TKJTVZ",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "id": "evt_01M1JMH852A3KDZRKMEBY5RZ23",
+                "key": "RATIO_CHANGE",
+                "name": "Ratio Change",
+                "payloadSchema": [
+                  {
+                    "name": "ratio",
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "description": "Called with the new ratio while dragging. Providing this makes `ratio` controlled — the rendered split always tracks the prop instead of internal state, mirroring a controlled input. Omit for uncontrolled (self-tracked) behavior.",
+                "id": "evt_01M1JMH852AWVKHSRQDJYCBMBR",
+                "key": "@config.onRatioChange",
+                "name": "@config.on ratio change",
+                "payloadSchema": [
+                  {
+                    "name": "ratio",
+                    "type": "number"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -174,6 +245,11 @@
             "transitions": [
               {
                 "effects": [
+                  [
+                    "set",
+                    "@entity.ratio",
+                    "@config.ratio"
+                  ],
                   [
                     "render-ui",
                     "main",
@@ -183,7 +259,8 @@
                       "left": "@config.left",
                       "leftClassName": "@config.leftClassName",
                       "minSize": "@config.minSize",
-                      "ratio": "@config.ratio",
+                      "onRatioChange": "@config.onRatioChange",
+                      "ratio": "@entity.ratio",
                       "resizable": "@config.resizable",
                       "right": "@config.right",
                       "rightClassName": "@config.rightClassName",
@@ -195,6 +272,36 @@
                 "eventId": "evt_01KXG04SZQHBYQ7QDGS6TKJTVZ",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.ratio",
+                    "@payload.ratio"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "direction": "@config.direction",
+                      "left": "@config.left",
+                      "leftClassName": "@config.leftClassName",
+                      "minSize": "@config.minSize",
+                      "onRatioChange": "@config.onRatioChange",
+                      "ratio": "@entity.ratio",
+                      "resizable": "@config.resizable",
+                      "right": "@config.right",
+                      "rightClassName": "@config.rightClassName",
+                      "type": "split-pane"
+                    }
+                  ]
+                ],
+                "event": "RATIO_CHANGE",
+                "eventId": "evt_01M1JMH852A3KDZRKMEBY5RZ23",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }