@servicetitan/anvil2 3.17.0 → 3.18.0

package/dist/src/beta/components/Table/DataTable/internal/DataTablePagination.d.ts

@@ -1,5 +1,5 @@
 import { PaginationProps } from '../../../../../components/Pagination';
-type DataTableCursorPaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions"> & {
+type DataTableCursorPaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions" | "itemsPerPageLabel"> & {
     /** Explicit `true` enables Next. Omitted or false leaves it disabled. */
     hasNextPage?: boolean;
     /**
@@ -12,7 +12,7 @@ type DataTableCursorPaginationProps = Pick<PaginationProps, "page" | "itemsPerPa
  * Numbered pagination fields picked from {@link PaginationProps}, including
  * `totalItemCount`.
  */
-export type DataTablePaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "totalItemCount" | "showCount" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions">;
+export type DataTablePaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "totalItemCount" | "showCount" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions" | "itemsPerPageLabel" | "itemRangeFormatter">;
 /**
  * Numbered page chrome for DataTable. `showCount` defaults to `true`.
  */
@@ -21,5 +21,5 @@ export declare const DataTablePagination: ({ showCount, ...props }: DataTablePag
  * Prev/next chrome when the table has no `totalItemCount`. Next/Previous stay
  * disabled unless the matching flag is exactly `true`.
  */
-export declare const DataTableCursorPagination: ({ page, itemsPerPage, itemsPerPageOptions, hasNextPage, hasPrevPage, onPageChange, onItemsPerPageChange, }: DataTableCursorPaginationProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DataTableCursorPagination: ({ page, itemsPerPage, itemsPerPageOptions, itemsPerPageLabel, hasNextPage, hasPrevPage, onPageChange, onItemsPerPageChange, }: DataTableCursorPaginationProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/beta/components/Table/DataTable/internal/context/tabbables/CellTabbablesQueue.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Collects the first tabindex sweep of every cell that mounts in a commit, so
+ * the table body runs them together after the commit's layout effects. A
+ * write between two layout effects makes the next layout read in that commit
+ * (cell content measuring itself, say) force a style recalculation, so
+ * interleaved sweeps cost one recalculation per row instead of one per commit.
+ */
+export type CellTabbablesQueue = {
+    /**
+     * Queues a sweep for the next flush, or for a microtask if no flush comes
+     * first. Every body cell mounts in a render of its body, so the microtask is
+     * a safety net.
+     */
+    enqueue: (sweep: () => void) => void;
+    /** Drops a queued sweep, for a cell that unmounts before it ran. */
+    cancel: (sweep: () => void) => void;
+    /** Runs every queued sweep now. */
+    flush: () => void;
+};
+/** Creates an empty queue for one table body. */
+export declare function createCellTabbablesQueue(): CellTabbablesQueue;
+/** The enclosing table body's queue. Outside one, sweeps run on a microtask. */
+export declare const CellTabbablesQueueContext: import('react').Context<CellTabbablesQueue>;

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

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { PaginationProps } from '../../../../components/Pagination';
 import { TableRow } from '../types';
 import { DataAttributes, Svg } from '../../../../types';
 import { ButtonProps } from '../../../../components/Button';
@@ -99,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> & {
     /**
@@ -114,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;
 };
@@ -132,6 +142,7 @@ export type DataTableCursorPaginationConfig<T> = DataTablePaginationBaseConfig<T
     hasPrevPage: boolean;
     showCount?: never;
     totalRowCount?: never;
+    itemRangeFormatter?: never;
 };
 /**
  * Offset (numbered, known total) or cursor (prev/next, unknown total).

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/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/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';

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

@@ -40,10 +40,19 @@ type PopoverPropsBase = {
     fixedWidth?: boolean;
     /** Fills the remaining viewport height on the resolved side. Defaults to `false`. */
     fillAvailableHeight?: boolean;
-    /** With `fitScreen`, becomes the content height while available space becomes its cap. */
+    /**
+     * Caps the content height. With `fitScreen`, this is the content height and
+     * available space is the cap. With `sizeAfterPlacement`, a number is also the
+     * height measured while choosing top or bottom.
+     */
     maxHeight?: number | string;
     /** Constrains content to the available viewport height. Defaults to `false`. */
     fitScreen?: boolean;
+    /**
+     * Chooses top or bottom before applying height limits. A short side cannot
+     * shrink the content before the opposite side is tried. Defaults to `false`.
+     */
+    sizeAfterPlacement?: boolean;
     /** Minimum used when a constrained-height mode is active. Defaults to the component minimum. */
     minHeight?: number | string;
 } & DisableCloseOnEscapeOrClickProps & OpenCloseTransitionStateEffects;
@@ -107,10 +116,6 @@ export type PopoverNonDialogRoleProps = (PopoverPropsBase & NonDialogRoleProps &
  * @extends OpenCloseTransitionStateEffects
  */
 export type PopoverProps = PopoverDialogRoleProps | PopoverNonDialogRoleProps;
-/**
- * Positions top-layer content relative to a trigger. Dialog popovers manage
- * focus; listbox, tree, and grid popovers defer focus to their inner widget.
- */
 export declare const Popover: import('react').ForwardRefExoticComponent<PopoverProps & import('react').RefAttributes<unknown>> & {
     /**
      * Render-prop trigger for wiring a custom element to the popover.

package/dist/src/internal/components/Popover/internal/verticalPlacement.d.ts

@@ -0,0 +1,9 @@
+import { Middleware, Placement } from '@floating-ui/react';
+type SizeAfterPlacementOptions = {
+    fallbackPlacements?: Placement[];
+    maxHeight?: number | string;
+    matchReferenceWidth?: boolean;
+    fixedWidth?: boolean;
+};
+export declare function sizeAfterPlacementMiddleware(options: SizeAfterPlacementOptions): Middleware[];
+export {};

package/dist/src/internal/contexts/DisableConditionalUnmountWarningContext.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal context to disable the conditional unmount warning for legitimate
+ * viewport-based component swaps (e.g., Page.Panel switching between desktop
+ * panel and mobile Dialog on resize).
+ */
+export declare const DisableConditionalUnmountWarningContext: import('react').Context<boolean>;

package/dist/src/internal/contexts/SuppressPanelSwapWarningContext.d.ts

@@ -0,0 +1,13 @@
+import { MutableRefObject } from 'react';
+/**
+ * Internal context for a mutable ref that suppresses the conditional unmount
+ * warning during a Page.Panel viewport-branch swap (mobile ↔ desktop). When
+ * Page.Panel swaps branches, it sets this ref to true before the old branch's
+ * cleanups run, and clears it after the hook's microtask. Consumer Dialogs
+ * and Drawers that remount with open=true during the swap do not warn.
+ *
+ * This is internal and not exported to consumers.
+ *
+ * @internal
+ */
+export declare const SuppressPanelSwapWarningContext: import('react').Context<MutableRefObject<boolean> | undefined>;

package/dist/src/internal/functions/inlineMarkdown.d.ts

@@ -1,7 +1,10 @@
 import { ReactNode } from 'react';
+import { InlineMarkdownFormat } from '../utils/inlineMarkdownRegex';
 /**
  * Turns limited inline markdown into React nodes (`***` / `**` / `*` / `==` / `` ` ``).
  * The shared global regex needs `lastIndex` reset per call and saved around
- * nested parses. Code spans are not reparsed.
+ * nested parses. Code spans are not reparsed. Markers for formats outside
+ * `allowedFormats` stay literal text, though the formats nested inside them
+ * still render.
  */
-export declare const parseInlineMarkdown: (text: string) => ReactNode[];
+export declare const parseInlineMarkdown: (text: string, allowedFormats?: readonly InlineMarkdownFormat[]) => ReactNode[];

package/dist/src/internal/functions/stripInlineMarkdown.d.ts

@@ -1,6 +1,8 @@
+import { InlineMarkdownFormat } from '../utils/inlineMarkdownRegex';
 /**
  * Drops inline markdown markers and returns the inner text (for `aria-label`).
  * Shared global regex: reset `lastIndex` per call and save it around nested
- * strips. Code spans are not reparsed.
+ * strips. Code spans are not reparsed. Markers for formats outside
+ * `allowedFormats` are kept, as they render literally.
  */
-export declare const stripInlineMarkdown: (str: string) => string;
+export declare const stripInlineMarkdown: (str: string, allowedFormats?: readonly InlineMarkdownFormat[]) => string;

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

@@ -19,3 +19,4 @@ export * from './useSelectFieldLoading';
 export * from './useDownshiftEnvironment';
 export * from './useConfirmationDraft';
 export * from './useBulkActionRunner';
+export * from './useWarnOnConditionalUnmount';

package/dist/src/internal/hooks/useSelectFieldLoading/useSelectFieldLoading.d.ts

@@ -27,7 +27,13 @@ type UseSelectFieldLoadingConfigEager<TID extends string | number> = Pick<Select
  * Discriminated by `lazy`: omitted/`false` is eager; `"page"` needs `pageSize`;
  * `"offset"` needs `limit`; `"group"` pages by option `group`.
  */
-export type UseSelectFieldLoadingConfig<TID extends string | number> = UseSelectFieldLoadingConfigLazyPage<TID> | UseSelectFieldLoadingConfigLazyOffset<TID> | UseSelectFieldLoadingConfigLazyGroup<TID> | UseSelectFieldLoadingConfigEager<TID>;
+export type UseSelectFieldLoadingConfig<TID extends string | number> = (UseSelectFieldLoadingConfigLazyPage<TID> | UseSelectFieldLoadingConfigLazyOffset<TID> | UseSelectFieldLoadingConfigLazyGroup<TID> | UseSelectFieldLoadingConfigEager<TID>) & {
+    /**
+     * Called in the same step an initial load's result (or a cache restore) is
+     * applied, so a superseded load never reports one.
+     */
+    onInitialApplied?: () => void;
+};
 export type UseSelectFieldLoadingReturn<TID extends string | number> = {
     /** Replaced on `{ initial: true }`; appended on load-more. Empty until the first load. */
     options: SelectFieldOption<TID>[];
@@ -50,6 +56,8 @@ export type UseSelectFieldLoadingReturn<TID extends string | number> = {
     reset: () => void;
     /** Drops cached searches. In-memory options stay. */
     clearCache: () => void;
+    /** Supersedes every pending request and ends their busy flags. Options stay. */
+    discardPending: () => void;
 };
 /**
  * Loads SelectField options for eager or lazy (`page` / `offset` / `group`)

package/dist/src/internal/hooks/useSelectOrchestration.d.ts

@@ -27,7 +27,6 @@ export declare function useSelectOrchestration<TID extends string | number>(conf
     displayAs: "dialog" | "popover";
     initialLoad: "open" | "immediate";
     initialLoadPerformed: boolean;
-    setInitialLoadPerformed: import('react').Dispatch<import('react').SetStateAction<boolean>>;
     options: import('../..').SelectFieldOption<TID>[];
     loading: boolean;
     loadingMore: boolean;

package/dist/src/internal/hooks/useWarnOnConditionalUnmount/index.d.ts

@@ -0,0 +1 @@
+export * from './useWarnOnConditionalUnmount';

package/dist/src/internal/hooks/useWarnOnConditionalUnmount/useWarnOnConditionalUnmount.d.ts

@@ -0,0 +1 @@
+export declare function useWarnOnConditionalUnmount(open: boolean, message: string): void;

package/dist/src/internal/testing/keepMutationObserversAlive.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Keeps every `MutationObserver` that the current test creates alive, then
+ * restores `WeakRef` when the test finishes. happy-dom holds an observer's
+ * reporter only through a `WeakRef`, so a garbage collection between
+ * `observe()` and a mutation silently stops the observer. A test that waits
+ * for it then fails at random. Browsers keep an observer alive for as long as
+ * it observes a live node.
+ */
+export declare function keepMutationObserversAlive(): void;

package/dist/src/internal/types/selectFieldInternalTypes.d.ts

@@ -60,7 +60,6 @@ export type SelectFieldBaseInternalProps<TID extends string | number> = {
     loadMore: (searchValue: string) => Promise<void>;
     initialLoad: "immediate" | "open";
     initialLoadPerformed: boolean;
-    setInitialLoadPerformed: (val: boolean) => void;
     inputWrapperRef: RefObject<HTMLDivElement>;
     confirmation?: ResolvedConfirmation;
     /** Consumer-supplied `data-*` attributes forwarded to the field wrapper. */

package/dist/src/internal/utils/inlineMarkdownRegex.d.ts

@@ -1 +1,6 @@
 export declare const INLINE_MARKDOWN_REGEX: RegExp;
+export type InlineMarkdownFormat = "bold" | "italic" | "highlight" | "code";
+/** Marker text for each capture group of `INLINE_MARKDOWN_REGEX`, by group number. */
+export declare const INLINE_MARKDOWN_MARKERS: string[];
+/** Whether the match's capture group is a format the caller allows. */
+export declare const isGroupAllowed: (group: number, allowedFormats?: readonly InlineMarkdownFormat[]) => boolean;

package/dist/stripInlineMarkdown-BV12XXzl.js

@@ -0,0 +1,35 @@
+import { I as INLINE_MARKDOWN_REGEX, i as isGroupAllowed, a as INLINE_MARKDOWN_MARKERS } from './InlineMarkdown-CL1tKR01.js';
+
+const stripInlineMarkdown = (str, allowedFormats) => {
+  const parts = [];
+  let lastIndex = 0;
+  INLINE_MARKDOWN_REGEX.lastIndex = 0;
+  let match;
+  while ((match = INLINE_MARKDOWN_REGEX.exec(str)) !== null) {
+    if (match.index > lastIndex) {
+      parts.push(str.substring(lastIndex, match.index));
+    }
+    const savedIndex = INLINE_MARKDOWN_REGEX.lastIndex;
+    const group = match.findIndex((value, i) => i > 0 && value !== void 0);
+    const inner = match[group];
+    if (!isGroupAllowed(group, allowedFormats)) {
+      const marker = INLINE_MARKDOWN_MARKERS[group];
+      parts.push(
+        group === 5 ? match[0] : `${marker}${stripInlineMarkdown(inner, allowedFormats)}${marker}`
+      );
+    } else {
+      parts.push(
+        group === 5 ? inner : stripInlineMarkdown(inner, allowedFormats)
+      );
+    }
+    INLINE_MARKDOWN_REGEX.lastIndex = savedIndex;
+    lastIndex = savedIndex;
+  }
+  if (lastIndex < str.length) {
+    parts.push(str.substring(lastIndex));
+  }
+  return parts.join("");
+};
+
+export { stripInlineMarkdown as s };
+//# sourceMappingURL=stripInlineMarkdown-BV12XXzl.js.map

package/dist/stripInlineMarkdown-BV12XXzl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripInlineMarkdown-BV12XXzl.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import {\n  INLINE_MARKDOWN_MARKERS,\n  INLINE_MARKDOWN_REGEX,\n  isGroupAllowed,\n  type InlineMarkdownFormat,\n} from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Drops inline markdown markers and returns the inner text (for `aria-label`).\n * Shared global regex: reset `lastIndex` per call and save it around nested\n * strips. Code spans are not reparsed. Markers for formats outside\n * `allowedFormats` are kept, as they render literally.\n */\nexport const stripInlineMarkdown = (\n  str: string,\n  allowedFormats?: readonly InlineMarkdownFormat[],\n): string => {\n  const parts: string[] = [];\n  let lastIndex = 0;\n\n  INLINE_MARKDOWN_REGEX.lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = INLINE_MARKDOWN_REGEX.exec(str)) !== null) {\n    if (match.index > lastIndex) {\n      parts.push(str.substring(lastIndex, match.index));\n    }\n\n    const savedIndex = INLINE_MARKDOWN_REGEX.lastIndex;\n    const group = match.findIndex((value, i) => i > 0 && value !== undefined);\n    const inner = match[group];\n\n    if (!isGroupAllowed(group, allowedFormats)) {\n      const marker = INLINE_MARKDOWN_MARKERS[group];\n      parts.push(\n        group === 5\n          ? match[0]\n          : `${marker}${stripInlineMarkdown(inner, allowedFormats)}${marker}`,\n      );\n    } else {\n      parts.push(\n        group === 5 ? inner : stripInlineMarkdown(inner, allowedFormats),\n      );\n    }\n\n    INLINE_MARKDOWN_REGEX.lastIndex = savedIndex;\n    lastIndex = savedIndex;\n  }\n\n  if (lastIndex < str.length) {\n    parts.push(str.substring(lastIndex));\n  }\n\n  return parts.join(\"\");\n};\n"],"names":[],"mappings":";;AAaO,MAAM,mBAAA,GAAsB,CACjC,GAAA,EACA,cAAA,KACW;AACX,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,qBAAA,CAAsB,SAAA,GAAY,CAAA;AAClC,EAAA,IAAI,KAAA;AAEJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,qBAAA,CAAsB,IAAA,CAAK,GAAG,OAAO,IAAA,EAAM;AACzD,IAAA,IAAI,KAAA,CAAM,QAAQ,SAAA,EAAW;AAC3B,MAAA,KAAA,CAAM,KAAK,GAAA,CAAI,SAAA,CAAU,SAAA,EAAW,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,IAClD;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,SAAA;AACzC,IAAA,MAAM,KAAA,GAAQ,MAAM,SAAA,CAAU,CAAC,OAAO,CAAA,KAAM,CAAA,GAAI,CAAA,IAAK,KAAA,KAAU,MAAS,CAAA;AACxE,IAAA,MAAM,KAAA,GAAQ,MAAM,KAAK,CAAA;AAEzB,IAAA,IAAI,CAAC,cAAA,CAAe,KAAA,EAAO,cAAc,CAAA,EAAG;AAC1C,MAAA,MAAM,MAAA,GAAS,wBAAwB,KAAK,CAAA;AAC5C,MAAA,KAAA,CAAM,IAAA;AAAA,QACJ,KAAA,KAAU,CAAA,GACN,KAAA,CAAM,CAAC,CAAA,GACP,CAAA,EAAG,MAAM,CAAA,EAAG,mBAAA,CAAoB,KAAA,EAAO,cAAc,CAAC,GAAG,MAAM,CAAA;AAAA,OACrE;AAAA,IACF,CAAA,MAAO;AACL,MAAA,KAAA,CAAM,IAAA;AAAA,QACJ,KAAA,KAAU,CAAA,GAAI,KAAA,GAAQ,mBAAA,CAAoB,OAAO,cAAc;AAAA,OACjE;AAAA,IACF;AAEA,IAAA,qBAAA,CAAsB,SAAA,GAAY,UAAA;AAClC,IAAA,SAAA,GAAY,UAAA;AAAA,EACd;AAEA,EAAA,IAAI,SAAA,GAAY,IAAI,MAAA,EAAQ;AAC1B,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,SAAA,CAAU,SAAS,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,EAAE,CAAA;AACtB;;;;"}