@servicetitan/anvil2 3.16.1 → 3.18.0

package/dist/src/beta/components/Table/DataTable/types.d.ts

@@ -1,6 +1,11 @@
 import { ReactNode } from 'react';
+import { PaginationProps } from '../../../../components/Pagination';
 import { TableRow } from '../types';
-import { Svg } from '../../../../types';
+import { DataAttributes, Svg } from '../../../../types';
+import { ButtonProps } from '../../../../components/Button';
+import { ToolbarButtonProps } from '../../Toolbar';
+import { ToolbarSize } from '../../Toolbar/types';
+import { Filter } from '../../FilterBar';
 /**
  * Single-column sort. DataTable only applies `sorting[0]`.
  */
@@ -25,6 +30,11 @@ export type DataTableEmptyState = {
     };
     /** Rendered under the illustration. */
     content?: ReactNode;
+    /**
+     * Repeats the `rowAdd` button under `content`, for tables that start empty.
+     * Does nothing without `rowAdd`.
+     */
+    includeAddRow?: boolean;
 };
 /**
  * `loadPageData` page cache. Hits restore a page without calling the loader.
@@ -90,6 +100,10 @@ type DataTablePaginationBaseConfig<T> = {
      * cursor defaults `{ enabled: false }` when this is omitted.
      */
     cache?: DataTableCacheOptions;
+    /**
+     * Label before the rows-per-page menu. {@link PaginationProps.itemsPerPageLabel}
+     */
+    itemsPerPageLabel?: PaginationProps["itemsPerPageLabel"];
 };
 export type DataTableOffsetPaginationConfig<T> = DataTablePaginationBaseConfig<T> & {
     /**
@@ -105,6 +119,11 @@ export type DataTableOffsetPaginationConfig<T> = DataTablePaginationBaseConfig<T
      * omitted — pass this when `loadPageData` returns only the current page.
      */
     totalRowCount?: number;
+    /**
+     * Range text when `showCount` is true. Offset mode only.
+     * {@link PaginationProps.itemRangeFormatter}
+     */
+    itemRangeFormatter?: PaginationProps["itemRangeFormatter"];
     hasNextPage?: never;
     hasPrevPage?: never;
 };
@@ -123,13 +142,103 @@ export type DataTableCursorPaginationConfig<T> = DataTablePaginationBaseConfig<T
     hasPrevPage: boolean;
     showCount?: never;
     totalRowCount?: never;
