@affino/datagrid-orchestration 0.1.0

package/dist/src/useDataGridColumnUiPolicy.js

@@ -0,0 +1,55 @@
+export function useDataGridColumnUiPolicy(options) {
+    const selectColumnKey = options.selectColumnKey ?? "select";
+    const selectColumnMinWidth = options.selectColumnMinWidth ?? 48;
+    const selectColumnDefaultWidth = options.selectColumnDefaultWidth ?? 58;
+    const defaultColumnMinWidth = options.defaultColumnMinWidth ?? 110;
+    const defaultColumnWidth = options.defaultColumnWidth ?? 160;
+    function isGroupedByColumn(columnKey) {
+        const groupBy = options.resolveCurrentGroupBy();
+        return groupBy !== "none" && Boolean(groupBy) && columnKey === groupBy;
+    }
+    function isSortableColumn(columnKey) {
+        return columnKey !== selectColumnKey;
+    }
+    function isColumnResizable(columnKey) {
+        return columnKey !== selectColumnKey;
+    }
+    function resolveColumnFilterKind(columnKey) {
+        if (options.isEnumColumn(columnKey)) {
+            return "enum";
+        }
+        if (options.numericColumnKeys.has(columnKey)) {
+            return "number";
+        }
+        return "text";
+    }
+    function resolveEnumFilterOptions(columnKey) {
+        const editorOptions = options.resolveEnumEditorOptions(columnKey);
+        if (editorOptions && editorOptions.length) {
+            return [...editorOptions];
+        }
+        const values = new Set();
+        for (const row of options.resolveRows()) {
+            const value = options.resolveCellValue(row, columnKey);
+            if (value === null || typeof value === "undefined") {
+                continue;
+            }
+            values.add(String(value));
+        }
+        return [...values].sort((left, right) => left.localeCompare(right));
+    }
+    function resolveColumnWidth(column) {
+        if (column.key === selectColumnKey) {
+            return Math.max(selectColumnMinWidth, column.width ?? selectColumnDefaultWidth);
+        }
+        return Math.max(defaultColumnMinWidth, column.width ?? defaultColumnWidth);
+    }
+    return {
+        isGroupedByColumn,
+        isSortableColumn,
+        isColumnResizable,
+        resolveColumnFilterKind,
+        resolveEnumFilterOptions,
+        resolveColumnWidth,
+    };
+}

package/dist/src/useDataGridContextMenu.d.ts

@@ -0,0 +1,30 @@
+import type { DataGridContextMenuAction, DataGridContextMenuState, OpenDataGridContextMenuInput } from "./dataGridContextMenuContracts";
+export interface UseDataGridContextMenuOptions {
+    isColumnResizable?: (columnKey: string) => boolean;
+    onBeforeOpen?: () => void;
+}
+export interface DataGridContextMenuKeyboardIntentInput {
+    key: string;
+    activeIndex: number;
+    itemCount: number;
+    shiftKey?: boolean;
+}
+export interface DataGridContextMenuKeyboardIntentResult {
+    handled: boolean;
+    nextIndex: number;
+    shouldTrigger: boolean;
+    shouldClose: boolean;
+}
+export interface DataGridContextMenuSnapshot {
+    contextMenu: DataGridContextMenuState;
+    actions: readonly DataGridContextMenuAction[];
+}
+export interface UseDataGridContextMenuResult {
+    getSnapshot: () => DataGridContextMenuSnapshot;
+    subscribe: (listener: (snapshot: DataGridContextMenuSnapshot) => void) => () => void;
+    closeContextMenu: () => void;
+    openContextMenu: (clientX: number, clientY: number, context: OpenDataGridContextMenuInput) => void;
+}
+export declare function resolveDataGridContextMenuKeyboardIntent(input: DataGridContextMenuKeyboardIntentInput): DataGridContextMenuKeyboardIntentResult;
+export declare function useDataGridContextMenu(options?: UseDataGridContextMenuOptions): UseDataGridContextMenuResult;
+//# sourceMappingURL=useDataGridContextMenu.d.ts.map

package/dist/src/useDataGridContextMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridContextMenu.d.ts","sourceRoot":"","sources":["../../src/useDataGridContextMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,gCAAgC,CAAA;AAEvC,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;IAClD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,sCAAsC;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,wBAAwB,CAAA;IACrC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,2BAA2B,CAAA;IAC9C,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,2BAA2B,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IACpF,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAA;CACnG;AAuDD,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,sCAAsC,GAC5C,uCAAuC,CA+CzC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,4BAA4B,CA6D9B"}

