@logicplanes/kaeso-ui 0.1.0 → 0.2.0

package/ai/component-registry.json

@@ -1,6 +1,6 @@
 {
   "package": "@logicplanes/kaeso-ui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "components": [
     {
       "entry": "app-frame",
@@ -9,7 +9,7 @@
       "components": [
         {
           "name": "AppFrame",
-          "description": "The page frame of an app: a skip link to the content, the sidebar, the inset panel and, on phones, a bar with a menu button.",
+          "description": "The page frame of an app: a skip link to the content, the sidebar, the inset panel and, on phones, a bar with a menu button. The navigation sheet's code loads once the page is idle or on the first tap; after a failed download the next tap or hover loads it again from a fresh address. Chromium and WebKit keep a failed download of a chunk the sheet shares with the rest of the app until the page is reloaded.",
           "props": [
             {
               "name": "children",
@@ -59,6 +59,13 @@
               "required": false,
               "default": "screen",
               "description": "`screen` fills the viewport (default); `parent` fills its container (previews, embedded tools)."
+            },
+            {
+              "name": "phoneActions",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "Icon buttons in the phone bar before the navigation toggle, such as search, so it is one tap away; pass `tooltip={false}` to each."
             }
           ],
           "file": "src/components/app-frame/app-frame.tsx"
@@ -103,16 +110,10 @@
               "description": "The element that gets focus back when the sheet closes."
             }
           ],
-          "file": "src/components/app-frame/app-frame.tsx"
+          "file": "src/components/app-frame/nav-sheet.tsx"
         }
       ],
       "variants": {
-        "APP_FRAME_BODY_DEFAULT": {
-          "axes": {
-            "padding": {}
-          },
-          "defaults": {}
-        },
         "APP_FRAME_BODY": {
           "axes": {
             "padding": {
@@ -121,13 +122,9 @@
               "page": "A content page (overviews, charts, sections): 24px sides, 16px under the header, 48px at the end"
             }
           },
-          "defaults": {}
-        },
-        "APP_FRAME_DEFAULT": {
-          "axes": {
-            "fill": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "padding": "none"
+          }
         },
         "APP_FRAME": {
           "axes": {
@@ -136,7 +133,9 @@
               "parent": "Fills its container: previews, embedded tools"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "fill": "screen"
+          }
         }
       }
     },
@@ -238,13 +237,6 @@
         }
       ],
       "variants": {
-        "AVATAR_DEFAULT": {
-          "axes": {
-            "size": {},
-            "kind": {}
-          },
-          "defaults": {}
-        },
         "AVATAR": {
           "axes": {
             "size": {
@@ -259,7 +251,10 @@
               "org": "Organizations and projects: radius 8"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "24",
+            "kind": "person"
+          }
         }
       }
     },
@@ -291,12 +286,6 @@
         }
       ],
       "variants": {
-        "BADGE_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "BADGE": {
           "axes": {
             "tone": {
@@ -309,7 +298,9 @@
               "ink": "Inverted, for the one thing that must stand out"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "neutral"
+          }
         }
       }
     },
@@ -383,13 +374,6 @@
         }
       ],
       "variants": {
-        "BANNER_DEFAULT": {
-          "axes": {
-            "tone": {},
-            "layout": {}
-          },
-          "defaults": {}
-        },
         "BANNER": {
           "axes": {
             "tone": {
@@ -404,7 +388,10 @@
               "full": "Across the top of the panel for global notices"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "neutral",
+            "layout": "inline"
+          }
         }
       }
     },
@@ -541,14 +528,6 @@
         }
       ],
       "variants": {
-        "BUTTON_DEFAULT": {
-          "axes": {
-            "variant": {},
-            "size": {},
-            "shape": {}
-          },
-          "defaults": {}
-        },
         "BUTTON": {
           "axes": {
             "variant": {
@@ -573,7 +552,11 @@
               "circle": "Icon-only: a circle of the same height"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "secondary",
+            "size": "md",
+            "shape": "pill"
+          }
         }
       }
     },
@@ -619,13 +602,6 @@
         }
       ],
       "variants": {
-        "BUTTON_GROUP_DEFAULT": {
-          "axes": {
-            "attached": {},
-            "size": {}
-          },
-          "defaults": {}
-        },
         "BUTTON_GROUP": {
           "axes": {
             "attached": {
@@ -639,7 +615,10 @@
               "lg": "40px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "attached": "true",
+            "size": "md"
+          }
         }
       }
     },
@@ -727,12 +706,6 @@
         }
       ],
       "variants": {
-        "CALENDAR_DEFAULT": {
-          "axes": {
-            "mode": {}
-          },
-          "defaults": {}
-        },
         "CALENDAR": {
           "axes": {
             "mode": {
@@ -740,7 +713,9 @@
               "range": "A range: a continuous strip between ink ends"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "mode": "single"
+          }
         }
       }
     },
@@ -1633,12 +1608,6 @@
         }
       ],
       "variants": {
-        "BAR_CHART_DEFAULT": {
-          "axes": {
-            "layout": {}
-          },
-          "defaults": {}
-        },
         "BAR_CHART": {
           "axes": {
             "layout": {
@@ -1647,13 +1616,9 @@
               "horizontal": "Horizontal bars for rankings"
             }
           },
-          "defaults": {}
-        },
-        "CHARTS_DEFAULT": {
-          "axes": {
-            "chrome": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "layout": "grouped"
+          }
         },
         "CHARTS": {
           "axes": {
@@ -1661,13 +1626,9 @@
               "default": "Dashed 3 3 grid, tertiary 12px labels, a strong baseline; no frame"
             }
           },
-          "defaults": {}
-        },
-        "DONUT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "chrome": "default"
+          }
         },
         "DONUT": {
           "axes": {
@@ -1677,13 +1638,9 @@
               "lg": "180px"
             }
           },
-          "defaults": {}
-        },
-        "GAUGE_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "GAUGE": {
           "axes": {
@@ -1691,13 +1648,9 @@
               "md": "180px (default)"
             }
           },
-          "defaults": {}
-        },
-        "HEATMAP_DEFAULT": {
-          "axes": {
-            "layout": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "HEATMAP": {
           "axes": {
@@ -1706,13 +1659,9 @@
               "year": "Day × week"
             }
           },
-          "defaults": {}
-        },
-        "SANKEY_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "layout": "week"
+          }
         },
         "SANKEY": {
           "axes": {
@@ -1720,13 +1669,9 @@
               "md": "Fills its width; 320px tall by default"
             }
           },
