@sakaniui/react 0.12.0 → 0.14.0

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 6,
   "name": "@sakaniui/react",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Machine-readable contract of the SakaniUI React library, generated from its TypeScript source.",
   "docs": "https://www.sakaniui.com",
   "guide": "https://www.sakaniui.com/llms-full.txt",
@@ -24,7 +24,7 @@
     "@sakaniui/react/emoji": "Fluent Emoji (full colour): EmojiName, one module each (1594 emoji, 311 with skin tones)."
   },
   "conventions": {
-    "version": "This manifest describes @sakaniui/react@0.12.0. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
+    "version": "This manifest describes @sakaniui/react@0.14.0. Each component has `since`, the first release that contained it; a prop added later has its own `since`, and a value added later is listed in the prop's `valuesSince`. If the project has an older version installed, anything newer than that does not exist there.",
     "acceptsNativeProps": "Components forward native HTML attributes (className, style, aria-*, event handlers) to their root element unless a prop says otherwise; only the props that are specific to SakaniUI are listed here.",
     "accessibleName": "When `contract.requiresAccessibleName` is true, a required prop (aria-label, aria-labelledby or an alt text) is the only thing that names the control or image. Do not omit it.",
     "tokens": "Use only the token names listed under `tokens`. Colour tokens follow the theme (the `.dark` class flips them); do not hard-code colours.",
@@ -195,7 +195,7 @@
     "wrap"
   ],
   "tokens": {
-    "count": 231,
+    "count": 235,
     "groups": {
       "bp": {
         "--bp-sm": "640px",
@@ -281,6 +281,8 @@
         "--color-chart-purple": "#9179D6",
         "--color-chart-gold": "#DCA84F",
         "--color-chart-green": "#12B76A",
+        "--color-blue-700": "#33619F",
+        "--color-violet-500": "#9179D6",
         "--color-code-keyword": "#7B4BD9",
         "--color-code-string": "#16A34A",
         "--color-bg-canvas": "var(--color-neutral-50)",
@@ -341,7 +343,9 @@
         "--space-16": "16px",
         "--space-20": "20px",
         "--space-24": "24px",
+        "--space-28": "28px",
         "--space-32": "32px",
+        "--space-36": "36px",
         "--space-40": "40px",
         "--space-48": "48px",
         "--space-64": "64px",
@@ -459,7 +463,7 @@
     }
   },
   "counts": {
-    "components": 139,
+    "components": 142,
     "blocks": 42,
     "utilities": 10
   },
@@ -2220,7 +2224,6 @@
             "done",
             "working"
           ],
-          "default": "done",
           "description": "Adds the working line under the steps: \"working\" (sparkle, shimmer) or \"done\" (\"Worked for 11.2s\")."
         },
         {
@@ -2324,7 +2327,8 @@
           "name": "accent",
           "type": "string",
           "required": false,
-          "description": "Colour of the spark that runs into the step while it is active. Defaults to the icon's brand colour when it is a logo from `sourceLogo()`."
+          "description": "Colour of the spark that runs into the step while it is active. Defaults to the icon's brand colour when it is a logo from `sourceLogo()`.",
+          "since": "0.13.0"
         },
         {
           "name": "sources",
@@ -2750,6 +2754,579 @@
         "tag input"
       ]
     },
