@almadar/std 16.234.0 → 16.236.0

package/behaviors/registry/ui/core/molecules/ui-document-details.orb

@@ -10,15 +10,6 @@
         "owner": "workspace",
         "renames": []
       },
-      "evt_01M13ZXC59HB41Z83ZYJR50JQP": {
-        "bakedName": "DocumentDetailsLoaded",
-        "curName": "DocumentDetailsLoaded",
-        "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
-        "renames": []
-      },
       "evt_01M13ZXC59R4VP1T1DHD262B08": {
         "bakedName": "@config.metaCommitEvent",
         "curName": "@config.metaCommitEvent",
@@ -46,6 +37,15 @@
         "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
         "renames": []
       },
+      "evt_01M3RWGC5NSA2MG9W3F0E0SB97": {
+        "bakedName": "DocumentDetailsLoaded",
+        "curName": "DocumentDetailsLoaded",
+        "id": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
       "orb_01M13ZXC59HR3466AAAMSKD8MY": {
         "bakedName": "DocumentDetailsOrbital",
         "curName": "DocumentDetailsOrbital",
@@ -203,8 +203,8 @@
             },
             "selfFetch": {
               "default": true,
-              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
-              "label": "Fetch its own rows on mount?",
+              "description": "true (default) = a mount that carries an id loads that one row (never the collection); a create-mode mount skips the load. false = a composing atom owns the load.",
+              "label": "Fetch its own row on mount?",
               "tier": "internal",
               "type": "boolean"
             },
@@ -272,9 +272,9 @@
               "tier": "essential"
             },
             {
-              "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
+              "description": "DocumentDetails row finished loading; payload.data holds the single row.",
               "event": "DocumentDetailsLoaded",
-              "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+              "eventId": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
               "payloadSchema": [
                 {
                   "entity": "DocumentDetailsItem",
@@ -286,7 +286,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -310,13 +310,21 @@
           "stateMachine": {
             "events": [
               {
+                "description": "Mount payload; a host that routes to this panel by id (a :id page param) passes it here.",
                 "id": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
                 "key": "INIT",
-                "name": "Initialize"
+                "name": "Initialize",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
               },
               {
-                "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
-                "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "description": "DocumentDetails row finished loading; payload.data holds the single row.",
+                "id": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
                 "key": "DocumentDetailsLoaded",
                 "name": "Document details loaded",
                 "payloadSchema": [
@@ -330,7 +338,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -383,6 +391,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -395,7 +406,8 @@
                     {
                       "emit": {
                         "success": "DocumentDetailsLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -414,8 +426,20 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
-                "from": "idle",
-                "guard": "@config.selfFetch",
+                "from": "resolving",
+                "guard": [
+                  "and",
+                  "@config.selfFetch",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      "@payload.id",
+                      ""
+                    ],
+                    ""
+                  ]
+                ],
                 "to": "idle"
               },
               {
@@ -436,13 +460,46 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
-                "from": "idle",
+                "from": "resolving",
                 "guard": [
                   "not",
-                  "@config.selfFetch"
+                  [
+                    "and",
+                    "@config.selfFetch",
+                    [
+                      "!=",
+                      [
+                        "str/default",
+                        "@payload.id",
+                        ""
+                      ],
+                      ""
+                    ]
+                  ]
                 ],
                 "to": "idle"
               },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "entity": "@entity",
+                      "fields": "@config.fields",
+                      "metaCommitEvent": "@config.metaCommitEvent",
+                      "relationEvent": "@config.relationEvent",
+                      "title": "@config.title",
+                      "type": "document-details"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+                "from": "idle",
+                "to": "idle"
+              },
               {
                 "effects": [
                   [
@@ -460,7 +517,7 @@
                   ]
                 ],
                 "event": "DocumentDetailsLoaded",
-                "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "eventId": "evt_01M3RWGC5NSA2MG9W3F0E0SB97",
                 "from": "idle",
                 "to": "idle"
               }

package/behaviors/registry/ui/core/molecules/ui-document-panel.orb

@@ -164,6 +164,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -282,6 +290,13 @@
               "label": "Value",
               "tier": "presentation",
               "type": "string"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -502,7 +517,40 @@
                     "render-ui",
                     "main",
                     {
-                      "actions": "@config.actions",
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
@@ -539,7 +587,40 @@
                     "render-ui",
                     "main",
                     {
-                      "actions": "@config.actions",
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
@@ -576,7 +657,40 @@
                     "render-ui",
                     "main",
                     {
-                      "actions": "@config.actions",
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
@@ -624,6 +738,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ]
       }

package/behaviors/registry/ui/core/molecules/ui-document-viewer.orb

@@ -100,6 +100,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -267,6 +275,13 @@
               "label": "Total Pages",
               "tier": "presentation",
               "type": "number"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -309,7 +324,40 @@
                     "render-ui",
                     "main",
                     {
-                      "actions": "@config.actions",
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
                       "className": "@config.className",
                       "content": "@config.content",
                       "currentPage": "@config.currentPage",
@@ -355,6 +403,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "DocumentViewerDocumentsItem": [

package/behaviors/registry/ui/core/molecules/ui-drawer.orb

@@ -46,6 +46,15 @@
         "parent": "trt_01KXG04NNM7QJHC934D0EDT8KC",
         "renames": []
       },
+      "evt_01M3SGNF2TD0GBX6P7TQFKC549": {
+        "bakedName": "@config.onExited",
+        "curName": "@config.onExited",
+        "id": "evt_01M3SGNF2TD0GBX6P7TQFKC549",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04NNM7QJHC934D0EDT8KC",
+        "renames": []
+      },
       "orb_01KXG04NNM46ZEJ56TQKVZTX6Z": {
         "bakedName": "DrawerOrbital",
         "curName": "DrawerOrbital",
@@ -141,6 +150,13 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "contained": {
+              "default": false,
+              "description": "Render inside the nearest positioned ancestor (a preview frame) instead of over the window.",
+              "label": "Contained",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "footer": {
               "description": "Footer content",
               "label": "Footer",
@@ -161,6 +177,13 @@
               "tier": "presentation",
               "type": "event"
             },
+            "onExited": {
+              "default": "EXITED",
+              "description": "Fires after the exit animation completes (the drawer is about to unmount).",
+              "label": "On Exited",
+              "tier": "presentation",
+              "type": "event"
+            },
             "position": {
               "default": "right",
               "description": "Position (left or right)",
@@ -204,6 +227,14 @@
             }
           ],
           "emits": [
+            {
+              "definerKnob": "onExited",
+              "description": "Fires after the exit animation completes (the drawer is about to unmount).",
+              "event": "@config.onExited",
+              "eventId": "evt_01M3SGNF2TD0GBX6P7TQFKC549",
+              "scope": "external",
+              "tier": "essential"
+            },
             {
               "definerKnob": "onClose",
               "description": "Callback when drawer should close (injected by slot wrapper)",
@@ -264,6 +295,13 @@
                 "key": "CLOSE",
                 "name": "Close"
               },
+              {
+                "description": "Fires after the exit animation completes (the drawer is about to unmount).",
+                "id": "evt_01M3SGNF2TD0GBX6P7TQFKC549",
+                "key": "@config.onExited",
+                "name": "@config.on exited",
+                "tier": "essential"
+              },
               {
                 "description": "Callback when drawer should close (injected by slot wrapper)",
                 "id": "evt_01KXG04NNQF8X136A5E4RS94BZ",
@@ -310,9 +348,11 @@
                       "closeEvent": "@config.closeEvent",
                       "closeOnEscape": "@config.closeOnEscape",
                       "closeOnOverlayClick": "@config.closeOnOverlayClick",
+                      "contained": "@config.contained",
                       "footer": "@config.footer",
                       "isOpen": "@config.isOpen",
                       "onClose": "@config.onClose",
+                      "onExited": "@config.onExited",
                       "position": "@config.position",
                       "showCloseButton": "@config.showCloseButton",
                       "title": "@config.title",

package/behaviors/registry/ui/core/molecules/ui-floating-action-button.orb

@@ -136,6 +136,14 @@
                     "required": true,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -200,6 +208,13 @@
                 "danger",
                 "warning"
               ]
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The viewer's role that each action's `roles` is checked against; bind it at the call site (e.g. `viewerRole: @user.role`). Empty = only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -276,7 +291,40 @@
                     {
                       "action": "@config.action",
                       "actionPayload": "@config.actionPayload",
-                      "actions": "@config.actions",
+                      "actions": [
+                        "array/filter",
+                        "@config.actions",
+                        [
+                          "fn",
+                          "action",
+                          [
+                            "or",
+                            [
+                              "=",
+                              [
+                                "array/len",
+                                [
+                                  "object/get",
+                                  "@action",
+                                  "roles",
+                                  []
+                                ]
+                              ],
+                              0.0
+                            ],
+                            [
+                              "array/includes",
+                              [
+                                "object/get",
+                                "@action",
+                                "roles",
+                                []
+                              ],
+                              "@config.viewerRole"
+                            ]
+                          ]
+                        ]
+                      ],
                       "className": "@config.className",
                       "icon": "@config.icon",
                       "label": "@config.label",
@@ -320,6 +368,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ]
       }