themelia-react-ui 2.0.0 → 2.0.1

package/dist/components/blocks/commerce/shared/line-thumbnail.d.ts

@@ -0,0 +1,9 @@
+export interface LineThumbnailProps {
+    /** Image source. Optional: without one the initials show. */
+    src?: string;
+    /** Alternative text. Defaults to `title`. */
+    alt?: string;
+    /** The line's name, used for the initials and as the default alt text. */
+    title: string;
+}
+export declare function LineThumbnail({ src, alt, title }: LineThumbnailProps): import("react").JSX.Element;

package/dist/components/blocks/commerce/shared/order-status.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The order vocabularies the order surfaces share. Goods and money move
+ * independently ("refunded, still unfulfilled"), so an order carries two status
+ * axes. Each union has exactly one tone map, and no order surface takes a tone
+ * prop that could disagree with its status.
+ *
+ * Primary stays off every status chip: it is the one main command. A state the
+ * order is moving through reads `info`; a starting state that needs attention
+ * reads `warning`, not `destructive`.
+ */
+import type { BadgeTone } from '../../../base/badge';
+/** Where the goods are. */
+export type FulfillmentStatus = 'unfulfilled' | 'partiallyFulfilled' | 'fulfilled' | 'scheduled' | 'onHold' | 'cancelled';
+export declare const fulfillmentStatusTone: Record<FulfillmentStatus, BadgeTone>;
+/** Where the money is. */
+export type PaymentStatus = 'pending' | 'authorized' | 'paid' | 'partiallyRefunded' | 'refunded' | 'voided';
+export declare const paymentStatusTone: Record<PaymentStatus, BadgeTone>;
+/** What was attempted against the payment method. */
+export type TransactionKind = 'authorization' | 'capture' | 'sale' | 'refund' | 'void' | 'chargeback';
+/** Whether the attempt worked. */
+export type TransactionStatus = 'success' | 'pending' | 'failure';
+export declare const transactionStatusTone: Record<TransactionStatus, BadgeTone>;
+/** Kinds that take money out of the merchant. They set the sign; callers pass the magnitude. */
+export declare const outgoingTransactionKinds: ReadonlySet<TransactionKind>;
+/** A postal address as an order carries it. `AddressCard` keeps its own flat props. */
+export interface OrderAddress {
+    /** Recipient. */
+    name?: string;
+    /** Street address. */
+    line1: string;
+    /** Apartment, suite, or unit. */
+    line2?: string;
+    /** City or town. */
+    city: string;
+    /** State, province, or region. */
+    region?: string;
+    /** Postal or ZIP code. */
+    postalCode?: string;
+    /** Country name or code. */
+    country: string;
+    /** Contact number for the delivery. */
+    phone?: string;
+}
+/** The words for both status axes. Tones stay derived from the status. */
+export interface OrderStatusVocabulary {
+    /** Label for each `FulfillmentStatus`. */
+    fulfillment: Record<FulfillmentStatus, string>;
+    /** Label for each `PaymentStatus`. */
+    payment: Record<PaymentStatus, string>;
+}
+export declare const defaultOrderStatusVocabulary: OrderStatusVocabulary;

package/dist/components/blocks/commerce/shipment-tracking/shipment-tracking.d.ts

@@ -1,5 +1,5 @@
 import { type ShipmentTrackingProps } from './types';
-export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, className, strings: stringsProp, }: ShipmentTrackingProps): import("react").JSX.Element;
+export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, onCopyTracking, className, strings: stringsProp, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
 export declare namespace ShipmentTracking {
     var displayName: string;
 }

package/dist/components/blocks/commerce/shipment-tracking/types.d.ts

@@ -1,24 +1,43 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
 /**
  * Transit stage. Drives the status label (through `strings`) and the tone of
- * the status dot, so a delayed shipment can never be painted as a healthy one.
+ * the status chip, so a delayed shipment can never be painted as a healthy one.
  */
 export type ShipmentStatus = 'pending' | 'in_transit' | 'delivered' | 'delayed';
