themelia-react-ui 1.0.0 → 1.0.2

package/dist/components/base/inline-edit/inline-edit.recipes.d.ts

@@ -0,0 +1,6 @@
+/** Private field/action layout; geometry remains generated from shared roots. */
+export declare const inlineEditRecipes: {
+    readonly frame: "transition-[grid-template-columns,column-gap] duration-180 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none";
+    readonly closedColumns: "grid-cols-[minmax(0,1fr)_0px]";
+    readonly actionsTrack: "min-w-0 flex items-center justify-end overflow-hidden focus-within:overflow-visible transition-opacity duration-180 ease-[cubic-bezier(0.22,1,0.36,1)] motion-reduce:transition-none";
+};

package/dist/components/base/navigation/tabs.d.ts

@@ -1,11 +1,9 @@
 /**
  * Typography- and token-aware wrappers around the internal shadcn tabs parts.
  *
- * The shadcn source is left untouched, so its literal `gap-1.5 rounded-md px-2
- * py-1` reached consumers unchanged and opted tabs out of scoped `--space-scale`
- * and `--radius` overrides — the only interactive family in the package that
- * did. These wrappers restate the same values as tokens; `cn` merges them last,
- * so they win. Every value below is pixel-identical to the primitive's default.
+ * Raw anatomy and these wrappers share token-backed spacing. The wrappers
+ * add stable public hooks, canonical corners, scalar text and scroll controls;
+ * the primitive owns tab/list interaction and the nested list inset.
  */
 import type { ComponentProps } from 'react';
 import { Tabs as PrimitiveTabs, TabsContent as PrimitiveTabsContent, TabsList as PrimitiveTabsList, TabsTrigger as PrimitiveTabsTrigger } from '../../ui/tabs';

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

@@ -1,12 +1,12 @@
 import { type RowDensity } from '../../../lib/row-recipes';
 /** Shared anchored-surface chrome; Menu and Popover retain their own accessible behavior. */
 export declare const popoverRecipes: {
-    readonly surface: "rounded-radius border border-border/60 bg-popover text-popover-foreground shadow-md ring-0";
+    readonly surface: "box-border rounded-radius border border-border bg-popover text-popover-foreground shadow-md ring-0";
     readonly display: "p-surface";
     readonly menu: "p-surface-xs";
     readonly menuRegion: "px-surface-xs py-space-md";
     readonly separator: "mx-0 my-space-xs h-px w-full shrink-0 bg-border/60";
-    readonly row: "min-h-control rounded-inner px-row-x gap-space-sm font-medium leading-tight";
+    readonly row: "box-border min-h-control rounded-inner px-row-x gap-space-sm font-medium leading-tight";
 };
 export type PopoverContentType = 'display' | 'menu';
 /** One surface inset vocabulary for Popover, Command and their collections. */
@@ -24,6 +24,6 @@ export declare const collectionRecipes: {
     readonly interactive: "relative flex cursor-default items-center outline-none select-none transition-colors";
     readonly highlighted: "data-highlighted:bg-accent data-highlighted:text-accent-foreground data-highlighted:[&_svg]:text-accent-foreground";
     readonly disabled: "data-disabled:pointer-events-none data-disabled:opacity-50";
-    readonly destructive: "data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/20 data-[variant=destructive]:[&_svg]:text-destructive data-[variant=destructive]:data-highlighted:[&_svg]:text-destructive";
+    readonly destructive: "data-[variant=destructive]:text-destructive data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive dark:data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:[&_svg]:text-destructive data-[variant=destructive]:data-highlighted:[&_svg]:text-destructive";
     readonly tableRow: "min-h-action-xs py-space-2xs";
 };

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

@@ -1,4 +1,10 @@
 import type { AdaptiveGridMinimum, GridColumnLadder, ResponsiveValue, StructureAlign, StructureGap, StructureJustify } from './structure.types';
