themelia-react-ui 2.0.0 → 2.0.2

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

@@ -3,10 +3,13 @@
  *
  * Density mapping:
  *   - `compact`  → small tone-coloured dot
- *   - `default`  → 22px tone-tinted square with the event icon
- *   - `rich`     → 28px tone-tinted circle with the event icon
+ *   - `default`  → icon-lg tone-tinted disc with the event icon
+ *   - `rich`     → small IconBadge (avatar-sm) with the event icon
  *
- * Always renders the connector line beneath unless `last` is true.
+ * Every marker heads a first-line box at least `icon-lg` tall, the height of
+ * the headline's first line, so the glyph centres on that line by layout
+ * rather than by a nudge. Always renders the connector line beneath unless
+ * `last` is true.
  */
 import type { LucideIcon } from 'lucide-react';
 import type { ActivityDensity, ActivityTone } from '../activities.types';

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/appointment-calendar/appointment-calendar.d.ts

@@ -0,0 +1,5 @@
+import { type Appointment, type AppointmentCalendarProps } from './appointment-calendar.types';
+export declare function AppointmentCalendar<T extends Appointment = Appointment>({ appointments, categories, staff: staffProp, title, date: dateProp, defaultDate, onDateChange, view: viewProp, defaultView, onViewChange, category: categoryProp, defaultCategory, onCategoryChange, staffId: staffIdProp, defaultStaffId, onStaffChange, onAppointmentClick, appointmentActions, renderAppointment, onRangeChange, onCreateAppointment, onConflictsDismiss, loading, error, onRetry, weekStartsOn: weekStartsOnProp, strings: stringsProp, className, }: AppointmentCalendarProps<T>): import("react").JSX.Element;
+export declare namespace AppointmentCalendar {
+    var displayName: string;
+}

package/dist/components/features/appointment-calendar/appointment-calendar.types.d.ts

