@sakaniui/react 0.14.2 → 0.15.0

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 6,
   "name": "@sakaniui/react",
-  "version": "0.14.2",
+  "version": "0.15.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.14.2. 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.15.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": 235,
+    "count": 243,
     "groups": {
       "bp": {
         "--bp-sm": "640px",
@@ -405,6 +405,16 @@
         "--transition-slow": "var(--motion-slow) var(--ease-in-out)",
         "--transition-hover": "var(--motion-slow) var(--ease-out)"
       },
+      "ai": {
+        "--ai-ember-0": "var(--color-blue-700)",
+        "--ai-ember-1": "var(--color-violet-500)",
+        "--ai-ember-2": "color-mix(in srgb, var(--color-danger-500) 55%, var(--color-violet-500))",
+        "--ai-ember-3": "var(--color-danger-500)",
+        "--ai-ember-4": "var(--color-primary-500)",
+        "--ai-ember-5": "var(--color-warning-500)",
+        "--ai-ember-6": "var(--color-warning-300)",
+        "--ai-ember-gradient": "linear-gradient(90deg, var(--ai-ember-0), var(--ai-ember-1), var(--ai-ember-2), var(--ai-ember-3), var(--ai-ember-4), var(--ai-ember-5), var(--ai-ember-6))"
+      },
       "glass": {
         "--glass-bg": "rgba(255, 255, 255, 0.64)",
         "--glass-bg-overlay": "rgba(255, 255, 255, 0.76)",
@@ -463,8 +473,8 @@
     }
   },
   "counts": {
-    "components": 142,
-    "blocks": 42,
+    "components": 150,
+    "blocks": 44,
     "utilities": 10
   },
   "components": [
@@ -631,6 +641,81 @@
       "since": "0.1.0",
       "example": "import { ActivityFeedHighlight } from '@sakaniui/react';\n\n<ActivityFeedHighlight>Label</ActivityFeedHighlight>"
     },
