@servicetitan/anvil2 3.0.8 → 3.0.9

package/dist/index.js

@@ -14,7 +14,7 @@ export { a as Calendar, g as CalendarMonth, f as CalendarMonthButton, e as Calen
 export { C as Card } from './Card-fBqg853U.js';
 export { C as Checkbox } from './Checkbox-BYWhkYoK.js';
 export { C as Chip } from './Chip-CyMNyEPR.js';
-export { C as Combobox, a as ComboboxElement, c as ComboboxList, b as ComboboxSelect, u as useInfiniteCombobox } from './useInfiniteCombobox-C6TDFfds.js';
+export { C as Combobox, a as ComboboxElement, c as ComboboxList, b as ComboboxSelect, u as useInfiniteCombobox } from './useInfiniteCombobox-BqJm-CdN.js';
 export { D as DateFieldRange } from './DateFieldRange-BUug1tUy.js';
 export { D as DateFieldSingle } from './DateFieldSingle-DR7faQGD.js';
 export { D as DateFieldYearless } from './DateFieldYearless-7MFcR7L6.js';
@@ -22,8 +22,8 @@ export { D as DateFieldYearlessRange } from './DateFieldYearlessRange-DGtdyISH.j
 export { D as DaysOfTheWeek } from './DaysOfTheWeek-C7oN9nIe.js';
 export { D as Details } from './Details-s2pVu-YL.js';
 export { D as Dialog } from './Dialog-dE9c90iR.js';
-export { D as Divider } from './Divider-CxtTyw8_.js';
-export { D as Dnd } from './index-CukEaIHB.js';
+export { D as Divider } from './Divider-Dz27DFuE.js';
+export { D as Dnd } from './index-CKdC7x1S.js';
 export { D as Drawer } from './Drawer-Dk0MsaOU.js';
 export { D as DrillDown, b as DrillDownContent, c as DrillDownFooter, a as DrillDownHeader, d as DrillDownNextButton, e as DrillDownPrevButton, u as useDrillDown } from './useDrilldown-BJ2dHHKV.js';
 export { E as EditCard } from './EditCard-DV2N7zWr.js';

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

@@ -32,10 +32,6 @@ export type DataTableProps<T extends DataTableRowData> = LayoutUtilProps & Compo
      * @default false
      */
     disableExpandAll?: boolean;
-    /**
-     * The default active row ids.
-     */
-    defaultActiveRowIds?: TableRow<T>["id"][];
     /**
      * The default selected row ids.
      */
@@ -54,23 +50,11 @@ export type DataTableProps<T extends DataTableRowData> = LayoutUtilProps & Compo
      * @default false
      */
     disableSelectAll?: boolean;
-    /**
-     * Whether rows can be activated by clicking. When enabled, rows receive
-     * a pointer cursor and hover background, and clicking a row toggles it
-     * into the active set. Can be a boolean to apply to all rows, or a
-     * function to opt specific rows in.
-     * @default false
-     */
-    isActivatable?: boolean | ((row: T) => boolean);
     /**
      * Whether the table is selectable. Can be a boolean or a function to customize the selection logic.
      * @default false
      */
     isSelectable?: boolean | ((row: T) => boolean);
-    /**
-     * Called when the row activation state changes. Passes the active row ids.
-     */
-    onActivateRow?: (activeRowIds: TableRow<T>["id"][]) => void;
     /**
      * Called when the row expansion state changes. Passes the expanded row ids.
      */
@@ -89,18 +73,13 @@ export type DataTableProps<T extends DataTableRowData> = LayoutUtilProps & Compo
      * When `false` or `undefined`, no pagination is applied and all data is shown.
      */
     pagination?: boolean | DataTablePaginationConfig<T>;
-    /**
-     * The active row ids.
-     */
-    activeRowIds?: TableRow<T>["id"][];
     /**
      * Row ids that should render as read-only. Read-only rows gray their
-     * plain text content, show a `not-allowed` cursor when they would
-     * otherwise be activatable, and disable the selection checkbox.
-     * Links, chips, and custom cell content are unaffected.
+     * plain-text cell content and render their selection checkbox as disabled
+     * and read-only. Links, chips, and custom cell content are unaffected.
      *
-     * Pre-seeded `selectedRowIds` / `activeRowIds` are still accepted —
-     * read-only only gates user interaction, not the visual state.
+     * Pre-seeded `selectedRowIds` is still honored — `readOnlyRowIds` only
+     * gates user interaction (checkbox toggling), not the visual state.
      */
     readOnlyRowIds?: TableRow<T>["id"][];
     /**

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

@@ -1,7 +1,6 @@
 import { ComponentPropsWithoutRef } from 'react';
 import { Table as TanstackTable } from '@tanstack/react-table';
 import { DataTableVirtualizer } from './useDataTableVirtualizer';
-import { TableRow } from '../../types';
 /**
  * Props for the DataTableBody component
  * @property {TanstackTable<T>} table - The table instance from @tanstack/react-table to render
@@ -34,25 +33,9 @@ export type DataTableBodyProps<T> = {
      */
     getRowVersion?: (row: T) => unknown;
     /**
-     * Whether rows can be activated. Mirrors the DataTable `isActivatable`
-     * prop — a boolean applies to every row, a function opts specific rows in.
-     */
-    isActivatable?: boolean | ((row: T) => boolean);
-    /**
-     * Map of currently active row ids keyed by id. An entry set to `true`
-     * marks the row as active.
-     */
-    activeRowMap: Record<string, boolean>;
-    /**
-     * Map of read-only row ids keyed by id. Read-only rows gray their text
-     * and ignore activation clicks; their selection checkbox is disabled.
+     * Map of read-only row ids keyed by id. Read-only rows gray their plain
+     * text content and render disabled, read-only selection checkboxes.
      */
     readOnlyRowMap: Record<string, boolean>;
-    /**
-     * Called when an activatable row is clicked. Receives the row id and the
-     * ids of all descendant rows (flattened, any depth) so the parent's state
-     * can cascade to its sub-rows.
-     */
-    onToggleActive: (rowId: TableRow<T>["id"], descendantIds: TableRow<T>["id"][]) => void;
 } & ComponentPropsWithoutRef<"div">;
 export declare function DataTableBody<T>(props: DataTableBodyProps<T>): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,4 @@
 import { Row } from '@tanstack/react-table';
