@logicplanes/kaeso-ui 0.4.2 → 0.4.4

package/ai/component-registry.json

@@ -1,7 +1,121 @@
 {
   "package": "@logicplanes/kaeso-ui",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "components": [
+    {
+      "entry": "agent-avatar",
+      "kind": "components",
+      "import": "@logicplanes/kaeso-ui/agent-avatar",
+      "components": [
+        {
+          "name": "AgentAttribution",
+          "description": "A person's avatar with the agent that acted for them as a small badge on its corner, for audit rows and activity; it reads as one picture named after both. The badge stays inside the avatar's square, so a table cell never cuts it off.",
+          "props": [
+            {
+              "name": "agent",
+              "type": "{ name: string; model: string; }",
+              "required": true,
+              "default": null,
+              "description": "The agent that acted, with its name and model family id from the API; the family is named in the accessible name only."
+            },
+            {
+              "name": "name",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The name of the person the agent acted for; it starts the accessible name, such as `Ada Okafor via Release helper (Claude)`."
+            },
+            {
+              "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": "size",
+              "type": "24 | 20 | 28 | 32 | 40",
+              "required": false,
+              "default": "24",
+              "description": "The diameter of the person's avatar in pixels; the agent badge is half of it."
+            },
+            {
+              "name": "src",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The person's picture; without one, or when it fails to load, their initials show."
+            }
+          ],
+          "file": "src/components/agent-avatar/agent-avatar.tsx"
+        },
+        {
+          "name": "AgentAvatar",
+          "description": "An agent acting for a person: one bot face on an ink square, the same for every agent; write its model family beside it with useModelName where it matters.",
+          "props": [
+            {
+              "name": "name",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The agent's name, such as `Release helper`; it is the accessible name."
+            },
+            {
+              "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": "decorative",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Hides it from assistive technology when the agent's name is already written next to it."
+            },
+            {
+              "name": "size",
+              "type": "24 | 20 | 28 | 32 | 40",
+              "required": false,
+              "default": "24",
+              "description": "The side of the square in pixels, on the same scale as `Avatar`."
+            }
+          ],
+          "file": "src/components/agent-avatar/agent-avatar.tsx"
+        }
+      ],
+      "variants": {
+        "AGENT_ATTRIBUTION": {
+          "axes": {
+            "size": {
+              "20": "20px person, 10px agent badge",
+              "24": "24px person, 12px agent badge (default)",
+              "28": "28px person, 14px agent badge",
+              "32": "32px person, 16px agent badge",
+              "40": "40px person, 20px agent badge"
+            }
+          },
+          "defaults": {
+            "size": "24"
+          }
+        },
+        "AGENT_AVATAR": {
+          "axes": {
+            "size": {
+              "20": "20px",
+              "24": "24px: rows and lists (default)",
+              "28": "28px",
+              "32": "32px",
+              "40": "40px: an agent's own page, menus"
+            }
+          },
+          "defaults": {
+            "size": "24"
+          }
+        }
+      }
+    },
     {
       "entry": "app-frame",
       "kind": "components",
@@ -696,7 +810,7 @@
             },
             {
               "name": "weekStartsOn",
-              "type": "0 | 4 | 1 | 2 | 3 | 5 | 6",
+              "type": "0 | 2 | 3 | 4 | 1 | 5 | 6",
               "required": false,
               "default": "1",
               "description": "0 = Sunday, 1 = Monday (default)."
@@ -2115,6 +2229,10 @@
           "defaults": {
             "size": "md"
           }
+        },
+        "CHECKBOX_GROUP": {
+          "axes": {},
+          "defaults": {}
         }
       }
     },
@@ -2367,6 +2485,83 @@
           ],
           "file": "src/components/code-block/code-block.tsx"
         },