+    {
+      "name": "AiMessage",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "One turn of an AI conversation.",
+      "props": [
+        {
+          "name": "role",
+          "type": "\"assistant\" | \"user\"",
+          "required": false,
+          "values": [
+            "assistant",
+            "user"
+          ],
+          "default": "assistant"
+        },
+        {
+          "name": "streaming",
+          "type": "boolean",
+          "required": false,
+          "description": "Assistant only: the reply is still arriving."
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "description": "The text."
+        },
+        {
+          "name": "actions",
+          "type": "ReactNode",
+          "required": false,
+          "default": true,
+          "description": "Assistant only. `false` leaves the row out; a node replaces it. Default: the four built-in actions."
+        },
+        {
+          "name": "onCopy",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "onRegenerate",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "onFeedback",
+          "type": "((value: \"up\" | \"down\") => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { AiMessage } from '@sakaniui/react';\n\n<AiMessage />",
+      "aliases": [
+        "ai chat message",
+        "chat message",
+        "assistant message",
+        "user message",
+        "chatgpt message",
+        "llm reply",
+        "ai reply",
+        "message actions",
+        "copy regenerate feedback"
+      ]
+    },
     {
       "name": "Alert",
       "kind": "component",
@@ -838,6 +923,78 @@
       "since": "0.1.0",
       "example": "import { AreaChart } from '@sakaniui/react';\n\n<AreaChart data={[{ label: \"Label\", value: 50 }]} />"
     },
+    {
+      "name": "AttachmentChip",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "A file or image attached to a prompt.",
+      "props": [
+        {
+          "name": "type",
+          "type": "\"file\" | \"image\" | \"uploading\" | \"error\"",
+          "required": false,
+          "values": [
+            "file",
+            "image",
+            "uploading",
+            "error"
+          ],
+          "default": "file"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "meta",
+          "type": "string",
+          "required": false,
+          "description": "The second line: \"PDF · 2.4 MB\". Uploading and error replace it with their own text unless you pass one."
+        },
+        {
+          "name": "preview",
+          "type": "string",
+          "required": false,
+          "description": "Image thumbnail URL (type=\"image\")."
+        },
+        {
+          "name": "progress",
+          "type": "number",
+          "required": false,
+          "default": 0,
+          "description": "0-100 (type=\"uploading\")."
+        },
+        {
+          "name": "onRemove",
+          "type": "(() => void)",
+          "required": false,
+          "description": "Shows the x."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "name"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { AttachmentChip } from '@sakaniui/react';\n\n<AttachmentChip name=\"Name\" />",
+      "aliases": [
+        "file chip",
+        "attached file",
+        "upload chip",
+        "file attachment",
+        "image attachment",
+        "upload progress chip"
+      ]
+    },
     {
       "name": "Avatar",
       "kind": "component",
@@ -2268,7 +2425,6 @@
       "aliases": [
         "thought chain",
         "reasoning steps",
-        "reasoning trace",
         "agent steps",
         "agent activity",
         "agent trace",
@@ -2367,7 +2523,6 @@
         "reasoning step",
         "thought step",
         "agent step",
-        "tool call",
         "search step",
         "task step"
       ]
@@ -2381,13 +2536,13 @@
       "props": [
         {
           "name": "state",
-          "type": "\"default\" | \"disabled\" | \"typing\" | \"uploading\"",
+          "type": "\"default\" | \"uploading\" | \"disabled\" | \"typing\"",
           "required": false,
           "values": [
             "default",
+            "uploading",
             "disabled",
-            "typing",
-            "uploading"
+            "typing"
           ],
           "default": "default"
         },
@@ -2447,6 +2602,79 @@
         "composer"
       ]
     },
+    {
+      "name": "ChatOrb",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "The AI's face: a soft white sphere with two black eyes. It is the assistant avatar in AiMessage and can stand alone as a chat launcher or greeter.",
+      "props": [
+        {
+          "name": "size",
+          "type": "number",
+          "required": false,
+          "default": 28,
+          "description": "Diameter in px. Default 28 (the AiMessage avatar)."
+        },
+        {
+          "name": "look",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "The eyes follow the pointer. Default true."
+        },
+        {
+          "name": "blink",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "The eyes blink now and then. Default true."
+        },
+        {
+          "name": "thinking",
+          "type": "boolean",
+          "required": false,
+          "default": false,
+          "description": "The AI is thinking: the eyes sweep side to side instead of following the pointer."
+        },
+        {
+          "name": "glance",
+          "type": "boolean",
+          "required": false,
+          "default": false,
+          "description": "The response has arrived: glance toward the text (to the right) for 1.4s, then look straight. Fires each time it turns true."
+        },
+        {
+          "name": "squintOnHover",
+          "type": "boolean",
+          "required": false,
+          "default": true,
+          "description": "The eyes squint while the pointer is over the orb. Default true."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "required": false,
+          "description": "Accessible name. Omit for a decorative orb."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "style",
+          "type": "CSSProperties",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { ChatOrb } from '@sakaniui/react';\n\n<ChatOrb />"
+    },
     {
       "name": "Checkbox",
       "kind": "component",
@@ -2870,12 +3098,12 @@
         },
         {
           "name": "state",
-          "type": "\"loading\" | \"ready\" | \"error\"",
+          "type": "\"error\" | \"loading\" | \"ready\"",
           "required": false,
           "values": [
+            "error",
             "loading",
-            "ready",
-            "error"
+            "ready"
           ],
           "default": "ready",
           "description": "\"loading\" shows skeleton rows, \"error\" the error message."
@@ -4243,15 +4471,16 @@
         },
         {
           "name": "glow",
-          "type": "\"off\" | \"pulse\" | \"focus\"",
+          "type": "\"off\" | \"once\" | \"pulse\" | \"focus\"",
           "required": false,
           "values": [
             "off",
+            "once",
             "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.",
+          "default": "once",
+          "description": "variant=\"ai\": the light that sweeps clockwise around the border. \"once\" (default) sweeps one lap shortly after it appears and then stays still, focused or not; \"pulse\" 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"
         },
         {
@@ -4694,8 +4923,7 @@
             "ignore"
           ],
           "default": "respect",
-          "description": "'respect' (default): with prefers-reduced-transparency the glass becomes a plain opaque surface. 'ignore': keep the full glass anyway. Only for a decorative showcase that means nothing without it; never for a surface that holds the user's content.",
-          "since": "0.14.2"
+          "description": "'respect' (default): with prefers-reduced-transparency the glass becomes a plain opaque surface. 'ignore': keep the full glass anyway. Only for a decorative showcase that means nothing without it; never for a surface that holds the user's content."
         }
       ],
       "contract": {
@@ -5062,13 +5290,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15641",
+                "name": "__@iterator@16335",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15671",
+                "name": "__@unscopables@16365",
                 "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."
@@ -5644,13 +5872,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15641",
+                "name": "__@iterator@16335",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15671",
+                "name": "__@unscopables@16365",
                 "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."
@@ -6034,13 +6262,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15641",
+                "name": "__@iterator@16335",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15671",
+                "name": "__@unscopables@16365",
                 "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."
@@ -6341,13 +6569,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15641",
+                "name": "__@iterator@16335",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15671",
+                "name": "__@unscopables@16365",
                 "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."
@@ -6581,12 +6809,12 @@
         },
         {
           "name": "content",
-          "type": "\"text\" | \"file\" | \"image\"",
+          "type": "\"file\" | \"image\" | \"text\"",
           "required": false,
           "values": [
-            "text",
             "file",
-            "image"
+            "image",
+            "text"
           ],
           "default": "text"
         },
@@ -7739,6 +7967,143 @@
       "since": "0.1.0",
       "example": "import { ProgressStat } from '@sakaniui/react';\n\n<ProgressStat label=\"Label\" value=\"Value\" progress={50} />"
     },
+    {
+      "name": "PromptComposer",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "The prompt box of an AI product.",
+      "props": [
+        {
+          "name": "value",
+          "type": "string",
+          "required": false
+        },
+        {
+          "name": "defaultValue",
+          "type": "string",
+          "required": false,
+          "default": ""
+        },
+        {
+          "name": "onValueChange",
+          "type": "((value: string) => void)",
+          "required": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "required": false,
+          "default": "Ask anything, or type / for skills"
+        },
+        {
+          "name": "status",
+          "type": "\"idle\" | \"streaming\"",
+          "required": false,
+          "values": [
+            "idle",
+            "streaming"
+          ],
+          "default": "idle",
+          "description": "While `streaming`, send becomes Stop."
+        },
+        {
+          "name": "onSubmit",
+          "type": "((value: string) => void)",
+          "required": false,
+          "description": "Enter, or the send button. Receives the trimmed text."
+        },
+        {
+          "name": "onStop",
+          "type": "(() => void)",
+          "required": false
+        },
+        {
+          "name": "onAttach",
+          "type": "(() => void)",
+          "required": false,
+          "description": "The + button. Hidden when there is no handler and `attachments` is unset... pass `onAttach` to show it."
+        },
+        {
+          "name": "onVoice",
+          "type": "(() => void)",
+          "required": false,
+          "description": "The mic. Hidden when there is no handler."
+        },
+        {
+          "name": "attachments",
+          "type": "ReactNode",
+          "required": false,
+          "description": "Chips above the field, usually AttachmentChip."
+        },
+        {
+          "name": "actions",
+          "type": "ReactNode",
+          "required": false,
+          "description": "Extra controls on the left, after the +."
+        },
+        {
+          "name": "maxRows",
+          "type": "number",
+          "required": false,
+          "default": 8,
+          "description": "The most lines the field grows to before it scrolls. Default 8."
+        },
+        {
+          "name": "glow",
+          "type": "\"off\" | \"once\" | \"pulse\" | \"focus\"",
+          "required": false,
+          "values": [
+            "off",
+            "once",
+            "pulse",
+            "focus"
+          ],
+          "default": "once",
+          "description": "The ember light round the border (Textarea variant=\"ai\"'s): `once` (default) one lap shortly after it appears, then still; `pulse` every 2.5s while idle; `focus` one lap each time it gains focus; `off` none."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "autoFocus",
+          "type": "boolean",
+          "required": false,
+          "description": "Focus the field on mount."
+        },
+        {
+          "name": "aria-label",
+          "type": "string",
+          "required": false,
+          "default": "Message",
+          "description": "Accessible name of the field."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { PromptComposer } from '@sakaniui/react';\n\n<PromptComposer />",
+      "aliases": [
+        "prompt box",
+        "ai input",
+        "chat input",
+        "message composer",
+        "ask anything",
+        "ai prompt input",
+        "prompt input",
+        "send stop button",
+        "chatgpt input"
+      ]
+    },
     {
       "name": "QuantitySelector",
       "kind": "component",
@@ -7992,6 +8357,80 @@
         "radio input"
       ]
     },
+    {
+      "name": "ReasoningTrace",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "The thinking panel above a reply.",
+      "props": [
+        {
+          "name": "status",
+          "type": "\"done\" | \"streaming\"",
+          "required": false,
+          "values": [
+            "done",
+            "streaming"
+          ],
+          "default": "done"
+        },
+        {
+          "name": "elapsed",
+          "type": "number",
+          "required": false,
+          "description": "Seconds. Streaming: the running time; done: the final time (\"Thought for 6s\")."
+        },
+        {
+          "name": "summary",
+          "type": "string",
+          "required": false,
+          "description": "One line about what it concluded, shown on the closed row."
+        },
+        {
+          "name": "children",
+          "type": "ReactNode",
+          "required": false,
+          "description": "The reasoning, one paragraph per child."
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "defaultOpen",
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        {
+          "name": "onOpenChange",
+          "type": "((open: boolean) => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { ReasoningTrace } from '@sakaniui/react';\n\n<ReasoningTrace />",
+      "aliases": [
+        "thinking",
+        "thinking panel",
+        "reasoning",
+        "thought for",
+        "chain of thought summary",
+        "ai thinking",
+        "show thinking",
+        "reasoning panel"
+      ]
+    },
     {
       "name": "RichSeparator",
       "kind": "component",
@@ -8369,12 +8808,12 @@
       "props": [
         {
           "name": "type",
-          "type": "\"user\" | \"user-menu\" | \"actions\"",
+          "type": "\"user\" | \"actions\" | \"user-menu\"",
           "required": false,
           "values": [
             "user",
-            "user-menu",
-            "actions"
+            "actions",
+            "user-menu"
           ],
           "default": "user"
         },
@@ -9174,12 +9613,12 @@
         },
         {
           "name": "trend",
-          "type": "\"flat\" | \"up\" | \"down\"",
+          "type": "\"up\" | \"down\" | \"flat\"",
           "required": false,
           "values": [
-            "flat",
             "up",
-            "down"
+            "down",
+            "flat"
           ],
           "default": "up"
         },
@@ -9588,6 +10027,67 @@
       "since": "0.3.0",
       "example": "import { SubFeature } from '@sakaniui/react';\n\n<SubFeature icon=\"Icon\" title=\"Title\" description=\"Description\" />"
     },
+    {
+      "name": "SuggestionChip",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "A suggested prompt.",
+      "props": [
+        {
+          "name": "variant",
+          "type": "\"starter\" | \"follow-up\"",
+          "required": false,
+          "values": [
+            "starter",
+            "follow-up"
+          ],
+          "default": "follow-up"
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "required": true,
+          "description": "The prompt. For a starter it is the title."
+        },
+        {
+          "name": "hint",
+          "type": "string",
+          "required": false,
+          "description": "Starter only: a one-line hint under the title."
+        },
+        {
+          "name": "icon",
+          "type": "IconComponent",
+          "required": false,
+          "description": "Starter: the icon in the tile. Follow-up: defaults to an arrow."
+        },
+        {
+          "name": "index",
+          "type": "number",
+          "required": false,
+          "default": 0,
+          "description": "Starter: its place in the row, so each rises 50ms after the one before."
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "label"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { SuggestionChip } from '@sakaniui/react';\n\n<SuggestionChip label=\"Label\" />",
+      "aliases": [
+        "suggested prompt",
+        "prompt suggestion",
+        "starter prompt",
+        "follow-up question",
+        "follow up chip",
+        "conversation starter",
+        "quick reply"
+      ]
+    },
     {
       "name": "Switch",
       "kind": "component",
@@ -10030,15 +10530,16 @@
         },
         {
           "name": "glow",
-          "type": "\"off\" | \"pulse\" | \"focus\"",
+          "type": "\"off\" | \"once\" | \"pulse\" | \"focus\"",
           "required": false,
           "values": [
             "off",
+            "once",
             "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.",
+          "default": "once",
+          "description": "variant=\"ai\": the light that sweeps clockwise around the border. \"once\" (default) sweeps one lap shortly after it appears and then stays still, focused or not; \"pulse\" 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"
         },
         {
@@ -10076,6 +10577,33 @@
         "comment box"
       ]
     },
+    {
+      "name": "ThinkingLoader",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "The status pill of an AI that is working: a ray spinner and a label whose text shimmers, in a 1px-bordered full-radius pill.",
+      "props": [
+        {
+          "name": "label",
+          "type": "string",
+          "required": false,
+          "default": "Thinking",
+          "description": "What it is doing. Default \"Thinking\"."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { ThinkingLoader } from '@sakaniui/react';\n\n<ThinkingLoader />"
+    },
     {
       "name": "Ticker",
       "kind": "component",
@@ -10316,6 +10844,94 @@
         "toast manager"
       ]
     },
+    {
+      "name": "ToolCall",
+      "kind": "component",
+      "category": "AI",
+      "import": "@sakaniui/react",
+      "summary": "The row an agent leaves when it calls a tool.",
+      "props": [
+        {
+          "name": "status",
+          "type": "\"error\" | \"done\" | \"running\"",
+          "required": false,
+          "values": [
+            "error",
+            "done",
+            "running"
+          ],
+          "default": "done"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": true,
+          "description": "The tool's name, in code: \"search_crm\"."
+        },
+        {
+          "name": "args",
+          "type": "string",
+          "required": false,
+          "description": "The arguments, in code, muted: `(query=\"Acme Corp\")`."
+        },
+        {
+          "name": "duration",
+          "type": "string",
+          "required": false,
+          "description": "\"1.2s\"."
+        },
+        {
+          "name": "input",
+          "type": "unknown",
+          "required": false,
+          "description": "The call's input: a string, or any value (shown as JSON)."
+        },
+        {
+          "name": "output",
+          "type": "unknown",
+          "required": false,
+          "description": "The call's output: a string, or any value (shown as JSON)."
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "required": false
+        },
+        {
+          "name": "defaultOpen",
+          "type": "boolean",
+          "required": false,
+          "default": false
+        },
+        {
+          "name": "onOpenChange",
+          "type": "((open: boolean) => void)",
+          "required": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [
+          "name"
+        ],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { ToolCall } from '@sakaniui/react';\n\n<ToolCall name=\"Name\" />",
+      "aliases": [
+        "tool use",
+        "function call",
+        "agent tool call",
+        "mcp tool call",
+        "tool result",
+        "tool input output",
+        "api call row"
+      ]
+    },
     {
       "name": "Tooltip",
       "kind": "component",
@@ -10875,6 +11491,83 @@
       "since": "0.3.0",
       "example": "import { AddCardFormBlock } from '@sakaniui/react/blocks';\n\n<AddCardFormBlock />"
     },
+    {
+      "name": "AiChatBlock",
+      "kind": "block",
+      "category": "Blocks/AI",
+      "import": "@sakaniui/react/blocks",
+      "summary": "Ai Chat block (AI): a composition example. Copy it into your project and edit it.",
+      "props": [
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { AiChatBlock } from '@sakaniui/react/blocks';\n\n<AiChatBlock />",
+      "aliases": [
+        "ai chat",
+        "chatgpt layout",
+        "ai assistant screen",
+        "chat with ai",
+        "ai conversation page",
+        "copilot chat",
+        "llm chat ui"
+      ]
+    },
+    {
+      "name": "AiWelcomeBlock",
+      "kind": "block",
+      "category": "Blocks/AI",
+      "import": "@sakaniui/react/blocks",
+      "summary": "Ai Welcome block (AI): a composition example. Copy it into your project and edit it.",
+      "props": [
+        {
+          "name": "greeting",
+          "type": "string",
+          "required": false,
+          "default": "Good afternoon",
+          "description": "\"Good afternoon\"."
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": false,
+          "default": "Samuel",
+          "description": "Who it greets."
+        },
+        {
+          "name": "onSubmit",
+          "type": "((text: string) => void)",
+          "required": false,
+          "description": "Called with the prompt when the user sends."
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "required": false
+        }
+      ],
+      "contract": {
+        "requiredProps": [],
+        "requiresAccessibleName": false
+      },
+      "since": "0.15.0",
+      "example": "import { AiWelcomeBlock } from '@sakaniui/react/blocks';\n\n<AiWelcomeBlock />",
+      "aliases": [
+        "ai welcome",
+        "ai home",
+        "ai empty state",
+        "ask anything screen",
+        "ai landing screen",
+        "good afternoon greeting"
+      ]
+    },
     {
       "name": "AppHeaderBlock",
       "kind": "block",
@@ -11715,13 +12408,13 @@
       "props": [
         {
           "name": "state",
-          "type": "\"default\" | \"empty\" | \"loading\" | \"error\" | \"filtered\" | \"bulk\"",
+          "type": "\"default\" | \"error\" | \"empty\" | \"loading\" | \"filtered\" | \"bulk\"",
           "required": false,
           "values": [
             "default",
+            "error",
             "empty",
             "loading",
-            "error",
             "filtered",
             "bulk"
           ],
@@ -13633,22 +14326,22 @@
                 "description": "Unique key for the grid -- defaults to `name` if omitted."
               },
               {
-                "name": "location",
+                "name": "image",
                 "type": "string",
                 "required": true
               },
               {
-                "name": "name",
+                "name": "location",
                 "type": "string",
                 "required": true
               },
               {
-                "name": "role",
+                "name": "name",
                 "type": "string",
                 "required": true
               },
               {
-                "name": "image",
+                "name": "role",
                 "type": "string",
                 "required": true
               },