@almadar/std 16.152.0 → 16.153.0

package/behaviors/registry/ui/core/molecules/ui-emoji-picker.orb

@@ -0,0 +1,214 @@
+{
+  "description": "EmojiPicker — UI factory (1:1 with the @almadar/ui emoji-picker pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01KYQH4C3Q9BVPB3K23JCEX9A4": {
+        "bakedName": "EmojiPickerItem",
+        "curName": "EmojiPickerItem",
+        "id": "ent_01KYQH4C3Q9BVPB3K23JCEX9A4",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYQH4C3Q8PNKE9JWBWBV1MJY": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYQH4C3Q8PNKE9JWBWBV1MJY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYQH4C3QDP4SZTQXM1REWR2C",
+        "renames": []
+      },
+      "evt_01KYQH4C422XMP60F6KRA0A70N": {
+        "bakedName": "@config.pickEvent",
+        "curName": "@config.pickEvent",
+        "id": "evt_01KYQH4C422XMP60F6KRA0A70N",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYQH4C3QDP4SZTQXM1REWR2C",
+        "renames": []
+      },
+      "orb_01KYQH4C3QSJA8JK76ZYH10CMT": {
+        "bakedName": "EmojiPickerOrbital",
+        "curName": "EmojiPickerOrbital",
+        "id": "orb_01KYQH4C3QSJA8JK76ZYH10CMT",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYQH4C43QP034T5Y20CFKP8C": {
+        "bakedName": "EmojiPickerPage",
+        "curName": "EmojiPickerPage",
+        "id": "pag_01KYQH4C43QP034T5Y20CFKP8C",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYQH4C3QDP4SZTQXM1REWR2C": {
+        "bakedName": "EmojiPickerRender",
+        "curName": "EmojiPickerRender",
+        "id": "trt_01KYQH4C3QDP4SZTQXM1REWR2C",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-emoji-picker",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01KYQH4C3Q9BVPB3K23JCEX9A4",
+        "name": "EmojiPickerItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYQH4C3QSJA8JK76ZYH10CMT",
+      "name": "EmojiPickerOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYQH4C43QP034T5Y20CFKP8C",
+          "name": "EmojiPickerPage",
+          "path": "/emoji-picker",
+          "traits": [
+            {
+              "ref": "EmojiPickerRender",
+              "refId": "trt_01KYQH4C3QDP4SZTQXM1REWR2C"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "className": {
+              "description": "Additional CSS classes applied to the trigger button",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "pickEvent": {
+              "default": "PICK",
+              "description": "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+              "label": "Pick Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "position": {
+              "default": "top",
+              "description": "Which side of the trigger the panel opens on",
+              "label": "Position",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "top",
+                "bottom"
+              ]
+            },
+            "triggerIcon": {
+              "description": "Icon shown on the trigger button",
+              "label": "Trigger Icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "triggerLabel": {
+              "default": "Add emoji",
+              "description": "Accessible label for the trigger button",
+              "label": "Trigger Label",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+              "event": "@config.pickEvent",
+              "eventId": "evt_01KYQH4C422XMP60F6KRA0A70N",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "EmojiPickerItem": "ent_01KYQH4C3Q9BVPB3K23JCEX9A4"
+          },
+          "id": "trt_01KYQH4C3QDP4SZTQXM1REWR2C",
+          "linkedEntity": "EmojiPickerItem",
+          "linkedEntityId": "ent_01KYQH4C3Q9BVPB3K23JCEX9A4",
+          "name": "EmojiPickerRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYQH4C3Q8PNKE9JWBWBV1MJY",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+                "id": "evt_01KYQH4C422XMP60F6KRA0A70N",
+                "key": "@config.pickEvent",
+                "name": "@config.pick event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "pickEvent": "@config.pickEvent",
+                      "position": "@config.position",
+                      "triggerIcon": "@config.triggerIcon",
+                      "triggerLabel": "@config.triggerLabel",
+                      "type": "emoji-picker"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYQH4C3Q8PNKE9JWBWBV1MJY",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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

@@ -19,6 +19,24 @@
         "parent": "trt_01KXG04QHPHB07PFRVRXWCZZZ3",
         "renames": []
       },
+      "evt_01KYQH4C8T000A3RVFDAXSCAXR": {
+        "bakedName": "OPEN_CHANGE",
+        "curName": "OPEN_CHANGE",
+        "id": "evt_01KYQH4C8T000A3RVFDAXSCAXR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04QHPHB07PFRVRXWCZZZ3",
+        "renames": []
+      },
+      "evt_01KYQH4C8TH1DGZ4141EYBQ2JG": {
+        "bakedName": "@config.onOpenChange",
+        "curName": "@config.onOpenChange",
+        "id": "evt_01KYQH4C8TH1DGZ4141EYBQ2JG",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04QHPHB07PFRVRXWCZZZ3",
+        "renames": []
+      },
       "orb_01KXG04QHN73J68Z4BJMKERHWN": {
         "bakedName": "PopoverOrbital",
         "curName": "PopoverOrbital",
@@ -55,6 +73,10 @@
             "name": "id",
             "required": true,
             "type": "string"
+          },
+          {
+            "name": "open",
+            "type": "boolean"
           }
         ],
         "id": "ent_01KXG04QHPFXYX2GXK0M1509YJ",
@@ -98,6 +120,19 @@
               "tier": "presentation",
               "type": "node"
             },
+            "onOpenChange": {
+              "default": "OPEN_CHANGE",
+              "description": "Fired when the popover wants to change visibility (trigger click, outside click)",
+              "label": "On Open Change",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "open": {
+              "description": "Controlled open state. When set, the host owns visibility and the popover reports intent through onOpenChange instead of toggling itself.",
+              "label": "Open",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "position": {
               "default": "bottom",
               "description": "Popover position",
@@ -130,8 +165,25 @@
               ]
             }
           },
+          "emits": [
+            {
+              "description": "Fired when the popover wants to change visibility (trigger click, outside click)",
+              "event": "@config.onOpenChange",
+              "eventId": "evt_01KYQH4C8TH1DGZ4141EYBQ2JG",
+              "payloadSchema": [
+                {
+                  "name": "open",
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
-            "provides": [],
+            "provides": [
+              "open"
+            ],
             "requires": []
           },
           "entityRebindable": true,
@@ -149,6 +201,30 @@
                 "id": "evt_01KXG04QHPR5WWNS2YTHXGN3V7",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYQH4C8T000A3RVFDAXSCAXR",
+                "key": "OPEN_CHANGE",
+                "name": "Open Change",
+                "payloadSchema": [
+                  {
+                    "name": "open",
+                    "type": "boolean"
+                  }
+                ]
+              },
+              {
+                "description": "Fired when the popover wants to change visibility (trigger click, outside click)",
+                "id": "evt_01KYQH4C8TH1DGZ4141EYBQ2JG",
+                "key": "@config.onOpenChange",
+                "name": "@config.on open change",
+                "payloadSchema": [
+                  {
+                    "name": "open",
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -160,6 +236,11 @@
             "transitions": [
               {
                 "effects": [
+                  [
+                    "set",
+                    "@entity.open",
+                    "@config.open"
+                  ],
                   [
                     "render-ui",
                     "main",
@@ -167,6 +248,8 @@
                       "children": "@config.children",
                       "className": "@config.className",
                       "content": "@config.content",
+                      "onOpenChange": "@config.onOpenChange",
+                      "open": "@entity.open",
                       "position": "@config.position",
                       "showArrow": "@config.showArrow",
                       "trigger": "@config.trigger",
@@ -178,6 +261,34 @@
                 "eventId": "evt_01KXG04QHPR5WWNS2YTHXGN3V7",
                 "from": "idle",
                 "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.open",
+                    "@payload.open"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "content": "@config.content",
+                      "onOpenChange": "@config.onOpenChange",
+                      "open": "@entity.open",
+                      "position": "@config.position",
+                      "showArrow": "@config.showArrow",
+                      "trigger": "@config.trigger",
+                      "type": "popover"
+                    }
+                  ]
+                ],
+                "event": "OPEN_CHANGE",
+                "eventId": "evt_01KYQH4C8T000A3RVFDAXSCAXR",
+                "from": "idle",
+                "to": "idle"
               }
             ]
           }

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

@@ -55,6 +55,15 @@
         "parent": "trt_01KXG04RSAMGZ70BX7E6M2EKPH",
         "renames": []
       },
+      "evt_01KYQ93WDMPFGCAXSHZQ4RAVKK": {
+        "bakedName": "@config.itemClickEvent",
+        "curName": "@config.itemClickEvent",
+        "id": "evt_01KYQ93WDMPFGCAXSHZQ4RAVKK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04RSAMGZ70BX7E6M2EKPH",
+        "renames": []
+      },
       "orb_01KXG04RSAMH7355J2NZQRJWY9": {
         "bakedName": "TableViewOrbital",
         "curName": "TableViewOrbital",
@@ -407,6 +416,13 @@
               "tier": "presentation",
               "type": "[TableViewItemActionsItem]"
             },
+            "itemClickEvent": {
+              "default": "ITEM_CLICK",
+              "description": "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win). Mirrors DataList's contract.",
+              "label": "Item Click Event",
+              "tier": "presentation",
+              "type": "string"
+            },
             "look": {
               "default": "dense",
               "description": "Layer 2 visual treatment — mirrors the data-list / entity-table look enum so authors share one knob name across row renderers.",
@@ -502,6 +518,19 @@
             }
           },
           "emits": [
+            {
+              "description": "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win). Mirrors DataList's contract.",
+              "event": "@config.itemClickEvent",
+              "eventId": "evt_01KYQ93WDMPFGCAXSHZQ4RAVKK",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
             {
               "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
               "event": "@config.selectEvent",
@@ -590,6 +619,19 @@
                 "synonyms": "loaded, fetched, retrieved",
                 "tier": "essential"
               },
+              {
+                "description": "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win). Mirrors DataList's contract.",
+                "id": "evt_01KYQ93WDMPFGCAXSHZQ4RAVKK",
+                "key": "@config.itemClickEvent",
+                "name": "@config.item click event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
               {
                 "description": "Event emitted on selection change: UI:{selectEvent} with { ids, rows }.",
                 "id": "evt_01KXG04RSDTCZQPH74KHHQR5MZ",
@@ -666,6 +708,7 @@
                       "groupBy": "@config.groupBy",
                       "isLoading": "@config.isLoading",
                       "itemActions": "@config.itemActions",
+                      "itemClickEvent": "@config.itemClickEvent",
                       "look": "@config.look",
                       "maxInlineActions": "@config.maxInlineActions",
                       "pageSize": "@config.pageSize",
@@ -707,6 +750,7 @@
                       "groupBy": "@config.groupBy",
                       "isLoading": "@config.isLoading",
                       "itemActions": "@config.itemActions",
+                      "itemClickEvent": "@config.itemClickEvent",
                       "look": "@config.look",
                       "maxInlineActions": "@config.maxInlineActions",
                       "pageSize": "@config.pageSize",

package/behaviors/registry/ui/game/atoms/std-arcade-flow.orb

@@ -158,6 +158,7 @@
           "linkedEntity": "ArcadeFlowData",
           "linkedEntityId": "ent_01KXG04TDX07HTCNYVNDHC53RK",
           "name": "ArcadeFlow",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-arcade-play.orb

@@ -280,6 +280,7 @@
           "linkedEntity": "ArcadePlayData",
           "linkedEntityId": "ent_01KXG04TEBH2S8F34K30KH30N1",
           "name": "ArcadePlay",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-chase-ai.orb

@@ -334,6 +334,7 @@
           "linkedEntity": "ChaseState",
           "linkedEntityId": "ent_01KXG04TEWGVEGGK1NQKS6APGC",
           "name": "ChaseAi",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-dungeon-combat.orb

@@ -433,6 +433,7 @@
           "linkedEntity": "DungeonCombatData",
           "linkedEntityId": "ent_01KXG04TFHJXHJH03SBR5C2V8Q",
           "name": "DungeonCombat",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-fx-particles.orb

@@ -211,6 +211,7 @@
           "linkedEntity": "FxState",
           "linkedEntityId": "ent_01KXG04TFZP9QXE9KF516SP9KC",
           "name": "FxParticles",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-gather.orb

@@ -436,6 +436,7 @@
           "linkedEntity": "GatherData",
           "linkedEntityId": "ent_01KXG04TGGZJHPYRRS81F9PP09",
           "name": "Gather",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-gold.orb

@@ -165,6 +165,7 @@
           "linkedEntity": "GoldData",
           "linkedEntityId": "ent_01KXG04TH3Y6NVBGH0NAHJSXNN",
           "name": "GoldMine",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-grid-tactics.orb

@@ -416,6 +416,7 @@
           "linkedEntity": "TacticsState",
           "linkedEntityId": "ent_01KXG04THRXWP7JG6D7NKVW1RQ",
           "name": "GridTactics",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-hero-nav.orb

@@ -394,6 +394,7 @@
           "linkedEntity": "HeroNavData",
           "linkedEntityId": "ent_01KXG04TJB0VKAFAXTSAQ751BT",
           "name": "HeroNav",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-market-flow.orb

@@ -165,6 +165,7 @@
           "linkedEntity": "MarketFlowData",
           "linkedEntityId": "ent_01KXG04TJW5RCS4DQVWH384F5W",
           "name": "MarketFlow",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-objective-flow.orb

@@ -151,6 +151,7 @@
           "linkedEntity": "FlowState",
           "linkedEntityId": "ent_01KXG04TKBJ5BFB1E634XZRG5Z",
           "name": "ObjectiveFlow",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-objective-reach.orb

@@ -441,6 +441,7 @@
           "linkedEntity": "ObjectiveState",
           "linkedEntityId": "ent_01KXG04TKT589Q8E6DEHJMMF61",
           "name": "ObjectiveReach",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-patience.orb

@@ -451,6 +451,7 @@
           "linkedEntity": "PatienceData",
           "linkedEntityId": "ent_01KXG04TMDA7KDAZVATM3XK8K0",
           "name": "Patience",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-production.orb

@@ -243,6 +243,7 @@
           "linkedEntity": "ProductionState",
           "linkedEntityId": "ent_01KXG04TMX5VXK8YE9TAHMXSMW",
           "name": "Producer",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-round-flow.orb

@@ -141,6 +141,7 @@
           "linkedEntity": "RoundState",
           "linkedEntityId": "ent_01KXG04TNC4MHVDJM20C3DJKX1",
           "name": "RoundFlow",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-score.orb

@@ -144,6 +144,7 @@
           "linkedEntity": "ScoreState",
           "linkedEntityId": "ent_01KXG04TNSC9WJATDGG5AES67C",
           "name": "ScoreKeeper",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-survival-flow.orb

@@ -160,6 +160,7 @@
           "linkedEntity": "SurvivalFlowData",
           "linkedEntityId": "ent_01KXG04TP606Z9Y15XFV49JRM1",
           "name": "SurvivalFlow",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/std-xp.orb

@@ -214,6 +214,7 @@
           "linkedEntity": "XpState",
           "linkedEntityId": "ent_01KXG04TPPCTES5FATA48QHG9W",
           "name": "XpProgression",
+          "scope": "instance",
           "stateMachine": {
             "events": [
               {

package/behaviors/registry/ui/game/atoms/ui-draw-sprite.orb

@@ -195,7 +195,7 @@
               "type": "json"
             },
             "height": {
-              "description": "Draw height in world units (fractions of `projector.tileWidth`); omitted → resolved source height in px.",
+              "description": "Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`.",
               "label": "Height",
               "tier": "presentation",
               "type": "number"
@@ -248,7 +248,7 @@
               "type": "json"
             },
             "width": {
-              "description": "Draw width in world units (fractions of `projector.tileWidth`); omitted → resolved source width in px.",
+              "description": "Draw width in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`.",
               "label": "Width",
               "tier": "presentation",
               "type": "number"