+        {
+          "name": "DiffView",
+          "description": "Two versions of a text side by side in one column: removed lines on red, added lines on green, the changed words inside them marked, syntax highlighted, and long unchanged runs folded away.",
+          "props": [
+            {
+              "name": "after",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The new version."
+            },
+            {
+              "name": "before",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The old version."
+            },
+            {
+              "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": "context",
+              "type": "number",
+              "required": false,
+              "default": "3",
+              "description": "Unchanged lines kept around each change before the rest folds (3 by default)."
+            },
+            {
+              "name": "copy",
+              "type": "boolean",
+              "required": false,
+              "default": "true",
+              "description": "Hide the copy circle, which copies the diff with + and - markers."
+            },
+            {
+              "name": "lang",
+              "type": "CodeLang",
+              "required": false,
+              "default": "text",
+              "description": "The language of both versions, for highlighting (`text` by default)."
+            },
+            {
+              "name": "lineNumbers",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Shows the old and the new line numbers."
+            },
+            {
+              "name": "surface",
+              "type": "\"well\" | \"plain\"",
+              "required": false,
+              "default": "well",
+              "description": "On a filled well (`well`) or on the panel itself (`plain`)."
+            },
+            {
+              "name": "title",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "A name in the title bar, beside the count of added and removed lines."
+            },
+            {
+              "name": "wrap",
+              "type": "boolean",
+              "required": false,
+              "default": "false",
+              "description": "Long lines wrap instead of scrolling sideways, keeping their indent: values in a narrow column such as a sheet."
+            }
+          ],
+          "file": "src/components/code-block/diff-view.tsx"
+        },
         {
           "name": "JsonView",
           "description": "A folding JSON tree: copy any path, highlight a search. For request and response bodies.",
@@ -2422,6 +2617,17 @@
             "surface": "well"
           }
         },