+    {
+      "name": "CommandMenu",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "A ⌘K search and command palette: a field, scope tabs, grouped results (the matched letters in the strong weight), a footer of key hints, and loading, no-results and error states. Pass `groups` of `items` and handle `onSelect`; it filters as you type unless `filter={false}`. ⌘K opens it, ↑ ↓ move, ↵ chooses, ⌘↵ asks AI (with `onAskAI`), Tab switches scope, esc clears then closes. `variant=\"simple\"` is just the field, one group and the key hints.",
+      "props": [
+        {
+          "name": "open",
+          "type": "boolean",
+          "required": false,
+          "description": "Controlled open state."
+        },
+        {
+          "name": "defaultOpen",
+          "type": "boolean",
+          "required": false,
+          "default": false,
+          "description": "Initial open state when uncontrolled."
+        },
+        {
+          "name": "onOpenChange",
+          "type": "((open: boolean) => void)",
+          "required": false
+        },
+        {
+          "name": "hotkey",
+          "type": "string | false",
+          "required": false,
+          "default": "k",
+          "description": "The key that opens it with ⌘ / Ctrl. `false` turns the shortcut off. Defaults to \"k\"."
+        },
+        {
+          "name": "variant",
+          "type": "\"default\" | \"simple\"",
+          "required": false,
+          "values": [
+            "default",
+            "simple"
+          ],
+          "default": "default",
+          "description": "\"default\" has scopes and a workspace footer; \"simple\" is just the field, the rows and the key hints."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "required": false,
+          "description": "The field's text (controlled)."
+        },
+        {
+          "name": "defaultQuery",
+          "type": "string",
+          "required": false,
+          "default": ""
+        },
+        {
+          "name": "onQueryChange",
+          "type": "((query: string) => void)",
+          "required": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "required": false,
+          "default": "Search or ask anything…"
+        },
+        {
+          "name": "groups",
+          "type": "CommandMenuGroup[]",
+          "required": true,
+          "description": "Results, in groups.",
+          "shape": {
+            "type": "CommandMenuGroup",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": false,
+                "description": "The small heading above the items."
+              },
+              {
+                "name": "action",
+                "type": "{ label: string; onClick: () => void; }",
+                "required": false,
+                "description": "A link on the right of the heading, e.g. \"See all\"."
+              },
+              {
+                "name": "items",
+                "type": "CommandMenuItem[]",
+                "required": true
+              }
+            ]
+          }
+        },
+        {
+          "name": "filter",
+          "type": "boolean | ((item: CommandMenuItem, query: string) => boolean)",
+          "required": false,
+          "default": true,
+          "description": "Filter the groups by the query, scope and tokens here. Pass a function to match your own way, or `false` to show `groups` as given. Defaults to true."
+        },
+        {
+          "name": "highlightMatches",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Wrap the matched letters of each label in the strong weight. Defaults to true."
+        },
+        {
+          "name": "state",
+          "type": "\"loading\" | \"ready\" | \"error\"",
+          "required": false,
+          "values": [
+            "loading",
+            "ready",
+            "error"
+          ],
+          "default": "ready",
+          "description": "\"loading\" shows skeleton rows, \"error\" the error message."
+        },
+        {
+          "name": "onSelect",
+          "type": "((item: CommandMenuItem) => void)",
+          "required": false,
+          "description": "Called when an item is chosen (click or ↵)."
+        },
+        {
+          "name": "closeOnSelect",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "Close the menu when an item is chosen. Defaults to true."
+        },
+        {
+          "name": "scopes",
+          "type": "CommandMenuScope[]",
+          "required": false,
+          "description": "Scope tabs under the field (not shown in the simple variant).",
+          "shape": {
+            "type": "CommandMenuScope",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "value",
+                "type": "string",
+                "required": true,
+                "description": "\"all\" is the unfiltered scope."
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "count",
+                "type": "number | null",
+                "required": false,
+                "description": "The count shown on the tab. Computed from the items when you leave it out (and `filter` is on); `null` shows no count."
+              }
+            ]
+          }
+        },
+        {
+          "name": "scope",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "defaultScope",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "onScopeChange",
+          "type": "((scope: string) => void)",
+          "required": false
+        },
+        {
+          "name": "filters",
+          "type": "CommandMenuFilter[]",
+          "required": false,
+          "description": "Filter tokens shown in the field.",
+          "shape": {
+            "type": "CommandMenuFilter",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": true,
+                "description": "Shown in the token, e.g. \"People\" or \"team: Design\"."
+              },
+              {
+                "name": "value",
+                "type": "string",
+                "required": false,
+                "description": "What `tags` are matched against. Defaults to the label."
+              },
+              {
+                "name": "icon",
+                "type": "IconComponent",
+                "required": false
+              }
+            ]
+          }
+        },
+        {
+          "name": "onFiltersChange",
+          "type": "((filters: CommandMenuFilter[]) => void)",
+          "required": false
+        },
+        {
+          "name": "filterKeys",
+          "type": "string[]",
+          "required": false,
+          "description": "Typing `key:value` and a space turns it into a token for these keys, e.g. [\"team\", \"status\"]."
+        },
+        {
+          "name": "onAskAI",
+          "type": "((query: string) => void)",
+          "required": false,
+          "description": "Adds ⌘↵ and the \"Ask AI\" hint; called with the current query."
+        },
+        {
+          "name": "answer",
+          "type": "ReactNode",
+          "required": false,
+          "description": "Shown above the results (an answer card, a Chain of Thought)."
+        },
+        {
+          "name": "renderPreview",
+          "type": "((item: CommandMenuItem) => ReactNode)",
+          "required": false,
+          "description": "Shows a preview pane beside the list for the active item. Return null for no pane."
+        },
+        {
+          "name": "previewActions",
+          "type": "ReactNode | ((item: CommandMenuItem) => ReactNode)",
+          "required": false,
+          "description": "Buttons or links pinned to the bottom of the detail pane. They stay put while the content above changes from row to row (only `renderPreview`'s content cross-fades); pass a function to read the previewed row. Hidden when a row has no preview.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "previewEmpty",
+          "type": "ReactNode",
+          "required": false,
+          "default": "Nothing to preview for this result",
+          "description": "Shown in the detail pane when the active row has nothing to preview (`renderPreview` returned nothing).",
+          "since": "0.14.0"
+        },
+        {
+          "name": "emptyTitle",
+          "type": "ReactNode",
+          "required": false,
+          "description": "The \"No results\" message."
+        },
+        {
+          "name": "emptyDescription",
+          "type": "ReactNode",
+          "required": false
+        },
+        {
+          "name": "suggestions",
+          "type": "CommandMenuSuggestion[]",
+          "required": false,
+          "description": "Quick fixes under the empty message, e.g. \"Did you mean invoice?\".",
+          "shape": {
+            "type": "CommandMenuSuggestion",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "IconComponent",
+                "required": false
+              },
+              {
+                "name": "iconPosition",
+                "type": "\"start\" | \"end\"",
+                "required": false,
+                "description": "Where the icon sits: before the label (default) or after it (e.g. the × on \"Remove the Files filter\")."
+              },
+              {
+                "name": "emphasis",
+                "type": "string",
+                "required": false,
+                "description": "A word inside `label` to set in the strong weight (\"invoice\" in \"Did you mean invoice?\")."
+              },
+              {
+                "name": "onSelect",
+                "type": "() => void",
+                "required": true
+              }
+            ]
+          }
+        },
+        {
+          "name": "fallbackGroups",
+          "type": "CommandMenuGroup[]",
+          "required": false,
+          "description": "Shown under the empty or error message, and navigable like any group (e.g. \"Try instead\").",
+          "shape": {
+            "type": "CommandMenuGroup",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "id",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "label",
+                "type": "string",
+                "required": false,
+                "description": "The small heading above the items."
+              },
+              {
+                "name": "action",
+                "type": "{ label: string; onClick: () => void; }",
+                "required": false,
+                "description": "A link on the right of the heading, e.g. \"See all\"."
+              },
+              {
+                "name": "items",
+                "type": "CommandMenuItem[]",
+                "required": true
+              }
+            ]
+          }
+        },
+        {
+          "name": "errorTitle",
+          "type": "ReactNode",
+          "required": false,
+          "default": "Search is unavailable"
+        },
+        {
+          "name": "errorDescription",
+          "type": "ReactNode",
+          "required": false
+        },
+        {
+          "name": "onRetry",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "onReport",
+          "type": "(() => void)",
+          "required": false,
+          "description": "A second, quieter action beside \"Try again\" in the error state (\"Report\").",
+          "since": "0.14.0"
+        },
+        {
+          "name": "retryLabel",
+          "type": "ReactNode",
+          "required": false,
+          "default": "Try again",
+          "since": "0.14.0"
+        },
+        {
+          "name": "reportLabel",
+          "type": "ReactNode",
+          "required": false,
+          "default": "Report",
+          "since": "0.14.0"
+        },
+        {
+          "name": "workspace",
+          "type": "ReactNode",
+          "required": false,
+          "description": "The workspace switcher in the footer (default variant)."
+        },
+        {
+          "name": "hideFooter",
+          "type": "boolean",
+          "required": false,
+          "default": false,
+          "description": "Hide the footer of key hints."
+        },
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "default": "Command menu",
+          "description": "Accessible name of the dialog. Defaults to \"Command menu\"."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "groups"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.13.0",
+      "example": "import { CommandMenu } from '@sakaniui/react';\n\n<CommandMenu groups={[{ id: \"item-1\", items: [{ id: \"item-1\", label: \"Label\" }] }]} />",
+      "recipes": [
+        {
+          "title": "A ⌘K search over your pages, people and actions",
+          "description": "CommandMenu is controlled by you for what it shows and what happens: pass `groups` of `items`, handle `onSelect`, and give the menu `scopes` for the tabs. It opens on ⌘K by itself (`open` / `onOpenChange` to control it) and filters as you type. For results from a server pass `filter={false}`, set `state=\"loading\"` while you wait, and render the groups you got back. Put a `CommandMenuTrigger` in your top bar. Give every item a `label`; add `shortcut` for key hints and `description` or `meta` for context.",
+          "code": "import React from 'react';\nimport { CommandMenu, CommandMenuTrigger } from '@sakaniui/react';\nimport { IconSettings, IconPlus } from '@sakaniui/react/icons';\n\nconst GROUPS = [\n  {\n    id: 'pages', label: 'Pages',\n    items: [{ id: 'settings', type: 'page' as const, label: 'Settings', description: 'Workspace', icon: IconSettings }],\n  },\n  {\n    id: 'actions', label: 'Actions',\n    items: [{ id: 'new', type: 'action' as const, label: 'Create project', icon: IconPlus, shortcut: ['⌘', 'N'] }],\n  },\n];\n\nexport const Example = () => {\n  const [open, setOpen] = React.useState(false);\n  return (\n    <>\n      <CommandMenuTrigger onClick={() => setOpen(true)} />\n      <CommandMenu\n        open={open}\n        onOpenChange={setOpen}\n        groups={GROUPS}\n        scopes={[{ value: 'all', label: 'All' }, { value: 'pages', label: 'Pages' }, { value: 'actions', label: 'Actions' }]}\n        onSelect={(item) => console.log(item.id)}\n      />\n    </>\n  );\n};"
+        }
+      ],
+      "aliases": [
+        "command palette",
+        "command bar",
+        "cmd k",
+        "cmdk",
+        "search modal",
+        "global search",
+        "spotlight",
+        "quick actions",
+        "omnibar",
+        "search palette",
+        "advanced search",
+        "quick switcher",
+        "command k"
+      ]
+    },
+    {
+      "name": "CommandMenuAnswer",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "An answer card for the CommandMenu's Ask AI state: the answer text, its sources as chips, and a follow-up. Pass it as the menu's `answer`.",
+      "props": [
+        {
+          "name": "title",
+          "type": "string",
+          "required": false,
+          "default": "SakaniUI AI"
+        },
+        {
+          "name": "status",
+          "type": "string",
+          "required": false,
+          "description": "e.g. \"Thought for 2.4s\". With `stream` it appears once the text has been written."
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": true,
+          "description": "The answer text."
+        },
+        {
+          "name": "stream",
+          "type": "boolean",
+          "required": false,
+          "description": "Writes the answer in word by word, the way a chat reply arrives, and brings in the sources and the follow-up once it is written. Needs `children` to be a plain string; reduced motion shows it at once.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "onStreamEnd",
+          "type": "(() => void)",
+          "required": false,
+          "description": "Called once when the text has been written (or at once when it is not streamed).",
+          "since": "0.14.0"
+        },
+        {
+          "name": "sources",
+          "type": "{ label: string; icon?: IconComponent; }[]",
+          "required": false,
+          "description": "Sources as chips under the answer.",
+          "shape": {
+            "type": "{ label: string; icon?: IconComponent | undefined; }",
+            "collection": "array",
+            "fields": [
+              {
+                "name": "label",
+                "type": "string",
+                "required": true
+              },
+              {
+                "name": "icon",
+                "type": "IconComponent",
+                "required": false
+              }
+            ]
+          }
+        },
+        {
+          "name": "onFollowUp",
+          "type": "(() => void)",
+          "required": false,
+          "description": "Adds an \"Ask a follow-up\" button."
+        },
+        {
+          "name": "onOpenInChat",
+          "type": "(() => void)",
+          "required": false,
+          "description": "Adds an \"Open in chat\" hint with ⌘↵."
+        },
+        {
+          "name": "onCopy",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "children"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.13.0",
+      "example": "import { CommandMenuAnswer } from '@sakaniui/react';\n\n<CommandMenuAnswer>Label</CommandMenuAnswer>",
+      "aliases": [
+        "ai answer",
+        "answer card",
+        "search answer"
+      ]
+    },
+    {
+      "name": "CommandMenuTrigger",
+      "kind": "component",
+      "category": "Composite",
+      "import": "@sakaniui/react",
+      "summary": "The ⌘K pill that opens a CommandMenu, for a top bar or sidebar. A button: give it `onClick`.",
+      "props": [
+        {
+          "name": "placeholder",
+          "type": "string",
+          "required": false,
+          "default": "Search or ask anything…",
+          "description": "The text in the pill. Defaults to \"Search or jump to…\"."
+        },
+        {
+          "name": "shortcut",
+          "type": "string[]",
+          "required": false,
+          "default": "['⌘', 'K']",
+          "description": "The key caps on the right. Defaults to [\"⌘\", \"K\"]."
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.13.0",
+      "example": "import { CommandMenuTrigger } from '@sakaniui/react';\n\n<CommandMenuTrigger />",
+      "aliases": [
+        "search button",
+        "cmd k trigger",
+        "search pill",
+        "search trigger",
+        "command trigger"
+      ]
+    },
     {
       "name": "ConversationItem",
       "kind": "component",
@@ -2943,12 +3520,12 @@
       "props": [
         {
           "name": "type",
-          "type": "\"no-data\" | \"no-results\" | \"error\"",
+          "type": "\"error\" | \"no-data\" | \"no-results\"",
           "required": false,
           "values": [
+            "error",
             "no-data",
-            "no-results",
-            "error"
+            "no-results"
           ],
           "default": "no-data"
         },
@@ -3651,6 +4228,45 @@
           "name": "trailingIcon",
           "type": "ReactNode",
           "required": false
+        },
+        {
+          "name": "variant",
+          "type": "\"default\" | \"ai\"",
+          "required": false,
+          "values": [
+            "default",
+            "ai"
+          ],
+          "default": "default",
+          "description": "\"ai\" is the prompt box of an AI product: a pill with a 16px field, action slots and a light around the border. Defaults to \"default\".",
+          "since": "0.14.0"
+        },
+        {
+          "name": "glow",
+          "type": "\"off\" | \"pulse\" | \"focus\"",
+          "required": false,
+          "values": [
+            "off",
+            "pulse",
+            "focus"
+          ],
+          "default": "pulse",
+          "description": "variant=\"ai\": the light that sweeps clockwise around the border. \"pulse\" (default) sweeps every 2.5s while idle and once each time the field takes focus; \"focus\" sweeps only on focus; \"off\" draws none. Reduced motion draws none.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "leading",
+          "type": "ReactNode",
+          "required": false,
+          "description": "variant=\"ai\": actions before the field, such as an attach button. Interactive content is fine here (unlike `leadingIcon`).",
+          "since": "0.14.0"
+        },
+        {
+          "name": "trailing",
+          "type": "ReactNode",
+          "required": false,
+          "description": "variant=\"ai\": actions after the field, such as a mic and a send button.",
+          "since": "0.14.0"
         }
       ],
       "contract": {
@@ -4434,13 +5050,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15310",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15340",
+                "name": "__@unscopables@15667",
                 "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
                 "required": true,
                 "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
@@ -5016,13 +5632,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15310",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15340",
+                "name": "__@unscopables@15667",
                 "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
                 "required": true,
                 "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
@@ -5406,13 +6022,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15310",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15340",
+                "name": "__@unscopables@15667",
                 "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
                 "required": true,
                 "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
@@ -5713,13 +6329,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15310",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15340",
+                "name": "__@unscopables@15667",
                 "type": "{ [x: number]: boolean | undefined; length?: boolean | undefined; toString?: boolean | undefined; toLocaleString?: boolean | undefined; pop?: boolean | undefined; push?: boolean | undefined; concat?: boolean | undefined; join?: boolean | undefined; reverse?: boolean | undefined; shift?: boolean | undefined; slice?: boolean | undefined; sort?: boolean | undefined; splice?: boolean | undefined; unshift?: boolean | undefined; indexOf?: boolean | undefined; lastIndexOf?: boolean | undefined; every?: boolean | undefined; some?: boolean | undefined; forEach?: boolean | undefined; map?: boolean | undefined; filter?: boolean | undefined; reduce?: boolean | undefined; reduceRight?: boolean | undefined; find?: boolean | undefined; findIndex?: boolean | undefined; fill?: boolean | undefined; copyWithin?: boolean | undefined; entries?: boolean | undefined; keys?: boolean | undefined; values?: boolean | undefined; includes?: boolean | undefined; flatMap?: boolean | undefined; flat?: boolean | undefined; at?: boolean | undefined; [Symbol.iterator]?: boolean | undefined; readonly [Symbol.unscopables]?: boolean | undefined; }",
                 "required": true,
                 "description": "Is an object whose properties have the value 'true' when they will be absent when used in a 'with' statement."
@@ -8293,7 +8909,7 @@
         ],
         "requiresAccessibleName": false
       },
-      "since": "0.12.0",
+      "since": "0.13.0",
       "example": "import { SourceLogo } from '@sakaniui/react';\n\n<SourceLogo name=\"x\" />",
       "aliases": [
         "brand logo",
@@ -9387,6 +10003,53 @@
           "name": "error",
           "type": "string",
           "required": false
+        },
+        {
+          "name": "variant",
+          "type": "\"default\" | \"ai\"",
+          "required": false,
+          "values": [
+            "default",
+            "ai"
+          ],
+          "default": "default",
+          "description": "\"ai\" is the prompt box of an AI product: a 16px-radius box, a 16px field that grows with the text, an actions row and a light around the border. Defaults to \"default\".",
+          "since": "0.14.0"
+        },
+        {
+          "name": "glow",
+          "type": "\"off\" | \"pulse\" | \"focus\"",
+          "required": false,
+          "values": [
+            "off",
+            "pulse",
+            "focus"
+          ],
+          "default": "pulse",
+          "description": "variant=\"ai\": the light that sweeps clockwise around the border. \"pulse\" (default) sweeps every 2.5s while idle and once each time the field takes focus; \"focus\" sweeps only on focus; \"off\" draws none. Reduced motion draws none.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "leading",
+          "type": "ReactNode",
+          "required": false,
+          "description": "variant=\"ai\": actions on the left of the row under the field, such as an attach button.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "trailing",
+          "type": "ReactNode",
+          "required": false,
+          "description": "variant=\"ai\": actions on the right of that row, such as a mic and a send button.",
+          "since": "0.14.0"
+        },
+        {
+          "name": "maxRows",
+          "type": "number",
+          "required": false,
+          "default": 8,
+          "description": "variant=\"ai\": the most lines the field grows to before it scrolls. Defaults to 8.",
+          "since": "0.14.0"
         }
       ],
       "contract": {
@@ -10034,7 +10697,7 @@
             "done",
             "working"
           ],
-          "default": "done",
+          "default": "working",
           "description": "\"working\" shows a sparkle and a shimmering label; \"done\" shows a check. Defaults to \"working\"."
         },
         {
@@ -13156,12 +13819,14 @@
     {
       "name": "sourceLogo",
       "kind": "helper",
-      "import": "@sakaniui/react"
+      "import": "@sakaniui/react",
+      "since": "0.13.0"
     },
     {
       "name": "sourceLogoNames",
       "kind": "helper",
-      "import": "@sakaniui/react"
+      "import": "@sakaniui/react",
+      "since": "0.13.0"
     },
     {
       "name": "syncLiquidBackdrop",