themelia-react-ui 2.0.0 → 2.0.2

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

@@ -141,10 +141,14 @@ export interface MediaLibraryItemRenderContext<TItem = MediaLibraryItem> {
     selected: boolean;
     /** Whether one asset or several can be selected at a time. */
     selectionMode: MediaLibrarySelectionMode;
+    /** Whether the library is in selection mode, where activating an asset toggles it. */
+    selecting: boolean;
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
     toggle: () => void;
     openDetails: () => void;
+    /** Opens the asset: `onItemOpen` when supplied, otherwise the detail panel. */
+    open: () => void;
 }
 export interface MediaLibraryDetailRenderContext<TItem = MediaLibraryItem> {
     /** Reads id, name, URL, type, and size off your own asset shape. */
@@ -187,6 +191,13 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     selectedSet: Set<string>;
     toggleSelection: (id: string) => void;
     clearSelection: () => void;
+    /**
+     * Whether selection mode is on: requested explicitly (`setSelecting(true)`,
+     * a picker) or implied because at least one asset is selected.
+     */
+    selecting: boolean;
+    /** Turns selection mode on or off. Turning it off also clears the selection. */
+    setSelecting: (selecting: boolean) => void;
     clearFilters: () => void;
     loading: boolean;
     error: unknown;
@@ -298,6 +309,20 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
     defaultUploadOptions?: Partial<MediaLibraryUploadOptions>;
     /** Fired with the fully resolved upload options whenever they change. */
     onUploadOptionsChange?: (options: MediaLibraryUploadOptions) => void;
+    /**
+     * Explicit selection mode, for controlled use. Selection mode is also on
+     * whenever an asset is selected; turning it off clears the selection.
+     */
+    selecting?: boolean;
+    /**
+     * Explicit selection mode on first render for uncontrolled use. Default:
+     * `false`, so activating an asset opens it. `MediaLibrary` starts selecting
+     * when `confirmOnSelect` is set and `MediaLibraryDialog` always starts
+     * selecting, because both are pickers.
+     */
+    defaultSelecting?: boolean;
+    /** Fired when explicit selection mode is turned on or off. */
+    onSelectingChange?: (selecting: boolean) => void;
 }
 export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<ComponentPropsWithoutRef<'section'>, 'children' | 'defaultValue' | 'onError' | 'onSelect' | 'title'>, UseMediaLibraryOptions<TItem> {
     /** Heading above the browser. */
@@ -306,6 +331,12 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
     titleSuffix?: ReactNode;
     /** Requests replacement of the inspected asset. The consumer owns file selection, persistence, identity, and refreshed `items`; omitted callbacks hide Replace file. */
     onItemReplace?: (item: TItem) => void;
+    /**
+     * Fired when an asset is activated outside selection mode (click, Enter or
+     * Space) — for a preview, a lightbox or navigation. Without it the asset's
+     * detail panel opens. In selection mode activation toggles the asset instead.
+     */
+    onItemOpen?: (item: TItem) => void;
     /** Supporting line under the title. */
     description?: ReactNode;
     /** Copy for the confirm action. */
@@ -333,6 +364,15 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
     onCancel?: () => void;
     /** Fired after the surface closes, however it was dismissed. */
     onClose?: () => void;
+    /**
+     * Bulk actions for the selected assets, rendered in a floating
+     * `BatchActionBar` (count, these actions, Clear) while assets are selected.
+     * Browsing only: a picker (`onConfirm` without `confirmOnSelect`, or
+     * `MediaLibraryDialog`) reports its selection in the footer instead, so the
+     * bar is not rendered there. While the bar is in use the library tab drops
+     * the picker footer; the upload tab keeps its own.
+     */
+    bulkActions?: (context: MediaLibraryBulkActionContext<TItem>) => ReactNode;
     /** Overrides the library's own copy. */
     strings?: StringsProp<MediaLibraryStrings>;
     /** Replaces individual regions — the toolbar, cards, detail panel, or footer. */
@@ -340,8 +380,21 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
     /** Height utility for the scrollable browse region. */
     heightClassName?: string;
 }
