@servicetitan/anvil2 3.0.7 → 3.0.8

package/dist/src/beta/components/TreeSelectField/internal/useTreeLoader.d.ts

@@ -0,0 +1,58 @@
+import { TreeSelectFieldNode } from '../types';
+/**
+ * Options for the useTreeLoader hook.
+ * @property loadOptions - Async function to load tree nodes. Called with searchValue and optional parentNode.
+ * @property cache - Cache configuration. Enabled by default with maxSize of 15.
+ * @property initialLoad - Controls when the initial load occurs. "auto" and "immediate" load on mount, "open" loads on first onOpen() call.
+ * @property debounceMs - Debounce delay in milliseconds for search calls. Defaults to 200.
+ */
+export type UseTreeLoaderOptions = {
+    loadOptions: (searchValue: string, parentNode?: TreeSelectFieldNode) => TreeSelectFieldNode[] | Promise<TreeSelectFieldNode[]>;
+    cache?: {
+        enabled?: boolean;
+        maxSize?: number;
+    };
+    initialLoad?: "auto" | "immediate" | "open";
+    debounceMs?: number;
+};
+/**
+ * Return value from the useTreeLoader hook.
+ * @property nodes - The currently loaded tree nodes.
+ * @property ancestry - Durable childId → parentId map accumulated from lazy
+ *   children loads; survives tree resets so off-screen selections can be
+ *   attributed to their ancestors.
+ * @property isLoading - Whether a root/search load is in progress.
+ * @property isLoadingChildren - Set of node IDs whose children are currently loading.
+ * @property loadChildren - Loads children for the given branch node (lazy expansion).
+ * @property search - Triggers a search load with the given search value (debounced).
+ * @property clearCache - Clears both the search and children caches.
+ * @property invalidate - Clears both caches and triggers a fresh load.
+ * @property onOpen - Triggers the initial load when initialLoad="open". No-op otherwise or after first open.
+ */
+export type UseTreeLoaderReturn = {
+    nodes: TreeSelectFieldNode[];
+    ancestry: Map<string | number, string | number>;
+    isLoading: boolean;
+    isLoadingChildren: Set<string | number>;
+    loadChildren: (parentNode: TreeSelectFieldNode) => Promise<TreeSelectFieldNode[]>;
+    search: (searchValue: string) => void;
+    clearCache: () => void;
+    invalidate: () => void;
+    onOpen: () => void;
+};
+/**
+ * Hook that manages async loading and caching for tree data.
+ *
+ * Features:
+ * - Handles root/search loading and lazy branch expansion via a single loadOptions callback
+ * - Two separate LRU caches: one for search results, one for lazy-loaded children
+ * - Configurable cache size and opt-out support
+ * - Debounced search to reduce unnecessary loadOptions calls
+ * - initialLoad modes: "immediate"/"auto" load on mount, "open" defers until onOpen() is called
+ * - Children are merged into the node tree after loading, updating children: null to the loaded array
+ * - invalidate() clears caches and triggers a fresh load of the current view
+ *
+ * @param options - Configuration options for the tree loader.
+ * @returns Current nodes, loading states, and loader control functions.
+ */
+export declare function useTreeLoader(options: UseTreeLoaderOptions): UseTreeLoaderReturn;

package/dist/src/beta/components/TreeSelectField/stories/TreeSelectField.stories.data.d.ts

@@ -0,0 +1,21 @@
+import { TreeSelectFieldNode } from '../types';
+/**
+ * Realistic multi-level org chart for stories and tests.
+ * 4 levels deep: Company divisions > Departments > Teams > Individuals
+ */
+export declare const orgChart: TreeSelectFieldNode[];
+/**
+ * Async version: root nodes with children: null (lazy-loaded).
+ */
+export declare const asyncOrgChartRoots: TreeSelectFieldNode[];
+/**
+ * Simulates an async loadOptions for stories.
+ * Supports search filtering on roots and lazy child loading.
+ */
+export declare function simulatedLoadOptions(searchValue: string, parentNode?: TreeSelectFieldNode): Promise<TreeSelectFieldNode[]>;
+/**
+ * Simulates multi-level lazy loading. Each expansion returns immediate
+ * children with branches having children: null (requiring another load).
+ * Every level shows a spinner while loading.
+ */
+export declare function multiLevelLoadOptions(searchValue: string, parentNode?: TreeSelectFieldNode): Promise<TreeSelectFieldNode[]>;

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

