@almadar/std 16.199.0 → 16.201.0

package/behaviors/registry/ui/core/atoms/ui-conditional-wrapper.orb

@@ -108,24 +108,252 @@
               "label": "Context",
               "properties": {
                 "entity": {
+                  "items": {
+                    "properties": {
+                      "FileValue": {
+                        "name": "FileValue",
+                        "properties": {
+                          "mimeType": {
+                            "name": "mimeType",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "name": {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "sizeBytes": {
+                            "name": "sizeBytes",
+                            "required": true,
+                            "type": "number"
+                          },
+                          "url": {
+                            "name": "url",
+                            "required": true,
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "array": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "array",
+                        "type": "array"
+                      },
+                      "boolean": {
+                        "name": "boolean",
+                        "type": "boolean"
+                      },
+                      "number": {
+                        "name": "number",
+                        "type": "number"
+                      },
+                      "string": {
+                        "name": "string",
+                        "type": "string"
+                      }
+                    },
+                    "type": "union",
+                    "values": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "FileValue"
+                    ]
+                  },
                   "name": "entity",
                   "required": false,
-                  "type": "opaque"
+                  "type": "object"
                 },
                 "formValues": {
+                  "items": {
+                    "properties": {
+                      "FileValue": {
+                        "name": "FileValue",
+                        "properties": {
+                          "mimeType": {
+                            "name": "mimeType",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "name": {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "sizeBytes": {
+                            "name": "sizeBytes",
+                            "required": true,
+                            "type": "number"
+                          },
+                          "url": {
+                            "name": "url",
+                            "required": true,
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "array": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "array",
+                        "type": "array"
+                      },
+                      "boolean": {
+                        "name": "boolean",
+                        "type": "boolean"
+                      },
+                      "number": {
+                        "name": "number",
+                        "type": "number"
+                      },
+                      "string": {
+                        "name": "string",
+                        "type": "string"
+                      }
+                    },
+                    "type": "union",
+                    "values": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "FileValue"
+                    ]
+                  },
                   "name": "formValues",
                   "required": true,
-                  "type": "opaque"
+                  "type": "object"
                 },
                 "globalVariables": {
+                  "items": {
+                    "properties": {
+                      "FileValue": {
+                        "name": "FileValue",
+                        "properties": {
+                          "mimeType": {
+                            "name": "mimeType",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "name": {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "sizeBytes": {
+                            "name": "sizeBytes",
+                            "required": true,
+                            "type": "number"
+                          },
+                          "url": {
+                            "name": "url",
+                            "required": true,
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "array": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "array",
+                        "type": "array"
+                      },
+                      "boolean": {
+                        "name": "boolean",
+                        "type": "boolean"
+                      },
+                      "number": {
+                        "name": "number",
+                        "type": "number"
+                      },
+                      "string": {
+                        "name": "string",
+                        "type": "string"
+                      }
+                    },
+                    "type": "union",
+                    "values": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "FileValue"
+                    ]
+                  },
                   "name": "globalVariables",
                   "required": true,
-                  "type": "opaque"
+                  "type": "object"
                 },
                 "localVariables": {
+                  "items": {
+                    "properties": {
+                      "FileValue": {
+                        "name": "FileValue",
+                        "properties": {
+                          "mimeType": {
+                            "name": "mimeType",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "name": {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          "sizeBytes": {
+                            "name": "sizeBytes",
+                            "required": true,
+                            "type": "number"
+                          },
+                          "url": {
+                            "name": "url",
+                            "required": true,
+                            "type": "string"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "array": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "array",
+                        "type": "array"
+                      },
+                      "boolean": {
+                        "name": "boolean",
+                        "type": "boolean"
+                      },
+                      "number": {
+                        "name": "number",
+                        "type": "number"
+                      },
+                      "string": {
+                        "name": "string",
+                        "type": "string"
+                      }
+                    },
+                    "type": "union",
+                    "values": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "FileValue"
+                    ]
+                  },
                   "name": "localVariables",
                   "required": false,
-                  "type": "opaque"
+                  "type": "object"
                 }
               },
               "tier": "presentation",
@@ -189,7 +417,51 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "ConditionalWrapperContext": [
+          {
+            "name": "formValues",
+            "required": true,
+            "type": "Map<string,ControlValue>"
+          },
+          {
+            "name": "globalVariables",
+            "required": true,
+            "type": "Map<string,ControlValue>"
+          },
+          {
+            "name": "localVariables",
+            "type": "Map<string,ControlValue>"
+          },
+          {
+            "name": "entity",
+            "type": "Map<string,ControlValue>"
+          }
+        ],
+        "FileValue": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "url",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "mimeType",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "sizeBytes",
+            "required": true,
+            "type": "number"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/atoms/ui-game-icon.orb

@@ -251,7 +251,62 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "GameIconAssetUrl": [
+          {
+            "name": "url",
+            "required": true,
+            "type": "asset"
+          },
+          {
+            "name": "role",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "category",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "animations",
+            "type": "[string]"
+          },
+          {
+            "name": "style",
+            "type": "string"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "dimension",
+            "type": "string"
+          },
+          {
+            "name": "aspect",
+            "type": "string"
+          },
+          {
+            "name": "atlas",
+            "type": "asset"
+          },
+          {
+            "name": "sprite",
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "type": "string"
+          },
+          {
+            "name": "thumbnailUrl",
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/atoms/ui-icon.orb

@@ -99,19 +99,10 @@
               "type": "string"
             },
             "color": {
-              "default": "primary",
               "description": "Semantic palette token or an arbitrary Tailwind color class.",
               "label": "Color",
               "tier": "presentation",
-              "type": "string",
-              "values": [
-                "primary",
-                "secondary",
-                "success",
-                "warning",
-                "error",
-                "muted"
-              ]
+              "type": "string"
             },
             "icon": {
               "description": "Lucide icon component (preferred for type-safe usage), OR a canonical kebab-case icon name string — a string is treated exactly like `name` so trait/factory authors can pass an icon by name through the `icon` prop.",

package/behaviors/registry/ui/core/atoms/ui-input.orb

@@ -122,7 +122,7 @@
           "config": {
             "action": {
               "default": "ACTION",
-              "description": "Declarative event name for trait dispatch",
+              "description": "Declarative event name for trait dispatch.",
               "label": "Action",
               "tier": "presentation",
               "type": "event"
@@ -262,14 +262,21 @@
           "emits": [
             {
               "definerKnob": "action",
-              "description": "Declarative event name for trait dispatch",
+              "description": "Declarative event name for trait dispatch.",
               "event": "@config.action",
               "eventId": "evt_01KXG04K52E0KDCQQZ6PGG6PRA",
               "payloadSchema": [
                 {
                   "name": "value",
                   "required": true,
-                  "type": "string"
+                  "type": "string",
+                  "typeWhen": [
+                    {
+                      "equals": "number",
+                      "knob": "inputType",
+                      "type": "number"
+                    }
+                  ]
                 }
               ],
               "scope": "external",
@@ -322,12 +329,19 @@
                   {
                     "name": "value",
                     "required": true,
-                    "type": "string"
+                    "type": "string",
+                    "typeWhen": [
+                      {
+                        "equals": "number",
+                        "knob": "inputType",
+                        "type": "number"
+                      }
+                    ]
                   }
                 ]
               },
               {
-                "description": "Declarative event name for trait dispatch",
+                "description": "Declarative event name for trait dispatch.",
                 "id": "evt_01KXG04K52E0KDCQQZ6PGG6PRA",
                 "key": "@config.action",
                 "name": "@config.action",
@@ -335,7 +349,14 @@
                   {
                     "name": "value",
                     "required": true,
-                    "type": "string"
+                    "type": "string",
+                    "typeWhen": [
+                      {
+                        "equals": "number",
+                        "knob": "inputType",
+                        "type": "number"
+                      }
+                    ]
                   }
                 ],
                 "tier": "essential"
@@ -439,7 +460,21 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "InputOptionsItem": [
+          {
+            "name": "value",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/atoms/ui-law-reference-tooltip.orb

@@ -196,7 +196,33 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "LawReferenceTooltipReference": [
+          {
+            "name": "law",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "lawName",
+            "type": "string"
+          },
+          {
+            "name": "article",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "clause",
+            "type": "string"
+          },
+          {
+            "name": "link",
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/ui/core/atoms/ui-select.orb

@@ -109,7 +109,7 @@
           "config": {
             "action": {
               "default": "ACTION",
-              "description": "Declarative event name for trait dispatch",
+              "description": "Declarative event name for trait dispatch — emits `{ value }` on selection commit (same gestures as `onChange`).",
               "label": "Action",
               "tier": "presentation",
               "type": "event"
@@ -224,22 +224,25 @@
               "type": "boolean"
             },
             "value": {
-              "default": [],
               "description": "Current value (string for single, string[] for multiple)",
-              "items": {
-                "type": "string"
-              },
               "label": "Value",
               "tier": "presentation",
-              "type": "[string]"
+              "type": "string"
             }
           },
           "emits": [
             {
               "definerKnob": "action",
-              "description": "Declarative event name for trait dispatch",
+              "description": "Declarative event name for trait dispatch — emits `{ value }` on selection commit (same gestures as `onChange`).",
               "event": "@config.action",
               "eventId": "evt_01KXG04KKDB89J9WEPA27HHG35",
+              "payloadSchema": [
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -281,10 +284,17 @@
                 "name": "Initialize"
               },
               {
-                "description": "Declarative event name for trait dispatch",
+                "description": "Declarative event name for trait dispatch — emits `{ value }` on selection commit (same gestures as `onChange`).",
                 "id": "evt_01KXG04KKDB89J9WEPA27HHG35",
                 "key": "@config.action",
                 "name": "@config.action",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
                 "tier": "essential"
               },
               {
@@ -339,7 +349,57 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "SelectGroupsItem": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "options",
+            "properties": [
+              {
+                "name": "value",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          }
+        ],
+        "SelectGroupsItemOptionsItem": [
+          {
+            "name": "value",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "SelectOptionsItem": [
+          {
+            "name": "value",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

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

@@ -345,7 +345,36 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "AccordionItemsItem": [
+          {
+            "name": "id",
+            "type": "string"
+          },
+          {
+            "name": "header",
+            "type": "node"
+          },
+          {
+            "name": "title",
+            "type": "node"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "node"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean"
+          },
+          {
+            "name": "defaultOpen",
+            "type": "boolean"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,