@servicetitan/anvil2 3.0.2 → 3.0.4

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

@@ -0,0 +1,338 @@
+import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
+import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../../types';
+import { AvatarProps, ChipProps, IconProps } from '../../..';
+/**
+ * Configuration options for the SelectField cache.
+ * @property enabled - Whether caching is enabled. Defaults to true.
+ * @property maxSize - Maximum number of cached entries before clearing the cache. Defaults to 15.
+ */
+export type SelectFieldCacheOptions = {
+    enabled?: boolean;
+    maxSize?: number;
+};
+/**
+ * Imperative handle for the SelectField component.
+ * @property clearCache - Clears the options cache.
+ * @property invalidate - Clears the cache and triggers a fresh options load from the data source.
+ */
+export type SelectFieldHandle = {
+    clearCache: () => void;
+    invalidate: () => void;
+};
+export type SelectFieldGroupByValue = string | number;
+export type SelectFieldOption = {
+    id: string | number;
+    label: string;
+    searchText?: string;
+    group?: SelectFieldGroupByValue;
+    disabled?: boolean;
+    extra?: Record<string, unknown>;
+    content?: {
+        title?: string;
+        description?: string;
+        chips?: Pick<ChipProps, "label" | "color" | "textWrap">[];
+        avatar?: Pick<AvatarProps, "name" | "status" | "color" | "image">;
+        icon?: Pick<IconProps, "svg" | "color"> & {
+            /** Accessible label for the icon. When omitted, the icon is treated as decorative. */
+            label?: string;
+        };
+    };
+};
+export type SelectFieldGroupedOption = SelectFieldOption & {
+    group: SelectFieldGroupByValue;
+};
+export type SelectFieldUngroupedOption = Omit<SelectFieldOption, "group"> & {
+    group?: never;
+};
+export type SelectFieldOptionsResult = SelectFieldOption[] | Promise<SelectFieldOption[]>;
+export type SelectFieldEagerLoader = (searchValue: string) => SelectFieldOptionsResult;
+export type SelectFieldOffsetLazyResult = {
+    options: SelectFieldUngroupedOption[];
+    hasMore?: boolean;
+};
+export type SelectFieldOffsetLazyLoader = (searchValue: string, offset: number, limit: number) => SelectFieldOffsetLazyResult | Promise<SelectFieldOffsetLazyResult>;
+export type SelectFieldPageLazyResult = {
+    options: SelectFieldUngroupedOption[];
+    hasMore?: boolean;
+};
+export type SelectFieldPageLazyLoader = (searchValue: string, pageNumber: number, pageSize: number) => SelectFieldPageLazyResult | Promise<SelectFieldPageLazyResult>;
+export type SelectFieldGroupLazyResult = {
+    options: SelectFieldGroupedOption[];
+    hasMore?: boolean;
+};
+export type SelectFieldGroupLazyLoader = (searchValue: string, previousGroupKey: SelectFieldGroupByValue | null) => SelectFieldGroupLazyResult | Promise<SelectFieldGroupLazyResult>;
+export type SelectFieldSearchProps = {
+    /**
+     * The current search value.
+     * Not a preferred usage. You likely don't need to control the searchValue yourself.
+     */
+    searchValue?: string;
+    /**
+     * Callback when the search value changes.
+     * Not a preferred usage. Lean on the searchValue in the loadOptions function instead.
+     */
+    onSearchChange?: (searchValue: string) => void;
+    /**
+     * The number of milliseconds to debounce the search input.
+     */
+    debounceMs?: number;
+};
+type SelectFieldAddNewOptionProps = {
+    /**
+     * The configuration for the add new option.
+     */
+    addNewOption?: {
+        /**
+         * The label to display for the add new option.
+         */
+        label: string;
+        /**
+         * The content to display in the add new option dialog.
+         */
+        renderDialogContent: (searchValue: string) => React.ReactNode;
+    };
+};
+export type SelectFieldPinnedOptionsSection = {
+    options: SelectFieldOption[] | ((searchValue: string) => SelectFieldOption[] | Promise<SelectFieldOption[]>);
+    label: string;
+    /**
+     * Whether to re-call the loader when search value changes.
+     * Only applies when `options` is a function. Defaults to true.
+     * When false, the loader is called once and the result is reused for all search values.
+     *
+     * You may wish to use this, for example, if you are loading a set of "favorites" options that should not be re-loaded when the search value changes.
+     */
+    searchReactive?: boolean;
+    /**
+     * Maximum number of search results to cache per section.
+     * Only applies when `options` is a function and `searchReactive` is true.
+     * Oldest entries are evicted when the limit is reached. Defaults to 15.
+     */
+    cacheSize?: number;
+};
+/**
+ * There are two ways to configure pinned options.
+ * 1. A labeled pinned options object (e.g. "Favorites", "Recent", "AI Suggestions", etc.)
+ * 2. An array of labeled pinned options objects (e.g. [{"label": "Favorites", "options": [...]}])
+ */
+export type SelectFieldPinnedOptions = SelectFieldPinnedOptionsSection | SelectFieldPinnedOptionsSection[];
+type SelectFieldCommonSelectFieldProps = {
+    /**
+     * The id of the select field.
+     */
+    id?: string;
+    /**
+     * The label of the select field.
+     */
+    label: string;
+    /**
+     * The placeholder of the select field.
+     */
+    placeholder?: string;
+    /**
+     * The size of the select field.
+     */
+    size?: Extract<Size, "small" | "medium" | "large">;
+    /**
+     * The value of the select field. Must be controlled state.
+     */
+    value: SelectFieldOption | null;
+    /**
+     * The callback to call when an item is clicked.
+     * @param option - The option that was selected.
+     */
+    onSelectedOptionChange: (option: SelectFieldOption | null) => void;
+    /**
+     * Defines the initial loading behavior of the options. Controls when loadOptions is called.
+     * @default "auto"
+     * @description "auto" default behavior, currently equivalent to "immediate".
+     * @description "immediate" will load the initial options when the component is mounted.
+     * @description "open" will load the initial options if/when the user opens the dropdown.
+     */
+    initialLoad?: "auto" | "immediate" | "open";
+    /**
+     * The options to pin to the top of the list.
+     */
+    pinned?: SelectFieldPinnedOptions;
+    /**
+     * Whether to disable the clear button.
+     * @default false
+     */
+    disableClearButton?: boolean;
+    /**
+     * Configuration for caching loadOptions results.
+     * Caching is enabled by default. Set `{ enabled: false }` to disable.
+     */
+    cache?: SelectFieldCacheOptions;
+    /**
+     * The way to display the menu.
+     * @default "auto"
+     * @description "auto" will display the menu as a popover on mobile and a dialog on desktop.
+     * @description "popover" will always display the menu as a popover.
+     * @description "dialog" will always display the menu as a dialog.
+     */
+    displayMenuAs?: "auto" | "popover" | "dialog";
+    /**
+     * Error state for the field. Pass `true` to indicate error styling without a message.
+     * Pass a string, string[], or ReactElement (deprecated) for error messages.
+     */
+    error?: boolean | string | ReactElement | string[];
+    /**
+     * Visually hides the label while keeping it accessible to screen readers.
+     * @default false
+     */
+    hideLabel?: boolean;
+    /**
+     * Hint text displayed below the input field.
+     */
+    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 text displayed below the input field.
+     */
+    description?: ReactElement | string;
+    /**
+     * @deprecated No longer used. Error messages always use `aria-live="assertive"`.
+     */
+    errorAriaLive?: AriaAttributes["aria-live"];
+    /**
+     * Warning message(s) to display. Supports a single string or an array of strings.
+     */
+    warning?: string | string[];
+    /**
+     * Whether the field is required. Shows a red asterisk (*) next to the label.
+     */
+    required?: boolean;
+    /**
+     * Whether the field is disabled.
+     * When disabled, the input is still focusable but menu items cannot be selected.
+     */
+    disabled?: boolean;
+    /**
+     * Whether the field is read-only.
+     * When read-only, the input is still focusable but menu items cannot be selected.
+     */
+    readOnly?: boolean;
+    /**
+     * Content to display before the input field.
+     */
+    prefix?: string | ReactElement;
+    /**
+     * Content to display after the input field.
+     */
+    suffix?: string | ReactElement;
+    /**
+     * Custom CSS class name for the wrapper element.
+     */
+    className?: string;
+    /**
+     * Custom inline styles for the wrapper element.
+     */
+    style?: CSSProperties;
+    /**
+     * Whether to virtualize the dropdown list using windowed rendering.
+     * Enable this for large option sets to improve performance by only rendering visible items.
+     * @default false
+     */
+    virtualize?: boolean;
+    /**
+     * Whether to disable the search input.
+     * When true, the input is replaced with a non-editable select trigger and the ARIA pattern
+     * changes from combobox to listbox.
+     * @default false
+     */
+    disableSearch?: boolean;
+} & SelectFieldSearchProps & SelectFieldAddNewOptionProps & LayoutUtilProps;
+type SelectFieldGroupingProps = {
+    /**
+     * Function to convert a group value to a display label.
+     * Only used when options have a `group` property.
+     * @param groupValue - The group value from the option's `group` property
+     * @returns The formatted group label
+     */
+    groupToString?: (groupValue: SelectFieldGroupByValue) => string;
+    /**
+     * Function to compare two group values for sorting.
+     * When provided, options are sorted by group using this comparator,
+     * then by match-sort order within each group.
+     * @param a - First group value to compare
+     * @param b - Second group value to compare
+     * @returns Negative if a < b, positive if a > b, zero if equal
+     */
+    groupSorter?: (a: SelectFieldGroupByValue, b: SelectFieldGroupByValue) => number;
+};
+type SelectFieldNonGroupingProps = {
+    /**
+     * Incompatible with non-group lazy loading.
+     */
+    groupToString?: never;
+    /**
+     * Incompatible with non-group lazy loading.
+     */
+    groupSorter?: never;
+};
+export type SelectFieldPropsLazyPage = SelectFieldCommonSelectFieldProps & {
+    /**
+     * Lazy loading mode using page-based pagination.
+     * Options will be loaded on demand when the user scrolls to the bottom of the list.
+     * This mode only supports flat options (i.e. cannot be used with grouped options).
+     */
+    lazy: "page";
+    lazyOptions?: {
+        pageSize?: number;
+    };
+    /**
+     * Function to load the options.
+     */
+    loadOptions: SelectFieldPageLazyLoader;
+} & SelectFieldNonGroupingProps;
+export type SelectFieldPropsLazyOffset = SelectFieldCommonSelectFieldProps & {
+    /**
+     * Lazy loading mode using offset-based pagination.
+     * Options will be loaded on demand when the user scrolls to the bottom of the list.
+     * This mode only supports flat options (i.e. cannot be used with grouped options).
+     */
+    lazy: "offset";
+    lazyOptions?: {
+        limit?: number;
+    };
+    /**
+     * Function to load the options.
+     */
+    loadOptions: SelectFieldOffsetLazyLoader;
+} & SelectFieldNonGroupingProps;
+export type SelectFieldPropsLazyGroup = SelectFieldCommonSelectFieldProps & {
+    /**
+     * Lazy loading mode using incremental group loading.
+     * Groups will be loaded on demand when the user scrolls to the bottom of the list.
+     * This mode supports grouped options.
+     */
+    lazy: "group";
+    lazyOptions?: object;
+    /**
+     * Function to load the options.
+     */
+    loadOptions: SelectFieldGroupLazyLoader;
+} & SelectFieldGroupingProps;
+export type SelectFieldPropsEager = SelectFieldCommonSelectFieldProps & {
+    /**
+     * Whether the options are lazy loaded. If true, the options will be loaded on demand when the user scrolls to the bottom of the list.
+     * @default false
+     */
+    lazy?: false;
+    /**
+     * Function to load the options.
+     */
+    loadOptions: SelectFieldEagerLoader;
+} & SelectFieldGroupingProps;
+export type SelectFieldPropsLazy = SelectFieldPropsLazyPage | SelectFieldPropsLazyOffset | SelectFieldPropsLazyGroup;
+export type SelectFieldProps = SelectFieldPropsLazy | SelectFieldPropsEager;
+export {};

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

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+export type DataTableCellAffordanceProps = {
+    children: ReactNode;
+    interactive?: boolean;
+};
+export declare function DataTableCellAffordance({ children, interactive, }: DataTableCellAffordanceProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+import { DataTableBodyImmutableCellProps } from './DataTableBodyImmutableCell';
+export declare function DataTableOverflowCell<T>(props: DataTableBodyImmutableCellProps<T>): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export declare const dataTableCellAffordanceHostClassName: any;

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

@@ -0,0 +1,22 @@
+/**
+ * Marker attribute applied the first time we manage an element's tabindex,
+ * so we can find it again to flip the value back when entering interaction
+ * mode regardless of what tabindex it currently has.
+ */
+export declare const CELL_MANAGED_ATTR = "data-anv-cell-managed-tabindex";
+/**
+ * Finds descendants of a cell that are currently tabbable but have not yet
+ * been marked managed. Used by the immutable cell to discover newly rendered
+ * focusables and bring them under tabindex control.
+ *
+ * @param cellEl The cell element to search within
+ * @returns Tabbable descendants that are not yet under cell-tabindex control
+ */
+export declare function getUnmanagedTabbables(cellEl: HTMLElement): HTMLElement[];
+/**
+ * Finds descendants the cell has previously brought under tabindex control.
+ *
+ * @param cellEl The cell element to search within
+ * @returns Descendants previously marked as managed by the cell
+ */
+export declare function getManagedInteractives(cellEl: HTMLElement): HTMLElement[];

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

@@ -0,0 +1,65 @@
+import { ColumnHelper } from '@tanstack/react-table';
+import { ReactNode } from 'react';
+import { ColumnDef, ColumnReadRenderResult, EditMode, TableRow } from '../../../types';
+declare module "@tanstack/react-table" {
+    interface ColumnMeta<TData, TValue> {
+        editMode?: EditMode;
+        editConfig?: ColumnDef<TData>["editConfig"];
+        overflow?: ColumnDef<TData>["overflow"];
+        /**
+         * The original column definition, stored for type narrowing and runtime access
+         */
+        columnDef?: ColumnDef<TData>;
+        /**
+         * Custom read display metadata shared between rendering, editing, and sorting.
+         */
+        readRenderResult?: ColumnReadRenderResult;
+        getCellText?: (value: TValue, context: {
+            row: TableRow<TData>;
+            depth: number;
+        }) => string;
+        getReadRenderResult?: (value: TValue, context: {
+            row: TableRow<TData>;
+            depth: number;
+        }) => ColumnReadRenderResult;
+        /**
+         * Whether the header action (expand all / select all) is disabled for this column
+         */
+        disableHeaderAction?: boolean;
+        /**
+         * Resolved header alignment for DataTable-owned header layout.
+         */
+        headerAlign?: HeaderAlign;
+        /**
+         * Whether this column renders a grouped header.
+         */
+        isGroupHeader?: boolean;
+    }
+}
+/**
+ * Props for the getTanStackColumnDef function
+ */
+export type TanStackColumnDefProps<T> = {
+    /**
+     * The column definition to convert to a TanStack column definition
+     */
+    columnDef: ColumnDef<T>;
+    /**
+     * Table-level default content for empty cells. Column-level `emptyCellContent`
+     * takes precedence over this value.
+     */
+    emptyCellContent?: ReactNode;
+};
+type TanStackColumnDef<T extends object> = ReturnType<ColumnHelper<T>["group"]> | ReturnType<ColumnHelper<T>["accessor"]>;
+type HeaderAlign = "start" | "center" | "end";
+/**
+ * Build the column definition for TanStack useReactTable.
+ * This converts our ColumnDef<T> to TanStack's column definition format,
+ * preserving the original column definition in meta for type narrowing.
+ *
+ * @param props - The props for the getTanStackColumnDef function
+ * @param props.columnDef - The column definition to convert
+ * @returns The column definition for TanStack useReactTable
+ */
+export declare function getTanStackColumnDef<T extends object>({ columnDef, emptyCellContent, }: TanStackColumnDefProps<T>): TanStackColumnDef<T>;
+export {};

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

@@ -0,0 +1,246 @@
+import { ReactNode } from 'react';
+import { ColumnDef, ColumnOverflowConfig, ColumnTypeConfig, TextEditConfig, NumberEditConfig, SelectEditConfig, SelectAsyncEditConfig, MultiselectEditConfig, MultiselectAsyncEditConfig, BooleanEditConfig, CustomEditConfig, TableRow, ColumnHeaderConfig, ColumnReadRenderContext, ColumnReadRenderResult } from './types';
+import { MultiSelectMenuOption } from '../MultiSelectMenu';
+/**
+ * Base column configuration shared by all column types
+ */
+type BaseColumnConfig<T> = ColumnHeaderConfig & {
+    /**
+     * The cleaned-up header configuration.
+     */
+    header?: ColumnDef<T>["header"];
+    /**
+     * The label of the header.
+     * @deprecated Use `header.label` instead.
+     */
+    headerLabel?: string;
+    /**
+     * The alignment of the header.
+     * When using `type`, this is set automatically but can be overridden.
+     */
+    align?: "start" | "center" | "end";
+    /**
+     * Custom content to display when a cell value is empty (null, undefined, or empty string).
+     * Overrides the default em dash. When set on both the column and the DataTable,
+     * the column-level value takes precedence.
+     */
+    emptyCellContent?: ReactNode;
+    /**
+     * The content of the footer cell. An array will display multiple footer rows
+     */
+    footerContent?: ReactNode | ReactNode[];
+    /**
+     * The maximum width of the column, in pixels. Caps automatic growth when
+     * the table has extra horizontal space available.
+     */
+    maxWidth?: number;
+    /**
+     * The minimum width of the column, in pixels. Used as the floor for manual
+     * resize — users can drag a column down to but not below this value. Also
+     * serves as the fallback auto-sizing floor when `defaultWidth` is not set.
+     */
+    minWidth?: number;
+    /**
+     * The preferred starting width of the column, in pixels. Used as the basis
+     * for automatic growing/shrinking: the column renders at this width by
+     * default, grows toward `maxWidth` when the table has spare horizontal
+     * space, and never auto-shrinks below it — the table scrolls horizontally
+     * instead.
+     *
+     * Manual resize via the column's resize handle is still bounded by
+     * `minWidth`/`maxWidth`, so users can drag a column below `defaultWidth`
+     * down to `minWidth`.
+     *
+     * Falls back to `minWidth` when not specified.
+     */
+    defaultWidth?: number;
+    /**
+     * The pinning location of the column
+     */
+    pinned?: "left" | "right";
+    /**
+     * Whether the column is resizable
+     */
+    resizable?: boolean;
+};
+type BaseDataColumnConfig<T, K extends keyof T> = BaseColumnConfig<T> & {
+    /**
+     * The function to customize how the cell content is rendered.
+     * When using `type`, a default renderer is provided but can be overridden.
+     */
+    renderCell?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => ReactNode;
+    /**
+     * Optional plain-text extractor for the read path.
+     * Useful when `renderCell` returns JSX or multiline content but default sorting
+     * should still use a simple string.
+     */
+    getCellText?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => string;
+    /**
+     * Optional advanced read-display extractor.
+     * Prefer `getCellText` for the common case where `renderCell` already handles
+     * display and sorting only needs a simple string. Use this when you want one
+     * hook to return both rendered read content and the sortable raw string.
+     */
+    getReadRenderResult?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => ColumnReadRenderResult;
+    /**
+     * Whether the column is sortable, or a function to customize the sorting logic
+     */
+    sortable?: boolean | ((valueA: T[K], valueB: T[K]) => number);
+    /**
+     * The column type for automatic display configuration.
+     * Sets default `renderCell` (formatter) and `align` based on the data type.
+     */
+    type?: ColumnTypeConfig;
+};
+type GroupColumnConfig<T> = BaseColumnConfig<T> & {
+    /**
+     * Columns of a group column (for grouped columns)
+     */
+    columns: ColumnDef<T>[];
+    editConfig?: never;
+    overflow?: never;
+    renderCell?: never;
+    sortable?: never;
+    type?: never;
+};
+/**
+ * Configuration for read-only columns (no editing)
+ */
+type ReadOnlyColumnConfig<T, K extends keyof T> = BaseDataColumnConfig<T, K> & {
+    editConfig?: undefined;
+    overflow?: ColumnOverflowConfig;
+};
+type EditableColumnConfig<T, K extends keyof T> = BaseDataColumnConfig<T, K> & {
+    overflow?: never;
+};
+/**
+ * Configuration for text editable columns using editConfig.
+ * Valid when T[K] is a string.
+ */
+type TextEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends string ? EditableColumnConfig<T, K> & {
+    editConfig: TextEditConfig<T, K>;
+} : never;
+/**
+ * Configuration for number editable columns using editConfig.
+ * Valid when T[K] is a number type.
+ */
+type NumberEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends number ? EditableColumnConfig<T, K> & {
+    editConfig: NumberEditConfig<T, K>;
+} : never;
+/**
+ * Configuration for select editable columns using editConfig
+ */
+type SelectEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
+    editConfig: SelectEditConfig<T, K>;
+};
+/**
+ * Configuration for async select editable columns using editConfig
+ */
+type SelectAsyncEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
+    editConfig: SelectAsyncEditConfig<T>;
+};
+type CellArrayItem = object | string | number | boolean | bigint | symbol | null | undefined;
+type CellArrayValue = readonly CellArrayItem[];
+/**
+ * Configuration for multiselect editable columns using editConfig
+ * Only valid when T[K] is an array type
+ */
+type MultiselectEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends CellArrayValue ? EditableColumnConfig<T, K> & {
+    editConfig: MultiselectEditConfig<T, K>;
+} : never;
+/**
+ * Configuration for async multiselect editable columns using editConfig.
+ * Only valid when T[K] is MultiSelectMenuOption[] — full option objects,
+ * not a plain primitive array like string[].
+ */
+type MultiselectAsyncEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends MultiSelectMenuOption[] ? EditableColumnConfig<T, K> & {
+    editConfig: MultiselectAsyncEditConfig<T>;
+} : never;
+/**
+ * Configuration for boolean editable columns using editConfig.
+ * Valid when T[K] is a boolean type.
+ */
+type BooleanEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends boolean ? EditableColumnConfig<T, K> & {
+    editConfig: BooleanEditConfig<T, K>;
+} : never;
+type CustomEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
+    editConfig: CustomEditConfig<T, K>;
+};
+/**
+ * Full column configuration type - union of all possible configurations.
+ * TypeScript will enforce that the editConfig matches the value type constraints.
+ */
+type ColumnConfig<T, K extends keyof T> = ReadOnlyColumnConfig<T, K> | TextEditConfigColumnConfig<T, K> | NumberEditConfigColumnConfig<T, K> | SelectEditConfigColumnConfig<T, K> | SelectAsyncEditConfigColumnConfig<T, K> | MultiselectEditConfigColumnConfig<T, K> | MultiselectAsyncEditConfigColumnConfig<T, K> | BooleanEditConfigColumnConfig<T, K> | CustomEditConfigColumnConfig<T, K>;
+/**
+ * Factory function to create column helper function for defining Table columns.
+ *
+ * This helper provides type safety by enforcing that:
+ * - `type` sets display defaults (formatter and alignment) for the column
+ * - `editConfig` enables cell editing with proper type constraints
+ * - `editConfig.mode: "text"` can only be used with string columns
+ * - `editConfig.mode: "boolean"` can only be used with boolean columns
+ * - `editConfig.mode: "number"` can only be used with number columns
+ * - `editConfig.mode: "multiselect"` can only be used with array columns
+ * - `editConfig.mode: "select"` options values must match the column's value type
+ * - `editConfig.mode: "custom"` preserves object-valued canonical state and typed draft helpers
+ * - `editConfig.onChange` callback receives the correct value type for the column
+ * - `getCellText` provides a simple sortable read string when `renderCell` returns rich content
+ *
+ * @template T - The type of the row data
+ * @returns A function that creates type-safe column definitions
+ *
+ * @example
+ * ```ts
+ * type Data = { name: string; amount: number; tags: string[] };
+ * const createColumn = createColumnHelper<Data>();
+ *
+ * // Display-only column with type defaults
+ * createColumn("amount", { header: { label: "Amount" }, type: "currency" });
+ *
+ * // Editable column with editConfig
+ * createColumn("name", {
+ *   header: { label: "Name" },
+ *   type: "text",
+ *   editConfig: { mode: "text", onChange: (value, rowId) => save(value, rowId) }
+ * });
+ *
+ * // Number editing
+ * createColumn("amount", {
+ *   header: { label: "Amount" },
+ *   editConfig: {
+ *     mode: "number",
+ *     minValue: 0,
+ *     maxValue: 10000,
+ *     step: 0.01,
+ *     onChange: (value, rowId) => save(value, rowId)
+ *   }
+ * });
+ *
+ * // Select editing
+ * createColumn("status", {
+ *   header: { label: "Status" },
+ *   editConfig: {
+ *     mode: "select",
+ *     options: [{ id: "active", label: "Active" }],
+ *     onChange: (option, rowId) => save(option?.id, rowId)
+ *   }
+ * });
+ *
+ * // Multiselect editing with array column
+ * createColumn("tags", {
+ *   header: { label: "Tags" },
+ *   editConfig: {
+ *     mode: "multiselect",
+ *     options: [{ id: "urgent", label: "Urgent" }],
+ *     onChange: (options, rowId) => save(options.map(o => o.id), rowId)
+ *   }
+ * });
+ * ```
+ */
+export declare function createColumnHelper<T>(): {
+    (id: {
+        group: string;
+    }, column: GroupColumnConfig<T>): ColumnDef<T>;
+    <K extends keyof T>(id: K, column: ColumnConfig<T, K>): ColumnDef<T>;
+};
+export {};