@almadar/std 16.143.0 → 16.145.0

package/dist/behaviors/registry/ui/core/atoms/std-file-store.orb

@@ -959,6 +959,46 @@
                 "from": "loading",
                 "to": "error"
               },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "StoredFile",
+                    {
+                      "emit": {
+                        "failure": "StoredFileLoadFailed",
+                        "success": "StoredFileLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04GBQ18HVDGB5NHDV52F0",
+                "from": "browsing",
+                "to": "loading"
+              },
               {
                 "effects": [
                   [

package/dist/behaviors/registry/ui/core/atoms/std-version-history.orb

@@ -844,6 +844,46 @@
                 "from": "loading",
                 "to": "error"
               },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Revision",
+                    {
+                      "emit": {
+                        "failure": "RevisionLoadFailed",
+                        "success": "RevisionLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading version history…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04HV9D9FEAFFAPEMZ9RP2",
+                "from": "browsing",
+                "to": "loading"
+              },
               {
                 "effects": [
                   [

package/dist/behaviors/registry/ui/core/atoms/ui-typography.orb

@@ -205,7 +205,7 @@
             },
             "weight": {
               "default": "none",
-              "description": "Font weight override",
+              "description": "Font weight override — `none` = no override, the variant's baked weight applies",
               "label": "Weight",
               "tier": "presentation",
               "type": "string",

package/dist/behaviors/registry/ui/core/molecules/ui-calendar-grid.orb

@@ -169,6 +169,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "colorField": {
+              "default": "color",
+              "description": "Row field holding the chip's Tailwind colour class. Defaults to `color`.",
+              "label": "Color Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "dayWindow": {
               "description": "Override the viewport-driven day window. `'auto'` (default) tracks `window.innerWidth` — 1 day on mobile, 3 on tablet, 7 on laptop+. Pass an explicit number to force a fixed window (useful for print layouts or screenshot tests).",
               "label": "Day Window",
@@ -210,6 +217,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "startField": {
+              "default": "startTime",
+              "description": "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`.",
+              "label": "Start Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "swipeLeftEvent": {
               "default": "SWIPE_LEFT",
               "description": "Event emitted on swipe left (next week): UI:{swipeLeftEvent}",
@@ -234,6 +248,13 @@
               "tier": "presentation",
               "type": "[string]"
             },
+            "titleField": {
+              "default": "title",
+              "description": "Row field holding the chip label. Defaults to `title`. Lets a host bound to its own entity name the column instead of being forced to rename its fields to this grid's contract (same accessor idiom as `DataList`'s `senderField` / `DataGrid`'s `imageField`).",
+              "label": "Title Field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "weekStart": {
               "default": "2024-01-01",
               "description": "Start of the week (defaults to current week's Monday)",
@@ -490,6 +511,7 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "colorField": "@config.colorField",
                       "dayWindow": "@config.dayWindow",
                       "events": "@entity",
                       "longPressEvent": "@config.longPressEvent",
@@ -497,9 +519,11 @@
                       "onDayClick": "@config.onDayClick",
                       "onEventClick": "@config.onEventClick",
                       "onSlotClick": "@config.onSlotClick",
+                      "startField": "@config.startField",
                       "swipeLeftEvent": "@config.swipeLeftEvent",
                       "swipeRightEvent": "@config.swipeRightEvent",
                       "timeSlots": "@config.timeSlots",
+                      "titleField": "@config.titleField",
                       "type": "calendar-grid",
                       "weekStart": "@config.weekStart"
                     }
@@ -517,6 +541,7 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "colorField": "@config.colorField",
                       "dayWindow": "@config.dayWindow",
                       "events": "@payload.data",
                       "longPressEvent": "@config.longPressEvent",
@@ -524,9 +549,11 @@
                       "onDayClick": "@config.onDayClick",
                       "onEventClick": "@config.onEventClick",
                       "onSlotClick": "@config.onSlotClick",
+                      "startField": "@config.startField",
                       "swipeLeftEvent": "@config.swipeLeftEvent",
                       "swipeRightEvent": "@config.swipeRightEvent",
                       "timeSlots": "@config.timeSlots",
+                      "titleField": "@config.titleField",
                       "type": "calendar-grid",
                       "weekStart": "@config.weekStart"
                     }

package/dist/behaviors/registry/ui/core/molecules/ui-data-grid.orb

@@ -524,10 +524,10 @@
                 "tier": "essential"
               },
               {
-                "description": "Selection change event name (emits UI:{selectionEvent} with { selectedIds: string[] })",
-                "id": "evt_01KXG04N8DGC8A3RER0AYS0QJM",
-                "key": "@config.selectionEvent",
-                "name": "@config.selection event",
+                "description": "User opened a record from the list.",
+                "id": "evt_01KXG04N8D4X4590GZE8705366",
+                "key": "VIEW",
+                "name": "View",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -537,10 +537,10 @@
                 "tier": "essential"
               },
               {
-                "description": "Event emitted when more items needed: UI:{loadMoreEvent}",
-                "id": "evt_01KXG04N8D5HH49DN80YD3E4GT",
-                "key": "@config.loadMoreEvent",
-                "name": "@config.load more event",
+                "description": "Selection change event name (emits UI:{selectionEvent} with { selectedIds: string[] })",
+                "id": "evt_01KXG04N8DGC8A3RER0AYS0QJM",
+                "key": "@config.selectionEvent",
+                "name": "@config.selection event",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -550,10 +550,10 @@
                 "tier": "essential"
               },
               {
-                "description": "User opened a record from the list.",
-                "id": "evt_01KXG04N8D4X4590GZE8705366",
-                "key": "VIEW",
-                "name": "View",
+                "description": "Event emitted when more items needed: UI:{loadMoreEvent}",
+                "id": "evt_01KXG04N8D5HH49DN80YD3E4GT",
+                "key": "@config.loadMoreEvent",
+                "name": "@config.load more event",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -664,6 +664,19 @@
                 "eventId": "evt_01KXG04N8DK57488TSZFVFEC94",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04N8D4X4590GZE8705366",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/dist/behaviors/registry/ui/core/molecules/ui-data-list.orb

@@ -685,6 +685,19 @@
                 "synonyms": "loaded, fetched, retrieved",
                 "tier": "essential"
               },
+              {
+                "description": "User opened a record from the list.",
+                "id": "evt_01KXG04N9MDW84T2BWY9EF2FC7",
+                "key": "VIEW",
+                "name": "View",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
               {
                 "description": "Event emitted on reorder: UI:{reorderEvent} with { fromIndex, toIndex }",
                 "id": "evt_01KXG04N9M0MPJ2H0462NH6D5S",
@@ -762,19 +775,6 @@
                   }
                 ],
                 "tier": "essential"
-              },
-              {
-                "description": "User opened a record from the list.",
-                "id": "evt_01KXG04N9MDW84T2BWY9EF2FC7",
-                "key": "VIEW",
-                "name": "View",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  }
-                ],
-                "tier": "essential"
               }
             ],
             "states": [
@@ -888,6 +888,19 @@
                 "eventId": "evt_01KXG04N9M8T9GWGKD8RDCZB00",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04N9MDW84T2BWY9EF2FC7",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/dist/behaviors/registry/ui/core/molecules/ui-filter-group.orb

@@ -37,6 +37,24 @@
         "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
         "renames": []
       },
+      "evt_01KYC06RDGC5AX8D3JVW30MTNT": {
+        "bakedName": "@config.event",
+        "curName": "@config.event",
+        "id": "evt_01KYC06RDGC5AX8D3JVW30MTNT",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
+        "renames": []
+      },
+      "evt_01KYC06RDGJEVGWBTWQKHSHA5J": {
+        "bakedName": "@config.clearEvent",
+        "curName": "@config.clearEvent",
+        "id": "evt_01KYC06RDGJEVGWBTWQKHSHA5J",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04NWZX79JYS9DQRRJSY6D",
+        "renames": []
+      },
       "orb_01KXG04NWZHMEEFXA8JY1SW36Z": {
         "bakedName": "FilterGroupOrbital",
         "curName": "FilterGroupOrbital",
@@ -104,6 +122,20 @@
               "tier": "presentation",
               "type": "string"
             },
+            "clearEvent": {
+              "default": "CLEAR",
+              "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+              "label": "Clear Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "event": {
+              "default": "EVENT",
+              "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+              "label": "Event",
+              "tier": "presentation",
+              "type": "string"
+            },
             "filters": {
               "default": [
                 {
@@ -254,6 +286,32 @@
               ],
               "scope": "external",
               "tier": "essential"
+            },
+            {
+              "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+              "event": "@config.event",
+              "eventId": "evt_01KYC06RDGC5AX8D3JVW30MTNT",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+              "event": "@config.clearEvent",
+              "eventId": "evt_01KYC06RDGJEVGWBTWQKHSHA5J",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
             }
           ],
           "entityContract": {
@@ -305,6 +363,32 @@
                   }
                 ],
                 "tier": "essential"
+              },
+              {
+                "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+                "id": "evt_01KYC06RDGC5AX8D3JVW30MTNT",
+                "key": "@config.event",
+                "name": "@config.event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+                "id": "evt_01KYC06RDGJEVGWBTWQKHSHA5J",
+                "key": "@config.clearEvent",
+                "name": "@config.clear event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -326,7 +410,9 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "clearEvent": "@config.clearEvent",
                       "entity": "FilterGroupItem",
+                      "event": "@config.event",
                       "filters": "@config.filters",
                       "isLoading": "@config.isLoading",
                       "look": "@config.look",

package/dist/behaviors/registry/ui/core/molecules/ui-search-input.orb

@@ -37,6 +37,15 @@
         "parent": "trt_01KXG04R09E51Q5ZC3H3NVM9TC",
         "renames": []
       },
+      "evt_01KYC06S4G3K7GBQ9XAPXR61GW": {
+        "bakedName": "@config.event",
+        "curName": "@config.event",
+        "id": "evt_01KYC06S4G3K7GBQ9XAPXR61GW",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04R09E51Q5ZC3H3NVM9TC",
+        "renames": []
+      },
       "orb_01KXG04R09BDKZJVAQGGAYPS4V": {
         "bakedName": "SearchInputOrbital",
         "curName": "SearchInputOrbital",
@@ -123,7 +132,8 @@
               "type": "number"
             },
             "event": {
-              "description": "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component.",
+              "default": "EVENT",
+              "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
               "label": "Event",
               "tier": "presentation",
               "type": "string"
@@ -174,6 +184,19 @@
               ],
               "scope": "external",
               "tier": "essential"
+            },
+            {
+              "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+              "event": "@config.event",
+              "eventId": "evt_01KYC06S4G3K7GBQ9XAPXR61GW",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
             }
           ],
           "entityContract": {
@@ -221,6 +244,19 @@
                   }
                 ],
                 "tier": "essential"
