themelia-react-ui 2.0.5 → 3.0.0

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

@@ -39,8 +39,14 @@ export interface MediaLibraryStrings {
     loading: string;
     errorTitle: string;
     errorDescription: string;
-    /** Retry action in the load error state. Defaults to "Try again". */
+    /** Retry action in the load error state and after a failed further page. Defaults to "Try again". */
     retry?: string;
+    /** Command under the results that loads the next page of a remote library. Defaults to "Load more". */
+    loadMore?: string;
+    /** Pending label of the load-more command. Defaults to "Loading more...". */
+    loadingMore?: string;
+    /** Notice when a further page fails to load; the loaded assets stay. */
+    loadMoreError?: string;
     cardDetails: string;
     /** Toolbar toggle that turns selection mode on or off. */
     selectMode: string;
@@ -48,8 +54,6 @@ export interface MediaLibraryStrings {
     selectItem: string;
     /** Accessible name of the selected-assets action region. Defaults to "Batch actions". */
     batchActionsLabel?: string;
-    privateLabel: string;
-    publicLabel: string;
     typeImage: string;
     typeVideo: string;
     typeFile: string;
@@ -81,6 +85,13 @@ export interface MediaLibraryStrings {
         replace: string;
         delete: string;
         close: string;
+        mutationError?: string;
+        confirmDeleteTitle?: string;
+        confirmDeleteDescription?: string;
+        confirmDeleteLabel?: string;
+        confirmDeleteError?: string;
+        /** Collection select placeholder for an asset that has no collection. Defaults to "No collection". */
+        noCollection?: string;
     };
     upload: {
         dropTitle: string;
@@ -96,6 +107,19 @@ export interface MediaLibraryStrings {
         removeFile: string;
         uploading: string;
         done: string;
+        error?: string;
+        /** Collection select placeholder and clearing option; nothing is sent while it shows. Defaults to "No collection". */
+        noCollection?: string;
+        /** Per-file text when its upload request fails. Defaults to "Upload failed". */
+        fileFailed?: string;
+        /** Notice for a chosen file outside the accepted types; `{name}` is the file. */
+        unsupportedType?: string;
+        /** Notice for a chosen file over `maxFileSize`; `{name}` is the file and `{size}` the limit. */
+        tooLarge?: string;
+        /** Notice when more files are chosen than `maxFiles` allows; `{count}` is the limit. */
+        tooMany?: string;
+        /** Added to the drop hint when `maxFileSize` is set; `{size}` is the limit. */
+        sizeLimitHint?: string;
     };
     footer: {
         pickOne: string;
@@ -120,12 +144,24 @@ export interface MediaLibraryStrings {
         addTile: string;
         cover: string;
         primary: string;
+        /** Accessible name of the primary command; `{name}` is the asset. */
         setPrimary: string;
+        /** Accessible name of the remove command; `{name}` is the asset. */
         remove: string;
+        /** Accessible name of the move-earlier command; `{name}` is the asset. */
         movePrevious: string;
+        /** Accessible name of the move-later command; `{name}` is the asset. */
         moveNext: string;
         itemPosition: string;
         maxReached: string;
+        /** Accessible name of a field tile's command menu; `{name}` is the asset. Defaults to "Actions for {name}". */
+        itemActions?: string;
+        /** Field-tile menu command that makes the asset the cover. Defaults to "Set as cover". */
+        setCoverAction?: string;
+        /** Field-tile menu command that moves the asset one place earlier. Defaults to "Move earlier". */
+        movePreviousAction?: string;
+        /** Field-tile menu command that moves the asset one place later. Defaults to "Move later". */
+        moveNextAction?: string;
     };
 }
 export declare const defaultMediaLibraryStrings: MediaLibraryStrings;

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

@@ -67,6 +67,13 @@ export interface MediaLibraryStagedFile {
     status: MediaLibraryUploadStatus;
     error?: string;
 }
+/** A chosen file the library did not stage, and which limit it broke. */
+export interface MediaLibraryUploadRejection {
+    /** The file's name. */
+    name: string;
+    /** `type`: outside `uploadAccept`. `size`: over `maxFileSize`. `count`: beyond `maxFiles`. */
+    reason: 'type' | 'size' | 'count';
+}
 export interface MediaLibraryFetchParams {
     /** Current search text. */
     query: string;
@@ -76,7 +83,12 @@ export interface MediaLibraryFetchParams {
     collection?: string;
     /** Current sort order. */
     sort: MediaLibrarySort;
+    /** Records to return for this page: the library's `pageSize`. */
     limit?: number;
+    /** The page being requested, starting at 1. */
+    page?: number;
+    /** The `nextCursor` of the previous page, when the fetcher returned one. Absent on the first page. */
+    cursor?: string;
     signal?: AbortSignal;
 }
 export interface MediaLibraryFetchResult<TItem = MediaLibraryItem> {
@@ -84,11 +96,17 @@ export interface MediaLibraryFetchResult<TItem = MediaLibraryItem> {
     items: TItem[];
     /** Total number of records across all pages. */
     total?: number;
+    /** Whether another page exists. Omitted, and for a plain array, the result is the last page. */
+    hasMore?: boolean;
+    /** Cursor for the next page; returning one also means another page exists. */
+    nextCursor?: string;
 }
 export type MediaLibraryFetcher<TItem = MediaLibraryItem> = (params: MediaLibraryFetchParams) => Promise<MediaLibraryFetchResult<TItem> | TItem[]>;
 export interface MediaLibraryUploadHelpers {
     /** Aborted when the user cancels or the media-library instance unmounts. */
     signal: AbortSignal;
+    /** IDs in the same order as the files passed to this upload call. */
+    fileIds?: readonly string[];
     setProgress: (fileId: string, progress: number) => void;
     setFileStatus: (fileId: string, status: MediaLibraryUploadStatus, error?: string) => void;
 }
@@ -154,6 +172,9 @@ export interface MediaLibraryDetailRenderContext<TItem = MediaLibraryItem> {
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
     update: (patch: MediaLibraryItemPatch) => Promise<boolean>;
+    /** The most recent failed mutation for this asset. */
+    mutationError?: MediaLibraryState<TItem>['mutationError'];
+    /** In MediaLibrary, resolves after the user confirms or cancels removal. */
     remove: () => Promise<boolean>;
     /** Requests the consumer's replacement workflow for this inspected item, when supported. */
     replace?: () => void;
@@ -185,7 +206,7 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     visibleItems: TItem[];
     /** Ids of the currently selected assets. */
     selectedIds: string[];
-    /** The currently selected assets, resolved from their ids. */
+    /** The selected assets that have been loaded or uploaded, including earlier server results. */
     selectedItems: TItem[];
     /** Ids of the currently selected assets, for fast lookup per row. */
     selectedSet: Set<string>;
@@ -200,14 +221,35 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     setSelecting: (selecting: boolean) => void;
     clearFilters: () => void;
     loading: boolean;
-    error: unknown;
+    /** Whether remote or newly uploaded results are available during a request. */
+    hasLoadedResults?: boolean;
+    /** The current fetch failure. Local mode has no load error. */
+    loadError?: unknown;
+    /** The most recent failed update or delete, with the affected asset ID. */
+    mutationError?: {
+        itemId: string;
+        operation: 'update' | 'delete';
+        cause: unknown;
+    } | null;
+    /** The current upload request failure, separate from individual file statuses. */
+    uploadError?: unknown;
     /** Runs the fetcher again for the current query after a failure; does nothing in local mode. */
     retry: () => void;
+    /** Whether the fetcher reported a further page for the current query. */
+    hasMore?: boolean;
+    /** Requests the next page and appends it. Does nothing without a further page or while a request runs. */
+    loadMore: () => Promise<void>;
+    /** Whether a further page is being requested. */
+    loadingMore?: boolean;
+    /** The failure of the latest further-page request; the loaded assets are kept. */
+    loadMoreError?: unknown;
     hasFilters: boolean;
     totalCount: number;
     filteredCount: number;
     /** Files chosen for upload but not yet sent. */
     stagedFiles: MediaLibraryStagedFile[];
+    /** Files from the latest selection that were not staged, with the limit each one broke. */
+    uploadRejections?: MediaLibraryUploadRejection[];
     addFiles: (files: File[]) => void;
     removeStagedFile: (id: string) => void;
     clearStagedFiles: () => void;
@@ -218,9 +260,9 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     uploading: boolean;
     startUpload: () => Promise<void>;
     cancelUpload: () => void;
-    /** Resolves `false` after rollback when the consumer mutation fails. */
+    /** Requires `onItemUpdate`. Resolves `false` when unavailable or after a failed edit rolls back. */
     updateItem: (item: TItem, patch: MediaLibraryItemPatch) => Promise<boolean>;
-    /** Resolves `false` after rollback when the consumer mutation fails. */
+    /** Requires `onItemDelete`. Resolves `false` when unavailable or after a failed delete rolls back. */
     removeItem: (item: TItem) => Promise<boolean>;
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
@@ -246,6 +288,10 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
      * the returned assets itself.
      */
     fetcher?: MediaLibraryFetcher<TItem>;
+    /** Change this key to reload the current remote query. Callback identity alone does not reload it. */
+    refreshKey?: string | number;
+    /** Records requested per page, sent to the fetcher as `limit`. Default: 48. */
+    pageSize?: number;
     /**
      * Reads id, name, URL, type, and size off your own asset shape. Omit only
      * when items already match `MediaLibraryItem`.
@@ -259,14 +305,25 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
     value?: readonly string[];
     /** Initially selected asset ids, for uncontrolled use. */
     defaultValue?: readonly string[];
-    /** Fired with the selected ids and their resolved assets. */
+    /** Fired with every selected id and the records loaded or uploaded so far. */
     onValueChange?: (ids: string[], items: TItem[]) => void;
-    /** Applies an edit to an asset's metadata. May be awaited. */
+    /** Applies a metadata edit. Without it, details are read-only. May be awaited. */
     onItemUpdate?: (item: TItem, patch: MediaLibraryItemPatch) => void | Promise<void>;
-    /** Removes an asset. May be awaited. */
+    /** Persists removal. The built-in library asks for confirmation and only offers Delete with this callback. */
     onItemDelete?: (item: TItem) => void | Promise<void>;
     /** Fired when an entry is uploaded. */
     onUpload?: MediaLibraryUploadHandler<TItem>;
+    /**
+     * File types the upload tab accepts, as a native `accept` list. It filters
+     * the file picker and rejects other files on drop. Default: `image/*,video/*`.
+     */
+    uploadAccept?: string;
+    /** Largest file the upload tab stages, in bytes. No limit by default. */
+    maxFileSize?: number;
+    /** Most files staged at once. No limit by default. */
+    maxFiles?: number;
+    /** Per-file text for a failed upload request. `MediaLibrary` supplies `strings.upload.fileFailed`. */
+    uploadFailedMessage?: string;
     /** Receives failures from the fetcher, uploads, updates, and deletes. */
     onError?: (error: unknown) => void;
     /** Current browse/upload tab, for controlled use. */
@@ -360,7 +417,7 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
      * and skipping the footer. Suits single-select pickers.
      */
     confirmOnSelect?: boolean;
-    /** Fired with the chosen assets and their ids. */
+    /** Fired with every chosen ID and the selected records loaded or uploaded so far. */
     onConfirm?: (items: TItem[], ids: string[]) => void;
     /** Fired when the user backs out without choosing. */
     onCancel?: () => void;
@@ -534,8 +591,14 @@ export interface MediaLibraryDetailPanelProps<TItem = MediaLibraryItem> {
     strings: MediaLibraryStrings;
     onClose: () => void;
     onUpdate: (patch: MediaLibraryItemPatch) => Promise<boolean>;
-    /** Fired when an entry is removed. */
+    /** Keeps metadata visible while preventing edits. */
+    readOnly?: boolean;
+    /** A failed mutation for the inspected asset. */
+    mutationError?: MediaLibraryState<TItem>['mutationError'];
+    /** Requests removal. */
     onRemove: () => Promise<boolean>;
+    /** Offers the Delete action and enables removal from custom details. Defaults to true. */
+    allowDelete?: boolean;
     /** Opens the consumer-owned replacement workflow for the inspected item. */
     onReplace?: () => void;
     /** Replaces the default detail rendering. */
@@ -550,6 +613,16 @@ export interface MediaLibraryUploadPanelProps {
     collections?: readonly MediaLibraryCollectionOption[];
     /** Whether an upload is in flight. */
     uploading?: boolean;
+    /** Shows an inline notice for a failed upload request. */
+    hasUploadError?: boolean;
+    /** File types offered by the picker. Default: `image/*,video/*`. */
+    accept?: string;
+    /** Size limit named in the drop hint and in size notices, in bytes. */
+    maxFileSize?: number;
+    /** Count limit named in count notices. */
+    maxFiles?: number;
+    /** Files from the latest selection that were not staged. */
+    rejections?: readonly MediaLibraryUploadRejection[];
     /** Overrides this surface's own copy. */
     strings: MediaLibraryStrings;
     onFiles: (files: File[]) => void;

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

@@ -3,8 +3,8 @@ 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, selecting, onSelectingChange, summary, disabled, }: MediaLibraryToolbarProps): import("react").JSX.Element;
 export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, onOpen, selecting, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryList<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, onOpen, selecting, }: MediaLibraryListProps<TItem>): import("react").JSX.Element;
-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 MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, readOnly, mutationError, onRemove, allowDelete, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
+export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, hasUploadError, accept, maxFileSize, maxFiles, rejections, 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;
+export declare function MediaLibraryFooterActions<TItem>({ tab, selectedIds, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onUpload, onCancelUpload, className, }: MediaLibraryFooterActionsProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryFooter<TItem>({ tab, selectedItems, selectedIds, selectionMode, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onClearSelection, onUpload, onCancelUpload, chrome, className, }: MediaLibraryFooterProps<TItem>): import("react").JSX.Element;

package/dist/components/features/mentions/hooks/use-mentions-search.d.ts

@@ -7,6 +7,13 @@ export interface UseMentionsSearchOptions<TResource extends string = string> {
     debounceMs?: number;
     /** Receives non-abort failures for each resource kind that could not be searched. */
     onError?: MentionsSearchErrorHandler<TResource>;
+    /**
+     * Runs searches. Default: `true`. Pass `false` while no suggestion surface
+     * is showing so a mounted composer issues no requests; the search for the
+     * current query starts when it turns `true`. `useMentions` sets it from
+     * its own picker state.
+     */
+    enabled?: boolean;
 }
 export interface UseMentionsSearchReturn<TResource extends string = string> {
     kinds: ReadonlyArray<TResource>;

package/dist/components/features/mentions/hooks/use-mentions.d.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from 'react';
+import type { FocusEvent, RefObject } from 'react';
 import type { Mention, MentionSuggestion } from '../mentions.types';
 import { type UseMentionsSearchOptions, type UseMentionsSearchReturn } from './use-mentions-search';
 /**
@@ -25,6 +25,21 @@ export interface UseMentionsReturn<TResource extends string = string> extends Us
     triggerActive: boolean;
     /** Wire to the editor's `onCaretChange` to enable inline triggers. */
     handleCaretChange: () => void;
+    /** Whether the inline suggestions panel is open. */
+    inlineOpen: boolean;
+    /** ID to pass to the inline suggestion list. */
+    listboxId: string;
+    /** Highlighted option index, or -1 when no option is highlighted. */
+    activeIndex: number;
+    /** Completion metadata for the editable body while options are available. */
+    suggestionPopup?: {
+        listboxId: string;
+        activeOptionId?: string;
+    };
+    /** Handles inline navigation and returns whether the editor should consume the key. */
+    handleKeyDown: (event: KeyboardEvent) => boolean;
+    /** Bind to the wrapper containing both the editor and inline suggestions. */
+    handleBlur: (event: FocusEvent<HTMLElement>) => void;
     /**
      * Convert a suggestion into a Mention, register it, insert the chip
      * into the editor (replacing the trigger range when one is active),

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

@@ -1,5 +1,5 @@
 export { useMentions, useMentionsSearch, type MentionEditorHandle, type UseMentionsOptions, type UseMentionsReturn, type UseMentionsSearchOptions, type UseMentionsSearchReturn, } from './hooks';
 export { MentionChip, MentionContent, MentionPicker, MentionInlineSuggestions, type MentionChipProps, type MentionContentProps, type MentionPickerProps, type MentionInlineSuggestionsProps, } from './partials';
 export { defaultMentionPickerStrings, defaultMentionInlineSuggestionsStrings, type MentionPickerStrings, type MentionInlineSuggestionsStrings, } from './mentions.strings';
-export { buildMentionHtml, splitHtmlByMentions, parseMentionsFromHtml, type MentionHtmlSegment, } from './utils';
+export { buildMentionHtml, parseMentionsFromHtml, } from './utils';
 export type { Mention, MentionResource, MentionSearchErrorContext, MentionSearchRequestContext, MentionSuggestion, MentionTone, MentionsConfig, MentionsResourceSearch, MentionsSearchErrorHandler, } from './mentions.types';

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

@@ -14,13 +14,21 @@ export interface MentionPickerStrings {
     /** Shown in place of the collection when it has no entries. */
     empty: string;
     loading: string;
+    /** Shown in place of the collection when the search failed. */
+    error?: string;
+    /** Label of the control that repeats a failed search. */
+    retry?: string;
 }
-export declare const defaultMentionPickerStrings: MentionPickerStrings;
+export declare const defaultMentionPickerStrings: Required<MentionPickerStrings>;
 export interface MentionInlineSuggestionsStrings {
     /** Surface title. */
     title: string;
     /** Shown in place of the collection when it has no entries. */
     empty: string;
     loading: string;
+    /** Shown in place of the collection when the search failed. */
+    error?: string;
+    /** Label of the control that repeats a failed search. */
+    retry?: string;
 }
-export declare const defaultMentionInlineSuggestionsStrings: MentionInlineSuggestionsStrings;
+export declare const defaultMentionInlineSuggestionsStrings: Required<MentionInlineSuggestionsStrings>;

package/dist/components/features/mentions/partials/mention-chip.d.ts

@@ -20,6 +20,7 @@ export interface MentionChipProps {
     resource?: MentionResource<string>;
     /** Force-disable the chip's link (useful inside the composer draft list). */
     asLink?: boolean;
+    /** Activates the chip. A linked chip calls it on the link; otherwise the label becomes a button. */
     onClick?: () => void;
     /** Trailing slot — typically a remove button when shown in the composer. */
     trailing?: ReactNode;

package/dist/components/features/mentions/partials/mention-inline-suggestions.d.ts

@@ -17,8 +17,19 @@ export interface MentionInlineSuggestionsProps<TResource extends string = string
     suggestionsByKind?: Readonly<Record<string, ReadonlyArray<MentionSuggestion<TResource>>>>;
     /** Matches for the text typed after the trigger character. */
     suggestions: ReadonlyArray<MentionSuggestion<TResource>>;
+    /** ID shared with the editor's controlled listbox. */
+    listboxId?: string;
+    /** Highlighted option supplied by the editor's keyboard navigation. */
+    activeIndex?: number;
     /** Replaces the content with the loading state. */
     loading: boolean;
+    /**
+     * The search for the matched kind failed. Any truthy value replaces the
+     * empty copy with the failure message; pass `useMentions().errorsByKind[kind]`.
+     */
+    error?: unknown;
+    /** Repeats the failed search; renders the retry control. */
+    onRetry?: () => void;
     /** Live query the panel echoes in the header; the consumer owns the editor input. */
     query?: string;
     /**
@@ -33,4 +44,4 @@ export interface MentionInlineSuggestionsProps<TResource extends string = string
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function MentionInlineSuggestions<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, suggestionsByKind, suggestions, loading, query, onManualKindChange, onSelect, strings: stringsProp, className, }: MentionInlineSuggestionsProps<TResource>): import("react").JSX.Element | null;
+export declare function MentionInlineSuggestions<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, suggestionsByKind, suggestions, listboxId, activeIndex, loading, error, onRetry, query, onManualKindChange, onSelect, strings: stringsProp, className, }: MentionInlineSuggestionsProps<TResource>): import("react").JSX.Element | null;

package/dist/components/features/mentions/partials/mention-picker.d.ts

@@ -21,6 +21,13 @@ export interface MentionPickerProps<TResource extends string = string> {
     suggestions: ReadonlyArray<MentionSuggestion<TResource>>;
     /** Replaces the content with the loading state. */
     loading: boolean;
+    /**
+     * The search for the browsed kind failed. Any truthy value replaces the
+     * empty copy with the failure message; pass `useMentions().errorsByKind[kind]`.
+     */
+    error?: unknown;
+    /** Repeats the failed search; renders the retry control. */
+    onRetry?: () => void;
     /** Fired when an entry is activated. */
     onSelect: (suggestion: MentionSuggestion<TResource>) => void;
     /** Overrides this surface's own copy. */
@@ -28,4 +35,4 @@ export interface MentionPickerProps<TResource extends string = string> {
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function MentionPicker<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, query, setQuery, suggestions, loading, onSelect, strings: stringsProp, className, }: MentionPickerProps<TResource>): import("react").JSX.Element | null;
+export declare function MentionPicker<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, query, setQuery, suggestions, loading, error, onRetry, onSelect, strings: stringsProp, className, }: MentionPickerProps<TResource>): import("react").JSX.Element | null;

package/dist/components/features/mentions/partials/mention-search-error.d.ts

@@ -0,0 +1,6 @@
+export interface MentionSearchErrorProps {
+    message: string;
+    retryLabel: string;
+    onRetry?: () => void;
+}
+export declare function MentionSearchError({ message, retryLabel, onRetry }: MentionSearchErrorProps): import("react").JSX.Element;

package/dist/components/features/mentions/utils/index.d.ts

@@ -1,3 +1,2 @@
 export { buildMentionHtml } from './build-mention-html';
-export { splitHtmlByMentions, type MentionHtmlSegment, } from './split-html-by-mentions';
 export { parseMentionsFromHtml } from './parse-mentions-from-html';

package/dist/components/features/overlays/alert-dialog.d.ts

@@ -1,4 +1,4 @@
 import type { ConfirmDialogProps } from './overlays.types';
-declare function ConfirmDialogImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, className, contentClassName, surfaceStyle, initialFocusRef, closeOnEscape, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, tone, showIcon, alertMessage, trigger, destructive, align, }: ConfirmDialogProps): import("react").JSX.Element;
+declare function ConfirmDialogImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, className, contentClassName, surfaceStyle, initialFocusRef, finalFocus, closeOnEscape, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, tone, showIcon, alertMessage, trigger, destructive, align, }: ConfirmDialogProps): import("react").JSX.Element;
 export declare const ConfirmDialog: import("react").MemoExoticComponent<typeof ConfirmDialogImpl>;
 export {};

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

