@almadar/std 16.235.0 → 16.237.0

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

@@ -643,6 +643,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "max": {
                     "name": "max",
                     "required": false,
@@ -1001,6 +1009,14 @@
                           "required": false,
                           "type": "string"
                         },
+                        "labels": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "name": "labels",
+                          "required": false,
+                          "type": "object"
+                        },
                         "max": {
                           "name": "max",
                           "required": false,
@@ -1139,8 +1155,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 +1357,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 +1371,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -1379,12 +1395,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 +1423,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -1504,6 +1528,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -1516,7 +1543,8 @@
                     {
                       "emit": {
                         "success": "FormSectionLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -1559,8 +1587,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 +1650,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 +1731,7 @@
                       "className": "@config.className",
                       "conditionalFields": "@config.conditionalFields",
                       "configPath": "@config.configPath",
-                      "entity": "@payload.data",
+                      "entity": "@entity",
                       "error": "@config.error",
                       "evaluationContext": "@config.evaluationContext",
                       "fieldOverrides": "@config.fieldOverrides",
@@ -1922,6 +2029,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [
@@ -2160,6 +2271,10 @@
                 "name": "values",
                 "type": "[string]"
               },
+              {
+                "name": "labels",
+                "type": "Map<string,string>"
+              },
               {
                 "name": "relation",
                 "properties": [
@@ -2319,6 +2434,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [

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

@@ -643,6 +643,14 @@
                     "required": false,
                     "type": "string"
                   },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
                   "max": {
                     "name": "max",
                     "required": false,
@@ -1001,6 +1009,14 @@
                           "required": false,
                           "type": "string"
                         },
+                        "labels": {
+                          "items": {
+                            "type": "string"
+                          },
+                          "name": "labels",
+                          "required": false,
+                          "type": "object"
+                        },
                         "max": {
                           "name": "max",
                           "required": false,
@@ -1139,8 +1155,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 +1357,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 +1371,7 @@
                       "type": "string"
                     }
                   ],
-                  "type": "[object]"
+                  "type": "object"
                 }
               ],
               "scope": "internal",
@@ -1379,12 +1395,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 +1423,7 @@
                         "type": "string"
                       }
                     ],
-                    "type": "[object]"
+                    "type": "object"
                   }
                 ],
                 "synonyms": "loaded, fetched, retrieved",
@@ -1504,6 +1528,9 @@
             "states": [
               {
                 "isInitial": true,
+                "name": "resolving"
+              },
+              {
                 "name": "idle"
               }
             ],
@@ -1516,7 +1543,8 @@
                     {
                       "emit": {
                         "success": "FormLoaded"
-                      }
+                      },
+                      "id": "@payload.id"
                     }
                   ],
                   [
@@ -1559,8 +1587,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 +1650,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 +1731,7 @@
                       "className": "@config.className",
                       "conditionalFields": "@config.conditionalFields",
                       "configPath": "@config.configPath",
-                      "entity": "@payload.data",
+                      "entity": "@entity",
                       "error": "@config.error",
                       "evaluationContext": "@config.evaluationContext",
                       "fieldOverrides": "@config.fieldOverrides",
@@ -1922,6 +2029,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [
@@ -2160,6 +2271,10 @@
                 "name": "values",
                 "type": "[string]"
               },
+              {
+                "name": "labels",
+                "type": "Map<string,string>"
+              },
               {
                 "name": "relation",
                 "properties": [
@@ -2319,6 +2434,10 @@
             "name": "values",
             "type": "[string]"
           },
+          {
+            "name": "labels",
+            "type": "Map<string,string>"
+          },
           {
             "name": "relation",
             "properties": [