@@ -0,0 +1,124 @@
+import { CSSProperties, ReactElement, ReactNode } from 'react';
+import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../../types';
+import { OptionContent } from '../../../internal/types/optionContent';
+/**
+ * Rich content configuration for a TreeSelectField option row.
+ * Controls the avatar, icon, description, and chip display within an option.
+ */
+export type TreeSelectFieldOptionContent = OptionContent;
+/**
+ * A node in the tree structure.
+ * @property id - Unique identifier for the node.
+ * @property label - Display text for the node.
+ * @property searchText - Additional text to match during search, beyond label.
+ * @property disabled - Whether the node is disabled for selection.
+ * @property extra - Pass-through data for consumer convenience.
+ * @property children - Child nodes. undefined=leaf, []=empty branch, [...]=branch, null=unloaded (lazy).
+ * @property childCount - Server-provided count, optionally displayed on branch nodes.
+ * @property path - Optional ancestor ids, root→parent. Selection-ancestry
+ *   metadata, primarily meaningful on value objects: when a selected node lives
+ *   under branches that aren't currently loaded, `path` lets the field show the
+ *   correct ancestor check states without a parent-of lookup. The field emits
+ *   it on selections whose ancestry it knows, and reads it from incoming value
+ *   so a persisted-then-restored selection resolves exactly. Not a structural
+ *   tree attribute — omit it on `loadOptions` results.
+ */
+export type TreeSelectFieldNode = {
+    id: string | number;
+    label: string;
+    searchText?: string;
+    disabled?: boolean;
+    extra?: Record<string, unknown>;
+    content?: TreeSelectFieldOptionContent;
+    children?: TreeSelectFieldNode[] | null;
+    childCount?: number;
+    path?: (string | number)[];
+};
+/**
+ * The value shape stored in the value array. Intentionally slim — just enough to render chips and identify the node.
+ * @property id - The node's unique identifier.
+ * @property label - The node's display text.
+ * @property extra - Pass-through data from the node.
+ * @property path - Optional ancestor ids, root→parent. See {@link TreeSelectFieldNode.path}.
+ */
+export type TreeSelectFieldValue = Pick<TreeSelectFieldNode, "id" | "label" | "extra" | "path">;
+/**
+ * Controls which nodes are selectable and how the value array is shaped.
+ * - "ALL" — any node selectable, all checked nodes in value
+ * - "BRANCH_PRIORITY" — any node selectable, branches replace leaves when fully checked
+ * - "BRANCH_ONLY" — only branches selectable, leaves visible but inert
+ * - "LEAF_PRIORITY" — only leaves selectable (branches expand), leaves + childless branches in value
+ * - "LEAF_ONLY" — only leaves selectable (branches expand), strictly leaves in value
+ */
+export type TreeSelectFieldValueConsistsOf = "ALL" | "BRANCH_PRIORITY" | "BRANCH_ONLY" | "LEAF_PRIORITY" | "LEAF_ONLY";
+/**
+ * Imperative handle for the TreeSelectField component.
+ * @property clearCache - Clears the options cache.
+ * @property invalidate - Clears the cache and triggers a fresh options load.
+ * @property expandAll - Expands all tree nodes.
+ * @property collapseAll - Collapses all tree nodes.
+ */
+export type TreeSelectFieldHandle = {
+    clearCache: () => void;
+    invalidate: () => void;
+    expandAll: () => void;
+    collapseAll: () => void;
+};
+/**
+ * Props for the TreeSelectField component.
+ * @property label - Required label for accessibility.
+ * @property value - Controlled value array. Always an array, even in single-select mode.
+ * @property onSelectedOptionsChange - Callback when selection changes.
+ * @property loadOptions - Async function to load tree nodes. Called with parentNode for lazy branch loading.
+ * @property selectionMode - "single": one node at a time. "independent": no cascade. "linked" (default): parent-child cascade.
+ * @property valueConsistsOf - Controls which nodes are selectable and how the value is shaped.
+ * @property defaultExpandLevel - Initial expand depth. 0=collapsed, Infinity=all.
+ * @extends LayoutUtilProps
+ */
+export type TreeSelectFieldProps = {
+    id?: string;
+    label: string;
+    labelNode?: ReactNode;
+    hideLabel?: boolean;
+    placeholder?: string;
+    size?: Extract<Size, "small" | "medium" | "large">;
+    displayMenuAs?: "auto" | "popover" | "dialog";
+    error?: boolean | string | string[] | ReactElement;
+    hint?: ReactElement | string;
+    /** Additional information to display in a tooltip next to the label. */
+    moreInfo?: ReactNode;
+    /**
+     * AI mark configuration to display next to the label.
+     * Can be a boolean to show a simple AI mark, or an object with tooltip/popover configuration.
+     */
+    labelAiMark?: AiMarkWithTooltipOrPopoverProps["aiMark"];
+    description?: ReactElement | string;
+    warning?: string | string[];
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    prefix?: string | ReactElement;
+    suffix?: string | ReactElement;
+    className?: string;
+    style?: CSSProperties;
+    disableSearch?: boolean;
+    debounceMs?: number;
+    searchValue?: string;
+    onSearchChange?: (v: string) => void;
+    singleRow?: boolean;
+    maxChips?: number;
+    virtualize?: boolean;
+    value: TreeSelectFieldValue[];
+    onSelectedOptionsChange: (nodes: TreeSelectFieldValue[]) => void;
+    selectionMode?: "single" | "independent" | "linked";
+    valueConsistsOf?: TreeSelectFieldValueConsistsOf;
+    defaultExpandLevel?: number;
+    expandedIds?: Set<string | number>;
+    onExpandedIdsChange?: (ids: Set<string | number>) => void;
+    loadOptions: (searchValue: string, parentNode?: TreeSelectFieldNode) => TreeSelectFieldNode[] | Promise<TreeSelectFieldNode[]>;
+    cache?: {
+        enabled?: boolean;
+        maxSize?: number;
+    };
+    initialLoad?: "auto" | "immediate" | "open";
+} & LayoutUtilProps;

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