-/** Dot tone per stage. Semantic state tokens only — never a raw palette colour. */
-export declare const shipmentStatusDotTone: Record<ShipmentStatus, string>;
+/**
+ * Chip tone per stage. `delayed` is a warning, not an error: the parcel is
+ * still coming. Primary stays off status chips.
+ */
+export declare const shipmentStatusTone: Record<ShipmentStatus, BadgeTone>;
 export interface TrackingStep {
+    /** Stable identity. Falls back to the label and position, so repeated labels never collide. */
+    id?: string;
     /** Display label. */
     label: string;
+    /**
+     * Whether the parcel has reached this checkpoint. The latest reached
+     * checkpoint stays current until the shipment is delivered.
+     */
     done: boolean;
+    /** Already formatted. When the checkpoint was reached: a parcel's rail is a log, not a plan. */
+    timestamp?: string;
 }
 export interface ShipmentDetail {
     /** Display label. */
     label: string;
-    value: string;
+    value: ReactNode;
 }
 export interface ShipmentTrackingStrings {
-    /** Accessible name for the surface. */
+    /** Surface title. */
     title: string;
+    /** Label of the tracking-number row. */
+    trackingNumber: string;
+    /** Label of the carrier row. */
+    carrier: string;
+    /** Accessible name of the copy button beside the tracking number. */
+    copyTrackingNumber: string;
     /** Status label for each `ShipmentStatus`. */
     pending: string;
     in_transit: string;
@@ -26,7 +45,7 @@ export interface ShipmentTrackingStrings {
     delayed: string;
 }
 export declare const defaultShipmentTrackingStrings: ShipmentTrackingStrings;
-export interface ShipmentTrackingProps {
+export interface ShipmentTrackingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Carrier tracking reference. */
     trackingNumber: string;
     /** Carrier handling the shipment. */
@@ -37,6 +56,8 @@ export interface ShipmentTrackingProps {
     steps: TrackingStep[];
     /** Label/value facts about the shipment. */
     details?: ShipmentDetail[];
+    /** Fired after the tracking number is copied to the clipboard. */
+    onCopyTracking?: (trackingNumber: string) => void;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/commerce/summary-panel/amount-row.d.ts

@@ -0,0 +1,2 @@
+import type { AmountRowProps } from './types';
+export declare const AmountRow: import("react").ForwardRefExoticComponent<AmountRowProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/commerce/summary-panel/index.d.ts

@@ -0,0 +1,3 @@
+export { AmountRow } from './amount-row';
+export { SummaryPanel } from './summary-panel';
+export type { AmountRowProps, SummaryPanelProps } from './types';

package/dist/components/blocks/commerce/summary-panel/summary-panel.d.ts

@@ -0,0 +1,2 @@
+import type { SummaryPanelProps } from './types';
+export declare const SummaryPanel: import("react").ForwardRefExoticComponent<SummaryPanelProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/blocks/commerce/summary-panel/types.d.ts

@@ -0,0 +1,26 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+export interface AmountRowProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
+    /** What the amount is: "Subtotal", "Shipping". */
+    label: ReactNode;
+    /** Already formatted, including its currency. This row totals nothing itself. */
+    amount: string;
+    /** A rate or qualifier ("20%", "3 items") that sits quietly beside the amount. */
+    note?: ReactNode;
+    /** Marks the row the eye should land on: a total, an amount due. */
+    total?: boolean;
+    /**
+     * Money coming off the total. Rewrites whatever sign the caller passed to
+     * one U+2212 and sets the figure in success ink: a deduction reads as a gain
+     * to whoever is paying.
+     */
+    deduction?: boolean;
+    /**
+     * Rules this row off from the rows above it, for a grand total under the
+     * breakdown it rolls up. It is the only rule a ledger draws.
+     */
+    rollup?: boolean;
+}
+export interface SummaryPanelProps extends ComponentPropsWithoutRef<'div'> {
+    /** `AmountRow`s, top to bottom. */
+    children?: ReactNode;
+}

package/dist/components/blocks/commerce/tax-breakdown/tax-breakdown.d.ts

@@ -1,5 +1,5 @@
 import { type TaxBreakdownCardProps } from './types';
-export declare function TaxBreakdownCard({ subtotal, taxes, totalTax, total, className, strings: stringsProp, }: TaxBreakdownCardProps): import("react").JSX.Element;
+export declare function TaxBreakdownCard({ subtotal, taxes, totalTax, total, className, strings: stringsProp, ...props }: TaxBreakdownCardProps): import("react").JSX.Element;
 export declare namespace TaxBreakdownCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/tax-breakdown/types.d.ts

@@ -1,3 +1,4 @@
+import type { ComponentPropsWithoutRef } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 export interface TaxLineItem {
     /** Stable identity for this entry. */
@@ -18,7 +19,7 @@ export interface TaxBreakdownStrings {
     total: string;
 }
 export declare const defaultTaxBreakdownStrings: TaxBreakdownStrings;
-export interface TaxBreakdownCardProps {
+export interface TaxBreakdownCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
     /** Formatted amount before tax. */
     subtotal: string;
     /** Individual tax lines making up the total. */

package/dist/components/blocks/data-display/metadata/index.d.ts

@@ -1,4 +1,30 @@
-export { MetadataList } from './metadata-list';
-export type { MetadataDensity, MetadataInlineListItem, MetadataLayout, MetadataListItem, MetadataListProps, } from './metadata-list';
-export { MetadataValue } from './metadata-value';
-export type { MetadataValueDescriptor, MetadataValueKind, MetadataValueProps, } from './metadata-value';
+/**
+ * Deprecated compatibility path.
+ *
+ * MetadataList is a base structure, not a block: it composes typography,
+ * primitives and base display parts. It moved to
+ * `themelia-react-ui/base/metadata-list`; these re-exports keep existing
+ * `themelia-react-ui/blocks/data-display` imports working through 2.x.
+ */
+export { 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataList, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValue, } from '../../../base/metadata-list';
+export type { 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataDensity, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataInlineListItem, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataLayout, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataListItem, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataListProps, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueDescriptor, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueKind, 
+/** @deprecated Import from `themelia-react-ui/base/metadata-list`. */
+MetadataValueProps, } from '../../../base/metadata-list';

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

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { ActivityAction, ActivityActor, ActivityDensity, ActivityEventConfig, ActivityItemSpacing, ActivityItem, ActivityResourceConfig, ActivityResourceRef, ActivityTone } from '../activities.types';
 export interface ActivityRowProps<TData = unknown> {
     /** The feed entry this row renders. */
@@ -30,7 +30,11 @@ export interface ActivityRowProps<TData = unknown> {
     showChangesLabel: string;
     /** Control that collapses the change list. */
     hideChangesLabel: string;
-    /** Control that reveals the remaining changes. */
+    /**
+     * Copy for remaining metadata in the former collapsed preview.
+     * @deprecated Collapsed rows no longer preview metadata; the full list
+     * appears behind the details disclosure. Accepted for compatibility.
+     */
     moreLabel: string;
     /** Accessible name for the row's overflow trigger. */
     actionsLabel: string;

package/dist/components/features/activities/partials/tone-tokens.d.ts

@@ -1,9 +1,3 @@
-/**
- * Tone palettes shared by the marker, headline status segments, and the
- * resource tag. Tones map to semantic shadcn tokens — never to raw colours —
- * so a consumer rebrand at `:root` flows through the activities feature
- * automatically.
- */
 import type { ActivityTone } from '../activities.types';
 import type { BadgeTone } from '../../../base/badge';
 export interface ActivityToneStyle {

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

@@ -0,0 +1,15 @@
+/**
+ * Group caption shared by result groups and idle sections. It uses the compact
+ * secondary role and inset of a Command group heading, so a caption never reads
+ * as another row and both lists keep one rhythm.
+ */
+import type * as React from 'react';
+export interface GlobalSearchGroupHeadingProps {
+    /** Caption copy. */
+    label: React.ReactNode;
+    /** Optional leading glyph supplied by the section. */
+    icon?: React.ElementType;
+    /** Trailing action, such as "See all". */
+    action?: React.ReactNode;
+}
+export declare function GlobalSearchGroupHeading({ label, icon: Icon, action }: GlobalSearchGroupHeadingProps): React.JSX.Element;

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

@@ -1,8 +1,3 @@
-/**
- * Default tone palettes for thumbnails and avatars.
- *
- * Consumers can override per-call via `slots.toneBg` / `slots.toneAvatar`.
- */
 import type { GlobalSearchTone } from '../global-search.types';
 export declare const DEFAULT_TONE_BG: Record<GlobalSearchTone, string>;
 export declare const DEFAULT_TONE_AVATAR: Record<GlobalSearchTone, string>;

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

@@ -21,7 +21,7 @@ export declare namespace KanbanItem {
 }
 export declare const KanbanItemHandle: import("react").ForwardRefExoticComponent<KanbanItemHandleProps & import("react").RefAttributes<HTMLButtonElement>>;
 /**
- * Per-item actions menu (`⋮` trigger → popover with the actions
+ * Per-item actions menu (`⋯` trigger → popover with the actions
  * registered at the `<Kanban itemActions>` root). Place inside any
  * `<KanbanItem>` — typically in the card's top-right corner.
  *

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

@@ -17,7 +17,7 @@ export interface KanbanStrings {
     dragHandleAria: string;
     /** Aria label on the board landmark. */
     boardAria: string;
-    /** Aria label on the per-item actions trigger (`⋮`). */
+    /** Aria label on the per-item actions trigger (`⋯`). */
     itemActionsAria: string;
 }
 export declare const defaultKanbanStrings: KanbanStrings;

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

@@ -10,7 +10,7 @@ import type { KanbanStrings } from './kanban.strings';
 export type KanbanValue<T = unknown> = Record<string, T[]>;
 /**
  * A single action available on a Kanban item — surfaces inside the
- * `<KanbanItemActions>` (`⋮`) shared `ActionMenu`. Mirrors the action
+ * `<KanbanItemActions>` (`⋯`) shared `ActionMenu`. Mirrors the action
  * definition shape used by table/card/page action chrome so consumers can
  * re-use the same action concepts across surfaces.
  */
@@ -148,7 +148,7 @@ export interface KanbanItemHandleProps {
 export interface KanbanItemActionsProps {
     /** Optional class on the trigger button. */
     className?: string;
-    /** Override the trigger icon (defaults to a `⋮` MoreHorizontal). */
+    /** Override the trigger icon. Defaults to the shared `⋯` overflow glyph. */
     icon?: ReactNode;
     /** aria-label on the trigger button. Defaults to `strings.itemActionsAria`. */
     ariaLabel?: string;

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

@@ -2,4 +2,4 @@ import type { MediaLibraryAccessors, MediaLibraryItem, ResolvedMediaLibraryAcces
 export declare function resolveMediaLibraryAccessors<TItem = MediaLibraryItem>(accessors?: MediaLibraryAccessors<TItem>): ResolvedMediaLibraryAccessors<TItem>;
 export declare function formatMediaLibrarySize(bytes?: number): string;
 export declare function getMediaLibraryDimensions<TItem>(item: TItem, accessors: ResolvedMediaLibraryAccessors<TItem>): string;
-export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, }?: UseMediaLibraryOptions<TItem>): MediaLibraryState<TItem>;
+export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, selecting: selectingProp, defaultSelecting, onSelectingChange, }?: UseMediaLibraryOptions<TItem>): MediaLibraryState<TItem>;

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

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

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

@@ -1,3 +1,3 @@
 import type { MediaLibraryDialogProps, MediaLibraryProps } from './media-library.types';
-export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onUpload, onError, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, bulkActions, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onItemOpen, onUpload, onError, selecting, defaultSelecting, onSelectingChange, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryDialog<TItem = import('./media-library.types').MediaLibraryItem>({ open, onOpenChange, trigger, dialogTitle, dialogDescription, onClose, className, dialogClassName, contentClassName, closeOnEscape, closeOnBackdropClick, ...props }: MediaLibraryDialogProps<TItem>): import("react").JSX.Element;

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

@@ -40,6 +40,10 @@ export interface MediaLibraryStrings {
     errorTitle: string;
     errorDescription: string;
     cardDetails: string;
+    /** Toolbar toggle that turns selection mode on or off. */
+    selectMode: string;
+    /** Check control that selects one asset while browsing; `{name}` is the asset. */
+    selectItem: string;
     privateLabel: string;
     publicLabel: string;
     typeImage: string;

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";
     };
 };
 /**