-import { TableRow } from '../../types';
 import { useColumnOrder } from './useColumnOrder';
 export type DataTableBodyRowProps<T> = {
     columnOrder: ReturnType<typeof useColumnOrder>["columnOrder"];
@@ -17,22 +16,22 @@ export type DataTableBodyRowProps<T> = {
     parentRowCanExpand: boolean;
     isSelected: boolean;
     isSomeSelected: boolean;
-    isActivatable: boolean;
-    isActive: boolean;
     /**
-     * True when the row is the topmost active ancestor in its active chain
-     * (itself active, has sub-rows, and no ancestor row is active). Drives
-     * the darker blue/100 background; non-topmost active rows use blue/50.
+     * True when any ancestor row (parent, grandparent, etc.) is currently
+     * selected. Combined with `isSelected` to drive the row's
+     * `data-anv-is-selected-row` attribute so descendants visually adopt
+     * an ancestor's selection state without painting the ancestor itself.
+     * Computed at the parent level (`DataTableBody.tsx`) so the prop
+     * remains a serializable boolean — preserving `React.memo`
+     * comparator semantics in `areRowPropsEqual`.
      */
-    isTopMostActive: boolean;
+    isAncestorSelected: boolean;
     /**
-     * True when the row is flagged read-only via `readOnlyRowIds`. Grays
-     * plain text, shows `not-allowed` cursor on activatable rows, and
-     * disables the activation click (checkbox disabling is gated at the
-     * DataTable level via `enableRowSelection`).
+     * True when the row is flagged read-only via `readOnlyRowIds`. Grays the
+     * row's plain-text cell content. Checkbox disabling is gated separately
+     * at the DataTable level via `enableRowSelection`.
      */
     isReadOnly: boolean;
-    onToggleActive: (rowId: TableRow<T>["id"], descendantIds: TableRow<T>["id"][]) => void;
     /**
      * Optional consumer-provided function that returns a value expressing
      * "this row has changed." When supplied, the row is memoized: a row will
@@ -43,6 +42,6 @@ export type DataTableBodyRowProps<T> = {
      */
     getRowVersion?: (row: T) => unknown;
 };
-declare function DataTableBodyRowInner<T>({ columnOrder: _columnOrder, columnIndexMap, row, rowIndex, tableHasSubRows, isExpanded, canExpand, depth, parentRowCanExpand, isActivatable, isActive, isTopMostActive, isReadOnly, onToggleActive, }: DataTableBodyRowProps<T>): import("react/jsx-runtime").JSX.Element;
+declare function DataTableBodyRowInner<T>({ columnOrder: _columnOrder, columnIndexMap, row, rowIndex, tableHasSubRows, isExpanded, canExpand, depth, parentRowCanExpand, isSelected, isSomeSelected, isAncestorSelected, isReadOnly, }: DataTableBodyRowProps<T>): import("react/jsx-runtime").JSX.Element;
 export declare const DataTableBodyRow: typeof DataTableBodyRowInner;
 export {};

package/dist/src/beta/components/Table/DataTable/internal/context/surface/DataTableSurfaceCoordinatorContext.d.ts

@@ -0,0 +1,13 @@
+import { RefObject } from 'react';
+export type DataTableSurfaceRegistration = {
+    id: string;
+    close: (options?: {
+        restoreFocus?: boolean;
+    }) => void;
+};
+export type DataTableSurfaceCoordinator = {
+    requestOpen: (registration: DataTableSurfaceRegistration) => void;
+    clear: (id: string) => void;
+    intersectionBoundaryRef?: RefObject<HTMLElement | null>;
+};
+export declare const DataTableSurfaceCoordinatorContext: import('react').Context<DataTableSurfaceCoordinator | null>;

package/dist/src/beta/components/Table/DataTable/internal/context/surface/DataTableSurfaceCoordinatorProvider.d.ts

@@ -0,0 +1,7 @@
+import { RefObject } from 'react';
+type DataTableSurfaceCoordinatorProviderProps = {
+    children: React.ReactNode;
+    intersectionBoundaryRef?: RefObject<HTMLElement | null>;
+};
+export declare function DataTableSurfaceCoordinatorProvider({ children, intersectionBoundaryRef, }: DataTableSurfaceCoordinatorProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/beta/components/Table/DataTable/internal/context/surface/useDataTableSurfaceCoordinator.d.ts

@@ -0,0 +1 @@
+export declare function useDataTableSurfaceCoordinator(): import('./DataTableSurfaceCoordinatorContext').DataTableSurfaceCoordinator | null;

package/dist/src/beta/components/Table/DataTable/internal/editable-cells/useCustomEditHelpers.d.ts

@@ -1,13 +1,15 @@
-import { CustomEditConfig, CustomEditController, CustomEditRenderContext, TableRow } from '../../../types';
+import { CustomEditConfig, CustomEditController, CustomEditDraftValue, CustomEditInitialValue, CustomEditPresentObjectValue, TableRow } from '../../../types';
 type CustomObjectValue = object;
-type CustomEditHelperValue<T, K extends keyof T> = CustomEditRenderContext<T, K>["controller"]["draftValue"];
+type CustomEditHelperValue<T, K extends keyof T> = CustomEditDraftValue<T, K>;
+type CustomEditHelperPresentValue<T, K extends keyof T> = CustomEditPresentObjectValue<T, K>;
+type CustomEditHelperInitialValue<T, K extends keyof T> = CustomEditInitialValue<T, K>;
 /**
  * State returned by custom edit controller helpers.
  * @property {CustomEditController<TValue>} controller - Controller object exposed to custom edit renderers.
  * @property {() => void} runInitialFocus - Runs the initial focus callback registered by the custom editor.
  */
-export type CustomEditControllerState<TValue extends CustomObjectValue> = {
-    controller: CustomEditController<TValue>;
+export type CustomEditControllerState<TValue extends CustomObjectValue, TDraftValue = Partial<TValue>, TInitialValue = TValue> = {
+    controller: CustomEditController<TValue, TDraftValue, TInitialValue>;
     runInitialFocus: () => void;
 };
 /**
@@ -30,7 +32,7 @@ export type UseCustomEditHelperStateOptions<T, K extends keyof T> = UseCustomEdi
  * @param options Row, column, edit configuration, and close callback for the editable cell.
  * @returns Controller state with draft value helpers and initial focus runner.
  */
-export declare function useCustomEditControllerState<T, K extends keyof T>({ row, columnId, editConfig, onCloseEditor, }: UseCustomEditControllerStateOptions<T, K>): CustomEditControllerState<CustomEditHelperValue<T, K>>;
+export declare function useCustomEditControllerState<T, K extends keyof T>({ row, columnId, editConfig, onCloseEditor, }: UseCustomEditControllerStateOptions<T, K>): CustomEditControllerState<CustomEditHelperPresentValue<T, K>, CustomEditHelperValue<T, K>, CustomEditHelperInitialValue<T, K>>;
 /**
  * Backward-compatible alias for the custom edit controller hook.
  */
@@ -41,7 +43,7 @@ export declare const useCustomEditHelperState: typeof useCustomEditControllerSta
  * @param options Row, column, edit configuration, and close callback for the editable cell.
  * @returns Controller state with mutable draft value helpers and initial focus runner.
  */
-export declare function createCustomEditControllerState<T, K extends keyof T>({ row, columnId, editConfig, onCloseEditor, }: UseCustomEditControllerStateOptions<T, K>): CustomEditControllerState<CustomEditHelperValue<T, K>>;
+export declare function createCustomEditControllerState<T, K extends keyof T>({ row, columnId, editConfig, onCloseEditor, }: UseCustomEditControllerStateOptions<T, K>): CustomEditControllerState<CustomEditHelperPresentValue<T, K>, CustomEditHelperValue<T, K>, CustomEditHelperInitialValue<T, K>>;
 /**
  * Backward-compatible alias for the imperative custom edit controller factory.
  */

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

@@ -182,8 +182,10 @@ type ColumnConfig<T, K extends keyof T> = ReadOnlyColumnConfig<T, K> | TextEditC
  * - `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
+ * - `editConfig.mode: "custom"` can only be used with structured object columns;
+ *   drafts may be partial objects, plus null/undefined when declared by the row type
+ * - non-custom `editConfig.onChange` callbacks receive the correct value type;
+ *   custom mode uses `onCommit` and `onDraftUpdate`
  * - `getCellText` provides a simple sortable read string when `renderCell` returns rich content
  *
  * @template T - The type of the row data

package/dist/src/beta/components/Table/formatters/htmlFormatter.d.ts

@@ -3,8 +3,10 @@ import { ReactNode } from 'react';
  * Formats an HTML string value for DataTable cells by converting to markdown
  * and rendering through the markdown formatter.
  *
- * Supported HTML: strong, b, em, i, code, mark, ul, ol, li, br, p.
- * Unsupported tags and their content are dropped entirely.
+ * Supported HTML: strong, b, em, i, code, mark, s, strike, del, h1, h2, h3,
+ * ul, ol, li, br, p. The u and span tags, along with text-align styling on
+ * p/h1-h3, are rendered as plain text (styling ignored, content preserved).
+ * Other unsupported tags and their content are dropped entirely.
  * HTML entities are decoded to plain text.
  *
  * @param value - The HTML string to format

package/dist/src/beta/components/Table/formatters/htmlToMarkdown.d.ts

@@ -1,8 +1,11 @@
 /**
  * Converts an HTML string to the markdown subset supported by markdownFormatter.
  *
- * Supported tags: strong, b, em, i, code, mark, ul, ol, li, br, p.
- * Unsupported tags and their content are dropped entirely.
+ * Supported tags: strong, b, em, i, code, mark, s, strike, del, h1, h2, h3,
+ * ul, ol, li, br, p.
+ * The u and span tags, along with text-align styling on p/h1-h3, are rendered
+ * as plain text: their styling is ignored but their content is preserved.
+ * Other unsupported tags and their content are dropped entirely.
  * HTML entities are decoded to plain text.
  *
  * @param value - The HTML string to convert

package/dist/src/beta/components/Table/formatters/markdownFormatter.d.ts

@@ -2,8 +2,9 @@ import { ReactNode } from 'react';
 /**
  * Formats a string value as markdown content for DataTable cells.
  *
- * Supports inline constructs (bold, italic, bold+italic, inline code, highlight)
- * and block-level flat lists (unordered with `- `, ordered with `N. `).
+ * Supports inline constructs (bold, italic, bold+italic, strikethrough, inline
+ * code, highlight) and block-level constructs: headings (`# ` through `### `)
+ * and flat lists (unordered with `- `, ordered with `N. `).
  *
  * @param value - The markdown string to format
  * @returns Formatted React nodes, or null for empty/null/undefined values

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

@@ -61,9 +61,19 @@ type BaseEditConfig<T, K extends keyof T> = {
      */
     onChange: (value: T[K], rowId: string) => void;
 };
-type CustomEditCanonicalValueForValue<TValue> = TValue extends readonly (infer _Element)[] ? never : TValue extends object ? NonNullable<TValue> : never;
-type CustomEditCanonicalValue<T, K extends keyof T> = CustomEditCanonicalValueForValue<NonNullable<T[K]>>;
-export type CustomEditFieldValueUpdater<TValue extends object, TField extends keyof TValue> = TValue[TField] | ((previousValue: TValue[TField], draftValue: TValue) => TValue[TField]);
+type CustomEditInvalidPresentValue<TValue> = Extract<NonNullable<TValue>, readonly unknown[]> | Extract<NonNullable<TValue>, (...args: never[]) => unknown> | Exclude<NonNullable<TValue>, object>;
+type CustomEditPresentObjectValueForValue<TValue> = [
+    CustomEditInvalidPresentValue<TValue>
+] extends [never] ? NonNullable<TValue> extends object ? NonNullable<TValue> : never : never;
+type CustomEditPartialPresentValue<TValue extends object> = TValue extends object ? Partial<TValue> : never;
+export type CustomEditAllowedNullishValue<TValue> = Extract<TValue, null | undefined>;
+export type CustomEditPresentObjectValue<T, K extends keyof T> = CustomEditPresentObjectValueForValue<T[K]>;
+export type CustomEditDraftValueForValue<TValue> = [
+    CustomEditPresentObjectValueForValue<TValue>
+] extends [never] ? never : CustomEditPartialPresentValue<CustomEditPresentObjectValueForValue<TValue>> | CustomEditAllowedNullishValue<TValue>;
+export type CustomEditDraftValue<T, K extends keyof T> = CustomEditDraftValueForValue<T[K]>;
+export type CustomEditInitialValue<T, K extends keyof T> = T[K];
+export type CustomEditFieldValueUpdater<TValue extends object, TField extends keyof TValue> = TValue[TField] | ((previousValue: TValue[TField] | undefined, draftValue: Partial<TValue>) => TValue[TField]);
 export type CustomEditCloseReason = "submit" | "escape" | "outside-click" | "close-button" | "programmatic";
 export type CustomEditValidation<TValue extends object> = {
     /**
@@ -97,7 +107,7 @@ export type CustomEditSurfaceConfig = {
      */
     onKeyDown?: (event: ReactKeyboardEvent<HTMLDivElement>) => void;
 };
-export type CustomEditCloseRequest<TValue extends object> = {
+export type CustomEditCloseRequest<TValue extends object, TDraftValue = Partial<TValue>, TInitialValue = TValue> = {
     /**
      * Why the close was requested.
      */
@@ -105,11 +115,11 @@ export type CustomEditCloseRequest<TValue extends object> = {
     /**
      * Draft value at the time the request is evaluated.
      */
-    draftValue: TValue;
+    draftValue: TDraftValue;
     /**
      * Original committed value when editing began.
      */
-    initialValue: TValue;
+    initialValue: TInitialValue;
     /**
      * Whether the draft differs from the initial value.
      */
@@ -119,21 +129,23 @@ export type CustomEditCloseRequest<TValue extends object> = {
      */
     validation: CustomEditValidation<TValue>;
 };
-export type CustomEditController<TValue extends object> = {
+export type CustomEditController<TValue extends object, TDraftValue = Partial<TValue>, TInitialValue = TValue> = {
     /**
-     * Current local draft value owned by the custom editor.
+     * Current local draft. Custom editors may hold a partial object, or a
+     * row-type-supported nullish value.
      */
-    draftValue: TValue;
+    draftValue: TDraftValue;
     /**
      * Original value before editing began.
      */
-    initialValue: TValue;
+    initialValue: TInitialValue;
     /**
      * Whether the draft differs from the initial value.
      */
     isDirty: boolean;
     /**
-     * Ordered list of changed fields.
+     * Ordered list of changed object fields. Whole-value nullish changes are
+     * represented by `isDirty`, not by synthetic field names.
      */
     changedFields: ReadonlyArray<keyof TValue>;
     /**
@@ -141,13 +153,15 @@ export type CustomEditController<TValue extends object> = {
      */
     validation: CustomEditValidation<TValue>;
     /**
-     * Replace the entire draft value.
+     * Replace the entire draft value. Null and undefined are accepted only when
+     * the column's row value type includes that nullish value.
      */
-    setDraftValue: (nextValue: SetStateAction<TValue>) => TValue;
+    setDraftValue: (nextValue: SetStateAction<TDraftValue>) => TDraftValue;
     /**
-     * Update a single field in the current draft value.
+     * Update a single field in the current draft value. If the current draft is
+     * nullish, a partial object containing this field is synthesized.
      */
-    setDraftField: <TField extends keyof TValue>(field: TField, nextValue: CustomEditFieldValueUpdater<TValue, TField>) => TValue;
+    setDraftField: <TField extends keyof TValue>(field: TField, nextValue: CustomEditFieldValueUpdater<TValue, TField>) => TDraftValue;
     /**
      * Submit the current draft and close the editor.
      */
@@ -197,41 +211,43 @@ export type CustomEditRenderContext<T, K extends keyof T> = {
      */
     rowId: string;
     /**
-     * Canonical committed value for the cell.
+     * Committed value for the cell, exactly as declared by the row type.
      */
     value: T[K];
     /**
      * Typed controller for draft mutation, validation, focus, and lifecycle control.
      */
-    controller: CustomEditController<CustomEditCanonicalValue<T, K>>;
+    controller: CustomEditController<CustomEditPresentObjectValue<T, K>, CustomEditDraftValue<T, K>, CustomEditInitialValue<T, K>>;
 };
 /**
  * Edit configuration for custom mode cells.
- * Preserves canonical object values while continuing to use `renderCell`
- * for the read path.
+ * Custom mode is for structured object-valued columns. The committed read
+ * value remains `T[K]`; editable drafts may be partial objects, plus `null`
+ * or `undefined` when those values are part of `T[K]`.
  *
  * @template T - The row data type
  * @template K - The column key
  */
 export type CustomEditConfig<T, K extends keyof T> = [
-    CustomEditCanonicalValue<T, K>
+    CustomEditPresentObjectValue<T, K>
 ] extends [never] ? never : Omit<BaseEditConfig<T, K>, "onChange"> & {
     /**
      * Custom edit mode - renders a multi-field editor surface.
      */
     mode: "custom";
     /**
-     * Callback fired when the draft is committed.
+     * Callback fired when the current draft is committed. The value is the
+     * exact draft state: partial object, full object, or allowed nullish value.
      */
-    onCommit: (value: T[K], rowId: string) => void;
+    onCommit: (value: CustomEditDraftValue<T, K>, rowId: string) => void;
     /**
-     * Callback fired on every local draft mutation.
+     * Callback fired on every local draft mutation with the exact draft state.
      */
-    onDraftUpdate?: (value: T[K], rowId: string) => void;
+    onDraftUpdate?: (value: CustomEditDraftValue<T, K>, rowId: string) => void;
     /**
      * Optional validation metadata derived from the current draft.
      */
-    validateDraft?: (draftValue: CustomEditCanonicalValue<T, K>, rowId: string) => CustomEditValidation<CustomEditCanonicalValue<T, K>> | undefined;
+    validateDraft?: (draftValue: CustomEditDraftValue<T, K>, rowId: string) => CustomEditValidation<CustomEditPresentObjectValue<T, K>> | undefined;
     /**
      * When true, submit-style close requests are blocked while validation contains
      * a form error or any field error. Defaults to `false`.
@@ -241,13 +257,14 @@ export type CustomEditConfig<T, K extends keyof T> = [
      * Optional close interception hook.
      * Return `false` to keep the editor open.
      */
-    onRequestClose?: (request: CustomEditCloseRequest<CustomEditCanonicalValue<T, K>>) => boolean | void;
+    onRequestClose?: (request: CustomEditCloseRequest<CustomEditPresentObjectValue<T, K>, CustomEditDraftValue<T, K>, CustomEditInitialValue<T, K>>) => boolean | void;
     /**
      * Optional surface presentation overrides.
      */
     surface?: CustomEditSurfaceConfig;
     /**
-     * Consumer-owned renderer for the custom editor contents.
+     * Consumer-owned renderer for the custom editor contents. Editors should
+     * handle partial and row-type-supported nullish draft values defensively.
      */
     renderEditor: (context: CustomEditRenderContext<T, K>) => ReactNode;
 };
@@ -601,9 +618,9 @@ export type BooleanEditConfig<T, K extends keyof T> = BaseEditConfig<T, K> & {
  * // Custom editing keeps renderCell as the read path
  * editConfig: {
  *   mode: "custom",
- *   onChange: (value, rowId) => save(value, rowId),
- *   onDraftChange: (value, rowId) => saveDraft(value, rowId),
- *   renderEditor: ({ helpers }) => renderAddressEditor(helpers)
+ *   onCommit: (draft, rowId) => saveDraft(draft, rowId),
+ *   onDraftUpdate: (draft, rowId) => previewDraft(draft, rowId),
+ *   renderEditor: ({ controller }) => renderAddressEditor(controller)
  * }
  * ```
  */

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

@@ -53,6 +53,7 @@ export declare function SurfaceTrigger({ children }: SurfaceTriggerProps): React
  * @property {ReactNode} [title] - Header title used as the default accessible label.
  * @property {ReactNode} [headerContent] - Additional header actions rendered before the close button.
  * @property {RefObject<HTMLElement | null>} [initialFocusRef] - Element focused after the surface opens.
+ * @property {RefObject<HTMLElement | null>} [intersectionBoundaryRef] - Optional element that positioned content should intersect after placement or drag.
  * @property {number | string} [width] - Surface width as pixels or a CSS dimension.
  * @property {number | string} [maxHeight] - Maximum surface height as pixels or a CSS dimension.
  * @property {string} [closeButtonLabel] - Accessible label for the header close button.
@@ -65,6 +66,7 @@ export type SurfaceContentProps = Omit<ComponentPropsWithoutRef<"div">, "childre
     title?: ReactNode;
     headerContent?: ReactNode;
     initialFocusRef?: RefObject<HTMLElement | null>;
+    intersectionBoundaryRef?: RefObject<HTMLElement | null>;
     width?: number | string;
     maxHeight?: number | string;
     closeButtonLabel?: string;
@@ -87,6 +89,7 @@ export declare const SurfaceContent: import('react').ForwardRefExoticComponent<O
     title?: ReactNode;
     headerContent?: ReactNode;
     initialFocusRef?: RefObject<HTMLElement | null>;
+    intersectionBoundaryRef?: RefObject<HTMLElement | null>;
     width?: number | string;
     maxHeight?: number | string;
     closeButtonLabel?: string;
@@ -134,6 +137,7 @@ export declare const Surface: (({ children, open, id }: SurfaceProps) => import(
         title?: ReactNode;
         headerContent?: ReactNode;
         initialFocusRef?: RefObject<HTMLElement | null>;
+        intersectionBoundaryRef?: RefObject<HTMLElement | null>;
         width?: number | string;
         maxHeight?: number | string;
         closeButtonLabel?: string;

package/dist/src/internal/components/Surface/surfaceGeometry.d.ts

@@ -0,0 +1,31 @@
+export declare const SURFACE_VIEWPORT_PADDING = 8;
+export declare const SURFACE_MIN_WIDTH = 240;
+export declare const SURFACE_MIN_HEIGHT = 120;
+export type SurfaceGeometry = {
+    x: number;
+    y: number;
+    width: number;
+    height: number | null;
+    isUserModified: boolean;
+    hasUserResized: boolean;
+};
+export type SurfaceViewport = {
+    width: number;
+    height: number;
+};
+export type SurfaceRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type ClampSurfaceGeometryOptions = {
+    measuredHeight?: number;
+    intersectionBoundary?: SurfaceRect | null;
+};
+export declare function getMaxSurfaceWidth(viewport: SurfaceViewport, x: number): number;
+export declare function getMaxSurfaceHeight(viewport: SurfaceViewport, y: number): number;
+export declare function hasStrictRectIntersection(rect: SurfaceRect, boundary: SurfaceRect): boolean;
+export declare function clampSurfaceGeometry(geometry: SurfaceGeometry, viewport: SurfaceViewport, options?: ClampSurfaceGeometryOptions): SurfaceGeometry;
+export declare function clampActiveResizeSurfaceGeometry(geometry: SurfaceGeometry, viewport: SurfaceViewport): SurfaceGeometry;
+export declare function restoreSurfaceGeometryIntersection(geometry: SurfaceGeometry, viewport: SurfaceViewport, options?: ClampSurfaceGeometryOptions): SurfaceGeometry;

package/dist/{syncFilterUtils-DZqeVWTS.js → syncFilterUtils-CgHB-l6A.js}

@@ -5,7 +5,7 @@ import { c as cx } from './index-De1g9FRV.js';
 import { useState, useRef, useCallback, useEffect, useMemo, forwardRef, useId, useImperativeHandle } from 'react';
 import { u as useIntersectionObserver } from './useIntersectionObserver-BEmMDO3P.js';
 import { T as Text } from './Text-w2gWn4K6.js';
-import { D as Divider } from './Divider-CxtTyw8_.js';
+import { D as Divider } from './Divider-Dz27DFuE.js';
 import { u as useMergeRefs } from './useMergeRefs-Dfmtq9cI.js';
 import { S as SrOnly } from './SrOnly-pnf8ajnh.js';
 import { I as Icon } from './Icon-feeG7gXA.js';
@@ -1238,4 +1238,4 @@ const sortByGroup = (options, groupSorter) => {
 };
 
 export { AddNewItemButton as A, OptionsPanel as O, VirtualizedOptionsPanel as V, useProcessedOptions as a, buildSelectItems as b, useDebouncedCallback as c, defaultSyncFilter as d, toSelectItem as e, sortByGroup as s, toSyncFilterFn as t, useSelectOrchestration as u };
-//# sourceMappingURL=syncFilterUtils-DZqeVWTS.js.map
+//# sourceMappingURL=syncFilterUtils-CgHB-l6A.js.map