@@ -1,4 +1,4 @@
 import type { ActionDialogProps } from './overlays.types';
-declare function ActionDialogImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, className, contentClassName, showCloseButton, surfaceStyle, initialFocusRef, closeOnEscape, closeOnBackdropClick, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, emphasis, tone, showIcon, alertMessage, size, trigger, align, }: ActionDialogProps): import("react").JSX.Element;
+declare function ActionDialogImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, className, contentClassName, showCloseButton, surfaceStyle, initialFocusRef, finalFocus, closeOnEscape, closeOnBackdropClick, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, emphasis, tone, showIcon, alertMessage, size, trigger, align, }: ActionDialogProps): import("react").JSX.Element;
 export declare const ActionDialog: import("react").MemoExoticComponent<typeof ActionDialogImpl>;
 export {};

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

@@ -1,4 +1,4 @@
 import type { ActionDrawerProps } from './overlays.types';
-declare function ActionDrawerImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, showCloseButton, className, contentClassName, surfaceStyle, initialFocusRef, closeOnEscape, closeOnBackdropClick, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, emphasis, tone, showIcon, alertMessage, direction, width, showFooter, modal, trigger, }: ActionDrawerProps): import("react").JSX.Element;
+declare function ActionDrawerImpl({ open, onOpenChange, onClose, children, title, description, visuallyHideHeader, showCloseButton, className, contentClassName, surfaceStyle, initialFocusRef, finalFocus, closeOnEscape, closeOnBackdropClick, strings: customStrings, showCancel, showConfirm, onCancel, onConfirm, onAsyncConfirm, onError, closeOnAsyncComplete, confirmTone, confirmStyle, loading, formId, footer, emphasis, tone, showIcon, alertMessage, direction, width, showFooter, modal, trigger, }: ActionDrawerProps): import("react").JSX.Element;
 export declare const ActionDrawer: import("react").MemoExoticComponent<typeof ActionDrawerImpl>;
 export {};

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

