@almadar/std 16.243.0 → 16.244.1

package/behaviors/registry/ui/avl/atoms/ui-module-card.orb

@@ -80,6 +80,80 @@
         {
           "category": "interaction",
           "config": {
+            "annotations": {
+              "default": {
+                "item": {}
+              },
+              "description": "Author explanations per trait name (states, transition events, effect types), shown in a popover on hover.",
+              "items": {
+                "properties": {
+                  "effects": {
+                    "items": {
+                      "properties": {
+                        "body": {
+                          "name": "body",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "title": {
+                          "name": "title",
+                          "required": false,
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "name": "effects",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "states": {
+                    "items": {
+                      "properties": {
+                        "body": {
+                          "name": "body",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "title": {
+                          "name": "title",
+                          "required": false,
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "name": "states",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "transitions": {
+                    "items": {
+                      "properties": {
+                        "body": {
+                          "name": "body",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "title": {
+                          "name": "title",
+                          "required": false,
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "name": "transitions",
+                    "required": false,
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Annotations",
+              "tier": "presentation",
+              "type": "Map<string,ModuleCardAnnotationsValue>"
+            },
             "ariaBusy": {
               "description": "This region is updating; assistive technology waits before announcing it.",
               "label": "Aria-busy",
@@ -766,6 +840,7 @@
                     "render-ui",
                     "main",
                     {
+                      "annotations": "@config.annotations",
                       "aria-busy": "@config.ariaBusy",
                       "aria-current": "@config.ariaCurrent",
                       "aria-describedby": "@config.ariaDescribedby",
@@ -795,6 +870,53 @@
         }
       ],
       "types": {
+        "ModuleCardAnnotationsValue": [
+          {
+            "name": "states",
+            "type": "Map<string,ModuleCardAnnotationsValueStatesValue>"
+          },
+          {
+            "name": "transitions",
+            "type": "Map<string,ModuleCardAnnotationsValueTransitionsValue>"
+          },
+          {
+            "name": "effects",
+            "type": "Map<string,ModuleCardAnnotationsValueEffectsValue>"
+          }
+        ],
+        "ModuleCardAnnotationsValueEffectsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "ModuleCardAnnotationsValueStatesValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "ModuleCardAnnotationsValueTransitionsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "ModuleCardData": [
           {
             "name": "orbitalName",

package/behaviors/registry/ui/core/atoms/std-app-layout.orb

@@ -170,7 +170,7 @@
             },
             "layoutMode": {
               "default": "sidebar",
-              "description": "sidebar = left rail; topnav = top bar; bottomnav = mobile tab bar; minimal = no nav.",
+              "description": "sidebar = left rail; topnav = top bar; bottomnav = mobile tab bar; minimal = no nav; drawer = navigation behind a menu button at every width, content full width.",
               "label": "Where should navigation be placed?",
               "synonyms": "nav position, navigation style, menu placement, layout style",
               "tier": "presentation",
@@ -179,7 +179,8 @@
                 "sidebar",
                 "topnav",
                 "bottomnav",
-                "minimal"
+                "minimal",
+                "drawer"
               ]
             },
             "layoutPattern": {
@@ -189,6 +190,14 @@
               "tier": "internal",
               "type": "pattern"
             },
+            "logoSrc": {
+              "default": "",
+              "description": "Address of the logo shown beside the app name in the chrome header (an image URL or an inline data: SVG); empty shows the name's first letter.",
+              "label": "Logo image",
+              "synonyms": "logo, brand mark, app icon, logo url",
+              "tier": "presentation",
+              "type": "string"
+            },
             "navItems": {
               "default": "@pages",
               "description": "Top-level navigation links shown on the left rail.",
@@ -285,6 +294,22 @@
               "tier": "internal",
               "type": "event"
             },
+            "showSearch": {
+              "default": true,
+              "description": "The top-bar search box; turn off for apps whose pages carry their own search.",
+              "label": "Show the search box?",
+              "synonyms": "search bar, top search, hide search",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "showThemeToggle": {
+              "default": true,
+              "description": "The theme toggle in the top bar; turn off when the app offers it elsewhere, such as a settings page.",
+              "label": "Show the light/dark toggle?",
+              "synonyms": "dark mode button, theme switch, hide theme toggle",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "sidebarTrait": {
               "description": "Optional trait rendered in the sidebar between the nav links and the footer — the Notion/Confluence-style always-visible page tree; scrolls independently. Unset renders plain nav only.",
               "label": "Sidebar trait",
@@ -587,6 +612,22 @@
                           ],
                           "currentPath": "@config.currentPath",
                           "layoutMode": "@config.layoutMode",
+                          "logo": [
+                            "if",
+                            [
+                              "==",
+                              "@config.logoSrc",
+                              ""
+                            ],
+                            null,
+                            {
+                              "alt": "",
+                              "className": "h-8 w-8",
+                              "fit": "contain",
+                              "src": "@config.logoSrc",
+                              "type": "image"
+                            }
+                          ],
                           "navItems": [
                             "array/map",
                             [
@@ -684,7 +725,13 @@
                           ],
                           "notificationClickEvent": "@config.notificationClickEvent",
                           "notifications": "@config.notifications",
-                          "searchEvent": "@config.searchEvent",
+                          "searchEvent": [
+                            "if",
+                            "@config.showSearch",
+                            "@config.searchEvent",
+                            null
+                          ],
+                          "showThemeToggle": "@config.showThemeToggle",
                           "sidebarContent": "@config.sidebarTrait",
                           "topBarActions": [
                             "array/filter",
@@ -798,6 +845,22 @@
                           ],
                           "currentPath": "@config.currentPath",
                           "layoutMode": "@config.layoutMode",
+                          "logo": [
+                            "if",
+                            [
+                              "==",
+                              "@config.logoSrc",
+                              ""
+                            ],
+                            null,
+                            {
+                              "alt": "",
+                              "className": "h-8 w-8",
+                              "fit": "contain",
+                              "src": "@config.logoSrc",
+                              "type": "image"
+                            }
+                          ],
                           "navItems": [
                             "array/map",
                             [
@@ -895,7 +958,13 @@
                           ],
                           "notificationClickEvent": "@config.notificationClickEvent",
                           "notifications": "@config.notifications",
-                          "searchEvent": "@config.searchEvent",
+                          "searchEvent": [
+                            "if",
+                            "@config.showSearch",
+                            "@config.searchEvent",
+                            null
+                          ],
+                          "showThemeToggle": "@config.showThemeToggle",
                           "sidebarContent": "@config.sidebarTrait",
                           "topBarActions": [
                             "array/filter",

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

@@ -1,5 +1,5 @@
 {
-  "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.",
+  "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, optional media below or beside the copy, and an optional backdrop scene behind it all. `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": {
@@ -127,6 +127,16 @@
                 "start"
               ]
             },
+            "backdropContent": {
+              "default": {
+                "className": "hidden",
+                "type": "box"
+              },
+              "description": "A scene behind the whole block, such as an animated canvas; it fills the block, never takes clicks, and the copy stays on top. Empty by default.",
+              "label": "Backdrop",
+              "tier": "presentation",
+              "type": "render-ui"
+            },
             "command": {
               "default": "",
               "description": "A shell command shown in a copyable code box under the actions, e.g. an install one-liner; empty hides it",
@@ -333,6 +343,17 @@
               "tier": "presentation",
               "type": "string"
             },
+            "height": {
+              "default": "auto",
+              "description": "auto fits the copy; tall fills most of the screen with the copy centred, for a hero over a backdrop scene",
+              "label": "Height",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "auto",
+                "tall"
+              ]
+            },
             "lede": {
               "default": "",
               "description": "One or two sentences under the headline; empty hides it",
@@ -432,66 +453,93 @@
                   "transparent"
                 ],
                 "children": [
+                  {
+                    "aria-hidden": true,
+                    "children": [
+                      "@config.backdropContent"
+                    ],
+                    "className": "inset-0 pointer-events-none",
+                    "position": "absolute",
+                    "type": "box"
+                  },
                   {
                     "children": [
                       {
-                        "bg": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "muted",
-                          "transparent"
-                        ],
-                        "border": [
-                          "==",
-                          "@config.look",
-                          "banner"
-                        ],
                         "children": [
                           {
-                            "align": "center",
+                            "bg": [
+                              "if",
+                              [
+                                "==",
+                                "@config.look",
+                                "banner"
+                              ],
+                              "muted",
+                              "transparent"
+                            ],
+                            "border": [
+                              "==",
+                              "@config.look",
+                              "banner"
+                            ],
                             "children": [
-                              "@config.copyContent",
-                              "@config.mediaContent"
+                              {
+                                "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"
                             ],
-                            "gap": "xl",
-                            "ratio": "1:1",
-                            "type": "split"
+                            "type": "box"
                           }
                         ],
-                        "padding": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "xl",
-                          "none"
-                        ],
-                        "rounded": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "2xl",
-                          "none"
-                        ],
-                        "type": "box"
+                        "maxWidth": "xl",
+                        "padding": "lg",
+                        "size": "xl",
+                        "type": "container"
                       }
                     ],
-                    "maxWidth": "xl",
-                    "padding": "lg",
-                    "size": "xl",
-                    "type": "container"
+                    "fullWidth": true,
+                    "position": "relative",
+                    "type": "box"
                   }
                 ],
+                "className": [
+                  "if",
+                  [
+                    "==",
+                    "@config.height",
+                    "tall"
+                  ],
+                  "flex min-h-[80vh] items-center",
+                  ""
+                ],
                 "fullWidth": true,
+                "overflow": "hidden",
                 "paddingY": [
                   "if",
                   [
@@ -502,6 +550,7 @@
                   "xl",
                   "2xl"
                 ],
+                "position": "relative",
                 "type": "box"
               },
               "label": "Side-by-side body",
@@ -521,75 +570,102 @@
                   "transparent"
                 ],
                 "children": [
+                  {
+                    "aria-hidden": true,
+                    "children": [
+                      "@config.backdropContent"
+                    ],
+                    "className": "inset-0 pointer-events-none",
+                    "position": "absolute",
+                    "type": "box"
+                  },
                   {
                     "children": [
                       {
-                        "bg": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "muted",
-                          "transparent"
-                        ],
-                        "border": [
-                          "==",
-                          "@config.look",
-                          "banner"
-                        ],
                         "children": [
                           {
-                            "align": [
+                            "bg": [
                               "if",
                               [
                                 "==",
-                                "@config.alignment",
-                                "center"
+                                "@config.look",
+                                "banner"
                               ],
-                              "center",
-                              "stretch"
+                              "muted",
+                              "transparent"
+                            ],
+                            "border": [
+                              "==",
+                              "@config.look",
+                              "banner"
                             ],
                             "children": [
-                              "@config.copyContent",
-                              "@config.mediaContent"
+                              {
+                                "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"
                             ],
-                            "direction": "vertical",
-                            "gap": "2xl",
-                            "type": "stack"
+                            "type": "box"
                           }
                         ],
-                        "padding": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "xl",
-                          "none"
-                        ],
-                        "rounded": [
-                          "if",
-                          [
-                            "==",
-                            "@config.look",
-                            "banner"
-                          ],
-                          "2xl",
-                          "none"
-                        ],
-                        "type": "box"
+                        "maxWidth": "xl",
+                        "padding": "lg",
+                        "size": "xl",
+                        "type": "container"
                       }
                     ],
-                    "maxWidth": "xl",
-                    "padding": "lg",
-                    "size": "xl",
-                    "type": "container"
+                    "fullWidth": true,
+                    "position": "relative",
+                    "type": "box"
                   }
                 ],
+                "className": [
+                  "if",
+                  [
+                    "==",
+                    "@config.height",
+                    "tall"
+                  ],
+                  "flex min-h-[80vh] items-center",
+                  ""
+                ],
                 "fullWidth": true,
+                "overflow": "hidden",
                 "paddingY": [
                   "if",
                   [
@@ -600,6 +676,7 @@
                   "xl",
                   "2xl"
                 ],
+                "position": "relative",
                 "type": "box"
               },
               "label": "Stacked body",