themelia-react-ui 1.0.1 → 2.0.0

package/dist/components/base/sheet/index.d.ts

@@ -1 +1,29 @@
-export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetBody, SheetFooter, SheetTitle, SheetDescription, } from './sheet';
+/**
+ * Deprecated compatibility entrypoint.
+ *
+ * `ActionDrawer` from `themelia-react-ui/features/overlays` is the supported
+ * slide-in panel: it owns the scrim, focus, dismissal, pending lock and action
+ * footer, and `ActionDialog` / `ConfirmDialog` cover centred dialogs. These
+ * parts remain the internal anatomy behind ActionDrawer and the mobile sidebar
+ * drawer, which import the implementation module directly. They keep working
+ * through 1.x for existing callers.
+ */
+export { 
+/** @deprecated Use `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns open state through `open`/`onOpenChange` or `trigger`. */
+Sheet, 
+/** @deprecated Use the `trigger` prop of `ActionDrawer` from `themelia-react-ui/features/overlays`, or `useOverlayVisibility` for an external control. */
+SheetTrigger, 
+/** @deprecated `ActionDrawer` from `themelia-react-ui/features/overlays` renders its own dismiss control (`showCloseButton`) and cancel action. */
+SheetClose, 
+/** @deprecated Use `ActionDrawer` from `themelia-react-ui/features/overlays` (`direction`, `width`, `modal`). */
+SheetContent, 
+/** @deprecated Use the `title`/`description` props of `ActionDrawer` from `themelia-react-ui/features/overlays`. */
+SheetHeader, 
+/** @deprecated Pass content as `children` of `ActionDrawer` from `themelia-react-ui/features/overlays`; it owns the scrolling body. */
+SheetBody, 
+/** @deprecated Use the generated actions or the `footer` prop of `ActionDrawer` from `themelia-react-ui/features/overlays`. */
+SheetFooter, 
+/** @deprecated Use the `title` prop of `ActionDrawer` from `themelia-react-ui/features/overlays`. */
+SheetTitle, 
+/** @deprecated Use the `description` prop of `ActionDrawer` from `themelia-react-ui/features/overlays`. */
+SheetDescription, } from './sheet';

package/dist/components/base/sheet/sheet.d.ts

@@ -1,10 +1,15 @@
 import type { TextGap } from '../structure';
 /**
- * Sheet — design-system wrapper around the shadcn compound primitive.
+ * Sheet — internal edge-anchored modal anatomy behind `ActionDrawer` and the
+ * mobile sidebar drawer.
  *
- * The root and trigger behavior stay primitive-compatible. The package layer
- * adds a deliberate header / scrollable body / footer structure, calm admin
- * spacing, and stable BEM hooks without narrowing primitive props.
+ * Applications use `ActionDrawer` from `themelia-react-ui/features/overlays`,
+ * which owns the lifecycle, focus, dismissal and action contract; the
+ * `themelia-react-ui/base/sheet` entrypoint remains only as a deprecated
+ * compatibility surface. The panel shares the modal geometry of the internal
+ * Dialog wrapper: the shell owns the block inset and the gap between header,
+ * scrolling body and footer, regions own their inline inset, and one edge rule
+ * separates the panel from the page.
  */
 import * as React from 'react';
 import { Sheet as SheetPrimitive } from '../../ui/sheet';
