@aircall/blocks 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Badge, Button, CounterBadge, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, SidebarProvider, TabsList, useSidebar } from "@aircall/ds";
+import { Badge, Button, Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle, CounterBadge, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, SidebarProvider, TabsList, useSidebar } from "@aircall/ds";
 import * as React$1 from "react";
 import { VariantProps } from "class-variance-authority";
 import * as _tanstack_react_form0 from "@tanstack/react-form";
@@ -25,11 +25,13 @@ type EmptyStateMediaProps = Omit<React$1.ComponentProps<typeof EmptyMedia>, 'var
 declare namespace EmptyStateMedia {
   type Props = EmptyStateMediaProps;
 }
+/** Title line of an empty state. Wraps the DS `EmptyTitle`. */
 declare const EmptyStateTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface EmptyStateTitleProps extends React$1.ComponentProps<typeof EmptyTitle> {}
 declare namespace EmptyStateTitle {
   type Props = EmptyStateTitleProps;
 }
+/** Supporting description text of an empty state. Wraps the DS `EmptyDescription`. */
 declare const EmptyStateDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface EmptyStateDescriptionProps extends React$1.ComponentProps<typeof EmptyDescription> {}
 declare namespace EmptyStateDescription {
@@ -46,6 +48,11 @@ declare namespace EmptyStateActions {
   type Props = EmptyStateActionsProps;
 }
 type EmptyStateButtonProps = Omit<React$1.ComponentProps<typeof Button>, 'size'>;
+/**
+ * Action button for an empty state — the only button allowed inside one. Wraps
+ * the DS `Button` with `size` locked to `default` for visual consistency across
+ * empty states; consumers still choose the `variant`.
+ */
 declare const EmptyStateButton: React$1.ForwardRefExoticComponent<Omit<EmptyStateButtonProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare namespace EmptyStateButton {
   type Props = EmptyStateButtonProps;
@@ -53,49 +60,193 @@ declare namespace EmptyStateButton {
 type EmptyStateExternalLinkProps = Omit<EmptyStateButtonProps, 'variant' | 'render'> & {
   href: string;
 };
+/**
+ * External "Learn more"-style link for an empty state. Renders a real `<a>` (via
+ * `EmptyStateButton` with `variant="link"`) that opens in a new tab. Pass
+ * `children` to override the default "Learn more" label, including any icon.
+ *
+ * @default children "Learn more"
+ */
 declare const EmptyStateExternalLink: React$1.ForwardRefExoticComponent<Omit<EmptyStateExternalLinkProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare namespace EmptyStateExternalLink {
   type Props = EmptyStateExternalLinkProps;
 }
 //#endregion
 //#region src/components/coming-soon.d.ts
+/**
+ * Root of the "Coming soon" empty state — shown when a feature exists in the UI
+ * but is not yet available. Renders a `<div>` (the DS `Empty` container); compose
+ * it from its parts.
+ *
+ * @example
+ * ```tsx
+ * <ComingSoonEmptyState>
+ *   <EmptyStateHeader>
+ *     <ComingSoonMedia />
+ *     <ComingSoonTitle />
+ *     <ComingSoonDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateButton variant="outline" onClick={goBack}>Go back</EmptyStateButton>
+ *     <EmptyStateExternalLink href={docsUrl} />
+ *   </EmptyStateActions>
+ * </ComingSoonEmptyState>
+ * ```
+ */
 declare const ComingSoonEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "Coming soon" empty state (a sprout icon). Renders a `<div>`, hidden from assistive tech. */
 declare const ComingSoonMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "Coming soon" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const ComingSoonTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "Coming soon" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const ComingSoonDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/restricted-access.d.ts
+/**
+ * Root of the "Restricted access" empty state — shown when the user lacks
+ * permission to view a page. Renders a `<div>` (the DS `Empty` container); pair
+ * it with an `EmptyStateExternalLink` for the "Learn more" action.
+ *
+ * @example
+ * ```tsx
+ * <RestrictedAccessEmptyState>
+ *   <EmptyStateHeader>
+ *     <RestrictedAccessMedia />
+ *     <RestrictedAccessTitle />
+ *     <RestrictedAccessDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateExternalLink href={docsUrl} />
+ *   </EmptyStateActions>
+ * </RestrictedAccessEmptyState>
+ * ```
+ */
 declare const RestrictedAccessEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "Restricted access" empty state (a locked padlock icon). Renders a `<div>`, hidden from assistive tech. */
 declare const RestrictedAccessMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "Restricted access" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const RestrictedAccessTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "Restricted access" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const RestrictedAccessDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/not-found.d.ts
+/**
+ * Root of the "Not found" empty state — shown when a page or route cannot be
+ * found. Renders a `<div>` (the DS `Empty` container); pair it with an
+ * `EmptyStateButton` for the navigation action (e.g. "Go to inbox").
+ *
+ * @example
+ * ```tsx
+ * <NotFoundEmptyState>
+ *   <EmptyStateHeader>
+ *     <NotFoundMedia />
+ *     <NotFoundTitle />
+ *     <NotFoundDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateButton onClick={goToInbox}>Go to inbox</EmptyStateButton>
+ *   </EmptyStateActions>
+ * </NotFoundEmptyState>
+ * ```
+ */
 declare const NotFoundEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "Not found" empty state (a search icon). Renders a `<div>`, hidden from assistive tech. */
 declare const NotFoundMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "Not found" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NotFoundTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "Not found" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NotFoundDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/no-data.d.ts
+/**
+ * Root of the "No data" empty state — shown when a search or filter returns no
+ * results. Renders a `<div>` (the DS `Empty` container) with `role="status"` so
+ * it announces politely after a user action; pair it with an `EmptyStateButton`
+ * for the "Reset" action.
+ *
+ * @example
+ * ```tsx
+ * <NoDataEmptyState>
+ *   <EmptyStateHeader>
+ *     <NoDataMedia />
+ *     <NoDataTitle />
+ *     <NoDataDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateButton variant="outline" onClick={resetFilters}>Reset</EmptyStateButton>
+ *   </EmptyStateActions>
+ * </NoDataEmptyState>
+ * ```
+ */
 declare const NoDataEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "No data" empty state (a search icon). Renders a `<div>`, hidden from assistive tech. */
 declare const NoDataMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "No data" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NoDataTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "No data" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NoDataDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/no-support.d.ts
+/**
+ * Root of the "No support" empty state — shown when the current browser can't
+ * render a page. Renders a `<div>` (the DS `Empty` container); pair it with an
+ * `EmptyStateExternalLink` for the "Learn more" action.
+ *
+ * @example
+ * ```tsx
+ * <NoSupportEmptyState>
+ *   <EmptyStateHeader>
+ *     <NoSupportMedia />
+ *     <NoSupportTitle />
+ *     <NoSupportDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateExternalLink href={docsUrl} />
+ *   </EmptyStateActions>
+ * </NoSupportEmptyState>
+ * ```
+ */
 declare const NoSupportEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "No support" empty state (a settings icon). Renders a `<div>`, hidden from assistive tech. */
 declare const NoSupportMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "No support" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NoSupportTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "No support" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const NoSupportDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/unknown-error.d.ts
+/**
+ * Root of the "Unknown error" empty state — shown when content fails to load
+ * unexpectedly. Renders a `<div>` (the DS `Empty` container) with `role="alert"`
+ * so it announces assertively; pair it with a primary `EmptyStateButton` for the
+ * "Try again" action.
+ *
+ * @example
+ * ```tsx
+ * <UnknownErrorEmptyState>
+ *   <EmptyStateHeader>
+ *     <UnknownErrorMedia />
+ *     <UnknownErrorTitle />
+ *     <UnknownErrorDescription />
+ *   </EmptyStateHeader>
+ *   <EmptyStateActions>
+ *     <EmptyStateButton onClick={retry}>Try again</EmptyStateButton>
+ *   </EmptyStateActions>
+ * </UnknownErrorEmptyState>
+ * ```
+ */
 declare const UnknownErrorEmptyState: React$1.ForwardRefExoticComponent<Omit<EmptyStateProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Decorative media slot of the "Unknown error" empty state (a warning triangle icon). Renders a `<div>`, hidden from assistive tech. */
 declare const UnknownErrorMedia: React$1.ForwardRefExoticComponent<Omit<Omit<EmptyStateMediaProps, "children">, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Title line of the "Unknown error" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const UnknownErrorTitle: React$1.ForwardRefExoticComponent<Omit<EmptyStateTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** Supporting description text of the "Unknown error" empty state. Renders a `<div>` with the design copy by default; pass children to override. */
 declare const UnknownErrorDescription: React$1.ForwardRefExoticComponent<Omit<EmptyStateDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 //#endregion
 //#region src/components/chatbot-response-block.d.ts
+/** Feedback state for a response: thumbs up, thumbs down, or none. */
 type ChatbotResponseBlockFeedback = 'up' | 'down' | null;
+/** A cited source shown in the response's sources hover card. */
 type ChatbotResponseBlockSource = {
   title: string;
   url: string;
@@ -111,6 +262,22 @@ type ChatbotResponseBlockProps = {
   onFeedback?: (value: ChatbotResponseBlockFeedback) => void;
   className?: string;
 };
+/**
+ * Renders a chatbot response from markdown, splitting it into markdown text and
+ * embedded component blocks (table, audio, transcript, loading), with a sources
+ * hover card and copy / thumbs-up / thumbs-down feedback controls. Renders a
+ * `<div>` (`data-slot="chatbot-response-block"`).
+ *
+ * @example
+ * ```tsx
+ * <ChatbotResponseBlock
+ *   messageId="msg-1"
+ *   markdown="**Hello** from the assistant"
+ *   sources={[{ title: 'Help center', url: 'https://help.aircall.io' }]}
+ *   onFeedback={value => console.log(value)}
+ * />
+ * ```
+ */
 declare function ChatbotResponseBlock({
   messageId,
   markdown,
@@ -148,6 +315,26 @@ declare function ChatbotResponseLoading({
 }: ChatbotResponseLoadingProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/chatbot-page.d.ts
+/**
+ * Root layout shell for the AI chatbot experience; provides the `SidebarProvider`
+ * context required by `ChatbotSidebar` and lays out the sidebar and content
+ * columns. Renders a `SidebarProvider` (a `<div>` wrapper) with the sidebar width
+ * preset and full-height overrides for panel/modal contexts.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotPage>
+ *   <ChatbotSidebar conversations={[...]} />
+ *   <ChatbotPageContent>
+ *     <ChatbotPageBody>
+ *       <ChatbotPageHeading>Need help?</ChatbotPageHeading>
+ *       <ChatbotInput />
+ *     </ChatbotPageBody>
+ *     <ChatbotPageFooter betaTermsHref="https://legal.aircall.io/..." />
+ *   </ChatbotPageContent>
+ * </ChatbotPage>
+ * ```
+ */
 declare const ChatbotPage: React$1.ForwardRefExoticComponent<ChatbotPageProps & React$1.RefAttributes<HTMLDivElement>>;
 interface ChatbotPageProps {
   children?: React$1.ReactNode;
@@ -324,6 +511,7 @@ declare function ChatbotPanelHeader({
 }: ChatbotPanelHeaderProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/chatbot-sidebar.d.ts
+/** A single conversation row in the `ChatbotSidebar` recent list. */
 interface ChatbotSidebarConversation {
   id: string;
   /** Display title — truncated with ellipsis when it overflows. */
@@ -364,12 +552,26 @@ interface ChatbotSidebarProps {
   popup?: boolean;
   className?: string;
 }
+/**
+ * Conversation-history sidebar: an optional "New Chat" entry plus a scrollable,
+ * resizable list of recent conversations, each with an optional trailing ⋯ menu.
+ * Renders the DS `Sidebar` (a `<div>`), or a plain `<div>` when `popup`. Must be
+ * rendered inside a `SidebarProvider`.
+ *
+ * @example
+ * ```tsx
+ * <SidebarProvider>
+ *   <ChatbotSidebar conversations={items} onSelectConversation={open} />
+ * </SidebarProvider>
+ * ```
+ */
 declare const ChatbotSidebar: React$1.ForwardRefExoticComponent<ChatbotSidebarProps & React$1.RefAttributes<HTMLDivElement>>;
 declare namespace ChatbotSidebar {
   type Props = ChatbotSidebarProps;
 }
 //#endregion
 //#region src/components/chatbot-input.d.ts
+/** A suggestion pill shown in a row below the `ChatbotInput`. */
 interface ChatbotInputSuggestion {
   id: string;
   /** Text shown on the pill button. */
@@ -407,6 +609,18 @@ type ChatbotInputProps = Omit<React$1.ComponentProps<'textarea'>, 'onChange' | '
   activeConversationId?: string; /** Called when the user selects a conversation from the history popover. */
   onSelectConversation?: (id: string) => void;
 };
+/**
+ * Chatbot message composer: an auto-growing `InputGroup` textarea with a send/stop
+ * button, plus optional suggestion pills and a conversation-history popover. Works
+ * controlled (`value` + `onValueChange`) or uncontrolled. Enter submits;
+ * Shift+Enter inserts a newline. Renders the DS `InputGroup` (a `<div>`) wrapping a
+ * `<textarea>`.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotInput value={text} onValueChange={setText} onSubmit={send} />
+ * ```
+ */
 declare function ChatbotInput({
   className,
   value,
@@ -427,6 +641,19 @@ declare function ChatbotInput({
 }: ChatbotInputProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/copy-button.d.ts
+/**
+ * Copy-to-clipboard button. Composes DS `Button`; copies `value` on click and
+ * exposes a `copied` state (auto-reset after `timeout`) to its `CopyButtonIcon`
+ * and `CopyButtonLabel` children via context. Renders a `<button>`.
+ *
+ * @example
+ * ```tsx
+ * <CopyButton value="npm i @aircall/ds">
+ *   <CopyButtonIcon />
+ *   <CopyButtonLabel />
+ * </CopyButton>
+ * ```
+ */
 declare const CopyButton: React$1.ForwardRefExoticComponent<Omit<CopyButtonProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 interface CopyButtonProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick' | 'variant'> {
   value: string;
@@ -438,6 +665,10 @@ interface CopyButtonProps extends Omit<React$1.ComponentProps<typeof Button>, 'o
 declare namespace CopyButton {
   type Props = CopyButtonProps;
 }
+/**
+ * Icon for `CopyButton` that swaps between a copy glyph and a check glyph based on
+ * the parent's copied state. Renders an `<svg>`. Must be used inside a `CopyButton`.
+ */
 declare const CopyButtonIcon: React$1.ForwardRefExoticComponent<CopyButtonIconProps & React$1.RefAttributes<SVGSVGElement>>;
 interface CopyButtonIconProps {
   className?: string;
@@ -445,6 +676,10 @@ interface CopyButtonIconProps {
 declare namespace CopyButtonIcon {
   type Props = CopyButtonIconProps;
 }
+/**
+ * Text label for `CopyButton` that shows `label` normally and `copiedLabel` after a
+ * successful copy. Renders a `<span>`. Must be used inside a `CopyButton`.
+ */
 declare const CopyButtonLabel: React$1.ForwardRefExoticComponent<CopyButtonLabelProps & React$1.RefAttributes<HTMLSpanElement>>;
 interface CopyButtonLabelProps {
   label?: string;
@@ -457,6 +692,17 @@ declare namespace CopyButtonLabel {
 //#endregion
 //#region src/components/chatbot-panel-suggestion.d.ts
 type ChatbotPanelSuggestionProps = Omit<React.ComponentProps<typeof Button>, 'variant' | 'size'>;
+/**
+ * Pill-shaped prompt suggestion shown in the chatbot panel; a preset styling of
+ * `Button` with a green border and surface background. Renders a `<button>`.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotPanelSuggestion onClick={() => ask('How do I set my phone line?')}>
+ *   How do I set my phone line?
+ * </ChatbotPanelSuggestion>
+ * ```
+ */
 declare function ChatbotPanelSuggestion({
   className,
   ...props
@@ -464,6 +710,16 @@ declare function ChatbotPanelSuggestion({
 //#endregion
 //#region src/components/chatbot-user-message.d.ts
 type ChatbotUserMessageProps = React.ComponentProps<'div'>;
+/**
+ * Right-aligned chat bubble for a user's message; clamps long content to six
+ * lines with a "Show more" / "Show less" toggle. Renders a `<div>`
+ * (`data-slot="chatbot-user-message"`).
+ *
+ * @example
+ * ```tsx
+ * <ChatbotUserMessage>How do I set up my phone number?</ChatbotUserMessage>
+ * ```
+ */
 declare function ChatbotUserMessage({
   className,
   children,
@@ -471,31 +727,68 @@ declare function ChatbotUserMessage({
 }: ChatbotUserMessageProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/dashboard-standalone-page.d.ts
+/**
+ * Full-screen takeover shell for focused, sidebar-less flows; renders a flex-row `<div>`
+ * holding one or more `DashboardStandalonePageContent` panels side by side.
+ *
+ * @example
+ * ```tsx
+ * <DashboardStandalonePage>
+ *   <DashboardStandalonePageContent>
+ *     <DashboardStandalonePageHeader>
+ *       <DashboardStandalonePageTitle>Create user</DashboardStandalonePageTitle>
+ *       <DashboardStandalonePageActions side="start">
+ *         <DashboardStandalonePageAction>Cancel</DashboardStandalonePageAction>
+ *       </DashboardStandalonePageActions>
+ *     </DashboardStandalonePageHeader>
+ *     <DashboardStandalonePageMain>…</DashboardStandalonePageMain>
+ *   </DashboardStandalonePageContent>
+ * </DashboardStandalonePage>
+ * ```
+ */
 declare const DashboardStandalonePage: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardStandalonePageProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardStandalonePage {
   type Props = DashboardStandalonePageProps;
 }
+/**
+ * Rounded, bordered content panel that fills the shell; renders a `<div>`.
+ * Typically wraps a `DashboardStandalonePageHeader` above a `DashboardStandalonePageMain`.
+ */
 declare const DashboardStandalonePageContent: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageContentProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardStandalonePageContentProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardStandalonePageContent {
   type Props = DashboardStandalonePageContentProps;
 }
+/**
+ * Fixed-height (64px) header bar with an optically centered title and absolutely
+ * positioned action slots; renders a `<header>`.
+ */
 declare const DashboardStandalonePageHeader: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageHeaderProps, "ref"> & React$1.RefAttributes<HTMLElement>>;
 interface DashboardStandalonePageHeaderProps extends React$1.ComponentProps<'header'> {}
 declare namespace DashboardStandalonePageHeader {
   type Props = DashboardStandalonePageHeaderProps;
 }
+/**
+ * Centered, truncated page title in the header; renders an `<h1>`.
+ */
 declare const DashboardStandalonePageTitle: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageTitleProps, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 interface DashboardStandalonePageTitleProps extends React$1.ComponentProps<'h1'> {}
 declare namespace DashboardStandalonePageTitle {
   type Props = DashboardStandalonePageTitleProps;
 }
+/**
+ * Optional subtitle stacked beneath the title in the header; renders a `<p>`.
+ */
 declare const DashboardStandalonePageDescription: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageDescriptionProps, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 interface DashboardStandalonePageDescriptionProps extends React$1.ComponentProps<'p'> {}
 declare namespace DashboardStandalonePageDescription {
   type Props = DashboardStandalonePageDescriptionProps;
 }
+/**
+ * Action slot absolutely pinned to the header's left or right edge; renders a `<div>`.
+ * Sitting outside the flow, it never shifts the centered title.
+ */
 declare const DashboardStandalonePageActions: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageActionsProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardStandalonePageActionsProps extends React$1.ComponentProps<'div'> {
   side?: 'start' | 'end';
@@ -503,11 +796,17 @@ interface DashboardStandalonePageActionsProps extends React$1.ComponentProps<'di
 declare namespace DashboardStandalonePageActions {
   type Props = DashboardStandalonePageActionsProps;
 }
+/**
+ * Header action button rendering a ds `Button` (ghost, `lg` by default); renders a `<button>`.
+ */
 declare const DashboardStandalonePageAction: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageActionProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 interface DashboardStandalonePageActionProps extends React$1.ComponentProps<typeof Button> {}
 declare namespace DashboardStandalonePageAction {
   type Props = DashboardStandalonePageActionProps;
 }
+/**
+ * Scrollable, transparent content area below the header inside the panel; renders a `<main>`.
+ */
 declare const DashboardStandalonePageMain: React$1.ForwardRefExoticComponent<Omit<DashboardStandalonePageMainProps, "ref"> & React$1.RefAttributes<HTMLElement>>;
 interface DashboardStandalonePageMainProps extends React$1.ComponentProps<'main'> {}
 declare namespace DashboardStandalonePageMain {
@@ -515,26 +814,54 @@ declare namespace DashboardStandalonePageMain {
 }
 //#endregion
 //#region src/components/dashboard-page.d.ts
+/**
+ * Full-screen outer shell for a dashboard view; renders a `<div>`.
+ * Stacks an optional `DashboardPageBanner` above a `DashboardSidebarProvider`
+ * that holds the sidebar and a `DashboardPageContent`.
+ *
+ * @example
+ * ```tsx
+ * <DashboardPage>
+ *   <DashboardSidebarProvider>
+ *     <DashboardSidebar>…</DashboardSidebar>
+ *     <DashboardPageContent>…</DashboardPageContent>
+ *   </DashboardSidebarProvider>
+ * </DashboardPage>
+ * ```
+ */
 declare const DashboardPage: React$1.ForwardRefExoticComponent<Omit<DashboardPageProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPage {
   type Props = DashboardPageProps;
 }
+/**
+ * Full-width top row that sits flush above the sidebar/content row; renders a `<div>`.
+ * Use to host trial notices, announcements, or any ds `Banner`.
+ */
 declare const DashboardPageBanner: React$1.ForwardRefExoticComponent<Omit<DashboardPageBannerProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageBannerProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageBanner {
   type Props = DashboardPageBannerProps;
 }
+/**
+ * White content card filling the right column beside the sidebar; renders a `<div>`.
+ */
 declare const DashboardPageContent: React$1.ForwardRefExoticComponent<Omit<DashboardPageContentProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageContentProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageContent {
   type Props = DashboardPageContentProps;
 }
+/**
+ * Scrollable content area inside `DashboardPageContent`; renders a `<main>`.
+ */
 declare const DashboardPageMain: React$1.ForwardRefExoticComponent<Omit<DashboardPageMainProps, "ref"> & React$1.RefAttributes<HTMLElement>>;
 interface DashboardPageMainProps extends React$1.ComponentProps<'main'> {}
 declare namespace DashboardPageMain {
   type Props = DashboardPageMainProps;
 }
+/**
+ * Left-aligned tab bar placed as a sibling of `DashboardPageHeader`; renders a ds `TabsList`.
+ */
 declare const DashboardPageTabs: React$1.ForwardRefExoticComponent<Omit<DashboardPageTabsProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageTabsProps extends React$1.ComponentProps<typeof TabsList> {}
 declare namespace DashboardPageTabs {
@@ -542,31 +869,62 @@ declare namespace DashboardPageTabs {
 }
 //#endregion
 //#region src/components/dashboard-page-header.d.ts
+/**
+ * Header for a `DashboardPageContent`; renders a `<div>` that establishes a
+ * `@container` context with an inner CSS-grid its sub-components self-place into.
+ *
+ * @example
+ * ```tsx
+ * <DashboardPageHeader>
+ *   <DashboardPageHeaderTitle>Team</DashboardPageHeaderTitle>
+ *   <DashboardPageHeaderActions>
+ *     <DashboardPageHeaderAction>Invite</DashboardPageHeaderAction>
+ *   </DashboardPageHeaderActions>
+ * </DashboardPageHeader>
+ * ```
+ */
 declare const DashboardPageHeader: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeader {
   type Props = DashboardPageHeaderProps;
 }
+/**
+ * Back-navigation row for Level 2 headers; renders a `<div>` in the grid `nav` area.
+ */
 declare const DashboardPageHeaderNav: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderNavProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderNavProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderNav {
   type Props = DashboardPageHeaderNavProps;
 }
+/**
+ * Back button rendering a ghost, small ds `Button` with a leading chevron icon.
+ * Accepts a render prop so it can become an `<a>` or router `<Link>`.
+ */
 declare const DashboardPageHeaderNavBack: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderNavBackProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 interface DashboardPageHeaderNavBackProps extends Omit<React$1.ComponentProps<typeof Button>, 'variant' | 'size'> {}
 declare namespace DashboardPageHeaderNavBack {
   type Props = DashboardPageHeaderNavBackProps;
 }
+/**
+ * Icon/flag slot shown left of the title; renders a `<div>` in the grid `prefix` area.
+ */
 declare const DashboardPageHeaderPrefix: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderPrefixProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderPrefixProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderPrefix {
   type Props = DashboardPageHeaderPrefixProps;
 }
+/**
+ * Wrapper that stacks the title and subtitle; renders a `<div>` in the grid `info` area.
+ */
 declare const DashboardPageHeaderTitleGroup: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderTitleGroupProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderTitleGroupProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderTitleGroup {
   type Props = DashboardPageHeaderTitleGroupProps;
 }
+/**
+ * Page title; renders an `<h1>`, self-placing in the grid `info` area or deferring
+ * layout to `DashboardPageHeaderTitleGroup` when nested inside one.
+ */
 declare const DashboardPageHeaderTitle: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderTitleProps, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 interface DashboardPageHeaderTitleProps extends React$1.ComponentProps<'h1'> {
   size?: 'lg' | 'sm';
@@ -574,21 +932,34 @@ interface DashboardPageHeaderTitleProps extends React$1.ComponentProps<'h1'> {
 declare namespace DashboardPageHeaderTitle {
   type Props = DashboardPageHeaderTitleProps;
 }
+/**
+ * Optional subtitle line/block placed beneath the title; renders a `<div>`.
+ */
 declare const DashboardPageHeaderSubtitle: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderSubtitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderSubtitleProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderSubtitle {
   type Props = DashboardPageHeaderSubtitleProps;
 }
+/**
+ * Muted, clamped description text under the title; renders a `<div>`.
+ */
 declare const DashboardPageHeaderDescription: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderDescriptionProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderDescription {
   type Props = DashboardPageHeaderDescriptionProps;
 }
+/**
+ * Flex container for header actions; renders a `<div>` in the grid `actions` area.
+ */
 declare const DashboardPageHeaderActions: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderActionsProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardPageHeaderActionsProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardPageHeaderActions {
   type Props = DashboardPageHeaderActionsProps;
 }
+/**
+ * Header action button rendering a ds `Button` locked to the actions area sizes;
+ * renders a `<button>` (defaults to a labeled `lg` CTA, or `icon-lg` for icon-only triggers).
+ */
 declare const DashboardPageHeaderAction: React$1.ForwardRefExoticComponent<Omit<DashboardPageHeaderActionProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 interface DashboardPageHeaderActionProps extends Omit<React$1.ComponentProps<typeof Button>, 'size'> {
   size?: 'lg' | 'icon-lg';
@@ -737,10 +1108,12 @@ declare function ChatbotPanelTrigger({
 }: ChatbotPanelTriggerProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/chatbot-expand-suggestion.d.ts
+/** A selectable category filter pill shown above the suggestions list. */
 interface ChatbotExpandSuggestionCategory {
   value: string;
   label: string;
 }
+/** A single clickable suggestion row. */
 interface ChatbotExpandSuggestionItem {
   id: string;
   text: string;
@@ -760,12 +1133,27 @@ interface ChatbotExpandSuggestionProps {
   onSuggestionClick?: (suggestion: ChatbotExpandSuggestionItem) => void;
   className?: string;
 }
+/**
+ * Displays category filter pills and a list of clickable suggestion rows for the
+ * chatbot idle state. Renders a `<div>` wrapping an optional `ToggleGroup` of
+ * category pills and a list of `Item` rows separated by `Separator`.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotExpandSuggestion
+ *   categories={[{ value: 'billing', label: 'Billing' }]}
+ *   suggestions={[{ id: '1', text: 'How do I reset my password?' }]}
+ *   onSuggestionClick={suggestion => console.log(suggestion.text)}
+ * />
+ * ```
+ */
 declare const ChatbotExpandSuggestion: React$1.ForwardRefExoticComponent<ChatbotExpandSuggestionProps & React$1.RefAttributes<HTMLDivElement>>;
 declare namespace ChatbotExpandSuggestion {
   type Props = ChatbotExpandSuggestionProps;
 }
 //#endregion
 //#region src/components/chatbot-panel.d.ts
+/** A suggestion pill shown in the panel's empty state. */
 type ChatbotPanelSuggestionItem = {
   /** Stable id; falls back to the label when omitted. */id?: string; /** Pill copy, also used as the message text on select. */
   label: string;
@@ -808,6 +1196,21 @@ type ChatbotPanelProps = Omit<React$1.ComponentProps<'div'>, 'title' | 'onSubmit
   onWidthChange?: (width: number) => void; /** Conversation content. When empty, the empty state renders instead. */
   children?: React$1.ReactNode;
 };
+/**
+ * Presentational chatbot surface — header, scrollable conversation area (or a
+ * built-in empty state), composer, and disclaimer — in a width-resizable shell.
+ * Owns no visibility state (the consumer controls show/hide); pass the conversation
+ * as `children`, and no children renders the empty state. Renders a `<div>`
+ * container.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotPanel onClose={close} onSubmit={send}>
+ *   <ChatbotUserMessage>Hi</ChatbotUserMessage>
+ *   <ChatbotResponseBlock>Hello!</ChatbotResponseBlock>
+ * </ChatbotPanel>
+ * ```
+ */
 declare function ChatbotPanel({
   title,
   onMenu,
@@ -856,23 +1259,25 @@ declare function useCopyToClipboard(value: string, {
 };
 //#endregion
 //#region src/components/card-save-bar.d.ts
+type CardSaveBarProps = {
+  submitLabel?: string;
+  savingLabel?: string;
+  resetLabel?: string;
+};
 /**
- * Animated save/discard bar for card-layout forms. Slides in when the form is dirty, collapses when clean.
+ * Save/discard bar for card-layout forms — the TanStack Form adapter around
+ * `SaveBar`. Reads `isDirty`, `isSubmitting`, and `canSubmit` from form context
+ * and renders `SaveBar` (which owns the animation, buttons, and the
+ * `data-slot="card-footer"` that flushes it to the card edge).
  *
- * Reads `isDirty`, `isSubmitting`, and `canSubmit` from context — no props needed for form wiring.
- * Must be placed **inside** the `<form>` element and wrapped by `form.AppForm` (or any `formContext` provider).
- * Pair with `<Card className="overflow-hidden pb-0">` so the bar's border sits flush at the card edge.
+ * Must be placed **inside** the `<form>` element and wrapped by `form.AppForm`
+ * (or any `formContext` provider).
  *
  * @example
  * <form.AppForm>
  *   <form.CardSaveBar submitLabel="Save" resetLabel="Discard" />
  * </form.AppForm>
  */
-type CardSaveBarProps = {
-  submitLabel?: string;
-  savingLabel?: string;
-  resetLabel?: string;
-};
 declare function CardSaveBar({
   submitLabel,
   savingLabel,
@@ -880,10 +1285,14 @@ declare function CardSaveBar({
 }: CardSaveBarProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/submit-button.d.ts
+type SubmitButtonProps = Omit<React.ComponentProps<typeof Button>, 'type' | 'disabled'> & {
+  loadingLabel?: string;
+};
 /**
  * Context-aware submit button. Disables itself when the form cannot be submitted or is submitting.
  * Shows `loadingLabel` (default `"Saving…"`) while submitting.
  *
+ * Renders a DS `<Button type="submit">` (a `<button>` element).
  * Must be a descendant of `form.AppForm` (or any `formContext` provider).
  * Use for inline/flat layouts where `CardSaveBar` is not needed.
  * Accepts all `Button` props except `type` and `disabled` (managed internally).
@@ -893,9 +1302,6 @@ declare function CardSaveBar({
  *   <form.SubmitButton loadingLabel="Saving…">Save</form.SubmitButton>
  * </form.AppForm>
  */
-type SubmitButtonProps = Omit<React.ComponentProps<typeof Button>, 'type' | 'disabled'> & {
-  loadingLabel?: string;
-};
 declare function SubmitButton({
   children,
   loadingLabel,
@@ -1538,6 +1944,7 @@ type LayoutProps = {
  *   and error share one growing column on the opposite side.
  */
 type ControlVariant = 'inline' | 'fill';
+/** Props for `FormFieldShell` — the normalized label / description / layout inputs it renders from. */
 type FormFieldShellProps = {
   label?: LabelProp;
   description?: DescriptionProp;
@@ -1554,6 +1961,13 @@ type FormFieldShellProps = {
   controlPosition?: LayoutProps['controlPosition'];
   controlVariant?: ControlVariant;
 };
+/**
+ * Internal layout shell shared by every `Form*Field` wrapper. Normalizes the
+ * `label` / `description` props, lays out the `Field → label row → description →
+ * control → error` skeleton per `orientation` / `controlVariant`, and applies the
+ * error-display policy plus `data-invalid`. Reads the bound field from context,
+ * so it must render inside `form.AppField`. Renders a DS `Field`.
+ */
 declare function FormFieldShell({
   label,
   description,
@@ -2208,12 +2622,127 @@ declare function toFieldErrors(errors: readonly unknown[]): Array<{
   message: string;
 }>;
 //#endregion
+//#region src/components/setting-card.d.ts
+/**
+ * Root container for a setting card. Renders the DS `Card`.
+ *
+ * By default the level (and therefore the background) is detected automatically:
+ * a top-level card is level 1 (muted background, borderless); a card nested
+ * inside another card's `SettingCardContent` becomes level 2 (white background,
+ * border). Pass `level` to force a specific level — needed for the rare third
+ * nesting level, which reuses the level-1 look (`level={1}`).
+ *
+ * @example
+ * ```tsx
+ * <SettingCard>
+ *   <SettingCardHeader>
+ *     <SettingCardTitle>Call recording</SettingCardTitle>
+ *     <SettingCardDescription>Record inbound and outbound calls.</SettingCardDescription>
+ *     <SettingCardAction>
+ *       <Switch checked={enabled} onCheckedChange={setEnabled} />
+ *     </SettingCardAction>
+ *   </SettingCardHeader>
+ *   {enabled && <SettingCardContent>…</SettingCardContent>}
+ * </SettingCard>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With a save/discard bar: put the form on the OUTER level and drop
+ * // `form.CardSaveBar` in as the last child. It reads dirty/submitting/canSubmit
+ * // from form context, slides in when dirty, and carries `data-slot="card-footer"`
+ * // so the card flushes it to the edge automatically. No `className` needed.
+ * <form onSubmit={e => { e.preventDefault(); void form.handleSubmit(); }}>
+ *   <SettingCard>
+ *     <SettingCardHeader>
+ *       <SettingCardTitle>Profile</SettingCardTitle>
+ *       <SettingCardDescription>Update your display name.</SettingCardDescription>
+ *     </SettingCardHeader>
+ *     <SettingCardContent>…</SettingCardContent>
+ *     <form.AppForm>
+ *       <form.CardSaveBar resetLabel="Undo" />
+ *     </form.AppForm>
+ *   </SettingCard>
+ * </form>
+ * ```
+ */
+declare const SettingCard: React$1.ForwardRefExoticComponent<Omit<SettingCardProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardProps extends React$1.ComponentProps<typeof Card> {
+  /**
+   * Force the visual level instead of auto-detecting from nesting.
+   * `1` = muted background, borderless. `2` = white background, border.
+   * Leave undefined to detect automatically (top-level → 1, nested → 2).
+   */
+  level?: 1 | 2;
+}
+declare namespace SettingCard {
+  type Props = SettingCardProps;
+}
+/**
+ * Header row of a setting card. Wraps DS `CardHeader`, which lays out the
+ * title/description on the left and the `SettingCardAction` on the right.
+ */
+declare const SettingCardHeader: React$1.ForwardRefExoticComponent<Omit<SettingCardHeaderProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardHeaderProps extends React$1.ComponentProps<typeof CardHeader> {}
+declare namespace SettingCardHeader {
+  type Props = SettingCardHeaderProps;
+}
+/**
+ * Title of a setting card. Wraps DS `CardTitle`, overriding its type ramp so
+ * weight and size follow the card's level (auto-detected from nesting, like the
+ * background): level 1 is 18px bold, level 2 (nested) is 16px medium. A forced
+ * level-1 card that is still nested (the rare 3rd level) keeps the 16px-medium
+ * title, matching the design guidance for that case.
+ */
+declare const SettingCardTitle: React$1.ForwardRefExoticComponent<Omit<SettingCardTitleProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardTitleProps extends React$1.ComponentProps<typeof CardTitle> {}
+declare namespace SettingCardTitle {
+  type Props = SettingCardTitleProps;
+}
+/**
+ * Supporting description under the title. Wraps DS `CardDescription` (14px muted).
+ * Inline links (e.g. "Learn more") can be placed inside its children.
+ */
+declare const SettingCardDescription: React$1.ForwardRefExoticComponent<Omit<SettingCardDescriptionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardDescriptionProps extends React$1.ComponentProps<typeof CardDescription> {}
+declare namespace SettingCardDescription {
+  type Props = SettingCardDescriptionProps;
+}
+/**
+ * Top-right control slot of the header — holds a single control, either a
+ * `<Switch>` (toggle card) or a `<Button>` (action card). Wraps DS `CardAction`.
+ * The two never co-occur, so this is one slot, not two.
+ */
+declare const SettingCardAction: React$1.ForwardRefExoticComponent<Omit<SettingCardActionProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardActionProps extends React$1.ComponentProps<typeof CardAction> {}
+declare namespace SettingCardAction {
+  type Props = SettingCardActionProps;
+}
+/**
+ * Body of a setting card. Wraps DS `CardContent` and carries the
+ * `data-setting-card-content` marker that drives nesting detection: any
+ * `SettingCard` rendered inside here auto-detects level 2.
+ *
+ * For progressive disclosure, render this conditionally — mount it only when
+ * the header's toggle is on — so gated fields never mount while disabled.
+ */
+declare const SettingCardContent: React$1.ForwardRefExoticComponent<Omit<SettingCardContentProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface SettingCardContentProps extends React$1.ComponentProps<typeof CardContent> {}
+declare namespace SettingCardContent {
+  type Props = SettingCardContentProps;
+}
+//#endregion
 //#region src/components/save-bar.d.ts
 /**
- * Headless animated save/discard bar. Slides in when `isDirty`, collapses when clean.
+ * Headless animated save/discard bar — the shared UI behind `CardSaveBar`.
+ * Slides in when `isDirty`, collapses when clean (animates real content height
+ * via a grid-rows transition, so appear and disappear are both smooth).
  *
- * Unlike `CardSaveBar`, this component is form-library agnostic — wire it manually via `form.Subscribe`.
- * Use when you need the save-bar UI outside of a card layout, or with a custom form setup.
+ * Form-library agnostic: wire the state yourself (via `form.Subscribe`, a store,
+ * or local state). Its root carries `data-slot="card-footer"`, so a surrounding
+ * `Card` collapses its bottom padding (`has-data-[slot=card-footer]:pb-0`) and
+ * the bar sits flush at the card edge. For TanStack Form, prefer `CardSaveBar`,
+ * which reads the state from context and renders this.
  *
  * @example
  * <form.Subscribe selector={s => ({ isDirty: s.isDirty, isSubmitting: s.isSubmitting, canSubmit: s.canSubmit })}>
@@ -2320,62 +2849,130 @@ type DashboardSidebarNavProps = {
    */
   renderLink?: (href: string) => React$1.ReactElement;
 };
+/**
+ * Data-driven sidebar navigation. Maps a `groups` array into the
+ * `DashboardSidebar` primitives, rendering each item as a link, a dropdown
+ * submenu, or an action button (with optional badges, counts, and tooltips).
+ *
+ * Renders a fragment of `DashboardSidebarGroup` sections — it has no wrapper
+ * element of its own, so place it inside a `DashboardSidebarContent`.
+ *
+ * @example
+ * <DashboardSidebarNav
+ *   groups={groups}
+ *   renderLink={href => <Link to={href} />}
+ * />
+ */
 declare function DashboardSidebarNav({
   groups,
   renderLink
 }: DashboardSidebarNavProps): React$1.JSX.Element;
 //#endregion
 //#region src/components/dashboard-sidebar.d.ts
+/**
+ * Context provider and flex-row layout wrapping the sidebar and page content;
+ * renders a ds `SidebarProvider`. Provides the state consumed by `useDashboardSidebar`.
+ *
+ * @example
+ * ```tsx
+ * <DashboardSidebarProvider>
+ *   <DashboardSidebar>
+ *     <DashboardSidebarContent>
+ *       <DashboardSidebarMenu>
+ *         <DashboardSidebarMenuItem>
+ *           <DashboardSidebarMenuButton icon={<Home />}>Home</DashboardSidebarMenuButton>
+ *         </DashboardSidebarMenuItem>
+ *       </DashboardSidebarMenu>
+ *     </DashboardSidebarContent>
+ *   </DashboardSidebar>
+ *   <DashboardPageContent>…</DashboardPageContent>
+ * </DashboardSidebarProvider>
+ * ```
+ */
 declare const DashboardSidebarProvider: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarProviderProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarProviderProps extends React$1.ComponentProps<typeof SidebarProvider> {}
 declare namespace DashboardSidebarProvider {
   type Props = DashboardSidebarProviderProps;
 }
+/**
+ * Root sidebar column that grows/shrinks with the collapse state; renders a `<div>`.
+ * Holds `DashboardSidebarHeader`, `DashboardSidebarContent`, and `DashboardSidebarFooter`.
+ */
 declare const DashboardSidebar: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebar {
   type Props = DashboardSidebarProps;
 }
+/**
+ * Top bar of the sidebar that houses the collapse toggle; renders a `<div>`.
+ */
 declare const DashboardSidebarHeader: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarHeaderProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarHeaderProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebarHeader {
   type Props = DashboardSidebarHeaderProps;
 }
+/**
+ * Collapse/expand toggle rendering a ghost, icon ds `Button`; renders a `<button>`.
+ * Swaps its icon and aria-label based on the sidebar state.
+ */
 declare const DashboardSidebarTrigger: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarTriggerProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 interface DashboardSidebarTriggerProps extends React$1.ComponentProps<typeof Button> {}
 declare namespace DashboardSidebarTrigger {
   type Props = DashboardSidebarTriggerProps;
 }
+/**
+ * Scrollable middle section of the sidebar (scrollbar hidden); renders a `<div>`.
+ */
 declare const DashboardSidebarContent: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarContentProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarContentProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebarContent {
   type Props = DashboardSidebarContentProps;
 }
+/**
+ * Frosted-glass bottom section of the sidebar; renders a `<div>`.
+ */
 declare const DashboardSidebarFooter: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarFooterProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarFooterProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebarFooter {
   type Props = DashboardSidebarFooterProps;
 }
+/**
+ * Groups a set of menu items (optionally labelled); renders a `<div>`.
+ */
 declare const DashboardSidebarGroup: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarGroupProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarGroupProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebarGroup {
   type Props = DashboardSidebarGroupProps;
 }
+/**
+ * Section heading for a group, hidden when the sidebar is collapsed; renders a `<div>`
+ * by default, overridable via the `render` prop.
+ */
 declare const DashboardSidebarGroupLabel: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarGroupLabelProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 type DashboardSidebarGroupLabelProps = useRender.ComponentProps<'div'> & React$1.ComponentProps<'div'>;
 declare namespace DashboardSidebarGroupLabel {
   type Props = DashboardSidebarGroupLabelProps;
 }
+/**
+ * List container for menu items; renders a `<ul>`.
+ */
 declare const DashboardSidebarMenu: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarMenuProps, "ref"> & React$1.RefAttributes<HTMLUListElement>>;
 interface DashboardSidebarMenuProps extends React$1.ComponentProps<'ul'> {}
 declare namespace DashboardSidebarMenu {
   type Props = DashboardSidebarMenuProps;
 }
+/**
+ * Wrapper for a single menu row; renders a `<li>` (relative, for badge positioning).
+ */
 declare const DashboardSidebarMenuItem: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarMenuItemProps, "ref"> & React$1.RefAttributes<HTMLLIElement>>;
 interface DashboardSidebarMenuItemProps extends React$1.ComponentProps<'li'> {}
 declare namespace DashboardSidebarMenuItem {
   type Props = DashboardSidebarMenuItemProps;
 }
+/**
+ * Pill-shaped navigation item with a leading icon circle and optional trailing action;
+ * renders a `<button>` by default, overridable via the `render` prop (e.g. a router `<Link>`).
+ */
 declare const DashboardSidebarMenuButton: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarMenuButtonProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 type DashboardSidebarMenuButtonProps = useRender.ComponentProps<'button'> & React$1.ComponentProps<'button'> & {
   isActive?: boolean;
@@ -2398,16 +2995,29 @@ type DashboardSidebarMenuButtonProps = useRender.ComponentProps<'button'> & Reac
 declare namespace DashboardSidebarMenuButton {
   type Props = DashboardSidebarMenuButtonProps;
 }
+/**
+ * Notification count badge for a menu item; renders a ds `CounterBadge` positioned
+ * absolutely at the row's right edge (moves to the icon corner when collapsed).
+ * Place it inside `DashboardSidebarMenuItem`, as a sibling of the button.
+ */
 declare const DashboardSidebarMenuBadge: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarMenuBadgeProps, "ref"> & React$1.RefAttributes<HTMLSpanElement>>;
 interface DashboardSidebarMenuBadgeProps extends React$1.ComponentProps<typeof CounterBadge> {}
 declare namespace DashboardSidebarMenuBadge {
   type Props = DashboardSidebarMenuBadgeProps;
 }
+/**
+ * Popover-style panel (white card with border and shadow) opening beside a trigger;
+ * renders a `<div>`. Hosts `DashboardSidebarSubmenuItem` and `DashboardSidebarSubmenuSeparator`.
+ */
 declare const DashboardSidebarSubmenu: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarSubmenuProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarSubmenuProps extends React$1.ComponentProps<'div'> {}
 declare namespace DashboardSidebarSubmenu {
   type Props = DashboardSidebarSubmenuProps;
 }
+/**
+ * One row inside a submenu; renders a `<div>` by default, overridable via the `render`
+ * prop (e.g. an `<a>` or router `<Link>` for navigation).
+ */
 declare const DashboardSidebarSubmenuItem: React$1.ForwardRefExoticComponent<Omit<DashboardSidebarSubmenuItemProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 type DashboardSidebarSubmenuItemProps = useRender.ComponentProps<'div'> & React$1.ComponentProps<'div'> & {
   isActive?: boolean;
@@ -2415,6 +3025,9 @@ type DashboardSidebarSubmenuItemProps = useRender.ComponentProps<'div'> & React$
 declare namespace DashboardSidebarSubmenuItem {
   type Props = DashboardSidebarSubmenuItemProps;
 }
+/**
+ * Thin horizontal divider between submenu items; renders a `<div>`.
+ */
 declare const DashboardSidebarSubmenuSeparator: React$1.ForwardRefExoticComponent<DashboardSidebarSubmenuSeparatorProps & React$1.RefAttributes<HTMLDivElement>>;
 interface DashboardSidebarSubmenuSeparatorProps {
   className?: string;
@@ -2423,4 +3036,4 @@ declare namespace DashboardSidebarSubmenuSeparator {
   type Props = DashboardSidebarSubmenuSeparatorProps;
 }
 //#endregion
-export { type ArrayField, type ArrayItem, BetaBadge, type BoundForm, CardSaveBar, type CardSaveBarProps, ChatbotExpandSuggestion, type ChatbotExpandSuggestionProps, ChatbotInput, type ChatbotInputProps, type ChatbotInputSuggestion, ChatbotPage, ChatbotPageBody, type ChatbotPageBodyProps, ChatbotPageContent, type ChatbotPageContentProps, ChatbotPageConversation, type ChatbotPageConversationProps, ChatbotPageFooter, type ChatbotPageFooterProps, ChatbotPageHeading, type ChatbotPageHeadingProps, ChatbotPageInputBar, type ChatbotPageInputBarProps, type ChatbotPageProps, ChatbotPanel, ChatbotPanelHeader, type ChatbotPanelHeaderProps, type ChatbotPanelProps, ChatbotPanelSuggestion, type ChatbotPanelSuggestionItem, type ChatbotPanelSuggestionProps, ChatbotPanelTrigger, type ChatbotPanelTriggerProps, ChatbotResponseBlock, type ChatbotResponseBlockFeedback, type ChatbotResponseBlockProps, ChatbotResponseLoading, type ChatbotResponseLoadingProps, ChatbotSidebar, type ChatbotSidebarConversation, ChatbotUserMessage, type ChatbotUserMessageProps, type ComboboxControl, ComingSoonDescription, ComingSoonEmptyState, ComingSoonMedia, ComingSoonTitle, CommonForm, CopyButton, CopyButtonIcon, CopyButtonLabel, DashboardPage, DashboardPageBanner, DashboardPageContent, DashboardPageHeader, DashboardPageHeaderAction, DashboardPageHeaderActions, DashboardPageHeaderDescription, DashboardPageHeaderNav, DashboardPageHeaderNavBack, DashboardPageHeaderPrefix, DashboardPageHeaderSubtitle, DashboardPageHeaderTitle, DashboardPageHeaderTitleGroup, DashboardPageMain, DashboardPageTabs, DashboardSidebar, DashboardSidebarContent, DashboardSidebarFooter, DashboardSidebarGroup, DashboardSidebarGroupLabel, DashboardSidebarHeader, DashboardSidebarMenu, DashboardSidebarMenuBadge, DashboardSidebarMenuButton, DashboardSidebarMenuItem, DashboardSidebarNav, type DashboardSidebarNavGroup, type DashboardSidebarNavItem, type DashboardSidebarNavItemAction, type DashboardSidebarNavItemLink, type DashboardSidebarNavItemSubmenu, type DashboardSidebarNavSubmenuItem, DashboardSidebarProvider, DashboardSidebarSubmenu, DashboardSidebarSubmenuItem, DashboardSidebarSubmenuSeparator, DashboardSidebarTrigger, DashboardStandalonePage, DashboardStandalonePageAction, DashboardStandalonePageActions, DashboardStandalonePageContent, DashboardStandalonePageDescription, DashboardStandalonePageHeader, DashboardStandalonePageMain, DashboardStandalonePageTitle, DeprecatedBadge, EmptyState, EmptyStateActions, EmptyStateButton, EmptyStateDescription, EmptyStateExternalLink, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, type FieldBindingProps, FormArrayField, type FormArrayFieldProps, FormComboboxField, type FormComboboxFieldProps, FormFieldBase, FormFieldShell, type FormFieldShellProps, type FormFieldValidators, FormInputField, type FormInputFieldProps, FormMultiComboboxField, type FormMultiComboboxFieldProps, FormNumericField, type FormNumericFieldProps, FormOTPField, type FormOTPFieldProps, FormRadioGroupField, type FormRadioGroupFieldProps, FormSelectField, type FormSelectFieldProps, FormSliderField, type FormSliderFieldProps, FormSwitchField, type FormSwitchFieldProps, FormTextareaField, type FormTextareaFieldProps, FormToggleGroupField, type FormToggleGroupFieldProps, type InputControl, type MultiComboboxControl, type NecessityProps, NewBadge, NoDataDescription, NoDataEmptyState, NoDataMedia, NoDataTitle, NoSupportDescription, NoSupportEmptyState, NoSupportMedia, NoSupportTitle, NotFoundDescription, NotFoundEmptyState, NotFoundMedia, NotFoundTitle, type NumericControl, type OTPControl, PERCENTAGE_THRESHOLDS, ProfessionalBadge, type RadioGroupControl, RestrictedAccessDescription, RestrictedAccessEmptyState, RestrictedAccessMedia, RestrictedAccessTitle, RoleBadge, type RoleBadgeRole, SaveBar, type SaveBarProps, ScoreBadge, type ScoreKind, type ScoreThreshold, type ScoreThresholds, type ScoreTone, type SelectControl, type Sentiment, SentimentBadge, type SliderControl, SubmitButton, type SubmitButtonProps, type SwitchControl, type TextareaControl, type ToggleGroupControl, TrialBadge, type TypedField, UnknownErrorDescription, UnknownErrorEmptyState, UnknownErrorMedia, UnknownErrorTitle, fieldContext, formContext, toFieldErrors, useCopyToClipboard, useSidebar as useDashboardSidebar, useFieldContext, useForm, useFormContext, withFieldGroup, withForm };
+export { type ArrayField, type ArrayItem, BetaBadge, type BoundForm, CardSaveBar, type CardSaveBarProps, ChatbotExpandSuggestion, type ChatbotExpandSuggestionProps, ChatbotInput, type ChatbotInputProps, type ChatbotInputSuggestion, ChatbotPage, ChatbotPageBody, type ChatbotPageBodyProps, ChatbotPageContent, type ChatbotPageContentProps, ChatbotPageConversation, type ChatbotPageConversationProps, ChatbotPageFooter, type ChatbotPageFooterProps, ChatbotPageHeading, type ChatbotPageHeadingProps, ChatbotPageInputBar, type ChatbotPageInputBarProps, type ChatbotPageProps, ChatbotPanel, ChatbotPanelHeader, type ChatbotPanelHeaderProps, type ChatbotPanelProps, ChatbotPanelSuggestion, type ChatbotPanelSuggestionItem, type ChatbotPanelSuggestionProps, ChatbotPanelTrigger, type ChatbotPanelTriggerProps, ChatbotResponseBlock, type ChatbotResponseBlockFeedback, type ChatbotResponseBlockProps, ChatbotResponseLoading, type ChatbotResponseLoadingProps, ChatbotSidebar, type ChatbotSidebarConversation, ChatbotUserMessage, type ChatbotUserMessageProps, type ComboboxControl, ComingSoonDescription, ComingSoonEmptyState, ComingSoonMedia, ComingSoonTitle, CommonForm, CopyButton, CopyButtonIcon, CopyButtonLabel, DashboardPage, DashboardPageBanner, DashboardPageContent, DashboardPageHeader, DashboardPageHeaderAction, DashboardPageHeaderActions, DashboardPageHeaderDescription, DashboardPageHeaderNav, DashboardPageHeaderNavBack, DashboardPageHeaderPrefix, DashboardPageHeaderSubtitle, DashboardPageHeaderTitle, DashboardPageHeaderTitleGroup, DashboardPageMain, DashboardPageTabs, DashboardSidebar, DashboardSidebarContent, DashboardSidebarFooter, DashboardSidebarGroup, DashboardSidebarGroupLabel, DashboardSidebarHeader, DashboardSidebarMenu, DashboardSidebarMenuBadge, DashboardSidebarMenuButton, DashboardSidebarMenuItem, DashboardSidebarNav, type DashboardSidebarNavGroup, type DashboardSidebarNavItem, type DashboardSidebarNavItemAction, type DashboardSidebarNavItemLink, type DashboardSidebarNavItemSubmenu, type DashboardSidebarNavSubmenuItem, DashboardSidebarProvider, DashboardSidebarSubmenu, DashboardSidebarSubmenuItem, DashboardSidebarSubmenuSeparator, DashboardSidebarTrigger, DashboardStandalonePage, DashboardStandalonePageAction, DashboardStandalonePageActions, DashboardStandalonePageContent, DashboardStandalonePageDescription, DashboardStandalonePageHeader, DashboardStandalonePageMain, DashboardStandalonePageTitle, DeprecatedBadge, EmptyState, EmptyStateActions, EmptyStateButton, EmptyStateDescription, EmptyStateExternalLink, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, type FieldBindingProps, FormArrayField, type FormArrayFieldProps, FormComboboxField, type FormComboboxFieldProps, FormFieldBase, FormFieldShell, type FormFieldShellProps, type FormFieldValidators, FormInputField, type FormInputFieldProps, FormMultiComboboxField, type FormMultiComboboxFieldProps, FormNumericField, type FormNumericFieldProps, FormOTPField, type FormOTPFieldProps, FormRadioGroupField, type FormRadioGroupFieldProps, FormSelectField, type FormSelectFieldProps, FormSliderField, type FormSliderFieldProps, FormSwitchField, type FormSwitchFieldProps, FormTextareaField, type FormTextareaFieldProps, FormToggleGroupField, type FormToggleGroupFieldProps, type InputControl, type MultiComboboxControl, type NecessityProps, NewBadge, NoDataDescription, NoDataEmptyState, NoDataMedia, NoDataTitle, NoSupportDescription, NoSupportEmptyState, NoSupportMedia, NoSupportTitle, NotFoundDescription, NotFoundEmptyState, NotFoundMedia, NotFoundTitle, type NumericControl, type OTPControl, PERCENTAGE_THRESHOLDS, ProfessionalBadge, type RadioGroupControl, RestrictedAccessDescription, RestrictedAccessEmptyState, RestrictedAccessMedia, RestrictedAccessTitle, RoleBadge, type RoleBadgeRole, SaveBar, type SaveBarProps, ScoreBadge, type ScoreKind, type ScoreThreshold, type ScoreThresholds, type ScoreTone, type SelectControl, type Sentiment, SentimentBadge, SettingCard, SettingCardAction, SettingCardContent, SettingCardDescription, SettingCardHeader, SettingCardTitle, type SliderControl, SubmitButton, type SubmitButtonProps, type SwitchControl, type TextareaControl, type ToggleGroupControl, TrialBadge, type TypedField, UnknownErrorDescription, UnknownErrorEmptyState, UnknownErrorMedia, UnknownErrorTitle, fieldContext, formContext, toFieldErrors, useCopyToClipboard, useSidebar as useDashboardSidebar, useFieldContext, useForm, useFormContext, withFieldGroup, withForm };