@almadar/std 16.227.0 → 16.228.0

package/behaviors/registry/ui/core/atoms/std-graphs.orb

@@ -66,7 +66,20 @@
             "type": "string"
           },
           {
-            "default": [],
+            "default": [
+              {
+                "label": "Active",
+                "value": 6.0
+              },
+              {
+                "label": "Pending",
+                "value": 3.0
+              },
+              {
+                "label": "Inactive",
+                "value": 1.0
+              }
+            ],
             "description": "The data points used to render the chart.",
             "intrinsic": true,
             "items": {
@@ -416,24 +429,6 @@
             "transitions": [
               {
                 "effects": [
-                  [
-                    "set",
-                    "@entity.chartData",
-                    [
-                      {
-                        "label": "Active",
-                        "value": 6.0
-                      },
-                      {
-                        "label": "Pending",
-                        "value": 3.0
-                      },
-                      {
-                        "label": "Inactive",
-                        "value": 1.0
-                      }
-                    ]
-                  ],
                   [
                     "render-ui",
                     "main",

package/behaviors/registry/ui/core/atoms/std-slide-deck.orb

@@ -0,0 +1,546 @@
+{
+  "description": "std-slide-deck — generic presentation atom. An ordered list of slide nodes (`config.slides`, any render tree or @trait) shown one at a time, with a previous/next arrow on either side, a dot strip and a k / n counter underneath, and keyboard stepping through the host's KEY router (`config.nextKeys` / `config.prevKeys`, captured per `config.keymap`). The cursor clamps at either end unless `loop` is on. Each visit mounts the slide fresh, so its own entry animations replay. Carries no content or visual style: a realization supplies the slides and restyles via `bodyContent`. The default body picks the slide inside a mapped-children lambda, which expands static slides only; a deck whose slides hold stateful traits (forms, live lists) overrides `bodyContent` with one `presence` per slide gated on `@entity.slideIndex`. Every move emits SLIDE_CHANGED for speaker notes, timers or analytics.",
+  "ledger": {
+    "entries": {
+      "ent_01M39MPG8EZJMEW9YAGD6SNM0W": {
+        "bakedName": "SlideDeck",
+        "curName": "SlideDeck",
+        "id": "ent_01M39MPG8EZJMEW9YAGD6SNM0W",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M39MPG8EDQH4W0H47M0BDFY3": {
+        "bakedName": "SLIDE_CHANGED",
+        "curName": "SLIDE_CHANGED",
+        "id": "evt_01M39MPG8EDQH4W0H47M0BDFY3",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M39MPG8EP9R7YFMP1RDHRZ23",
+        "renames": []
+      },
+      "evt_01M39MPG8EJYM25W3QY1BGRDRF": {
+        "bakedName": "GO_TO",
+        "curName": "GO_TO",
+        "id": "evt_01M39MPG8EJYM25W3QY1BGRDRF",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M39MPG8EP9R7YFMP1RDHRZ23",
+        "renames": []
+      },
+      "evt_01M39MPG8ER5ADZA6BZSQZ3GC3": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M39MPG8ER5ADZA6BZSQZ3GC3",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M39MPG8EP9R7YFMP1RDHRZ23",
+        "renames": []
+      },
+      "orb_01M39MPG8E8DBNC6ZS0E5S2YBZ": {
+        "bakedName": "SlideDeckOrbital",
+        "curName": "SlideDeckOrbital",
+        "id": "orb_01M39MPG8E8DBNC6ZS0E5S2YBZ",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M39MPG8E6BFGAGMXQDWVEWFH": {
+        "bakedName": "SlideDeckPage",
+        "curName": "SlideDeckPage",
+        "id": "pag_01M39MPG8E6BFGAGMXQDWVEWFH",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M39MPG8EP9R7YFMP1RDHRZ23": {
+        "bakedName": "SlideDeckPresenter",
+        "curName": "SlideDeckPresenter",
+        "id": "trt_01M39MPG8EP9R7YFMP1RDHRZ23",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-slide-deck",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "description": "Zero-based index of the slide currently shown.",
+            "name": "slideIndex",
+            "synonyms": "current slide, cursor, position",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M39MPG8EZJMEW9YAGD6SNM0W",
+        "name": "SlideDeck",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M39MPG8E8DBNC6ZS0E5S2YBZ",
+      "name": "SlideDeckOrbital",
+      "pages": [
+        {
+          "id": "pag_01M39MPG8E6BFGAGMXQDWVEWFH",
+          "name": "SlideDeckPage",
+          "path": "/slide-deck",
+          "traits": [
+            {
+              "ref": "SlideDeckPresenter",
+              "refId": "trt_01M39MPG8EP9R7YFMP1RDHRZ23"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "bodyContent": {
+              "default": {
+                "children": [
+                  {
+                    "align": "center",
+                    "children": [
+                      [
+                        "array/map",
+                        [
+                          [
+                            "array/len",
+                            "@config.slides"
+                          ]
+                        ],
+                        [
+                          "fn",
+                          "n",
+                          [
+                            "if",
+                            "@config.showArrows",
+                            {
+                              "action": "GO_TO",
+                              "actionPayload": {
+                                "index": [
+                                  "if",
+                                  "@config.loop",
+                                  [
+                                    "math/wrap",
+                                    [
+                                      "-",
+                                      "@entity.slideIndex",
+                                      1.0
+                                    ],
+                                    0.0,
+                                    "@n"
+                                  ],
+                                  [
+                                    "math/max",
+                                    0.0,
+                                    [
+                                      "-",
+                                      "@entity.slideIndex",
+                                      1.0
+                                    ]
+                                  ]
+                                ]
+                              },
+                              "disabled": [
+                                "and",
+                                [
+                                  "==",
+                                  "@config.loop",
+                                  false
+                                ],
+                                [
+                                  "<=",
+                                  "@entity.slideIndex",
+                                  0.0
+                                ]
+                              ],
+                              "icon": "@config.prevIcon",
+                              "size": "lg",
+                              "type": "button",
+                              "variant": "ghost"
+                            },
+                            null
+                          ]
+                        ]
+                      ],
+                      {
+                        "children": [
+                          "array/map",
+                          [
+                            "@entity.slideIndex"
+                          ],
+                          [
+                            "fn",
+                            "i",
+                            {
+                              "children": [
+                                [
+                                  "array/nth",
+                                  "@config.slides",
+                                  "@i"
+                                ]
+                              ],
+                              "className": "w-full",
+                              "type": "box"
+                            }
+                          ]
+                        ],
+                        "className": "flex-1 min-w-0",
+                        "minHeight": "@config.stageMinHeight",
+                        "type": "center"
+                      },
+                      [
+                        "array/map",
+                        [
+                          [
+                            "array/len",
+                            "@config.slides"
+                          ]
+                        ],
+                        [
+                          "fn",
+                          "n",
+                          [
+                            "if",
+                            "@config.showArrows",
+                            {
+                              "action": "GO_TO",
+                              "actionPayload": {
+                                "index": [
+                                  "if",
+                                  "@config.loop",
+                                  [
+                                    "math/wrap",
+                                    [
+                                      "+",
+                                      "@entity.slideIndex",
+                                      1.0
+                                    ],
+                                    0.0,
+                                    "@n"
+                                  ],
+                                  [
+                                    "math/min",
+                                    [
+                                      "-",
+                                      "@n",
+                                      1.0
+                                    ],
+                                    [
+                                      "+",
+                                      "@entity.slideIndex",
+                                      1.0
+                                    ]
+                                  ]
+                                ]
+                              },
+                              "disabled": [
+                                "and",
+                                [
+                                  "==",
+                                  "@config.loop",
+                                  false
+                                ],
+                                [
+                                  ">=",
+                                  "@entity.slideIndex",
+                                  [
+                                    "-",
+                                    "@n",
+                                    1.0
+                                  ]
+                                ]
+                              ],
+                              "icon": "@config.nextIcon",
+                              "size": "lg",
+                              "type": "button",
+                              "variant": "ghost"
+                            },
+                            null
+                          ]
+                        ]
+                      ]
+                    ],
+                    "direction": "horizontal",
+                    "gap": "md",
+                    "type": "stack"
+                  },
+                  [
+                    "if",
+                    "@config.showProgress",
+                    {
+                      "align": "center",
+                      "children": [
+                        "array/map",
+                        [
+                          [
+                            "array/len",
+                            "@config.slides"
+                          ]
+                        ],
+                        [
+                          "fn",
+                          "n",
+                          {
+                            "align": "center",
+                            "children": [
+                              {
+                                "count": "@n",
+                                "currentIndex": "@entity.slideIndex",
+                                "onDotClick": "GO_TO",
+                                "size": "sm",
+                                "type": "progress-dots"
+                              },
+                              {
+                                "color": "muted",
+                                "content": [
+                                  "str/concat",
+                                  "",
+                                  [
+                                    "+",
+                                    "@entity.slideIndex",
+                                    1.0
+                                  ],
+                                  " / ",
+                                  "@n"
+                                ],
+                                "type": "typography",
+                                "variant": "caption"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "md",
+                            "type": "stack"
+                          }
+                        ]
+                      ],
+                      "direction": "horizontal",
+                      "gap": "md",
+                      "justify": "center",
+                      "type": "stack"
+                    },
+                    null
+                  ]
+                ],
+                "className": "w-full",
+                "direction": "vertical",
+                "gap": "md",
+                "type": "stack"
+              },
+              "description": "Render-ui tree for the deck. Default: slide centred between previous/next arrows, dot strip and counter below. A realization overrides this to restyle (full-bleed, bottom bar, no chrome) while keeping the same cursor, keys and emits.",
+              "label": "Body content tree",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "loop": {
+              "default": false,
+              "description": "Wrap from the last slide to the first (and back) instead of stopping at either end.",
+              "label": "Loop",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "nextIcon": {
+              "default": "chevron-right",
+              "label": "Next icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "prevIcon": {
+              "default": "chevron-left",
+              "label": "Previous icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "showArrows": {
+              "default": true,
+              "description": "Previous/next buttons on the left and right of the slide.",
+              "label": "Show arrows",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "showProgress": {
+              "default": true,
+              "description": "Dot strip and k / n counter under the slide; dots jump to their slide.",
+              "label": "Show progress",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "slides": {
+              "default": [],
+              "description": "Ordered slide nodes; each entry is a render tree or a @trait reference and is shown one at a time.",
+              "items": {
+                "type": "trait"
+              },
+              "label": "Slides",
+              "tier": "domain",
+              "type": "[trait]"
+            },
+            "stageMinHeight": {
+              "default": "70vh",
+              "description": "Minimum height of the slide stage (any CSS length, e.g. 70vh or 640px); the slide is centred vertically inside it so short and tall slides share one frame.",
+              "label": "Stage height",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "startIndex": {
+              "default": 0.0,
+              "description": "Zero-based slide shown on first render; clamped to the deck.",
+              "label": "Start slide",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "SLIDE_CHANGED"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.slideIndex"
+            }
+          ],
+          "emits": [
+            {
+              "description": "The deck moved to a new slide (zero-based index).",
+              "event": "SLIDE_CHANGED",
+              "eventId": "evt_01M39MPG8EDQH4W0H47M0BDFY3",
+              "payloadSchema": [
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "slide shown, advanced, went back",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "slideIndex"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "SlideDeck": "ent_01M39MPG8EZJMEW9YAGD6SNM0W"
+          },
+          "id": "trt_01M39MPG8EP9R7YFMP1RDHRZ23",
+          "linkedEntity": "SlideDeck",
+          "linkedEntityId": "ent_01M39MPG8EZJMEW9YAGD6SNM0W",
+          "name": "SlideDeckPresenter",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M39MPG8ER5ADZA6BZSQZ3GC3",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Show a zero-based slide index. The arrows and dots send the already-bounded target; a remote or table of contents can send any index.",
+                "id": "evt_01M39MPG8EJYM25W3QY1BGRDRF",
+                "key": "GO_TO",
+                "name": "Go To",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "synonyms": "jump, seek, next slide, previous slide, select slide",
+                "tier": "domain"
+              },
+              {
+                "description": "The deck moved to a new slide (zero-based index).",
+                "id": "evt_01M39MPG8EDQH4W0H47M0BDFY3",
+                "key": "SLIDE_CHANGED",
+                "name": "Slide Changed",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "synonyms": "slide shown, advanced, went back",
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "presenting"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.slideIndex",
+                    "@config.startIndex"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    "@config.bodyContent"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M39MPG8ER5ADZA6BZSQZ3GC3",
+                "from": "presenting",
+                "to": "presenting"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.slideIndex",
+                    "@payload.index"
+                  ],
+                  [
+                    "emit",
+                    "SLIDE_CHANGED",
+                    {
+                      "index": "@entity.slideIndex"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    "@config.bodyContent"
+                  ]
+                ],
+                "event": "GO_TO",
+                "eventId": "evt_01M39MPG8EJYM25W3QY1BGRDRF",
+                "from": "presenting",
+                "to": "presenting"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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

@@ -149,6 +149,13 @@
               "description": "Declarative event: fires on ⌘/Ctrl+Enter with `{ value }`.",
               "event": "@config.action",
               "eventId": "evt_01KXG04MCN5MVPZH4K7YHGNYS0",
+              "payloadSchema": [
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
               "scope": "external",
               "tier": "essential"
             },
@@ -193,6 +200,13 @@
                 "id": "evt_01KXG04MCN5MVPZH4K7YHGNYS0",
                 "key": "@config.action",
                 "name": "@config.action",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
                 "tier": "essential"
               },
               {

package/behaviors/registry/ui/game/atoms/std-choice-gate.orb

@@ -306,7 +306,7 @@
           ],
           "emits": [
             {
-              "description": "The player landed grounded on the gate's correct option; fires once per gate (solved gates stop judging). Carries the gate center so boards can burst the unlock there.",
+              "description": "The player landed grounded on the gate's correct option; fires once per gate (solved gates stop judging). Carries the gate id, the chosen optionId, and the gate center so boards can burst the unlock there.",
               "event": "CHOICE_CORRECT",
               "eventId": "evt_01M144Y1KFKY565GDY3P64AVJQ",
               "payloadSchema": [
@@ -315,6 +315,11 @@
                   "required": true,
                   "type": "string"
                 },
+                {
+                  "name": "optionId",
+                  "required": true,
+                  "type": "string"
+                },
                 {
                   "name": "x",
                   "required": true,
@@ -503,7 +508,7 @@
                 ]
               },
               {
-                "description": "The player landed grounded on the gate's correct option; fires once per gate (solved gates stop judging). Carries the gate center so boards can burst the unlock there.",
+                "description": "The player landed grounded on the gate's correct option; fires once per gate (solved gates stop judging). Carries the gate id, the chosen optionId, and the gate center so boards can burst the unlock there.",
                 "id": "evt_01M144Y1KFKY565GDY3P64AVJQ",
                 "key": "CHOICE_CORRECT",
                 "name": "Choice Correct",
@@ -513,6 +518,11 @@
                     "required": true,
                     "type": "string"
                   },
+                  {
+                    "name": "optionId",
+                    "required": true,
+                    "type": "string"
+                  },
                   {
                     "name": "x",
                     "required": true,
@@ -847,6 +857,11 @@
                                     "@g",
                                     "id"
                                   ],
+                                  "optionId": [
+                                    "object/get",
+                                    "@o",
+                                    "id"
+                                  ],
                                   "x": [
                                     "object/get",
                                     "@g",