+    itemRangeFormatter?: never;
 };
 /**
  * Offset (numbered, known total) or cursor (prev/next, unknown total).
  */
 export type DataTablePaginationConfig<T> = DataTableOffsetPaginationConfig<T> | DataTableCursorPaginationConfig<T>;
 /**
- * Imperative handle: refetch the current loader, or drop cached pages.
+ * What a bulk action applies to. `"rows"` lists the checked row ids as
+ * strings, the same form as `onSelectRow` (numeric ids arrive stringified).
+ * `"all"` means every selectable row across pages, including rows that have
+ * not loaded — rows rejected by `isSelectable` and rows in `readOnlyRowIds`
+ * are excluded, so the backend must apply the same rules. Its
+ * `selectedRowCount` is the count the bar shows, sub-rows included.
+ */
+export type DataTableBulkSelection<T> = {
+    mode: "rows";
+    rowIds: TableRow<T>["id"][];
+} | {
+    mode: "all";
+    selectedRowCount: number;
+};
+/**
+ * A bulk action button, or a menu item when nested under `items`.
+ */
+export type DataTableBulkAction<T> = Omit<ButtonProps, "appearance" | "onClick" | "loading" | "children"> & {
+    /**
+     * Visible button text, or menu-item text when nested under `items`. A
+     * function receives the selected count (the total after "Select all N
+     * items"), e.g. for singular and plural wording.
+     */
+    label: string | ((selectedCount: number) => string);
+    /**
+     * Runs with the current {@link DataTableBulkSelection}. Selection clears
+     * once it returns or resolves. Return or resolve `false` to keep rows
+     * selected (e.g. while a confirmation dialog is open); a rejected promise
+     * also keeps them selected. The button shows a spinner while it is pending.
+     */
+    onClick: (selection: DataTableBulkSelection<T>) => void | boolean | Promise<void | boolean>;
+};
+/**
+ * The bar's primary button.
+ */
+export type DataTableBulkPrimaryAction<T> = DataTableBulkAction<T> & {
+    /** Defaults to `"primary"`. */
+    appearance?: "primary" | "danger";
+};
+/**
+ * A primary button that opens a menu of actions instead of running one.
+ */
+export type DataTableBulkMenuAction<T> = Omit<DataTableBulkPrimaryAction<T>, "onClick"> & {
+    /** Menu items. The button runs no handler of its own. */
+    items: DataTableBulkMenuItem<T>[];
+};
+/**
+ * An item in a primary action's menu. `data-*` attributes reach the item.
+ */
+export type DataTableBulkMenuItem<T> = DataAttributes & Pick<DataTableBulkAction<T>, "label" | "onClick"> & {
+    /** Leading icon. */
+    icon?: Svg;
+    /** Prevents selection. Defaults to `false`. */
+    disabled?: boolean;
+};
+/**
+ * A secondary button in the bar.
+ */
+export type DataTableBulkSecondaryAction<T> = DataTableBulkAction<T> & {
+    /** Defaults to `"secondary"`. */
+    appearance?: "secondary" | "danger-secondary";
+};
+/**
+ * Actions shown in the bulk action bar while rows are selected.
+ */
+export type DataTableBulkActions<T> = {
+    /** Primary button. Pass `items` to open a menu of actions instead. */
+    primary?: DataTableBulkPrimaryAction<T> | DataTableBulkMenuAction<T>;
+    /**
+     * Button before the primary one. For more actions, pass `items` to the
+     * primary action instead.
+     */
+    secondary?: DataTableBulkSecondaryAction<T>;
+    /**
+     * Shows a "Select all N items" button that selects rows across pages. Only
+     * shown with offset pagination when the total exceeds one page.
+     * @default false
+     */
+    selectAll?: boolean;
+    /**
+     * Rows "Select all" selects when pages come from `loadPageData`, counting
+     * sub-rows and leaving out rows that can't be selected; the table can't see
+     * rows that haven't loaded. Defaults to `pagination.totalRowCount`. With
+     * `data`, the table counts the selectable rows itself.
+     */
+    selectableRowCount?: number;
+};
+/**
+ * Imperative handle: refetch the current loader, drop cached pages, or clear
+ * the selection.
  */
 export type DataTableRef = {
     /**
@@ -143,5 +252,150 @@ export type DataTableRef = {
      * `refresh` or a cache-invalidating input changes.
      */
     clearCache: () => void;
+    /**
+     * Clears the selection, including a "Select all N items" selection. Use it
+     * after a bulk action returned `false` to keep rows selected, e.g. once a
+     * confirmation dialog is confirmed.
+     */
+    clearSelection: () => void;
+};
+/** One column's place in a {@link DataTableColumnEditing} layout. */
+export type DataTableColumnPref = {
+    /** Id of a top-level column in `columns`. */
+    id: string;
+    /** Controls rendering while retaining the column in the layout so it can be restored. */
+    visible: boolean;
+    /** Pins the column to the left. Hidden columns are never pinned. */
+    pinned: boolean;
+};
+/**
+ * Turns on the Edit Columns button and drawer. The consumer owns the layout:
+ * DataTable applies it to `columns` and reports Apply and Reset Defaults
+ * through `onLayoutChange`.
+ */
+export type DataTableColumnEditing = {
+    /**
+     * Current order, visibility, and pinning: pinned columns first, then the
+     * rest, each in list order, with hidden columns left out. Ids that match no
+     * editable column and repeated ids are ignored; columns missing from the
+     * list are appended as visible, keeping a declared `pinned: "left"`, so a
+     * stored layout survives column changes.
+     */
+    layout: DataTableColumnPref[];
+    /**
+     * Fires with the full layout when the user applies their edits, and with
+     * the layout implied by `columns` when they reset to defaults.
+     */
+    onLayoutChange: (layout: DataTableColumnPref[]) => void;
+    /**
+     * Hides the toolbar button while the layout still applies, for a page that
+     * opens one {@link DataTableEditColumnsDrawer} across several tables.
+     * @default false
+     */
+    hideButton?: boolean;
+};
+/** The parts of a column def the drawer reads, so tables of any row type fit one section list. */
+export type DataTableColumnLike = {
+    id: string | number | symbol;
+    pinned?: "left" | "right";
+    alwaysVisible?: boolean;
+    header?: {
+        label: string;
+    };
+    headerLabel?: string;
+};
+/** One table in a {@link DataTableEditColumnsDrawer}. */
+export type DataTableEditColumnsSection = {
+    /** Heading shown above the section when the drawer has more than one. */
+    title?: string;
+    /** The same `columns` the table receives. */
+    columns: DataTableColumnLike[];
+    /**
+     * Current order, visibility, and pinning for this table's drawer-editable
+     * columns: pinned columns first, then the rest, each in list order, with
+     * hidden columns left out. Ids that match no editable column and repeated
+     * ids are ignored; columns missing from the list are appended as visible,
+     * keeping a declared `pinned: "left"`.
+     */
+    layout: DataTableColumnPref[];
+    /** Fires with the new layout on Apply, or the default layout on Reset. */
+    onLayoutChange: (layout: DataTableColumnPref[]) => void;
+};
+/**
+ * A button in the DataTable toolbar. Takes the props of a toolbar button:
+ * a text label as `children`, or an `icon` with a required `aria-label`.
+ */
+export type DataTableToolbarAction = ToolbarButtonProps & {
+    /** Stable identity for the button. Not forwarded to the DOM. */
+    id: string;
+};
+/**
+ * Filter bar configuration for DataTable. DataTable does not filter rows
+ * itself: apply changes from `onChange` to `data` or to your `loadPageData`
+ * request.
+ */
+export type DataTableFilters = {
+    /**
+     * Filter definitions rendered as a filter bar above the table. Memoize the
+     * array; a new identity re-syncs the bar and discards in-progress input.
+     */
+    items: Filter[];
+    /**
+     * Fires with the full filter list after a filter commit. Any change also
+     * returns a paginated table to its first page and, with `loadPageData`,
+     * clears the page cache and reloads, so the loader sees the new filters.
+     */
+    onChange: (filters: Filter[]) => void;
+    /**
+     * Delays inline commits for filters with an Apply affordance. Filters
+     * without one still commit immediately; the drawer always batches changes.
+     * @default false
+     */
+    controlled?: boolean;
+    /**
+     * Size of the filter bar controls.
+     * @default "medium"
+     */
+    size?: ToolbarSize;
+};
+/**
+ * Toolbar configuration for DataTable, rendered to the right of the filter
+ * bar. Works without `filters`.
+ */
+export type DataTableTools = {
+    /**
+     * Buttons in the toolbar, e.g. Export. Only Anvil2 buttons are accepted;
+     * arbitrary nodes are not.
+     */
+    actions: DataTableToolbarAction[];
+    /**
+     * Size of the toolbar controls.
+     * @default "medium"
+     */
+    size?: ToolbarSize;
+};
+/**
+ * Add row button in a toolbar below the table. DataTable only fires
+ * `onAddRow`: the page owns the flow, such as a dialog or a takeover, and
+ * must update `data` when it finishes, or call {@link DataTableRef} `refresh`
+ * for a table that loads rows with `pagination.loadPageData`.
+ */
+export type DataTableRowAdd = {
+    /** Fires when the Add button is clicked. */
+    onAddRow: () => void;
+    /**
+     * Label of the Add button.
+     * @default "Add row"
+     */
+    addRowLabel?: string;
+    /** Disables the Add button. */
+    disabled?: boolean;
+    /** Shows the Add button as busy, e.g. while an external check runs. */
+    loading?: boolean;
+    /**
+     * Size of the toolbar controls.
+     * @default "medium"
+     */
+    size?: ToolbarSize;
 };
 export {};