-          "defaults": {}
-        },
-        "SHARE_BAR_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "SHARE_BAR": {
           "axes": {
@@ -1734,13 +1679,9 @@
               "md": "One 8px pill (default)"
             }
           },
-          "defaults": {}
-        },
-        "SPARKLINE_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "SPARKLINE": {
           "axes": {
@@ -1748,13 +1689,9 @@
               "md": "80×24 inline (default)"
             }
           },
-          "defaults": {}
-        },
-        "TIMESERIES_CHART_DEFAULT": {
-          "axes": {
-            "kind": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "TIMESERIES_CHART": {
           "axes": {
@@ -1764,7 +1701,9 @@
               "stacked": "Stacked areas"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "kind": "line"
+          }
         }
       }
     },
@@ -2118,19 +2057,15 @@
         }
       ],
       "variants": {
-        "CHECKBOX_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "CHECKBOX": {
           "axes": {
             "size": {
               "md": "18px, radius 5 (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -2143,6 +2078,13 @@
           "name": "Code",
           "description": "Inline code: Geist Mono 13 on fill-1.",
           "props": [
+            {
+              "name": "flow",
+              "type": "\"cell\" | \"text\" | \"box\"",
+              "required": false,
+              "default": "box",
+              "description": "`text` for long code in running text, so it breaks with the sentence instead of jumping to its own line as one box; `cell` for the same in a table cell."
+            },
             {
               "name": "shape",
               "type": "\"auto\" | \"pill\" | \"rounded\"",
@@ -2155,21 +2097,23 @@
         }
       ],
       "variants": {
-        "CODE_DEFAULT": {
-          "axes": {
-            "shape": {}
-          },
-          "defaults": {}
-        },
         "CODE": {
           "axes": {
             "shape": {
               "auto": "Pill for a single word, radius 6 for anything longer (default)",
               "pill": "Always a pill",
               "rounded": "Always radius 6"
+            },
+            "flow": {
+              "box": "One box: it moves to the next line whole and wraps inside itself (default)",
+              "text": "Breaks with the sentence around it, each line keeping its fill and corners; for long code in running text",
+              "cell": "Breaks with the text around it and ends square at a break, so no padding hangs past a narrow table cell; for long code in a table"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "shape": "auto",
+            "flow": "box"
+          }
         }
       }
     },
@@ -2231,6 +2175,13 @@
               "default": null,
               "description": "Shows line numbers."
             },
+            {
+              "name": "onTabChange",
+              "type": "((label: string) => void)",
+              "required": false,
+              "default": null,
+              "description": "Called with the label of the tab a person chooses, to remember it."
+            },
             {
               "name": "surface",
               "type": "\"well\" | \"plain\"",
@@ -2238,6 +2189,13 @@
               "default": "well",
               "description": "On a filled well (`well`) or on the panel itself (`plain`)."
             },
+            {
+              "name": "tab",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The label of the tab to show, such as a language the reader chose before. A label the block lacks leaves its own choice."
+            },
             {
               "name": "tabs",
               "type": "CodeTab[]",
@@ -2315,6 +2273,13 @@
               "default": null,
               "description": "Shows line numbers."
             },
+            {
+              "name": "onTabChange",
+              "type": "((label: string) => void)",
+              "required": false,
+              "default": null,
+              "description": "Called with the label of the tab a person chooses, to remember it."
+            },
             {
               "name": "surface",
               "type": "\"well\" | \"plain\"",
@@ -2322,6 +2287,13 @@
               "default": "well",
               "description": "On a filled well (`well`) or on the panel itself (`plain`)."
             },
+            {
+              "name": "tab",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The label of the tab to show, such as a language the reader chose before. A label the block lacks leaves its own choice."
+            },
             {
               "name": "tabs",
               "type": "CodeTab[]",
@@ -2390,12 +2362,6 @@
         }
       ],
       "variants": {
-        "CODE_BLOCK_DEFAULT": {
-          "axes": {
-            "surface": {}
-          },
-          "defaults": {}
-        },
         "CODE_BLOCK": {
           "axes": {
             "surface": {
@@ -2403,13 +2369,9 @@
               "plain": "No surface, inside another well"
             }
           },
-          "defaults": {}
-        },
-        "JSON_VIEW_DEFAULT": {
-          "axes": {
-            "surface": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "surface": "well"
+          }
         },
         "JSON_VIEW": {
           "axes": {
@@ -2418,7 +2380,9 @@
               "plain": "No surface"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "surface": "well"
+          }
         }
       }
     },
@@ -2520,12 +2484,6 @@
         }
       ],
       "variants": {
-        "COLLAPSIBLE_DEFAULT": {
-          "axes": {
-            "state": {}
-          },
-          "defaults": {}
-        },
         "COLLAPSIBLE": {
           "axes": {
             "state": {
@@ -2533,7 +2491,9 @@
               "open": "Open: the chevron turns down and the content shows"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "state": "closed"
+          }
         }
       }
     },
@@ -2882,12 +2842,6 @@
         }
       ],
       "variants": {
-        "COMBOBOX_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "COMBOBOX": {
           "axes": {
             "size": {
@@ -2897,7 +2851,9 @@
               "xl": "48px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -2979,25 +2935,28 @@
               "required": false,
               "default": null,
               "description": "Defaults to \"Search or run a command\" in the provider's language."
+            },
+            {
+              "name": "query",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The query in the field, when you control it; keep it in sync through onQueryChange."
             }
           ],
           "file": "src/components/command-palette/command-palette.tsx"
         }
       ],
       "variants": {
-        "COMMAND_PALETTE_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "COMMAND_PALETTE": {
           "axes": {
             "size": {
               "md": "640px, 20vh from the top (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -3141,12 +3100,6 @@
         }
       ],
       "variants": {
-        "CLIPBOARD_TEXT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "CLIPBOARD_TEXT": {
           "axes": {
             "size": {
@@ -3155,14 +3108,9 @@
               "lg": "40px"
             }
           },
-          "defaults": {}
-        },
-        "COPY_BUTTON_DEFAULT": {
-          "axes": {
-            "variant": {},
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "COPY_BUTTON": {
           "axes": {
@@ -3178,7 +3126,10 @@
               "xl": "48px circle"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "ghost",
+            "size": "sm"
+          }
         }
       }
     },
@@ -3378,12 +3329,6 @@
         }
       ],
       "variants": {
-        "DATA_TABLE_DEFAULT": {
-          "axes": {
-            "density": {}
-          },
-          "defaults": {}
-        },
         "DATA_TABLE": {
           "axes": {
             "density": {
@@ -3392,7 +3337,9 @@
               "comfortable": "48px rows"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "density": "default"
+          }
         }
       }
     },