@@ -0,0 +1,29 @@
+import { TreeSelectMenuProps } from './types';
+/**
+ * TreeSelectMenu component for selecting tree nodes from a dropdown triggered by any element.
+ *
+ * Features:
+ * - Attaches to any trigger element via a render prop
+ * - Async tree data loading via loadOptions callback with optional LRU caching
+ * - Single-select and multi-select modes with linked/independent cascade
+ * - Cascading parent/child selection in linked mode
+ * - Search filtering across visible nodes
+ * - Lazy branch expansion with on-demand children loading
+ * - Virtualized rendering for large trees via the virtualize prop
+ * - Full keyboard navigation (ArrowDown/Up, ArrowRight/Left, Enter, Home/End, Escape)
+ * - Supports both popover and dialog display modes
+ * - Adaptive display based on device (mobile uses dialog)
+ * - Configurable popover width
+ * - Imperative handle for clearCache, invalidate, expandAll, collapseAll
+ * - Full accessibility support with ARIA tree attributes
+ *
+ * @example
+ * <TreeSelectMenu
+ *   trigger={(props) => <Button {...props}>Select Categories</Button>}
+ *   label="Categories"
+ *   value={selected}
+ *   onSelectedOptionsChange={setSelected}
+ *   loadOptions={async (search) => fetchCategories(search)}
+ * />
+ */
+export declare const TreeSelectMenu: import('react').ForwardRefExoticComponent<TreeSelectMenuProps & import('react').RefAttributes<import('..').TreeSelectFieldHandle>>;

package/dist/src/beta/components/TreeSelectMenu/TreeSelectMenuSync.d.ts