+/** What a media library bulk action receives; mirrors the product variants' bulk context. */
+export interface MediaLibraryBulkActionContext<TItem = MediaLibraryItem> {
+    /** The selected assets that are loaded. */
+    selectedItems: TItem[];
+    /** Every selected id, including any not currently loaded. */
+    selectedIds: string[];
+    selectedCount: number;
+    /** Assets passing the current query and filters, not the whole library. */
+    visibleCount: number;
+    /** Assets in the whole library. */
+    totalCount: number;
+    clearSelection: () => void;
+}
 /** The media library in a modal, for picking assets from elsewhere in a page. */
-export interface MediaLibraryDialogProps<TItem = MediaLibraryItem> extends Omit<MediaLibraryProps<TItem>, 'title' | 'description'> {
+export interface MediaLibraryDialogProps<TItem = MediaLibraryItem> extends Omit<MediaLibraryProps<TItem>, 'title' | 'description' | 'bulkActions'> {
     /** Visibility, for controlled use. Omit to let `trigger` own it. */
     open?: boolean;
     /** Fired whenever the dialog wants to open or close. */
@@ -430,6 +483,14 @@ export interface MediaLibraryCardProps<TItem = MediaLibraryItem> {
     /** Fired when an entry is toggled. */
     onToggle?: () => void;
     onDetails?: () => void;
+    /**
+     * Opens the asset. When set and the card is not `selecting`, activating the
+     * card opens it and a separate check control selects it. Without it,
+     * activating the card toggles its selection.
+     */
+    onOpen?: () => void;
+    /** Selection mode: activating the card toggles it and the check shows on every card. */
+    selecting?: boolean;
     /** Merged onto the outermost node. */
     className?: string;
 }
@@ -447,6 +508,14 @@ export interface MediaLibraryListProps<TItem = MediaLibraryItem> {
     /** Fired when an entry is toggled. */
     onToggle: (id: string) => void;
     onDetails: (id: string) => void;
+    /**
+     * Opens an asset. When set and the list is not `selecting`, activating a row
+     * opens it and a separate check control selects it. Without it, activating a
+     * row toggles its selection.
+     */
+    onOpen?: (id: string) => void;
+    /** Selection mode: activating a row toggles it. */
+    selecting?: boolean;
 }
 export interface MediaLibraryDetailPanelProps<TItem = MediaLibraryItem> {
     /** The asset this row or card represents. */
@@ -510,6 +579,10 @@ export interface MediaLibraryToolbarProps {
     onClearFilters: () => void;
     /** Content at the end of the toolbar row. */
     toolbarEnd?: ReactNode;
+    /** Whether selection mode is on; drives the pressed state of the Select toggle. */
+    selecting?: boolean;
+    /** Renders the Select toggle, which turns selection mode on or off. */
+    onSelectingChange?: (selecting: boolean) => void;
 }
 export interface MediaLibraryFooterSummaryProps {
     /** Which tab is showing — browse or upload. */

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

@@ -1,8 +1,8 @@
 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, }: MediaLibraryToolbarProps): import("react").JSX.Element;
-export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
-export declare function MediaLibraryList<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, }: MediaLibraryListProps<TItem>): import("react").JSX.Element;
+export declare function 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 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 MediaLibraryFooterSummary({ tab, selectedIds, selectionMode, stagedFiles, strings, onClearSelection, className, }: MediaLibraryFooterSummaryProps): import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+import type { MentionResource, MentionSuggestion } from '../mentions.types';
+interface MentionKindTogglesProps<TResource extends string> {
+    kinds: ReadonlyArray<TResource>;
+    activeKind: TResource | null;
+    resources?: Partial<Record<TResource, MentionResource<TResource>>>;
+    /** Per-kind results; a count follows the label when present. */
+    counts?: Readonly<Record<string, ReadonlyArray<MentionSuggestion<TResource>>>>;
+    onKindChange: (kind: TResource) => void;
+}
+/**
+ * The resource-kind filter shared by the inline suggestions and the picker:
+ * compact toggles that press with the accent fill and hover with muted, like
+ * every other toggle, rather than a primary command fill.
+ */
+export declare function MentionKindToggles<TResource extends string>({ kinds, activeKind, resources, counts, onKindChange, }: MentionKindTogglesProps<TResource>): import("react").JSX.Element;
+export {};

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, }: ConfirmDialogProps): import("react").JSX.Element;
+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;
 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, }: ActionDialogProps): import("react").JSX.Element;