@@ -3819,12 +3766,6 @@
         }
       ],
       "variants": {
-        "DATE_PICKER_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "DATE_PICKER": {
           "axes": {
             "size": {
@@ -3833,13 +3774,9 @@
               "lg": "40px"
             }
           },
-          "defaults": {}
-        },
-        "TIME_INPUT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "TIME_INPUT": {
           "axes": {
@@ -3850,7 +3787,9 @@
               "xl": "48px: sign-in and setup forms"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -3938,12 +3877,6 @@
         }
       ],
       "variants": {
-        "DELETE_RESOURCE_DEFAULT": {
-          "axes": {
-            "confirm": {}
-          },
-          "defaults": {}
-        },
         "DELETE_RESOURCE": {
           "axes": {
             "confirm": {
@@ -3951,7 +3884,9 @@
               "simple": "A confirm button only, for reversible archives"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "confirm": "typed"
+          }
         }
       }
     },
@@ -3980,7 +3915,7 @@
             },
             {
               "name": "onConfirm",
-              "type": "() => void | Promise<void>",
+              "type": "() => void | Promise<unknown>",
               "required": true,
               "default": null,
               "description": "Called when the action is confirmed; return a promise to keep the dialog busy until it ends. It closes when the promise resolves and stays open for another try when it rejects, so toast the error there."
@@ -4025,7 +3960,7 @@
               "type": "boolean",
               "required": false,
               "default": null,
-              "description": "Shows a spinner on the confirm while work runs (also automatic for a promise)."
+              "description": "Shows a spinner on the confirm while work runs (also automatic for a promise); until it ends, the dialog stays open."
             },
             {
               "name": "onOpenChange",
@@ -4060,7 +3995,7 @@
         },
         {
           "name": "Dialog",
-          "description": "A modal dialog: 440 / 560 / 720, radius 20, title, description, body, actions. ⌘Enter submits.",
+          "description": "A modal dialog: 440 / 560 / 720, radius 20, title, description, body, actions. ⌘Enter submits. It stays centered while its content changes, growing or shrinking 200ms from the size it has; the body scrolls between the header and the footer when the content is taller than the screen. Its content unmounts once it has closed; state kept beside it, like a field, a step or a secret, goes in a component inside a DialogScope.",
           "props": [
             {
               "name": "title",
@@ -4069,6 +4004,13 @@
               "default": null,
               "description": "The dialog's heading, also its accessible name."
             },
+            {
+              "name": "busy",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Keeps the dialog open while work it started is underway: Escape, a press outside, the close circle, Dialog.Close and ⌘Enter do nothing, so a request is never abandoned or sent twice."
+            },
             {
               "name": "children",
               "type": "ReactNode",
@@ -4163,6 +4105,27 @@
           ],
           "file": "src/components/dialog/dialog.tsx"
         },
+        {
+          "name": "DialogScope",
+          "description": "Opens a dialog's flow fresh every time: its children mount anew when `open` turns true and unmount once the Dialog, StepDialog, LayerDialog, AlertDialog, Sheet or CommandPalette inside has finished closing. Fields, steps, errors, results and secrets shown once never come back on the next open, and nothing changes while the dialog animates out.",
+          "props": [
+            {
+              "name": "children",
+              "type": "ReactNode",
+              "required": true,
+              "default": null,
+              "description": "The component that keeps the flow's state and renders the dialog with the same `open`."
+            },
+            {
+              "name": "open",
+              "type": "boolean",
+              "required": true,
+              "default": null,
+              "description": "Whether the dialog inside is open; pass the value its `open` gets."
+            }
+          ],
+          "file": "src/components/dialog/scope.tsx"
+        },
         {
           "name": "LayerDialog",
           "description": "A stacked dialog: a second layer slides over the first (add model → review values); back returns. The layers below stay as they were. Moving to a layer puts the focus on its first field, or its primary action; Back returns it to the control that opened the layer, scrolled where it was. ⌘/Ctrl+Enter calls onSubmit on every layer.",
@@ -4174,6 +4137,13 @@
               "default": null,
               "description": "The layers, each with its title, content and footer; one shows at a time, and the ones below it stay mounted and hidden."
             },
+            {
+              "name": "busy",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Keeps the dialog open while work it started is underway: Escape, a press outside, the close circle, Dialog.Close and ⌘Enter do nothing, so a request is never abandoned or sent twice."
+            },
             {
               "name": "className",
               "type": "string",
@@ -4256,7 +4226,7 @@
         },
         {
           "name": "StepDialog",
-          "description": "A form split into steps, one question at a time, like sign-in: the step's title and fields, Back and Continue, the action on the last step. Enter in a field and ⌘/Ctrl+Enter continue. The dialog takes each step's height: it grows or shrinks 200ms as the step changes, its top stays where it opened, and the new step drifts in from the side it comes from. Within a step it never shrinks, so nothing jumps while a step's content changes; it grows once if the content does. Steps a few pixels apart share one height. Continue and Back move the focus into the step they show (its first field; without one, the primary action, or Back when the last step destroys), and a screen reader hears which step it is.",
+          "description": "A form split into steps, one question at a time, like sign-in: the step's title and fields, Back and Continue, the action on the last step. Enter in a field and ⌘/Ctrl+Enter continue. The dialog takes each step's own height and stays centered: it grows or shrinks 200ms from the size it has as the step changes, and the new step drifts in from the side it comes from. With `result`, what the last step made (a key shown once) takes the steps' place in the same dialog, at its own size. Continue and Back move the focus into the step they show (its first field; without one, the primary action, or Back when the last step destroys), and a screen reader hears which step it is.",
           "props": [
             {
               "name": "onSubmit",
@@ -4314,6 +4284,13 @@
               "default": null,
               "description": "Whether it is open, when you control it."
             },
+            {
+              "name": "result",
+              "type": "StepDialogResult",
+              "required": false,
+              "default": null,
+              "description": "What the last step made, shown in the same dialog once it exists: its title, description, content, footer and size. Pass it after `onSubmit` succeeds, such as the created key with SecretReveal."
+            },
             {
               "name": "size",
               "type": "\"md\" | \"sm\" | \"lg\"",
@@ -4326,7 +4303,7 @@
               "type": "boolean",
               "required": false,
               "default": null,
-              "description": "Shows that the submission is underway."
+              "description": "Shows that the submission is underway; until it ends, the dialog stays open and Back and Cancel wait."
             },
             {
               "name": "tone",
@@ -4340,12 +4317,6 @@
         }
       ],
       "variants": {
-        "ALERT_DIALOG_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "ALERT_DIALOG": {
           "axes": {
             "tone": {
@@ -4354,13 +4325,9 @@
               "info": "Neutral confirmation"
             }
           },
-          "defaults": {}
-        },
-        "DIALOG_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "tone": "danger"
+          }
         },
         "DIALOG": {
           "axes": {
@@ -4370,13 +4337,9 @@
               "lg": "720px: two columns, previews"
             }
           },
