@servicetitan/anvil2 2.6.0 → 2.7.0

package/dist/internal/components/SelectOptions.d.ts

@@ -0,0 +1,23 @@
+import { SelectFieldOption } from '../../beta/components/SelectField/types';
+import { CSSProperties } from 'react';
+import { OptionsPanelHandle } from './OptionsPanel';
+import { GetItemPropsFn, GetMenuPropsFn, SectionMeta, SelectItem } from '../types/selectFieldInternalTypes';
+export type SelectOptionsProps = {
+    isOpen: boolean;
+    items: SelectItem[];
+    getMenuProps: GetMenuPropsFn;
+    getItemProps: GetItemPropsFn;
+    highlightedIndex: number;
+    selectedOption: SelectFieldOption | null;
+    hasMore: boolean;
+    onLoadMore: () => void;
+    loading: boolean;
+    loadingMore: boolean;
+    disableAutoLoadMore?: boolean;
+    disabled?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    sectionsMeta?: SectionMeta[];
+    virtualize?: boolean;
+};
+export declare const SelectOptions: import('react').ForwardRefExoticComponent<SelectOptionsProps & import('react').RefAttributes<OptionsPanelHandle>>;

package/dist/internal/components/VirtualizedOptionsPanel.d.ts

@@ -0,0 +1,2 @@
+import { OptionsPanelProps, OptionsPanelHandle } from './OptionsPanel';
+export declare const VirtualizedOptionsPanel: import('react').ForwardRefExoticComponent<OptionsPanelProps & import('react').RefAttributes<OptionsPanelHandle>>;

package/dist/internal/functions/buildSelectItems.d.ts

@@ -0,0 +1,22 @@
+import { SelectFieldOption } from '../../beta/components/SelectField/types';
+import { SectionMeta, SelectItem } from '../types/selectFieldInternalTypes';
+import { NormalizedPinnedSection } from '../hooks/usePinnedOptions';
+import { NormalizedGroupSection } from '../hooks/useGroupedOptions';
+export declare function toSelectItem(option: SelectFieldOption): SelectItem;
+type BuildSelectItemsParams = {
+    prefixItems?: SelectItem[];
+    pinnedSections: NormalizedPinnedSection[];
+    groupSections: NormalizedGroupSection[];
+    ungroupedItems: SelectItem[];
+};
+/**
+ * Assembles the flat items array and sectionsMeta.
+ * Order: prefixItems → pinned sections → group sections → ungrouped items.
+ * Multi-select hooks pass bulk action items (select-all / select-filtered) as prefixItems;
+ * single-select hooks omit it.
+ */
+export declare function buildSelectItems({ prefixItems, pinnedSections, groupSections, ungroupedItems, }: BuildSelectItemsParams): {
+    items: SelectItem[];
+    sectionsMeta: SectionMeta[];
+};
+export {};

package/dist/internal/functions/syncFilterUtils.d.ts

@@ -0,0 +1,10 @@
+import { MatchSorterOptions } from 'match-sorter';
+import { SelectFieldOption, SelectFieldGroupByValue } from '../../beta/components/SelectField/types';
+export type SyncFilterFn<T extends SelectFieldOption = SelectFieldOption> = (options: T[], searchValue: string) => T[];
+export declare const defaultSyncFilter: SyncFilterFn;
+export declare const toSyncFilterFn: <T extends SelectFieldOption = SelectFieldOption>(filter: SyncFilterFn<T> | MatchSorterOptions<T>) => SyncFilterFn<T>;
+/**
+ * Sorts options by group using the provided comparator while maintaining
+ * the original order within each group (stable sort).
+ */
+export declare const sortByGroup: <T extends SelectFieldOption = SelectFieldOption>(options: T[], groupSorter: (a: SelectFieldGroupByValue, b: SelectFieldGroupByValue) => number) => T[];

package/dist/{beta/components/SelectField/internal → internal/hooks}/useGroupedOptions.d.ts

