@sofya-ds/react 1.10.0 → 1.12.0

package/dist/index.d.ts

@@ -16,11 +16,11 @@ import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import * as SeparatorPrimitive from '@radix-ui/react-separator';
-import { ToasterProps as ToasterProps$1 } from 'sonner';
+import { ExternalToast, ToasterProps as ToasterProps$1, toast } from 'sonner';
 export { ExternalToast, ToastClassnames, toast } from 'sonner';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import * as SwitchPrimitives from '@radix-ui/react-switch';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
-import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 
 declare const avatarSizeOptions: readonly ["sm", "default", "lg"];
 declare const avatarVariants: (props?: ({
@@ -65,6 +65,12 @@ declare const alertVariants: (props?: ({
 interface AlertProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
     icon?: React.ReactNode;
     showToneIcon?: boolean;
+    /**
+     * When provided, renders the single canonical close button. Omit for
+     * non-dismissible alerts so no close affordance is shown.
+     */
+    onDismiss?: () => void;
+    dismissLabel?: string;
 }
 declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
 declare const AlertTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
@@ -98,7 +104,7 @@ declare const buttonVariantOptions: readonly ["default", "gradient", "dropdown",
 declare const buttonSizeOptions: readonly ["default", "sm", "lg", "icon"];
 
 declare const buttonVariants: (props?: ({
-    variant?: "default" | "destructive" | "icon" | "secondary" | "gradient" | "outline" | "dropdown" | "language" | "ghost" | null | undefined;
+    variant?: "default" | "destructive" | "icon" | "secondary" | "gradient" | "dropdown" | "language" | "outline" | "ghost" | null | undefined;
     size?: "sm" | "default" | "lg" | "icon" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
@@ -138,11 +144,32 @@ declare function CardFooter({ children, className, ...props }: React.HTMLAttribu
 interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type"> {
     description?: React.ReactNode;
     descriptionClassName?: string;
+    /** Renders the mixed/indeterminate state (sets the native flag). */
+    indeterminate?: boolean;
+    /** Renders the error state with a destructive border/ring. */
+    error?: boolean;
     label?: React.ReactNode;
     labelClassName?: string;
 }
 declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
 
+interface CloseButtonProps extends Omit<ButtonProps, "variant" | "leftIcon" | "rightIcon" | "children"> {
+    /** Accessible label. Defaults to "Fechar". */
+    label?: string;
+    /** Icon size in px. */
+    iconSize?: number;
+}
+/**
+ * The single, canonical close affordance for the design system.
+ *
+ * It is always a flat ghost icon button on a transparent background — never a
+ * solid/black surface — with a required accessible label and the standard
+ * hover/active/focus-visible/disabled states inherited from `Button`. Dialogs,
+ * popovers and notices should all use this component so there is exactly one
+ * close model across the system.
+ */
+declare const CloseButton: React.ForwardRefExoticComponent<CloseButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
 declare const dropdownVariantOptions: readonly ["card", "language", "selected", "action"];
 type DropdownVariant = (typeof dropdownVariantOptions)[number];
 declare const dropdownAppearanceOptions: readonly ["card"];
@@ -310,6 +337,7 @@ declare const legacyIconToTablerNameMap: {
     readonly copy: "IconCopy";
     readonly logout: "IconLogout";
     readonly star: "IconStar";
+    readonly "star-filled": "IconStarFilled";
     readonly "users-group": "IconUsersGroup";
     readonly archive: "IconArchive";
     readonly folder: "IconFolder";
@@ -324,6 +352,19 @@ declare const legacyIconToTablerNameMap: {
     readonly lixeira: "IconTrash";
     readonly settings: "IconSettings";
     readonly edit: "IconEdit";
+    readonly bold: "IconBold";
+    readonly italic: "IconItalic";
+    readonly underline: "IconUnderline";
+    readonly strikethrough: "IconStrikethrough";
+    readonly "list-bullet": "IconList";
+    readonly "list-numbers": "IconListNumbers";
+    readonly link: "IconLink";
+    readonly quote: "IconQuote";
+    readonly code: "IconCode";
+    readonly "align-left": "IconAlignLeft";
+    readonly "align-center": "IconAlignCenter";
+    readonly "align-right": "IconAlignRight";
+    readonly "align-justify": "IconAlignJustified";
 };
 type IconName = keyof typeof legacyIconToTablerNameMap;
 declare const iconNames: IconName[];
@@ -359,6 +400,29 @@ declare const Icon: React.ForwardRefExoticComponent<Omit<React.SVGProps<SVGSVGEl
     name: IconName;
 } & React.RefAttributes<SVGSVGElement>>;
 
+declare const iconButtonVariantOptions: readonly ["ghost", "subtle", "solid", "destructive"];
+declare const iconButtonSizeOptions: readonly ["sm", "md", "lg"];
+type IconButtonVariant = (typeof iconButtonVariantOptions)[number];
+type IconButtonSize = (typeof iconButtonSizeOptions)[number];
+interface IconButtonProps extends Omit<ButtonProps, "aria-label" | "children" | "leftIcon" | "rightIcon" | "size" | "variant"> {
+    /** Icon-only buttons must have an accessible label. */
+    "aria-label": string;
+    icon: React.ReactNode;
+    variant?: IconButtonVariant;
+    size?: IconButtonSize;
+    /**
+     * Toggle/selected state. When provided, the button exposes `aria-pressed`
+     * and the selected surface. Omit for plain (non-toggle) actions.
+     */
+    selected?: boolean;
+}
+/**
+ * Icon-only action button. Flat/ghost by default so it never paints an
+ * unwanted background on light surfaces (rails, tabs, settings, table actions),
+ * with a fixed square footprint (32x32 by default) for stable layouts.
+ */
+declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
 declare const uploadKindOptions: readonly ["document", "image", "video"];
 type UploadKind = (typeof uploadKindOptions)[number];
 type InputBaseProps$1 = {
@@ -523,6 +587,20 @@ declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverPrimitive.P
 declare const PopoverAnchor: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React.RefAttributes<HTMLDivElement>>;
 declare const PopoverPortal: React.FC<PopoverPrimitive.PopoverPortalProps>;
 declare const PopoverClose: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Opt-in close button for popovers, aligned to the top-right of the content.
+ * Popovers never render a close by default — only mount this when the popover
+ * genuinely needs a dismiss affordance, so there is never a duplicated close.
+ */
+declare const PopoverCloseButton: React.ForwardRefExoticComponent<CloseButtonProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * `PopoverContent` is a transient overlay surface. Per the flat visual
+ * contract it never uses the heavy brand shadows (`--sofya-shadow-sofya-*`).
+ * `--sofya-shadow-soft` is the single, official, minimal elevation used to lift
+ * transient surfaces (popover / dropdown / toast) off the page; visual
+ * separation is also reinforced by the surface border. Pass `shadow-none` via
+ * `className` to opt out entirely.
+ */
 declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const PopoverTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLHeadingElement>>;
 declare const PopoverDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
@@ -599,11 +677,41 @@ type RadioGroupComponent = typeof RadioGroupRoot & {
 };
 declare const RadioGroup: RadioGroupComponent;
 
-interface RightRailActionProps extends Omit<ButtonProps, "aria-label" | "children" | "leftIcon" | "rightIcon" | "size" | "variant"> {
+interface RichTextToolbarProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Accessible name for the toolbar. */
+    "aria-label"?: string;
+    /** Reflects whether the bound editor currently has focus. */
+    editorFocused?: boolean;
+}
+/**
+ * Text editor toolbar. A flat, token-based `role="toolbar"` container that
+ * holds standardized icon buttons. It highlights when the bound editor is
+ * focused (`editorFocused`) and when focus is inside the toolbar itself.
+ */
+declare const RichTextToolbar: React.ForwardRefExoticComponent<RichTextToolbarProps & React.RefAttributes<HTMLDivElement>>;
+declare const RichTextToolbarGroup: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const RichTextToolbarSeparator: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+interface RichTextToolbarButtonProps extends Omit<IconButtonProps, "selected" | "variant"> {
+    /** Whether the tool is currently applied (active/pressed). */
+    active?: boolean;
+}
+/**
+ * A single toolbar tool. Built on the standardized `IconButton`, so it shares
+ * the same flat ghost treatment, fixed size, and required `aria-label`. The
+ * `active` flag exposes the pressed state via `aria-pressed`.
+ */
+declare const RichTextToolbarButton: React.ForwardRefExoticComponent<RichTextToolbarButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+interface RightRailActionProps extends Omit<IconButtonProps, "aria-label" | "icon" | "selected" | "size" | "variant"> {
     "aria-label": string;
     active?: boolean;
     icon: React.ReactNode;
 }
+/**
+ * Right-rail action. Flat/ghost by default so the rail never competes with
+ * table or content actions on light surfaces; the selected surface only
+ * appears when `active`.
+ */
 declare const RightRailAction: React.ForwardRefExoticComponent<RightRailActionProps & React.RefAttributes<HTMLButtonElement>>;
 
 declare const scrollAreaOrientationOptions: readonly ["horizontal", "vertical"];
@@ -634,6 +742,28 @@ declare const SelectSeparator: React.ForwardRefExoticComponent<Omit<SelectPrimit
 
 declare const Separator: React.ForwardRefExoticComponent<Omit<SeparatorPrimitive.SeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 
+interface SidebarNavItemProps extends React.HTMLAttributes<HTMLElement> {
+    /** Render as a different element/component (e.g. a router Link). */
+    as?: React.ElementType;
+    /** Marks the item as the current/selected destination. */
+    active?: boolean;
+    disabled?: boolean;
+    /** Leading icon, kept vertically aligned with the label. */
+    icon?: React.ReactNode;
+    href?: string;
+}
+/**
+ * Lateral navigation item (settings / left sidebar).
+ *
+ * The selected state pairs a light surface background with a left indicator bar
+ * tinted with the primary token. The indicator is absolutely positioned and is
+ * always reserved in the layout (only its opacity toggles), so selecting an
+ * item never causes layout shift, and the icon/label stay aligned across every
+ * state.
+ */
+declare const SidebarNavItem: React.ForwardRefExoticComponent<SidebarNavItemProps & React.RefAttributes<HTMLElement>>;
+declare const SettingsNavItem: React.ForwardRefExoticComponent<SidebarNavItemProps & React.RefAttributes<HTMLElement>>;
+
 interface SliderProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "defaultValue" | "max" | "min" | "onChange" | "size" | "step" | "type" | "value"> {
     defaultValue?: number;
     formatValue?: (value: number) => React.ReactNode;
@@ -665,6 +795,33 @@ type NotificationVariant = (typeof notificationVariantOptions)[number];
 type ToasterProps = ToasterProps$1;
 
 declare const Toaster: React.ForwardRefExoticComponent<ToasterProps$1 & React.RefAttributes<HTMLElement>>;
+type NotifyOptions = ExternalToast & {
+    /** Stable key used for deduplication when no `id` is provided. */
+    key?: string;
+};
+type ToastMessage = React.ReactNode;
+interface NotifyApi {
+    (message: ToastMessage, options?: NotifyOptions): ReturnType<typeof toast>;
+    success: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.success>;
+    error: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.error>;
+    warning: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.warning>;
+    info: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.info>;
+    message: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.message>;
+    loading: (message: ToastMessage, options?: NotifyOptions) => ReturnType<typeof toast.loading>;
+    dismiss: typeof toast.dismiss;
+    promise: typeof toast.promise;
+}
+/**
+ * Official, deduplicated notification API.
+ *
+ * Prefer `notify` over the raw `toast` export: every method here collapses
+ * repeated notifications about the same problem into a single toast (dedup by
+ * `id` → `key` → stable message hash), so calling `notify.error("Falha ao
+ * salvar")` twice updates the existing toast instead of stacking duplicates.
+ * The raw `toast` remains exported for advanced/custom cases that opt out of
+ * deduplication on purpose.
+ */
+declare const notify: NotifyApi;
 
 declare const spinnerSizeOptions: readonly ["sm", "default", "lg"];
 type SpinnerSize = (typeof spinnerSizeOptions)[number];
@@ -673,6 +830,78 @@ interface SpinnerProps extends Omit<React.ComponentPropsWithoutRef<"svg">, "chil
 }
 declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<SVGSVGElement>>;
 
+declare const TooltipProvider: React.FC<TooltipPrimitive.TooltipProviderProps>;
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const tooltipToneOptions: readonly ["default", "info", "success", "warning", "destructive"];
+type TooltipTone = (typeof tooltipToneOptions)[number];
+interface TooltipContentProps extends React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> {
+    tone?: TooltipTone;
+}
+declare const TooltipContent: React.ForwardRefExoticComponent<TooltipContentProps & React.RefAttributes<HTMLDivElement>>;
+interface StatusTooltipProps {
+    /** Trigger element the status tooltip is anchored to. */
+    children: React.ReactNode;
+    /** Status label shown in its semantic color. */
+    label: React.ReactNode;
+    /** Semantic status driving the tooltip color. */
+    status?: TooltipTone;
+    /** Which side of the trigger the tooltip renders on. Defaults to `right`. */
+    side?: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>["side"];
+    align?: React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>["align"];
+    sideOffset?: number;
+    /** Whether the status tooltip is interactive/disabled. */
+    disabled?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    delayDuration?: number;
+    className?: string;
+}
+/**
+ * StatusTooltip is a composite that anchors a tooltip to the right of its
+ * trigger (e.g. the right side of an encounter row in the Home sidebar) and
+ * renders the status label using the matching semantic color.
+ *
+ * It self-contains a `TooltipProvider` so it can be dropped in without extra
+ * wiring, and falls back gracefully when `disabled` is set.
+ */
+declare const StatusTooltip: React.ForwardRefExoticComponent<StatusTooltipProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const workflowStatusOptions: readonly ["draft", "in_progress", "completed", "cancelled", "error", "warning"];
+type WorkflowStatus = (typeof workflowStatusOptions)[number];
+interface WorkflowStatusDescriptor {
+    /** Canonical status, or `null` when the input could not be resolved. */
+    status: WorkflowStatus | null;
+    tone: TooltipTone;
+    label: string;
+}
+/**
+ * Maps a workflow/document status (canonical key or common alias) to a tone and
+ * label. Unknown statuses fall back to the neutral tone with a humanized label
+ * (or an explicit `label` override), so consumers never crash on new statuses.
+ */
+declare function resolveWorkflowStatus(status: WorkflowStatus | string, options?: {
+    label?: string;
+}): WorkflowStatusDescriptor;
+interface StatusIndicatorProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+    status: WorkflowStatus | string;
+    /** Override the resolved label. */
+    label?: string;
+    /** Render the label text next to the dot. */
+    showLabel?: boolean;
+    /** Wrap in a status tooltip (anchored to the right by default). */
+    tooltip?: boolean;
+    side?: "top" | "right" | "bottom" | "left";
+}
+/**
+ * Semantic workflow/document status indicator: a tone-colored dot with an
+ * accessible label, and an optional status tooltip (anchored right, the default
+ * for list/table rows). The status text is always exposed to assistive tech via
+ * `aria-label`, independent of the visual tooltip.
+ */
+declare const StatusIndicator: React.ForwardRefExoticComponent<StatusIndicatorProps & React.RefAttributes<HTMLSpanElement>>;
+
 declare const switchSizeOptions: readonly ["default", "sm"];
 type SwitchSize = (typeof switchSizeOptions)[number];
 interface SwitchProps extends React.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root> {
@@ -706,7 +935,10 @@ interface TableProps extends React.TableHTMLAttributes<HTMLTableElement> {
     density?: TableDensity;
 }
 declare const Table: React.ForwardRefExoticComponent<TableProps & React.RefAttributes<HTMLTableElement>>;
-declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+interface TableHeaderProps extends React.HTMLAttributes<HTMLTableSectionElement> {
+    density?: TableDensity;
+}
+declare const TableHeader: React.ForwardRefExoticComponent<TableHeaderProps & React.RefAttributes<HTMLTableSectionElement>>;
 declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
 declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
 interface TableRowProps extends React.HTMLAttributes<HTMLTableRowElement> {
@@ -738,6 +970,100 @@ interface TableActionButtonProps extends Omit<React.ComponentPropsWithoutRef<typ
 declare const TableActionButton: React.ForwardRefExoticComponent<TableActionButtonProps & React.RefAttributes<HTMLButtonElement>>;
 declare const TableActions: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 
+declare const tagVariantOptions: readonly ["neutral", "organization", "brand", "privacy", "status"];
+declare const tagStatusToneOptions: readonly ["info", "success", "warning", "destructive"];
+type TagVariant = (typeof tagVariantOptions)[number];
+type TagStatusTone = (typeof tagStatusToneOptions)[number];
+declare const tagVariants: (props?: ({
+    variant?: "status" | "organization" | "neutral" | "brand" | "privacy" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof tagVariants> {
+    /** Status color when `variant="status"`. */
+    tone?: TagStatusTone;
+    icon?: React.ReactNode;
+    /**
+     * Truncate the label. Off by default so short/important labels (e.g.
+     * "Minha organização") are never clipped when there is room — only enable
+     * this together with a constraining width when the container is tight.
+     */
+    truncate?: boolean;
+}
+/**
+ * Compact semantic label. Variants: `neutral`, `organization`, `brand`,
+ * `privacy` and `status` (with a `tone`). `brand` reuses the `organization`
+ * primary-tinted look for generic content labels. Text is not truncated by
+ * default.
+ */
+declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLSpanElement>>;
+declare const privacyLevelOptions: readonly ["private", "organization", "public"];
+type PrivacyLevel = (typeof privacyLevelOptions)[number];
+interface PrivacyLabelProps extends React.HTMLAttributes<HTMLSpanElement> {
+    privacy: PrivacyLevel;
+    /**
+     * `text` (default) renders simple inline text — for specs that ask for plain
+     * text rather than a tag. `tag` renders the chip treatment.
+     */
+    appearance?: "text" | "tag";
+    label?: React.ReactNode;
+    icon?: React.ReactNode;
+}
+/**
+ * Privacy indicator. Defaults to plain text so it never looks like a tag unless
+ * the spec calls for the chip (`appearance="tag"`).
+ */
+declare const PrivacyLabel: React.ForwardRefExoticComponent<PrivacyLabelProps & React.RefAttributes<HTMLSpanElement>>;
+
+declare const templateCardLayoutOptions: readonly ["card", "list"];
+type TemplateCardLayout = (typeof templateCardLayoutOptions)[number];
+declare const templateCardFavoriteDisplayOptions: readonly ["action", "inline"];
+type TemplateCardFavoriteDisplay = (typeof templateCardFavoriteDisplayOptions)[number];
+declare const templateCardMetaPlacementOptions: readonly ["block", "inline"];
+type TemplateCardMetaPlacement = (typeof templateCardMetaPlacementOptions)[number];
+interface TemplateCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    title: React.ReactNode;
+    description?: React.ReactNode;
+    /** Secondary metadata row (tags, author, updated-at…). */
+    meta?: React.ReactNode;
+    layout?: TemplateCardLayout;
+    selected?: boolean;
+    favorited?: boolean;
+    onToggleFavorite?: () => void;
+    favoriteLabel?: string;
+    /** Overflow menu trigger (e.g. a Dropdown). Rendered next to favorite. */
+    overflow?: React.ReactNode;
+    /**
+     * Renders a leading selection checkbox and makes the whole card a single
+     * toggle target. Use for multi-select pickers.
+     */
+    selectable?: boolean;
+    /** Fired when the row (or its checkbox) is toggled. Requires `selectable`. */
+    onSelectedChange?: (selected: boolean) => void;
+    /** Accessible name for the leading checkbox. Default: "Selecionar". */
+    selectLabel?: string;
+    /**
+     * Renders the favorite as a static inline star *before the title* instead of
+     * the trailing IconButton toggle. The star is filled when `favorited` and
+     * hidden otherwise. Use when favorite is a read-only indicator, not an action.
+     */
+    favoriteDisplay?: TemplateCardFavoriteDisplay;
+    /**
+     * Renders `meta` inline on the title row (right after the title) instead of
+     * the default block below it. Use for a single short tag.
+     */
+    metaPlacement?: TemplateCardMetaPlacement;
+}
+/**
+ * Template card / list item.
+ *
+ * - Title uses a semibold typography treatment.
+ * - In the list layout the description uses a smaller type ramp.
+ * - The favorite and overflow actions sit in a tight, tokenized cluster so they
+ *   never drift apart, and the action column is `shrink-0` so long titles wrap
+ *   instead of colliding with the actions.
+ */
+declare const TemplateCard: React.ForwardRefExoticComponent<TemplateCardProps & React.RefAttributes<HTMLDivElement>>;
+declare const TemplateListItem: React.ForwardRefExoticComponent<Omit<TemplateCardProps, "layout"> & React.RefAttributes<HTMLDivElement>>;
+
 interface TabsItem {
     value: string;
     label: React.ReactNode;
@@ -772,9 +1098,11 @@ declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.Re
 type TextSize = SofyaTextStyleName;
 type TextWeight = React.CSSProperties["fontWeight"];
 type TextVariant = "default" | "gradient" | "shiny" | "split";
+type TextTone = "default" | "soft" | "subtle";
 type TextSplitType = "chars" | "words" | "words, chars";
 declare const textSizeOptions: readonly ["display-xl", "display-lg", "heading-xl", "heading-lg", "heading-md", "h1", "h2", "h3", "h4", "h5", "encounter-title", "title-md", "title-sm", "body-lg", "body-md", "body-sm", "body", "label-md", "section-label", "eyebrow-md", "overline-md", "sidebar-title", "sidebar-title-regular", "sidebar-title-strong", "sidebar-label", "sidebar-label-strong", "sidebar-body", "sidebar-tag", "encounter-chip", "encounter-history", "caption", "eyebrow", "tiny", "extra-tiny", "code-sm"];
 declare const textVariantOptions: readonly ["default", "gradient", "shiny", "split"];
+declare const textToneOptions: readonly ["default", "soft", "subtle"];
 declare const textSplitTypeOptions: readonly ["chars", "words", "words, chars"];
 interface TextProps extends React.HTMLAttributes<HTMLElement> {
     as?: React.ElementType;
@@ -784,13 +1112,14 @@ interface TextProps extends React.HTMLAttributes<HTMLElement> {
     splitRootMargin?: string;
     splitThreshold?: number;
     splitType?: TextSplitType;
+    tone?: TextTone;
     variant?: TextVariant;
     weight?: TextWeight;
 }
 declare function isTextContent(children: React.ReactNode): children is string | number;
-type RenderTextContentOptions = Pick<TextProps, "as" | "className" | "size" | "style" | "variant" | "weight">;
+type RenderTextContentOptions = Pick<TextProps, "as" | "className" | "size" | "style" | "tone" | "variant" | "weight">;
 declare const Text: React.ForwardRefExoticComponent<TextProps & React.RefAttributes<HTMLElement>>;
-declare function renderTextContent(children: React.ReactNode, { as, className, size, style, variant, weight }?: RenderTextContentOptions): bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+declare function renderTextContent(children: React.ReactNode, { as, className, size, style, tone, variant, weight }?: RenderTextContentOptions): bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 
 interface ToggleProps extends React.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root> {
     containerClassName?: string;
@@ -801,15 +1130,10 @@ interface ToggleProps extends React.ComponentPropsWithoutRef<typeof SwitchPrimit
 }
 declare const Toggle: React.ForwardRefExoticComponent<ToggleProps & React.RefAttributes<HTMLButtonElement>>;
 
-declare const TooltipProvider: React.FC<TooltipPrimitive.TooltipProviderProps>;
-declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
-declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-
 interface SofyaProviderProps extends React.HTMLAttributes<HTMLDivElement> {
     preset?: ThemePresetName | SofyaTheme;
     overrides?: DeepPartial<SofyaTheme>;
 }
 declare function SofyaProvider({ preset, overrides, className, style, children, ...props }: SofyaProviderProps): react_jsx_runtime.JSX.Element;
 
-export { Accordion, type AccordionAppearance, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, type AlertProps, type AlertSize, AlertTitle, type AlertTone, Avatar, type AvatarProps, Badge, type BadgeAlert, type BadgePillTone, type BadgeProps, type BadgeVariant, Button, type ButtonLanguageLocale, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, Cluster, type ClusterProps, Container, type ContainerProps, Dialog, DialogBody, DialogCancel, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DocumentCard, type DocumentCardProps, Dropdown, type DropdownAppearance, type DropdownItem, type DropdownProps, DropdownSearch, type DropdownSearchOption, type DropdownSearchProps, type DropdownSubItem, type DropdownTriggerSize, type DropdownVariant, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, type EmptyMediaProps, type EmptyProps, EmptyTitle, Icon, type IconColor, type IconName, type IconProps, type IconSize, Inline, type InlineProps, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, type InputVariant, Label, Link, type LinkProps, Logo, type LogoProps, type LogoSize, type LogoVariant, type NotificationVariant, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverDescription, PopoverPortal, PopoverTitle, PopoverTrigger, Progress, type ProgressProps, type ProgressSize, ProseDialogBody, ProseDialogContent, type ProseDialogContentProps, ProseDialogDescription, ProseDialogHeader, ProseDialogTitle, RadioGroup, RadioGroupItem, type RadioGroupItemProps, RadioGroupOption, RadioGroupOptionAvatar, type RadioGroupOptionAvatarProps, RadioGroupOptionDescription, type RadioGroupOptionDescriptionProps, RadioGroupOptionIndicator, type RadioGroupOptionIndicatorProps, RadioGroupOptionLabel, type RadioGroupOptionLabelProps, type RadioGroupOptionProps, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupVariant, RightRailAction, type RightRailActionProps, ScrollArea, ScrollAreaCorner, type ScrollAreaOrientation, ScrollAreaScrollbar, type ScrollAreaScrollbarProps, ScrollAreaViewport, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSize, SelectTrigger, SelectValue, Separator, Skeleton, type SkeletonProps, Slider, type SliderProps, SofyaProvider, type SofyaProviderProps, Spinner, type SpinnerProps, type SpinnerSize, Stack, type StackProps, Surface, type SurfaceVariant, Switch, type SwitchProps, type SwitchSize, Table, TableActionButton, type TableActionButtonProps, TableActions, TableBody, TableCaption, TableCell, TableCellDescription, type TableCellDescriptionProps, type TableCellProps, TableCellTitle, type TableCellTitleProps, type TableDensity, TableFooter, TableHead, TableHeader, type TableProps, TableRow, type TableRowProps, TableStatusBadge, type TableStatusBadgeProps, type TableTextSize, Tabs, type TabsItem, type TabsProps, Text, type TextProps, type TextSize, type TextSplitType, type TextVariant, type TextWeight, Textarea, type TextareaProps, Toaster, type ToasterProps, Toggle, type ToggleProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UploadKind, accordionAppearanceOptions, alertSizeOptions, alertToneOptions, avatarSizeOptions, avatarVariants, badgeAlertOptions, badgeAlertVariants, badgePillToneOptions, badgePillVariants, badgeVariantOptions, badgeVariants, buttonLanguageLocaleOptions, buttonSizeOptions, buttonVariantOptions, buttonVariants, cardVariants, dropdownAppearanceOptions, dropdownLanguageItems, dropdownTriggerSizeOptions, dropdownVariantOptions, emptyMediaVariantOptions, iconColorOptions, iconNames, iconSizeMap, iconSizeOptions, inputVariantOptions, isTextContent, logoSizeOptions, logoVariants, notificationVariantOptions, paginationLinkVariants, progressSizeOptions, radioGroupOrientationOptions, radioGroupVariantOptions, renderTextContent, scrollAreaOrientationOptions, selectSizeOptions, spinnerSizeOptions, surfaceVariantOptions, switchSizeOptions, tableActionToneOptions, tableCellVariantOptions, tableDensityOptions, tableStatusToneOptions, textSizeOptions, textSplitTypeOptions, textVariantOptions, uploadKindOptions };
+export { Accordion, type AccordionAppearance, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, type AlertProps, type AlertSize, AlertTitle, type AlertTone, Avatar, type AvatarProps, Badge, type BadgeAlert, type BadgePillTone, type BadgeProps, type BadgeVariant, Button, type ButtonLanguageLocale, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, CloseButton, type CloseButtonProps, Cluster, type ClusterProps, Container, type ContainerProps, Dialog, DialogBody, DialogCancel, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DocumentCard, type DocumentCardProps, Dropdown, type DropdownAppearance, type DropdownItem, type DropdownProps, DropdownSearch, type DropdownSearchOption, type DropdownSearchProps, type DropdownSubItem, type DropdownTriggerSize, type DropdownVariant, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, type EmptyMediaProps, type EmptyProps, EmptyTitle, Icon, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonVariant, type IconColor, type IconName, type IconProps, type IconSize, Inline, type InlineProps, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, type InputVariant, Label, Link, type LinkProps, Logo, type LogoProps, type LogoSize, type LogoVariant, type NotificationVariant, type NotifyOptions, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverClose, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverPortal, PopoverTitle, PopoverTrigger, PrivacyLabel, type PrivacyLabelProps, type PrivacyLevel, Progress, type ProgressProps, type ProgressSize, ProseDialogBody, ProseDialogContent, type ProseDialogContentProps, ProseDialogDescription, ProseDialogHeader, ProseDialogTitle, RadioGroup, RadioGroupItem, type RadioGroupItemProps, RadioGroupOption, RadioGroupOptionAvatar, type RadioGroupOptionAvatarProps, RadioGroupOptionDescription, type RadioGroupOptionDescriptionProps, RadioGroupOptionIndicator, type RadioGroupOptionIndicatorProps, RadioGroupOptionLabel, type RadioGroupOptionLabelProps, type RadioGroupOptionProps, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupVariant, RichTextToolbar, RichTextToolbarButton, type RichTextToolbarButtonProps, RichTextToolbarGroup, type RichTextToolbarProps, RichTextToolbarSeparator, RightRailAction, type RightRailActionProps, ScrollArea, ScrollAreaCorner, type ScrollAreaOrientation, ScrollAreaScrollbar, type ScrollAreaScrollbarProps, ScrollAreaViewport, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSize, SelectTrigger, SelectValue, Separator, SettingsNavItem, SidebarNavItem, type SidebarNavItemProps, Skeleton, type SkeletonProps, Slider, type SliderProps, SofyaProvider, type SofyaProviderProps, Spinner, type SpinnerProps, type SpinnerSize, Stack, type StackProps, StatusIndicator, type StatusIndicatorProps, StatusTooltip, type StatusTooltipProps, Surface, type SurfaceVariant, Switch, type SwitchProps, type SwitchSize, Table, TableActionButton, type TableActionButtonProps, TableActions, TableBody, TableCaption, TableCell, TableCellDescription, type TableCellDescriptionProps, type TableCellProps, TableCellTitle, type TableCellTitleProps, type TableDensity, TableFooter, TableHead, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, TableStatusBadge, type TableStatusBadgeProps, type TableTextSize, Tabs, type TabsItem, type TabsProps, Tag, type TagProps, type TagStatusTone, type TagVariant, TemplateCard, type TemplateCardFavoriteDisplay, type TemplateCardLayout, type TemplateCardMetaPlacement, type TemplateCardProps, TemplateListItem, Text, type TextProps, type TextSize, type TextSplitType, type TextTone, type TextVariant, type TextWeight, Textarea, type TextareaProps, Toaster, type ToasterProps, Toggle, type ToggleProps, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, type TooltipTone, TooltipTrigger, type UploadKind, type WorkflowStatus, type WorkflowStatusDescriptor, accordionAppearanceOptions, alertSizeOptions, alertToneOptions, avatarSizeOptions, avatarVariants, badgeAlertOptions, badgeAlertVariants, badgePillToneOptions, badgePillVariants, badgeVariantOptions, badgeVariants, buttonLanguageLocaleOptions, buttonSizeOptions, buttonVariantOptions, buttonVariants, cardVariants, dropdownAppearanceOptions, dropdownLanguageItems, dropdownTriggerSizeOptions, dropdownVariantOptions, emptyMediaVariantOptions, iconButtonSizeOptions, iconButtonVariantOptions, iconColorOptions, iconNames, iconSizeMap, iconSizeOptions, inputVariantOptions, isTextContent, logoSizeOptions, logoVariants, notificationVariantOptions, notify, paginationLinkVariants, privacyLevelOptions, progressSizeOptions, radioGroupOrientationOptions, radioGroupVariantOptions, renderTextContent, resolveWorkflowStatus, scrollAreaOrientationOptions, selectSizeOptions, spinnerSizeOptions, surfaceVariantOptions, switchSizeOptions, tableActionToneOptions, tableCellVariantOptions, tableDensityOptions, tableStatusToneOptions, tagStatusToneOptions, tagVariantOptions, templateCardFavoriteDisplayOptions, templateCardLayoutOptions, templateCardMetaPlacementOptions, textSizeOptions, textSplitTypeOptions, textToneOptions, textVariantOptions, tooltipToneOptions, uploadKindOptions, workflowStatusOptions };