-          "defaults": {}
-        },
-        "LAYER_DIALOG_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "LAYER_DIALOG": {
           "axes": {
@@ -4386,7 +4349,9 @@
               "lg": "720px: two columns, previews"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -4453,12 +4418,6 @@
         }
       ],
       "variants": {
-        "DISPLAY_OPTIONS_DEFAULT": {
-          "axes": {
-            "trigger": {}
-          },
-          "defaults": {}
-        },
         "DISPLAY_OPTIONS": {
           "axes": {
             "trigger": {
@@ -4466,7 +4425,9 @@
               "ghost": "A ghost circle"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "trigger": "secondary"
+          }
         }
       }
     },
@@ -4526,12 +4487,6 @@
         }
       ],
       "variants": {
-        "EMPTY_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "EMPTY": {
           "axes": {
             "size": {
@@ -4540,7 +4495,9 @@
               "compact": "Inside tables and lists"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "lg"
+          }
         }
       }
     },
@@ -4621,12 +4578,6 @@
         }
       ],
       "variants": {
-        "FIELD_DEFAULT": {
-          "axes": {
-            "layout": {}
-          },
-          "defaults": {}
-        },
         "FIELD": {
           "axes": {
             "layout": {
@@ -4634,7 +4585,9 @@
               "horizontal": "Label in a 240px column on the left, from 768px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "layout": "vertical"
+          }
         }
       }
     },
@@ -4750,19 +4703,15 @@
         }
       ],
       "variants": {
-        "FILTER_CHIP_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "FILTER_CHIP": {
           "axes": {
             "size": {
               "sm": "32px: toolbars (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "sm"
+          }
         }
       }
     },
@@ -4808,12 +4757,6 @@
         }
       ],
       "variants": {
-        "FILTER_ROW_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "FILTER_ROW": {
           "axes": {
             "size": {
@@ -4821,7 +4764,9 @@
               "inset": "In a settings column: 24px under the header (with the column's 8px), 16px above the list or table (chosen automatically)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -4881,12 +4826,6 @@
         }
       ],
       "variants": {
-        "FLOW_DEFAULT": {
-          "axes": {
-            "node": {}
-          },
-          "defaults": {}
-        },
         "FLOW": {
           "axes": {
             "node": {
@@ -4894,7 +4833,9 @@
               "box": "A rounded-14 box with a description line"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "node": "pill"
+          }
         }
       }
     },
@@ -4933,12 +4874,6 @@
         }
       ],
       "variants": {
-        "HEADING_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "HEADING": {
           "axes": {
             "size": {
@@ -4948,7 +4883,9 @@
               "display": "40/44: showcase headings, the setup screen"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "title-sm"
+          }
         }
       }
     },
@@ -4987,12 +4924,6 @@
         }
       ],
       "variants": {
-        "ICON_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "ICON": {
           "axes": {
             "size": {
@@ -5003,7 +4934,9 @@
               "xl": "24px, 1.5 stroke: rare, large moments"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "sm"
+          }
         }
       }
     },
@@ -5098,13 +5031,6 @@
         }
       ],
       "variants": {
-        "ICON_BUTTON_DEFAULT": {
-          "axes": {
-            "variant": {},
-            "size": {}
-          },
-          "defaults": {}
-        },
         "ICON_BUTTON": {
           "axes": {
             "variant": {
@@ -5124,7 +5050,10 @@
               "xl": "48px circle"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "ghost",
+            "size": "sm"
+          }
         }
       }
     },
@@ -5953,19 +5882,7 @@
         }
       ],
       "variants": {
-        "INPUT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
-        "INPUT_GROUP_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
-        "INPUT_GROUP": {
+        "INPUT": {
           "axes": {
             "size": {
               "sm": "32px: toolbars and compact forms",
@@ -5974,9 +5891,11 @@
               "xl": "48px: sign-in and setup forms"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
-        "INPUT": {
+        "INPUT_GROUP": {
           "axes": {
             "size": {
               "sm": "32px: toolbars and compact forms",
@@ -5985,13 +5904,9 @@
               "xl": "48px: sign-in and setup forms"
             }
           },
-          "defaults": {}
-        },
-        "NUMBER_INPUT_DEFAULT": {
-          "axes": {
-            "align": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "NUMBER_INPUT": {
           "axes": {
@@ -6000,13 +5915,9 @@
               "start": "Left-aligned"
             }
           },
-          "defaults": {}
-        },
-        "OTP_INPUT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "align": "end"
+          }
         },
         "OTP_INPUT": {
           "axes": {
@@ -6015,13 +5926,9 @@
               "sm": "40px cells"
             }
           },
-          "defaults": {}
-        },
-        "SENSITIVE_INPUT_DEFAULT": {
-          "axes": {
-            "kind": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "SENSITIVE_INPUT": {
           "axes": {
@@ -6030,13 +5937,9 @@
               "password": "Passwords: browser password managers allowed, Caps Lock hint"
             }
           },
-          "defaults": {}
-        },
-        "TAG_INPUT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "kind": "secret"
+          }
         },
         "TAG_INPUT": {
           "axes": {
@@ -6044,13 +5947,9 @@
               "md": "36px at one row; grows as tags wrap (default)"
             }
           },
-          "defaults": {}
-        },
-        "TEXTAREA_DEFAULT": {
-          "axes": {
-            "resize": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "TEXTAREA": {
           "axes": {
@@ -6059,7 +5958,9 @@
               "vertical": "People can drag it taller"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "resize": "auto"
+          }
         }
       }
     },
@@ -6735,12 +6636,6 @@
         }
       ],
       "variants": {
-        "CONVERSATION_DEFAULT": {
-          "axes": {
-            "density": {}
-          },
-          "defaults": {}
-        },
         "CONVERSATION": {
           "axes": {
             "density": {
@@ -6748,13 +6643,9 @@
               "compact": "16px, inside sheets"
             }
           },
-          "defaults": {}
-        },
-        "EFFECTIVE_ACCESS_DEFAULT": {
-          "axes": {
-            "layout": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "density": "default"
+          }
         },
         "EFFECTIVE_ACCESS": {
           "axes": {
@@ -6762,13 +6653,9 @@
               "rows": "A row per group: its name, what is granted in words, and how many (default)"
             }
           },
-          "defaults": {}
-        },
-        "IDENTITY_DEFAULT": {
-          "axes": {
-            "provider": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "layout": "rows"
+          }
         },
         "IDENTITY": {
           "axes": {
@@ -6779,13 +6666,9 @@
               "xl": "40px: a provider's own page or card"
             }
           },
