themelia-react-ui 2.0.4 → 2.0.6

package/dist/components/blocks/commerce/invoice-mini/types.d.ts

@@ -1,7 +1,11 @@
 import type { ComponentPropsWithoutRef } from 'react';
 import type { BadgeTone } from '../../../base/badge';
 import type { StringsProp } from '../../../../lib/strings';
-export type InvoiceStatus = 'paid' | 'pending' | 'overdue';
+/**
+ * Where an invoice stands: `draft` (not yet issued), `pending` (issued, open,
+ * not yet due), `overdue`, `disputed` (part of it is contested) or `paid`.
+ */
+export type InvoiceStatus = 'draft' | 'pending' | 'overdue' | 'disputed' | 'paid';
 export interface InvoiceMiniData {
     invoiceNumber: string;
     customerName: string;
@@ -11,9 +15,11 @@ export interface InvoiceMiniData {
     dueDate: string;
 }
 export interface InvoiceMiniStrings {
+    draft: string;
     paid: string;
     pending: string;
     overdue: string;
+    disputed: string;
     items: (count: number) => string;
     due: string;
 }

package/dist/components/blocks/commerce/order-customer/order-customer.d.ts

@@ -1,5 +1,5 @@
 import { type OrderCustomerProps } from './types';
-export declare function OrderCustomer({ name, email, phone, orderCount, shippingAddress, billingAddress, billingSameAsShipping, onOpenCustomer, onEditShipping, onEditBilling, surface, padding, headerDivider, className, strings: stringsProp, ...props }: OrderCustomerProps): import("react").JSX.Element;
+export declare function OrderCustomer({ name, email, phone, orderCount, shippingAddress, shippingMethod, showShippingAddress, billingAddress, billingSameAsShipping, onOpenCustomer, onEditShipping, onEditBilling, surface, padding, headerDivider, className, strings: stringsProp, ...props }: OrderCustomerProps): import("react").JSX.Element;
 export declare namespace OrderCustomer {
     var displayName: string;
 }

package/dist/components/blocks/commerce/order-customer/types.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentPropsWithoutRef } from 'react';
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 import type { OrderAddress } from '../shared/order-status';
@@ -33,6 +33,14 @@ export interface OrderCustomerProps extends Omit<ComponentPropsWithoutRef<'div'>
     orderCount?: number;
     /** Where the order ships. */
     shippingAddress?: OrderAddress;
+    /** How it ships, such as "Standard courier · 2–3 business days", under the shipping address. */
+    shippingMethod?: ReactNode;
+    /**
+     * Shows the shipping address section. Set `false` for a subject that never
+     * ships, such as an invoice or a digital order, rather than stating that no
+     * address is on file. @default true
+     */
+    showShippingAddress?: boolean;
     /** Where the order is billed. */
     billingAddress?: OrderAddress;
     /** Renders one line in place of a repeated billing address. */

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