@@ -0,0 +1,220 @@
+import type { ReactNode } from 'react';
+import type { ActionMenuAction } from '../../base/action-menu';
+import type { BadgeTone } from '../../base/badge';
+import type { StringsProp } from '../../../lib/strings';
+/** Where an appointment stands. Conflicts are derived, never a status. */
+export type AppointmentStatus = 'confirmed' | 'pending' | 'completed' | 'cancelled' | 'noShow';
+/** The day agenda or the seven-day week agenda beside the month. */
+export type AppointmentCalendarView = 'day' | 'week';
+/**
+ * Categorical colour for a service category. Categories are kinds, not
+ * statuses, so they draw from the chart series palette and never from the
+ * success, warning or destructive tones that status chips own.
+ */
+export type AppointmentCategoryColor = 'chart-1' | 'chart-2' | 'chart-3' | 'chart-4' | 'chart-5';
+/** A service category: its label, filter chip and marker colour. */
+export interface AppointmentCategory {
+    /** Stable identity, referenced by `Appointment.category`. */
+    id: string;
+    /** Chip and legend label. */
+    label: string;
+    /** Marker colour. Defaults to the chart series by the category's position. */
+    color?: AppointmentCategoryColor;
+}
+/** A person on an appointment: the staff member who delivers it, or the client. */
+export interface AppointmentPerson {
+    /** Stable identity. Staff overlap is detected by this id. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Portrait. Initials stand in without one, or when it fails to load. */
+    avatarUrl?: string;
+}
+/** One booked slot. The calendar formats it; it never fetches or saves. */
+export interface Appointment {
+    /** Stable identity. */
+    id: string;
+    /** The service: "Cut and blow-dry". */
+    title: string;
+    /** Start of the slot. */
+    start: Date;
+    /** End of the slot; later than `start`. */
+    end: Date;
+    /** Category id, matching an `AppointmentCategory`. */
+    category: string;
+    /** Booking state. Cancelled appointments are listed but never conflict. */
+    status: AppointmentStatus;
+    /** Who the appointment is for, shown after the time. */
+    client?: AppointmentPerson | string;
+    /** Who delivers it. Two overlapping appointments for one staff member conflict. */
+    staff?: AppointmentPerson;
+}
+/** The days on screen: the month grid and the agenda. `end` is exclusive (midnight after the last day). */
+export interface AppointmentDateRange {
+    start: Date;
+    end: Date;
+}
+/** Overlapping appointments for one staff member. */
+export interface AppointmentConflict<T extends Appointment = Appointment> {
+    /** The double-booked staff member. */
+    staff: AppointmentPerson;
+    /** The appointments that overlap, earliest first. */
+    appointments: T[];
+    /** When the overlap begins. */
+    start: Date;
+}
+export interface AppointmentCalendarStrings {
+    /** Booked count beside the title: "8 booked". */
+    formatBooked: (count: number) => string;
+    /** Conflict count beside the title: "2 conflicts". */
+    formatConflicts: (count: number) => string;
+    /** Accessible name of the Day/Week switch. */
+    viewLabel: string;
+    day: string;
+    week: string;
+    /** Accessible name of the staff filter. */
+    staffLabel: string;
+    /** The staff filter's "everyone" option. */
+    allStaff: string;
+    /** Primary command. */
+    newAppointment: string;
+    /** Conflict alert title. */
+    conflictTitle: string;
+    /** One overlapping-booking sentence per double-booked staff member. */
+    formatConflict: (staffName: string, count: number, time: string) => string;
+    /** Hides the conflict alert. */
+    dismiss: string;
+    previousMonth: string;
+    nextMonth: string;
+    /** Accessible name of the month select. */
+    monthLabel: string;
+    /** Accessible name of the year select. */
+    yearLabel: string;
+    /** Accessible name of the category filter. */
+    categoriesLabel: string;
+    /** The category filter's "every category" chip. */
+    allCategories: string;
+    /** Count beside the agenda heading: "8 appointments". */
+    formatCount: (count: number) => string;
+    /** A slot: "9 AM to 10 AM". Receives already formatted times. */
+    formatTimeRange: (start: string, end: string) => string;
+    /** Accessible day label in the month: "Tuesday, June 9, 3 appointments". */
+    formatDayLabel: (date: string, count: number) => string;
+    /** Agenda heading for the week view: "June 8 to 14". */
+    formatWeekRange: (start: string, end: string) => string;
+    /** Status chip words. */
+    status: Record<AppointmentStatus, string>;
+    /** Chip shown instead of the status when an appointment overlaps another. */
+    conflict: string;
+    /** Agenda copy when nothing matches the day or week. */
+    empty: string;
+    /** Loading copy for assistive technology. */
+    loading: string;
+    /** Default error state title. */
+    errorTitle: string;
+    /** Default error state description, when `error` carries no message. */
+    errorDescription: string;
+    /** Retry command in the default error state. */
+    retry: string;
+    /** Accessible name of an appointment's actions menu: "Actions for Balayage". */
+    formatActionsLabel: (title: string) => string;
+}
+export declare const defaultAppointmentCalendarStrings: AppointmentCalendarStrings;
+/** What the calendar has worked out for one appointment, handed to `renderAppointment`. */
+export interface AppointmentRenderContext {
+    /** The appointment's category, when one matches. */
+    category?: AppointmentCategory;
+    /** The category's marker class (`bg-chart-N`), for a stripe or dot of your own. */
+    categoryColorClass: string;
+    /** Whether it overlaps another booking for the same staff member. */
+    conflict: boolean;
+    /** The status chip's word, or the conflict word when it overlaps. */
+    statusLabel: string;
+    /** The status chip's tone: destructive for a conflict, otherwise the status tone. */
+    statusTone: BadgeTone;
+    /** The formatted slot: "09:00 to 10:00". */
+    time: string;
+    /** Opens it through `onAppointmentClick`. Undefined when rows are not interactive. */
+    open?: () => void;
+    /** The visible commands `appointmentActions` returned for it. */
+    actions: readonly ActionMenuAction[];
+    /** The built-in actions menu for those commands, or null when there are none. */
+    actionsMenu: ReactNode;
+    /** The built-in row, to wrap or extend instead of replacing. */
+    defaultRender: () => ReactNode;
+}
+/**
+ * Props for `AppointmentCalendar`. `T` is the app's own appointment type: extra
+ * fields such as a price or notes come back, typed, in every callback.
+ */
+export interface AppointmentCalendarProps<T extends Appointment = Appointment> {
+    /** Appointments to place. The calendar filters and formats; it never fetches. */
+    appointments: T[];
+    /** Service categories: filter chips, markers and day dots. */
+    categories: AppointmentCategory[];
+    /** Staff offered by the staff filter. Defaults to the staff found on appointments. */
+    staff?: AppointmentPerson[];
+    /** Heading above the calendar: the location or calendar name. */
+    title?: ReactNode;
+    /** Selected day. Controlled with `onDateChange`. */
+    date?: Date;
+    /** Selected day for uncontrolled use. Defaults to today. */
+    defaultDate?: Date;
+    /** Fired when a day is chosen or the month moves. */
+    onDateChange?: (date: Date) => void;
+    /** Day or week agenda. Controlled with `onViewChange`. */
+    view?: AppointmentCalendarView;
+    /** View for uncontrolled use. Defaults to `day`. */
+    defaultView?: AppointmentCalendarView;
+    /** Fired when the Day/Week switch changes. */
+    onViewChange?: (view: AppointmentCalendarView) => void;
+    /** Category filter: a category id, or `all`. Controlled with `onCategoryChange`. */
+    category?: string;
+    /** Category filter for uncontrolled use. Defaults to `all`. */
+    defaultCategory?: string;
+    /** Fired when a category chip is chosen. */
+    onCategoryChange?: (category: string) => void;
+    /** Staff filter: a staff id, or `all`. Controlled with `onStaffChange`. */
+    staffId?: string;
+    /** Staff filter for uncontrolled use. Defaults to `all`. */
+    defaultStaffId?: string;
+    /** Fired when the staff filter changes. */
+    onStaffChange?: (staffId: string) => void;
+    /** Fired when an appointment is activated. Without it, rows are not interactive. */
+    onAppointmentClick?: (appointment: T) => void;
+    /**
+     * Commands for one appointment, such as confirm, reschedule or cancel,
+     * offered in a menu at the end of its row. Return an empty list for none.
+     */
+    appointmentActions?: (appointment: T) => readonly ActionMenuAction[];
+    /**
+     * Renders one appointment in the agenda instead of the built-in row. The
+     * context carries its category colour, conflict, time, `open`, its actions
+     * and a ready actions menu, and `defaultRender` for the built-in row.
+     */
+    renderAppointment?: (appointment: T, context: AppointmentRenderContext) => ReactNode;
+    /**
+     * Fired with the days on screen, the month grid and the agenda together, once
+     * on mount and whenever they change. Load appointments for this range.
+     */
+    onRangeChange?: (range: AppointmentDateRange) => void;
+    /** Shows the primary "New appointment" command; receives the selected day. */
+    onCreateAppointment?: (date: Date) => void;
+    /** Fired when the conflict alert is dismissed, with the conflicts it showed. */
+    onConflictsDismiss?: (conflicts: AppointmentConflict<T>[]) => void;
+    /** Shows the loading state in the agenda. */
+    loading?: boolean;
+    /**
+     * Shows the error state in the agenda. A string or Error becomes its
+     * description; any other element replaces the default state.
+     */
+    error?: ReactNode | Error;
+    /** Adds Retry to the default error state. */
+    onRetry?: () => void;
+    /** First column of the month and first day of the week. Defaults to the provider, then Sunday. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Overrides this calendar's own copy. */
+    strings?: StringsProp<AppointmentCalendarStrings>;
+    /** Merged onto the root. */
+    className?: string;
+}