-          "defaults": {}
-        },
-        "MOMENTS_DEFAULT": {
-          "axes": {
-            "secret": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "provider": "md"
+          }
         },
         "MOMENTS": {
           "axes": {
@@ -6793,14 +6676,9 @@
               "md": "The one-time secret on a well"
             }
           },
-          "defaults": {}
-        },
-        "RIGHTS_MATRIX_DEFAULT": {
-          "axes": {
-            "origin": {},
-            "mode": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "secret": "md"
+          }
         },
         "RIGHTS_MATRIX": {
           "axes": {
@@ -6815,13 +6693,10 @@
               "readOnly": "A mark per right and, under it, the roles that grant it"
             }
           },
-          "defaults": {}
-        },
-        "ROLE_PICKER_DEFAULT": {
-          "axes": {
-            "appearance": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "origin": "none",
+            "mode": "edit"
+          }
         },
         "ROLE_PICKER": {
           "axes": {
@@ -6830,13 +6705,9 @@
               "select": "A pill that opens the roles: filters, table rows and tight forms"
             }
           },
-          "defaults": {}
-        },
-        "USAGE_DEFAULT": {
-          "axes": {
-            "limit": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "appearance": "list"
+          }
         },
         "USAGE": {
           "axes": {
@@ -6845,7 +6716,9 @@
               "soft": "Over the limit only alerts"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "limit": "hard"
+          }
         }
       }
     },
@@ -6898,12 +6771,6 @@
         }
       ],
       "variants": {
-        "KBD_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "KBD": {
           "axes": {
             "tone": {
@@ -6911,7 +6778,9 @@
               "onInk": "Inside ink surfaces (toasts, the selection bar)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "default"
+          }
         }
       }
     },
@@ -6957,13 +6826,6 @@
         }
       ],
       "variants": {
-        "KEY_VALUE_DEFAULT": {
-          "axes": {
-            "layout": {},
-            "columns": {}
-          },
-          "defaults": {}
-        },
         "KEY_VALUE": {
           "axes": {
             "layout": {
@@ -6977,7 +6839,10 @@
               "4": "Four to a row from 480px, for short values (counts, sizes); two below"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "layout": "columns",
+            "columns": "2"
+          }
         }
       }
     },
@@ -7016,12 +6881,6 @@
         }
       ],
       "variants": {
-        "LABEL_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "LABEL": {
           "axes": {
             "size": {
@@ -7029,7 +6888,9 @@
               "sm": "13/500: compact forms"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -7152,14 +7013,6 @@
         }
       ],
       "variants": {
-        "LAYOUT_DEFAULT": {
-          "axes": {
-            "align": {},
-            "justify": {},
-            "columns": {}
-          },
-          "defaults": {}
-        },
         "LAYOUT": {
           "axes": {
             "align": {
@@ -7183,7 +7036,11 @@
               "6": "Three, then six from 1024px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "align": "stretch",
+            "justify": "start",
+            "columns": "2"
+          }
         }
       }
     },
@@ -7219,31 +7076,29 @@
             },
             {
               "name": "variant",
-              "type": "\"inline\" | \"quiet\" | \"standalone\"",
+              "type": "\"heading\" | \"inline\" | \"quiet\" | \"standalone\" | \"card\"",
               "required": false,
               "default": "inline",
-              "description": "Underlined in text (`inline`), quiet in lists (`quiet`) or on its own line with an arrow (`standalone`)."
+              "description": "Underlined in text (`inline`), quiet in lists (`quiet`), on its own line with an arrow (`standalone`), inside a heading that links to itself (`heading`), or as a page to read next with its name and a sentence (`card`)."
             }
           ],
           "file": "src/components/link/link.tsx"
         }
       ],
       "variants": {
-        "LINK_DEFAULT": {
-          "axes": {
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "LINK": {
           "axes": {
             "variant": {
               "inline": "Inside prose: text color with a quiet underline that turns solid on hover",
               "quiet": "Navigation-style links in footers and metadata; no underline until hover",
-              "standalone": "A link on its own line (“Team overview ›”)"
+              "standalone": "A link on its own line (“Team overview ›”)",
+              "heading": "A heading's link to itself: the heading's own look, with a # beside it on hover and keyboard focus",
+              "card": "A page to read next: a filled well with the page's name and one sentence about it"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "inline"
+          }
         }
       }
     },
@@ -7639,12 +7494,6 @@
         }
       ],
       "variants": {
-        "LIST_DEFAULT": {
-          "axes": {
-            "density": {}
-          },
-          "defaults": {}
-        },
         "LIST": {
           "axes": {
             "density": {
@@ -7652,7 +7501,9 @@
               "compact": "36px rows"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "density": "default"
+          }
         }
       }
     },
@@ -7740,13 +7591,6 @@
         }
       ],
       "variants": {
-        "LOADER_DEFAULT": {
-          "axes": {
-            "size": {},
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "LOADER": {
           "axes": {
             "size": {
@@ -7762,13 +7606,10 @@
               "current": "The text color around it"
             }
           },
-          "defaults": {}
-        },
-        "SPINNER_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "sm",
+            "tone": "secondary"
+          }
         },
         "SPINNER": {
           "axes": {
@@ -7780,7 +7621,9 @@
               "xl": "32px: a page loading"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "sm"
+          }
         }
       }
     },
@@ -7819,13 +7662,6 @@
         }
       ],
       "variants": {
-        "LOGO_DEFAULT": {
-          "axes": {
-            "markSize": {},
-            "lockupSize": {}
-          },
-          "defaults": {}
-        },
         "LOGO": {
           "axes": {
             "markSize": {
@@ -7840,7 +7676,10 @@
               "lg": "40px: auth and setup screens"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "markSize": "md",
+            "lockupSize": "sm"
+          }
         }
       }
     },
