@sakaniui/react 0.13.0 → 0.14.1

package/dist/lib/AiGlow.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+/** `pulse` sweeps every 2.5s while idle, and once each time the field takes focus; `focus` sweeps only on focus; `off` draws nothing. */
+export type AiGlowMode = 'pulse' | 'focus' | 'off';
+export declare const AiGlow: React.FC<{
+    mode: AiGlowMode;
+}>;
+/** The Textarea's focus border: a static 1.5px ember gradient, left to right, that replaces the plain strong border while the box has focus. */
+export declare const AiFocusRing: React.FC;

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 6,
   "name": "@sakaniui/react",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "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.13.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.1. 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": 233,
+    "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)",
@@ -3002,14 +3004,16 @@
           "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."
+          "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)."
+          "description": "Shown in the detail pane when the active row has nothing to preview (`renderPreview` returned nothing).",
+          "since": "0.14.0"
         },
         {
           "name": "emptyTitle",
@@ -3115,19 +3119,22 @@
           "name": "onReport",
           "type": "(() => void)",
           "required": false,
-          "description": "A second, quieter action beside \"Try again\" in the error state (\"Report\")."
+          "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"
+          "default": "Try again",
+          "since": "0.14.0"
         },
         {
           "name": "reportLabel",
           "type": "ReactNode",
           "required": false,
-          "default": "Report"
+          "default": "Report",
+          "since": "0.14.0"
         },
         {
           "name": "workspace",
@@ -3215,13 +3222,15 @@
           "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."
+          "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)."
+          "description": "Called once when the text has been written (or at once when it is not streamed).",
+          "since": "0.14.0"
         },
         {
           "name": "sources",
@@ -4219,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": {
@@ -5002,13 +5050,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15607",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15637",
+                "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."
@@ -5584,13 +5632,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15607",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15637",
+                "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."
@@ -5974,13 +6022,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15607",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15637",
+                "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."
@@ -6281,13 +6329,13 @@
                 "description": "Returns the item located at the specified index."
               },
               {
-                "name": "__@iterator@15607",
+                "name": "__@iterator@15637",
                 "type": "() => ArrayIterator<number>",
                 "required": true,
                 "description": "Iterator"
               },
               {
-                "name": "__@unscopables@15637",
+                "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."
@@ -9955,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": {