themelia-ui 3.0.0 → 3.2.0

package/dist/components/features/activities/activity-row.d.ts

@@ -1,8 +1,8 @@
 import { ReactNode } from 'react';
-import { ActivityAction, ActivityActor, ActivityDensity, ActivityEventConfig, ActivityItem, ActivityItemSpacing, ActivityResourceConfig, ActivityResourceRef, ActivityTone } from './activities.types.js';
+import { ActivityAction, ActivityActor, ActivityVariant, ActivityEventConfig, ActivityItem, ActivityItemSpacing, ActivityResourceConfig, ActivityResourceRef, ActivityTone } from './activities.types.js';
 export interface ActivityRowProps<TData = unknown> {
     activity: ActivityItem<TData>;
-    density: ActivityDensity;
+    variant: ActivityVariant;
     itemSpacing: ActivityItemSpacing;
     eventConfig: ActivityEventConfig;
     tone: ActivityTone;
@@ -41,8 +41,8 @@ export interface ActivityRowProps<TData = unknown> {
     detailsClassName?: string;
 }
 /**
- * One entry on the rail. Density changes the marker size and the row rhythm together —
+ * One entry on the rail. The variant changes the marker size and the row rhythm together —
  * changing one without the other is what makes a compact feed look mis-aligned rather than
  * dense.
  */
-export declare function ActivityRow<TData = unknown>({ activity, density, itemSpacing, eventConfig, tone, last, expanded, onExpandedChange, detailsCollapsible, detailLabels, relativeTime, absoluteTime, sourceLabel, youLabel, showChangesLabel, hideChangesLabel, moreLabel, actionsLabel, currentUserId, actions, onActivityClick, onActorClick, onResourceClick, onAction, getResourceConfig, headlineOverride, markerOverride, customDetails, rowClassName, markerClassName, contentClassName, detailsClassName, }: ActivityRowProps<TData>): import("react").JSX.Element;
+export declare function ActivityRow<TData = unknown>({ activity, variant, itemSpacing, eventConfig, tone, last, expanded, onExpandedChange, detailsCollapsible, detailLabels, relativeTime, absoluteTime, sourceLabel, youLabel, showChangesLabel, hideChangesLabel, moreLabel, actionsLabel, currentUserId, actions, onActivityClick, onActorClick, onResourceClick, onAction, getResourceConfig, headlineOverride, markerOverride, customDetails, rowClassName, markerClassName, contentClassName, detailsClassName, }: ActivityRowProps<TData>): import("react").JSX.Element;

package/dist/components/features/activities/index.d.ts

@@ -8,4 +8,4 @@ export { defaultActivitiesStrings, resolveActivitiesStrings, type ActivitiesStri
 export { useActivityFeed, type ActivityDateGroup, type ActivityKeyedItem, type UseActivityFeedOptions, type UseActivityFeedReturn, } from './use-activity-feed.js';
 export { useActivityResources, type ActivityResourceRegistry, type UseActivityResourcesOptions, type UseActivityResourcesReturn, } from './use-activity-resources.js';
 export { createActivityEventAdapter, toActivityLogEntry, type ActivityEventAdapterAccessors, } from './activity-event-adapter.js';
-export type { ActivityAction, ActivityActor, ActivityChange, ActivityDensity, ActivityEventConfig, ActivityEventConfigMap, ActivityFeedAccessors, ActivityFeedCallbacks, ActivityFeedProps, ActivityFeedSlots, ActivityHeadlineSegment, ActivityItem, ActivityItemSpacing, ActivityLogActivityEntry, ActivityLogClassNameValue, ActivityLogClassNames, ActivityLogCommentEntry, ActivityLogComposerConfig, ActivityLogEntry, ActivityLogEventAction, ActivityLogEventRenderContext, ActivityLogProps, ActivityLogRenderer, ActivityLogSubmit, ActivityRenderRowContext, ActivityResourceConfig, ActivityResourceRef, ActivityResourcesProps, ActivityRowClassNameValue, ActivityRowClassNames, ActivityTone, } from './activities.types.js';
+export type { ActivityAction, ActivityActor, ActivityChange, ActivityVariant, ActivityEventConfig, ActivityEventConfigMap, ActivityFeedAccessors, ActivityFeedCallbacks, ActivityFeedProps, ActivityFeedSlots, ActivityHeadlineSegment, ActivityItem, ActivityItemSpacing, ActivityLogActivityEntry, ActivityLogClassNameValue, ActivityLogClassNames, ActivityLogCommentEntry, ActivityLogComposerConfig, ActivityLogEntry, ActivityLogEventAction, ActivityLogEventRenderContext, ActivityLogProps, ActivityLogRenderer, ActivityLogSubmit, ActivityRenderRowContext, ActivityResourceConfig, ActivityResourceRef, ActivityResourcesProps, ActivityRowClassNameValue, ActivityRowClassNames, ActivityTone, } from './activities.types.js';

package/dist/components/features/ai-chat/ai-chat.types.d.ts

@@ -1,5 +1,6 @@
 import { LucideIcon } from 'lucide-react';
 import { ReactNode } from 'react';
+import { TextProps } from '../../base/typography/index.js';
 import { SemanticTone } from '../../../lib/component-vocabulary.js';
 import type * as Strings from "./ai-chat.strings.js";
 export interface AiShimmerProps {
@@ -9,6 +10,8 @@ export interface AiShimmerProps {
     paused?: boolean;
     /** Sweep duration, in seconds. */
     duration?: number;
+    /** Step on the type scale, as on `Text`. Unset, the provider's default size. */
+    size?: TextProps["size"];
     className?: string;
 }
 export type AiMessageRole = "assistant" | "user" | "system";
@@ -90,9 +93,13 @@ export interface AiTaskItem {
 }
 export interface AiTaskProps {
     task: AiTaskItem;
-    /** `compact` collapses the sub-tasks behind a toggle; `expanded` always shows them. */
-    density?: "compact" | "expanded";
-    /** Indent per nesting level, as a multiple of `--space-xl`. */
+    /**
+     * Opens every level of sub-tasks at first. Off, only the top level starts open and the rest
+     * sit behind their toggles.
+     * @default false
+     */
+    defaultExpanded?: boolean;
+    /** Indent per nesting level, as a multiple of `--padding`. */
     indent?: number;
     className?: string;
     strings?: Partial<Strings.AiTaskStrings>;

package/dist/components/features/ai-chat/ai-message-surfaces.d.ts

@@ -5,7 +5,7 @@ import { AiChainOfThoughtProps, AiMessageBubbleProps, AiReasoningProps, AiShimme
  * waiting on. It paints through `background-clip`, so its colour is transparent by design — a
  * contrast probe reading `color` alone will call it a 1:1 failure.
  */
-export declare function AiShimmer({ children, paused, duration, className, }: AiShimmerProps): import("react").JSX.Element;
+export declare function AiShimmer({ children, paused, duration, size, className, }: AiShimmerProps): import("react").JSX.Element;
 export declare function AiMessageBubble({ role, avatar, avatarLabel, authorName, timestamp, children, plainText, loading, onCopy, onRegenerate, className, strings, }: AiMessageBubbleProps): import("react").JSX.Element;
 /** The reasoning disclosure: the model's trace, and how long it thought. */
 export declare function AiReasoning({ children, streaming, durationSeconds, expandWhileStreaming, defaultExpanded, expanded: expandedProp, onExpandedChange, className, strings, }: AiReasoningProps): import("react").JSX.Element;

package/dist/components/features/ai-chat/ai-work-surfaces.d.ts

@@ -9,7 +9,7 @@ export declare function AiToolCall({ name, status, icon, args, result, error, du
  * One task of an agent's plan, with its status and its sub-tasks. A task reports what is being
  * done, not merely that something is.
  */
-export declare function AiTask({ task, density, indent, className, strings, }: AiTaskProps): import("react").JSX.Element;
+export declare function AiTask({ task, defaultExpanded, indent, className, strings, }: AiTaskProps): import("react").JSX.Element;
 /** The identity strip that says which agent is answering. */
 export declare function AiAgent({ name, icon, avatar, subtitle, tone, status, variant, trailing, className, strings, }: AiAgentProps): import("react").JSX.Element;
 /**

package/dist/components/features/combobox/combobox.strings.d.ts

@@ -18,8 +18,8 @@ export interface AsyncComboboxStrings {
     /** Announced when a fetch fails, above the retry control. */
     errorTitle: string;
     retry: string;
-    /** Accessible name for a multi-select chip's remove control. Takes the chip's label. Optional for compatibility; the default supplies it. */
-    removeChip?: (label: string) => string;
+    /** Accessible name for a multi-select chip's remove control. Takes the chip's label. */
+    removeChip: (label: string) => string;
 }
 export declare const defaultAsyncComboboxStrings: AsyncComboboxStrings;
 /** The copy `SuggestionsCombobox` speaks, mapped onto `AsyncComboboxStrings` inside it. */

package/dist/components/features/combobox/fetching-combobox.d.ts

@@ -11,6 +11,7 @@ export interface FetchingComboboxProps<T> extends Omit<AsyncComboboxProps<T>, "i
     /** Receives the trimmed query that failed. Aborts never reach it. */
     onError?: (error: unknown, query: string) => void;
     preload: boolean;
+    scopeKey?: string | number;
     requestDelay?: number;
     searchValue?: string;
     defaultSearchValue?: string;
@@ -30,4 +31,4 @@ export interface FetchingComboboxProps<T> extends Omit<AsyncComboboxProps<T>, "i
     /** On the wrapper, which also holds the error, not on the input. */
     className?: string;
 }
-export declare function FetchingCombobox<T>({ hook, slot, fetchData, onError, preload, requestDelay, minSearchLength, debounceMs, searchValue, defaultSearchValue, onSearchValueChange, value, defaultValue, onValueChange, open, defaultOpen, onOpenChange, clearSearchOnClose, getItemLabel, getItemKey, getDescription, getMeta, renderOption, highlightMatch, errorTitle, renderError, strings, disabled, className, ...props }: FetchingComboboxProps<T>): import("react").JSX.Element;
+export declare function FetchingCombobox<T>({ hook, slot, fetchData, onError, preload, scopeKey, requestDelay, minSearchLength, debounceMs, searchValue, defaultSearchValue, onSearchValueChange, value, defaultValue, onValueChange, open, defaultOpen, onOpenChange, clearSearchOnClose, getItemLabel, getItemKey, getDescription, getMeta, renderOption, highlightMatch, errorTitle, renderError, strings, disabled, className, ...props }: FetchingComboboxProps<T>): import("react").JSX.Element;

package/dist/components/features/combobox/resource-combobox.d.ts

@@ -17,6 +17,9 @@ export interface ResourceComboboxProps<T> extends Omit<AsyncComboboxProps<T>, "i
      * and the query arrives trimmed. Honour `signal`, so an abort does not surface as a failure.
      */
     fetcher: ResourceComboboxFetcher<T>;
+    /** Resource scope identity. A change aborts stale lookups and refetches the current
+     * eligible query. The application owns clearing a selection invalid in the new scope. */
+    scopeKey?: string | number;
     /** Controlled. Omit entirely to let the component own the selection. */
     value?: T | null;
     /** The starting selection when uncontrolled. Ignored once `value` is passed. */

package/dist/components/features/combobox/use-suggestions.d.ts

@@ -9,6 +9,13 @@ export interface UseSuggestionsConfig<T> {
      * `context.signal` to the request: it aborts when a newer query starts.
      */
     fetchData: (query: string, context?: SuggestionsFetchContext) => MaybePromise<T[]>;
+    /**
+     * Identity of the resource scope (workspace, tenant or parent record). Changing it
+     * aborts previous work, hides its results/errors and immediately refetches an eligible
+     * query. Compared with Object.is; callback identity alone never refetches. Selection,
+     * query and open state survive: the application clears selections invalid in the new scope.
+     */
+    scopeKey?: string | number;
     /**
      * Characters required before a request is issued, not counting surrounding whitespace.
      * Defaults to 1.

package/dist/components/features/event-calendar/event-calendar.types.d.ts

@@ -1,6 +1,7 @@
 import { ReactNode } from 'react';
 import { Locale } from 'date-fns';
 import { ActionDefinition } from '../../base/action-menu/index.js';
+import { SemanticTone } from '../../../lib/component-vocabulary.js';
 import { EventCalendarStrings, EventCalendarEventCardStrings } from './event-calendar.strings.js';
 export interface CalendarEvent {
     id: string;
@@ -26,6 +27,8 @@ export interface EventCategory {
 }
 /** The only fallback: a category that is missing entirely. */
 export declare function resolveCategoryColorToken(category?: EventCategory | null): CalendarColorToken;
+/** The shared tone a category's marks render as `data-tone`: `amber` and `yellow` name warning. */
+export declare function resolveCategoryTone(category?: EventCategory | null): Extract<SemanticTone, CalendarColorToken>;
 export type CalendarViewMode = "month" | "week" | "agenda";
 /** One day, after the events have been placed on it. */
 export interface CalendarDayData {

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

@@ -5,4 +5,4 @@ export { MediaResourceGallery } from './media-resource-gallery.js';
 export { MediaLibraryCard, MediaLibraryDetailPanel, MediaLibraryEmptyState, MediaLibraryFooter, MediaLibraryFooterActions, MediaLibraryFooterSummary, MediaLibraryList, MediaLibraryToolbar, MediaLibraryUploadPanel, MediaPreview, type MediaLibraryCardProps, type MediaLibraryDetailPanelProps, type MediaLibraryEmptyStateProps, type MediaLibraryFooterActionsProps, type MediaLibraryFooterProps, type MediaLibraryFooterSummaryProps, type MediaLibraryListProps, type MediaLibraryToolbarProps, type MediaLibraryUploadPanelProps, } from './media-library-parts.js';
 export { formatMediaLibrarySize, getMediaLibraryDimensions, resolveMediaLibraryAccessors, useMediaLibrary, } from './use-media-library.js';
 export { defaultMediaLibraryStrings, type MediaLibraryStrings, } from './media-library.strings.js';
-export type { MediaLibraryAccessors, MediaLibraryCollectionOption, MediaLibraryDensity, MediaLibraryDetailRenderContext, MediaLibraryDialogProps, MediaLibraryFetchParams, MediaLibraryFetchResult, MediaLibraryFetcher, MediaLibraryItem, MediaLibraryItemPatch, MediaLibraryBulkActionContext, MediaLibraryItemRenderContext, MediaLibraryItemType, MediaLibraryProps, MediaLibrarySelectionMode, MediaLibrarySlots, MediaLibrarySort, MediaLibraryStagedFile, MediaLibraryState, MediaLibraryTab, MediaLibraryTypeFilter, MediaLibraryUploadHandler, MediaLibraryUploadHelpers, MediaLibraryUploadOptions, MediaLibraryUploadStatus, MediaLibraryView, MediaResourceGalleryItemRenderContext, MediaResourceGalleryLayout, MediaResourceGalleryProps, ResolvedMediaLibraryAccessors, UseMediaLibraryOptions, } from './media-library.types.js';
+export type { MediaLibraryAccessors, MediaLibraryCollectionOption, MediaLibrarySize, MediaLibraryDetailRenderContext, MediaLibraryDialogProps, MediaLibraryFetchParams, MediaLibraryFetchResult, MediaLibraryFetcher, MediaLibraryItem, MediaLibraryItemPatch, MediaLibraryBulkActionContext, MediaLibraryItemRenderContext, MediaLibraryItemType, MediaLibraryProps, MediaLibrarySelectionMode, MediaLibrarySlots, MediaLibrarySort, MediaLibraryStagedFile, MediaLibraryState, MediaLibraryTab, MediaLibraryTypeFilter, MediaLibraryUploadHandler, MediaLibraryUploadHelpers, MediaLibraryUploadOptions, MediaLibraryUploadStatus, MediaLibraryView, MediaResourceGalleryItemRenderContext, MediaResourceGalleryLayout, MediaResourceGalleryProps, ResolvedMediaLibraryAccessors, UseMediaLibraryOptions, } from './media-library.types.js';

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

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { MediaLibraryStrings } from './media-library.strings.js';
-import { MediaLibraryCollectionOption, MediaLibraryTab, MediaLibraryDensity, MediaLibrarySelectionMode, MediaLibrarySort, MediaLibraryStagedFile, MediaLibraryTypeFilter, MediaLibraryUploadOptions, MediaLibraryView, ResolvedMediaLibraryAccessors } from './media-library.types.js';
+import { MediaLibraryCollectionOption, MediaLibraryTab, MediaLibrarySize, MediaLibrarySelectionMode, MediaLibrarySort, MediaLibraryStagedFile, MediaLibraryTypeFilter, MediaLibraryUploadOptions, MediaLibraryView, ResolvedMediaLibraryAccessors } from './media-library.types.js';
 export { MediaPreview } from './media-preview.js';
 export interface MediaLibraryEmptyStateProps {
     title: ReactNode;
@@ -35,7 +35,8 @@ export declare function MediaLibraryToolbar({ query, onQueryChange, type, onType
 export interface MediaLibraryCardProps<TItem> {
     item: TItem;
     selected?: boolean;
-    density?: MediaLibraryDensity;
+    /** Tile size: `sm` fits more tiles in a row. */
+    size?: MediaLibrarySize;
     showMeta?: boolean;
     selectionMode?: MediaLibrarySelectionMode;
     accessors: ResolvedMediaLibraryAccessors<TItem>;
@@ -45,7 +46,7 @@ export interface MediaLibraryCardProps<TItem> {
     className?: string;
 }
 /** One asset in the grid, with its preview, name and selection control. */
-export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibraryCard<TItem>({ item, selected, size, showMeta, accessors, strings, onToggle, onDetails, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
 export interface MediaLibraryListProps<TItem> {
     items: readonly TItem[];
     selectedSet: Set<string>;

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

@@ -1,9 +1,10 @@
 import { ReactNode } from 'react';
 import { MediaLibraryListProps } from './media-library-parts.js';
 import { MediaLibraryStrings } from './media-library.strings.js';
-import { MediaLibraryDensity, MediaLibrarySlots } from './media-library.types.js';
+import { MediaLibrarySize, MediaLibrarySlots } from './media-library.types.js';
 export interface MediaLibraryGridProps<TItem> extends MediaLibraryListProps<TItem> {
-    density?: MediaLibraryDensity;
+    /** Tile size: `sm` fits more tiles in a row. */
+    size?: MediaLibrarySize;
     showMeta?: boolean;
     renderItem?: MediaLibrarySlots<TItem>["renderItem"];
     className?: string;
@@ -12,7 +13,7 @@ export interface MediaLibraryGridProps<TItem> extends MediaLibraryListProps<TIte
  * The composable visual grid. Like the list and the table, it uses the same accessors and
  * selection callbacks.
  */
-export declare function MediaLibraryGrid<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, density, selectionMode, showMeta, renderItem, className }: MediaLibraryGridProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibraryGrid<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, size, selectionMode, showMeta, renderItem, className }: MediaLibraryGridProps<TItem>): import("react").JSX.Element;
 export interface MediaLibrarySelectionBarProps {
     visibleCount: number;
     totalCount: number;

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

@@ -3,6 +3,6 @@ import { MediaLibraryDialogProps, MediaLibraryItem, MediaLibraryProps } from './
  * The asset browser, as a panel. The detail panel is a column beside the grid, not an overlay,
  * so several assets can be edited in a row.
  */
-export declare function MediaLibrary<TItem = MediaLibraryItem>({ title, description, confirmLabel, cancelLabel, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, bulkActions, strings, slots, className, collections, selectionMode, ...options }: MediaLibraryProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibrary<TItem = MediaLibraryItem>({ title, description, confirmLabel, cancelLabel, size, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, bulkActions, strings, slots, className, collections, selectionMode, ...options }: MediaLibraryProps<TItem>): import("react").JSX.Element;
 /** The same library in a modal, for picking assets from elsewhere on a page. */
 export declare function MediaLibraryDialog<TItem = MediaLibraryItem>({ open, onOpenChange, trigger, dialogTitle, dialogDescription, dialogClassName, contentClassName, closeOnEscape, closeOnBackdropClick, onClose, strings, ...props }: MediaLibraryDialogProps<TItem>): import("react").JSX.Element;

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

@@ -8,12 +8,12 @@ export interface MediaLibraryStrings {
     views: {
         grid: string;
         table: string;
-        list?: string;
+        list: string;
     };
-    selectVisible?: string;
-    deselectVisible?: string;
-    refreshError?: string;
-    table?: {
+    selectVisible: string;
+    deselectVisible: string;
+    refreshError: string;
+    table: {
         name: string;
         collection: string;
         size: string;
@@ -44,8 +44,7 @@ export interface MediaLibraryStrings {
     activeSearchLabel: string;
     loading: string;
     error: string;
-    /** Optional so existing complete translations keep working; defaults to "Try again". */
-    retry?: string;
+    retry: string;
     emptyTitle: string;
     emptyDescription: string;
     emptyFilteredTitle: string;
@@ -54,7 +53,7 @@ export interface MediaLibraryStrings {
     showingCount: (shown: number, total: number) => string;
     select: string;
     deselect: string;
-    assetAction?: (action: string, name: string) => string;
+    assetAction: (action: string, name: string) => string;
     details: string;
     close: string;
     confirm: string;
@@ -80,11 +79,11 @@ export interface MediaLibraryStrings {
         saving: string;
         delete: string;
         deleting: string;
-        saved?: string;
-        unsaved?: string;
-        saveFailed?: string;
-        deleteFailed?: string;
-        reset?: string;
+        saved: string;
+        unsaved: string;
+        saveFailed: string;
+        deleteFailed: string;
+        reset: string;
         dimensions: string;
         size: string;
         uploaded: string;

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

@@ -4,7 +4,7 @@ export type MediaLibraryItemType = "image" | "video" | "file";
 export type MediaLibrarySelectionMode = "single" | "multiple";
 export type MediaLibraryView = "grid" | "table" | "list";
 export type MediaLibraryTab = "library" | "upload";
-export type MediaLibraryDensity = "comfortable" | "compact";
+export type MediaLibrarySize = "default" | "sm";
 export type MediaResourceGalleryLayout = "field" | "grid" | "list";
 export type MediaLibrarySort = "newest" | "name" | "size" | "usage";
 export type MediaLibraryTypeFilter = "all" | MediaLibraryItemType;
@@ -157,16 +157,16 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     toggleSelection: (id: string) => void;
     clearSelection: () => void;
     /** Select/deselect only the currently visible records, preserving other selections. */
-    selectVisible?: () => void;
-    deselectVisible?: () => void;
+    selectVisible: () => void;
+    deselectVisible: () => void;
     clearFilters: () => void;
     loading: boolean;
     /** Most recent fetch or mutation failure; cleared when an operation starts. */
     error: unknown;
-    /** Always supplied by useMediaLibrary; optional for existing consumer-owned states. */
-    fetchError?: unknown;
-    /** Stable query reload, always supplied by useMediaLibrary; a no-op in local mode. */
-    refetch?: () => void;
+    /** Fetch failure, separate from mutation failures. */
+    fetchError: unknown;
+    /** Stable query reload; a no-op in local mode. */
+    refetch: () => void;
     hasFilters: boolean;
     totalCount: number;
     filteredCount: number;
@@ -266,7 +266,8 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
     description?: ReactNode;
     confirmLabel?: ReactNode;
     cancelLabel?: ReactNode;
-    density?: MediaLibraryDensity;
+    /** Tile size: `sm` fits more tiles in a row. */
+    size?: MediaLibrarySize;
     /** Shows each asset's size and dimensions under its name. */
     showMeta?: boolean;
     allowUpload?: boolean;
@@ -341,7 +342,8 @@ export interface MediaResourceGalleryProps<TItem = MediaLibraryItem> extends Omi
     /** The add control hides once reached. */
     maxItems?: number;
     layout?: MediaResourceGalleryLayout;
-    density?: MediaLibraryDensity;
+    /** Tile size: `sm` fits more tiles in a row. */
+    size?: MediaLibrarySize;
     readOnly?: boolean;
     empty?: ReactNode;
     action?: ReactNode;

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

@@ -4,4 +4,4 @@ import { MediaLibraryItem, MediaResourceGalleryProps } from './media-library.typ
  * `onAdd` usually opens the library dialog. Reordering uses move buttons rather than drag, so it
  * works with keyboard, screen reader and touch.
  */
-export declare function MediaResourceGallery<TItem = MediaLibraryItem>({ items, accessors: accessorsProp, title, description, primaryId, onPrimaryChange, onRemove, onReorder, onAdd, maxItems, layout, density, readOnly, empty, action, renderItem, strings, className, ...props }: MediaResourceGalleryProps<TItem>): import("react").JSX.Element;
+export declare function MediaResourceGallery<TItem = MediaLibraryItem>({ items, accessors: accessorsProp, title, description, primaryId, onPrimaryChange, onRemove, onReorder, onAdd, maxItems, layout, size, readOnly, empty, action, renderItem, strings, className, ...props }: MediaResourceGalleryProps<TItem>): import("react").JSX.Element;

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

@@ -1,6 +1,4 @@
 import { MediaLibraryAccessors, MediaLibraryItem, MediaLibraryState, ResolvedMediaLibraryAccessors, UseMediaLibraryOptions } from './media-library.types.js';
-/** The hook supplies the recovery controls, which a state adapter may omit. */
-type ResolvedMediaLibraryState<TItem> = MediaLibraryState<TItem> & Required<Pick<MediaLibraryState<TItem>, "fetchError" | "refetch" | "selectVisible" | "deselectVisible">>;
 export declare function resolveMediaLibraryAccessors<TItem = MediaLibraryItem>(accessors?: MediaLibraryAccessors<TItem>): ResolvedMediaLibraryAccessors<TItem>;
 export declare function formatMediaLibrarySize(bytes?: number): string;
 export declare function getMediaLibraryDimensions<TItem>(item: TItem, accessors: ResolvedMediaLibraryAccessors<TItem>): string;
@@ -9,5 +7,4 @@ export declare function getMediaLibraryDimensions<TItem>(item: TItem, accessors:
  * clearing filters or selection; `fetchError` identifies fetch failures separately from
  * mutation errors.
  */
-export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, applyItemPatch, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, }: UseMediaLibraryOptions<TItem>): ResolvedMediaLibraryState<TItem>;
-export {};
+export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, applyItemPatch, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, }: UseMediaLibraryOptions<TItem>): MediaLibraryState<TItem>;

package/dist/components/features/overlays/action-overlay-frame.d.ts

@@ -31,4 +31,4 @@ export interface ActionOverlayFrameProps extends OverlayBaseProps, OverlayAction
     showIconByDefault?: boolean;
     initialFocusRef?: RefObject<HTMLElement | null>;
 }
-export declare function ActionOverlayFrame({ open, onOpenChange, onClose, children, title, description, hideHeader, showCloseButton, initialFocusRef, closeOnEscape, closeOnBackdropClick, surfaceStyle, className, contentClassName, strings, trigger, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, emphasis, tone, showIcon, alertMessage, parts, hook, contentProps, alwaysRenderBody, showFooter, dismissible, defaultStrings, showIconByDefault, }: ActionOverlayFrameProps): import("react").JSX.Element;
+export declare function ActionOverlayFrame({ open, onOpenChange, onClose, children, title, description, hideHeader, showCloseButton, initialFocusRef, closeOnEscape, closeOnBackdropClick, surfaceStyle, className, contentClassName, strings, trigger, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmAppearance, loading, formId, footer, emphasis, tone, showIcon, alertMessage, parts, hook, contentProps, alwaysRenderBody, showFooter, dismissible, defaultStrings, showIconByDefault, }: ActionOverlayFrameProps): import("react").JSX.Element;

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

@@ -4,4 +4,4 @@ export { ConfirmDialog } from './confirm-dialog.js';
 export { useOverlayVisibility, useOverlayVisibilityGroup, type OverlayOpenSetter, type OverlayVisibilityProps, type OverlayVisibilityGroupState, type UseOverlayVisibilityOptions, type UseOverlayVisibilityReturn, type UseOverlayVisibilityGroupOptions, type UseOverlayVisibilityGroupReturn, } from './use-overlay-visibility.js';
 export { useOverlayActions, type UseOverlayActionsOptions, type UseOverlayActionsReturn, } from './use-overlay-actions.js';
 export { defaultOverlayActionStrings, defaultConfirmStrings, type OverlayActionStrings, } from './overlays.strings.js';
-export type { OverlayWidth, ActionDialogProps, ActionSheetProps, ConfirmDialogProps, OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps, OverlayTone, OverlayButtonTone, OverlayButtonStyle, } from './overlays.types.js';
+export type { OverlayWidth, ActionDialogProps, ActionSheetProps, ConfirmDialogProps, OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps, OverlayTone, OverlayButtonTone, OverlayButtonAppearance, } from './overlays.types.js';

package/dist/components/features/overlays/overlay-parts.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { OverlayActionStrings } from './overlays.strings.js';
-import { OverlayButtonStyle, OverlayButtonTone, OverlayTone } from './overlays.types.js';
+import { OverlayButtonAppearance, OverlayButtonTone, OverlayTone } from './overlays.types.js';
 /** The tone's glyph. Decorative — the tone is also said in the title and the copy. */
 export declare function OverlayToneIcon({ tone }: {
     tone: OverlayTone;
@@ -20,13 +20,13 @@ export interface OverlayFooterActionsProps {
     showCancel: boolean;
     showConfirm: boolean;
     confirmTone: OverlayButtonTone;
-    confirmStyle: OverlayButtonStyle;
+    confirmAppearance: OverlayButtonAppearance;
     busy: boolean;
     formId?: string;
     onCancel: () => void;
     onConfirm: () => void | Promise<void>;
 }
-export declare function OverlayFooterActions({ copy, showCancel, showConfirm, confirmTone, confirmStyle, busy, formId, onCancel, onConfirm, }: OverlayFooterActionsProps): import("react").JSX.Element | null;
+export declare function OverlayFooterActions({ copy, showCancel, showConfirm, confirmTone, confirmAppearance, busy, formId, onCancel, onConfirm, }: OverlayFooterActionsProps): import("react").JSX.Element | null;
 /** The header, hidden from view but not from the accessibility tree. */
 export declare function OverlayHiddenHeader({ title, description, titleId, descriptionId, Title, Description, }: {
     title?: ReactNode;

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

@@ -1,5 +1,6 @@
 import { CSSProperties, ReactNode, RefObject } from 'react';
-import { ButtonStyle } from '../../base/buttons/index.js';
+import { ButtonAppearance } from '../../base/buttons/index.js';
+import { OverlayInset, OverlayLength, OverlaySize } from '../../base/overlay/index.js';
 import { SheetSide } from '../../base/sheet/index.js';
 import { SemanticTone } from '../../../lib/component-vocabulary.js';
 import { OverlayActionStrings } from './overlays.strings.js';
@@ -7,7 +8,7 @@ import { OverlayActionStrings } from './overlays.strings.js';
 export type OverlayTone = Extract<SemanticTone, "neutral" | "destructive" | "warning" | "info" | "success">;
 export type OverlayButtonTone = SemanticTone;
 /** Ghost is excluded: a footer's confirm must look like a commitment. */
-export type OverlayButtonStyle = Exclude<ButtonStyle, "ghost">;
+export type OverlayButtonAppearance = Exclude<ButtonAppearance, "ghost">;
 export interface OverlayBaseProps {
     /** Controlled: hands the open state to the caller. Supply this OR `trigger`, not both. */
     open?: boolean;
@@ -67,7 +68,7 @@ export interface OverlayActionProps {
      */
     closeOnAsyncComplete?: boolean;
     confirmTone?: OverlayButtonTone;
-    confirmStyle?: OverlayButtonStyle;
+    confirmAppearance?: OverlayButtonAppearance;
     /** Forces the pending presentation, for confirm work owned outside the overlay. */
     loading?: boolean;
     /**
@@ -113,11 +114,11 @@ export interface ActionDialogProps extends OverlayBaseProps, OverlayActionProps,
 }
 export interface ActionSheetProps extends OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps {
     side?: SheetSide;
-    /** Cross-axis extent: a side panel's width. */
-    size?: string;
+    /** Cross-axis extent: a side panel's width, `default`, `sm`, `full` or a CSS length. */
+    size?: OverlaySize;
     /** How far it runs along its edge; `inset` sets the gap from the viewport. See base/sheet. */
-    length?: string;
-    inset?: boolean | string;
+    length?: OverlayLength;
+    inset?: OverlayInset;
     showFooter?: boolean;
     /**
      * How much of the page it takes hostage. `modal` traps focus, locks scroll and makes the page

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

@@ -3,5 +3,4 @@ export { RichTextEditorToolbar, EditorCounts, type RichTextEditorToolbarProps, t
 export { defaultRichTextEditorStrings, type RichTextEditorStrings, } from './rich-text-editor.strings.js';
 export { htmlToText, insertHtmlAtCaret, normalizeHtml, readCaretContext, replaceBeforeCaret, toEditorContent, } from './editor-dom.js';
 export type { RichTextCaretContext, RichTextEditorHandle, RichTextEditorProps, RichTextEditorToolbarItem, ToolbarButtonConfig, } from './rich-text-editor.types.js';
-export { createExecCommandEngine } from './exec-command-engine.js';
 export type { RichTextCommand, RichTextEngine, RichTextEngineState, } from './rich-text-engine.types.js';

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

@@ -1,4 +1,4 @@
 import { RowData } from '@tanstack/react-table';
 import { DataTableBodyProps } from './table.types.js';
 /** The body rows, and the row that stands in for all of them when there are none. */
-export declare function DataTableBody<TData extends RowData>({ table, onRowClick, emptyStateMessage, emptyStateAction, cellClassName, rowClassName, stickyFirstColumn, hasSelectionColumn, striped, strings, }: DataTableBodyProps<TData>): import("react").JSX.Element;
+export declare function DataTableBody<TData extends RowData>({ table, onRowClick, emptyStateMessage, emptyStateAction, cellClassName, rowClassName, stickyFirstColumn, hasSelectionColumn, hasExpandColumn, expandedRow, expansionId, striped, strings, }: DataTableBodyProps<TData>): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+import { RowData } from '@tanstack/react-table';
+import { LegacyRow } from '@tanstack/react-table/legacy';
+import { DataTableStrings } from './table.strings.js';
+import { DataTableExpandedRow as ExpandedRowConfig } from './table.types.js';
+export interface ExpandToggleProps<TData extends RowData> {
+    row: LegacyRow<TData>;
+    /** The id of the panel this toggle opens. */
+    panelId: string;
+    strings: DataTableStrings;
+}
+/** The chevron at a row's start. A row `canExpand` refuses gets nothing, and never opens. */
+export declare function ExpandToggle<TData extends RowData>({ row, panelId, strings }: ExpandToggleProps<TData>): import("react").JSX.Element | null;
+export interface DataTableExpandedRowProps<TData extends RowData> {
+    row: LegacyRow<TData>;
+    /** `false` while the panel plays its closing animation, before the body drops it. */
+    open: boolean;
+    /** Called once the panel has finished closing. */
+    onExited: (rowId: string) => void;
+    /** The visible column count, so the panel spans the row. */
+    colSpan: number;
+    panelId: string;
+    cacheKey: string;
+    config: ExpandedRowConfig<TData, unknown>;
+    strings: DataTableStrings;
+}
+/** One open row's panel: a row of its own, spanning the columns, under the row it belongs to. */
+export declare function DataTableExpandedRow<TData extends RowData>({ row, open, onExited, colSpan, panelId, cacheKey, config, strings, }: DataTableExpandedRowProps<TData>): import("react").JSX.Element;

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

@@ -4,4 +4,4 @@ import { DataTableHeaderProps } from './table.types.js';
  * The header rows — an optional band of column groups, then the columns. Sorting is base TableHead
  * doing the work; this only translates the column's state into it.
  */
-export declare function DataTableHeader<TData extends RowData>({ table, stickyHeader, headerClassName, cellClassName, stickyFirstColumn, hasSelectionColumn, columnGroups, headerTransparent, }: DataTableHeaderProps<TData>): import("react").JSX.Element;
+export declare function DataTableHeader<TData extends RowData>({ table, stickyHeader, headerClassName, cellClassName, stickyFirstColumn, hasSelectionColumn, hasExpandColumn, columnGroups, headerTransparent, }: DataTableHeaderProps<TData>): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
 import { DataTableSize } from './table.types.js';
-export declare const DataTableSizeContext: import('react').Context<"sm" | "md" | "lg">;
+export declare const DataTableSizeContext: import('react').Context<"default" | "sm">;
 /** The table's `size` — its row density — for a part rendered inside a row. */
 export declare function useDataTableSize(): DataTableSize;

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

@@ -1,5 +1,5 @@
 import { RowData } from '@tanstack/react-table';
 import { ReactNode } from 'react';
 import { DataTableProps } from './table.types.js';
-export declare function DataTable<TData extends RowData, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, enableSorting, enableFiltering, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, enableColumnVisibility, manualSorting, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, striped, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, tableContainerClassName, strings: stringsOverride, filterColumn, filterPlaceholder, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, pageCount, page, onPageChange, totalRowCount, pageSize, onRowClick, onRowSelectionChange, onSortingChange, onColumnVisibilityChange, onColumnFiltersChange, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, storageKey, style, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+export declare function DataTable<TData extends RowData, TValue = unknown, TDetail = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, enableSorting, enableFiltering, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, enableColumnVisibility, manualSorting, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, striped, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, tableContainerClassName, strings: stringsOverride, filterColumn, filterPlaceholder, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, pageCount, page, onPageChange, totalRowCount, pageSize, onRowClick, expandedRow, onRowSelectionChange, onSortingChange, onColumnVisibilityChange, onColumnFiltersChange, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, storageKey, style, }: DataTableProps<TData, TValue, TDetail>): import("react").JSX.Element;
 export type { ReactNode };

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

@@ -12,6 +12,6 @@ export { CellStack, CellValue, type CellStackProps, type CellStackValue, type Ce
 export { AvatarCell, CurrencyCell, DateCell, DateMetaCell, StatusCell, StatusClusterCell, type AvatarCellProps, type CurrencyCellProps, type DateCellProps, type DateMetaCellProps, type StatusCellEntry, type StatusCellProps, type StatusClusterCellItem, type StatusClusterCellProps, } from './cell-renderers.js';
 export { ResourceCell, type ResourceCellBadge, type ResourceCellMetadataItem, type ResourceCellProps, } from './resource-cell.js';
 export { defaultDataTableStrings, mergeDataTableStrings, type DataTableStrings, type DataTableStringsOverride, } from './table.strings.js';
-export type { ClassNameFor, ColumnGroup, ColumnVisibilityToggleProps, DataTableActionsProps, DataTableBodyProps, DataTableHeaderProps, DataTableProps, DataTableSelectionToolbarContext, DataTableSize, DataTableSurface, DataTableToolbarProps, RowActionsDisplayMode, RowClickHandler, RowSelectionHandler, SortingHandler, TableAction, } from './table.types.js';
+export type { ClassNameFor, ColumnGroup, ColumnVisibilityToggleProps, DataTableActionsProps, DataTableBodyProps, DataTableExpandedRow, DataTableExpandedRowContext, DataTableHeaderProps, DataTableProps, DataTableSelectionToolbarContext, DataTableSize, DataTableSurface, DataTableToolbarProps, RowActionsDisplayMode, RowClickHandler, RowSelectionHandler, SortingHandler, TableAction, } from './table.types.js';
 export { useDataTableSize } from './data-table-size.js';
 export type { LinkRenderer, LinkRenderProps } from '../../../lib/navigation.js';

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

@@ -2,11 +2,17 @@ import { LegacyColumnDef, LegacyRow, LegacyTable } from '@tanstack/react-table/l
 import { RowData } from '@tanstack/react-table';
 import { DataTableStrings } from './table.strings.js';
 import { ClassNameFor } from './table.types.js';
+/** The gutter columns' ids. Their cells keep the widths the pinned offsets are computed from. */
+export declare const EXPAND_COLUMN_ID = "expand";
 /**
- * Which cells stay put when the table scrolls sideways. With selection on, the pinned group
- * is the checkbox and the identity column after it, so a row never loses its name.
+ * Which cells stay put when the table scrolls sideways: the leading checkbox and expand toggle,
+ * when there are any, and the identity column after them, so a row never loses its name.
  */
-export declare function resolveCellClassName<TData extends RowData>(columnId: string, row: LegacyRow<TData> | null, cellClassName: ClassNameFor<TData> | undefined, stickyFirstColumn: boolean, cellIndex: number, hasSelectionColumn?: boolean): string;
+export declare function resolveCellClassName<TData extends RowData>(columnId: string, row: LegacyRow<TData> | null, cellClassName: ClassNameFor<TData> | undefined, stickyFirstColumn: boolean, cellIndex: number, hasSelectionColumn?: boolean, hasExpandColumn?: boolean): string;
+/** How many leading cells are pinned with `stickyFirstColumn`: the gutter columns and the identity one. */
+export declare function pinnedCellCount(hasSelectionColumn: boolean, hasExpandColumn: boolean): number;
 export declare function getSelectedRowsData<TData extends RowData>(table: LegacyTable<TData>): TData[];
 /** Prepends the selection column, built here so it always agrees with `enableRowSelection`. */
 export declare function addSelectionColumn<TData extends RowData, TValue = unknown>(columns: LegacyColumnDef<TData, TValue>[], strings?: DataTableStrings): LegacyColumnDef<TData, TValue>[];
+/** Prepends the expand toggle column, built here so it always agrees with `expandedRow`. */
+export declare function addExpandColumn<TData extends RowData, TValue = unknown>(columns: LegacyColumnDef<TData, TValue>[], strings: DataTableStrings, panelId: (rowId: string) => string): LegacyColumnDef<TData, TValue>[];

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

@@ -47,6 +47,17 @@ export interface DataTableStrings {
         /** Names the full-screen table, which is a modal region. */
         fullscreenRegion: string;
     };
+    /** Expandable rows: the toggle, and the panel's loading, error and empty states. */
+    expansion: {
+        /** The toggle column's header, read by screen readers only. */
+        column: string;
+        show: (index: number) => string;
+        hide: (index: number) => string;
+        loading: string;
+        error: string;
+        retry: string;
+        empty: string;
+    };
 }
 export declare const defaultDataTableStrings: DataTableStrings;
 /** Default accessible name for the table-owned controls. */