@@ -7921,13 +7760,6 @@
         }
       ],
       "variants": {
-        "MARKDOWN_DEFAULT": {
-          "axes": {
-            "size": {},
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "MARKDOWN": {
           "axes": {
             "size": {
@@ -7940,7 +7772,10 @@
               "secondary": "Quieter text: reasoning summaries and quotes"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "body",
+            "tone": "default"
+          }
         }
       }
     },
@@ -8014,14 +7849,6 @@
         }
       ],
       "variants": {
-        "MENU_DEFAULT": {
-          "axes": {
-            "item": {},
-            "width": {},
-            "description": {}
-          },
-          "defaults": {}
-        },
         "MENU": {
           "axes": {
             "item": {
@@ -8037,7 +7864,11 @@
               "danger": "A second line that warns: an organization scheduled for deletion"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "item": "default",
+            "width": "auto",
+            "description": "secondary"
+          }
         }
       }
     },
@@ -8153,12 +7984,6 @@
         }
       ],
       "variants": {
-        "METER_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "METER": {
           "axes": {
             "tone": {
@@ -8166,13 +7991,9 @@
               "neutral": "A plain share"
             }
           },
-          "defaults": {}
-        },
-        "PROGRESS_DEFAULT": {
-          "axes": {
-            "kind": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "tone": "auto"
+          }
         },
         "PROGRESS": {
           "axes": {
@@ -8181,7 +8002,9 @@
               "indeterminate": "A 2px line at the top of a container"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "kind": "determinate"
+          }
         }
       }
     },
@@ -8241,19 +8064,15 @@
         }
       ],
       "variants": {
-        "PAGE_HEADER_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "PAGE_HEADER": {
           "axes": {
             "size": {
               "md": "52px, no bottom line (default); on a phone the tabs take a second row"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -8446,12 +8265,6 @@
         }
       ],
       "variants": {
-        "PAGES_DEFAULT": {
-          "axes": {
-            "page": {}
-          },
-          "defaults": {}
-        },
         "PAGES": {
           "axes": {
             "page": {
@@ -8462,7 +8275,9 @@
               "auth": "No chrome; a centered 400px column"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "page": "list"
+          }
         }
       }
     },
@@ -8557,12 +8372,6 @@
         }
       ],
       "variants": {
-        "PAGINATION_DEFAULT": {
-          "axes": {
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "PAGINATION": {
           "axes": {
             "variant": {
@@ -8571,7 +8380,9 @@
               "pages": "Page numbers, for lists with a known number of pages"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "load-more"
+          }
         }
       }
     },
@@ -9352,12 +9163,6 @@
         }
       ],
       "variants": {
-        "COMPARE_GRID_DEFAULT": {
-          "axes": {
-            "divider": {}
-          },
-          "defaults": {}
-        },
         "COMPARE_GRID": {
           "axes": {
             "divider": {
@@ -9365,13 +9170,9 @@
               "none": "No line between columns: columns that sit in panels of their own"
             }
           },
-          "defaults": {}
-        },
-        "COMPOSER_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "divider": "hairline"
+          }
         },
         "COMPOSER": {
           "axes": {
@@ -9380,13 +9181,9 @@
               "sm": "The same box starting one line tall: a follow-up field under a thread"
             }
           },
-          "defaults": {}
-        },
-        "MODEL_PICKER_DEFAULT": {
-          "axes": {
-            "appearance": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         },
         "MODEL_PICKER": {
           "axes": {
@@ -9395,13 +9192,9 @@
               "default": "A raised pill with a ring: a form or toolbar"
             }
           },
-          "defaults": {}
-        },
-        "PARAMETER_PANEL_DEFAULT": {
-          "axes": {
-            "layout": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "appearance": "ghost"
+          }
         },
         "PARAMETER_PANEL": {
           "axes": {
@@ -9410,13 +9203,9 @@
               "panel": "A side panel or sheet: a little more room between groups"
             }
           },
-          "defaults": {}
-        },
-        "PROMPT_SUGGESTIONS_DEFAULT": {
-          "axes": {
-            "align": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "layout": "popover"
+          }
         },
         "PROMPT_SUGGESTIONS": {
           "axes": {
@@ -9425,13 +9214,9 @@
               "center": "Centered under an empty thread's title"
             }
           },
-          "defaults": {}
-        },
-        "RESPONSE_METRICS_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "align": "start"
+          }
         },
         "RESPONSE_METRICS": {
           "axes": {
@@ -9440,13 +9225,9 @@
               "md": "13/18: a response on its own"
             }
           },
-          "defaults": {}
-        },
-        "RESPONSE_VIEW_DEFAULT": {
-          "axes": {
-            "status": {}
-          },
-          "defaults": {}
+          "defaults": {
+            "size": "sm"
+          }
         },
         "RESPONSE_VIEW": {
           "axes": {
@@ -9458,7 +9239,9 @@
               "error": "Failed: “No response” and Retry. The error itself is a toast"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "status": "done"
+          }
         }
       }
     },
@@ -9546,12 +9329,6 @@
         }
       ],
       "variants": {
-        "POPOVER_DEFAULT": {
-          "axes": {
-            "padding": {}
-          },
-          "defaults": {}
-        },
         "POPOVER": {
           "axes": {
             "padding": {
@@ -9560,7 +9337,9 @@
               "none": "No padding: calendars and custom layouts"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "padding": "form"
+          }
         }
       }
     },
@@ -9592,10 +9371,6 @@
         }
       ],
       "variants": {
-        "PORTAL_DEFAULT": {
-          "axes": {},
-          "defaults": {}
-        },
         "PORTAL": {
           "axes": {},
           "defaults": {}
@@ -9644,12 +9419,6 @@
         }
       ],
       "variants": {
-        "QR_CODE_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "QR_CODE": {
           "axes": {
             "size": {
@@ -9657,7 +9426,9 @@
               "lg": "200px: a page of its own"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -9899,12 +9670,6 @@
         }
       ],
       "variants": {
-        "RADIO_DEFAULT": {
-          "axes": {
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "RADIO": {
           "axes": {
             "variant": {
@@ -9912,7 +9677,9 @@
               "cards": "Rows inside a settings group with the radio at the end, for choices with descriptions"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "default"
+          }
         }
       }
     },
@@ -9986,12 +9753,6 @@
         }
       ],
       "variants": {
-        "RESOURCE_LIST_DEFAULT": {
-          "axes": {
-            "grouping": {}
-          },
-          "defaults": {}
-        },
         "RESOURCE_LIST": {
           "axes": {
             "grouping": {
@@ -9999,7 +9760,9 @@
               "flat": "One list"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "grouping": "grouped"
+          }
         }
       }
     },
@@ -10052,12 +9815,6 @@
         }
       ],
       "variants": {
-        "SCROLL_AREA_DEFAULT": {
-          "axes": {
-            "orientation": {}
-          },
-          "defaults": {}
-        },
         "SCROLL_AREA": {
           "axes": {
             "orientation": {
@@ -10066,7 +9823,9 @@
               "both": "Both directions"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "orientation": "vertical"
+          }
         }
       }
     },
