themelia-react-ui 2.0.4 → 2.0.5

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

@@ -63,6 +63,10 @@ export interface FilterStrings {
     activeFilters: string;
     clearSearch: string;
     backToFilters: string;
+    /** Returns from a nested option level to its parent level. */
+    previousLevel: string;
+    /** Chooses the nested option level being viewed, when branches are selectable. */
+    selectCurrentLevel: string;
     select: string;
     options: string;
     operator: string;

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

@@ -64,6 +64,7 @@ export interface FilterOption {
     value: string;
     /** Leading glyph. */
     icon: ReactNode;
+    /** Nested options. SELECT and MULTI_SELECT editors show them level by level, and a chosen option reads as its path. */
     children?: FilterOption[];
     /** Renders the entry as unselectable. */
     disabled?: boolean;
@@ -167,6 +168,8 @@ export interface FilterConfig {
     validation?: ValidationConfig;
     dependencies?: FilterDependency[];
     multiple?: boolean;
+    /** For nested options: only leaves can be chosen (default), or any option, including a branch. */
+    selectableOptions?: 'leaf' | 'any';
     closeOnSelect?: boolean;
     maxSelected?: number;
     /** Async option loading config for ASYNC_SELECT filters. */

package/dist/components/features/filters/partials/filter-editor-header.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+interface FilterEditorHeaderProps {
+    /** The filter label shown as the editor title. */
+    title: ReactNode;
+    /** Optional supporting line under the title. */
+    description?: ReactNode;
+    /** Returns to the filter list; the back button shows only when this is set. */
+    onBack?: () => void;
+}
+/**
+ * The one header every value editor uses — list, date and tag editors alike:
+ * an optional back button and the filter label as the popover title, set in
+ * the compact editor surface so every editor starts on the same band.
+ */
+export declare function FilterEditorHeader({ title, description, onBack }: FilterEditorHeaderProps): import("react").JSX.Element;
+export {};

package/dist/components/features/filters/partials/filter-popover-content.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentProps } from 'react';
+import { type ComponentProps } from 'react';
 import { PopoverContent } from '../../../base/popover';
 import { type FilterConfig, type FilterTriggerSource } from '../filters.types';
 export interface FilterPopoverContentProps {

package/dist/components/features/filters/partials/nested-filter-options.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from 'react';
+import type { FilterConfig } from '../filters.types';
+interface NestedFilterOptionsProps {
+    /** Definition of the filter this control edits; its options nest `children`. */
+    filter: FilterConfig;
+    /** Current draft value. */
+    value: string[];
+    /** Whether several options can be chosen. */
+    multiple: boolean;
+    /** Receives the next draft value. */
+    onChange: (value: string[]) => void;
+    /** The editor's header, shown at the root level; a drilled level shows its own header and path instead. */
+    header: ReactNode;
+}
+/**
+ * NestedFilterOptions — the SELECT / MULTI_SELECT editor body for options with
+ * `children`. It shows one level at a time through the shared cascader panel,
+ * with path search across every level, inside the filter's own popover.
+ */
+export declare function NestedFilterOptions({ filter, value, multiple, onChange, header }: NestedFilterOptionsProps): import("react").JSX.Element;
+export {};

package/dist/components/features/filters/partials/regular-filter-content.d.ts

@@ -22,7 +22,8 @@ interface RegularFilterContentProps {
  *     the trailing edge — only rendered when the user has changed selection.
  *
  * Sizes are tuned to feel like a native menu, not a card. Popover width
- * stays at ~260-300px so labels read at one glance.
+ * stays at ~260-300px so labels read at one glance. Options with `children`
+ * replace the flat list with one level at a time (NestedFilterOptions).
  */
 export declare function RegularFilterContent({ filter, value, onFilterChange, onBackToFilterList, onClose, triggerSource, }: RegularFilterContentProps): import("react").JSX.Element;
 export {};

package/dist/components/features/filters/utils/filter-utils.d.ts

@@ -1,9 +1,27 @@
 import type { ReactNode } from 'react';
-import type { FilterConfig, FilterDependency } from '../filters.types';
+import type { CascaderNode } from '../../../base/cascader';
+import type { FilterConfig, FilterDependency, FilterOption } from '../filters.types';
 /**
- * Gets the label for a filter option
+ * The option for a value and its ancestors, searching nested options.
  */
-export declare function getFilterOptionLabel(filter: FilterConfig, value: string): string | undefined;
+export declare function findFilterOptionPath(options: readonly FilterOption[] | undefined, value: string): FilterOption[];
+/**
+ * A sentence-case label inside running text, such as a footer count:
+ * "Created date" reads "created date", while acronyms such as "SKU" stay.
+ */
+export declare function labelInRunningText(label: string): string;
+/**
+ * Whether any option nests children, so the editor shows them level by level.
+ */
+export declare function hasNestedFilterOptions(options?: readonly FilterOption[]): boolean;
+/**
+ * Nested filter options as cascader nodes.
+ */
+export declare function toCascaderNodes(options: readonly FilterOption[]): CascaderNode[];
+/**
+ * Gets the label for a filter option; a nested option reads as its path, such as "Europe / Greece".
+ */
+export declare function getFilterOptionLabel(filter: FilterConfig, value: string, separator?: string): string | undefined;
 /**
  * Gets the icon for a filter option
  */

package/dist/components/features/global-search/global-search.types.d.ts

@@ -85,6 +85,8 @@ export interface GlobalSearchRenderResultContext {
     query: string;
     /** Fired when an entry is activated. */
     onSelect: () => void;
+    /** Id of the option wrapping this row, which the search field names as its active descendant. */
+    optionId?: string;
 }
 /** Slot map — every consumer-overridable surface. */
 export interface GlobalSearchSlots<TGroup extends string = string> {

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

@@ -13,5 +13,15 @@ export interface GlobalSearchInputProps {
     loading?: boolean;
     /** Focuses the control on mount. */
     autoFocus?: boolean;
+    /**
+     * Whether the results list is showing. Setting it makes the field a
+     * combobox (`role="combobox"`, `aria-expanded`), the pattern for a search
+     * whose results are navigated with the arrow keys while focus stays here.
+     */
+    expanded?: boolean;
+    /** Id(s) of the results listbox(es) the combobox controls, while expanded. */
+    controls?: string;
+    /** Id of the highlighted result, announced as the active option. */
+    activeDescendant?: string;
 }
 export declare const GlobalSearchInput: React.ForwardRefExoticComponent<GlobalSearchInputProps & React.RefAttributes<HTMLInputElement>>;

package/dist/components/features/global-search/partials/global-search-result-row.d.ts

@@ -10,7 +10,13 @@ export interface GlobalSearchResultRowProps<TGroup extends string = string> {
     /** Fired when an entry is activated. */
     onSelect?: () => void;
     onMouseEnter?: () => void;
+    /**
+     * Id of this row as an option of a results listbox. When set, the row is a
+     * `role="option"` reached through the search field's active descendant
+     * rather than by Tab; standalone rows stay plain buttons.
+     */
+    optionId?: string;
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function GlobalSearchResultRow<TGroup extends string = string>({ result, active, query, onSelect, onMouseEnter, className, }: GlobalSearchResultRowProps<TGroup>): React.JSX.Element;
+export declare function GlobalSearchResultRow<TGroup extends string = string>({ result, active, query, onSelect, onMouseEnter, optionId, className, }: GlobalSearchResultRowProps<TGroup>): React.JSX.Element;

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

@@ -39,6 +39,8 @@ export interface MediaLibraryStrings {
     loading: string;
     errorTitle: string;
     errorDescription: string;
+    /** Retry action in the load error state. Defaults to "Try again". */
+    retry?: string;
     cardDetails: string;
     /** Toolbar toggle that turns selection mode on or off. */
     selectMode: string;

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

@@ -201,6 +201,8 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     clearFilters: () => void;
     loading: boolean;
     error: unknown;
+    /** Runs the fetcher again for the current query after a failure; does nothing in local mode. */
+    retry: () => void;
     hasFilters: boolean;
     totalCount: number;
     filteredCount: number;
@@ -419,14 +421,18 @@ export interface MediaResourceGalleryItemRenderContext<TItem = MediaLibraryItem>
     id: string;
     /** Zero-based position of the entry in its list. */
     index: number;
-    /** Total number of records across all pages. */
+    /** Number of attached items in this gallery. */
     total: number;
     primary: boolean;
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
+    /** Whether reordering is supported, writable, and an earlier position exists. */
     canMovePrevious: boolean;
+    /** Whether reordering is supported, writable, and a later position exists. */
     canMoveNext: boolean;
+    /** Keeps its callable shape; does nothing in read-only mode or without its handler. */
     setPrimary: () => void;
+    /** Keeps its callable shape; does nothing in read-only mode or without its handler. */
     remove: () => void;
     movePrevious: () => void;
     moveNext: () => void;
@@ -442,11 +448,11 @@ export interface MediaResourceGalleryProps<TItem = MediaLibraryItem> extends Omi
     description?: ReactNode;
     /** Id of the asset marked primary — the resource's cover image. */
     primaryId?: string;
-    /** Fired when a different asset is promoted to primary. */
+    /** Fired when a different asset is promoted to primary. Omit to hide the default primary command. */
     onPrimaryChange?: (id: string, item: TItem) => void;
-    /** Fired when an asset is detached from the resource. */
+    /** Fired when an asset is detached from the resource. Omit to hide the default remove command. */
     onRemove?: (id: string, item: TItem) => void;
-    /** Fired with the next order after a drag. */
+    /** Fired with the next order from a move command. Omit to hide default reorder commands. */
     onReorder?: (ids: string[], items: TItem[]) => void;
     /** Fired when the user asks to attach more assets — usually opens the library dialog. */
     onAdd?: () => void;
@@ -583,6 +589,10 @@ export interface MediaLibraryToolbarProps {
     selecting?: boolean;
     /** Renders the Select toggle, which turns selection mode on or off. */
     onSelectingChange?: (selecting: boolean) => void;
+    /** Result summary, such as the item count; it sits with the view controls. */
+    summary?: ReactNode;
+    /** Disables every control, for example while the collection failed to load. */
+    disabled?: boolean;
 }
 export interface MediaLibraryFooterSummaryProps {
     /** Which tab is showing — browse or upload. */

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

@@ -1,6 +1,6 @@
 import type { MediaLibraryCardProps, MediaLibraryDetailPanelProps, MediaLibraryEmptyStateProps, MediaLibraryFooterActionsProps, MediaLibraryFooterProps, MediaLibraryFooterSummaryProps, MediaLibraryListProps, MediaLibraryToolbarProps, MediaLibraryUploadPanelProps } from '../media-library.types';
 export declare function MediaLibraryEmptyState({ icon, title, description, action, className, }: MediaLibraryEmptyStateProps): import("react").JSX.Element;
-export declare function MediaLibraryToolbar({ query, type, typeFilters, collection, sort, view, collections, strings, onQueryChange, onTypeChange, onCollectionChange, onSortChange, onViewChange, onClearFilters, toolbarEnd, selecting, onSelectingChange, }: MediaLibraryToolbarProps): import("react").JSX.Element;
+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;

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

@@ -1,5 +1,5 @@
 import type { ProductOptionsMatrixProps } from '../products.types';
-export declare function ProductOptionsMatrix({ optionGroups, surface, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, confirmDelete, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, showHeader: showHeaderProp, showCollapseControls, showInlineActions, showVariantToggle, actions, headerEnd, footerSlot, empty, className, strings: stringsProp, }: ProductOptionsMatrixProps): import("react").JSX.Element;
+export declare function ProductOptionsMatrix({ optionGroups, surface, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, confirmDelete, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onError, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, showHeader: showHeaderProp, showCollapseControls, showInlineActions, showVariantToggle, actions, headerEnd, footerSlot, empty, className, strings: stringsProp, }: ProductOptionsMatrixProps): import("react").JSX.Element;
 export declare namespace ProductOptionsMatrix {
     var displayName: string;
 }

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

@@ -1,5 +1,5 @@
 import type { ProductVariantEditorProps } from '../products.types';
-export declare function ProductVariantEditor({ value: valueProp, defaultValue, optionFields, statusOptions, onValueChange, onSubmit, onError, onCancel, onDelete, actions, headerEnd, footerSlot, disabled, submitting, className, strings: stringsProp, }: ProductVariantEditorProps): import("react").JSX.Element;
+export declare function ProductVariantEditor({ value: valueProp, defaultValue, optionFields, statusOptions, onValueChange, onSubmit, onError, onCancel, onDelete, actions, headerEnd, footerSlot, visibleFields, errors, formId: formIdProp, showHeader, children, disabled, submitting, className, strings: stringsProp, }: ProductVariantEditorProps): import("react").JSX.Element;
 export declare namespace ProductVariantEditor {
     var displayName: string;
 }

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, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onBulkEdit, onBulkApply, onBulkDelete, renderVariantActions, renderBulkActions, groupByOptionId, defaultGroupByOptionId, onGroupByOptionIdChange, 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, 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/products.strings.d.ts

@@ -109,7 +109,7 @@ export interface ProductOptionsMatrixStrings {
     /** Title of the confirmation shown when saving would drop option values. */
     confirmRemoveValuesTitle: string;
     /**
-     * Consequence of saving an edit that drops values. Receives `{count}`, the
+     * Consequence of saving an edit that drops values. Receives `{{count}}`, the
      * number of values the save removes.
      */
     confirmRemoveValuesDescription: string;
@@ -119,6 +119,14 @@ export interface ProductOptionsMatrixStrings {
     confirmDeleteOptionDescription: string;
     doneLabel: string;
     saveLabel: string;
+    /** Pending option-save copy. Optional for compatibility with complete legacy string objects. */
+    savingLabel?: string;
+    /** Heading for a rejected option save. */
+    saveErrorTitle?: string;
+    /** Fallback when a rejection has no displayable Error message. */
+    saveErrorMessage?: string;
+    /** Save command after a rejected option save. */
+    retrySaveLabel?: string;
     cancelLabel: string;
     expandOptionLabel: string;
     collapseOptionLabel: string;

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

@@ -174,7 +174,7 @@ export interface ProductDetailsCardProps {
     description?: ReactNode | false;
     /** Label/value facts rendered as a metadata list. */
     metadata?: MetadataListItem[];
-    /** Leading media for the card. */
+    /** Leading media; remains visible when no metadata facts are supplied. */
     media?: ReactNode;
     /** Fired when a details is edited. */
     onEditDetails?: () => void;
@@ -406,8 +406,12 @@ export interface ProductOptionsMatrixProps {
     onValueLabelChange?: (option: ProductOptionGroup, value: ProductOptionValue, label: string) => void;
     /** Fired when editing an editing option finishes. */
     onDoneEditingOption?: (option: ProductOptionGroup) => void;
-    /** Fired when an editing option is saved. */
-    onSaveEditingOption?: (option: ProductOptionGroup, draft: ProductOptionEditDraft) => void;
+    /** Saves the option draft. A Promise keeps editing locked until acceptance;
+     * rejection retains the draft, shows an error and permits retry. Legacy change
+     * and done callbacks run only after this callback succeeds. */
+    onSaveEditingOption?: (option: ProductOptionGroup, draft: ProductOptionEditDraft) => void | Promise<void>;
+    /** Receives a rejected option save after its draft has been retained. */
+    onError?: (error: unknown) => void;
     /** Fired when editing an editing option is cancelled. */
     onCancelEditingOption?: (option: ProductOptionGroup, draft: ProductOptionEditDraft) => void;
     /** Fired when an used for variants is toggled. */
@@ -749,13 +753,21 @@ export interface ProductVariantsBulkTableProps {
     /** Overrides this surface’s own copy. */
     strings?: StringsProp<ProductVariantBulkTableStrings>;
 }
-export interface ProductVariantsManagerProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider' | 'footerDivider'>, Pick<ProductOptionsMatrixProps, 'optionGroups' | 'collapsedOptionIds' | 'defaultCollapsedOptionIds' | 'onCollapsedOptionIdsChange' | 'editingOptionId' | 'defaultEditingOptionId' | 'onEditingOptionIdChange' | 'onCreateOption' | 'onEditOption' | 'onDeleteOption' | 'onAddValue' | 'onDeleteValue' | 'onOptionNameChange' | 'onValueLabelChange' | 'onDoneEditingOption' | 'onSaveEditingOption' | 'onCancelEditingOption' | 'onToggleUsedForVariants' | 'renderOptionActions' | 'renderValue'>, Pick<ProductVariantsBulkTableProps, 'variants' | 'groupByOptionId' | 'visibleColumns' | 'optionCombinationDisplay' | 'cellDisplay' | 'selectionMode' | 'renderOptionCombination' | 'renderCell' | 'selectedVariantIds' | 'defaultSelectedVariantIds' | 'onSelectedVariantIdsChange' | 'onVariantFieldChange' | 'onVariantFieldBlur' | 'onCreateVariant' | 'onGenerateVariants' | 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant' | 'onBulkEdit' | 'onBulkApply' | 'onBulkDelete' | 'renderVariantActions' | 'renderBulkActions'> {
+export interface ProductVariantsManagerProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider' | 'footerDivider'>, Pick<ProductOptionsMatrixProps, 'optionGroups' | 'collapsedOptionIds' | 'defaultCollapsedOptionIds' | 'onCollapsedOptionIdsChange' | 'editingOptionId' | 'defaultEditingOptionId' | 'onEditingOptionIdChange' | 'onCreateOption' | 'onEditOption' | 'onDeleteOption' | 'onAddValue' | 'onDeleteValue' | 'onOptionNameChange' | 'onValueLabelChange' | 'onDoneEditingOption' | 'onSaveEditingOption' | 'onError' | 'onCancelEditingOption' | 'onToggleUsedForVariants' | 'renderOptionActions' | 'renderValue'>, Pick<ProductVariantsBulkTableProps, 'variants' | 'groupByOptionId' | 'visibleColumns' | 'optionCombinationDisplay' | 'cellDisplay' | 'selectionMode' | 'renderOptionCombination' | 'renderCell' | 'selectedVariantIds' | 'defaultSelectedVariantIds' | 'onSelectedVariantIdsChange' | 'onVariantFieldChange' | 'onVariantFieldBlur' | 'onCreateVariant' | 'onGenerateVariants' | 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant' | 'onBulkEdit' | 'onBulkApply' | 'onBulkDelete' | 'renderVariantActions' | 'renderBulkActions'> {
     /** Groups rows under the values of this option. `null` leaves the list flat. */
     groupByOptionId?: string | null;
     /** Option group used for grouping on first render. */
     defaultGroupByOptionId?: string | null;
+    /**
+     * Shows the Group by control. Set `false` for a short variant list that
+     * needs no grouping chrome; rows then stay flat unless `groupByOptionId`
+     * or `defaultGroupByOptionId` names an option. @default true
+     */
+    showGroupBy?: boolean;
     onGroupByOptionIdChange?: (optionId: string | undefined, option?: ProductOptionGroup) => void;
+    /** Opens the app-owned variant search. Omitted handler hides its toolbar command. */
     onSearchVariants?: () => void;
+    /** Opens or applies app-owned filtering. Omitted handler hides its toolbar command. */
     onFilterVariants?: () => void;
     /** Content at the end of the manager's control row. */
     controlsEnd?: ReactNode;
@@ -772,7 +784,7 @@ export interface ProductVariantsManagerProps extends Pick<CardProps, 'surface' |
     variantsStrings?: ProductVariantsBulkTableProps['strings'];
 }
 export interface ProductVariantDetailsProps {
-    /** Shell treatment. */
+    /** The selected variant and its accepted summary fields. */
     variant?: ProductVariantSummary;
     /** Label/value facts rendered as a metadata list. */
     metadata?: MetadataListItem[];
@@ -842,6 +854,8 @@ export interface ProductVariantEditorValues {
     /** Options to render. */
     options?: Record<string, string | undefined>;
 }
+/** A built-in ProductVariantEditor field that `visibleFields` can hide. */
+export type ProductVariantEditorField = 'name' | 'sku' | 'description' | 'price' | 'inventory' | 'status' | 'channels';
 export interface ProductVariantEditorProps {
     /** Value shown beside the label. */
     value?: ProductVariantEditorValues;
@@ -865,6 +879,29 @@ export interface ProductVariantEditorProps {
     headerEnd?: ReactNode;
     /** Content rendered in the footer. */
     footerSlot?: ReactNode;
+    /**
+     * Which built-in fields are shown. Omitted fields default to visible; a
+     * section whose fields are all hidden is omitted with its heading.
+     */
+    visibleFields?: Partial<Record<ProductVariantEditorField, boolean>>;
+    /** Validation messages for built-in fields, shown under each and marking it invalid. */
+    errors?: Partial<Record<ProductVariantEditorField, ReactNode>>;
+    /**
+     * Id of the editor's form. Pass the same id to `ActionDrawer formId` so the
+     * drawer's footer submits it. Generated when omitted.
+     */
+    formId?: string;
+    /**
+     * Shows the editor's own title and description. Set `false` inside an
+     * overlay whose header already names the task. @default true
+     */
+    showHeader?: boolean;
+    /**
+     * App-owned fields, such as unit cost or per-location stock, rendered inside
+     * the form after the built-in sections and before the default commands.
+     * Their values, validation and submission stay with the caller.
+     */
+    children?: ReactNode;
     /** Renders the entry as unselectable. */
     disabled?: boolean;
     /** Shows the pending state and blocks repeat submissions. */
@@ -901,7 +938,7 @@ export interface ProductOverviewProps {
     quote?: ProductQuotePreviewCardProps;
     /** Policies card configuration. */
     policies?: ProductPoliciesCardProps;
-    /** Replaces individual cards in the overview. */
+    /** Inserts content at the named main and supporting-region positions. */
     slots?: ProductOverviewSlots;
     /** Merged onto the outermost node. */
     className?: string;

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

@@ -1,8 +1,12 @@
 import type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShowShellProps, TabbedResourceShellProps } from './resource.types';
-export declare function ResourceHeader({ title, description, eyebrow, media, avatarUrl, avatarAlt, avatarFallback, icon, iconTone, badges, metadata, actions, primaryAction, secondaryActions, moreActionsLabel, renderLink, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
+/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
+export declare function ResourceHeader({ title, description, eyebrow, media, avatarUrl, avatarAlt, avatarFallback, icon, iconTone, badges, metadata, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, moreActionsLabel, renderLink, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
 export declare function ResourceActionBar({ children, leading, trailing, sticky, className }: ResourceActionBarProps): import("react").JSX.Element;
 export declare function ResourceEmptyState(props: ResourceEmptyStateProps): import("react").JSX.Element;
+/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
 export declare function ResourceIndexShell(props: ResourceIndexShellProps): import("react").JSX.Element;
+/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
 export declare function ResourceShowShell(props: ResourceShowShellProps): import("react").JSX.Element;
+/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
 export declare function TabbedResourceShell({ tabs, activeTab, onTabChange, tabsClassName, moreLabel, tabsAriaLabel, toolbar, slots, className, strings: stringsProp, ...props }: TabbedResourceShellProps): import("react").JSX.Element;
 export declare function ResourceDetailsSection({ metadata, metadataColumns, metadataDense, body, help, children, contentClassName, ...props }: ResourceDetailsSectionProps): import("react").JSX.Element;

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

@@ -33,7 +33,7 @@ export interface ResourceShellSlots {
  * menu.
  */
 export interface ResourceHeaderCommandProps {
-    /** The resource's one main command: a solid primary button, visible at every width. */
+    /** The resource's one main command: a solid primary button, in the command menu in compact headers. */
     primaryAction?: PageHeaderAction;
     /**
      * Supporting commands in priority order. The first two render as outline
@@ -41,11 +41,19 @@ export interface ResourceHeaderCommandProps {
      * command, move into the More actions menu, which always closes the row.
      */
     secondaryActions?: readonly PageHeaderAction[];
+    /**
+     * How many routine secondary commands render as outline buttons on wide
+     * headers; later ones join the More actions menu. Use `1` or `0` when long
+     * labels beside the primary command would crowd the header; `Infinity`
+     * keeps every routine command inline. @default 2
+     */
+    maxVisibleSecondaryActions?: number;
     /** Accessible name of the More actions menu trigger. Default: `'More actions'`. */
     moreActionsLabel?: string;
     /** Renders `href` commands as framework links. Defaults to a native anchor. */
     renderLink?: PageHeaderLinkRenderer;
 }
+/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
 export interface ResourceIndexShellProps extends ResourceHeaderCommandProps {
     /** Primary workspace content. Replaced by loading, error, or empty state when active. */
     children?: ReactNode;
@@ -82,10 +90,12 @@ export interface ResourceIndexShellProps extends ResourceHeaderCommandProps {
     /** Copy overrides for loading, empty, error, retry, and tab labels. */
     strings?: StringsProp<ResourceStrings>;
 }
+/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
 export interface ResourceShowShellProps extends ResourceIndexShellProps {
     /** Class name for `slots.aside`. */
     asideClassName?: string;
 }
+/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
 export interface ResourceHeaderProps extends ResourceHeaderCommandProps {
     /** Primary resource identity. */
     title: ReactNode;
@@ -172,6 +182,7 @@ export interface ResourceDetailsSectionProps extends ResourceSectionFrameProps {
     /** Quiet guidance rendered after the section content. */
     help?: ReactNode;
 }
+/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
 export interface TabbedResourceShellProps extends ResourceShowShellProps {
     /** Workspace tabs, including optional overflow metadata. */
     tabs: OverflowTabItem[];

package/dist/components/features/rich-text-editor/partials/image-uploads.d.ts

@@ -5,7 +5,7 @@ export declare const DEFAULT_IMAGE_ACCEPT = "image/png,image/jpeg,image/gif,imag
 /** Marks an upload placeholder in the editing surface; never part of the value. */
 export declare const UPLOAD_ATTRIBUTE = "data-rte-upload";
 /** The placeholder occupies a line of its own while its image uploads. */
-export declare const UPLOAD_PLACEHOLDER_CLASS = "rich-text-editor--upload my-space-xs flex min-h-control items-center rounded-inner border border-dashed border-input bg-muted/30 px-row-x py-row-y";
+export declare const UPLOAD_PLACEHOLDER_CLASS = "rich-text-editor--upload my-space-xs flex min-h-control items-center rounded-radius border border-dashed border-input bg-muted/30 px-row-x py-row-y";
 /** Removes upload placeholders from serialized editor HTML. */
 export declare function stripUploadPlaceholders(html: string): string;
 export declare function acceptsImageFile(file: File, accept: string): boolean;

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

@@ -1,7 +1,17 @@
-/** Shared field anatomy for rich editors, including specialized document schemas. */
+/**
+ * Shared field anatomy for rich editors, including specialized document schemas.
+ * Every region takes the toolbar's `surface-xs` inset, on both axes for the body,
+ * so the first line sits as far below the toolbar rule as text sits from the frame edge.
+ */
 export declare const richTextEditorRecipes: {
     readonly source: string;
-    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-inner border";
+    /** Editable body: shared content typography inside the editor's surface inset. Every embedded editor uses it. */
+    readonly editable: string;
+    /** Placeholder overlay, laid over the editable body at the same inset. */
+    readonly placeholder: "pointer-events-none absolute inset-0 p-surface-xs";
+    /** Inline inset for the regions under the body (image details, counts, footer slot). */
+    readonly regionX: "px-surface-xs";
+    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-radius border";
     readonly disabled: "opacity-50";
     readonly disabledControl: "disabled:opacity-100 aria-disabled:opacity-100";
     readonly content: "h-full [&_.ProseMirror]:h-full [&_.ProseMirror]:min-h-full [&_.ProseMirror]:outline-none";

package/dist/components/features/table/partials/resource-cell.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentType, ReactNode } from 'react';
-import { type LucideIcon } from 'lucide-react';
+import type { LucideIcon } from 'lucide-react';
 import { type BadgeTone } from '../../../base/badge';
 export interface ResourceCellMetadataItem {
     /** Stable identity for this entry. */
@@ -32,13 +32,24 @@ export interface ResourceCellProps {
     metadata?: ReactNode | readonly ResourceCellMetadataItem[];
     /** Status chips shown after the title. */
     badges?: readonly ResourceCellBadge[];
-    /** Thumbnail source. Falls back to `icon`, then `fallback`, when absent or broken. */
+    /**
+     * Thumbnail source. When it is absent or fails to load, the circle shows
+     * `fallback`, then `icon`, then the title's initials.
+     */
     imageUrl?: string;
-    /** Leading glyph. */
+    /** Leading glyph in the media circle. Pass one only when it identifies the resource. */
     icon?: ComponentType<{
         className?: string;
     }>;
-    /** Media shown when neither `imageUrl` nor `icon` resolves — usually initials. */
+    /**
+     * Media shown when `imageUrl` is absent or fails — usually
+     * `<Initials value={name} />` for a person or organization.
+     *
+     * The cell draws its media circle only when `imageUrl`, `icon` or
+     * `fallback` is supplied, so identifiers such as orders and invoices read
+     * as plain text with no decorative monogram. In a person column where only
+     * some rows have a photo, pass `fallback` on every row so titles align.
+     */
     fallback?: ReactNode;
     /** Destination for the entry, when it navigates. */
     href?: string;
@@ -48,6 +59,12 @@ export interface ResourceCellProps {
     emptyLabel?: ReactNode;
     /** Merged onto the outermost node. */
     className?: string;
+    /**
+     * `circle` for people and organizations; `square` (the default radius) for
+     * product photos and documents, so square images are not clipped.
+     * @default 'circle'
+     */
+    mediaShape?: 'circle' | 'square';
     /** Merged onto the media. */
     mediaClassName?: string;
     /** Merged onto the content. */
@@ -57,7 +74,7 @@ export interface ResourceCellProps {
     /** Merged onto the subtitle. */
     subtitleClassName?: string;
 }
-export declare function ResourceCell({ title, subtitle, metadata, badges, imageUrl, icon: IconComponent, fallback, href, renderLink, emptyLabel, className, mediaClassName, contentClassName, titleClassName, subtitleClassName, }: ResourceCellProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+export declare function ResourceCell({ title, subtitle, metadata, badges, imageUrl, icon: IconComponent, fallback, href, renderLink, emptyLabel, className, mediaShape, mediaClassName, contentClassName, titleClassName, subtitleClassName, }: ResourceCellProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
 export declare namespace ResourceCell {
     var displayName: string;
 }

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

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