@epicbagel/saas-kit 1.26.0 → 1.28.0

package/dist/primitives/chat.cjs

@@ -17,7 +17,10 @@ var _chunkPNI354BYcjs = require('../chunk-PNI354BY.cjs');
 var _chunkM4V7OJNFcjs = require('../chunk-M4V7OJNF.cjs');
 
 
-var _chunkU7XNNLVPcjs = require('../chunk-U7XNNLVP.cjs');
+var _chunkVMXKT67Ecjs = require('../chunk-VMXKT67E.cjs');
+
+
+var _chunkWP7CKIPEcjs = require('../chunk-WP7CKIPE.cjs');
 
 
 
@@ -37,6 +40,14 @@ require('../chunk-2HV2KKOE.cjs');
 
 
 
+
+
+
+var _chunkDHXKCMKYcjs = require('../chunk-DHXKCMKY.cjs');
+require('../chunk-NQK5ZWC7.cjs');
+
+
+
 var _chunkZLEM2SAUcjs = require('../chunk-ZLEM2SAU.cjs');
 
 
@@ -120,6 +131,7 @@ var _chunkH2UFRLLNcjs = require('../chunk-H2UFRLLN.cjs');
 
 
 
+
 var _react = require('react');
 
 
@@ -178,7 +190,7 @@ function authorLines(messages, markers) {
   });
 }
 function ChatAuthorLine({ author, align }) {
-  const avatar = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkU7XNNLVPcjs.PersonAvatar, { name: author.name, photoUrl: author.avatarUrl, size: 20, fallbackClassName: "text-[9px]" });
+  const avatar = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkWP7CKIPEcjs.PersonAvatar, { name: author.name, photoUrl: author.avatarUrl, size: 20, fallbackClassName: "text-[9px]" });
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { "data-slot": "chat-author", className: _chunkKWLSBTB2cjs.cn.call(void 0, "flex items-center gap-2 text-xs", align === "end" ? "self-end" : "self-start"), children: [
     align === "start" ? avatar : null,
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "font-medium text-foreground", children: author.name }),
@@ -758,6 +770,92 @@ function ChatSuggestions({
     )
   ] });
 }