@@ -10196,12 +9955,6 @@
         }
       ],
       "variants": {
-        "SECTION_DEFAULT": {
-          "axes": {
-            "spacing": {}
-          },
-          "defaults": {}
-        },
         "SECTION": {
           "axes": {
             "spacing": {
@@ -10209,7 +9962,9 @@
               "none": "No outer spacing"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "spacing": "default"
+          }
         }
       }
     },
@@ -10297,12 +10052,6 @@
         }
       ],
       "variants": {
-        "SEGMENTED_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "SEGMENTED": {
           "axes": {
             "size": {
@@ -10310,7 +10059,9 @@
               "md": "36px track, 32px items (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -10504,13 +10255,6 @@
         }
       ],
       "variants": {
-        "SELECT_DEFAULT": {
-          "axes": {
-            "appearance": {},
-            "size": {}
-          },
-          "defaults": {}
-        },
         "SELECT": {
           "axes": {
             "appearance": {
@@ -10525,7 +10269,10 @@
               "xl": "48px: sign-in and setup forms"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "appearance": "default",
+            "size": "md"
+          }
         }
       }
     },
@@ -10564,13 +10311,6 @@
         }
       ],
       "variants": {
-        "SEPARATOR_DEFAULT": {
-          "axes": {
-            "orientation": {},
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "SEPARATOR": {
           "axes": {
             "orientation": {
@@ -10582,7 +10322,10 @@
               "default": "Between regions that tone and space cannot separate"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "orientation": "horizontal",
+            "tone": "subtle"
+          }
         }
       }
     },
@@ -10747,12 +10490,6 @@
         }
       ],
       "variants": {
-        "SETTINGS_DEFAULT": {
-          "axes": {
-            "row": {}
-          },
-          "defaults": {}
-        },
         "SETTINGS": {
           "axes": {
             "row": {
@@ -10760,7 +10497,9 @@
               "single": "One line: 56px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "row": "default"
+          }
         }
       }
     },
@@ -10869,13 +10608,6 @@
         }
       ],
       "variants": {
-        "SHEET_DEFAULT": {
-          "axes": {
-            "size": {},
-            "side": {}
-          },
-          "defaults": {}
-        },
         "SHEET": {
           "axes": {
             "size": {
@@ -10889,7 +10621,10 @@
               "bottom": "From the bottom: mobile menus"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "sm",
+            "side": "right"
+          }
         }
       }
     },
@@ -10948,14 +10683,6 @@
         }
       ],
       "variants": {
-        "SIDEBAR_DEFAULT": {
-          "axes": {
-            "mode": {},
-            "item": {},
-            "caption": {}
-          },
-          "defaults": {}
-        },
         "SIDEBAR": {
           "axes": {
             "mode": {
@@ -10971,7 +10698,11 @@
               "danger": "A second line that warns: the organization is scheduled for deletion"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "mode": "expanded",
+            "item": "default",
+            "caption": "secondary"
+          }
         }
       }
     },
@@ -11010,12 +10741,6 @@
         }
       ],
       "variants": {
-        "SKELETON_DEFAULT": {
-          "axes": {
-            "shape": {}
-          },
-          "defaults": {}
-        },
         "SKELETON": {
           "axes": {
             "shape": {
@@ -11025,7 +10750,9 @@
               "control": "The shape of a 36px control"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "shape": "block"
+          }
         }
       }
     },
@@ -11148,19 +10875,15 @@
         }
       ],
       "variants": {
-        "SLIDER_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "SLIDER": {
           "axes": {
             "size": {
               "md": "A 4px track in a 20px hit area (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -11318,12 +11041,6 @@
         }
       ],
       "variants": {
-        "STAT_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "STAT": {
           "axes": {
             "size": {
@@ -11331,7 +11048,9 @@
               "sm": "20/28 for dense rows"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -11412,12 +11131,6 @@
         }
       ],
       "variants": {
-        "STATUS_DOT_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "STATUS_DOT": {
           "axes": {
             "tone": {
@@ -11428,7 +11141,9 @@
               "neutral": "Inactive, archived (default)"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "neutral"
+          }
         }
       }
     },
@@ -11453,12 +11168,6 @@
         }
       ],
       "variants": {
-        "SURFACE_DEFAULT": {
-          "axes": {
-            "kind": {}
-          },
-          "defaults": {}
-        },
         "SURFACE": {
           "axes": {
             "kind": {
@@ -11472,7 +11181,9 @@
               "tooltip": "Chart tooltips and rich tooltips: radius 12"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "kind": "panel"
+          }
         }
       }
     },
@@ -11511,12 +11222,6 @@
         }
       ],
       "variants": {
-        "SWAP_TEXT_DEFAULT": {
-          "axes": {
-            "align": {}
-          },
-          "defaults": {}
-        },
         "SWAP_TEXT": {
           "axes": {
             "align": {
@@ -11524,7 +11229,9 @@
               "start": "Aligned to the start"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "align": "center"
+          }
         }
       }
     },