+        "DIFF_VIEW": {
+          "axes": {
+            "surface": {
+              "well": "A well: radius 14, fill, no ring (default)",
+              "plain": "No surface, inside another well"
+            }
+          },
+          "defaults": {
+            "surface": "well"
+          }
+        },
         "JSON_VIEW": {
           "axes": {
             "surface": {
@@ -2903,6 +3109,19 @@
         }
       ],
       "variants": {
+        "AUTOCOMPLETE": {
+          "axes": {
+            "size": {
+              "sm": "32px",
+              "md": "36px (default)",
+              "lg": "40px",
+              "xl": "48px"
+            }
+          },
+          "defaults": {
+            "size": "md"
+          }
+        },
         "COMBOBOX": {
           "axes": {
             "size": {
@@ -3577,6 +3796,13 @@
               "default": null,
               "description": "The id of a row to show as active (open in a sheet)."
             },
+            {
+              "name": "canSelectRow",
+              "type": "((row: T) => boolean)",
+              "required": false,
+              "default": null,
+              "description": "Whether a row can be selected; a row that can't keeps a disabled checkbox, and select all skips it."
+            },
             {
               "name": "className",
               "type": "string",
@@ -3894,7 +4120,7 @@
             },
             {
               "name": "weekStartsOn",
-              "type": "0 | 4 | 1 | 2 | 3 | 5 | 6",
+              "type": "0 | 2 | 3 | 4 | 1 | 5 | 6",
               "required": false,
               "default": null,
               "description": "The first day of the week, from 0 (Sunday) to 6 (Saturday); the language decides by default."
@@ -4048,7 +4274,7 @@
             },
             {
               "name": "weekStartsOn",
-              "type": "0 | 4 | 1 | 2 | 3 | 5 | 6",
+              "type": "0 | 2 | 3 | 4 | 1 | 5 | 6",
               "required": false,
               "default": null,
               "description": "The first day of the week, from 0 (Sunday) to 6 (Saturday); the language decides by default."
@@ -4464,6 +4690,13 @@
               "default": null,
               "description": "Right-aligned actions: Cancel (secondary) then the primary."
             },
+            {
+              "name": "footerStart",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "A quiet action at the footer's start, such as a link to another way of doing the task."
+            },
             {
               "name": "headerStart",
               "type": "ReactNode",
@@ -4520,6 +4753,13 @@
               "default": null,
               "description": "The dialog's width."
             },
+            {
+              "name": "toolbar",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "Controls that stay under the title while the body scrolls, such as a search over the list below; a hairline shows once the body is scrolled."
+            },
             {
               "name": "trigger",
               "type": "ReactElement<unknown, string | JSXElementConstructor<any>>",
@@ -4560,7 +4800,7 @@
               "type": "DialogLayer[]",
               "required": true,
               "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."
+              "description": "The layers, each with its title, content and footer, and optionally a toolbar and a footer start; one shows at a time, and the ones below it stay mounted and hidden."
             },
             {
               "name": "anchor",
@@ -4665,7 +4905,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 single-line field and ⌘/Ctrl+Enter continue. The dialog takes each step's own height and keeps its top edge where it opened: it grows or shrinks 200ms downward from the size it has as the step changes, so the title never jumps, 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.",
+          "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 single-line field and ⌘/Ctrl+Enter continue. The dialog takes each step's own height and keeps its top edge where it opened: it grows or shrinks 200ms downward from the size it has as the step changes, so the title never jumps, 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. Inside a step, `useStepDialog()?.advance()` continues as Continue would, once the step is no longer blocked: a choice that answers the step, like a provider tile, moves on in one press.",
           "props": [
             {
               "name": "onSubmit",
@@ -4679,7 +4919,7 @@
               "type": "DialogStep[]",
               "required": true,
               "default": null,
-              "description": "The steps, each with its title, content and whether it can be continued."
+              "description": "The steps, each with its title, content and whether it can be continued; `onContinue` checks a step before the next opens, such as asking a server, and `continueLabel` names that check: \"Detect settings\"."
             },
             {
               "name": "submitLabel",
@@ -4785,6 +5025,10 @@
             "anchor": "center"
           }
         },
+        "DIALOG_SCOPE": {
+          "axes": {},
+          "defaults": {}
+        },
         "LAYER_DIALOG": {
           "axes": {
             "size": {
@@ -4801,6 +5045,23 @@
             "size": "md",
             "anchor": "center"
           }
+        },
+        "STEP_DIALOG": {
+          "axes": {
+            "size": {
+              "sm": "440px: most tasks in a few steps (default)",
+              "md": "560px: steps with longer forms",
+              "lg": "720px: steps with two columns or previews"
+            },
+            "tone": {
+              "default": "The last step's button is primary (default)",
+              "danger": "The last step's button is a danger button, for a task that ends in deletion"
+            }
+          },
+          "defaults": {
+            "size": "sm",
+            "tone": "default"
+          }
         }
       }
     },
@@ -5403,7 +5664,7 @@
             },
             {
               "name": "level",
-              "type": "4 | 1 | 2 | 3 | 5 | 6",
+              "type": "2 | 3 | 4 | 1 | 5 | 6",
               "required": false,
               "default": null,
               "description": "The heading level in the document, independent of its size."
@@ -6484,6 +6745,19 @@
             "size": "md"
           }
         },
+        "SEARCH_INPUT": {
+          "axes": {
+            "size": {
+              "sm": "32px: toolbars (default)",
+              "md": "36px: a search at the top of a page or dialog",
+              "lg": "40px",
+              "xl": "48px"
+            }
+          },
+          "defaults": {
+            "size": "sm"
+          }
+        },
         "SENSITIVE_INPUT": {
           "axes": {
             "kind": {
@@ -6544,6 +6818,41 @@
           ],
           "file": "src/components/kaeso/identity.tsx"
         },
+        {
+          "name": "ClientButton",
+          "description": "An agent client's mark, such as Claude, Cursor or GitHub Copilot, on a raised tile, as a button that opens how to connect it.",
+          "props": [
+            {
+              "name": "aria-label",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The client's name; also the tooltip."
+            },
+            {
+              "name": "client",
+              "type": "\"cursor\" | \"claude\" | \"github-copilot\"",
+              "required": true,
+              "default": null,
+              "description": "Which client's mark it shows."
+            },
+            {
+              "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": "onClick",
+              "type": "(() => void)",
+              "required": false,
+              "default": null,
+              "description": "Opens how to connect the client."
+            }
+          ],
+          "file": "src/components/kaeso/client-button.tsx"
+        },
         {
           "name": "ConversationView",
           "description": "A model conversation from a request log: role captions, prose, tool calls and results, reasoning, images, refusals. Inline images show; remote ones are links, so viewing a log never fetches them.",
@@ -6663,6 +6972,48 @@
           ],
           "file": "src/components/kaeso/moments.tsx"
         },
+        {
+          "name": "GrantSummary",
+          "description": "What an agent or a key may do, one short line each after a check mark, on a group surface.",
+          "props": [
+            {
+              "name": "aria-label",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The list's accessible name (\"What it can do\")."
+            },
+            {
+              "name": "items",
+              "type": "readonly ReactNode[]",
+              "required": true,
+              "default": null,
+              "description": "The lines, short and without a final period."
+            },
+            {
+              "name": "action",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "A small button after the note, such as Customize."
+            },
+            {
+              "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": "footer",
+              "type": "ReactNode",
+              "required": false,
+              "default": null,
+              "description": "A quiet note under the lines, such as how long it lasts."
+            }
+          ],
+          "file": "src/components/kaeso/grant-summary.tsx"
+        },
         {
           "name": "KeyDisplay",
           "description": "A redacted key: mono 13 with its state dot, copy of the redacted form, and its access.",
@@ -6970,10 +7321,10 @@
             },
             {
               "name": "appearance",
-              "type": "\"list\" | \"select\"",
+              "type": "\"list\" | \"grid\" | \"select\"",
               "required": false,
               "default": null,
-              "description": "An always-open list for a dialog step, or a pill that opens it."
+              "description": "An always-open list for a dialog step, tiles with each provider's mark for a dialog's first step, or a pill that opens the list."
             },
             {
               "name": "aria-label",
@@ -7039,6 +7390,13 @@
               "default": null,
               "description": "The label above the control (`vertical`) or beside it (`horizontal`)."
             },
+            {
+              "name": "onChoose",
+              "type": "((id: string) => void)",
+              "required": false,
+              "default": null,
+              "description": "With `grid`: called when a tile is pressed or clicked, not when the arrow keys move the choice, so a dialog step can continue at once."
+            },
             {
               "name": "onValueChange",
               "type": "((id: string | null) => void)",
@@ -7380,6 +7738,10 @@
         }
       ],
       "variants": {
+        "CLIENT_BUTTON": {
+          "axes": {},
+          "defaults": {}
+        },
         "CONVERSATION": {
           "axes": {
             "density": {
@@ -7401,6 +7763,10 @@
             "layout": "rows"
           }
         },
+        "GRANT_SUMMARY": {
+          "axes": {},
+          "defaults": {}
+        },
         "IDENTITY": {
           "axes": {
             "provider": {
@@ -7414,6 +7780,10 @@
             "provider": "md"
           }
         },
+        "KEY_DISPLAY": {
+          "axes": {},
+          "defaults": {}
+        },
         "MOMENTS": {
           "axes": {
             "secret": {
@@ -7428,7 +7798,8 @@
           "axes": {
             "appearance": {
               "list": "A search field over every provider, always open: a dialog step (default)",
-              "select": "A pill that opens the searchable list: forms and toolbars"
+              "select": "A pill that opens the searchable list: forms and toolbars",
+              "grid": "Tiles with each provider's mark, connected ones first: the first step of a dialog"
             }
           },
           "defaults": {
@@ -7464,6 +7835,10 @@
             "appearance": "list"
           }
         },
+        "USAGE_BREAKDOWN": {
+          "axes": {},
+          "defaults": {}
+        },
         "USAGE": {
           "axes": {
             "limit": {
@@ -7564,7 +7939,7 @@
             },
             {
               "name": "columns",
-              "type": "4 | 2 | 3",
+              "type": "2 | 3 | 4",
               "required": false,
               "default": "2",
               "description": "The grid layout's items to a row, from 480px of its container's width."
@@ -7674,14 +8049,14 @@
             },
             {
               "name": "columns",
-              "type": "4 | 1 | 2 | 3 | 6",
+              "type": "2 | 3 | 4 | 1 | 6",
               "required": false,
               "default": "2",
               "description": "The number of columns."
             },
             {
               "name": "gap",
-              "type": "0 | 24 | 20 | 32 | 40 | 4 | 2 | 6 | 8 | 12 | 16 | 48 | 64",
+              "type": "0 | 2 | 24 | 20 | 32 | 40 | 4 | 6 | 8 | 12 | 16 | 48 | 64",
               "required": false,
               "default": "16",
               "description": "The space between items, in pixels on the spacing scale."
@@ -7709,7 +8084,7 @@
             },
             {
               "name": "gap",
-              "type": "0 | 24 | 20 | 32 | 40 | 4 | 2 | 6 | 8 | 12 | 16 | 48 | 64",
+              "type": "0 | 2 | 24 | 20 | 32 | 40 | 4 | 6 | 8 | 12 | 16 | 48 | 64",
               "required": false,
               "default": "16",
               "description": "The space between items, in pixels on the spacing scale."
@@ -7751,7 +8126,7 @@
             },
             {
               "name": "gap",
-              "type": "0 | 24 | 20 | 32 | 40 | 4 | 2 | 6 | 8 | 12 | 16 | 48 | 64",
+              "type": "0 | 2 | 24 | 20 | 32 | 40 | 4 | 6 | 8 | 12 | 16 | 48 | 64",
               "required": false,
               "default": "16",
               "description": "The space between items, in pixels on the spacing scale."
@@ -8484,7 +8859,7 @@
             },
             {
               "name": "headingLevel",
-              "type": "4 | 1 | 2 | 3 | 5 | 6",
+              "type": "2 | 3 | 4 | 1 | 5 | 6",
               "required": false,
               "default": "3",
               "description": "The heading level `#` becomes (3 by default: below a page's and a section's own headings)."
@@ -8555,7 +8930,7 @@
       "components": [
         {
           "name": "ContextMenu",
-          "description": "A dropdown menu: 16px radius, 34px rows, typeahead, Home/End, loops.",
+          "description": "The same menu, opened by a right click, a long press or the context-menu key on the area it wraps.",
           "props": [
             {
               "name": "children",
@@ -8564,6 +8939,27 @@
               "default": null,
               "description": "The area that opens the menu on a right click or long press."
             },
+            {
+              "name": "onOpenChange",
+              "type": "((open: boolean) => void)",
+              "required": false,
+              "default": null,
+              "description": "Called when it opens or closes."
+            }
+          ],
+          "file": "src/components/menu/menu.tsx"
+        },
+        {
+          "name": "Menu",
+          "description": "A dropdown menu: 16px radius, 34px rows, typeahead, Home/End, loops.",
+          "props": [
+            {
+              "name": "children",
+              "type": "ReactNode",
+              "required": true,
+              "default": null,
+              "description": "The trigger and the menu's content."
+            },
             {
               "name": "defaultOpen",
               "type": "boolean",
@@ -8607,17 +9003,32 @@
               "description": "The menus."
             },
             {
-              "name": "onOpenChange",
-              "type": "((o: boolean) => void)",
+              "name": "aria-label",
+              "type": "string",
               "required": false,
               "default": null,
-              "description": "Called when a menu opens or closes."
+              "description": "The accessible name, for when there is no visible label."
+            },
+            {
+              "name": "className",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "Classes for the layout of the outer element: margin, width and placement, never its look."
             }
           ],
           "file": "src/components/menu/menu.tsx"
         }
       ],
       "variants": {
+        "CONTEXT_MENU": {
+          "axes": {},
+          "defaults": {}
+        },
+        "MENUBAR": {
+          "axes": {},
+          "defaults": {}
+        },
         "MENU": {
           "axes": {
             "item": {
@@ -10112,7 +10523,7 @@
             },
             {
               "name": "maxLines",
-              "type": "0 | 4 | 2 | 3 | 6",
+              "type": "0 | 2 | 3 | 4 | 6",
               "required": false,
               "default": "4",
               "description": "Lines shown before \"Show all\" (4 by default; 0 shows everything)."
@@ -10300,6 +10711,10 @@
         }
       ],
       "variants": {
+        "HOVER_CARD": {
+          "axes": {},
+          "defaults": {}
+        },
         "POPOVER": {
           "axes": {
             "padding": {
@@ -10638,6 +11053,90 @@
             }
           ],
           "file": "src/components/radio/radio.tsx"
+        },
+        {
+          "name": "RadioGroup",
+          "description": "The group a set of radios belongs to: one of them is chosen, and the arrow keys move between them.",
+          "props": [
+            {
+              "name": "children",
+              "type": "ReactNode",
+              "required": true,
+              "default": null,
+              "description": "The radios, one per option."
+            },
+            {
+              "name": "aria-label",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The accessible name, for when there is no visible label."
+            },
+            {
+              "name": "aria-labelledby",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The id of the element that names it, when its label is elsewhere on the page."
+            },
+            {
+              "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": "defaultValue",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The chosen option on first render."
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "required": false,
+              "default": null,
+              "description": "Turns off every radio."
+            },
+            {
+              "name": "name",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The field name the value is sent under in a form."
+            },
+            {
+              "name": "onValueChange",
+              "type": "((value: string) => void)",
+              "required": false,
+              "default": null,
+              "description": "Called with the chosen option."
+            },
+            {
+              "name": "orientation",
+              "type": "\"horizontal\" | \"vertical\"",
+              "required": false,
+              "default": "vertical",
+              "description": "Lays the items out in a row (`horizontal`) or a column (`vertical`)."
+            },
+            {
+              "name": "value",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "The chosen option, when you control it."
+            },
+            {
+              "name": "variant",
+              "type": "\"default\" | \"cards\"",
+              "required": false,
+              "default": "default",
+              "description": "A plain list of radios, or rows inside a settings group with the radio at the end (`cards`)."
+            }
+          ],
+          "file": "src/components/radio/radio.tsx"
         }
       ],
       "variants": {
@@ -11553,6 +12052,10 @@
           "defaults": {
             "row": "default"
           }
+        },
+        "SETTINGS_SECTION": {
+          "axes": {},
+          "defaults": {}
         }
       }
     },
@@ -12593,6 +13096,17 @@
         }
       ],
       "variants": {
+        "PILL_TABS": {
+          "axes": {
+            "variant": {
+              "underline": "Underline tabs for detail pages: 40px, a 2px ink indicator that slides",
+              "pill": "Header tabs: separate 32px pills, the active one filled"
+            }
+          },
+          "defaults": {
+            "variant": "pill"
+          }
+        },
         "TABS": {
           "axes": {
             "variant": {
@@ -12976,6 +13490,27 @@
           "name": "ThemeMenu",
           "description": "System, light or dark, stored as `kaeso:theme`.",
           "props": [
+            {
+              "name": "align",
+              "type": "\"start\" | \"end\"",
+              "required": false,
+              "default": "end",
+              "description": "Which edge of the button the menu lines up with: its end (`end`) or its start (`start`), for a button at the left edge."
+            },
+            {
+              "name": "data-force",
+              "type": "string",
+              "required": false,
+              "default": null,
+              "description": "Forces an interaction state for state matrices: `hover`, `pressed`, `focus`, `open`."
+            },
+            {
+              "name": "side",
+              "type": "\"top\" | \"bottom\"",
+              "required": false,
+              "default": "bottom",
+              "description": "Where the menu opens: below the button (`bottom`), or above it (`top`) when the button sits at the foot of a sidebar."
+            },
             {
               "name": "size",
               "type": "\"md\" | \"sm\"",
@@ -13075,6 +13610,62 @@
         }
       }
     },
+    {
+      "entry": "thumbnail",
+      "kind": "components",
+      "import": "@logicplanes/kaeso-ui/thumbnail",
+      "components": [
+        {
+          "name": "Thumbnail",
+          "description": "A square image someone sent, such as a photo in a conversation: cropped to fill, on a well with radius 14; when it can't load, its text alternative shows instead.",
+          "props": [
+            {
+              "name": "alt",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "What the image shows, read by screen readers and shown in its place when it can't load."
+            },
+            {
+              "name": "src",
+              "type": "string",
+              "required": true,
+              "default": null,
+              "description": "The image's address, including a data: URL."
+            },
+            {
+              "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": "size",
+              "type": "\"md\" | \"sm\" | \"lg\"",
+              "required": false,
+              "default": "md",
+              "description": "The width and height: 64, 120 or 160 pixels."
+            }
+          ],
+          "file": "src/components/thumbnail/thumbnail.tsx"
+        }
+      ],
+      "variants": {
+        "THUMBNAIL": {
+          "axes": {
+            "size": {
+              "sm": "64px: a row or a compact list",
+              "md": "120px: an image inside a message (default)",
+              "lg": "160px: an image a page is about"
+            }
+          },
+          "defaults": {
+            "size": "md"
+          }
+        }
+      }
+    },
     {
       "entry": "timeline",
       "kind": "components",
@@ -13132,14 +13723,14 @@
               "name": "limit",
               "type": "number",
               "required": false,
-              "default": null,
+              "default": "3",
               "description": "How many toasts show at once."
             },
             {
               "name": "timeout",
               "type": "number",
               "required": false,
-              "default": null,
+              "default": "5000",
               "description": "How long a toast stays, in milliseconds."
             }
           ],
@@ -13392,7 +13983,7 @@
               "name": "shape",
               "type": "\"pill\" | \"multiline\"",
               "required": false,
-              "default": null,
+              "default": "pill",
               "description": "A pill for a short label, or a box for several lines."
             },
             {