+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;
 export declare const ActionDialog: import("react").MemoExoticComponent<typeof ActionDialogImpl>;
 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, OverlayButtonTone, OverlayButtonStyle, OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps, ActionDialogProps, ActionDrawerProps, ConfirmDialogProps, } from './overlays.types';
+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';

package/dist/components/features/overlays/overlay-tone-icon.d.ts

@@ -14,17 +14,17 @@ export declare const overlayToneGlyphs: {
     readonly warning: {
         readonly Glyph: import("lucide-react").LucideIcon;
         readonly color: "text-warning-accent";
-        readonly surface: "bg-warning/15";
+        readonly surface: "bg-warning/20";
     };
     readonly info: {
         readonly Glyph: import("lucide-react").LucideIcon;
         readonly color: "text-info";
-        readonly surface: "bg-info/15";
+        readonly surface: "bg-info/20";
     };
     readonly success: {
         readonly Glyph: import("lucide-react").LucideIcon;
         readonly color: "text-success";
-        readonly surface: "bg-success/15";
+        readonly surface: "bg-success/20";
     };
 };
 /**

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

@@ -1,6 +1,7 @@
 import type { ReactNode, RefObject, CSSProperties } from 'react';
 import type { ButtonStyle } from '../../base/buttons';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
+import type { OverlayAlign } from '../../../lib/ui-provider/types';
 import type { StringsProp } from '../../../lib/strings';
 import type { OverlayStrings } from './overlays.strings';
 export type OverlayTone = Extract<SemanticTone, 'neutral' | 'destructive' | 'warning' | 'info' | 'success'>;
@@ -8,6 +9,13 @@ export type OverlayButtonTone = SemanticTone;
 export type OverlayButtonStyle = Exclude<ButtonStyle, 'ghost'>;
 export type OverlaySize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | 'full';
 export type DrawerDirection = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Where the heading (tone icon, title, description) and the actions sit:
+ * `'start'` on the reading edge, `'center'` stacked on the dialog's centre line.
+ * Resolved from the explicit prop, then the provider's `overlay` slice, then the
+ * component's fallback.
+ */
+export type { OverlayAlign };
 /** Presentation and lifecycle shared by every overlay in this family. */
 export interface OverlayBaseProps {
     /** Visibility, for controlled use. Omit to let the overlay own it via `trigger`. */
@@ -129,6 +137,12 @@ export interface OverlayEmphasisProps {
 }
 /** A modal dialog with a title, body, and generated action footer. */
 export interface ActionDialogProps extends OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps {
+    /**
+     * Aligns the heading and the actions. `'center'` stacks the `showIcon` glyph
+     * above the title. Default: the provider's `overlay.defaultDialogAlign`, else
+     * `'start'`.
+     */
+    align?: OverlayAlign;
     /** Maximum dialog width from the `sm` breakpoint; below it the dialog keeps a 1rem viewport margin. Default: `lg`. */
     size?: OverlaySize;
     /** Element that opens the dialog. Supply it for uncontrolled use instead of `open`; a string renders a secondary button. */
@@ -173,6 +187,12 @@ export interface ActionDrawerProps extends OverlayBaseProps, OverlayActionProps,
  * body needs real content — this one is sized for a question and two answers.
  */
 export interface ConfirmDialogProps extends OverlayBaseProps, OverlayActionProps {
+    /**
+     * Aligns the icon, title, description and actions together. Below the `sm`
+     * breakpoint the actions stack full width either way. Default: the
+     * provider's `overlay.defaultConfirmAlign`, else `'center'`.
+     */
+    align?: OverlayAlign;
     /** Semantic tone, driving the confirm button, the `showIcon` glyph and the notice. Default: `'neutral'`. */
     tone?: OverlayTone;
     /** Shows the tone's glyph above the title. Default: `false`; the confirm button and copy carry the tone. */

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 export declare function ProductOptionActionMenu({ option, index, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, menuLabel, className, strings: stringsProp, }: ProductOptionActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductOptionActionMenu {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,5 +1,27 @@
-import type { ProductVariantActionMenuProps } from '../products.types';
+import type { ReactNode } from 'react';
+import { type ProductVariantActionMenuStrings } from '../products.strings';
+import type { ProductVariantActionMenuProps, ProductVariantSummary } from '../products.types';
+type VariantCommandHandlers = Pick<ProductVariantActionMenuProps, 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant'>;
+interface VariantCommand {
+    id: string;
+    label: string;
+    icon: ReactNode;
+    onClick: () => void;
+    tone: 'secondary' | 'destructive';
+    buttonStyle?: 'ghost';
+}
+/**
+ * The default variant commands, in order, with the destructive one last. The
+ * row menu and the details card's single overflow menu both build on these.
+ */
+export declare function productVariantMenuActions(variant: ProductVariantSummary, { onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant }: VariantCommandHandlers, strings: ProductVariantActionMenuStrings): VariantCommand[];
+/**
+ * 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.
+ */
 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 {
     var displayName: string;
 }
+export {};

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

@@ -2,7 +2,7 @@ import type { ReactNode } from 'react';
 import type { CardProps } from '../../base/cards';
 import type { BadgeTone } from '../../base/badge';
 import type { ActionMenuAction } from '../../base/action-menu';
-import type { MetadataListItem } from '../../blocks/data-display/metadata';
+import type { MetadataListItem } from '../../base/metadata-list';
 import type { StringsProp } from '../../../lib/strings';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
 import type { ProductContractOverviewStrings, ProductDetailsCardStrings, ProductOperationsCardStrings, ProductOptionActionMenuStrings, ProductOptionsMatrixStrings, ProductOptionsSummaryStrings, ProductOverviewStrings, ProductPoliciesCardStrings, ProductQuotePreviewCardStrings, ProductReadinessCardStrings, ProductStructureCardStrings, ProductVariantActionMenuStrings, ProductVariantBulkTableStrings, ProductVariantDetailsStrings, ProductVariantEditorStrings, ProductVariantsManagerStrings, ProductVariantsTableStrings } from './products.strings';
@@ -720,12 +720,19 @@ export interface ProductVariantsBulkTableProps {
     onDuplicateVariant?: (variant: ProductVariantRow) => void;
     /** Fired when a variant is removed. */
     onDeleteVariant?: (variant: ProductVariantRow) => void;
+    /** Fired with the selected variants from the bulk bar's edit command. */
     onBulkEdit?: (variants: ProductVariantRow[]) => void;
+    /** Fired with the selected variants from the bulk bar's apply command, ordered before delete. */
     onBulkApply?: (variants: ProductVariantRow[]) => void;
+    /** Fired with the selected variants from the bulk bar's delete command, always last. */
     onBulkDelete?: (variants: ProductVariantRow[]) => void;
     /** Replaces the per-variant action controls. */
     renderVariantActions?: (variant: ProductVariantRow, context: ProductVariantActionContext) => ReactNode;
-    /** Replaces the per-bulk action controls. */
+    /**
+     * Replaces the default bulk commands (edit, apply, delete) in the inline
+     * BatchActionBar, which shows only while variants are selected and keeps its
+     * own count and Clear. Returning `null` or `undefined` keeps the defaults.
+     */
     renderBulkActions?: (context: ProductVariantBulkActionContext) => ReactNode;
     /** Overflow menu for the surface as a whole. */
     actions?: ActionMenuAction[];

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

@@ -1,3 +1,3 @@
 export { ResourceActionBar, ResourceDetailsSection, ResourceEmptyState, ResourceHeader, ResourceIndexShell, ResourceShowShell, TabbedResourceShell, } from './resource';
-export type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShellSlots, ResourceShowShellProps, TabbedResourceShellProps, } from './resource.types';
+export type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderCommandProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShellSlots, ResourceShowShellProps, TabbedResourceShellProps, } from './resource.types';
 export { defaultResourceStrings, type ResourceStrings, } from './resource.strings';

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

@@ -1,5 +1,5 @@
 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, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
+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;
 export declare function ResourceActionBar({ children, leading, trailing, sticky, className }: ResourceActionBarProps): import("react").JSX.Element;
 export declare function ResourceEmptyState(props: ResourceEmptyStateProps): import("react").JSX.Element;
 export declare function ResourceIndexShell(props: ResourceIndexShellProps): import("react").JSX.Element;

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

@@ -1,8 +1,9 @@
 import type { ComponentType, ReactNode } from 'react';
 import type { IconBadgeTone } from '../../base/display';
-import type { EmptyStateProps, MetadataListItem } from '../../blocks/data-display';
+import type { MetadataListItem } from '../../base/metadata-list';
+import type { EmptyStateProps } from '../../blocks/data-display';
 import type { ActionMenuAction } from '../../base/action-menu';
-import type { OverflowTabItem } from '../../base/navigation';
+import type { OverflowTabItem, PageHeaderAction, PageHeaderLinkRenderer } from '../../base/navigation';
 import type { StringsProp } from '../../../lib/strings';
 import type { CardSurface, ComponentScale } from '../../../lib/component-vocabulary';
 import type { ResourceStrings } from './resource.strings';
@@ -26,14 +27,37 @@ export interface ResourceShellSlots {
     /** Replaces the default error state. */
     error?: ReactNode;
 }
-export interface ResourceIndexShellProps {
+/**
+ * Role-based header commands, placed and styled exactly as in Page headers:
+ * outline secondary commands, the solid primary command, then the More actions
+ * menu.
+ */
+export interface ResourceHeaderCommandProps {
+    /** The resource's one main command: a solid primary button, visible at every width. */
+    primaryAction?: PageHeaderAction;
+    /**
+     * Supporting commands in priority order. The first two render as outline
+     * buttons before the primary command; the rest, and every destructive
+     * command, move into the More actions menu, which always closes the row.
+     */
+    secondaryActions?: readonly PageHeaderAction[];
+    /** 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;
+}
+export interface ResourceIndexShellProps extends ResourceHeaderCommandProps {
     /** Primary workspace content. Replaced by loading, error, or empty state when active. */
     children?: ReactNode;
     /** Generated header title. Omit when supplying `slots.header`. */
     title?: ReactNode;
     /** Generated header description. */
     description?: ReactNode;
-    /** Generated header actions. */
+    /**
+     * Non-command controls in the generated header, such as a period select.
+     * They render before the role-based commands; pass commands as
+     * `primaryAction` and `secondaryActions`.
+     */
     actions?: ReactNode;
     /** Content between the header and primary workspace body. */
     toolbar?: ReactNode;
@@ -62,7 +86,7 @@ export interface ResourceShowShellProps extends ResourceIndexShellProps {
     /** Class name for `slots.aside`. */
     asideClassName?: string;
 }
-export interface ResourceHeaderProps {
+export interface ResourceHeaderProps extends ResourceHeaderCommandProps {
     /** Primary resource identity. */
     title: ReactNode;
     /** Supporting resource summary. */
@@ -87,7 +111,11 @@ export interface ResourceHeaderProps {
     badges?: ReactNode;
     /** Compact resource facts rendered below the description. */
     metadata?: ReactNode;
-    /** Primary and secondary header actions. */
+    /**
+     * Non-command controls, such as a period select. They render before the
+     * role-based commands; pass commands as `primaryAction` and
+     * `secondaryActions`.
+     */
     actions?: ReactNode;
     /** Class name for the page-header root. */
     className?: string;

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

@@ -1,5 +1,6 @@
 export { RichTextEditor } from './rich-text-editor';
 export { FormRichTextEditor, type FormRichTextEditorProps } from './form-rich-text-editor';
-export type { RichTextEditorProps, RichTextEditorHandle, RichTextEditorToolbarItem, RichTextCaretContext, ToolbarButtonConfig, } from './rich-text-editor.types';
+export type { RichTextEditorProps, RichTextEditorBodyHeight, RichTextEditorHandle, RichTextEditorToolbarItem, RichTextCaretContext, ToolbarButtonConfig, RichTextEditorImages, RichTextImage, RichTextImageUploadContext, } from './rich-text-editor.types';
+export { useRichTextImages } from './use-rich-text-images';
 export { defaultRichTextEditorStrings, type RichTextEditorStrings, } from './rich-text-editor.strings';
 export { RichTextEditorToolbar, type RichTextEditorToolbarProps, CountsFooterText, type CountsFooterTextProps, } from './partials';

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

@@ -0,0 +1,13 @@
+import * as TiptapReact from '@tiptap/react';
+/**
+ * An inline image whose source passes the package image policy; any other
+ * `<img>` in loaded or pasted content is dropped. Serializes as a plain
+ * `<img src alt width height>`, matching the contenteditable engine.
+ */
+export declare function getImageNode(): TiptapReact.Node;
+/**
+ * The placeholder an image occupies while it uploads. It is never parsed from
+ * HTML and the editor strips it from its value; the editor renders the
+ * upload status into its node view.
+ */
+export declare function getImageUploadNode(): TiptapReact.Node;

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

@@ -0,0 +1,66 @@
+import { type RefObject } from 'react';
+import type { RichTextEditorStrings } from '../rich-text-editor.strings';
+import type { RichTextEditorImages, RichTextEditorToolbarItem, RichTextImage } from '../rich-text-editor.types';
+export declare const DEFAULT_IMAGE_ACCEPT = "image/png,image/jpeg,image/gif,image/webp";
+/** 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";
+/** Removes upload placeholders from serialized editor HTML. */
+export declare function stripUploadPlaceholders(html: string): string;
+export declare function acceptsImageFile(file: File, accept: string): boolean;
+/** A readable default description from the file name: `team-offsite_2026.jpg` → `team offsite 2026`. */
+export declare function altFromFileName(name: string): string;
+/** Image files carried by a paste or drop. */
+export declare function imageFilesFrom(data: DataTransfer | null | undefined): File[];
+/** How each editor engine puts placeholders and images into its document. */
+export interface ImageUploadAdapter {
+    /** Inserts an empty placeholder for `id` at the selection (or the drop point). */
+    insertPlaceholder: (id: string) => void;
+    /** Swaps the placeholder for the uploaded image and reports the change. */
+    resolvePlaceholder: (id: string, image: RichTextImage) => void;
+    /** Removes the placeholder and reports the change. */
+    removePlaceholder: (id: string) => void;
+    /** The placeholder's element, or null once the user has deleted it. */
+    findPlaceholder: (id: string) => HTMLElement | null;
+}
+export interface PendingImageUpload {
+    id: string;
+    name: string;
+    status: 'uploading' | 'error';
+}
+/**
+ * The engine-agnostic upload lifecycle: validate, insert a placeholder, call
+ * the consumer's `upload` with an abort signal, then swap in the image or keep
+ * the placeholder in its error state for Retry or Remove.
+ */
+export declare function useImageUploadQueue(images: RichTextEditorImages | undefined, adapterRef: RefObject<ImageUploadAdapter | null>, strings: RichTextEditorStrings['images']): {
+    uploads: PendingImageUpload[];
+    notice: string | null;
+    dismissNotice: () => void;
+    addFiles: (files: readonly File[]) => void;
+    retry: (id: string) => void;
+    remove: (id: string) => void;
+    prune: () => void;
+};
+export type ImageUploadQueue = ReturnType<typeof useImageUploadQueue>;
+/** Renders each pending upload's status into its placeholder in the editing surface. */
+export declare function ImageUploadPortals({ queue, adapterRef, strings }: {
+    queue: ImageUploadQueue;
+    adapterRef: RefObject<ImageUploadAdapter | null>;
+    strings: RichTextEditorStrings['images'];
+}): import("react").JSX.Element;
+/** The Insert image toolbar control and its hidden file input. */
+export declare function useImageInsertControl(images: RichTextEditorImages | undefined, strings: RichTextEditorStrings['images'], onFiles: (files: File[]) => void, beforeOpen?: () => void): {
+    item: RichTextEditorToolbarItem | null;
+    input: import("react").JSX.Element | null;
+};
+/** The description field for the image at the caret, and refused-file notices. */
+export declare function ImageDetailsBar({ alt, onAltChange, onRemove, notice, onDismissNotice, strings }: {
+    alt: string | null;
+    onAltChange: (alt: string) => void;
+    onRemove: () => void;
+    notice: string | null;
+    onDismissNotice: () => void;
+    strings: RichTextEditorStrings['images'];
+}): import("react").JSX.Element | null;