@@ -11654,12 +11361,6 @@
         }
       ],
       "variants": {
-        "SWITCH_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "SWITCH": {
           "axes": {
             "size": {
@@ -11668,7 +11369,9 @@
               "lg": "44×24, 20px thumb"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -11685,12 +11388,6 @@
         }
       ],
       "variants": {
-        "TABLE_DEFAULT": {
-          "axes": {
-            "align": {}
-          },
-          "defaults": {}
-        },
         "TABLE": {
           "axes": {
             "align": {
@@ -11698,7 +11395,9 @@
               "end": "Numbers"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "align": "start"
+          }
         }
       }
     },
@@ -11807,12 +11506,6 @@
         }
       ],
       "variants": {
-        "TABS_DEFAULT": {
-          "axes": {
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "TABS": {
           "axes": {
             "variant": {
@@ -11820,7 +11513,9 @@
               "pill": "Header tabs: separate 32px pills, the active one filled"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "underline"
+          }
         }
       }
     },
@@ -11985,13 +11680,6 @@
         }
       ],
       "variants": {
-        "TAG_DEFAULT": {
-          "axes": {
-            "size": {},
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "TAG": {
           "axes": {
             "size": {
@@ -12004,7 +11692,10 @@
               "soft": "Filled: selected toggle pills"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md",
+            "variant": "raised"
+          }
         }
       }
     },
@@ -12078,13 +11769,6 @@
         }
       ],
       "variants": {
-        "TEXT_DEFAULT": {
-          "axes": {
-            "variant": {},
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "TEXT": {
           "axes": {
             "variant": {
@@ -12115,6 +11799,83 @@
               "semibold": "600 (580 in dark mode)"
             }
           },
+          "defaults": {
+            "variant": "body",
+            "tone": "default"
+          }
+        }
+      }
+    },
+    {
+      "entry": "theme-image",
+      "kind": "components",
+      "import": "@logicplanes/kaeso-ui/theme-image",
+      "components": [
+        {
+          "name": "ThemeImage",
+          "description": "An image drawn twice, once for each theme: it follows the site's theme setting, not only the system's, and prints the light one.",
+          "props": [
+            {
+              "name": "alt",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "What the image shows, read by screen readers and shown when it can't load."
+            },
+            {
+              "name": "dark",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The image's address for the dark theme."
+            },
+            {
+              "name": "light",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The image's address for the light theme and for print."
+            },
+            {
+              "name": "aria-describedby",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The id of a longer description, such as a diagram's text alternative."
+            },
+            {
+              "name": "className",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "Classes for the layout of the outer element: margin, width and placement, never its look."
+            },
+            {
+              "name": "height",
+              "type": "number",
+              "required": false,
+              "default": null,
+              "description": "The image's own height in pixels, so the page keeps its place before it loads."
+            },
+            {
+              "name": "width",
+              "type": "number",
+              "required": false,
+              "default": null,
+              "description": "The image's own width in pixels; the image shrinks to its container, never grows past this."
+            }
+          ],
+          "file": "src/components/theme-image/theme-image.tsx"
+        }
+      ],
+      "variants": {
+        "THEME_IMAGE": {
+          "axes": {
+            "theme": {
+              "light": "Shown in the light theme and in print",
+              "dark": "Shown in the dark theme"
+            }
+          },
           "defaults": {}
         }
       }
@@ -12147,12 +11908,6 @@
         }
       ],
       "variants": {
-        "THEME_MENU_DEFAULT": {
-          "axes": {
-            "variant": {}
-          },
-          "defaults": {}
-        },
         "THEME_MENU": {
           "axes": {
             "variant": {
@@ -12160,7 +11915,76 @@
               "secondary": "A raised circle"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "variant": "ghost"
+          }
+        }
+      }
+    },
+    {
+      "entry": "theme-select",
+      "kind": "components",
+      "import": "@logicplanes/kaeso-ui/theme-select",
+      "components": [
+        {
+          "name": "ThemeSelect",
+          "description": "A select for system, light or dark, stored as `kaeso:theme`, with its label in the provider's language.",
+          "props": [
+            {
+              "name": "appearance",
+              "type": "\"ghost\" | \"default\"",
+              "required": false,
+              "default": "ghost",
+              "description": "A quiet pill for sidebars and toolbars (`ghost`) or a raised one with a ring (`default`)."
+            },
+            {
+              "name": "className",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "Classes for the layout of the outer element: margin, width and placement, never its look."
+            },
+            {
+              "name": "data-force",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "Forces an interaction state for state matrices: `hover`, `pressed`, `focus`, `open`."
+            },
+            {
+              "name": "fullWidth",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Width of the trigger follows its content (default) or fills the container, as in a sidebar's footer."
+            },
+            {
+              "name": "size",
+              "type": "\"md\" | \"sm\"",
+              "required": false,
+              "default": "sm",
+              "description": "The height of the field."
+            }
+          ],
+          "file": "src/components/theme-select/theme-select.tsx"
+        }
+      ],
+      "variants": {
+        "THEME_SELECT": {
+          "axes": {
+            "appearance": {
+              "ghost": "A quiet pill for sidebars and toolbars (default)",
+              "default": "A raised pill with a ring"
+            },
+            "size": {
+              "sm": "32px (default)",
+              "md": "36px"
+            }
+          },
+          "defaults": {
+            "appearance": "ghost",
+            "size": "sm"
+          }
         }
       }
     },
@@ -12192,12 +12016,6 @@
         }
       ],
       "variants": {
-        "TIMELINE_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "TIMELINE": {
           "axes": {
             "tone": {
@@ -12208,7 +12026,9 @@
               "info": "Informational"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "neutral"
+          }
         }
       }
     },
@@ -12310,12 +12130,6 @@
         }
       ],
       "variants": {
-        "TOAST_DEFAULT": {
-          "axes": {
-            "tone": {}
-          },
-          "defaults": {}
-        },
         "TOAST": {
           "axes": {
             "tone": {
@@ -12327,7 +12141,9 @@
               "loading": "Work underway: a spinner"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "tone": "neutral"
+          }
         }
       }
     },
@@ -12373,12 +12189,6 @@
         }
       ],
       "variants": {
-        "TABLE_OF_CONTENTS_DEFAULT": {
-          "axes": {
-            "state": {}
-          },
-          "defaults": {}
-        },
         "TABLE_OF_CONTENTS": {
           "axes": {
             "state": {
@@ -12386,7 +12196,9 @@
               "active": "The heading in view, with a 2px ink bar"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "state": "default"
+          }
         }
       }
     },
@@ -12418,12 +12230,6 @@
         }
       ],
       "variants": {
-        "TOOLBAR_DEFAULT": {
-          "axes": {
-            "size": {}
-          },
-          "defaults": {}
-        },
         "TOOLBAR": {
           "axes": {
             "size": {
@@ -12431,7 +12237,9 @@
               "inset": "48px without side padding, inside padded content"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "size": "md"
+          }
         }
       }
     },
@@ -12575,13 +12383,6 @@
         }
       ],
       "variants": {
-        "TOOLTIP_DEFAULT": {
-          "axes": {
-            "side": {},
-            "shape": {}
-          },
-          "defaults": {}
-        },
         "TOOLTIP": {
           "axes": {
             "side": {
@@ -12595,7 +12396,10 @@
               "multiline": "Several lines: radius 12, max 280px"
             }
           },
-          "defaults": {}
+          "defaults": {
+            "side": "top",
+            "shape": "pill"
+          }
         }
       }
     },
@@ -12612,10 +12416,6 @@
         }
       ],
       "variants": {
-        "VISUALLY_HIDDEN_DEFAULT": {
-          "axes": {},
-          "defaults": {}
-        },
         "VISUALLY_HIDDEN": {
           "axes": {},
           "defaults": {}