@almadar/std 16.228.0 → 16.229.0

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

@@ -0,0 +1,532 @@
+{
+  "description": "std-steps — a numbered 'how it works' sequence from a config list: a numbered marker (or icon), a title and a short description per step, laid out as a row of columns or a vertical list, under an optional heading. Display only — for an interactive stepper use std-step-flow or std-wizard. Pick for onboarding explainers, process overviews and learning paths.",
+  "ledger": {
+    "entries": {
+      "ent_01M3B92534DENVNZNR69WZ9R93": {
+        "bakedName": "StepsView",
+        "curName": "StepsView",
+        "id": "ent_01M3B92534DENVNZNR69WZ9R93",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3B92534H3GMEV9DTSKQ8D8K": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3B92534H3GMEV9DTSKQ8D8K",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B92534ND60VA5QXWJ1SMPG",
+        "renames": []
+      },
+      "orb_01M3B92534TXK2RJPYSSG62B22": {
+        "bakedName": "StepsOrbital",
+        "curName": "StepsOrbital",
+        "id": "orb_01M3B92534TXK2RJPYSSG62B22",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3B925351R2J9SSY1CA4GW69": {
+        "bakedName": "StepsPage",
+        "curName": "StepsPage",
+        "id": "pag_01M3B925351R2J9SSY1CA4GW69",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3B92534ND60VA5QXWJ1SMPG": {
+        "bakedName": "StepsRender",
+        "curName": "StepsRender",
+        "id": "trt_01M3B92534ND60VA5QXWJ1SMPG",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-steps",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3B92534DENVNZNR69WZ9R93",
+        "name": "StepsView",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3B92534TXK2RJPYSSG62B22",
+      "name": "StepsOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3B925351R2J9SSY1CA4GW69",
+          "name": "StepsPage",
+          "path": "/steps",
+          "traits": [
+            {
+              "ref": "StepsRender",
+              "refId": "trt_01M3B92534ND60VA5QXWJ1SMPG"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "alignment": {
+              "default": "center",
+              "label": "Heading alignment",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "center",
+                "start"
+              ]
+            },
+            "heading": {
+              "default": "",
+              "description": "Section heading above the steps; empty hides it",
+              "label": "Heading",
+              "synonyms": "title",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "layout": {
+              "default": "row",
+              "description": "row = side-by-side columns, vertical = a top-to-bottom list",
+              "label": "Layout",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "row",
+                "vertical"
+              ]
+            },
+            "lede": {
+              "default": "",
+              "label": "Supporting text",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "steps": {
+              "default": [
+                {
+                  "description": "Say what you want in plain words.",
+                  "title": "Describe it"
+                },
+                {
+                  "description": "Check the plan before anything is built.",
+                  "title": "Review it"
+                },
+                {
+                  "description": "Publish when it looks right.",
+                  "title": "Ship it"
+                }
+              ],
+              "description": "One entry per step: title, optional description and icon (an icon replaces the step number)",
+              "items": {
+                "properties": {
+                  "description": {
+                    "name": "description",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "title": {
+                    "name": "title",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Steps",
+              "synonyms": "how it works, process, stages, phases, path",
+              "tier": "presentation",
+              "type": "[StepItem]"
+            },
+            "surface": {
+              "default": "plain",
+              "label": "Surface",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "plain",
+                "muted"
+              ]
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "StepsView": "ent_01M3B92534DENVNZNR69WZ9R93"
+          },
+          "id": "trt_01M3B92534ND60VA5QXWJ1SMPG",
+          "linkedEntity": "StepsView",
+          "linkedEntityId": "ent_01M3B92534DENVNZNR69WZ9R93",
+          "name": "StepsRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3B92534H3GMEV9DTSKQ8D8K",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "bg": [
+                        "if",
+                        [
+                          "==",
+                          "@config.surface",
+                          "muted"
+                        ],
+                        "muted",
+                        "transparent"
+                      ],
+                      "children": [
+                        {
+                          "children": [
+                            {
+                              "children": [
+                                {
+                                  "align": [
+                                    "if",
+                                    [
+                                      "==",
+                                      "@config.alignment",
+                                      "center"
+                                    ],
+                                    "center",
+                                    "start"
+                                  ],
+                                  "children": [
+                                    {
+                                      "align": [
+                                        "if",
+                                        [
+                                          "==",
+                                          "@config.alignment",
+                                          "center"
+                                        ],
+                                        "center",
+                                        "left"
+                                      ],
+                                      "className": [
+                                        "if",
+                                        [
+                                          "==",
+                                          "@config.heading",
+                                          ""
+                                        ],
+                                        "hidden",
+                                        "tracking-tight text-balance"
+                                      ],
+                                      "content": "@config.heading",
+                                      "type": "typography",
+                                      "variant": "h2",
+                                      "weight": "bold"
+                                    },
+                                    {
+                                      "align": [
+                                        "if",
+                                        [
+                                          "==",
+                                          "@config.alignment",
+                                          "center"
+                                        ],
+                                        "center",
+                                        "left"
+                                      ],
+                                      "className": [
+                                        "if",
+                                        [
+                                          "==",
+                                          "@config.lede",
+                                          ""
+                                        ],
+                                        "hidden",
+                                        "max-w-2xl text-pretty"
+                                      ],
+                                      "color": "muted",
+                                      "content": "@config.lede",
+                                      "type": "typography",
+                                      "variant": "large"
+                                    }
+                                  ],
+                                  "className": [
+                                    "if",
+                                    [
+                                      "==",
+                                      "@config.heading",
+                                      ""
+                                    ],
+                                    [
+                                      "if",
+                                      [
+                                        "==",
+                                        "@config.lede",
+                                        ""
+                                      ],
+                                      "hidden",
+                                      ""
+                                    ],
+                                    ""
+                                  ],
+                                  "direction": "vertical",
+                                  "gap": "sm",
+                                  "type": "stack"
+                                },
+                                {
+                                  "children": [
+                                    "array/map",
+                                    "@config.steps",
+                                    [
+                                      "fn",
+                                      "step",
+                                      {
+                                        "align": "start",
+                                        "children": [
+                                          {
+                                            "bg": "primary",
+                                            "children": [
+                                              {
+                                                "className": [
+                                                  "if",
+                                                  [
+                                                    "==",
+                                                    [
+                                                      "object/get",
+                                                      "@step",
+                                                      "icon",
+                                                      ""
+                                                    ],
+                                                    ""
+                                                  ],
+                                                  "",
+                                                  "hidden"
+                                                ],
+                                                "color": "inherit",
+                                                "content": [
+                                                  "if",
+                                                  [
+                                                    "==",
+                                                    [
+                                                      "object/get",
+                                                      "@step",
+                                                      "icon",
+                                                      ""
+                                                    ],
+                                                    ""
+                                                  ],
+                                                  [
+                                                    "str/concat",
+                                                    "",
+                                                    [
+                                                      "+",
+                                                      "@index",
+                                                      1.0
+                                                    ]
+                                                  ],
+                                                  ""
+                                                ],
+                                                "type": "typography",
+                                                "variant": "label",
+                                                "weight": "bold"
+                                              },
+                                              {
+                                                "className": [
+                                                  "if",
+                                                  [
+                                                    "==",
+                                                    [
+                                                      "object/get",
+                                                      "@step",
+                                                      "icon",
+                                                      ""
+                                                    ],
+                                                    ""
+                                                  ],
+                                                  "hidden",
+                                                  ""
+                                                ],
+                                                "name": [
+                                                  "object/get",
+                                                  "@step",
+                                                  "icon",
+                                                  ""
+                                                ],
+                                                "size": "sm",
+                                                "type": "icon"
+                                              }
+                                            ],
+                                            "className": "flex h-10 w-10 shrink-0 items-center justify-center text-primary-foreground",
+                                            "rounded": "full",
+                                            "type": "box"
+                                          },
+                                          {
+                                            "children": [
+                                              {
+                                                "content": [
+                                                  "object/get",
+                                                  "@step",
+                                                  "title",
+                                                  ""
+                                                ],
+                                                "type": "typography",
+                                                "variant": "h5",
+                                                "weight": "semibold"
+                                              },
+                                              {
+                                                "className": [
+                                                  "if",
+                                                  [
+                                                    "==",
+                                                    [
+                                                      "object/get",
+                                                      "@step",
+                                                      "description",
+                                                      ""
+                                                    ],
+                                                    ""
+                                                  ],
+                                                  "hidden",
+                                                  "text-pretty"
+                                                ],
+                                                "color": "muted",
+                                                "content": [
+                                                  "object/get",
+                                                  "@step",
+                                                  "description",
+                                                  ""
+                                                ],
+                                                "type": "typography",
+                                                "variant": "body"
+                                              }
+                                            ],
+                                            "direction": "vertical",
+                                            "gap": "xs",
+                                            "type": "stack"
+                                          }
+                                        ],
+                                        "direction": [
+                                          "if",
+                                          [
+                                            "==",
+                                            "@config.layout",
+                                            "vertical"
+                                          ],
+                                          "horizontal",
+                                          "vertical"
+                                        ],
+                                        "gap": "md",
+                                        "type": "stack"
+                                      }
+                                    ]
+                                  ],
+                                  "cols": [
+                                    "if",
+                                    [
+                                      "==",
+                                      "@config.layout",
+                                      "vertical"
+                                    ],
+                                    1.0,
+                                    [
+                                      "math/min",
+                                      [
+                                        "math/max",
+                                        [
+                                          "array/len",
+                                          "@config.steps"
+                                        ],
+                                        1.0
+                                      ],
+                                      4.0
+                                    ]
+                                  ],
+                                  "gap": "lg",
+                                  "type": "simple-grid"
+                                }
+                              ],
+                              "direction": "vertical",
+                              "gap": "xl",
+                              "type": "stack"
+                            }
+                          ],
+                          "maxWidth": "xl",
+                          "padding": "lg",
+                          "size": "xl",
+                          "type": "container"
+                        }
+                      ],
+                      "fullWidth": true,
+                      "paddingY": "xl",
+                      "type": "box"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3B92534H3GMEV9DTSKQ8D8K",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "StepItem": [
+          {
+            "name": "title",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "string"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/{marketing → core}/atoms/ui-animated-graphic.orb

@@ -2,43 +2,43 @@
   "description": "AnimatedGraphic — UI factory (1:1 with the @almadar/ui animated-graphic pattern).",
   "ledger": {
     "entries": {
-      "ent_01KXG053YH6KETF853AWC19ZVA": {
+      "ent_01M3B9EHV2QFXHYXHAGYY1V1NN": {
         "bakedName": "AnimatedGraphicItem",
         "curName": "AnimatedGraphicItem",
-        "id": "ent_01KXG053YH6KETF853AWC19ZVA",
+        "id": "ent_01M3B9EHV2QFXHYXHAGYY1V1NN",
         "kind": "entity",
         "owner": "workspace",
         "renames": []
       },
-      "evt_01KXG053YHS4QXEXBPWPDTG6NA": {
+      "evt_01M3B9EHV2GKPFRWJV8W99X02Y": {
         "bakedName": "INIT",
         "curName": "INIT",
-        "id": "evt_01KXG053YHS4QXEXBPWPDTG6NA",
+        "id": "evt_01M3B9EHV2GKPFRWJV8W99X02Y",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG053YH03687E7ZKKVRGPK7",
+        "parent": "trt_01M3B9EHV2HWWG11KKJRACPTNG",
         "renames": []
       },
-      "orb_01KXG053YHVAEFRER3QTYH9RVY": {
+      "orb_01M3B9EHV2FBZ0NRZ1GK7CM1RP": {
         "bakedName": "AnimatedGraphicOrbital",
         "curName": "AnimatedGraphicOrbital",
-        "id": "orb_01KXG053YHVAEFRER3QTYH9RVY",
+        "id": "orb_01M3B9EHV2FBZ0NRZ1GK7CM1RP",
         "kind": "orbital",
         "owner": "workspace",
         "renames": []
       },
-      "pag_01KXG053YK9G5DD68V95EVDD4T": {
+      "pag_01M3B9EHV29KE1ADFPPXJDGKK3": {
         "bakedName": "AnimatedGraphicPage",
         "curName": "AnimatedGraphicPage",
-        "id": "pag_01KXG053YK9G5DD68V95EVDD4T",
+        "id": "pag_01M3B9EHV29KE1ADFPPXJDGKK3",
         "kind": "page",
         "owner": "workspace",
         "renames": []
       },
-      "trt_01KXG053YH03687E7ZKKVRGPK7": {
+      "trt_01M3B9EHV2HWWG11KKJRACPTNG": {
         "bakedName": "AnimatedGraphicRender",
         "curName": "AnimatedGraphicRender",
-        "id": "trt_01KXG053YH03687E7ZKKVRGPK7",
+        "id": "trt_01M3B9EHV2HWWG11KKJRACPTNG",
         "kind": "trait",
         "owner": "workspace",
         "renames": []
@@ -57,21 +57,21 @@
             "type": "string"
           }
         ],
-        "id": "ent_01KXG053YH6KETF853AWC19ZVA",
+        "id": "ent_01M3B9EHV2QFXHYXHAGYY1V1NN",
         "name": "AnimatedGraphicItem",
         "persistence": "runtime"
       },
-      "id": "orb_01KXG053YHVAEFRER3QTYH9RVY",
+      "id": "orb_01M3B9EHV2FBZ0NRZ1GK7CM1RP",
       "name": "AnimatedGraphicOrbital",
       "pages": [
         {
-          "id": "pag_01KXG053YK9G5DD68V95EVDD4T",
+          "id": "pag_01M3B9EHV29KE1ADFPPXJDGKK3",
           "name": "AnimatedGraphicPage",
           "path": "/animated-graphic",
           "traits": [
             {
               "ref": "AnimatedGraphicRender",
-              "refId": "trt_01KXG053YH03687E7ZKKVRGPK7"
+              "refId": "trt_01M3B9EHV2HWWG11KKJRACPTNG"
             }
           ]
         }
@@ -183,17 +183,17 @@
           },
           "entityRebindable": true,
           "entityRefIds": {
-            "AnimatedGraphicItem": "ent_01KXG053YH6KETF853AWC19ZVA"
+            "AnimatedGraphicItem": "ent_01M3B9EHV2QFXHYXHAGYY1V1NN"
           },
-          "id": "trt_01KXG053YH03687E7ZKKVRGPK7",
+          "id": "trt_01M3B9EHV2HWWG11KKJRACPTNG",
           "linkedEntity": "AnimatedGraphicItem",
-          "linkedEntityId": "ent_01KXG053YH6KETF853AWC19ZVA",
+          "linkedEntityId": "ent_01M3B9EHV2QFXHYXHAGYY1V1NN",
           "name": "AnimatedGraphicRender",
           "scope": "instance",
           "stateMachine": {
             "events": [
               {
-                "id": "evt_01KXG053YHS4QXEXBPWPDTG6NA",
+                "id": "evt_01M3B9EHV2GKPFRWJV8W99X02Y",
                 "key": "INIT",
                 "name": "Initialize"
               }
@@ -229,7 +229,7 @@
                   ]
                 ],
                 "event": "INIT",
-                "eventId": "evt_01KXG053YHS4QXEXBPWPDTG6NA",
+                "eventId": "evt_01M3B9EHV2GKPFRWJV8W99X02Y",
                 "from": "idle",
                 "to": "idle"
               }