@@ -11,7 +11,7 @@ export interface UseOverlayVisibilityOptions {
     defaultOpen?: boolean;
     /** Controlled visibility. Omit to let the hook own it. */
     open?: boolean;
-    /** Fired once for every actual visibility change. */
+    /** Fired for each request that differs from the current visibility. */
     onOpenChange?: (open: boolean) => void;
     /** Fired after a change to open. */
     onOpen?: () => void;
@@ -33,7 +33,7 @@ export interface UseOverlayVisibilityGroupOptions<TKey extends string = string>
     defaultOpen?: Partial<Record<TKey, boolean>>;
     /** Controlled visibility per key. */
     open?: Partial<Record<TKey, boolean>>;
-    /** Fired once for every actual change, with the key, its visibility and the next group state. */
+    /** Fired for each requested change, with the key, its visibility and the proposed group state. */
     onOpenChange?: (key: TKey, open: boolean, state: OverlayVisibilityGroupState<TKey>) => void;
     /** Opening one key closes the others, for one-at-a-time overlays. Default: `false`. */
     closeOthersOnOpen?: boolean;

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

@@ -2,5 +2,5 @@ export { ActionDialog } from './dialog';
 export { ActionDrawer } from './drawer';
 export { ConfirmDialog } from './alert-dialog';
 export { useOverlayActions, type UseOverlayActionsOptions, type UseOverlayActionsReturn, useOverlayVisibility, useOverlayVisibilityGroup, type OverlayOpenSetter, type OverlayVisibilityGroupState, type OverlayVisibilityProps, type UseOverlayVisibilityGroupOptions, type UseOverlayVisibilityGroupReturn, type UseOverlayVisibilityOptions, type UseOverlayVisibilityReturn, } from './hooks';
-export type { OverlayTone, OverlaySize, DrawerDirection, OverlayAlign, OverlayButtonTone, OverlayButtonStyle, OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps, ActionDialogProps, ActionDrawerProps, ConfirmDialogProps, } from './overlays.types';
-export { defaultOverlayStrings, defaultAlertDialogStrings, type OverlayStrings, } from './overlays.strings';
+export type { OverlayTone, OverlaySize, DrawerDirection, OverlayAlign, OverlayButtonTone, OverlayButtonStyle, OverlayBaseProps, OverlayFinalFocus, OverlayInteractionType, OverlayActionProps, OverlayEmphasisProps, ActionDialogProps, ActionDrawerProps, ConfirmDialogProps, } from './overlays.types';
+export { defaultOverlayStrings, defaultConfirmDialogStrings, type OverlayStrings, } from './overlays.strings';

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

@@ -16,4 +16,5 @@ export interface OverlayStrings {
     alertDialogLabel: string;
 }
 export declare const defaultOverlayStrings: OverlayStrings;
-export declare const defaultAlertDialogStrings: OverlayStrings;
+/** ConfirmDialog's defaults, under the `default<Component>Strings` name. */
+export declare const defaultConfirmDialogStrings: OverlayStrings;

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

@@ -17,6 +17,10 @@ export type DrawerDirection = 'left' | 'right' | 'top' | 'bottom';
  */
 export type { OverlayAlign };
 /** Presentation and lifecycle shared by every overlay in this family. */
+/** How an overlay was opened or closed, as Base UI reports it. */
+export type OverlayInteractionType = 'mouse' | 'touch' | 'pen' | 'keyboard' | '';
+/** Accepted by `finalFocus` on ActionDialog, ActionDrawer and ConfirmDialog; Base UI's final-focus option. */
+export type OverlayFinalFocus = boolean | RefObject<HTMLElement | null> | ((closeType: OverlayInteractionType) => boolean | HTMLElement | null | void);
 export interface OverlayBaseProps {
     /** Visibility, for controlled use. Omit to let the overlay own it via `trigger`. */
     open?: boolean;
@@ -59,6 +63,20 @@ export interface OverlayBaseProps {
      * `useRef<HTMLInputElement>(null)` ref directly.
      */
     initialFocusRef?: RefObject<HTMLElement | null>;
+    /**
+     * Where focus goes when the overlay closes. Default: back to the element
+     * that opened it. Forwarded to Base UI's own `finalFocus`:
+     *
+     * - a ref — focus that element;
+     * - a function — called with how the overlay was closed (`'mouse'`,
+     *   `'touch'`, `'pen'`, `'keyboard'` or `''`); return an element to focus,
+     *   `true` or `null` for the default, `false` or nothing to leave focus alone;
+     * - `false` — do not move focus; `true` — the default.
+     *
+     * Use it when the opener is gone by the time the overlay closes (a deleted
+     * row, a menu item) or when the next step should take focus.
+     */
+    finalFocus?: OverlayFinalFocus;
     /** Allows Escape to dismiss. Default: `true`. Set `false` for destructive or in-progress work. */
     closeOnEscape?: boolean;
     /** Allows a backdrop click to dismiss. Default: `true`. */
@@ -84,7 +102,12 @@ export interface OverlayActionProps {
     showCancel?: boolean;
     /** Renders the confirm button. */
     showConfirm?: boolean;
-    /** Fired when cancel is chosen, just before the overlay closes. */
+    /**
+     * Fired when cancel is chosen, just before the overlay closes. On
+     * `ConfirmDialog` Escape is a decline too, so it fires there as well. On
+     * `ActionDialog` and `ActionDrawer` it is the Cancel button only; use
+     * `onClose` to hear every dismissal (Escape, the close control, the backdrop).
+     */
     onCancel?: () => void;
     /** Synchronous confirm. Takes precedence over `onAsyncConfirm`; closes on return. */
     onConfirm?: () => void;
@@ -117,7 +140,8 @@ export interface OverlayActionProps {
     /**
      * Replaces the generated footer; the consumer owns its action states.
      * Pending dismissal protection still applies. Custom actions that close the
-     * overlay use controlled visibility (`useOverlayVisibility`).
+     * overlay use controlled visibility (`useOverlayVisibility`). `null` renders
+     * no footer at all; leave it `undefined` to keep the generated one.
      */
     footer?: ReactNode;
 }
@@ -186,7 +210,7 @@ export interface ActionDrawerProps extends OverlayBaseProps, OverlayActionProps,
  * A short confirmation for a single decision. Prefer `ActionDialog` when the
  * body needs real content — this one is sized for a question and two answers.
  */
-export interface ConfirmDialogProps extends OverlayBaseProps, OverlayActionProps {
+export interface ConfirmDialogProps extends Omit<OverlayBaseProps, 'closeOnBackdropClick' | 'showCloseButton'>, OverlayActionProps {
     /**
      * Aligns the icon, title, description and actions together. Below the `sm`
      * breakpoint the actions stack full width either way. Default: the
@@ -203,11 +227,4 @@ export interface ConfirmDialogProps extends OverlayBaseProps, OverlayActionProps
     trigger?: ReactNode;
     /** Shorthand for the destructive presentation. */
     destructive?: boolean;
-    /**
-     * Not used: a confirmation needs an explicit answer, so an outside press
-     * never dismisses it. Escape still cancels unless `closeOnEscape` is `false`.
-     */
-    closeOnBackdropClick?: boolean;
-    /** Not used: a confirmation has no corner dismiss control; Cancel or Escape declines. */
-    showCloseButton?: boolean;
 }

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

@@ -1,15 +1,5 @@
-export { ProductContractOverview } from './product-contract-overview';
-export { ProductDetailsCard } from './product-details-card';
-export { ProductOptionActionMenu } from './product-option-action-menu';
-export { ProductOperationsCard } from './product-operations-card';
 export { ProductOptionsMatrix } from './product-options-matrix';
-export { ProductOptionsSummary } from './product-options-summary';
 export { ProductOverview } from './product-overview';
-export { ProductPoliciesCard } from './product-policies-card';
-export { ProductQuotePreviewCard } from './product-quote-preview-card';
-export { ProductReadinessCard } from './product-readiness-card';
-export { ProductStructureCard } from './product-structure-card';
-export { ProductVariantActionMenu } from './product-variant-action-menu';
 export { ProductVariantDetails } from './product-variant-details';
 export { ProductVariantEditor } from './product-variant-editor';
 export { ProductVariantsBulkTable } from './product-variants-bulk-table';

package/dist/components/features/products/components/product-contract-overview.d.ts

@@ -2,7 +2,7 @@ import type { ProductContractOverviewProps } from '../products.types';
 /**
  * One main column region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `contract` prop (still typed `ProductContractOverviewProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductContractOverview({ metrics, terms, rules, onOpenContract, onEditContract, onCreateRule, onSelectRule, onEditRule, onDeleteRule, renderRuleActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductContractOverviewProps): import("react").JSX.Element;
 export declare namespace ProductContractOverview {

package/dist/components/features/products/components/product-details-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductDetailsCardProps } from '../products.types';
 /**
  * One main column region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `details` prop (still typed `ProductDetailsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductDetailsCard({ title, description, metadata, media, onEditDetails, actions, headerEnd, footerSlot, empty, className, strings: stringsProp, }: ProductDetailsCardProps): import("react").JSX.Element;
 export declare namespace ProductDetailsCard {

package/dist/components/features/products/components/product-operations-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductOperationsCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `operations` prop (still typed `ProductOperationsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductOperationsCard({ items, onCreateOperation, onSelectOperation, onEditOperation, onDeleteOperation, renderOperationActions, actions, footerSlot, renderItem, empty, className, strings: stringsProp, }: ProductOperationsCardProps): import("react").JSX.Element;
 export declare namespace ProductOperationsCard {