@@ -11,6 +11,10 @@ export interface OrderStatusEvent {
 export interface OrderStatusStrings {
     /** Surface title. */
     title: string;
+    /** Labels for each supported fulfilment stage. */
+    status?: Partial<Record<OrderStatusKind, string>>;
+    /** Formats the human-facing reference displayed below the title. */
+    formatOrderNumber?: (orderNumber: string) => string;
     /** Not rendered: the title badge states the status. Kept for existing overrides. */
     statusLabel: string;
     /** Label of the delivery-estimate fact. */

package/dist/components/blocks/commerce/refund-status/refund-status.d.ts

@@ -1,5 +1,5 @@
 import { type RefundStatusCardProps } from './types';
-export declare function RefundStatusCard({ stage, amount, reason, method, eta, requestedAt, className, strings: stringsProp, ...props }: RefundStatusCardProps): import("react").JSX.Element;
+export declare function RefundStatusCard({ stage, amount, reason, method, eta, requestedAt, className, strings: stringsProp, surface, padding, headerDivider, ...props }: RefundStatusCardProps): import("react").JSX.Element;
 export declare namespace RefundStatusCard {
     var displayName: string;
 }

package/dist/components/blocks/commerce/refund-status/types.d.ts

@@ -1,4 +1,5 @@
 import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export type RefundStage = 'requested' | 'approved' | 'processing' | 'completed';
 export interface RefundStatusStrings {
@@ -18,7 +19,8 @@ export interface RefundStatusStrings {
     method: string;
 }
 export declare const defaultRefundStatusStrings: RefundStatusStrings;
-export interface RefundStatusCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface RefundStatusCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** How far the refund has progressed. */
     stage: RefundStage;
     /** Formatted refund amount. */

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, onCopyTracking, className, strings: stringsProp, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
+export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, onCopyTracking, className, strings: stringsProp, surface, padding, headerDivider, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
 export declare namespace ShipmentTracking {
     var displayName: string;
 }

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

@@ -1,5 +1,6 @@
 import type { ComponentPropsWithoutRef, ReactNode } from 'react';
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 /**
  * Transit stage. Drives the status label (through `strings`) and the tone of
@@ -45,7 +46,8 @@ export interface ShipmentTrackingStrings {
     delayed: string;
 }
 export declare const defaultShipmentTrackingStrings: ShipmentTrackingStrings;
-export interface ShipmentTrackingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface ShipmentTrackingProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Carrier tracking reference. */
     trackingNumber: string;
     /** Carrier handling the shipment. */

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, ...props }: TaxBreakdownCardProps): import("react").JSX.Element;
+export declare function TaxBreakdownCard({ subtotal, taxes, totalTax, total, className, strings: stringsProp, surface, padding, headerDivider, ...props }: TaxBreakdownCardProps): import("react").JSX.Element;
 export declare namespace TaxBreakdownCard {
     var displayName: string;
 }

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

@@ -1,4 +1,5 @@
 import type { ComponentPropsWithoutRef } from 'react';
+import type { CardProps } from '../../../base/cards';
 import type { StringsProp } from '../../../../lib/strings';
 export interface TaxLineItem {
     /** Stable identity for this entry. */
@@ -19,7 +20,8 @@ export interface TaxBreakdownStrings {
     total: string;
 }
 export declare const defaultTaxBreakdownStrings: TaxBreakdownStrings;
-export interface TaxBreakdownCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface TaxBreakdownCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'>, Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Formatted amount before tax. */
     subtotal: string;
     /** Individual tax lines making up the total. */

package/dist/components/blocks/data-display/empty-state/empty-state.types.d.ts

@@ -3,13 +3,14 @@ import type { ComponentScale } from '../../../../lib/component-vocabulary';
 import type { StringsProp } from '../../../../lib/strings';
 import type { EmptyStateStrings } from './empty-state.strings';
 /**
- * Vertical breathing room.
+ * Surface inset.
  *
+ * `none` — flush inside a parent that already owns the inset.
  * `sm` — compact cards, table cells, and side panels.
  * `md` — normal table, list, and card empty states.
  * `lg` — large page-level empty states.
  */
-export type EmptyStatePadding = ComponentScale;
+export type EmptyStatePadding = ComponentScale | 'none';
 /**
  * How the `media` slot renders.
  *
@@ -66,7 +67,7 @@ export interface EmptyStateProps {
      * keyboard hints, etc.
      */
     footer?: ReactNode;
-    /** Vertical breathing. Defaults to the provider density scale; tune values through CSS variables. */
+    /** Surface inset. Defaults to the provider density scale. Use `none` inside an already padded surface. */
     padding?: EmptyStatePadding;
     /**
      * `border` toggles the dashed-border look on/off. Defaults to `false`

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

@@ -61,26 +61,27 @@ export interface ActivityResourceConfig {
     /** Free-form note exposed via tooltip. */
     note?: string;
 }
-/** A single piece of the headline — blocks inline by the renderer. */
-export type ActivityHeadlineSegment = {
-    type: 'text';
+type ActivityHeadlineText = {
     text: string;
-} | {
+    /** React content rendered in place of the text fallback. */
+    content?: ReactNode;
+};
+/** A single inline piece of the headline. */
+export type ActivityHeadlineSegment = ({
+    type: 'text';
+} & ActivityHeadlineText) | {
     type: 'actor';
     text: string;
     actorId?: string;
     href?: string;
-} | {
+} | ({
     type: 'field';
-    text: string;
-} | {
+} & ActivityHeadlineText) | ({
     type: 'value';
-    text: string;
-} | {
+} & ActivityHeadlineText) | ({
     type: 'status';
-    text: string;
     tone?: ActivityTone;
-} | {
+} & ActivityHeadlineText) | {
     type: 'resource';
     text?: string;
     resource: ActivityResourceRef;
@@ -106,6 +107,8 @@ export interface ActivityItem<TData = unknown> {
     event: string;
     /** Optional source bucket — drives the source-badge label. */
     source?: string;
+    /** React content for the source badge. Takes precedence over the source label. */
+    sourceContent?: ReactNode;
     actor?: ActivityActor;
     /** Pre-built segments — preferred over `headline`. */
     segments?: readonly ActivityHeadlineSegment[];
@@ -142,7 +145,10 @@ export interface ActivityItem<TData = unknown> {
 export interface ActivityEventConfig {
     /** Leading glyph. */
     icon: LucideIcon;
-    /** Semantic tone driving the entry's colour. */
+    /**
+     * Status tone for the event. It colours status dots and status segments;
+     * the event icon tile names a kind and stays neutral.
+     */
     tone: ActivityTone;
     /** Display label for the event. Defaults to `strings.events[event] || event`. */
     label?: string;
@@ -313,14 +319,20 @@ export interface ActivityLogActivityEntry<TResource extends string = string> {
     event?: string;
     /** Leading glyph. */
     icon?: LucideIcon;
-    /** Semantic tone driving the entry's colour. */
+    /**
+     * Status tone for the entry. It colours status dots and status segments;
+     * the event icon tile names a kind and stays neutral.
+     */
     tone?: ActivityTone;
     actor?: string | ActivityActor;
     /** The action this surface performs. */
     action?: string;
     target?: ReactNode;
+    /** Status badge content. Takes precedence over the target value. */
+    status?: ReactNode;
     /** Display label. */
     label?: ReactNode;
+    /** Fallback headline when no action or target is supplied. Accepts inline React content. */
     headline?: ReactNode;
     /** Supporting copy shown under the label. */
     description?: ReactNode;
@@ -429,3 +441,4 @@ export interface ActivityLogProps<TUser extends CommentUser = CommentUser, TMeta
     className?: string;
 }
 export type ActivityLogSubmit<TResource extends string = string> = (values: CommentFormValues<TResource>, helpers: CommentSubmitHelpers) => void | Promise<void>;
+export {};

package/dist/components/features/activities/hooks/use-activity-resources.d.ts

@@ -1,6 +1,7 @@
 import type { ActivityResourceConfig, ActivityResourceRef } from '../activities.types';
 export type ActivityResourceRegistry = Readonly<Record<string, ActivityResourceConfig>>;
 export interface UseActivityResourcesOptions {
+    /** Registry seed. Equivalent resource values preserve local edits. */
     resources?: ActivityResourceRegistry;
     onResourcesChange?: (registry: ActivityResourceRegistry) => void;
 }
@@ -16,7 +17,7 @@ export interface UseActivityResourcesReturn {
     remove: (key: string) => void;
     /** Replace the entire registry. */
     setAll: (registry: ActivityResourceRegistry) => void;
-    /** Reset to the original `resources` prop (or empty if none). */
+    /** Reset to the latest resource seed. */
     reset: () => void;
 }
 export declare function useActivityResources({ resources, onResourcesChange, }?: UseActivityResourcesOptions): UseActivityResourcesReturn;

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

@@ -2,9 +2,13 @@
  * ActivityMarker — left-edge visual for a row.
  *
  * Density mapping:
- *   - `compact`  → small tone-coloured dot
- *   - `default`  → icon-lg tone-tinted disc with the event icon
- *   - `rich`     → small IconBadge (avatar-sm) with the event icon
+ *   - `compact`  → small tone-coloured status dot
+ *   - `default`  → icon-lg neutral disc with the event icon
+ *   - `rich`     → small neutral IconBadge (avatar-sm) with the event icon
+ *
+ * Event icons name a kind, not a status, so their tiles and the rail stay
+ * neutral whatever the tone; the tone reaches the compact status dot and the
+ * headline's status segment.
  *
  * 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

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

@@ -68,5 +68,29 @@ export interface ActivityRowProps<TData = unknown> {
     contentClassName?: string;
     /** Merged onto the details. */
     detailsClassName?: string;
+    /**
+     * Keeps the expand toggle's column when this row has none, so timestamps
+     * share one end edge with sibling rows that do. The feed sets it.
+     */
+    reserveDisclosure?: boolean;
+    /**
+     * Keeps the overflow menu's column when this row has none, so timestamps
+     * share one end edge with sibling rows that do. The feed sets it.
+     */
+    reserveMenu?: boolean;
 }
+/**
+ * Which trailing controls a row draws beside its timestamp. The feed asks every
+ * row first, so rows without a control can keep its column and the timestamps align.
+ */
+export declare function resolveActivityRowTrailing<TData = unknown>({ activity, density, detailsCollapsible, customDetails, actions, }: {
+    activity: ActivityItem<TData>;
+    density: ActivityDensity;
+    detailsCollapsible?: boolean;
+    customDetails?: ReactNode;
+    actions: readonly ActivityAction<TData>[];
+}): {
+    disclosure: boolean;
+    menu: boolean;
+};
 export declare function ActivityRow<TData = unknown>(props: ActivityRowProps<TData>): import("react").JSX.Element;

package/dist/components/features/ai-chat/hooks/use-ai-chat-scroll.d.ts

@@ -1,7 +1,7 @@
 export interface UseAiChatScrollOptions {
     /** Distance (px) from bottom counted as "at bottom". */
     threshold?: number;
-    /** Re-evaluate on these dependencies (typically the message count). */
+    /** Re-evaluate when content changes, including updates to existing messages. */
     dependency?: unknown;
     /** Disable auto-scroll-on-update behaviour. */
     disableAutoScroll?: boolean;

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

@@ -1,5 +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 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, onStaffIdChange, 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

@@ -174,11 +174,13 @@ export interface AppointmentCalendarProps<T extends Appointment = Appointment> {
     defaultCategory?: string;
     /** Fired when a category chip is chosen. */
     onCategoryChange?: (category: string) => void;
-    /** Staff filter: a staff id, or `all`. Controlled with `onStaffChange`. */
+    /** Staff filter: a staff id, or `all`. Controlled with `onStaffIdChange`. */
     staffId?: string;
     /** Staff filter for uncontrolled use. Defaults to `all`. */
     defaultStaffId?: string;
-    /** Fired when the staff filter changes. */
+    /** Fired when the staff filter changes. Takes precedence over `onStaffChange`. */
+    onStaffIdChange?: (staffId: string) => void;
+    /** Legacy alias for `onStaffIdChange`. */
     onStaffChange?: (staffId: string) => void;
     /** Fired when an appointment is activated. Without it, rows are not interactive. */
     onAppointmentClick?: (appointment: T) => void;

package/dist/components/features/combobox/async-resource-combobox.d.ts

@@ -21,7 +21,7 @@ export interface AsyncResourceComboboxRenderErrorContext {
     query: string;
     retry: () => void;
 }
-export interface AsyncResourceComboboxProps<T> extends Omit<ComboboxProps<T>, 'items' | 'selectedValue' | 'onSelectedValueChange' | 'clearSearchOnClose' | 'searchValue' | 'onSearchValueChange' | 'getItemLabel' | 'getItemKey' | 'loading' | 'showListContent' | 'renderItem' | 'strings' | 'error' | 'debounceMs'> {
+export interface AsyncResourceComboboxProps<T> extends Omit<ComboboxProps<T>, 'items' | 'selectedValue' | 'onSelectedValueChange' | 'clearSearchOnClose' | 'getItemLabel' | 'getItemKey' | 'loading' | 'showListContent' | 'renderItem' | 'strings' | 'error' | 'debounceMs'> {
     /**
      * Loads options for the current query. This component owns the request
      * lifecycle: calls are debounced by `debounceMs`, the previous request is
@@ -88,7 +88,7 @@ export interface AsyncResourceComboboxProps<T> extends Omit<ComboboxProps<T>, 'i
     /** Trigger density. Falls back to `UIProvider.density.defaultScale`, then `md`. */
     size?: ComboboxSize;
 }
-export declare function AsyncResourceCombobox<T>({ fetcher, value, defaultValue, onValueChange, onAfterFetch, onError, getKey, getLabel, getDescription, getMeta, renderOption, limit, debounceMs, preload, minSearchLength, errorMessage, renderError, strings: stringsProp, disabled, size, ...props }: AsyncResourceComboboxProps<T>): import("react").JSX.Element;
+export declare function AsyncResourceCombobox<T>({ fetcher, value, defaultValue, onValueChange, searchValue: controlledSearch, defaultSearchValue, onSearchValueChange, onAfterFetch, onError, getKey, getLabel, getDescription, getMeta, renderOption, limit, debounceMs, preload, minSearchLength, errorMessage, renderError, strings: stringsProp, disabled, size, ...props }: AsyncResourceComboboxProps<T>): import("react").JSX.Element;
 export declare namespace AsyncResourceCombobox {
     var displayName: string;
 }

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

@@ -10,11 +10,11 @@
  */
 import * as React from 'react';
 import type { ComboboxProps, MultiComboboxProps } from './types';
-export declare function Combobox<T>({ items, selectedValue, onSelectedValueChange, clearSearchOnClose, searchValue, onSearchValueChange, getItemLabel, getItemKey, loading, showListContent, minSearchLength, strings: stringsProp, disabled, className, clearable, renderItem, portalContainer, name, invalid, error, required, onBlur, onSearch, debounceMs, creatable, onCreate, getItemGroup, renderGroupLabel, hasMore, onLoadMore, loadingMore, getItemDisabled, highlightMatch, size: sizeProp, open, onOpenChange, }: ComboboxProps<T>): React.ReactElement;
+export declare function Combobox<T>({ items, value, defaultValue, onValueChange, selectedValue: legacyValue, onSelectedValueChange: onLegacyValueChange, clearSearchOnClose, searchValue: controlledSearch, defaultSearchValue, onSearchValueChange: onSearchChange, getItemLabel, getItemKey, getItemValue, loading, showListContent, minSearchLength, strings: stringsProp, disabled, className, clearable, renderItem, portalContainer, id, ref, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, 'aria-required': ariaRequired, name, invalid, error, required, onBlur, onSearch, debounceMs, creatable, onCreate, getItemGroup, renderGroupLabel, hasMore, onLoadMore, loadingMore, getItemDisabled, highlightMatch, size: sizeProp, open, defaultOpen, onOpenChange, }: ComboboxProps<T>): React.ReactElement;
 export declare namespace Combobox {
     var displayName: string;
 }
-export declare function MultiCombobox<T>({ items, selectedValues, onSelectedValuesChange, searchValue, onSearchValueChange, getItemLabel, getItemKey, loading, showListContent, minSearchLength, strings: stringsProp, disabled, className, renderItem, portalContainer, name, invalid, error, required, onBlur, onSearch, debounceMs, creatable, onCreate, getItemGroup, renderGroupLabel, hasMore, onLoadMore, loadingMore, getItemDisabled, highlightMatch, size: sizeProp, open, onOpenChange, closeOnSelect, applyButton, onApply, onCancel, }: MultiComboboxProps<T>): React.ReactElement;
+export declare function MultiCombobox<T>({ items, values, defaultValues, onValuesChange, selectedValues: legacyValues, onSelectedValuesChange: onLegacyValuesChange, searchValue: controlledSearch, defaultSearchValue, onSearchValueChange: onSearchChange, getItemLabel, getItemKey, getItemValue, loading, showListContent, minSearchLength, strings: stringsProp, disabled, className, renderItem, portalContainer, id, ref, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, 'aria-required': ariaRequired, name, invalid, error, required, onBlur, onSearch, debounceMs, creatable, onCreate, getItemGroup, renderGroupLabel, hasMore, onLoadMore, loadingMore, getItemDisabled, highlightMatch, size: sizeProp, open, defaultOpen, onOpenChange, closeOnSelect, applyButton, onApply, onCancel, }: MultiComboboxProps<T>): React.ReactElement;
 export declare namespace MultiCombobox {
     var displayName: string;
 }

package/dist/components/features/combobox/hooks/use-combobox-core.d.ts

@@ -24,7 +24,8 @@ export interface UseComboboxCoreReturn<T> {
     showCreateOption: boolean;
     renderItemContent: (item: T) => React.ReactNode;
     itemToStringLabel: (item: T) => string;
+    itemToStringValue: (item: T) => string;
     getItemReactKey: (item: T) => string;
     handleScroll: (event: Event) => void;
 }
-export declare function useComboboxCore<T>({ items, searchValue, getItemLabel, getItemKey, loading, showListContent, minSearchLength, strings: stringsProp, renderItem, onSearch, debounceMs, creatable, onCreate, getItemGroup, hasMore, onLoadMore, loadingMore, highlightMatch, ensuredItems, }: UseComboboxCoreOptions<T>): UseComboboxCoreReturn<T>;
+export declare function useComboboxCore<T>({ items, searchValue, getItemLabel, getItemKey, getItemValue, loading, showListContent, minSearchLength, strings: stringsProp, renderItem, onSearch, debounceMs, creatable, onCreate, getItemGroup, hasMore, onLoadMore, loadingMore, highlightMatch, ensuredItems, }: UseComboboxCoreOptions<T>): UseComboboxCoreReturn<T>;

package/dist/components/features/combobox/hooks/use-combobox-state.d.ts

@@ -0,0 +1 @@
+export declare function useComboboxState<T>(controlled: T | undefined, defaultValue: T, onChange?: (value: T) => void): readonly [T, (next: T) => void];

package/dist/components/features/combobox/hooks/use-load-more.d.ts

@@ -8,5 +8,6 @@ export interface UseLoadMoreOptions {
 }
 export interface UseLoadMoreReturn {
     handleScroll: (event: Event) => void;
+    cancelPendingLoad: () => void;
 }
 export declare function useLoadMore({ hasMore, onLoadMore, loadingMore, }: UseLoadMoreOptions): UseLoadMoreReturn;

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

@@ -22,7 +22,7 @@ export type ComboboxStrings = {
     apply: string;
     cancel: string;
 };
-export type ComboboxSharedProps<T> = {
+export type ComboboxSharedProps<T> = Pick<React.AriaAttributes, 'aria-label' | 'aria-labelledby' | 'aria-describedby' | 'aria-invalid' | 'aria-required'> & {
     /**
      * Options to display, in display order.
      *
@@ -87,8 +87,14 @@ export type ComboboxSharedProps<T> = {
     renderItem?: (item: T) => React.ReactNode;
     /** Mounts the dropdown inside this element instead of the default portal root. */
     portalContainer?: React.RefObject<HTMLElement | null>;
-    /** Form field name, forwarded to the hidden input for uncontrolled submits. */
+    /** ID of the editable input, for an external label. */
+    id?: string;
+    /** Ref to the editable input, for focus management and form adapters. */
+    ref?: React.Ref<HTMLInputElement>;
+    /** Name for native form submission. Selected items submit their key, or their label if no key is supplied. */
     name?: string;
+    /** Overrides the serialized native form value without changing item identity or display. */
+    getItemValue?: (item: T) => string;
     /** Applies the invalid styling to the trigger. */
     invalid?: boolean;
     /** Validation message rendered beneath the trigger. */
@@ -134,6 +140,8 @@ export type ComboboxSharedProps<T> = {
     size?: ComboboxSize;
     /** Controls dropdown visibility. Pair with `onOpenChange`. */
     open?: boolean;
+    /** Initial dropdown visibility when `open` is omitted. Defaults to false. */
+    defaultOpen?: boolean;
     /** Fired when the dropdown wants to open or close. */
     onOpenChange?: (open: boolean) => void;
     /**
@@ -153,16 +161,30 @@ export type ComboboxSharedProps<T> = {
     /** Fired when the user clicks Cancel (closes without committing). */
     onCancel?: () => void;
 };
-export type ComboboxProps<T> = ComboboxSharedProps<T> & {
+type ComboboxInteractiveProps<T> = Omit<ComboboxSharedProps<T>, 'searchValue' | 'onSearchValueChange'> & {
+    /** Controls the raw search text. Omit to let the component own the query. */
+    searchValue?: string;
+    /** Initial search text for uncontrolled use. Defaults to an empty string. */
+    defaultSearchValue?: string;
+    /** Reports raw search edits and resets in either mode. */
+    onSearchValueChange?: (value: string) => void;
+};
+export type ComboboxProps<T> = ComboboxInteractiveProps<T> & {
+    /** Selected item for controlled use. Takes precedence over `selectedValue`, including null. */
+    value?: T | null;
+    /** Initial selected item for uncontrolled use. Defaults to null. */
+    defaultValue?: T | null;
+    /** Reports the next selection. Takes precedence over `onSelectedValueChange`. */
+    onValueChange?: (value: T | null) => void;
     /**
      * The selected item, or `null` when empty. Controlled.
      *
      * Held as the item itself rather than a key, so a selection stays rendered
      * even after `items` is replaced by the next search result set.
      */
-    selectedValue: T | null;
+    selectedValue?: T | null;
     /** Fired with the new selection, or `null` when cleared. */
-    onSelectedValueChange: (value: T | null) => void;
+    onSelectedValueChange?: (value: T | null) => void;
     /**
      * Clears the typed query when the popup closes. Defaults to `true`.
      * Async wrappers disable this so focus can move to an external error or
@@ -170,19 +192,26 @@ export type ComboboxProps<T> = ComboboxSharedProps<T> & {
      */
     clearSearchOnClose?: boolean;
 };
-export type MultiComboboxProps<T> = ComboboxSharedProps<T> & {
+export type MultiComboboxProps<T> = ComboboxInteractiveProps<T> & {
+    /** Selected items for controlled use. Takes precedence over `selectedValues`. */
+    values?: T[];
+    /** Initial selected items for uncontrolled use. Defaults to an empty array. */
+    defaultValues?: T[];
+    /** Reports the next committed selection. Takes precedence over `onSelectedValuesChange`. */
+    onValuesChange?: (values: T[]) => void;
     /**
      * The selected items. Controlled.
      *
      * These are merged ahead of `items` and de-duplicated by key, so selections
      * remain visible and checked even when absent from the current result set.
      */
-    selectedValues: T[];
+    selectedValues?: T[];
     /**
      * Fired with the next selection array.
      *
      * With `applyButton`, edits accumulate in an internal draft and this fires
      * only on Apply; without it, each toggle commits immediately.
      */
-    onSelectedValuesChange: (values: T[]) => void;
+    onSelectedValuesChange?: (values: T[]) => void;
 };
+export {};

package/dist/components/features/email-composer/types.d.ts

@@ -139,11 +139,13 @@ export type EmailComposerProps<C = Record<string, never>, K extends string = str
     onClose?: () => void;
     /** Immutable live context passed to pure variable resolvers; changing it does not edit the draft. */
     context: C;
-    /** Authoritative controlled draft. onChange proposes changes for the parent to accept. */
+    /** Authoritative controlled draft. onValueChange proposes changes for the parent to accept. */
     value?: ComposerDraft<K>;
     /** Initial uncontrolled draft and discard baseline; remount with a new key for another message. */
     defaultValue?: Partial<ComposerDraft<K>>;
     /** Receives a detached draft proposal; treat it immutably when persisting controlled state. */
+    onValueChange?: (draft: ComposerDraft<K>) => void;
+    /** Legacy alias for onValueChange, used when onValueChange is omitted. */
     onChange?: (draft: ComposerDraft<K>) => void;
     /** Per-field editing mode and independent add/remove permissions. */
     recipients?: Partial<Record<"to" | "cc" | "bcc", RecipientOptions>>;

package/dist/components/features/event-calendar/colors.d.ts

@@ -14,9 +14,9 @@ import { type EventCategory } from './event-calendar.types';
 export interface CalendarColorClasses {
     /** Solid dot fill (used as the leading bullet on event chips). */
     dot: string;
-    /** Soft tinted surface for the event badge background. */
+    /** Neutral surface for the event badge background. */
     badgeBg: string;
-    /** Border-tone for the event badge / legend swatch. */
+    /** Neutral edge for the event badge. */
     border: string;
     /** Filled legend swatch (square chip in the legend row). */
     swatch: string;

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

@@ -48,6 +48,10 @@ export type CalendarColorToken = 'gray' | 'red' | 'orange' | 'amber' | 'yellow'
 /**
  * Tailwind class lookups for each canonical token. Used by day-cell dots and
  * event-badge dots so we never string-parse `category.color`.
+ *
+ * A category is a kind, not a status, so each hue family takes the nearest
+ * categorical chart series (`--chart-1…5`) rather than a success, warning,
+ * destructive or info tone; `gray` stays the neutral marker.
  */
 export declare const calendarTokenDot: Record<CalendarColorToken, string>;
 /**

package/dist/components/features/filters/facets/date-facet.d.ts

@@ -1,7 +1,9 @@
-import type { FilterConfig } from '../filters.types';
+import type { FilterConfig, FilterOperator } from '../filters.types';
 export interface DateFacetProps {
     /** Definition of the filter this control edits. */
     filter: FilterConfig;
+    /** Active operator. When omitted, the standalone facet uses the filter configuration. */
+    operator?: FilterOperator;
     /** Current value. */
     value: {
         start?: Date;
@@ -15,4 +17,4 @@ export interface DateFacetProps {
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function DateFacet({ filter, value, onValueChange, className, }: DateFacetProps): import("react").JSX.Element;
+export declare function DateFacet({ filter, operator, value, onValueChange, className, }: DateFacetProps): import("react").JSX.Element;

package/dist/components/features/filters/facets/range-facet.d.ts

@@ -1,3 +1,4 @@
+import { type ChangeEvent } from 'react';
 import type { FilterConfig } from '../filters.types';
 export interface RangeFacetProps {
     /** Definition of the filter this control edits. */
@@ -28,3 +29,14 @@ export interface RangeFacetProps {
  * and provides a user-friendly interface for range selection.
  */
 export declare function RangeFacet({ filter, value, onValueChange, className, }: RangeFacetProps): import("react").JSX.Element;
+interface RangeFacetFieldsProps {
+    min: string;
+    max: string;
+    onMinChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    onMaxChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    className?: string;
+    invalid?: boolean;
+}
+/** The public facet and the Confirm editor share the same field anatomy. */
+export declare function RangeFacetFields({ min, max, onMinChange, onMaxChange, className, invalid }: RangeFacetFieldsProps): import("react").JSX.Element;
+export {};

package/dist/components/features/filters/facets/select-facet.d.ts

@@ -14,6 +14,7 @@ export interface SelectFacetProps {
  *
  * Composes `PopoverMenu` for the popover + searchable list pattern.
  * Multi-select keeps the popover open after a tap; single-select closes
- * unless `closeOnSelect=false` is passed in the filter config.
+ * unless `closeOnSelect=false` is passed in the filter config. Options with
+ * `children` use the Cascader field instead, one level at a time.
  */
 export declare function SelectFacet({ filter, value, onValueChange, className, }: SelectFacetProps): import("react").JSX.Element;

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

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