package/dist/components/features/appointment-calendar/appointment-calendar.utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure helpers for the appointment calendar: day arithmetic, filtering,
+ * conflict detection and time formatting. No React, so they are testable and
+ * reusable by an application that pre-computes its own view.
+ */
+import type { Appointment, AppointmentCategory, AppointmentCategoryColor, AppointmentConflict, AppointmentPerson } from './appointment-calendar.types';
+/** Marker colour classes per chart series. Literal so Tailwind generates them. */
+export declare const appointmentCategoryColorClasses: Record<AppointmentCategoryColor, string>;
+/** A category's colour: its own, or the chart series at its position. */
+export declare function categoryColor(categories: AppointmentCategory[], id: string): AppointmentCategoryColor;
+export declare function startOfDay(date: Date): Date;
+export declare function addDays(date: Date, days: number): Date;
+export declare function isSameDay(a: Date, b: Date): boolean;
+/** The same day of the month in another month, clamped to that month's length. */
+export declare function addMonths(date: Date, months: number): Date;
+export declare function startOfWeek(date: Date, weekStartsOn: number): Date;
+/** The seven days of the week that holds `date`. */
+export declare function weekDays(date: Date, weekStartsOn: number): Date[];
+/** Six full weeks covering the month of `date`, so the grid never changes height. */
+export declare function monthGrid(date: Date, weekStartsOn: number): Date[][];
+/** Whether an appointment touches a day (it may run past midnight). */
+export declare function occursOn(appointment: Appointment, day: Date): boolean;
+export declare function appointmentsOn<T extends Appointment>(appointments: T[], day: Date): T[];
+/** Applies the category and staff filters; `all` keeps everything. */
+export declare function filterAppointments<T extends Appointment>(appointments: T[], category: string, staffId: string): T[];
+/**
+ * Overlapping appointments per staff member. Two appointments conflict when
+ * the same staff member is booked for both and their times overlap; touching
+ * ends (10:00 to 10:00) do not overlap, and cancelled appointments never conflict.
+ */
+export declare function findConflicts<T extends Appointment>(appointments: T[]): AppointmentConflict<T>[];
+/** Ids of every appointment that takes part in a conflict. */
+export declare function conflictingIds(conflicts: AppointmentConflict[]): Set<string>;
+/** Distinct staff found on appointments, in first-seen order. */
+export declare function staffFrom(appointments: Appointment[]): AppointmentPerson[];
+/**
+ * "9 AM", or "9:30 AM" when the minutes matter. A 24-hour clock always keeps
+ * its minutes ("09:00"), since a bare "09" does not read as a time.
+ */
+export declare function formatTime(date: Date, locale?: string): string;
+export declare function personName(person: AppointmentPerson | string | undefined): string | undefined;

