@almadar/std 16.234.0 → 16.236.0

package/behaviors/registry/ui/core/organisms/ui-form-section.orb

@@ -1139,8 +1139,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"
             },
@@ -1341,7 +1341,7 @@
               "tier": "essential"
             },
             {
-              "description": "FormSection rows finished loading; payload.data holds the collection.",
+              "description": "FormSection row finished loading; payload.data holds the single row.",
               "event": "FormSectionLoaded",
               "eventId": "evt_01KXG04SM2DVNXX31353QRB30A",
               "payloadSchema": [
@@ -1355,7 +1355,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -1379,12 +1379,20 @@
           "stateMachine": {
             "events": [
               {
+                "description": "Mount payload; a host that routes to this panel by id (a :id page param) passes it here.",
                 "id": "evt_01KXG04SKZFVRPEFWABSGRQCW9",
                 "key": "INIT",
-                "name": "Initialize"
+                "name": "Initialize",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
               },
               {
-                "description": "FormSection rows finished loading; payload.data holds the collection.",
+                "description": "FormSection row finished loading; payload.data holds the single row.",
                 "id": "evt_01KXG04SM2DVNXX31353QRB30A",
                 "key": "FormSectionLoaded",
                 "name": "Form section loaded",
@@ -1399,7 +1407,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -1504,6 +1512,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -1516,7 +1527,8 @@
                     {
                       "emit": {
                         "success": "FormSectionLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -1559,8 +1571,25 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SKZFVRPEFWABSGRQCW9",
-                "from": "idle",
-                "guard": "@config.selfFetch",
+                "from": "resolving",
+                "guard": [
+                  "and",
+                  "@config.selfFetch",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      "@payload.id",
+                      ""
+                    ],
+                    ""
+                  ],
+                  [
+                    "!=",
+                    "@config.mode",
+                    "create"
+                  ]
+                ],
                 "to": "idle"
               },
               {
@@ -1605,11 +1634,73 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SKZFVRPEFWABSGRQCW9",
-                "from": "idle",
+                "from": "resolving",
                 "guard": [
                   "not",
-                  "@config.selfFetch"
+                  [
+                    "and",
+                    "@config.selfFetch",
+                    [
+                      "!=",
+                      [
+                        "str/default",
+                        "@payload.id",
+                        ""
+                      ],
+                      ""
+                    ],
+                    [
+                      "!=",
+                      "@config.mode",
+                      "create"
+                    ]
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "cancelEvent": "@config.cancelEvent",
+                      "cancelLabel": "@config.cancelLabel",
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "conditionalFields": "@config.conditionalFields",
+                      "configPath": "@config.configPath",
+                      "entity": "@entity",
+                      "error": "@config.error",
+                      "evaluationContext": "@config.evaluationContext",
+                      "fieldOverrides": "@config.fieldOverrides",
+                      "fields": "@config.fields",
+                      "gap": "@config.gap",
+                      "hiddenCalculations": "@config.hiddenCalculations",
+                      "initialData": "@entity",
+                      "isLoading": "@config.isLoading",
+                      "layout": "@config.layout",
+                      "mode": "@config.mode",
+                      "onCancel": "@config.onCancel",
+                      "onFieldChange": "@config.onFieldChange",
+                      "onSubmit": "@config.onSubmit",
+                      "relationsData": "@config.relationsData",
+                      "relationsLoading": "@config.relationsLoading",
+                      "repeatable": "@config.repeatable",
+                      "sections": "@config.sections",
+                      "showCancel": "@config.showCancel",
+                      "showSubmit": "@config.showSubmit",
+                      "submitEvent": "@config.submitEvent",
+                      "submitLabel": "@config.submitLabel",
+                      "title": "@config.title",
+                      "type": "form-section",
+                      "violationTriggers": "@config.violationTriggers"
+                    }
+                  ]
                 ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04SKZFVRPEFWABSGRQCW9",
+                "from": "idle",
                 "to": "idle"
               },
               {
@@ -1624,7 +1715,7 @@
                       "className": "@config.className",
                       "conditionalFields": "@config.conditionalFields",
                       "configPath": "@config.configPath",
-                      "entity": "@payload.data",
+                      "entity": "@entity",
                       "error": "@config.error",
                       "evaluationContext": "@config.evaluationContext",
                       "fieldOverrides": "@config.fieldOverrides",

package/behaviors/registry/ui/core/organisms/ui-form.orb

@@ -1139,8 +1139,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"
             },
@@ -1341,7 +1341,7 @@
               "tier": "essential"
             },
             {
-              "description": "Form rows finished loading; payload.data holds the collection.",
+              "description": "Form row finished loading; payload.data holds the single row.",
               "event": "FormLoaded",
               "eventId": "evt_01KXG04SPJ2STJW3Y490CWSZ1M",
               "payloadSchema": [
@@ -1355,7 +1355,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -1379,12 +1379,20 @@
           "stateMachine": {
             "events": [
               {
+                "description": "Mount payload; a host that routes to this panel by id (a :id page param) passes it here.",
                 "id": "evt_01KXG04SPFFQ0K590SFJPYS7MM",
                 "key": "INIT",
-                "name": "Initialize"
+                "name": "Initialize",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
               },
               {
-                "description": "Form rows finished loading; payload.data holds the collection.",
+                "description": "Form row finished loading; payload.data holds the single row.",
                 "id": "evt_01KXG04SPJ2STJW3Y490CWSZ1M",
                 "key": "FormLoaded",
                 "name": "Form loaded",
@@ -1399,7 +1407,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -1504,6 +1512,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -1516,7 +1527,8 @@
                     {
                       "emit": {
                         "success": "FormLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -1559,8 +1571,25 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SPFFQ0K590SFJPYS7MM",
-                "from": "idle",
-                "guard": "@config.selfFetch",
+                "from": "resolving",
+                "guard": [
+                  "and",
+                  "@config.selfFetch",
+                  [
+                    "!=",
+                    [
+                      "str/default",
+                      "@payload.id",
+                      ""
+                    ],
+                    ""
+                  ],
+                  [
+                    "!=",
+                    "@config.mode",
+                    "create"
+                  ]
+                ],
                 "to": "idle"
               },
               {
@@ -1605,11 +1634,73 @@
                 ],
                 "event": "INIT",
                 "eventId": "evt_01KXG04SPFFQ0K590SFJPYS7MM",
-                "from": "idle",
+                "from": "resolving",
                 "guard": [
                   "not",
-                  "@config.selfFetch"
+                  [
+                    "and",
+                    "@config.selfFetch",
+                    [
+                      "!=",
+                      [
+                        "str/default",
+                        "@payload.id",
+                        ""
+                      ],
+                      ""
+                    ],
+                    [
+                      "!=",
+                      "@config.mode",
+                      "create"
+                    ]
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "cancelEvent": "@config.cancelEvent",
+                      "cancelLabel": "@config.cancelLabel",
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "conditionalFields": "@config.conditionalFields",
+                      "configPath": "@config.configPath",
+                      "entity": "@entity",
+                      "error": "@config.error",
+                      "evaluationContext": "@config.evaluationContext",
+                      "fieldOverrides": "@config.fieldOverrides",
+                      "fields": "@config.fields",
+                      "gap": "@config.gap",
+                      "hiddenCalculations": "@config.hiddenCalculations",
+                      "initialData": "@entity",
+                      "isLoading": "@config.isLoading",
+                      "layout": "@config.layout",
+                      "mode": "@config.mode",
+                      "onCancel": "@config.onCancel",
+                      "onFieldChange": "@config.onFieldChange",
+                      "onSubmit": "@config.onSubmit",
+                      "relationsData": "@config.relationsData",
+                      "relationsLoading": "@config.relationsLoading",
+                      "repeatable": "@config.repeatable",
+                      "sections": "@config.sections",
+                      "showCancel": "@config.showCancel",
+                      "showSubmit": "@config.showSubmit",
+                      "submitEvent": "@config.submitEvent",
+                      "submitLabel": "@config.submitLabel",
+                      "title": "@config.title",
+                      "type": "form",
+                      "violationTriggers": "@config.violationTriggers"
+                    }
+                  ]
                 ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04SPFFQ0K590SFJPYS7MM",
+                "from": "idle",
                 "to": "idle"
               },
               {
@@ -1624,7 +1715,7 @@
                       "className": "@config.className",
                       "conditionalFields": "@config.conditionalFields",
                       "configPath": "@config.configPath",
-                      "entity": "@payload.data",
+                      "entity": "@entity",
                       "error": "@config.error",
                       "evaluationContext": "@config.evaluationContext",
                       "fieldOverrides": "@config.fieldOverrides",

package/behaviors/registry/ui/core/organisms/ui-media-gallery.orb

@@ -118,6 +118,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
                   "variant": {
                     "name": "variant",
                     "required": false,
@@ -351,6 +359,13 @@
               "label": "Total Count",
               "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": [
@@ -481,7 +496,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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
                       "className": "@config.className",
@@ -518,7 +566,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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
                       "className": "@config.className",
@@ -558,7 +639,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"
+                            ]
+                          ]
+                        ]
+                      ],
                       "activeFilters": "@config.activeFilters",
                       "aspectRatio": "@config.aspectRatio",
                       "className": "@config.className",
@@ -610,6 +724,10 @@
           {
             "name": "variant",
             "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
           }
         ],
         "MediaGalleryError": [

package/behaviors/registry/ui/core/organisms/ui-state-machine-view.orb

@@ -183,6 +183,13 @@
                 "gear"
               ]
             },
+            "onTransitionClick": {
+              "default": "TRANSITION_CLICK",
+              "description": "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+              "label": "On Transition Click",
+              "tier": "presentation",
+              "type": "event"
+            },
             "pendingSourceState": {
               "description": "Source of a transition being drawn — the next state click picks its target.",
               "label": "Pending Source State",
@@ -391,6 +398,32 @@
                   "name": "to",
                   "required": true,
                   "type": "string"
+                },
+                {
+                  "name": "transition",
+                  "properties": [
+                    {
+                      "name": "index",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "event",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "from",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "to",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "object"
                 }
               ],
               "scope": "external",
@@ -456,6 +489,32 @@
                     "name": "to",
                     "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "transition",
+                    "properties": [
+                      {
+                        "name": "index",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "event",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "from",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "to",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "object"
                   }
                 ],
                 "tier": "essential"
@@ -482,6 +541,7 @@
                       "error": "@config.error",
                       "isLoading": "@config.isLoading",
                       "nodeShape": "@config.nodeShape",
+                      "onTransitionClick": "@config.onTransitionClick",
                       "pendingSourceState": "@config.pendingSourceState",
                       "selectedState": "@config.selectedState",
                       "showHeader": "@config.showHeader",
@@ -522,6 +582,28 @@
             "type": "string"
           }
         ],
+        "StateMachineViewTRANSITIONCLICKTransition": [
+          {
+            "name": "index",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "event",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "from",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "to",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "StateMachineViewTrait": [
           {
             "name": "name",