@@ -0,0 +1,65 @@
+import { MatchSorterOptions } from 'match-sorter';
+import { TreeSelectMenuNode, TreeSelectMenuProps } from './types';
+import { TreeSyncFilterFn } from '../TreeSelectField/internal/treeSync';
+export type { TreeSyncFilterFn };
+/**
+ * Props for the TreeSelectMenuSync component.
+ * @property options - The static tree options to display.
+ * @property filter - Custom filter function or MatchSorterOptions to control how nodes are filtered during search.
+ *   By default, filters by label and searchText using match-sorter, preserving parent nodes of any match.
+ * @extends TreeSelectMenuProps
+ */
+export type TreeSelectMenuSyncProps = Omit<TreeSelectMenuProps, "loadOptions" | "debounceMs" | "cache" | "initialLoad"> & {
+    /**
+     * The static tree options to display in the menu.
+     */
+    options: TreeSelectMenuNode[];
+    /**
+     * Controls how options are filtered when the user types a search value.
+     * Can be a function that returns nodes in the desired display order,
+     * or a MatchSorterOptions object to customize the default match-sorter behavior.
+     *
+     * By default, nodes are filtered by `label` and `searchText` using match-sorter,
+     * and parents of matching nodes are preserved in the tree structure.
+     *
+     * @example
+     * <TreeSelectMenuSync
+     *   options={options}
+     *   filter={(nodes, searchValue) => {
+     *     return nodes.filter((node) =>
+     *       node.label.toLowerCase().includes(searchValue.toLowerCase())
+     *     );
+     *   }}
+     * />
+     *
+     * @example
+     * <TreeSelectMenuSync
+     *   options={options}
+     *   filter={{ keys: ["label"] }}
+     * />
+     */
+    filter?: TreeSyncFilterFn | MatchSorterOptions<TreeSelectMenuNode>;
+};
+/**
+ * TreeSelectMenuSync is a simplified wrapper around TreeSelectMenu for static (non-async) tree data.
+ *
+ * Features:
+ * - Accepts static `options` instead of `loadOptions`.
+ * - Performs client-side filtering with tree-structure awareness (parents of matches are preserved).
+ * - Accepts a custom filter function or MatchSorterOptions to customize filtering behavior.
+ * - Invalidates the menu when the options reference changes.
+ * - Supports all other props of TreeSelectMenu.
+ *
+ * @example
+ * <TreeSelectMenuSync
+ *   trigger={(props) => <Button {...props}>Select location</Button>}
+ *   label="Select location"
+ *   options={locationTree}
+ *   value={selected}
+ *   onSelectedOptionsChange={setSelected}
+ * />
+ */
+export declare const TreeSelectMenuSync: {
+    (props: TreeSelectMenuSyncProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,4 @@
+export * from './TreeSelectMenu';
+export { TreeSelectMenuSync } from './TreeSelectMenuSync';
+export type { TreeSelectMenuSyncProps, TreeSyncFilterFn, } from './TreeSelectMenuSync';
+export * from './types';

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

@@ -0,0 +1,103 @@
+import { KeyboardEvent, ReactElement, RefObject } from 'react';
+import { ConfirmationProp } from '../../../internal/types/confirmationTypes';
+import { TreeSelectFieldNode as TreeSelectMenuNode, TreeSelectFieldValue as TreeSelectMenuValue, TreeSelectFieldValueConsistsOf as TreeSelectMenuValueConsistsOf, TreeSelectFieldHandle, TreeSelectFieldOptionContent as TreeSelectMenuOptionContent } from '../TreeSelectField/types';
+/**
+ * Configures a "Clear" button in the menu footer. Presence of this prop
+ * enables the button; omit to suppress.
+ *
+ * - `onClick` — called when the user clicks Clear.
+ * - `label` — button label (default "Clear").
+ * - `disabled` — whether the button is inert. Filter adapters typically tie
+ *   this to `!isActive(filter)` so the button is dim when nothing is selected.
+ */
+export type TreeSelectMenuClearConfig = {
+    onClick: () => void;
+    label?: string;
+    disabled?: boolean;
+};
+export type { TreeSelectMenuNode, TreeSelectMenuValue, TreeSelectMenuValueConsistsOf, TreeSelectMenuOptionContent, };
+/**
+ * Imperative handle for the TreeSelectMenu component.
+ * @property clearCache - Clears the options cache.
+ * @property invalidate - Clears the cache and triggers a fresh options load.
+ * @property expandAll - Expands all tree nodes.
+ * @property collapseAll - Collapses all tree nodes.
+ */
+export type TreeSelectMenuHandle = TreeSelectFieldHandle;
+/**
+ * Props provided to the trigger render function.
+ * @property ref - Ref to attach to the trigger element for positioning and focus restoration
+ * @property onClick - Click handler to toggle the menu
+ * @property onKeyDown - Key handler for keyboard navigation
+ * @property aria-haspopup - ARIA attribute indicating the trigger opens a tree
+ * @property aria-controls - ARIA attribute linking to the tree element
+ * @property aria-expanded - ARIA attribute indicating whether the menu is open
+ * @property data-state - Data attribute indicating the open/close state
+ */
+export type TreeSelectMenuTriggerProps = {
+    ref: RefObject<HTMLButtonElement>;
+    onClick: () => void;
+    onKeyDown: (e: KeyboardEvent<HTMLButtonElement>) => void;
+    "aria-haspopup": "tree";
+    "aria-controls": string;
+    "aria-expanded": boolean;
+    "data-state": "open" | "close";
+};
+/**
+ * Props for the TreeSelectMenu component.
+ * @property id - Optional id for the menu; an internal id is generated when omitted.
+ * @property trigger - Render function that receives trigger props and returns the element that opens the menu.
+ * @property onMenuKeyDown - Called for key events on the open menu, after internal navigation handling.
+ * @property onImplicitClose - Called when the menu closes implicitly (outside click, blur, Escape).
+ * @property onExplicitClose - Called when the menu closes from an explicit selection or trigger toggle.
+ * @property label - Accessible label for the menu. Used by screen readers but not rendered visually.
+ * @property searchPlaceholder - Placeholder text for the search input inside the menu.
+ * @property displayMenuAs - "auto" (default): popover on desktop, dialog on mobile; or force "popover"/"dialog".
+ * @property virtualize - When true, renders the tree with windowed virtualization for large datasets.
+ * @property disableSearch - Hides the search input and disables search filtering.
+ * @property popoverWidth - Width of the popover. Accepts a CSS width value or "reference" to match trigger width.
+ * @property debounceMs - Milliseconds to debounce search input before calling loadOptions. Defaults to 200.
+ * @property onSearchChange - Called when the search value changes. Pair with controlled search wiring.
+ * @property value - Controlled value array. Always an array, even in single-select mode.
+ * @property onSelectedOptionsChange - Callback when selection changes.
+ * @property selectionMode - "single": one node at a time. "independent": no cascade. "linked" (default): parent-child cascade.
+ * @property valueConsistsOf - Controls which nodes are selectable and how the value is shaped.
+ * @property defaultExpandLevel - Initial expand depth. 0=collapsed, Infinity=all.
+ * @property expandedIds - Controlled set of expanded branch node ids. Pair with onExpandedIdsChange.
+ * @property onExpandedIdsChange - Called when the expanded set changes (controlled expansion).
+ * @property loadOptions - Async function to load tree nodes. Called with parentNode for lazy branch loading.
+ * @property cache - LRU cache configuration for loadOptions results ({ enabled, maxSize }).
+ * @property initialLoad - When loadOptions first runs: "immediate" on mount, "open" when the menu opens, or "auto".
+ * @property confirmation - When set, selections are buffered as a draft inside the open menu and only commit on Apply; dismissing the menu discards the draft. Pass `true` for default Apply/Cancel labels, or an object to customize.
+ * @property clear - Configures a "Clear" button in the menu footer. Omit to suppress.
+ */
+export type TreeSelectMenuProps = {
+    id?: string;
+    trigger: (props: TreeSelectMenuTriggerProps) => ReactElement;
+    onMenuKeyDown?: (e: KeyboardEvent) => void;
+    onImplicitClose?: () => void;
+    onExplicitClose?: () => void;
+    label: string;
+    searchPlaceholder?: string;
+    displayMenuAs?: "auto" | "popover" | "dialog";
+    virtualize?: boolean;
+    disableSearch?: boolean;
+    popoverWidth?: "reference" | number | string;
+    debounceMs?: number;
+    onSearchChange?: (v: string) => void;
+    value: TreeSelectMenuValue[];
+    onSelectedOptionsChange: (nodes: TreeSelectMenuValue[]) => void;
+    selectionMode?: "single" | "independent" | "linked";
+    valueConsistsOf?: TreeSelectMenuValueConsistsOf;
+    defaultExpandLevel?: number;
+    expandedIds?: Set<string | number>;
+    onExpandedIdsChange?: (ids: Set<string | number>) => void;
+    loadOptions: (searchValue: string, parentNode?: TreeSelectMenuNode) => TreeSelectMenuNode[] | Promise<TreeSelectMenuNode[]>;
+    cache?: {
+        enabled?: boolean;
+        maxSize?: number;
+    };
+    initialLoad?: "auto" | "immediate" | "open";
+    confirmation?: ConfirmationProp;
+    clear?: TreeSelectMenuClearConfig;
+};

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

@@ -9,3 +9,5 @@ export * from './MultiSelectMenu';
 export * from './InteractiveCard';
 export * from './RichTextEditor';
 export * from './SavedFiltersButton';
+export * from './TreeSelectField';
+export * from './TreeSelectMenu';

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

@@ -44,6 +44,7 @@ export declare const Pagination: import('react').ForwardRefExoticComponent<Omit<
         startPage: number;
         endPage: number;
         length: number;
+        currentPage: number;
         onItemClick: (page: number) => void;
     } & import('react').RefAttributes<HTMLLIElement>>;
     ItemsPerPageMenu: import('react').ForwardRefExoticComponent<import('./PaginationItemsPerPageMenu').PaginationItemsPerPageMenuProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Pagination/internal/PaginationOverflowMenu.d.ts

@@ -16,6 +16,10 @@ export type PaginationOverflowMenuProps = ComponentPropsWithoutRef<"li"> & {
      * The number of pages in the overflow range.
      */
     length: number;
+    /**
+     * The current active page in the parent pagination.
+     */
+    currentPage: number;
     /**
      * Callback function called when a page in the overflow menu is selected.
      * @param page The selected page number
@@ -27,7 +31,9 @@ export type PaginationOverflowMenuProps = ComponentPropsWithoutRef<"li"> & {
  *
  * Features:
  * - Displays ellipsis menu for large page ranges
- * - Shows all pages in the overflow range as menu items
+ * - Renders the page items as a virtualized window — only the slice visible
+ *   in the scroller is in the DOM at any time, keeping pagination cheap
+ *   even when the overflow spans tens of thousands of pages
  * - Integrates with pagination navigation system
  * - Fully accessible with proper ARIA labels
  * - Consistent styling with design system
@@ -37,6 +43,7 @@ export type PaginationOverflowMenuProps = ComponentPropsWithoutRef<"li"> & {
  *   startPage={4}
  *   endPage={8}
  *   length={5}
+ *   currentPage={4}
  *   onItemClick={(page) => console.log('Page selected:', page)}
  * />
  */
@@ -53,6 +60,10 @@ export declare const PaginationOverflowMenu: import('react').ForwardRefExoticCom
      * The number of pages in the overflow range.
      */
     length: number;
+    /**
+     * The current active page in the parent pagination.
+     */
+    currentPage: number;
     /**
      * Callback function called when a page in the overflow menu is selected.
      * @param page The selected page number

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

@@ -0,0 +1,14 @@
+/**
+ * Class names that re-establish the Anvil2 styling scope on a container.
+ *
+ * Native `popover` / top-layer elements (toasts, popovers, tooltips, surfaces)
+ * are promoted to the top layer and live high in the DOM, escaping any ancestor
+ * `AnvilProvider`'s `.anvil2` scope. Without the scope, descendants resolve none
+ * of the `--a2-*` design tokens (defined on `.anvil2.theme-core`) and miss the
+ * scoped component rules, so they render unstyled.
+ *
+ * Spread/append these class names onto such containers so they self-scope and
+ * render correctly in any host context (including outside an `AnvilProvider`,
+ * e.g. when an Anvil2 component is used from a legacy host).
+ */
+export declare const portalScopeClassNames: string;

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

@@ -0,0 +1,10 @@
+/**
+ * Shallow set-equality of two value arrays by `id`, order-independent.
+ *
+ * Used as the `isEqual` comparator for `useConfirmationDraft` so that a draft
+ * is considered unchanged when it holds the same set of selected items as the
+ * committed value, regardless of order.
+ */
+export declare function arrayIdsEqual<T extends {
+    id: string | number;
+}>(a: T[], b: T[]): boolean;

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

@@ -1,3 +1,4 @@
+export * from './arrayIdsEqual';
 export * from './generateChromaticStickersheetProps';
 export * from './inlineMarkdownRegex';
 export * from './layerManager';

package/dist/{stripInlineMarkdown-C5DNxxwf.js → stripInlineMarkdown-C0bVmYgG.js}

@@ -1,4 +1,4 @@
-import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-D1qPAGtB.js';
+import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-VVn8GR64.js';
 
 const stripInlineMarkdown = (str) => {
   const parts = [];
@@ -22,4 +22,4 @@ const stripInlineMarkdown = (str) => {
 };
 
 export { stripInlineMarkdown as s };
-//# sourceMappingURL=stripInlineMarkdown-C5DNxxwf.js.map
+//# sourceMappingURL=stripInlineMarkdown-C0bVmYgG.js.map

package/dist/{stripInlineMarkdown-C5DNxxwf.js.map → stripInlineMarkdown-C0bVmYgG.js.map}

@@ -1 +1 @@
-{"version":3,"file":"stripInlineMarkdown-C5DNxxwf.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import { INLINE_MARKDOWN_REGEX } from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Strips inline markdown syntax from a string, returning plain text.\n * Intended for accessibility contexts (e.g. `aria-label`) where only plain text is appropriate.\n *\n * @param str - The string to strip\n * @returns The string with all inline markdown syntax removed\n */\nexport const stripInlineMarkdown = (str: string): 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 inner =\n      match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? \"\";\n\n    // code spans don't support nested markdown, matching parseInlineMarkdown behavior\n    parts.push(match[5] ? inner : stripInlineMarkdown(inner));\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":";;AASO,MAAM,mBAAA,GAAsB,CAAC,GAAA,KAAwB;AAC1D,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,GACJ,KAAA,CAAM,CAAC,CAAA,IAAK,MAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,KAAK,KAAA,CAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AAG9D,IAAA,KAAA,CAAM,KAAK,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,mBAAA,CAAoB,KAAK,CAAC,CAAA;AAExD,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;;;;"}
+{"version":3,"file":"stripInlineMarkdown-C0bVmYgG.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import { INLINE_MARKDOWN_REGEX } from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Strips inline markdown syntax from a string, returning plain text.\n * Intended for accessibility contexts (e.g. `aria-label`) where only plain text is appropriate.\n *\n * @param str - The string to strip\n * @returns The string with all inline markdown syntax removed\n */\nexport const stripInlineMarkdown = (str: string): 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 inner =\n      match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? \"\";\n\n    // code spans don't support nested markdown, matching parseInlineMarkdown behavior\n    parts.push(match[5] ? inner : stripInlineMarkdown(inner));\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":";;AASO,MAAM,mBAAA,GAAsB,CAAC,GAAA,KAAwB;AAC1D,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,GACJ,KAAA,CAAM,CAAC,CAAA,IAAK,MAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,KAAK,KAAA,CAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AAG9D,IAAA,KAAA,CAAM,KAAK,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,mBAAA,CAAoB,KAAK,CAAC,CAAA;AAExD,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;;;;"}