@@ -1,4 +1,5 @@
-import { SelectFieldDownshiftItem, SelectFieldGroupByValue, SelectFieldOption } from '../types';
+import { SelectFieldGroupByValue, SelectFieldOption } from '../../beta/components/SelectField/types';
+import { SelectItem } from '../types/selectFieldInternalTypes';
 /**
  * Normalized group section structure used internally.
  * @property label - The group label (derived from groupToString or String(groupValue))
@@ -10,9 +11,9 @@ export type NormalizedGroupSection = {
 };
 type UseGroupedOptionsResult = {
     /** Options that have a group property, converted to downshift items */
-    groupedItems: SelectFieldDownshiftItem[];
+    groupedItems: SelectItem[];
     /** Options that don't have a group property, converted to downshift items */
-    ungroupedItems: SelectFieldDownshiftItem[];
+    ungroupedItems: SelectItem[];
     /** Metadata about each group section for rendering */
     groupSections: NormalizedGroupSection[];
 };

package/dist/{beta/components/SelectField/internal/useFieldListSections.d.ts → internal/hooks/useOptionsSections.d.ts}

@@ -1,7 +1,6 @@
-import { SelectFieldDownshiftItem } from '../types';
-import { SectionMeta } from './types';
+import { SectionMeta, SelectItem } from '../types/selectFieldInternalTypes';
 export type SectionItem = {
-    item: SelectFieldDownshiftItem;
+    item: SelectItem;
     index: number;
 };
 export type PinnedSection = {
@@ -22,8 +21,8 @@ export type FlatSection = {
 export type Section = PinnedSection | GroupSection | FlatSection;
 export type VirtualRow = {
     type: "item";
-    item: SelectFieldDownshiftItem;
-    downshiftIndex: number;
+    item: SelectItem;
+    index: number;
 } | {
     type: "header";
     label: string;
@@ -36,15 +35,15 @@ export type VirtualRow = {
 };
 /**
  * Computes grouped sections from a flat items array and section metadata.
- * @param items - The flat downshift items array
+ * @param items - The flat items array
  * @param sectionsMeta - Section metadata describing pinned/group ranges
  * @returns Grouped sections for rendering
  */
-export declare const useFieldListSections: (items: SelectFieldDownshiftItem[], sectionsMeta: SectionMeta[]) => Section[];
+export declare const useOptionsSections: (items: SelectItem[], sectionsMeta: SectionMeta[]) => Section[];
 /**
  * Flattens grouped sections into a linear list of virtual rows for virtualization,
  * and builds a mapping from downshift item index to virtual row index.
- * @param sections - The grouped sections from useFieldListSections
+ * @param sections - The grouped sections from useOptionsSections
  * @param hasMore - Whether there are more items to load
  * @returns The flat virtual row list and a downshift-to-virtual index mapping
  */

package/dist/{beta/components/SelectField/internal → internal/hooks}/usePinnedOptions.d.ts

@@ -1,4 +1,4 @@
-import { SelectFieldOption, SelectFieldPinnedOptions } from '../types';
+import { SelectFieldOption, SelectFieldPinnedOptions } from '../../beta/components/SelectField/types';
 /**
  * Normalized pinned section structure used internally.
  * @property label - Section label (e.g., "Recent", "Favorites")

package/dist/{beta/components/SelectField/internal → internal/hooks}/useProcessedOptions.d.ts

@@ -1,4 +1,4 @@
-import { SelectFieldGroupByValue, SelectFieldOption, SelectFieldPinnedOptions } from '../types';
+import { SelectFieldGroupByValue, SelectFieldOption, SelectFieldPinnedOptions } from '../../beta/components/SelectField/types';
 type UseProcessedOptionsParams = {
     options: SelectFieldOption[];
     pinned?: SelectFieldPinnedOptions;
@@ -13,7 +13,7 @@ type UseProcessedOptionsParams = {
  */
 export declare const useProcessedOptions: ({ options, pinned, searchValue, groupToString, groupSorter, }: UseProcessedOptionsParams) => {
     pinnedSections: import('./usePinnedOptions').NormalizedPinnedSection[];
-    ungroupedItems: import('..').SelectFieldDownshiftItem[];
+    ungroupedItems: import('../types/selectFieldInternalTypes').SelectItem[];
     groupSections: import('./useGroupedOptions').NormalizedGroupSection[];
 };
 export {};

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

@@ -0,0 +1,38 @@
+import { ForwardedRef } from 'react';
+export type UseSelectOrchestrationConfig = {
+    lazy: false | "page" | "offset" | "group" | undefined;
+    loadOptions: any;
+    cache?: {
+        enabled?: boolean;
+        maxSize?: number;
+    };
+    lazyOptions?: {
+        pageSize?: number;
+        limit?: number;
+    };
+    initialLoad?: "auto" | "immediate" | "open";
+    displayMenuAs?: "auto" | "popover" | "dialog";
+    ref: ForwardedRef<{
+        clearCache: () => void;
+        invalidate: () => void;
+    }>;
+};
+/**
+ * Shared orchestration hook used by Select components
+ * Centralizes adaptive view resolution, loading config construction, option loading lifecycle,
+ * and imperative handle setup (clearCache/invalidate).
+ */
+export declare function useSelectOrchestration(config: UseSelectOrchestrationConfig): {
+    displayAs: "popover" | "dialog";
+    initialLoad: "open" | "immediate";
+    initialLoadPerformed: boolean;
+    setInitialLoadPerformed: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    options: import('../../beta').SelectFieldOption[];
+    loading: boolean;
+    loadingMore: boolean;
+    hasMore: boolean;
+    loadOptions: (searchValue: string, options?: {
+        initial?: boolean;
+    }) => Promise<void>;
+    loadMore: (searchValue: string) => Promise<void>;
+};

package/dist/{beta/components/MultiSelectField/internal → internal/hooks}/useToggleSelection.d.ts

@@ -1,5 +1,5 @@
-import { SelectFieldOption } from '../../SelectField/types';
-import { NormalizedPinnedSection } from '../../SelectField/internal/usePinnedOptions';
+import { SelectFieldOption } from '../../beta/components/SelectField/types';
+import { NormalizedPinnedSection } from './usePinnedOptions';
 type UseToggleSelectionParams = {
     options: SelectFieldOption[];
     pinnedSections: NormalizedPinnedSection[];

package/dist/{beta/components/SelectField/internal/types.d.ts → internal/types/selectFieldInternalTypes.d.ts}

@@ -1,11 +1,12 @@
 import { ReactElement, RefObject } from 'react';
-import { SelectFieldOption, SelectFieldProps } from '../types';
+import { CheckState } from '../../types';
+import { SelectFieldOption, SelectFieldProps } from '../../beta/components/SelectField/types';
 /**
  * Metadata about list sections for rendering purposes.
- * Used by both SelectFieldList and MultiSelectFieldList to render section headers and dividers.
+ * Used by SelectOptions, MultiSelectOptions, and their Menu counterparts to render section headers and dividers.
  * @property type - The type of section ("pinned" for pinned options, "group" for grouped options)
  * @property label - Section label (e.g., "Recent", "Favorites", or group name)
- * @property startIndex - Index in downshiftItems where this section starts
+ * @property startIndex - Index in items where this section starts
  * @property endIndex - Index where this section ends (exclusive)
  * @property loading - Whether this section is still loading its options (pinned sections only)
  */
@@ -71,3 +72,10 @@ export type SelectFieldComboboxInternalProps = SelectFieldBaseInternalProps & {
 export type GetMenuPropsFn = (...args: any[]) => any;
 export type GetItemPropsFn = (...args: any[]) => any;
 export type GetLabelPropsFn = (...args: any[]) => any;
+export type SelectItem = {
+    id: string | number;
+    type: "option" | "pinned-option" | "grouped-option" | "select-all" | "select-filtered";
+    original: SelectFieldOption;
+    disabled?: boolean;
+    checkState?: CheckState;
+};