+/** Shared region/peer rhythm for structures and composed surface owners. */
+export declare function gapRecipe({ gap, rowGap, columnGap, }: {
+    gap?: ResponsiveValue<StructureGap>;
+    rowGap?: ResponsiveValue<StructureGap>;
+    columnGap?: ResponsiveValue<StructureGap>;
+}): string[];
 export declare function stackRecipe({ direction, gap, align, justify, wrap, }: {
     direction?: ResponsiveValue<'vertical' | 'horizontal'>;
     gap?: ResponsiveValue<StructureGap>;

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-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/blocks/analytics/index.d.ts

@@ -32,3 +32,4 @@ export { MetricGradient, type MetricGradientProps, type MetricGradientTheme, } f
 export { ActivityHeatmap, type ActivityHeatmapDay, type ActivityHeatmapProps, type ActivityHeatmapStrings, type ActivityLevel, } from './activity-heatmap';
 export { ChartCard, type ChartCardProps } from './chart-card';
 export { TimeDistributionRuler, defaultTimeDistributionRulerStrings, type TimeDistributionRulerProps, type TimeDistributionRulerStrings, } from './time-ruler';
+export * from './usage-card';

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/usage-card/index.d.ts

@@ -0,0 +1,3 @@
+export { UsageCard } from './usage-card';
+export { defaultUsageCardStrings, type UsageCardStrings } from './usage-card.strings';
+export type { UsageCardProps, UsageCardData, UsageCardQuota, UsageCardCategory, UsageCardDay, UsageCardResource, UsageCardPeriod } from './types';

package/dist/components/blocks/analytics/usage-card/types.d.ts

@@ -0,0 +1,52 @@
+import type { ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
+import type { StringsProp } from '../../../../lib/strings';
+import type { UsageCardStrings } from './usage-card.strings';
+/** Explicit `null` limit means unlimited; omitted limit means unavailable. */
+export interface UsageCardQuota {
+    used: number | null;
+    limit?: number | null;
+    unit?: string;
+}
+export interface UsageCardCategory {
+    id: string;
+    label: string;
+    value: number | null;
+    /** Semantic chart role; defaults to cycling through the five chart roles. */
+    color?: 1 | 2 | 3 | 4 | 5;
+}
+export interface UsageCardDay {
+    /** App-formatted date or day label, in chronological order. */
+    label: string;
+    value: number | null;
+}
+export interface UsageCardResource extends UsageCardQuota {
+    id: string;
+    label: string;
+}
+export interface UsageCardData extends UsageCardQuota {
+    categories?: readonly UsageCardCategory[];
+    daily?: readonly UsageCardDay[];
+    resources?: readonly UsageCardResource[];
+}
+export interface UsageCardPeriod {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+export interface UsageCardProps extends Pick<CardProps, 'title' | 'description' | 'icon' | 'titleSuffix' | 'headerAction' | 'surface' | 'padding' | 'className'> {
+    data?: UsageCardData | null;
+    /** Loading and error replace stale data; fetching stays in the application. */
+    status?: 'ready' | 'loading' | 'error' | 'empty';
+    periods?: readonly UsageCardPeriod[];
+    /** Controlled selection. Defaults visually to the first period when omitted. */
+    period?: string;
+    onPeriodChange?: (value: string) => void;
+    onRetry?: () => void;
+    loadingSlot?: ReactNode;
+    errorSlot?: ReactNode;
+    emptySlot?: ReactNode;
+    /** App-owned billing/navigation action in the Card footer. */
+    footerAction?: ReactNode;
+    strings?: StringsProp<UsageCardStrings>;
+}

package/dist/components/blocks/analytics/usage-card/usage-card.d.ts

@@ -0,0 +1,6 @@
+import type { UsageCardProps } from './types';
+/** App-owned usage data and period callbacks in the canonical Card composition. */
+export declare function UsageCard({ data, status, periods, period, onPeriodChange, onRetry, loadingSlot, errorSlot, emptySlot, footerAction, strings: stringsProp, ...cardProps }: UsageCardProps): import("react").JSX.Element;
+export declare namespace UsageCard {
+    var displayName: string;
+}

package/dist/components/blocks/analytics/usage-card/usage-card.data.d.ts

@@ -0,0 +1,19 @@
+import type { UsageCardDay } from './types';
+export declare function validUsage(value: number | null | undefined): number | null;
+/** Account only for rounding accumulated by positive finite category additions. */
+export declare function usageExceeds(actual: number, expected: number, terms?: number): boolean;
+/** Retain actual numbers; cap only geometry. Zero quota has no finite percentage. */
+export declare function quotaSummary(usedValue: number | null, limitValue: number | null | undefined): {
+    readonly kind: "unavailable" | "unlimited" | "limited";
+    readonly used: number | null;
+    readonly limit: number | null;
+    readonly percent: number | null;
+    readonly progress: number | null;
+    readonly remaining: number | null;
+    readonly excess: number | null;
+};
+export declare function dailySummary(days: readonly UsageCardDay[]): {
+    values: (number | null)[];
+    average: number | null;
+    maximum: number;
+};

package/dist/components/blocks/analytics/usage-card/usage-card.strings.d.ts

@@ -0,0 +1,22 @@
+export interface UsageCardStrings {
+    title: string;
+    usage: string;
+    used: string;
+    of: string;
+    unlimited: string;
+    unavailable: string;
+    remaining: string;
+    overLimit: string;
+    breakdown: string;
+    inconsistentBreakdown: string;
+    daily: string;
+    average: string;
+    perDay: string;
+    resources: string;
+    periods: string;
+    loading: string;
+    error: string;
+    empty: string;
+    retry: string;
+}
+export declare const defaultUsageCardStrings: UsageCardStrings;

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/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/planning/index.d.ts

@@ -0,0 +1,3 @@
+export { TaskCard } from './task-card';
+export { defaultTaskCardStrings, type TaskCardStrings } from './task-card.strings';
+export type { TaskCardProps, TaskCardItem, TaskCardStatus, TaskCardDueDate } from './task-card.types';

package/dist/components/blocks/planning/task-card.d.ts

@@ -0,0 +1,3 @@
+import type { TaskCardProps } from './task-card.types';
+/** Compact task summary with explicit keyboard disclosure and controlled subtasks. */
+export declare const TaskCard: import("react").ForwardRefExoticComponent<TaskCardProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/planning/task-card.strings.d.ts

@@ -0,0 +1,15 @@
+export interface TaskCardStrings {
+    expand: string;
+    collapse: string;
+    subtasks: string;
+    completion: string;
+    due: string;
+    open: string;
+    empty: string;
+    saving: string;
+    /** Compact visible count; the full completion formatter remains the accessible value. */
+    formatCompletionCount: (completed: number, total: number) => string;
+    formatCompletion: (completed: number, total: number) => string;
+    formatAssignedTo: (name: string) => string;
+}
+export declare const defaultTaskCardStrings: TaskCardStrings;

package/dist/components/blocks/planning/task-card.types.d.ts

@@ -0,0 +1,66 @@
+import type { ComponentPropsWithoutRef } from 'react';
+import type { StackedAvatarUser } from '../../base/avatar';
+import type { BadgeProps } from '../../base/badge';
+import type { CardProps } from '../../base/cards';
+import type { StringsProp } from '../../../lib/strings';
+import type { TaskCardStrings } from './task-card.strings';
+export interface TaskCardItem {
+    /** Stable identity emitted by the completion callback. */
+    id: string;
+    /** Task copy supplied by the application. */
+    title: string;
+    /** Controlled completion state. */
+    completed: boolean;
+    /** Optional individual assignee. */
+    assignee?: StackedAvatarUser;
+    /** Prevents completion changes for this item. */
+    disabled?: boolean;
+    /** Application-owned saving state; keeps the checkbox inert. */
+    busy?: boolean;
+    /** Application-owned error; connected to the checkbox and announced. */
+    error?: string;
+}
+export interface TaskCardStatus {
+    /** Application-owned workflow status, independent of subtask completion. */
+    label: string;
+    /** Semantic badge tone. Defaults to neutral. */
+    tone?: BadgeProps['tone'];
+}
+export interface TaskCardDueDate {
+    /** Application-formatted date; the library adds the localized Due label. */
+    label: string;
+    /** Optional machine-readable ISO date for native time semantics. */
+    dateTime?: string;
+}
+export interface TaskCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+    /** Task title. */
+    title: string;
+    /** Controlled subtasks. Completion is read-only without its callback. */
+    items: readonly TaskCardItem[];
+    /** Application-owned workflow status. */
+    status?: TaskCardStatus;
+    /** Optional due date. */
+    dueDate?: TaskCardDueDate;
+    /** People shown in the compact summary. */
+    assignees?: StackedAvatarUser[];
+    /** Task owner shown in the expanded footer. */
+    assignedTo?: StackedAvatarUser;
+    /** Controlled disclosure state. */
+    expanded?: boolean;
+    /** Initial disclosure state. Defaults to false. */
+    defaultExpanded?: boolean;
+    /** Called for pointer and keyboard disclosure changes. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Completion request; update items to accept the change. */
+    onItemCompletedChange?: (id: string, completed: boolean) => void;
+    /** Open action supplied by the application. */
+    onOpen?: () => void;
+    /** Native navigation destination for the Open action. */
+    href?: string;
+    /** Disables disclosure, completion and the Open action. */
+    disabled?: boolean;
+    /** Canonical Card surface; inherits the provider default. */
+    surface?: CardProps['surface'];
+    /** Overrides this block's labels and formatters. */
+    strings?: StringsProp<TaskCardStrings>;
+}

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/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;

package/dist/components/features/overlays/hooks/use-pending-overlay-focus.d.ts

@@ -0,0 +1,2 @@
+/** Keep modal focus anchored when its focused action becomes disabled. */
+export declare function usePendingOverlayFocus(pending: boolean, modal?: boolean | 'trap-focus'): import("react").RefObject<HTMLDivElement | null>;

package/dist/components/features/overlays/overlays.types.d.ts

@@ -76,8 +76,9 @@ export interface OverlayActionProps {
     onConfirm?: () => void;
     /**
      * Awaited confirm. The confirm button shows a spinner and both buttons
-     * disable until it settles. A rejection leaves the overlay open and is
-     * reported through `onError`. Ignored when `onConfirm` is also set.
+     * disable until it settles. Close, Escape and backdrop dismissal also wait
+     * for completion. A rejection leaves the overlay open, restores the actions
+     * and is reported through `onError`. Ignored when `onConfirm` is also set.
      */
     onAsyncConfirm?: () => Promise<void>;
     /** Receives rejected async confirmations so consumers can report or toast them. */
@@ -91,7 +92,7 @@ export interface OverlayActionProps {
     confirmTone?: OverlayButtonTone;
     /** Confirm button fill treatment. */
     confirmStyle?: OverlayButtonStyle;
-    /** Forces the pending presentation for confirm work owned outside the overlay. */
+    /** Applies the same pending action/dismissal lock for work owned outside the overlay. */
     loading?: boolean;
     /**
      * `id` of a form elsewhere in the tree. The confirm button calls
@@ -99,7 +100,7 @@ export interface OverlayActionProps {
      * `onSubmit` owns the outcome — `onConfirm` and `onAsyncConfirm` do not fire.
      */
     formId?: string;
-    /** Replaces the generated footer entirely. The props above no longer apply. */
+    /** Replaces the generated footer; the consumer owns its action states. Pending dismissal protection still applies. */
     footer?: ReactNode;
 }
 /** Semantic weight — the header icon and the confirm button's tone. */

package/dist/components/features/rich-text-editor/rich-text-editor.recipes.d.ts

@@ -1,6 +1,7 @@
 /** Shared field anatomy for rich editors, including specialized document schemas. */
 export declare const richTextEditorRecipes: {
-    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-radius border";
+    readonly source: string;
+    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-inner border";
     readonly disabled: "opacity-70";
     readonly content: "h-full [&_.ProseMirror]:h-full [&_.ProseMirror]:min-h-full [&_.ProseMirror]:outline-none";
 };

package/dist/components/features/table/data-table.d.ts

@@ -1,6 +1,6 @@
 export declare function useDataTableSize(): 'xs' | 'sm';
 import { type DataTableProps } from './table.types';
-export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableResizing, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
 export declare namespace DataTable {
     var displayName: string;
 }

package/dist/components/features/table/table.types.d.ts

@@ -171,7 +171,7 @@ export type DataTableSize = ComponentScale;
  *
  * - `card` (default): rounded card with `border-border bg-card` and a
  *   soft shadow — the canonical admin treatment.
- * - `glass`: a hairline `border-border/60 rounded-radius-md` outline with no
+ * - `glass`: a hairline `border-border/60 rounded-radius` outline with no
  *   shadow and no card background — pairs with consumer-supplied
  *   surrounding chrome (e.g. dropping into an existing SmartCard).
  *   Background remains transparent so a glassy parent shows

package/dist/components/features/theme-tweaker/theme-provider-settings.d.ts

@@ -39,7 +39,9 @@ export interface ThemeProviderSettingsStrings {
             description: string;
         };
     };
-    labels: Record<'locale' | 'defaultCurrency' | 'displayCurrency' | 'moneyFormat' | 'firstDay' | 'dateFormat' | 'textSize' | 'commentComposer' | 'dualPricing' | 'dualPricingMode' | 'dualPricingLayout' | 'componentScale' | 'itemVariant' | 'buttonTone' | 'buttonStyle' | 'badgeTone' | 'cardSurface' | 'spinner' | 'cardDivider' | 'toastPosition' | 'toastTheme' | 'toastDuration' | 'visibleToasts' | 'closeButton' | 'richColors', string>;
+    labels: Record<'locale' | 'defaultCurrency' | 'displayCurrency' | 'moneyFormat' | 'firstDay' | 'dateFormat' | 'textSize' | 'commentComposer' | 'dualPricing' | 'dualPricingMode' | 'dualPricingLayout' | 'componentScale' | 'itemVariant' | 'buttonTone' | 'buttonStyle' | 'badgeTone' | 'cardSurface' | 'spinner' | 'cardDivider' | 'toastPosition' | 'toastTheme' | 'toastDuration' | 'visibleToasts' | 'closeButton' | 'richColors', string> & {
+        cardFooterDivider?: string;
+    };
     dualPricingDescription: string;
     displayCurrencyPlaceholder: string;
     options: Record<string, string>;

package/dist/components/layout/auth/auth.types.d.ts

@@ -205,6 +205,7 @@ export interface AuthShellProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ti
     /** Content for the panel beside the form in the split layout. */
     splitPanel?: ReactNode | AuthSplitPanelProps;
     splitSide?: AuthSplitSide;
+    /** Panel behavior below the shell's own 64rem inline width; independent of viewport width. */
     splitMobile?: AuthSplitMobile;
     /** Merged onto the main region. */
     mainClassName?: string;

package/dist/components/layout/page/page.d.ts

@@ -1,3 +1,2 @@
 import type { PageProps } from './page.types';
-/** Page — non-scrolling Container, PageHeader, and body-rhythm composition. */
 export declare const Page: import("react").ForwardRefExoticComponent<Omit<PageProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/layout/page/page.types.d.ts

@@ -7,7 +7,7 @@ import type { LayoutLinkRenderer, LayoutNavigationAdapter, LayoutSlotAttributes
 import type { TextGap } from '../../base/structure';
 import type { ButtonSize } from '../../base/buttons';
 import type { HeadingTag } from '../../typography';
-import type { ContainerMaxWidth, ContainerProps } from '../containers/containers.types';
+import type { ContainerGutter, ContainerMaxWidth, ContainerProps } from '../containers/containers.types';
 import type { StringsProp } from '../../../lib/strings';
 import type { BadgeTone } from '../../base/badge';
 import type { ActionPresentation } from '../../../lib/action-presentation';
@@ -33,7 +33,7 @@ export interface PageHeaderProps extends LayoutNavigationAdapter {
     title: ReactNode;
     /** Supporting copy under the title. */
     description?: ReactNode;
-    /** Shared title/description rhythm. Defaults to normal. */
+    /** Shared title/description rhythm. Defaults to dense for page copy. */
     textGap?: TextGap;
     /** Semantic heading level for the title. Defaults to `h3` for nested app pages. */
     headingTag?: HeadingTag;
@@ -130,8 +130,14 @@ export interface PageSlotProps {
 export interface PageProps extends LayoutNavigationAdapter, Omit<ContainerProps, 'children'> {
     /** Header region of the shell. */
     header?: PageHeaderProps;
-    /** Maximum content width. Defaults to `lg` for readable page composition. */
+    /** Maximum content width. Explicit values override narrow. Defaults to `lg`. */
     maxWidth?: ContainerMaxWidth;
+    /** Center one resource or form at the existing `md` content measure. */
+    narrow?: boolean;
+    /** Inline page gutters. Defaults to `lg`; none requires an existing padded parent. */
+    gutter?: ContainerGutter;
+    /** Block padding around the whole page. Defaults to `lg`, independent of gutter. */
+    padding?: ContainerGutter;
     children?: ReactNode;
     /** Native attributes for stable page regions. */
     slotProps?: PageSlotProps;