@@ -24,7 +29,11 @@ export declare const SheetContent: React.ForwardRefExoticComponent<Omit<import("
 export declare const SheetHeader: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement>, "ref"> & {
     textGap?: TextGap;
 } & React.RefAttributes<HTMLDivElement>>;
-/** Scroll-owning content region between the fixed sheet header and footer. */
+/**
+ * Scroll-owning content region between the pinned sheet header and footer.
+ * A rule appears on its top or bottom edge only while content is scrolled out
+ * of view there.
+ */
 export declare const SheetBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 export declare const SheetFooter: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export declare const SheetTitle: React.ForwardRefExoticComponent<Omit<import("@base-ui/react").AlertDialogTitleProps & {

package/dist/components/base/spinner/spinner.d.ts

@@ -20,10 +20,11 @@ export interface SpinnerStrings {
 }
 export declare const defaultSpinnerStrings: SpinnerStrings;
 export interface SpinnerProps {
-    /** Display label. */
+    /** Visible label under the indicator; also its accessible name. */
     label?: string;
+    /** Merged onto the indicator graphic (size, colour), not the padded wrapper. */
     className?: string;
-    /** Semantic tone. */
+    /** Indicator style: circular `default`, `shimmer`, or `progress` strip. Defaults to `UIProvider.spinner.defaultVariant`, then `default`. */
     variant?: SpinnerVariant;
     /** Localizes the fallback progress-bar name. */
     strings?: StringsProp<SpinnerStrings>;

package/dist/components/base/structure/structure.types.d.ts

@@ -3,7 +3,7 @@ import type { ComponentScale } from '../../../lib/component-vocabulary';
 export type StructureBreakpoint = 'base' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 export type ResponsiveValue<T> = T | Partial<Record<StructureBreakpoint, T>>;
 export type TextGap = 'normal' | 'dense';
-export type StructureGap = TextGap | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+export type StructureGap = TextGap | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 export type StructureAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
 export type StructureJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
 export interface StackProps extends useRender.ComponentProps<'div'> {

package/dist/components/base/table/index.d.ts

@@ -8,7 +8,7 @@ export type TableRowProps = React.ComponentProps<typeof UITableRow>;
 export type TableHeadProps = React.ComponentProps<typeof UITableHead>;
 export type TableCellProps = React.ComponentProps<typeof UITableCell>;
 export type TableCaptionProps = React.ComponentProps<typeof UITableCaption>;
-export declare function Table({ className, containerClassName, ...props }: TableProps): React.JSX.Element;
+export declare function Table({ className, containerClassName, containerProps, ...props }: TableProps): React.JSX.Element;
 export declare function TableHeader({ className, ...props }: TableHeaderProps): React.JSX.Element;
 export declare function TableBody({ className, ...props }: TableBodyProps): React.JSX.Element;
 export declare function TableFooter({ className, ...props }: TableFooterProps): React.JSX.Element;

package/dist/components/base/text-inputs/clear-native-field.d.ts

@@ -0,0 +1,2 @@
+/** Route inline clearing through the field's existing native change handler. */
+export declare function clearNativeField(field: HTMLInputElement | HTMLTextAreaElement): void;

package/dist/components/base/text-inputs/input-group.d.ts

@@ -35,8 +35,8 @@ export type InputGroupTextareaProps = ComponentProps<typeof InputGroupTextareaPr
 declare function InputGroup({ className, ...props }: InputGroupProps): import("react").JSX.Element;
 /** Leading/trailing (or block start/end) affordance slot inside the frame. */
 declare function InputGroupAddon({ className, align, ...props }: InputGroupAddonProps): import("react").JSX.Element;
-/** Inline action button sized to sit inside the control frame. */
-declare function InputGroupButton({ className, tone, buttonStyle, ...props }: InputGroupButtonProps): import("react").JSX.Element;
+/** Inline action button sized to sit inside the control frame; its label stays on one line. */
+declare function InputGroupButton({ className, tone, buttonStyle, truncate, ...props }: InputGroupButtonProps): import("react").JSX.Element;
 /** Static copy segment — scalar text renders through Typography. */
 declare function InputGroupText({ children, className, ...props }: InputGroupTextProps): import("react").JSX.Element;
 /** Single-line control that inherits the group's frame instead of its own. */

package/dist/components/base/text-inputs/input-trailing-action.d.ts

@@ -0,0 +1,3 @@
+import { type ReactNode } from 'react';
+/** Private composition seam: the Input owner lays out PasswordInput's action. */
+export declare const InputTrailingActionContext: import("react").Context<ReactNode>;

package/dist/components/base/upload/upload.recipes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Private drop-target states shared by Dropzone, AvatarUpload and ImageUpload.
+ * An empty target draws the dashed `--input` control boundary (3:1 on every
+ * surface), so all three upload targets read as the same kind of control.
+ * Hover, drag and invalid states replace only the boundary colour and fill.
+ */
+export declare const uploadDropTargetRecipes: {
+    readonly idle: "border-input";
+    readonly invalid: "border-destructive";
+    readonly dragging: "border-primary bg-primary/10";
+};

package/dist/components/base/value-inputs/date-time-input.d.ts

@@ -7,13 +7,15 @@ export interface DateTimeInputProps {
     placeholder?: string;
     /** Display format for the date */
     readableFormat?: string;
-    /** Step for time selection in minutes */
+    /** Step for time selection, in minutes. Default `30`. */
     stepMinutes?: number;
     /** Use modal for picker */
     modal?: boolean;
-    /** Error state for styling (passed from FormField) */
+    /** Error state for styling (passed from FormField). Validation copy stays with FormField. */
     invalid?: boolean;
     /** Disabled state */
     disabled?: boolean;
+    /** Id of the trigger, so an external `<FormField label>` names it. Defaults to a generated id. */
+    id?: string;
 }
 export declare const DateTimeInput: import("react").ForwardRefExoticComponent<DateTimeInputProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/base/value-inputs/tags-input.d.ts

@@ -8,6 +8,8 @@ export interface TagsInputStrings {
      *  `current` (number of tags entered) and `max` (the limit). The
      *  default is English `"{current} / {max} tags"` — override for i18n. */
     summary: (current: number, max: number) => string;
+    /** Accessible name of a tag's remove action. Defaults to `"Remove {tag}"`. */
+    removeTag?: (tag: string) => string;
 }
 export declare const defaultTagsInputStrings: TagsInputStrings;
 export interface TagsInputProps<T = string> {

package/dist/components/blocks/admin/api-key-list/api-key-list.types.d.ts

@@ -23,7 +23,7 @@ export interface ApiKeyListItem {
      * full secret.
      */
     displayValue?: string;
-    /** Optional per-item icon override (defaults to a Lock). */
+    /** Optional per-item leading icon. Rows render without one by default. */
     icon?: ReactNode;
     /** Disable the per-item dropdown when true. */
     disabled?: boolean;

package/dist/components/blocks/analytics/format-metric-value.d.ts

@@ -1,5 +1,15 @@
+import type { MoneyFormatMode } from '../../../lib/ui-provider';
 import type { MetricData } from './types';
-export declare function formatMetricValue(data: MetricData): string;
+/** Display policy that metric components resolve from UIProvider. */
+export interface FormatMetricValueOptions {
+    /** BCP-47 locale. Metric components pass `UIProvider.formatting.locale`. */
+    locale?: string;
+    /** Currency used when the metric has none. Defaults to `USD`, like UIProvider. */
+    defaultCurrency?: string;
+    /** Money format policy. Defaults to `with_code`, like UIProvider. */
+    moneyFormatMode?: MoneyFormatMode;
+}
+export declare function formatMetricValue(data: MetricData, options?: FormatMetricValueOptions): string;
 /**
  * Resolve the effective `MetricTrend` for a metric — explicit `trend` wins,
  * otherwise we infer from `change.direction` (`up` → positive, `down` →

package/dist/components/blocks/analytics/index.d.ts

@@ -19,7 +19,7 @@
  */
 export type { MetricChange, MetricColorScheme, MetricData, MetricDataPoint, MetricDirection, MetricPeriod, MetricSize, MetricTrend, MetricTrendVariant, MetricValueType, MetricVariant, } from './types';
 export { defaultAnalyticsStrings, type AnalyticsStrings, } from './analytics.strings';
-export { formatMetricValue, resolveTrend } from './format-metric-value';
+export { formatMetricValue, resolveTrend, type FormatMetricValueOptions } from './format-metric-value';
 export { MetricTrendChip, type MetricTrendChipProps } from './atoms/metric-trend-chip';
 export { MetricSparkline, type MetricSparklineProps } from './atoms/metric-sparkline';
 export { MetricSkeleton, type MetricSkeletonProps } from './atoms/metric-skeleton';

package/dist/components/blocks/analytics/types.d.ts

@@ -21,7 +21,7 @@ export type MetricColorScheme = 'default' | 'primary' | 'success' | 'warning' |
 export type MetricVariant = 
 /** Default tile — label, value, optional sparkline / trend chip / footer. */
 'default'
-/** Standalone metric using the canonical SmartCard surface. */
+/** Standalone metric using the canonical Card surface. */
  | 'card'
 /** Single-row icon + label + value + change chip. Compact list/sidebar use. */
  | 'compact'

package/dist/components/blocks/analytics/use-metric-format-options.d.ts

@@ -0,0 +1,3 @@
+import type { FormatMetricValueOptions } from './format-metric-value';
+/** Metric formatting policy from UIProvider: locale, default currency and money format. */
+export declare function useMetricFormatOptions(): FormatMetricValueOptions;

package/dist/components/blocks/collaboration/message/message.recipes.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react';
+/** Obvious empty slot values have no media track; rich React nodes remain untouched. */
+export declare function hasMessageMedia(media: ReactNode): boolean;
+/** Transcript rows and their continuation regions share the actual media track. */
+export declare const messageColumns: {
+    readonly start: "grid-cols-[auto_minmax(0,1fr)]";
+    readonly end: "grid-cols-[minmax(0,1fr)_auto]";
+};
+export declare const messageContentColumn: {
+    readonly start: "col-start-2";
+    readonly end: "col-start-1";
+};

package/dist/components/blocks/commerce/address-card/address-card.d.ts

@@ -1,5 +1,5 @@
 import { type AddressCardProps } from './types';
-export declare function AddressCard({ kind, name, line1, line2, city, region, postalCode, country, phone, default: defaultAddress, onEdit, onRemove, onMakeDefault, className, strings: stringsProp, }: AddressCardProps): import("react").JSX.Element;
+export declare function AddressCard({ kind, name, line1, line2, city, region, postalCode, country, phone, default: defaultAddress, onEdit, onRemove, onMakeDefault, surface, padding, headerDivider, className, strings: stringsProp, }: AddressCardProps): import("react").JSX.Element;
 export declare namespace AddressCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/address-card/types.d.ts

@@ -1,3 +1,4 @@
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type AddressKind = 'shipping' | 'billing' | 'pickup';
 export interface AddressCardStrings {
@@ -10,7 +11,8 @@ export interface AddressCardStrings {
     pickup: string;
 }
 export declare const defaultAddressCardStrings: AddressCardStrings;
-export interface AddressCardProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface AddressCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** What the address is for — billing, shipping, or both. */
     kind?: AddressKind;
     /** Display name. */

package/dist/components/blocks/commerce/booking-calendar-event-card/booking-calendar-event-card.d.ts

@@ -2,6 +2,10 @@ import type { BookingCalendarEventCardProps } from './booking-calendar-event-car
 /**
  * Compact, card-free booking detail composition.
  *
+ * The status sits beside the title, the facts share one label-above-value
+ * layout, and spacing alone separates them from the action: no header rule,
+ * no inset note panel and no rule above the action.
+ *
  * All visible copy is supplied by props, so this component intentionally has
  * no strings file. Frame it with `Card` only when the page needs card
  * chrome.

package/dist/components/blocks/commerce/booking-calendar-event-card/booking-calendar-event-card.types.d.ts

@@ -7,7 +7,7 @@ export interface BookingCalendarEventCardItem {
     label: ReactNode;
     /** Display value. Strings and numbers use the canonical `Value` primitive. */
     value: ReactNode;
-    /** Span both detail columns and receive the emphasized note treatment. */
+    /** Span both detail columns, for a note that should not sit in a column. */
     fullWidth?: boolean;
 }
 /**
@@ -21,7 +21,7 @@ export interface BookingCalendarEventCardProps {
     title: ReactNode;
     /** Optional supporting context shown beneath the title. */
     description?: ReactNode;
-    /** Optional status or metadata rendered at the end of the header. */
+    /** Optional status, rendered beside the title. */
     status?: ReactNode;
     /** Ordered booking facts rendered as a responsive definition list. */
     items: BookingCalendarEventCardItem[];

package/dist/components/blocks/commerce/discount-stack/types.d.ts

@@ -5,7 +5,7 @@ export interface Discount {
     /** Display label. */
     label: string;
     amount: string;
-    /** Chip rendered beside the label. */
+    /** Tone of the type chip. Discount types are kinds, so pass `neutral` unless the chip states a status. */
     badge: BadgeTone;
 }
 export interface DiscountStackStrings {

package/dist/components/blocks/commerce/inventory-section/types.d.ts

@@ -36,7 +36,10 @@ export interface InventorySectionMetric {
     value: string;
     /** Supporting copy shown under the label. */
     description?: string;
-    /** Semantic tone driving the entry's colour. */
+    /**
+     * Semantic tone of the entry. Not rendered by the summary: stats are plain
+     * and the title badge carries the stock state. Kept for type compatibility.
+     */
     tone?: 'default' | 'success' | 'warning' | 'error' | 'info';
 }
 export interface InventorySectionStrings {

package/dist/components/blocks/commerce/loyalty-points/types.d.ts

@@ -20,7 +20,7 @@ export interface LoyaltyPointsProps {
     balance: number | string;
     /** Membership tier name. Defaults to `strings.tier`. */
     tier?: string;
-    /** Badge tone for the tier chip. @default 'warning' */
+    /** Badge tone for the tier chip. A tier is a kind, not a status. @default 'neutral' */
     tierTone?: BadgeTone;
     /** Recent point movements. */
     history?: LoyaltyHistoryEntry[];

package/dist/components/blocks/commerce/order-status/types.d.ts

@@ -11,9 +11,13 @@ export interface OrderStatusEvent {
 export interface OrderStatusStrings {
     /** Surface title. */
     title: string;
+    /** Not rendered: the title badge states the status. Kept for existing overrides. */
     statusLabel: string;
+    /** Label of the delivery-estimate fact. */
     eta: string;
+    /** Not rendered: the timeline shows the latest event. Kept for existing overrides. */
     latestEvent: string;
+    /** Not rendered: the timeline marks the current step. Kept for existing overrides. */
     currentStep: string;
 }
 export declare const defaultOrderStatusStrings: OrderStatusStrings;

package/dist/components/blocks/commerce/payment-method/payment-method.d.ts

@@ -1,5 +1,5 @@
 import { type PaymentMethodProps } from './types';
-export declare function PaymentMethod({ brand, last4, expiry, holderName, default: defaultMethod, onChange, className, strings: stringsProp, }: PaymentMethodProps): import("react").JSX.Element;
+export declare function PaymentMethod({ brand, last4, expiry, holderName, default: defaultMethod, onChange, surface, padding, headerDivider, className, strings: stringsProp, }: PaymentMethodProps): import("react").JSX.Element;
 export declare namespace PaymentMethod {
     var displayName: string;
 }

package/dist/components/blocks/commerce/payment-method/types.d.ts

@@ -1,3 +1,4 @@
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type PaymentBrand = 'visa' | 'mastercard' | 'amex' | 'paypal' | 'applepay' | 'googlepay' | 'unknown';
 export interface PaymentMethodStrings {
@@ -9,7 +10,8 @@ export interface PaymentMethodStrings {
     change: string;
 }
 export declare const defaultPaymentMethodStrings: PaymentMethodStrings;
-export interface PaymentMethodProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface PaymentMethodProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Card network or wallet. */
     brand: PaymentBrand;
     /** Last four digits, the only card number this component accepts. */

package/dist/components/blocks/commerce/seo-listing/seo-listing-card.d.ts

@@ -1,5 +1,5 @@
 import { type SeoListingCardProps } from './types';
-export declare function SeoListingCard({ siteName, baseUrl, pathSegments, permalink, title, description, price, keyword, score, limits, showChecks, onEdit, className, strings: stringsProp, }: SeoListingCardProps): import("react").JSX.Element;
+export declare function SeoListingCard({ siteName, baseUrl, pathSegments, permalink, title, description, price, keyword, score, limits, showChecks, onEdit, surface, padding, headerDivider, className, strings: stringsProp, }: SeoListingCardProps): import("react").JSX.Element;
 export declare namespace SeoListingCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/seo-listing/types.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type SeoListingCheckId = 'title' | 'description' | 'permalink' | 'slug' | 'url' | 'keyword';
 export type SeoListingCheckStatus = 'good' | 'review' | 'missing';
@@ -60,7 +61,8 @@ export interface SeoListingCardStrings {
     checkHints: Record<SeoListingCheckId, string>;
 }
 export declare const defaultSeoListingCardStrings: SeoListingCardStrings;
-export interface SeoListingCardProps {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface SeoListingCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Site name shown in the search preview. */
     siteName?: string;
     /** Origin the permalink is built on. */

package/dist/components/blocks/commerce/vendor-profile/types.d.ts

@@ -76,7 +76,10 @@ export interface VendorProfileCardProps {
     onMessage?: () => void;
     /** Shows the engagement action and delegates its behavior to the consumer. */
     onHire?: () => void;
-    /** Card surface override. Defaults through the shared SmartCard configuration. */
+    /**
+     * Card surface override. Defaults through the shared SmartCard configuration.
+     * `flat` also drops the dossier's own insets, so the embedding surface owns them.
+     */
     surface?: SmartCardSurface;
     /** Card density override. Defaults through the shared SmartCard configuration. */
     /** Additional classes applied to the outer SmartCard element. */

package/dist/components/blocks/data-display/dense-info-card/dense-info.strings.d.ts

@@ -1,6 +1,9 @@
 export interface DenseInfoStrings {
     /** Total number of records across all pages. */
     total: string;
+    /** Word after the task count ("12/20 tasks"). */
     tasks: string;
+    /** Word after the priority value ("High priority"). Additive, so optional for existing dictionaries. */
+    priority?: string;
 }
-export declare const defaultDenseInfoStrings: DenseInfoStrings;
+export declare const defaultDenseInfoStrings: Required<DenseInfoStrings>;

package/dist/components/blocks/data-display/empty-state/partials/illustrations/document-stack.d.ts

@@ -1,8 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Two staggered document silhouettes — for "no documents", "no
- * invoices", "no reports" surfaces.
- */
+/** Two staggered document silhouettes; all coordinates belong to the drawing. */
 export declare function DocumentStackIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace DocumentStackIllustration {
     var displayName: string;

package/dist/components/blocks/data-display/empty-state/partials/illustrations/inbox-clean.d.ts

@@ -1,8 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Open inbox tray with a soft check above — for "all caught up",
- * "no notifications", "inbox zero" surfaces.
- */
+/** Open inbox tray with a check; the scene has one intrinsic coordinate system. */
 export declare function InboxCleanIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace InboxCleanIllustration {
     var displayName: string;

package/dist/components/blocks/data-display/empty-state/partials/illustrations/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * Token-driven illustrations for `<EmptyState>`.
  *
- * Each illustration is a small composition of `bg-muted` /
- * `bg-background` / `border-border` divs (no raw palette colors), so it
- * adapts to the consumer's theme automatically. Use as the `media`
+ * Each illustration uses semantic theme colors for its HTML or SVG drawing,
+ * so it adapts to the consumer's theme automatically. Intrinsic drawing
+ * coordinates remain independent of UI spacing and density. Use as the `media`
  * prop of `<EmptyState>` — pick one per resource:
  *
  *     <EmptyState

package/dist/components/blocks/data-display/empty-state/partials/illustrations/stacked-cards.d.ts

@@ -1,10 +1,5 @@
 import type { EmptyStateIllustrationProps } from './types';
-/**
- * Three stacked card silhouettes with a fade-out at the bottom — the
- * generic "no records" illustration. Token-driven so it adapts to any
- * theme (uses `bg-muted`, `bg-background`, `border-border`, no raw
- * palette).
- */
+/** Three card silhouettes with a theme-backed fade; coordinates are drawing geometry. */
 export declare function StackedCardsIllustration({ className }: EmptyStateIllustrationProps): import("react").JSX.Element;
 export declare namespace StackedCardsIllustration {
     var displayName: string;

package/dist/components/blocks/data-display/inline-stat/inline-stat.d.ts

@@ -6,7 +6,10 @@
  *  - `inline`: label sits immediately before the value, separator-style.
  *  - `stacked`: label above (xs secondary), value below (md).
  *
- * `mono` toggles `tabular-nums` on the value side for amounts and counters.
+ * `mono` switches the value to the monospace identifier role (references,
+ * codes, keys). Amounts, counts, percentages and dates stay in the sans UI
+ * font: pass `valueClassName="tabular-nums"` (or a value primitive such as
+ * `Money` / `Percent`, which are already tabular) when figures should align.
  * Use `valueClassName` for one-off colour/weight overrides; the surrounding
  * row is intentionally plain so consumers can stack many of these without
  * visual clutter.

package/dist/components/features/combobox/components/error-message.d.ts

@@ -9,7 +9,7 @@ export interface ErrorMessageProps {
     size: ComboboxSize;
     className?: string;
 }
-export declare function ErrorMessage({ error, size, className, }: ErrorMessageProps): React.ReactElement | null;
+export declare function ErrorMessage({ error, size: _size, className, }: ErrorMessageProps): React.ReactElement | null;
 export declare namespace ErrorMessage {
     var displayName: string;
 }

package/dist/components/features/comments/hooks/use-attachment-upload.d.ts

@@ -1,3 +1,5 @@
+import { type StringsProp } from '../../../../lib/strings';
+import { type CommentsStrings } from '../comments.strings';
 import type { CommentAttachment, CommentsAttachmentsConfig } from '../comments.types';
 export interface UseAttachmentUploadOptions extends CommentsAttachmentsConfig {
     /** Initial attachments — useful when editing an existing comment. */
@@ -6,6 +8,9 @@ export interface UseAttachmentUploadOptions extends CommentsAttachmentsConfig {
     onValueChange?: (attachments: ReadonlyArray<CommentAttachment>) => void;
     /** Fires when a validation or upload error happens. */
     onError?: (error: string) => void;
+    /** Validation and non-Error upload fallback copy; omitted keys use Comments defaults.
+     * Error objects retain their caller-supplied message. */
+    strings?: StringsProp<Pick<CommentsStrings, 'attachmentTooLargeError' | 'attachmentTooManyError' | 'attachmentFailedLabel'>>;
 }
 export interface UseAttachmentUploadReturn {
     /** All attachments — uploading + uploaded + failed. */

package/dist/components/features/filters/facets/search-facet.d.ts

@@ -10,18 +10,6 @@ export interface SearchFacetProps {
     /** Merged onto the outermost node. */
     className?: string;
 }
-/**
- * Search Filter Facet
- *
- * This component implements a text search filter that allows users to:
- * - Enter search terms
- * - Configure search behavior (contains, equals, etc.)
- * - Set debounce delay for performance
- * - Customize placeholder text and appearance
- *
- * The component integrates with the filter context to manage the search value
- * and provides a responsive search input interface.
- */
 declare function SearchFacetComponent({ filter, value, onValueChange, className, }: SearchFacetProps): React.JSX.Element;
 export declare const SearchFacet: React.MemoExoticComponent<typeof SearchFacetComponent>;
 export {};

package/dist/components/features/filters/facets/tags-facet.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type FilterConfig } from '../filters.types';
+import type { FilterConfig } from '../filters.types';
 export interface TagsFacetProps {
     /** Definition of the filter this control edits. */
     filter: FilterConfig;

package/dist/components/features/global-search/partials/global-search-idle-state.d.ts

@@ -3,7 +3,7 @@ import type { GlobalSearchIdleSection } from '../global-search.types';
 export interface GlobalSearchIdleStateProps {
     /** Sections to render, in display order. */
     sections: ReadonlyArray<GlobalSearchIdleSection>;
-    /** Optional override for the heading icon when missing on a section. */
+    /** Optional heading icon used when a section supplies none. Headings carry no icon by default. */
     fallbackIcons?: {
         recent?: React.ElementType;
         suggestions?: React.ElementType;

package/dist/components/features/media-library/media-library.d.ts

@@ -1,3 +1,3 @@
 import type { MediaLibraryDialogProps, MediaLibraryProps } from './media-library.types';
-export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onUpload, onError, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryDialog<TItem = import('./media-library.types').MediaLibraryItem>({ open, onOpenChange, trigger, dialogTitle, dialogDescription, onClose, className, dialogClassName, contentClassName, closeOnEscape, closeOnBackdropClick, ...props }: MediaLibraryDialogProps<TItem>): import("react").JSX.Element;

package/dist/components/features/media-library/media-library.types.d.ts

@@ -114,7 +114,7 @@ export interface MediaLibraryAccessors<TItem = MediaLibraryItem> {
 export type ResolvedMediaLibraryAccessors<TItem = MediaLibraryItem> = Required<MediaLibraryAccessors<TItem>>;
 export interface MediaLibrarySlots<TItem = MediaLibraryItem> {
     headerStart?: ReactNode;
-    /** Content at the end of the header, before the overflow menu. */
+    /** Header controls beside the library/upload tabs. Put title status in `titleSuffix`. */
     headerEnd?: ReactNode;
     /** Content at the end of the toolbar row. */
     toolbarEnd?: ReactNode;
@@ -151,6 +151,8 @@ export interface MediaLibraryDetailRenderContext<TItem = MediaLibraryItem> {
     accessors: ResolvedMediaLibraryAccessors<TItem>;
     update: (patch: MediaLibraryItemPatch) => Promise<boolean>;
     remove: () => Promise<boolean>;
+    /** Requests the consumer's replacement workflow for this inspected item, when supported. */
+    replace?: () => void;
     close: () => void;
 }
 export interface MediaLibraryState<TItem = MediaLibraryItem> {
@@ -300,6 +302,10 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
 export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<ComponentPropsWithoutRef<'section'>, 'children' | 'defaultValue' | 'onError' | 'onSelect' | 'title'>, UseMediaLibraryOptions<TItem> {
     /** Heading above the browser. */
     title?: ReactNode;
+    /** Status, count, or version content directly after the title; header actions belong in `slots.headerEnd`. */
+    titleSuffix?: ReactNode;
+    /** Requests replacement of the inspected asset. The consumer owns file selection, persistence, identity, and refreshed `items`; omitted callbacks hide Replace file. */
+    onItemReplace?: (item: TItem) => void;
     /** Supporting line under the title. */
     description?: ReactNode;
     /** Copy for the confirm action. */
@@ -455,6 +461,8 @@ export interface MediaLibraryDetailPanelProps<TItem = MediaLibraryItem> {
     onUpdate: (patch: MediaLibraryItemPatch) => Promise<boolean>;
     /** Fired when an entry is removed. */
     onRemove: () => Promise<boolean>;
+    /** Opens the consumer-owned replacement workflow for the inspected item. */
+    onReplace?: () => void;
     /** Replaces the default detail rendering. */
     renderDetail?: MediaLibrarySlots<TItem>['renderDetail'];
 }

package/dist/components/features/media-library/partials/media-library-partials.d.ts

@@ -3,7 +3,7 @@ export declare function MediaLibraryEmptyState({ icon, title, description, actio
 export declare function MediaLibraryToolbar({ query, type, typeFilters, collection, sort, view, collections, strings, onQueryChange, onTypeChange, onCollectionChange, onSortChange, onViewChange, onClearFilters, toolbarEnd, }: MediaLibraryToolbarProps): import("react").JSX.Element;
 export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryList<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, }: MediaLibraryListProps<TItem>): import("react").JSX.Element;
-export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, onRemove, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
+export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, onRemove, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
 export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, strings, onFiles, onRemoveFile, onOptionsChange, empty, }: MediaLibraryUploadPanelProps): import("react").JSX.Element;
 export declare function MediaLibraryFooterSummary({ tab, selectedIds, selectionMode, stagedFiles, strings, onClearSelection, className, }: MediaLibraryFooterSummaryProps): import("react").JSX.Element;
 export declare function MediaLibraryFooterActions<TItem>({ tab, selectedItems, selectedIds, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onUpload, onCancelUpload, className, }: MediaLibraryFooterActionsProps<TItem>): import("react").JSX.Element;