package/dist/components/features/appointment-calendar/index.d.ts

@@ -0,0 +1,3 @@
+export { AppointmentCalendar } from './appointment-calendar';
+export { defaultAppointmentCalendarStrings, type Appointment, type AppointmentCalendarProps, type AppointmentCalendarStrings, type AppointmentCalendarView, type AppointmentCategory, type AppointmentCategoryColor, type AppointmentConflict, type AppointmentDateRange, type AppointmentPerson, type AppointmentRenderContext, type AppointmentStatus, } from './appointment-calendar.types';
+export { appointmentsOn, filterAppointments, findConflicts, } from './appointment-calendar.utils';

package/dist/components/features/appointment-calendar/partials/appointment-agenda.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AppointmentAgenda — the list beside the month: one day's appointments, or
+ * the selected week grouped by day. Each row shows its category stripe, the
+ * service with its status chip (or the conflict chip when it overlaps another
+ * booking for the same staff member), the time range and client, and the
+ * staff member's avatar. A row opens only when the app can open it: a
+ * transparent button stretched over the row takes the click, and the actions
+ * menu sits above it, since a button cannot hold another. Private to the
+ * appointment calendar.
+ */
+import { type ReactNode } from 'react';
+import { type ActionMenuAction } from '../../../base/action-menu';
+import type { Appointment, AppointmentCalendarStrings, AppointmentCategory, AppointmentRenderContext } from '../appointment-calendar.types';
+export interface AppointmentAgendaProps {
+    /** The days to list: one for the day view, seven for the week view. */
+    days: Date[];
+    /** Appointments after the category and staff filters. */
+    appointments: Appointment[];
+    categories: AppointmentCategory[];
+    /** Ids of appointments that overlap another booking for the same staff member. */
+    conflicts: Set<string>;
+    heading: string;
+    loading: boolean;
+    error?: ReactNode | Error;
+    onRetry?: () => void;
+    locale?: string;
+    onAppointmentClick?: (appointment: Appointment) => void;
+    appointmentActions?: (appointment: Appointment) => readonly ActionMenuAction[];
+    renderAppointment?: (appointment: Appointment, context: AppointmentRenderContext) => ReactNode;
+    strings: AppointmentCalendarStrings;
+}
+export declare function AppointmentAgenda({ days, appointments, categories, conflicts, heading, loading, error, onRetry, locale, onAppointmentClick, appointmentActions, renderAppointment, strings }: AppointmentAgendaProps): import("react").JSX.Element;

package/dist/components/features/appointment-calendar/partials/appointment-month.d.ts

@@ -0,0 +1,13 @@
+import type { Appointment, AppointmentCalendarStrings, AppointmentCategory } from '../appointment-calendar.types';
+export interface AppointmentMonthProps {
+    selected: Date;
+    onSelect: (date: Date) => void;
+    /** The first day of the month on screen, which keyboard focus can move away from the selection. */
+    onVisibleMonthChange?: (month: Date) => void;
+    appointments: Appointment[];
+    categories: AppointmentCategory[];
+    weekStartsOn: number;
+    locale?: string;
+    strings: AppointmentCalendarStrings;
+}
+export declare function AppointmentMonth({ selected, onSelect, onVisibleMonthChange, appointments, categories, weekStartsOn, locale, strings }: AppointmentMonthProps): import("react").JSX.Element;

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

@@ -10,5 +10,19 @@
  * here for the constants file.
  */
 import type { ComboboxStrings } from './types';
-export declare const defaultComboboxStrings: ComboboxStrings;
+export declare const defaultComboboxStrings: {
+    placeholder: string;
+    clear: string;
+    toggle: string;
+    dismiss: string;
+    removeSelection: (itemLabel: string) => string;
+    searching: string;
+    noResults: string;
+    typeToSearch: string;
+    typeMore: string;
+    createNew: string;
+    loadingMore: string;
+    apply: string;
+    cancel: string;
+};
 export type { ComboboxStrings };

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

@@ -9,6 +9,10 @@ export type ComboboxStrings = {
     placeholder: string;
     clear: string;
     toggle: string;
+    /** Accessible name of both screen-reader dismissal controls. */
+    dismiss?: string;
+    /** Names an individual selected item's removal button. */
+    removeSelection?: (itemLabel: string) => string;
     searching: string;
     noResults: string;
     typeToSearch: string;

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,12 @@ 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;
+    /** Accessible name of the selected-assets action region. Defaults to "Batch actions". */
+    batchActionsLabel?: string;
     privateLabel: string;
     publicLabel: string;
     typeImage: string;