@almadar/std 16.181.0 → 16.183.0

package/behaviors/registry/ui/game/atoms/ui-control-grid.orb

@@ -433,6 +433,17 @@
                 "md",
                 "lg"
               ]
+            },
+            "visibility": {
+              "default": "auto",
+              "description": "'auto' (default) renders only on coarse-pointer (touch) devices; 'always' renders everywhere.",
+              "label": "Visibility",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "auto",
+                "always"
+              ]
             }
           },
           "emits": [
@@ -553,7 +564,8 @@
                       "onAction": "@config.onAction",
                       "onDirection": "@config.onDirection",
                       "size": "@config.size",
-                      "type": "control-grid"
+                      "type": "control-grid",
+                      "visibility": "@config.visibility"
                     }
                   ]
                 ],

package/behaviors/registry/ui/game/atoms/ui-game-hud.orb

@@ -299,6 +299,17 @@
               "label": "Transparent",
               "tier": "presentation",
               "type": "boolean"
+            },
+            "variant": {
+              "default": "floating",
+              "description": "Layout variant: 'floating' (default) renders a compact pill cluster that hugs its content width; 'bar' preserves the legacy full-width split bar.",
+              "label": "Variant",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "floating",
+                "bar"
+              ]
             }
           },
           "entityContract": {
@@ -342,7 +353,8 @@
                       "size": "@config.size",
                       "stats": "@config.stats",
                       "transparent": "@config.transparent",
-                      "type": "game-hud"
+                      "type": "game-hud",
+                      "variant": "@config.variant"
                     }
                   ]
                 ],

package/behaviors/registry/ui/game/templates/ui-game-shell.orb

@@ -81,7 +81,7 @@
           "category": "interaction",
           "config": {
             "addons": {
-              "description": "Action cluster — floats bottom-right (End Turn, Fire, Reset, …)",
+              "description": "Action cluster — floats bottom-right (End Turn, Fire, Reset, …). Legacy chrome surface: new behaviors emit action chrome via render-ui \"hud-bottom\" or \"floating\" instead.",
               "label": "Addons",
               "tier": "presentation",
               "type": "node"
@@ -199,20 +199,20 @@
               "type": "string"
             },
             "controls": {
-              "description": "Movement controls — floats bottom-left (d-pad / control-grid).",
+              "description": "Movement controls — floats bottom-left (d-pad / control-grid). Legacy chrome surface: new behaviors emit movement controls via render-ui \"hud-bottom\" instead.",
               "label": "Controls",
               "tier": "presentation",
               "type": "node"
             },
             "fontFamily": {
               "default": "future",
-              "description": "Game font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family.",
+              "description": "Game display-font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme.",
               "label": "Font Family",
               "tier": "presentation",
               "type": "string"
             },
             "hud": {
-              "description": "Stat chips row — floats along the top edge",
+              "description": "Stat chips row — floats along the top edge. Legacy chrome surface: new behaviors emit HUD chrome via render-ui \"hud-top\" instead.",
               "label": "Hud",
               "tier": "presentation",
               "type": "node"
@@ -306,7 +306,7 @@
               "type": "GameShellHudBackgroundAsset"
             },
             "overlay": {
-              "description": "Centered overlay layer (victory/defeat banners, dialogs).",
+              "description": "Centered overlay layer (victory/defeat banners, dialogs). Legacy chrome surface: new behaviors emit overlays via render-ui \"overlay\" (clear with render-ui \"overlay\" null on every exit) instead.",
               "label": "Overlay",
               "tier": "presentation",
               "type": "node"