package/dist/src/beta/components/Table/types.d.ts

@@ -519,6 +519,12 @@ export type ColumnBaseDef = ColumnHeaderConfig & {
     defaultWidth?: number;
     /** Keeps the column against the chosen edge while horizontally scrolling. */
     pinned?: "left" | "right";
+    /**
+     * Disables the column's hide button in the Edit Columns drawer. It is still
+     * listed there and can be reordered or pinned. Only applies when DataTable
+     * has `columnEditing`.
+     */
+    alwaysVisible?: boolean;
     /** Shows a pointer-driven resize handle. */
     resizable?: boolean;
 };

package/dist/src/beta/components/deprecatedReexports/MultiSelectField.d.ts

@@ -2,21 +2,21 @@ import { MultiSelectFieldProps as StableMultiSelectFieldProps, MultiSelectFieldH
 import { ForwardRefExoticComponent, RefAttributes } from 'react';
 /**
  * @deprecated Import `MultiSelectField` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-field/beta-changes/stable-promotion Migration guide}
  */
 export declare const MultiSelectField: ForwardRefExoticComponent<StableMultiSelectFieldProps & RefAttributes<StableMultiSelectFieldHandleProps>>;
 /**
  * @deprecated Import `MultiSelectFieldSync` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-field/beta-changes/stable-promotion Migration guide}
  */
 export declare const MultiSelectFieldSync: <TID extends string | number>(props: StableMultiSelectFieldSyncProps<TID>) => import("react/jsx-runtime").JSX.Element;
 /**
  * @deprecated Import `MultiSelectFieldSyncProps` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-field/beta-changes/stable-promotion Migration guide}
  */
 export type MultiSelectFieldSyncProps = StableMultiSelectFieldSyncProps;
 /**
  * @deprecated Import MultiSelectField types from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-field/beta-changes/stable-promotion Migration guide}
  */
 export type * from '../../../components/MultiSelectField/types';

package/dist/src/beta/components/deprecatedReexports/MultiSelectMenu.d.ts

@@ -1,21 +1,21 @@
 import { MultiSelectMenuSyncProps as StableMultiSelectMenuSyncProps } from '../../../components/MultiSelectMenu';
 /**
  * @deprecated Import `MultiSelectMenu` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
  */
 export declare const MultiSelectMenu: import('react').ForwardRefExoticComponent<import('./MultiSelectMenu').MultiSelectMenuProps & import('react').RefAttributes<import('./MultiSelectMenu').MultiSelectMenuHandle>>;
 /**
  * @deprecated Import `MultiSelectMenuSync` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
  */
 export declare const MultiSelectMenuSync: (props: StableMultiSelectMenuSyncProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * @deprecated Import `MultiSelectMenuSyncProps` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
  */
 export type MultiSelectMenuSyncProps = StableMultiSelectMenuSyncProps;
 /**
  * @deprecated Import MultiSelectMenu types from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/multi-select-menu/beta-changes/stable-promotion Migration guide}
  */
 export type * from '../../../components/MultiSelectMenu/types';

package/dist/src/beta/components/deprecatedReexports/SelectField.d.ts

@@ -2,21 +2,21 @@ import { SelectFieldProps as StableSelectFieldProps, SelectFieldHandle as Stable
 import { ForwardRefExoticComponent, RefAttributes } from 'react';
 /**
  * @deprecated Import `SelectField` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-field/beta-changes/stable-promotion Migration guide}
  */
 export declare const SelectField: ForwardRefExoticComponent<StableSelectFieldProps & RefAttributes<StableSelectFieldHandleProps>>;
 /**
  * @deprecated Import `SelectFieldSync` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-field/beta-changes/stable-promotion Migration guide}
  */
 export declare const SelectFieldSync: <TID extends string | number>(props: StableSelectFieldSyncProps<TID>) => import("react/jsx-runtime").JSX.Element;
 /**
  * @deprecated Import `SelectFieldSyncProps` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-field/beta-changes/stable-promotion Migration guide}
  */
 export type SelectFieldSyncProps = StableSelectFieldSyncProps;
 /**
  * @deprecated Import SelectField types from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-field/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-field/beta-changes/stable-promotion Migration guide}
  */
 export type * from '../../../components/SelectField/types';

package/dist/src/beta/components/deprecatedReexports/SelectMenu.d.ts

@@ -1,21 +1,21 @@
 import { SelectMenuSyncProps as StableSelectMenuSyncProps } from '../../../components/SelectMenu';
 /**
  * @deprecated Import `SelectMenu` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-menu/beta-changes/stable-promotion Migration guide}
  */
 export declare const SelectMenu: import('react').ForwardRefExoticComponent<import('./SelectMenu').SelectMenuProps & import('react').RefAttributes<import('./SelectMenu').SelectMenuHandle>>;
 /**
  * @deprecated Import `SelectMenuSync` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-menu/beta-changes/stable-promotion Migration guide}
  */
 export declare const SelectMenuSync: (props: StableSelectMenuSyncProps) => import("react/jsx-runtime").JSX.Element;
 /**
  * @deprecated Import `SelectMenuSyncProps` from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-menu/beta-changes/stable-promotion Migration guide}
  */
 export type SelectMenuSyncProps = StableSelectMenuSyncProps;
 /**
  * @deprecated Import SelectMenu types from `@servicetitan/anvil2` instead. The beta export will be removed in Anvil2 4.0.
- * @see {@link https://anvil.servicetitan.com/docs/web/components/select-menu/beta-changes/stable-promotion Migration guide}
+ * @see {@link https://anvil.servicetitan.com/docs/components/select-menu/beta-changes/stable-promotion Migration guide}
  */
 export type * from '../../../components/SelectMenu/types';

package/dist/src/beta/components/index.d.ts

@@ -13,3 +13,4 @@ export * from './RichTextEditor';
 export * from './SavedFiltersButton';
 export * from './TypeaheadTextField';
 export * from './Page';
+export * from './Details';

package/dist/src/components/DrillDown/DrillDownHeader.d.ts

@@ -1,11 +1,20 @@
 import { PassThroughPropsWithRef } from '../../types';
 import { TextProps } from '../Text';
+import { DrawerHeaderAction } from '../Drawer/DrawerHeader';
+/** Command shown in `DrillDown.Header`'s overflow menu. Same shape as {@link DrawerHeaderAction}. */
+export type DrillDownHeaderAction = DrawerHeaderAction;
 export type DrillDownHeaderProps = PassThroughPropsWithRef<"header"> & {
     /** Heading element for the title. Defaults to `h1`. */
     el?: TextProps["el"];
+    /**
+     * Commands placed in an overflow menu before the close control. Belong to
+     * this screen only; the host Drawer's actions are not inherited.
+     */
+    actions?: DrillDownHeaderAction[];
 };
 /**
- * Title row with a back control. Close appears when this screen registered
- * `onClose`. Children are the heading text.
+ * Title row with a back control. An overflow menu appears when `actions` is
+ * non-empty, and Close appears when this screen registered `onClose`.
+ * Children are the heading text.
  */
 export declare const DrillDownHeader: import('react').ForwardRefExoticComponent<Omit<DrillDownHeaderProps, "ref"> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/DrillDown/index.d.ts

@@ -1,5 +1,5 @@
 export { DrillDown as default, DrillDown, type DrillDownProps, } from './DrillDown';
-export { DrillDownHeader, type DrillDownHeaderProps } from './DrillDownHeader';
+export { DrillDownHeader, type DrillDownHeaderAction, type DrillDownHeaderProps, } from './DrillDownHeader';
 export { DrillDownContent, type DrillDownContentProps, } from './DrillDownContent';
 export { DrillDownFooter, type DrillDownFooterProps } from './DrillDownFooter';
 export { DrillDownNextButton, type DrillDownNextButtonProps, } from './DrillDownNextButton';

package/dist/src/components/DrillDown/internal/DrillDownContext.d.ts

@@ -1,5 +1,9 @@
 import { Dispatch, SetStateAction } from 'react';
+/** Component that owns the DrillDown stack. */
+export type DrillDownHost = "dialog" | "drawer" | "panel";
 export type DrillDownContextProps = {
+    /** Owning host. `DrillDown.Header` drops `actions` inside a `"dialog"`. */
+    host?: DrillDownHost;
     /** Active screen, or `undefined` when the stack is closed. */
     index?: number;
     setIndex?: (index: number | undefined) => void;
@@ -8,8 +12,9 @@ export type DrillDownContextProps = {
     /** Occupancy counts by index; a missing slot means `next()` should close. */
     registeredIndices?: number[];
     setRegisteredIndices?: Dispatch<SetStateAction<number[] | undefined>>;
-    onClose?: (() => void)[];
-    setOnClose?: (fn: () => void, index: number) => void;
+    onClose?: ((() => void) | undefined)[];
+    /** Registers a screen's Close handler; `undefined` clears that index. */
+    setOnClose?: (fn: (() => void) | undefined, index: number) => void;
     /** When `false`, no screen mounts (host is closing or unopened). */
     hostIsInteractive?: boolean;
     setHostTrigger?: (element: HTMLElement | null) => void;

package/dist/src/components/DrillDown/internal/useDrillDownContextState.d.ts

@@ -1,19 +1,22 @@
+import { DrillDownHost } from './DrillDownContext';
 type useDrillDownContextStateParams = {
     /**
      * Screen opened by the first `next()` from a closed stack, and restored when
      * the host closes after a drilldown session. Defaults to `0`.
      */
     defaultDrillDownIndex?: number;
+    host: DrillDownHost;
 };
-export declare function useDrillDownContextState({ defaultDrillDownIndex, }: useDrillDownContextStateParams): {
+export declare function useDrillDownContextState({ defaultDrillDownIndex, host, }: useDrillDownContextStateParams): {
+    host: DrillDownHost;
     index: number | undefined;
     setIndex: (index: number | undefined) => void;
     back: () => void;
     next: () => void;
     registeredIndices: number[] | undefined;
     setRegisteredIndices: import('react').Dispatch<import('react').SetStateAction<number[] | undefined>>;
-    onClose: (() => void)[];
-    setOnClose: (fn: () => void, index: number) => void;
+    onClose: ((() => void) | undefined)[];
+    setOnClose: (fn: (() => void) | undefined, index: number) => void;
     hostIsInteractive: boolean;
     setHostTrigger: (element: HTMLElement | null) => void;
     onHostClose: () => void;

package/dist/src/components/MultiSelectField/internal/MultiSelectFieldComboboxMode.d.ts

@@ -1,3 +1,3 @@
 import { MultiSelectFieldComboboxInternalProps } from './types';
 /** Searchable combobox rendering mode. */
-export declare const MultiSelectFieldComboboxMode: <TID extends string | number>({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, selectAll, selectFiltered, bulkPending, onBulkActivate, singleRow, maxChips, getChipProps, onSearchChange, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, dataAttributes, }: MultiSelectFieldComboboxInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;
+export declare const MultiSelectFieldComboboxMode: <TID extends string | number>({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, inputWrapperRef, debounceMs, selectAll, selectFiltered, bulkPending, onBulkActivate, singleRow, maxChips, getChipProps, onSearchChange, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, dataAttributes, }: MultiSelectFieldComboboxInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/MultiSelectField/internal/MultiSelectFieldSelectMode.d.ts

@@ -1,3 +1,3 @@
 import { MultiSelectFieldBaseInternalProps } from './types';
 /** Listbox rendering mode used when `disableSearch` is true. */
-export declare const MultiSelectFieldSelectMode: <TID extends string | number>({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, selectAll, bulkPending, onBulkActivate, singleRow, maxChips, getChipProps, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, dataAttributes, }: MultiSelectFieldBaseInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;
+export declare const MultiSelectFieldSelectMode: <TID extends string | number>({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, inputWrapperRef, selectAll, bulkPending, onBulkActivate, singleRow, maxChips, getChipProps, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, dataAttributes, }: MultiSelectFieldBaseInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/MultiSelectField/internal/types.d.ts

@@ -46,7 +46,6 @@ export type MultiSelectFieldBaseInternalProps<TID extends string | number> = {
     loadMore: (searchValue: string) => Promise<void>;
     initialLoad: "immediate" | "open";
     initialLoadPerformed: boolean;
-    setInitialLoadPerformed: (val: boolean) => void;
     inputWrapperRef: RefObject<HTMLDivElement>;
     selectAll?: {
         label: string;

package/dist/src/components/Page/Page.d.ts

@@ -13,6 +13,7 @@ export declare const Page: import('react').ForwardRefExoticComponent<Omit<import
         localStorageKey?: string;
         "data-tracking-id"?: string;
         currentPageTitle?: string;
+        onOpenChange?: (open: boolean) => void;
     } & import('react').RefAttributes<HTMLDivElement>>;
     /** Sidebar heading region hidden from accessibility when collapsed. */
     SidebarHeader: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Page/PageSidebar.d.ts

@@ -9,6 +9,12 @@ export type PageSidebarProps = ComponentPropsWithoutRef<"div"> & {
     ["data-tracking-id"]?: string;
     /** Smaller-page trigger text. Defaults to `"Menu"`. */
     currentPageTitle?: string;
+    /**
+     * Called when the desktop sidebar collapses or expands; `open` is `true` when
+     * expanded. Not called on mount. The small-page popover layout does not report
+     * changes.
+     */
+    onOpenChange?: (open: boolean) => void;
 };
 /**
  * Collapsible desktop sidebar with persisted state. On smaller pages it
@@ -21,4 +27,10 @@ export declare const PageSidebar: import('react').ForwardRefExoticComponent<Omit
     "data-tracking-id"?: string;
     /** Smaller-page trigger text. Defaults to `"Menu"`. */
     currentPageTitle?: string;
+    /**
+     * Called when the desktop sidebar collapses or expands; `open` is `true` when
+     * expanded. Not called on mount. The small-page popover layout does not report
+     * changes.
+     */
+    onOpenChange?: (open: boolean) => void;
 } & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/SelectField/internal/SelectFieldComboboxMode.d.ts

@@ -1,3 +1,3 @@
 import { SelectFieldComboboxInternalProps } from '../../../internal/types/selectFieldInternalTypes';
 /** Combobox mode. Default when `disableSearch` is false. */
-export declare const SelectFieldComboboxMode: <TID extends string | number>({ id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, labelAiMark, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, addItemLabel, onAddNewItem, dataAttributes, }: SelectFieldComboboxInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectFieldComboboxMode: <TID extends string | number>({ id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, labelAiMark, readOnly, isHighlighted, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, inputWrapperRef, debounceMs, addItemLabel, onAddNewItem, dataAttributes, }: SelectFieldComboboxInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/SelectField/internal/SelectFieldSelectMode.d.ts

@@ -1,3 +1,3 @@
 import { SelectFieldBaseInternalProps } from '../../../internal/types/selectFieldInternalTypes';
 /** Listbox mode. Active when `disableSearch` is true. */
-export declare const SelectFieldSelectMode: <TID extends string | number = string | number>({ labelAiMark, id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, required, addItemLabel, onAddNewItem, dataAttributes, }: SelectFieldBaseInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectFieldSelectMode: <TID extends string | number = string | number>({ labelAiMark, id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, inputWrapperRef, required, addItemLabel, onAddNewItem, dataAttributes, }: SelectFieldBaseInternalProps<TID>) => import("react/jsx-runtime").JSX.Element;

package/dist/src/hooks/usePrefersReducedMotion/index.d.ts

@@ -1 +1,3 @@
+export { prefersReducedMotion } from './prefersReducedMotion';
 export * from './usePrefersReducedMotion';
+export * from './useReducedMotion';

package/dist/src/hooks/usePrefersReducedMotion/prefersReducedMotion.d.ts

@@ -0,0 +1,6 @@
+export declare const PREFERS_REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+/**
+ * One-shot read of the OS reduced-motion setting for non-React code.
+ * Returns `false` when `matchMedia` is unavailable.
+ */
+export declare const prefersReducedMotion: () => boolean;

package/dist/src/hooks/usePrefersReducedMotion/useReducedMotion.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Motion's reduced-motion hook. `true` or `false` after hydration, `null` during SSR.
+ * Prefer {@link usePrefersReducedMotion} when you want a boolean object that starts `false`.
+ */
+export { useReducedMotion } from 'motion/react';

package/dist/src/internal/components/InlineMarkdown/InlineMarkdown.d.ts

@@ -1,6 +1,13 @@
+import { InlineMarkdownFormat } from '../../utils/inlineMarkdownRegex';
+export type { InlineMarkdownFormat };
 export interface InlineMarkdownProps {
     /** Markdown source. Defaults to `""`. */
     value?: string;
+    /**
+     * The formats to render. Markers for any other format stay literal text.
+     * Defaults to all of them.
+     */
+    allowedFormats?: readonly InlineMarkdownFormat[];
 }
 /** Turns limited inline markdown into React nodes. */
-export declare const InlineMarkdown: ({ value }: InlineMarkdownProps) => import("react/jsx-runtime").JSX.Element;
+export declare const InlineMarkdown: ({ value, allowedFormats, }: InlineMarkdownProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/internal/components/InlineMarkdown/index.d.ts

@@ -1 +1 @@
-export { InlineMarkdown, type InlineMarkdownProps } from './InlineMarkdown';
+export { InlineMarkdown, type InlineMarkdownFormat, type InlineMarkdownProps, } from './InlineMarkdown';