+var DEFAULT_EMPTY_ACTIONS_LABEL = "Pick up where you left off";
+function ChatEmptyActionIcon({ icon }) {
+  if (!icon) return null;
+  if (_react.isValidElement.call(void 0, icon)) return icon;
+  if (typeof icon === "function" || typeof icon === "object" && icon !== null && "render" in icon) {
+    const IconComp = icon;
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, IconComp, { "aria-hidden": true });
+  }
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _jsxruntime.Fragment, { children: icon });
+}
+function ChatEmptyActions({
+  items,
+  label,
+  onError,
+  className
+}) {
+  const labelId = _react.useId.call(void 0, );
+  const [running, setRunning] = _react.useState.call(void 0, null);
+  if (items.length === 0) return null;
+  const showLabel = label.length > 0;
+  const pick = async (item) => {
+    if (running !== null) return;
+    let result;
+    try {
+      result = item.onSelect();
+    } catch (cause) {
+      onError(cause);
+      return;
+    }
+    if (!result || typeof result.then !== "function") return;
+    setRunning(item.id);
+    try {
+      await result;
+    } catch (cause) {
+      onError(cause);
+    } finally {
+      setRunning(null);
+    }
+  };
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { "data-slot": "chat-empty-actions", className: _chunkKWLSBTB2cjs.cn.call(void 0, "w-full text-left", className), children: [
+    showLabel && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { id: labelId, "data-slot": "chat-empty-actions-label", className: "mb-1.5 px-3 text-xs text-muted-foreground", children: label }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "div",
+      {
+        role: "group",
+        "aria-labelledby": showLabel ? labelId : void 0,
+        "aria-label": showLabel ? void 0 : DEFAULT_EMPTY_ACTIONS_LABEL,
+        className: "flex flex-col gap-0.5",
+        children: items.map((item) => {
+          const busy = running === item.id;
+          return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDHXKCMKYcjs.Item, { asChild: true, size: "sm", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+            "button",
+            {
+              type: "button",
+              "data-slot": "chat-empty-action",
+              "data-state": busy ? "loading" : void 0,
+              "aria-busy": busy || void 0,
+              disabled: item.disabled || running !== null,
+              onClick: () => void pick(item),
+              className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+                "min-h-11 cursor-pointer flex-nowrap text-left",
+                "hover:bg-muted focus-visible:bg-muted",
+                "disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent",
+                busy && "disabled:opacity-100"
+              ),
+              children: [
+                /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                  _chunkDHXKCMKYcjs.ItemMedia,
+                  {
+                    variant: "icon",
+                    className: "size-8 self-center rounded-md bg-muted text-muted-foreground group-has-data-[slot=item-description]/item:translate-y-0 group-has-data-[slot=item-description]/item:self-center",
+                    children: busy ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkVMXKT67Ecjs.Spinner, { "aria-hidden": true }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ChatEmptyActionIcon, { icon: item.icon })
+                  }
+                ),
+                /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkDHXKCMKYcjs.ItemContent, { className: "min-w-0 flex-row flex-wrap items-baseline gap-x-2 gap-y-0.5 md:flex-nowrap", children: [
+                  /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDHXKCMKYcjs.ItemTitle, { className: "w-auto min-w-0 shrink-0 font-normal text-foreground md:max-w-[60%] md:truncate", children: item.label }),
+                  item.detail && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDHXKCMKYcjs.ItemDescription, { className: "line-clamp-1 min-w-0 flex-1 truncate text-xs md:text-sm", children: item.detail })
+                ] })
+              ]
+            }
+          ) }, item.id);
+        })
+      }
+    )
+  ] });
+}
 function MobileReplySuggestions({
   items,
   onSelect,
@@ -913,6 +1011,8 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
   emptySubtitle,
   examplePrompts = [],
   examplePromptsLabel = "Try",
+  emptyActions = [],
+  emptyActionsLabel = DEFAULT_EMPTY_ACTIONS_LABEL,
   examplePromptsVariant = "chips",
   examplePromptsLoading = false,
   examplePromptsLoadingLabel = "Loading suggestions\u2026",
@@ -1152,6 +1252,15 @@ var Chat = _react.forwardRef.call(void 0, function Chat2({
                     }
                   ),
                   error && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ChatError, { children: error }),
+                  !pending && emptyActions.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                    ChatEmptyActions,
+                    {
+                      items: emptyActions,
+                      label: emptyActionsLabel,
+                      onError: reportSendError,
+                      className: "mt-3"
+                    }
+                  ),
                   !pending && examplePromptsLoading && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, ExamplePromptsLoading, { label: examplePromptsLoadingLabel }),
                   !pending && !examplePromptsLoading && examplePrompts.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
                     ChatSuggestions,

package/dist/primitives/chat.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
+import { LucideIcon } from 'lucide-react';
 import { VoiceSessionControlsProps } from './voice-session-controls.cjs';
 import { ChatNavigatorItem } from './chat-turn-navigator.cjs';
 import { MarkdownComponents } from './markdown.cjs';