package/dist/src/useDataGridContextMenu.js

@@ -0,0 +1,147 @@
+const DEFAULT_CONTEXT_MENU_STATE = {
+    visible: false,
+    x: 0,
+    y: 0,
+    zone: "cell",
+    columnKey: null,
+    rowId: null,
+};
+function createDefaultState() {
+    return { ...DEFAULT_CONTEXT_MENU_STATE };
+}
+function clamp(value, min, max) {
+    if (!Number.isFinite(value)) {
+        return min;
+    }
+    if (max <= min) {
+        return min;
+    }
+    return Math.max(min, Math.min(max, value));
+}
+function resolveContextMenuActions(contextMenu, isColumnResizable) {
+    if (!contextMenu.visible) {
+        return [];
+    }
+    if (contextMenu.zone === "header") {
+        const actions = [
+            { id: "sort-asc", label: "Sort ascending" },
+            { id: "sort-desc", label: "Sort descending" },
+            { id: "sort-clear", label: "Clear sort" },
+            { id: "filter", label: "Filter column" },
+        ];
+        const canResize = typeof contextMenu.columnKey === "string" &&
+            contextMenu.columnKey.length > 0 &&
+            (isColumnResizable?.(contextMenu.columnKey) ?? false);
+        if (canResize) {
+            actions.push({ id: "auto-size", label: "Auto size column" });
+        }
+        return actions;
+    }
+    return [
+        { id: "cut", label: "Cut" },
+        { id: "paste", label: "Paste" },
+        { id: "copy", label: "Copy" },
+        { id: "clear", label: "Clear values" },
+    ];
+}
+export function resolveDataGridContextMenuKeyboardIntent(input) {
+    const count = input.itemCount;
+    if (count <= 0) {
+        return { handled: false, nextIndex: -1, shouldTrigger: false, shouldClose: false };
+    }
+    const normalizedIndex = input.activeIndex >= 0 ? input.activeIndex : 0;
+    if (input.key === "ArrowDown") {
+        return {
+            handled: true,
+            nextIndex: (normalizedIndex + 1) % count,
+            shouldTrigger: false,
+            shouldClose: false,
+        };
+    }
+    if (input.key === "ArrowUp") {
+        return {
+            handled: true,
+            nextIndex: (normalizedIndex - 1 + count) % count,
+            shouldTrigger: false,
+            shouldClose: false,
+        };
+    }
+    if (input.key === "Home") {
+        return { handled: true, nextIndex: 0, shouldTrigger: false, shouldClose: false };
+    }
+    if (input.key === "End") {
+        return { handled: true, nextIndex: count - 1, shouldTrigger: false, shouldClose: false };
+    }
+    if (input.key === "Enter" || input.key === " ") {
+        return { handled: true, nextIndex: normalizedIndex, shouldTrigger: true, shouldClose: false };
+    }
+    if (input.key === "Escape") {
+        return { handled: true, nextIndex: normalizedIndex, shouldTrigger: false, shouldClose: true };
+    }
+    if (input.key === "Tab") {
+        return {
+            handled: true,
+            nextIndex: input.shiftKey
+                ? (normalizedIndex <= 0 ? count - 1 : normalizedIndex - 1)
+                : (normalizedIndex + 1) % count,
+            shouldTrigger: false,
+            shouldClose: false,
+        };
+    }
+    return { handled: false, nextIndex: normalizedIndex, shouldTrigger: false, shouldClose: false };
+}
+export function useDataGridContextMenu(options = {}) {
+    let contextMenu = createDefaultState();
+    const listeners = new Set();
+    function createSnapshot() {
+        return {
+            contextMenu,
+            actions: resolveContextMenuActions(contextMenu, options.isColumnResizable),
+        };
+    }
+    function emit() {
+        const snapshot = createSnapshot();
+        listeners.forEach(listener => listener(snapshot));
+    }
+    function subscribe(listener) {
+        listeners.add(listener);
+        listener(createSnapshot());
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    function closeContextMenu() {
+        contextMenu = createDefaultState();
+        emit();
+    }
+    function openContextMenu(clientX, clientY, context) {
+        options.onBeforeOpen?.();
+        const baseState = {
+            visible: true,
+            x: 0,
+            y: 0,
+            zone: context.zone,
+            columnKey: context.columnKey ?? null,
+            rowId: context.rowId ?? null,
+        };
+        const actionCount = resolveContextMenuActions(baseState, options.isColumnResizable).length;
+        const estimatedMenuWidth = 240;
+        const estimatedMenuHeight = Math.max(56, actionCount * 36 + 12);
+        const viewportWidth = typeof window !== "undefined" ? window.innerWidth : clientX + estimatedMenuWidth + 16;
+        const viewportHeight = typeof window !== "undefined" ? window.innerHeight : clientY + estimatedMenuHeight + 16;
+        const maxX = Math.max(8, viewportWidth - estimatedMenuWidth - 8);
+        const maxY = Math.max(8, viewportHeight - estimatedMenuHeight - 8);
+        contextMenu = {
+            ...baseState,
+            x: clamp(clientX, 8, maxX),
+            y: clamp(clientY, 8, maxY),
+        };
+        emit();
+    }
+    return {
+        getSnapshot: createSnapshot,
+        subscribe,
+        closeContextMenu,
+        openContextMenu,
+    };
+}

package/dist/src/useDataGridContextMenuActionRouter.d.ts

@@ -0,0 +1,19 @@
+import type { DataGridContextMenuActionId, DataGridContextMenuZone } from "./dataGridContextMenuContracts";
+export interface DataGridContextMenuActionRouterState {
+    zone: DataGridContextMenuZone;
+    columnKey: string | null;
+}
+export interface UseDataGridContextMenuActionRouterOptions {
+    resolveContextMenuState: () => DataGridContextMenuActionRouterState;
+    runHeaderContextAction: (action: DataGridContextMenuActionId, columnKey: string) => boolean;
+    copySelection: (trigger: "context-menu") => Promise<boolean>;
+    pasteSelection: (trigger: "context-menu") => Promise<boolean>;
+    cutSelection: (trigger: "context-menu") => Promise<boolean>;
+    clearCurrentSelection: (trigger: "context-menu") => Promise<boolean>;
+    closeContextMenu: () => void;
+}
+export interface UseDataGridContextMenuActionRouterResult {
+    runContextMenuAction: (action: DataGridContextMenuActionId) => Promise<boolean>;
+}
+export declare function useDataGridContextMenuActionRouter(options: UseDataGridContextMenuActionRouterOptions): UseDataGridContextMenuActionRouterResult;
+//# sourceMappingURL=useDataGridContextMenuActionRouter.d.ts.map

package/dist/src/useDataGridContextMenuActionRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridContextMenuActionRouter.d.ts","sourceRoot":"","sources":["../../src/useDataGridContextMenuActionRouter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,gCAAgC,CAAA;AAEvC,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE,uBAAuB,CAAA;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,yCAAyC;IACxD,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;IACnE,sBAAsB,EAAE,CAAC,MAAM,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;IAC3F,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5D,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,YAAY,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,qBAAqB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,gBAAgB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,wCAAwC;IACvD,oBAAoB,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAChF;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,yCAAyC,GACjD,wCAAwC,CA+B1C"}

package/dist/src/useDataGridContextMenuActionRouter.js

@@ -0,0 +1,29 @@
+export function useDataGridContextMenuActionRouter(options) {
+    async function runContextMenuAction(action) {
+        const context = options.resolveContextMenuState();
+        if (context.zone === "header") {
+            if (!context.columnKey) {
+                options.closeContextMenu();
+                return false;
+            }
+            return options.runHeaderContextAction(action, context.columnKey);
+        }
+        if (action === "copy") {
+            return options.copySelection("context-menu");
+        }
+        if (action === "paste") {
+            return options.pasteSelection("context-menu");
+        }
+        if (action === "cut") {
+            return options.cutSelection("context-menu");
+        }
+        if (action === "clear") {
+            return options.clearCurrentSelection("context-menu");
+        }
+        options.closeContextMenu();
+        return false;
+    }
+    return {
+        runContextMenuAction,
+    };
+}

package/dist/src/useDataGridContextMenuAnchor.d.ts

@@ -0,0 +1,33 @@
+import type { OpenDataGridContextMenuInput } from "./dataGridContextMenuContracts";
+export interface DataGridContextMenuAnchorCellCoord {
+    rowIndex: number;
+    columnIndex: number;
+}
+export interface DataGridContextMenuAnchorRange {
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export interface DataGridContextMenuAnchorRowIdentity {
+    rowId: string | number;
+}
+export interface DataGridContextMenuAnchorColumnIdentity {
+    key: string;
+}
+export interface UseDataGridContextMenuAnchorOptions<TRow extends DataGridContextMenuAnchorRowIdentity = DataGridContextMenuAnchorRowIdentity, TColumn extends DataGridContextMenuAnchorColumnIdentity = DataGridContextMenuAnchorColumnIdentity, TCoord extends DataGridContextMenuAnchorCellCoord = DataGridContextMenuAnchorCellCoord, TRange extends DataGridContextMenuAnchorRange = DataGridContextMenuAnchorRange> {
+    resolveCurrentCellCoord: () => TCoord | null;
+    resolveViewportElement: () => HTMLElement | null;
+    resolveRowAtIndex: (rowIndex: number) => TRow | undefined;
+    resolveColumnAtIndex: (columnIndex: number) => TColumn | undefined;
+    resolveSelectionRange: () => TRange | null;
+    isMultiCellSelection: (range: TRange) => boolean;
+    isCoordInsideRange: (coord: TCoord, range: TRange) => boolean;
+    openContextMenu: (clientX: number, clientY: number, context: OpenDataGridContextMenuInput) => void;
+    isColumnContextEnabled?: (column: TColumn) => boolean;
+}
+export interface UseDataGridContextMenuAnchorResult {
+    openContextMenuFromCurrentCell: () => boolean;
+}
+export declare function useDataGridContextMenuAnchor<TRow extends DataGridContextMenuAnchorRowIdentity = DataGridContextMenuAnchorRowIdentity, TColumn extends DataGridContextMenuAnchorColumnIdentity = DataGridContextMenuAnchorColumnIdentity, TCoord extends DataGridContextMenuAnchorCellCoord = DataGridContextMenuAnchorCellCoord, TRange extends DataGridContextMenuAnchorRange = DataGridContextMenuAnchorRange>(options: UseDataGridContextMenuAnchorOptions<TRow, TColumn, TCoord, TRange>): UseDataGridContextMenuAnchorResult;
+//# sourceMappingURL=useDataGridContextMenuAnchor.d.ts.map

package/dist/src/useDataGridContextMenuAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridContextMenuAnchor.d.ts","sourceRoot":"","sources":["../../src/useDataGridContextMenuAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,gCAAgC,CAAA;AAEvC,MAAM,WAAW,kCAAkC;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,oCAAoC;IACnD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,uCAAuC;IACtD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,mCAAmC,CAClD,IAAI,SAAS,oCAAoC,GAAG,oCAAoC,EACxF,OAAO,SAAS,uCAAuC,GAAG,uCAAuC,EACjG,MAAM,SAAS,kCAAkC,GAAG,kCAAkC,EACtF,MAAM,SAAS,8BAA8B,GAAG,8BAA8B;IAE9E,uBAAuB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC5C,sBAAsB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IAChD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAA;IACzD,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;IAClE,qBAAqB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC1C,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAChD,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAC7D,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,KAAK,IAAI,CAAA;IAClG,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CACtD;AAED,MAAM,WAAW,kCAAkC;IACjD,8BAA8B,EAAE,MAAM,OAAO,CAAA;CAC9C;AA6BD,wBAAgB,4BAA4B,CAC1C,IAAI,SAAS,oCAAoC,GAAG,oCAAoC,EACxF,OAAO,SAAS,uCAAuC,GAAG,uCAAuC,EACjG,MAAM,SAAS,kCAAkC,GAAG,kCAAkC,EACtF,MAAM,SAAS,8BAA8B,GAAG,8BAA8B,EAE9E,OAAO,EAAE,mCAAmC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAC1E,kCAAkC,CAwCpC"}

package/dist/src/useDataGridContextMenuAnchor.js

@@ -0,0 +1,60 @@
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function escapeCssAttributeValue(value) {
+    if (typeof CSS !== "undefined" && typeof CSS.escape === "function") {
+        return CSS.escape(value);
+    }
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function resolveCellAnchorPoint(viewport, selector) {
+    const element = viewport.querySelector(selector);
+    if (element) {
+        const rect = element.getBoundingClientRect();
+        return {
+            x: rect.left + clamp(rect.width * 0.5, 10, Math.max(10, rect.width - 10)),
+            y: rect.bottom - 4,
+        };
+    }
+    const viewportRect = viewport.getBoundingClientRect();
+    return {
+        x: viewportRect.left + clamp(viewportRect.width * 0.3, 10, Math.max(10, viewportRect.width - 10)),
+        y: viewportRect.top + clamp(viewportRect.height * 0.4, 10, Math.max(10, viewportRect.height - 10)),
+    };
+}
+export function useDataGridContextMenuAnchor(options) {
+    function openContextMenuFromCurrentCell() {
+        const current = options.resolveCurrentCellCoord();
+        const viewport = options.resolveViewportElement();
+        if (!current || !viewport) {
+            return false;
+        }
+        const row = options.resolveRowAtIndex(current.rowIndex);
+        const column = options.resolveColumnAtIndex(current.columnIndex);
+        if (!row || !column) {
+            return false;
+        }
+        if (!(options.isColumnContextEnabled?.(column) ?? column.key !== "select")) {
+            return false;
+        }
+        const rowId = String(row.rowId);
+        const columnKey = column.key;
+        const selector = `.datagrid-stage__cell[data-row-id="${escapeCssAttributeValue(rowId)}"][data-column-key="${escapeCssAttributeValue(columnKey)}"]`;
+        const anchor = resolveCellAnchorPoint(viewport, selector);
+        const range = options.resolveSelectionRange();
+        const zone = range &&
+            options.isMultiCellSelection(range) &&
+            options.isCoordInsideRange(current, range)
+            ? "range"
+            : "cell";
+        options.openContextMenu(anchor.x, anchor.y, {
+            zone,
+            columnKey,
+            rowId,
+        });
+        return true;
+    }
+    return {
+        openContextMenuFromCurrentCell,
+    };
+}

package/dist/src/useDataGridCopyRangeHelpers.d.ts

@@ -0,0 +1,20 @@
+export interface DataGridCopyRangeCoord {
+    rowIndex: number;
+    columnIndex: number;
+}
+export interface DataGridCopyRange {
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export interface UseDataGridCopyRangeHelpersOptions<TCoord extends DataGridCopyRangeCoord = DataGridCopyRangeCoord, TRange extends DataGridCopyRange = DataGridCopyRange> {
+    resolveSelectionRange: () => TRange | null;
+    resolveCurrentCellCoord: () => TCoord | null;
+}
+export interface UseDataGridCopyRangeHelpersResult<TRange extends DataGridCopyRange = DataGridCopyRange> {
+    isMultiCellSelection: (range: TRange | null) => boolean;
+    resolveCopyRange: () => TRange | null;
+}
+export declare function useDataGridCopyRangeHelpers<TCoord extends DataGridCopyRangeCoord = DataGridCopyRangeCoord, TRange extends DataGridCopyRange = DataGridCopyRange>(options: UseDataGridCopyRangeHelpersOptions<TCoord, TRange>): UseDataGridCopyRangeHelpersResult<TRange>;
+//# sourceMappingURL=useDataGridCopyRangeHelpers.d.ts.map

package/dist/src/useDataGridCopyRangeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridCopyRangeHelpers.d.ts","sourceRoot":"","sources":["../../src/useDataGridCopyRangeHelpers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kCAAkC,CACjD,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,MAAM,SAAS,iBAAiB,GAAG,iBAAiB;IAEpD,qBAAqB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IAC1C,uBAAuB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAC7C;AAED,MAAM,WAAW,iCAAiC,CAChD,MAAM,SAAS,iBAAiB,GAAG,iBAAiB;IAEpD,oBAAoB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IACvD,gBAAgB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CACtC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,EAEpD,OAAO,EAAE,kCAAkC,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1D,iCAAiC,CAAC,MAAM,CAAC,CA6B3C"}

package/dist/src/useDataGridCopyRangeHelpers.js

@@ -0,0 +1,28 @@
+export function useDataGridCopyRangeHelpers(options) {
+    function isMultiCellSelection(range) {
+        if (!range) {
+            return false;
+        }
+        return range.startRow !== range.endRow || range.startColumn !== range.endColumn;
+    }
+    function resolveCopyRange() {
+        const selected = options.resolveSelectionRange();
+        if (selected) {
+            return selected;
+        }
+        const current = options.resolveCurrentCellCoord();
+        if (!current) {
+            return null;
+        }
+        return {
+            startRow: current.rowIndex,
+            endRow: current.rowIndex,
+            startColumn: current.columnIndex,
+            endColumn: current.columnIndex,
+        };
+    }
+    return {
+        isMultiCellSelection,
+        resolveCopyRange,
+    };
+}

package/dist/src/useDataGridDragPointerSelection.d.ts

@@ -0,0 +1,22 @@
+export interface DataGridDragPointerSelectionCoord {
+    rowIndex: number;
+    columnIndex: number;
+}
+export interface DataGridDragPointerSelectionCoordinates {
+    clientX: number;
+    clientY: number;
+}
+export interface UseDataGridDragPointerSelectionOptions<TCoord extends DataGridDragPointerSelectionCoord> {
+    isDragSelecting: () => boolean;
+    resolveDragPointer: () => DataGridDragPointerSelectionCoordinates | null;
+    resolveCellCoordFromPointer: (clientX: number, clientY: number) => TCoord | null;
+    resolveLastDragCoord: () => TCoord | null;
+    setLastDragCoord: (coord: TCoord) => void;
+    cellCoordsEqual: (a: TCoord | null, b: TCoord | null) => boolean;
+    applyCellSelection: (coord: TCoord, extend: boolean, fallbackAnchor?: TCoord, ensureVisible?: boolean) => void;
+}
+export interface UseDataGridDragPointerSelectionResult {
+    applyDragSelectionFromPointer: () => void;
+}
+export declare function useDataGridDragPointerSelection<TCoord extends DataGridDragPointerSelectionCoord>(options: UseDataGridDragPointerSelectionOptions<TCoord>): UseDataGridDragPointerSelectionResult;
+//# sourceMappingURL=useDataGridDragPointerSelection.d.ts.map

package/dist/src/useDataGridDragPointerSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridDragPointerSelection.d.ts","sourceRoot":"","sources":["../../src/useDataGridDragPointerSelection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sCAAsC,CAAC,MAAM,SAAS,iCAAiC;IACtG,eAAe,EAAE,MAAM,OAAO,CAAA;IAC9B,kBAAkB,EAAE,MAAM,uCAAuC,GAAG,IAAI,CAAA;IACxE,2BAA2B,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IAChF,oBAAoB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;IACzC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IAChE,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAC/G;AAED,MAAM,WAAW,qCAAqC;IACpD,6BAA6B,EAAE,MAAM,IAAI,CAAA;CAC1C;AAED,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,iCAAiC,EAC9F,OAAO,EAAE,sCAAsC,CAAC,MAAM,CAAC,GACtD,qCAAqC,CAuBvC"}

package/dist/src/useDataGridDragPointerSelection.js

@@ -0,0 +1,23 @@
+export function useDataGridDragPointerSelection(options) {
+    function applyDragSelectionFromPointer() {
+        if (!options.isDragSelecting()) {
+            return;
+        }
+        const pointer = options.resolveDragPointer();
+        if (!pointer) {
+            return;
+        }
+        const coord = options.resolveCellCoordFromPointer(pointer.clientX, pointer.clientY);
+        if (!coord) {
+            return;
+        }
+        if (options.cellCoordsEqual(options.resolveLastDragCoord(), coord)) {
+            return;
+        }
+        options.setLastDragCoord(coord);
+        options.applyCellSelection(coord, true, undefined, false);
+    }
+    return {
+        applyDragSelectionFromPointer,
+    };
+}

package/dist/src/useDataGridDragSelectionLifecycle.d.ts

@@ -0,0 +1,18 @@
+export interface UseDataGridDragSelectionLifecycleOptions<TCoord = {
+    rowIndex: number;
+    columnIndex: number;
+}> {
+    setDragSelecting: (value: boolean) => void;
+    clearDragPointer: () => void;
+    clearLastDragCoord: () => void;
+    stopAutoScrollFrameIfIdle: () => void;
+    resolveLastDragCoord?: () => TCoord | null;
+}
+export interface UseDataGridDragSelectionLifecycleResult {
+    stopDragSelection: () => void;
+}
+export declare function useDataGridDragSelectionLifecycle<TCoord = {
+    rowIndex: number;
+    columnIndex: number;
+}>(options: UseDataGridDragSelectionLifecycleOptions<TCoord>): UseDataGridDragSelectionLifecycleResult;
+//# sourceMappingURL=useDataGridDragSelectionLifecycle.d.ts.map

package/dist/src/useDataGridDragSelectionLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridDragSelectionLifecycle.d.ts","sourceRoot":"","sources":["../../src/useDataGridDragSelectionLifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wCAAwC,CAAC,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;IAC1G,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC1C,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,kBAAkB,EAAE,MAAM,IAAI,CAAA;IAC9B,yBAAyB,EAAE,MAAM,IAAI,CAAA;IACrC,oBAAoB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,uCAAuC;IACtD,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAClG,OAAO,EAAE,wCAAwC,CAAC,MAAM,CAAC,GACxD,uCAAuC,CAWzC"}

package/dist/src/useDataGridDragSelectionLifecycle.js

@@ -0,0 +1,11 @@
+export function useDataGridDragSelectionLifecycle(options) {
+    function stopDragSelection() {
+        options.setDragSelecting(false);
+        options.clearDragPointer();
+        options.clearLastDragCoord();
+        options.stopAutoScrollFrameIfIdle();
+    }
+    return {
+        stopDragSelection,
+    };
+}

package/dist/src/useDataGridEditableValuePolicy.d.ts

@@ -0,0 +1,32 @@
+export type DataGridEditableValueStrategy<TRow> = {
+    kind: "text";
+    apply: (row: TRow, draft: string) => void;
+    canPaste?: (draft: string) => boolean;
+    clearable?: boolean;
+    clear?: (row: TRow) => boolean;
+} | {
+    kind: "enum";
+    isAllowed: (draft: string) => boolean;
+    apply: (row: TRow, draft: string) => void;
+    clearable?: boolean;
+    clear?: (row: TRow) => boolean;
+} | {
+    kind: "number";
+    parse?: (draft: string) => number | null;
+    apply: (row: TRow, numericValue: number) => void;
+    clearable?: boolean;
+    clear?: (row: TRow) => boolean;
+};
+export interface UseDataGridEditableValuePolicyOptions<TRow, TColumnKey extends string> {
+    strategies: Readonly<Record<TColumnKey, DataGridEditableValueStrategy<TRow>>>;
+    defaultClearable?: boolean;
+}
+export interface UseDataGridEditableValuePolicyResult<TRow, TColumnKey extends string> {
+    hasEditablePolicy: (columnKey: string) => columnKey is TColumnKey;
+    applyEditedValue: (row: TRow, columnKey: TColumnKey, draft: string) => void;
+    canApplyPastedValue: (columnKey: TColumnKey, draft: string) => boolean;
+    isColumnClearableForCut: (columnKey: TColumnKey) => boolean;
+    clearEditedValue: (row: TRow, columnKey: TColumnKey) => boolean;
+}
+export declare function useDataGridEditableValuePolicy<TRow, TColumnKey extends string>(options: UseDataGridEditableValuePolicyOptions<TRow, TColumnKey>): UseDataGridEditableValuePolicyResult<TRow, TColumnKey>;
+//# sourceMappingURL=useDataGridEditableValuePolicy.d.ts.map

package/dist/src/useDataGridEditableValuePolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataGridEditableValuePolicy.d.ts","sourceRoot":"","sources":["../../src/useDataGridEditableValuePolicy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,6BAA6B,CAAC,IAAI,IAC1C;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACrC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACrC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAA;CAC/B,GACD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACxC,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAA;CAC/B,CAAA;AAEL,MAAM,WAAW,qCAAqC,CAAC,IAAI,EAAE,UAAU,SAAS,MAAM;IACpF,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,oCAAoC,CAAC,IAAI,EAAE,UAAU,SAAS,MAAM;IACnF,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,IAAI,UAAU,CAAA;IACjE,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3E,mBAAmB,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACtE,uBAAuB,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAA;IAC3D,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,KAAK,OAAO,CAAA;CAChE;AAOD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,UAAU,SAAS,MAAM,EAC5E,OAAO,EAAE,qCAAqC,CAAC,IAAI,EAAE,UAAU,CAAC,GAC/D,oCAAoC,CAAC,IAAI,EAAE,UAAU,CAAC,CAiGxD"}