@almadar/std 16.228.0 → 16.229.0

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

@@ -0,0 +1,811 @@
+{
+  "description": "std-hero — the headline block at the top of a page, or a call-to-action banner further down. Optional eyebrow badge, headline, supporting text, up to two link actions, an optional copyable command, and optional media below or beside the copy. `look: banner` turns it into a contained call-to-action card. Links follow `href` (in-app path, #anchor, or absolute URL); each click also emits CTA_PRIMARY / CTA_SECONDARY with the href. Pick for landing, product, pricing and campaign pages.",
+  "ledger": {
+    "entries": {
+      "ent_01M3B9EHJJRYBFDXWBWE6J5G03": {
+        "bakedName": "HeroView",
+        "curName": "HeroView",
+        "id": "ent_01M3B9EHJJRYBFDXWBWE6J5G03",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3B9EHJJ2KAN6JGP641VZBP5": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3B9EHJJ2KAN6JGP641VZBP5",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "renames": []
+      },
+      "evt_01M3B9EHJJ3XRE1W3M4TCNHPZ6": {
+        "bakedName": "HERO_PRIMARY",
+        "curName": "HERO_PRIMARY",
+        "id": "evt_01M3B9EHJJ3XRE1W3M4TCNHPZ6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "renames": []
+      },
+      "evt_01M3B9EHJJ61Z40EH8ADARPQKN": {
+        "bakedName": "CTA_PRIMARY",
+        "curName": "CTA_PRIMARY",
+        "id": "evt_01M3B9EHJJ61Z40EH8ADARPQKN",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "renames": []
+      },
+      "evt_01M3B9EHJJF32T4BD5285148R8": {
+        "bakedName": "CTA_SECONDARY",
+        "curName": "CTA_SECONDARY",
+        "id": "evt_01M3B9EHJJF32T4BD5285148R8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "renames": []
+      },
+      "evt_01M3B9EHJJPBEFQH0DQRX012SK": {
+        "bakedName": "HERO_SECONDARY",
+        "curName": "HERO_SECONDARY",
+        "id": "evt_01M3B9EHJJPBEFQH0DQRX012SK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "renames": []
+      },
+      "orb_01M3B9EHJJ5N7HA1XJCGAHT1Q8": {
+        "bakedName": "HeroOrbital",
+        "curName": "HeroOrbital",
+        "id": "orb_01M3B9EHJJ5N7HA1XJCGAHT1Q8",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3B9EHJJN0620F8KEGY2TYYE": {
+        "bakedName": "HeroPage",
+        "curName": "HeroPage",
+        "id": "pag_01M3B9EHJJN0620F8KEGY2TYYE",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V": {
+        "bakedName": "HeroRender",
+        "curName": "HeroRender",
+        "id": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-hero",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3B9EHJJRYBFDXWBWE6J5G03",
+        "name": "HeroView",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3B9EHJJ5N7HA1XJCGAHT1Q8",
+      "name": "HeroOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3B9EHJJN0620F8KEGY2TYYE",
+          "name": "HeroPage",
+          "path": "/hero",
+          "traits": [
+            {
+              "ref": "HeroRender",
+              "refId": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "alignment": {
+              "default": "center",
+              "description": "Center the copy, or align it to the start edge",
+              "label": "Alignment",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "center",
+                "start"
+              ]
+            },
+            "command": {
+              "default": "",
+              "description": "A shell command shown in a copyable code box under the actions, e.g. an install one-liner; empty hides it",
+              "label": "Command",
+              "synonyms": "install command, cli, terminal snippet",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "copyContent": {
+              "default": {
+                "align": [
+                  "if",
+                  [
+                    "==",
+                    "@config.alignment",
+                    "center"
+                  ],
+                  "center",
+                  "start"
+                ],
+                "children": [
+                  {
+                    "label": "@config.eyebrow",
+                    "size": "md",
+                    "type": "badge",
+                    "variant": "primary"
+                  },
+                  {
+                    "align": [
+                      "if",
+                      [
+                        "==",
+                        "@config.alignment",
+                        "center"
+                      ],
+                      "center",
+                      "left"
+                    ],
+                    "className": "tracking-tight text-balance",
+                    "content": "@config.headline",
+                    "type": "typography",
+                    "variant": [
+                      "if",
+                      [
+                        "==",
+                        "@config.look",
+                        "banner"
+                      ],
+                      "h2",
+                      "h1"
+                    ],
+                    "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"
+                  },
+                  {
+                    "children": [
+                      {
+                        "action": "HERO_PRIMARY",
+                        "actionPayload": {
+                          "href": "@config.primaryHref"
+                        },
+                        "className": [
+                          "if",
+                          [
+                            "==",
+                            "@config.primaryLabel",
+                            ""
+                          ],
+                          "hidden",
+                          ""
+                        ],
+                        "href": "@config.primaryHref",
+                        "label": "@config.primaryLabel",
+                        "size": "lg",
+                        "type": "button",
+                        "variant": "primary"
+                      },
+                      {
+                        "action": "HERO_SECONDARY",
+                        "actionPayload": {
+                          "href": "@config.secondaryHref"
+                        },
+                        "className": [
+                          "if",
+                          [
+                            "==",
+                            "@config.secondaryLabel",
+                            ""
+                          ],
+                          "hidden",
+                          ""
+                        ],
+                        "href": "@config.secondaryHref",
+                        "label": "@config.secondaryLabel",
+                        "size": "lg",
+                        "type": "button",
+                        "variant": "secondary"
+                      }
+                    ],
+                    "className": [
+                      "if",
+                      [
+                        "==",
+                        "@config.primaryLabel",
+                        ""
+                      ],
+                      [
+                        "if",
+                        [
+                          "==",
+                          "@config.secondaryLabel",
+                          ""
+                        ],
+                        "hidden",
+                        "pt-2"
+                      ],
+                      "pt-2"
+                    ],
+                    "direction": "horizontal",
+                    "gap": "md",
+                    "justify": [
+                      "if",
+                      [
+                        "==",
+                        "@config.alignment",
+                        "center"
+                      ],
+                      "center",
+                      "start"
+                    ],
+                    "type": "stack",
+                    "wrap": true
+                  },
+                  {
+                    "children": [
+                      {
+                        "code": "@config.command",
+                        "language": "bash",
+                        "showCopyButton": true,
+                        "showLanguageBadge": false,
+                        "type": "code-block"
+                      }
+                    ],
+                    "className": [
+                      "if",
+                      [
+                        "==",
+                        "@config.command",
+                        ""
+                      ],
+                      "hidden",
+                      "max-w-xl"
+                    ],
+                    "fullWidth": true,
+                    "type": "box"
+                  }
+                ],
+                "direction": "vertical",
+                "gap": "lg",
+                "type": "stack"
+              },
+              "label": "Copy block",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "eyebrow": {
+              "default": "",
+              "description": "Small badge above the headline; empty hides it",
+              "label": "Eyebrow",
+              "synonyms": "tag, kicker, label above title",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "headline": {
+              "default": "Build what you mean",
+              "description": "Main headline",
+              "label": "Headline",
+              "synonyms": "title, heading",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "lede": {
+              "default": "",
+              "description": "One or two sentences under the headline; empty hides it",
+              "label": "Supporting text",
+              "synonyms": "subtitle, subheading, description, tagline",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "look": {
+              "default": "hero",
+              "description": "hero = full-width page opener with an h1; banner = contained call-to-action card with an h2",
+              "label": "Look",
+              "synonyms": "cta banner, call to action, callout, page header, masthead",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "hero",
+                "banner"
+              ]
+            },
+            "mediaAlt": {
+              "default": "",
+              "label": "Media alt text",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "mediaContent": {
+              "default": {
+                "alt": "@config.mediaAlt",
+                "bordered": true,
+                "loading": "eager",
+                "rounded": "xl",
+                "src": "@config.mediaSrc",
+                "type": "image"
+              },
+              "label": "Media block",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "mediaPosition": {
+              "default": "below",
+              "description": "Below the copy, or beside it on wide screens",
+              "label": "Media position",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "below",
+                "side"
+              ]
+            },
+            "mediaSrc": {
+              "default": "",
+              "description": "Screenshot or illustration URL; empty hides it",
+              "label": "Media image",
+              "synonyms": "hero image, screenshot, picture",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "primaryHref": {
+              "default": "#",
+              "description": "In-app path, #anchor, or absolute URL",
+              "label": "Primary action link",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "primaryLabel": {
+              "default": "Get started",
+              "description": "Empty hides the primary action",
+              "label": "Primary action label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "secondaryHref": {
+              "default": "",
+              "description": "In-app path, #anchor, or absolute URL",
+              "label": "Secondary action link",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "secondaryLabel": {
+              "default": "",
+              "description": "Empty hides the secondary action",
+              "label": "Secondary action label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "sideContent": {
+              "default": {
+                "bg": [
+                  "if",
+                  [
+                    "==",
+                    "@config.surface",
+                    "muted"
+                  ],
+                  "muted",
+                  "transparent"
+                ],
+                "children": [
+                  {
+                    "children": [
+                      {
+                        "bg": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "muted",
+                          "transparent"
+                        ],
+                        "border": [
+                          "==",
+                          "@config.look",
+                          "banner"
+                        ],
+                        "children": [
+                          {
+                            "align": "center",
+                            "children": [
+                              "@config.copyContent",
+                              "@config.mediaContent"
+                            ],
+                            "gap": "xl",
+                            "ratio": "1:1",
+                            "type": "split"
+                          }
+                        ],
+                        "padding": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "xl",
+                          "none"
+                        ],
+                        "rounded": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "2xl",
+                          "none"
+                        ],
+                        "type": "box"
+                      }
+                    ],
+                    "maxWidth": "xl",
+                    "padding": "lg",
+                    "size": "xl",
+                    "type": "container"
+                  }
+                ],
+                "fullWidth": true,
+                "paddingY": [
+                  "if",
+                  [
+                    "==",
+                    "@config.look",
+                    "banner"
+                  ],
+                  "xl",
+                  "2xl"
+                ],
+                "type": "box"
+              },
+              "label": "Side-by-side body",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "stackedContent": {
+              "default": {
+                "bg": [
+                  "if",
+                  [
+                    "==",
+                    "@config.surface",
+                    "muted"
+                  ],
+                  "muted",
+                  "transparent"
+                ],
+                "children": [
+                  {
+                    "children": [
+                      {
+                        "bg": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "muted",
+                          "transparent"
+                        ],
+                        "border": [
+                          "==",
+                          "@config.look",
+                          "banner"
+                        ],
+                        "children": [
+                          {
+                            "align": [
+                              "if",
+                              [
+                                "==",
+                                "@config.alignment",
+                                "center"
+                              ],
+                              "center",
+                              "stretch"
+                            ],
+                            "children": [
+                              "@config.copyContent",
+                              "@config.mediaContent"
+                            ],
+                            "direction": "vertical",
+                            "gap": "2xl",
+                            "type": "stack"
+                          }
+                        ],
+                        "padding": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "xl",
+                          "none"
+                        ],
+                        "rounded": [
+                          "if",
+                          [
+                            "==",
+                            "@config.look",
+                            "banner"
+                          ],
+                          "2xl",
+                          "none"
+                        ],
+                        "type": "box"
+                      }
+                    ],
+                    "maxWidth": "xl",
+                    "padding": "lg",
+                    "size": "xl",
+                    "type": "container"
+                  }
+                ],
+                "fullWidth": true,
+                "paddingY": [
+                  "if",
+                  [
+                    "==",
+                    "@config.look",
+                    "banner"
+                  ],
+                  "xl",
+                  "2xl"
+                ],
+                "type": "box"
+              },
+              "label": "Stacked body",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "surface": {
+              "default": "plain",
+              "description": "Background behind the block",
+              "label": "Surface",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "plain",
+                "muted"
+              ]
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "emit",
+              "resource": "CTA_PRIMARY"
+            },
+            {
+              "kind": "emit",
+              "resource": "CTA_SECONDARY"
+            },
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "emits": [
+            {
+              "description": "The primary action was clicked; carries its href.",
+              "event": "CTA_PRIMARY",
+              "eventId": "evt_01M3B9EHJJ61Z40EH8ADARPQKN",
+              "payloadSchema": [
+                {
+                  "name": "href",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "primary cta, main button, get started click",
+              "tier": "domain"
+            },
+            {
+              "description": "The secondary action was clicked; carries its href.",
+              "event": "CTA_SECONDARY",
+              "eventId": "evt_01M3B9EHJJF32T4BD5285148R8",
+              "payloadSchema": [
+                {
+                  "name": "href",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "secondary cta, second button, learn more click",
+              "tier": "domain"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "HeroView": "ent_01M3B9EHJJRYBFDXWBWE6J5G03"
+          },
+          "id": "trt_01M3B9EHJJBENJQ6CZJWXZ3K5V",
+          "linkedEntity": "HeroView",
+          "linkedEntityId": "ent_01M3B9EHJJRYBFDXWBWE6J5G03",
+          "name": "HeroRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3B9EHJJ2KAN6JGP641VZBP5",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Primary action button click.",
+                "id": "evt_01M3B9EHJJ3XRE1W3M4TCNHPZ6",
+                "key": "HERO_PRIMARY",
+                "name": "Hero Primary",
+                "payloadSchema": [
+                  {
+                    "name": "href",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "description": "Secondary action button click.",
+                "id": "evt_01M3B9EHJJPBEFQH0DQRX012SK",
+                "key": "HERO_SECONDARY",
+                "name": "Hero Secondary",
+                "payloadSchema": [
+                  {
+                    "name": "href",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "description": "The primary action was clicked; carries its href.",
+                "id": "evt_01M3B9EHJJ61Z40EH8ADARPQKN",
+                "key": "CTA_PRIMARY",
+                "name": "Cta Primary",
+                "payloadSchema": [
+                  {
+                    "name": "href",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "primary cta, main button, get started click",
+                "tier": "domain"
+              },
+              {
+                "description": "The secondary action was clicked; carries its href.",
+                "id": "evt_01M3B9EHJJF32T4BD5285148R8",
+                "key": "CTA_SECONDARY",
+                "name": "Cta Secondary",
+                "payloadSchema": [
+                  {
+                    "name": "href",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "secondary cta, second button, learn more click",
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "if",
+                    [
+                      "==",
+                      "@config.mediaPosition",
+                      "side"
+                    ],
+                    [
+                      "render-ui",
+                      "main",
+                      "@config.sideContent"
+                    ],
+                    [
+                      "render-ui",
+                      "main",
+                      "@config.stackedContent"
+                    ]
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3B9EHJJ2KAN6JGP641VZBP5",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "CTA_PRIMARY",
+                    {
+                      "href": "@payload.href"
+                    }
+                  ]
+                ],
+                "event": "HERO_PRIMARY",
+                "eventId": "evt_01M3B9EHJJ3XRE1W3M4TCNHPZ6",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "CTA_SECONDARY",
+                    {
+                      "href": "@payload.href"
+                    }
+                  ]
+                ],
+                "event": "HERO_SECONDARY",
+                "eventId": "evt_01M3B9EHJJPBEFQH0DQRX012SK",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}