+              },
+              {
+                "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+                "id": "evt_01KYC06S4G3K7GBQ9XAPXR61GW",
+                "key": "@config.event",
+                "name": "@config.event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [

package/dist/behaviors/registry/ui/core/molecules/ui-table-view.orb

@@ -558,10 +558,10 @@
                 "tier": "essential"
               },
               {
-                "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
-                "id": "evt_01KXG04RSDTCZQPH74KHHQR5MZ",
-                "key": "@config.selectEvent",
-                "name": "@config.select event",
+                "description": "User opened a record from the list.",
+                "id": "evt_01KXG04RSDC4V2E198Y3Q8880X",
+                "key": "VIEW",
+                "name": "View",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -571,10 +571,10 @@
                 "tier": "essential"
               },
               {
-                "description": "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }.",
-                "id": "evt_01KXG04RSDX3BXZBA0CDEKZV1G",
-                "key": "@config.sortEvent",
-                "name": "@config.sort event",
+                "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
+                "id": "evt_01KXG04RSDTCZQPH74KHHQR5MZ",
+                "key": "@config.selectEvent",
+                "name": "@config.select event",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -584,10 +584,10 @@
                 "tier": "essential"
               },
               {
-                "description": "User opened a record from the list.",
-                "id": "evt_01KXG04RSDC4V2E198Y3Q8880X",
-                "key": "VIEW",
-                "name": "View",
+                "description": "Event emitted on sortable-header click: UI:{sortEvent} with { column, direction }.",
+                "id": "evt_01KXG04RSDX3BXZBA0CDEKZV1G",
+                "key": "@config.sortEvent",
+                "name": "@config.sort event",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -694,6 +694,19 @@
                 "eventId": "evt_01KXG04RSDQRXCVM7YXC772W9K",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04RSDC4V2E198Y3Q8880X",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/dist/behaviors/registry/ui/core/organisms/ui-entity-cards.orb

@@ -541,6 +541,19 @@
                 "eventId": "evt_01KXG04SFWBBQT5FQHF88WB1R7",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04SFWKXQ588AJKC3XTPME",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/dist/behaviors/registry/ui/core/organisms/ui-entity-list.orb

@@ -393,10 +393,10 @@
                 "tier": "essential"
               },
               {
-                "description": "Item actions - schema-driven or function-based",
-                "id": "evt_01KXG04SH3CDMWPSH39V0BN1TD",
-                "key": "ITEM_ACTIONS",
-                "name": "Item Actions",
+                "description": "User opened a record from the list.",
+                "id": "evt_01KXG04SH3R1YPRSCJX64JDKM2",
+                "key": "VIEW",
+                "name": "View",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -406,10 +406,10 @@
                 "tier": "essential"
               },
               {
-                "description": "User opened a record from the list.",
-                "id": "evt_01KXG04SH3R1YPRSCJX64JDKM2",
-                "key": "VIEW",
-                "name": "View",
+                "description": "Item actions - schema-driven or function-based",
+                "id": "evt_01KXG04SH3CDMWPSH39V0BN1TD",
+                "key": "ITEM_ACTIONS",
+                "name": "Item Actions",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -506,6 +506,19 @@
                 "eventId": "evt_01KXG04SH3S1G8MB6C8PAC7PMY",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04SH3R1YPRSCJX64JDKM2",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

package/dist/behaviors/registry/ui/core/organisms/ui-entity-table.orb

@@ -637,6 +637,19 @@
                 "eventId": "evt_01KXG04SJJDJHTKN6PP74YNPWJ",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "VIEW",
+                    {}
+                  ]
+                ],
+                "event": "VIEW",
+                "eventId": "evt_01KXG04SJJ648J6B44Z4MCR8KK",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }