themelia-react-ui 2.0.6 → 3.0.0

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,6 +96,10 @@ 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 {
@@ -207,8 +223,6 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     loading: boolean;
     /** Whether remote or newly uploaded results are available during a request. */
     hasLoadedResults?: boolean;
-    /** Legacy operation error. Cleared when the next load, mutation or upload starts. */
-    error: unknown;
     /** The current fetch failure. Local mode has no load error. */
     loadError?: unknown;
     /** The most recent failed update or delete, with the affected asset ID. */
@@ -221,11 +235,21 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     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;
@@ -266,6 +290,8 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
     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`.
@@ -287,6 +313,17 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
     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. */
@@ -578,6 +615,14 @@ export interface MediaLibraryUploadPanelProps {
     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

@@ -4,7 +4,7 @@ export declare function MediaLibraryToolbar({ query, type, typeFilters, collecti
 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, readOnly, mutationError, onRemove, allowDelete, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
-export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, hasUploadError, strings, onFiles, onRemoveFile, onOptionsChange, empty, }: MediaLibraryUploadPanelProps): import("react").JSX.Element;
+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, 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/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

@@ -23,6 +23,13 @@ export interface MentionInlineSuggestionsProps<TResource extends string = string
     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;
     /**
@@ -37,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, listboxId, activeIndex, 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/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 {

package/dist/components/features/products/components/product-option-action-menu.d.ts

@@ -2,7 +2,7 @@ import type { ProductOptionActionMenuProps } from '../products.types';
 /**
  * Row menu for one product option.
  *
- * @deprecated An internal part of `ProductOptionsSummary` (and so of `ProductOverview`), which renders it for every option. Replace it there with `renderOptionActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.
+ * Internal part of the option and variant surfaces; not exported from the family.
  */
 export declare function ProductOptionActionMenu({ option, index, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, menuLabel, className, strings: stringsProp, }: ProductOptionActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductOptionActionMenu {

package/dist/components/features/products/components/product-options-summary.d.ts

@@ -2,7 +2,7 @@ import type { ProductOptionsSummaryProps } from '../products.types';
 /**
  * One main column region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `options` prop (still typed `ProductOptionsSummaryProps`). 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 ProductOptionsSummary({ options, onManageOptions, onCreateOption, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, actions, footerSlot, renderOption, empty, className, strings: stringsProp, }: ProductOptionsSummaryProps): import("react").JSX.Element;
 export declare namespace ProductOptionsSummary {

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

@@ -2,7 +2,7 @@ import type { ProductPoliciesCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `policies` prop (still typed `ProductPoliciesCardProps`). 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 ProductPoliciesCard({ policies, onCreatePolicy, onSelectPolicy, onEditPolicy, onDeletePolicy, renderPolicyActions, actions, footerSlot, renderPolicy, empty, className, strings: stringsProp, }: ProductPoliciesCardProps): import("react").JSX.Element;
 export declare namespace ProductPoliciesCard {

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

@@ -2,7 +2,7 @@ import type { ProductQuotePreviewCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `quote` prop (still typed `ProductQuotePreviewCardProps`). 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 ProductQuotePreviewCard({ lines, subtotal, tax, discount, total, onOpenQuote, onCreateLine, onSelectLine, onEditLine, onDeleteLine, renderLineActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductQuotePreviewCardProps): import("react").JSX.Element;
 export declare namespace ProductQuotePreviewCard {

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

@@ -2,7 +2,7 @@ import type { ProductReadinessCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `readiness` prop (still typed `ProductReadinessCardProps`). 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 ProductReadinessCard({ items, score, scoreLabel, summary, onCreateReadinessItem, onSelectReadinessItem, onEditReadinessItem, onDeleteReadinessItem, renderReadinessItemActions, actions, footerSlot, renderItem, empty, className, strings: stringsProp, }: ProductReadinessCardProps): import("react").JSX.Element;
 export declare namespace ProductReadinessCard {

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

@@ -2,7 +2,7 @@ import type { ProductStructureCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `structure` prop (still typed `ProductStructureCardProps`). 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 ProductStructureCard({ metrics, onCreateMetric, onSelectMetric, onEditMetric, onDeleteMetric, renderMetricActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductStructureCardProps): import("react").JSX.Element;
 export declare namespace ProductStructureCard {

package/dist/components/features/products/components/product-variant-action-menu.d.ts

@@ -18,7 +18,7 @@ export declare function productVariantMenuActions(variant: ProductVariantSummary
 /**
  * Row menu for one product variant.
  *
- * @deprecated An internal part of the variant tables and `ProductVariantDetails`, which render it for every variant. Replace it there with `renderVariantActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.
+ * Internal part of the option and variant surfaces; not exported from the family.
  */
 export declare function ProductVariantActionMenu({ variant, index, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, menuLabel, className, strings: stringsProp, }: ProductVariantActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductVariantActionMenu {

package/dist/components/features/products/components/product-variants-manager.d.ts

@@ -1,5 +1,5 @@
 import type { ProductVariantsManagerProps } from '../products.types';
-export declare function ProductVariantsManager({ optionGroups, variants, visibleColumns, optionCombinationDisplay, cellDisplay, selectionMode, renderOptionCombination, renderCell, selectedVariantIds, defaultSelectedVariantIds, onSelectedVariantIdsChange, onVariantFieldChange, onVariantFieldBlur, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onError, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onBulkEdit, onBulkApply, onBulkDelete, renderVariantActions, renderBulkActions, groupByOptionId, defaultGroupByOptionId, onGroupByOptionIdChange, showGroupBy, onSearchVariants, onFilterVariants, controlsEnd, actions, headerEnd, footerSlot, surface, padding, headerDivider, footerDivider, className, strings: stringsProp, optionsStrings, variantsStrings, }: ProductVariantsManagerProps): import("react").JSX.Element;
+export declare function ProductVariantsManager({ optionGroups, variants, visibleColumns, optionCombinationDisplay, cellDisplay, selectionMode, renderOptionCombination, renderCell, selectedVariantIds, defaultSelectedVariantIds, onSelectedVariantIdsChange, onVariantFieldChange, onVariantFieldBlur, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, confirmDelete, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onError, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onBulkEdit, onBulkApply, onBulkDelete, renderVariantActions, renderBulkActions, groupByOptionId, defaultGroupByOptionId, onGroupByOptionIdChange, showGroupBy, onSearchVariants, onFilterVariants, controlsEnd, actions, headerEnd, footerSlot, surface, padding, headerDivider, footerDivider, className, strings: stringsProp, optionsStrings, variantsStrings, }: ProductVariantsManagerProps): import("react").JSX.Element;
 export declare namespace ProductVariantsManager {
     var displayName: string;
 }

package/dist/components/features/products/components/product-variants-table.d.ts

@@ -1,5 +1,5 @@
 import type { ProductVariantsTableProps } from '../products.types';
-export declare function ProductVariantsTable({ variants, onCreateVariant, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductVariantsTableProps): import("react").JSX.Element;
+export declare function ProductVariantsTable({ variants, onCreateVariant, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, actions, footerSlot, empty, storageKey, className, strings: stringsProp, }: ProductVariantsTableProps): import("react").JSX.Element;
 export declare namespace ProductVariantsTable {
     var displayName: string;
 }

package/dist/components/features/products/partials/product-surface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Product surfaces used to render through the deprecated ContentBlock adapter
+ * and now compose Card directly. They keep the DOM hooks that adapter painted,
+ * so consumer selectors written against them still match.
+ */
+export declare function productBlockProps(className?: string): {
+    readonly surface: "flat";
+    readonly padding: "none";
+    readonly 'data-component': "content-block";
+    readonly 'data-slot': "content-block";
+    readonly className: string;
+    readonly headerClassName: "content-block--header";
+    readonly contentClassName: "content-block--content";
+    readonly footerClassName: "content-block--footer";
+};

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

@@ -132,7 +132,11 @@ export interface ProductOptionsMatrixStrings {
     collapseOptionLabel: string;
     actionsLabel: string;
     optionNameLabel: string;
+    /** Shown under the option name when a save is attempted with a blank name. */
+    optionNameRequiredMessage?: string;
     optionValuesLabel: string;
+    /** Shown under a value when a save is attempted with a blank label. */
+    optionValueRequiredMessage?: string;
     valuesLabel: string;
     useForVariantsLabel: string;
     usedForVariantsLabel: string;
@@ -238,6 +242,8 @@ export interface ProductVariantsManagerStrings {
     optionsTitle: string;
     variantsTitle: string;
     groupByLabel: string;
+    /** Group by choice that leaves the variant list flat. */
+    noGroupingLabel?: string;
     searchLabel: string;
     filterLabel: string;
     generateLabel: string;
@@ -265,6 +271,8 @@ export interface ProductVariantDetailsStrings {
     viewOptionLabel: string;
     emptyTitle: string;
     emptyDescription: string;
+    /** Labels of the variant commands in the header's overflow menu. Omitted keys keep the action-menu defaults. */
+    variantActions?: Partial<ProductVariantActionMenuStrings>;
     /** Label/value facts rendered as a metadata list. */
     metadata: {
         price: string;