@@ -259,6 +260,24 @@ interface ChatInputProps {
  * device-aware default modes.
  */
 declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceSession, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, header, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+/** A next step offered in the empty state, under the composer (`emptyActions`). */
+interface ChatEmptyAction {
+    /** Stable key. */
+    id: string;
+    /** What picking it does, e.g. "Review 3 new people". */
+    label: ReactNode;
+    /** Where it applies, muted after the label, e.g. "Head of Sales · Northwind". One line, truncated. */
+    detail?: ReactNode;
+    /** Leading icon: a Lucide component or an element. */
+    icon?: LucideIcon | ReactNode;
+    /**
+     * Called when picked. While a returned promise is pending, that row shows a
+     * spinner and every row is disabled; a rejection re-enables them and is
+     * reported.
+     */
+    onSelect: () => void | Promise<void>;
+    disabled?: boolean;
+}
 interface ChatProps {
     /** Conversation messages. */
     messages: ChatMessage[];
@@ -304,6 +323,21 @@ interface ChatProps {
     examplePrompts?: ReadonlyArray<string>;
     /** Label above the example prompts. Defaults to "Try". */
     examplePromptsLabel?: string;
+    /**
+     * Next steps under the empty-state composer, before `examplePrompts`,
+     * ChatGPT-style: a quiet list of rows, each an icon, what picking it does
+     * and where it applies (`ChatEmptyAction`). Picking one calls its
+     * `onSelect`; nothing is sent here. While a returned promise is pending
+     * the row shows a spinner and every row is disabled. Hidden while
+     * `pending`, like the example prompts.
+     */
+    emptyActions?: ReadonlyArray<ChatEmptyAction>;
+    /**
+     * The actions' small heading and accessible name. Defaults to "Pick up
+     * where you left off"; `""` hides the heading and keeps that default as
+     * the list's accessible name.
+     */
+    emptyActionsLabel?: string;
     /**
      * `chips` (the default) wrap onto as many lines as they need; `row` is one
      * line that scrolls sideways, for a few short prompts where height is
@@ -500,4 +534,4 @@ interface ChatHandle {
  */
 declare const Chat: React$1.ForwardRefExoticComponent<ChatProps & React$1.RefAttributes<ChatHandle>>;
 
-export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatMessageAuthor, ChatNavigatorItem, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps, authorLines };
+export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatEmptyAction, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatMessageAuthor, ChatNavigatorItem, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps, authorLines };

package/dist/primitives/chat.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
+import { LucideIcon } from 'lucide-react';
 import { VoiceSessionControlsProps } from './voice-session-controls.js';
 import { ChatNavigatorItem } from './chat-turn-navigator.js';
 import { MarkdownComponents } from './markdown.js';
@@ -259,6 +260,24 @@ interface ChatInputProps {
  * device-aware default modes.
  */
 declare function ChatInput({ value, onChange, onSend, pending, disabled, placeholder, size, uploadingLabel, voice, voiceSession, voiceTitle, voiceLang, submitLabel, autoFocus, className, inputRef, attachments, onFilesSelected, onRemoveAttachment, accept, multiple, addFilesLabel, appearance, compactOnBlur, header, helperText, privacyNote, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+/** A next step offered in the empty state, under the composer (`emptyActions`). */
+interface ChatEmptyAction {
+    /** Stable key. */
+    id: string;
+    /** What picking it does, e.g. "Review 3 new people". */
+    label: ReactNode;
+    /** Where it applies, muted after the label, e.g. "Head of Sales · Northwind". One line, truncated. */
+    detail?: ReactNode;
+    /** Leading icon: a Lucide component or an element. */
+    icon?: LucideIcon | ReactNode;
+    /**
+     * Called when picked. While a returned promise is pending, that row shows a
+     * spinner and every row is disabled; a rejection re-enables them and is
+     * reported.
+     */
+    onSelect: () => void | Promise<void>;
+    disabled?: boolean;
+}
 interface ChatProps {
     /** Conversation messages. */
     messages: ChatMessage[];
@@ -304,6 +323,21 @@ interface ChatProps {
     examplePrompts?: ReadonlyArray<string>;
     /** Label above the example prompts. Defaults to "Try". */
     examplePromptsLabel?: string;
+    /**
+     * Next steps under the empty-state composer, before `examplePrompts`,
+     * ChatGPT-style: a quiet list of rows, each an icon, what picking it does
+     * and where it applies (`ChatEmptyAction`). Picking one calls its
+     * `onSelect`; nothing is sent here. While a returned promise is pending
+     * the row shows a spinner and every row is disabled. Hidden while
+     * `pending`, like the example prompts.
+     */
+    emptyActions?: ReadonlyArray<ChatEmptyAction>;
+    /**
+     * The actions' small heading and accessible name. Defaults to "Pick up
+     * where you left off"; `""` hides the heading and keeps that default as
+     * the list's accessible name.
+     */
+    emptyActionsLabel?: string;
     /**
      * `chips` (the default) wrap onto as many lines as they need; `row` is one
      * line that scrolls sideways, for a few short prompts where height is
@@ -500,4 +534,4 @@ interface ChatHandle {
  */
 declare const Chat: React$1.ForwardRefExoticComponent<ChatProps & React$1.RefAttributes<ChatHandle>>;
 
-export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatMessageAuthor, ChatNavigatorItem, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps, authorLines };
+export { Chat, type ChatAttachment, type ChatAttachmentAction, ChatCopyAction, type ChatCopyActionProps, type ChatEmptyAction, type ChatHandle, ChatInput, type ChatInputProps, type ChatMessage, type ChatMessageAuthor, ChatNavigatorItem, type ChatProps, type ChatRole, ChatThread, type ChatThreadProps, authorLines };

package/dist/primitives/chat.js

@@ -15,9 +15,12 @@ import {
   Suggestion,
   Suggestions
 } from "../chunk-IJG2B3Y2.js";
+import {
+  Spinner
+} from "../chunk-QZBPZLAB.js";
 import {
   PersonAvatar
-} from "../chunk-NXFZULS3.js";
+} from "../chunk-T5AFBLP2.js";
 import {
   Marker,
   MarkerContent
@@ -34,6 +37,14 @@ import {
   InputGroupTextarea
 } from "../chunk-QTPPNK6F.js";
 import "../chunk-6FC65AZQ.js";
+import {
+  Item,
+  ItemContent,
+  ItemDescription,
+  ItemMedia,
+  ItemTitle
+} from "../chunk-SG4ZE2EN.js";
+import "../chunk-HYTILYE5.js";
 import {
   FileDropArea,
   FileDropzone
@@ -114,6 +125,7 @@ import {
 // src/primitives/chat.tsx
 import {
   forwardRef,
+  isValidElement,
   useCallback,
   useEffect,
   useId,
@@ -758,6 +770,92 @@ function ChatSuggestions({
     )
   ] });
 }
+var DEFAULT_EMPTY_ACTIONS_LABEL = "Pick up where you left off";
+function ChatEmptyActionIcon({ icon }) {
+  if (!icon) return null;
+  if (isValidElement(icon)) return icon;
+  if (typeof icon === "function" || typeof icon === "object" && icon !== null && "render" in icon) {
+    const IconComp = icon;
+    return /* @__PURE__ */ jsx(IconComp, { "aria-hidden": true });
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children: icon });
+}
+function ChatEmptyActions({
+  items,
+  label,
+  onError,
+  className
+}) {
+  const labelId = useId();
+  const [running, setRunning] = useState(null);
+  if (items.length === 0) return null;
+  const showLabel = label.length > 0;
+  const pick = async (item) => {
+    if (running !== null) return;
+    let result;
+    try {
+      result = item.onSelect();
+    } catch (cause) {
+      onError(cause);
+      return;
+    }
+    if (!result || typeof result.then !== "function") return;
+    setRunning(item.id);
+    try {
+      await result;
+    } catch (cause) {
+      onError(cause);
+    } finally {
+      setRunning(null);
+    }
+  };
+  return /* @__PURE__ */ jsxs("div", { "data-slot": "chat-empty-actions", className: cn("w-full text-left", className), children: [
+    showLabel && /* @__PURE__ */ jsx("p", { id: labelId, "data-slot": "chat-empty-actions-label", className: "mb-1.5 px-3 text-xs text-muted-foreground", children: label }),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: "group",
+        "aria-labelledby": showLabel ? labelId : void 0,
+        "aria-label": showLabel ? void 0 : DEFAULT_EMPTY_ACTIONS_LABEL,
+        className: "flex flex-col gap-0.5",
+        children: items.map((item) => {
+          const busy = running === item.id;
+          return /* @__PURE__ */ jsx(Item, { asChild: true, size: "sm", children: /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              "data-slot": "chat-empty-action",
+              "data-state": busy ? "loading" : void 0,
+              "aria-busy": busy || void 0,
+              disabled: item.disabled || running !== null,
+              onClick: () => void pick(item),
+              className: cn(
+                "min-h-11 cursor-pointer flex-nowrap text-left",
+                "hover:bg-muted focus-visible:bg-muted",
+                "disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent",
+                busy && "disabled:opacity-100"
+              ),
+              children: [
+                /* @__PURE__ */ jsx(
+                  ItemMedia,
+                  {
+                    variant: "icon",
+                    className: "size-8 self-center rounded-md bg-muted text-muted-foreground group-has-data-[slot=item-description]/item:translate-y-0 group-has-data-[slot=item-description]/item:self-center",
+                    children: busy ? /* @__PURE__ */ jsx(Spinner, { "aria-hidden": true }) : /* @__PURE__ */ jsx(ChatEmptyActionIcon, { icon: item.icon })
+                  }
+                ),
+                /* @__PURE__ */ jsxs(ItemContent, { className: "min-w-0 flex-row flex-wrap items-baseline gap-x-2 gap-y-0.5 md:flex-nowrap", children: [
+                  /* @__PURE__ */ jsx(ItemTitle, { className: "w-auto min-w-0 shrink-0 font-normal text-foreground md:max-w-[60%] md:truncate", children: item.label }),
+                  item.detail && /* @__PURE__ */ jsx(ItemDescription, { className: "line-clamp-1 min-w-0 flex-1 truncate text-xs md:text-sm", children: item.detail })
+                ] })
+              ]
+            }
+          ) }, item.id);
+        })
+      }
+    )
+  ] });
+}
 function MobileReplySuggestions({
   items,
   onSelect,
@@ -913,6 +1011,8 @@ var Chat = forwardRef(function Chat2({
   emptySubtitle,
   examplePrompts = [],
   examplePromptsLabel = "Try",
+  emptyActions = [],
+  emptyActionsLabel = DEFAULT_EMPTY_ACTIONS_LABEL,
   examplePromptsVariant = "chips",
   examplePromptsLoading = false,
   examplePromptsLoadingLabel = "Loading suggestions\u2026",
@@ -1152,6 +1252,15 @@ var Chat = forwardRef(function Chat2({
                     }
                   ),
                   error && /* @__PURE__ */ jsx(ChatError, { children: error }),
+                  !pending && emptyActions.length > 0 && /* @__PURE__ */ jsx(
+                    ChatEmptyActions,
+                    {
+                      items: emptyActions,
+                      label: emptyActionsLabel,
+                      onError: reportSendError,
+                      className: "mt-3"
+                    }
+                  ),
                   !pending && examplePromptsLoading && /* @__PURE__ */ jsx(ExamplePromptsLoading, { label: examplePromptsLoadingLabel }),
                   !pending && !examplePromptsLoading && examplePrompts.length > 0 && /* @__PURE__ */ jsx(
                     ChatSuggestions,

package/dist/primitives/chip-tabs.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _chunkKGFL3VWYcjs = require('../chunk-KGFL3VWY.cjs');
+var _chunkPPYHNJMVcjs = require('../chunk-PPYHNJMV.cjs');
 require('../chunk-VGTINL5Q.cjs');
 require('../chunk-I6GUOEBO.cjs');
 require('../chunk-KWLSBTB2.cjs');
 
 
-exports.ChipTabs = _chunkKGFL3VWYcjs.ChipTabs;
+exports.ChipTabs = _chunkPPYHNJMVcjs.ChipTabs;

package/dist/primitives/chip-tabs.d.cts

@@ -6,7 +6,7 @@ interface ChipTabItem {
     label: ReactNode;
     /** Optional count rendered after the label in a neutral count badge. */
     count?: number;
-    /** Optional leading icon. */
+    /** Optional leading icon. Decorative: hidden from screen readers, since the label names the chip. */
     icon?: ReactNode;
 }
 interface ChipTabsProps {
@@ -27,13 +27,24 @@ interface ChipTabsProps {
     disabled?: boolean;
     /** Visually guides attention to one option without selecting it. */
     guidedValue?: string;
+    /**
+     * The row's accessible name ("3 people shared from this search"): the
+     * chips become a labelled group. Or point at a visible caption with
+     * `labelledBy`.
+     */
+    label?: string;
+    /** The id of an element whose text names the row, in place of `label`. */
+    labelledBy?: string;
 }
 /**
  * Pill-style tab strip — toggle row of chips with active/inactive states
  * and an optional trailing actions slot. Distinct from `Tabs` (which
  * uses an underlined trigger row for page-level navigation). Use this
  * for compact filter / view selectors inside popovers, sidebars, etc.
+ *
+ * Each chip is a toggle button (`aria-pressed`), so a screen reader says
+ * which one is selected; `label` or `labelledBy` names the row as a group.
  */
-declare function ChipTabs({ items, value, onChange, size, variant, trailing, className, marginBottom, placement, disabled, guidedValue, }: ChipTabsProps): react_jsx_runtime.JSX.Element;
+declare function ChipTabs({ items, value, onChange, size, variant, trailing, className, marginBottom, placement, disabled, guidedValue, label, labelledBy, }: ChipTabsProps): react_jsx_runtime.JSX.Element;
 
 export { type ChipTabItem, ChipTabs, type ChipTabsProps };

package/dist/primitives/chip-tabs.d.ts

@@ -6,7 +6,7 @@ interface ChipTabItem {
     label: ReactNode;
     /** Optional count rendered after the label in a neutral count badge. */
     count?: number;
-    /** Optional leading icon. */
+    /** Optional leading icon. Decorative: hidden from screen readers, since the label names the chip. */
     icon?: ReactNode;
 }
 interface ChipTabsProps {
@@ -27,13 +27,24 @@ interface ChipTabsProps {
     disabled?: boolean;
     /** Visually guides attention to one option without selecting it. */
     guidedValue?: string;
+    /**
+     * The row's accessible name ("3 people shared from this search"): the
+     * chips become a labelled group. Or point at a visible caption with
+     * `labelledBy`.
+     */
+    label?: string;
+    /** The id of an element whose text names the row, in place of `label`. */
+    labelledBy?: string;
 }
 /**
  * Pill-style tab strip — toggle row of chips with active/inactive states
  * and an optional trailing actions slot. Distinct from `Tabs` (which
  * uses an underlined trigger row for page-level navigation). Use this
  * for compact filter / view selectors inside popovers, sidebars, etc.
+ *
+ * Each chip is a toggle button (`aria-pressed`), so a screen reader says
+ * which one is selected; `label` or `labelledBy` names the row as a group.
  */
-declare function ChipTabs({ items, value, onChange, size, variant, trailing, className, marginBottom, placement, disabled, guidedValue, }: ChipTabsProps): react_jsx_runtime.JSX.Element;
+declare function ChipTabs({ items, value, onChange, size, variant, trailing, className, marginBottom, placement, disabled, guidedValue, label, labelledBy, }: ChipTabsProps): react_jsx_runtime.JSX.Element;
 
 export { type ChipTabItem, ChipTabs, type ChipTabsProps };

package/dist/primitives/chip-tabs.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   ChipTabs
-} from "../chunk-QD63LB2F.js";
+} from "../chunk-MP64UGRF.js";
 import "../chunk-H7TETFLB.js";
 import "../chunk-D4ZL2OEQ.js";
 import "../chunk-G6SRSWXB.js";