@tablecraft/table 0.1.0

package/dist/toolbar.d.ts

@@ -0,0 +1,35 @@
+import type { Table } from "@tanstack/react-table";
+import type { TableConfig, ExportConfig, ExportableData } from "./types";
+interface DataTableToolbarProps<TData extends ExportableData> {
+    table: Table<TData>;
+    search: string;
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    setSearch: (value: string | ((prev: string) => string)) => void;
+    setDateRange: (value: {
+        from: string;
+        to: string;
+    } | ((prev: {
+        from: string;
+        to: string;
+    }) => {
+        from: string;
+        to: string;
+    })) => void;
+    totalSelectedItems: number;
+    clearSelection: () => void;
+    getSelectedItems?: () => Promise<TData[]>;
+    getAllItems: () => TData[];
+    config: TableConfig;
+    exportConfig?: ExportConfig<TData>;
+    resetColumnSizing?: () => void;
+    resetColumnOrder?: () => void;
+    columnMapping?: Record<string, string>;
+    customToolbarContent?: React.ReactNode;
+    startToolbarContent?: React.ReactNode;
+}
+export declare function DataTableToolbar<TData extends ExportableData>({ table, search, dateRange, setSearch, setDateRange, totalSelectedItems, clearSelection, getSelectedItems, getAllItems, config, exportConfig, resetColumnSizing, resetColumnOrder, columnMapping, customToolbarContent, startToolbarContent, }: DataTableToolbarProps<TData>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../src/toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAmCzE,UAAU,qBAAqB,CAAC,KAAK,SAAS,cAAc;IAC1D,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC;IAChE,YAAY,EAAE,CACZ,KAAK,EACD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAC5B,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,KACvE,IAAI,CAAC;IACV,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C,WAAW,EAAE,MAAM,KAAK,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvC,mBAAmB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAAE,EAC7D,KAAK,EACL,MAAM,EACN,SAAS,EACT,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,GACpB,EAAE,qBAAqB,CAAC,KAAK,CAAC,2CA+P9B"}

package/dist/toolbar.js

@@ -0,0 +1,119 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState, useRef } from "react";
+import { X, Settings, Undo2, CheckSquare, MoveHorizontal, EyeOff, Search } from "lucide-react";
+import { DataTableViewOptions } from "./view-options";
+import { DataTableExport } from "./export";
+import { Popover, PopoverContent, PopoverTrigger, } from "./components/popover";
+import { CalendarDatePicker } from "./components/calendar-date-picker";
+import { resetUrlState } from "./utils/deep-utils";
+import { cn } from "./utils/cn";
+const getInputSizeClass = (size) => {
+    switch (size) {
+        case "sm": return "h-8";
+        case "lg": return "h-10";
+        default: return "h-9";
+    }
+};
+const getButtonSizeClass = (size, isIcon = false) => {
+    if (isIcon) {
+        switch (size) {
+            case "sm": return "h-8 w-8 p-0";
+            case "lg": return "h-10 w-10 p-0";
+            default: return "h-9 w-9 p-0";
+        }
+    }
+    switch (size) {
+        case "sm": return "h-8 px-3";
+        case "lg": return "h-10 px-4";
+        default: return "h-9 px-3";
+    }
+};
+export function DataTableToolbar({ table, search, dateRange, setSearch, setDateRange, totalSelectedItems, clearSelection, getSelectedItems, getAllItems, config, exportConfig, resetColumnSizing, resetColumnOrder, columnMapping, customToolbarContent, startToolbarContent, }) {
+    const entityName = exportConfig?.entityName || "items";
+    // Local debounced search
+    const [localSearch, setLocalSearch] = useState(search);
+    const isLocallyUpdating = useRef(false);
+    const searchTimerRef = useRef(null);
+    useEffect(() => {
+        if (isLocallyUpdating.current)
+            return;
+        if (search !== localSearch)
+            setLocalSearch(search);
+    }, [search, localSearch]);
+    useEffect(() => {
+        return () => {
+            if (searchTimerRef.current)
+                clearTimeout(searchTimerRef.current);
+        };
+    }, []);
+    const handleSearchChange = (e) => {
+        const value = e.target.value;
+        isLocallyUpdating.current = true;
+        setLocalSearch(value);
+        if (searchTimerRef.current)
+            clearTimeout(searchTimerRef.current);
+        searchTimerRef.current = setTimeout(() => {
+            setSearch(value.trim());
+            searchTimerRef.current = null;
+            setTimeout(() => {
+                isLocallyUpdating.current = false;
+            }, 100);
+        }, 500);
+    };
+    // Date filter state
+    const parseDateFromUrl = (dateStr) => {
+        if (!dateStr)
+            return undefined;
+        const date = new Date(dateStr);
+        return isNaN(date.getTime()) ? undefined : date;
+    };
+    const [dates, setDates] = useState({
+        from: parseDateFromUrl(dateRange.from),
+        to: parseDateFromUrl(dateRange.to),
+    });
+    useEffect(() => {
+        setDates({
+            from: parseDateFromUrl(dateRange.from),
+            to: parseDateFromUrl(dateRange.to),
+        });
+    }, [dateRange.from, dateRange.to]);
+    const datesModified = !!dateRange.from || !!dateRange.to;
+    const tableFiltered = table.getState().columnFilters.length > 0;
+    const isFiltered = tableFiltered || !!localSearch || datesModified;
+    const handleResetFilters = () => {
+        table.resetColumnFilters();
+        if (searchTimerRef.current) {
+            clearTimeout(searchTimerRef.current);
+            searchTimerRef.current = null;
+        }
+        isLocallyUpdating.current = false;
+        setLocalSearch("");
+        setSearch("");
+        setDates({ from: undefined, to: undefined });
+        setDateRange({ from: "", to: "" });
+        if (config.enableUrlState)
+            resetUrlState();
+    };
+    const allItems = getAllItems();
+    return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-2", children: [_jsxs("div", { className: "flex flex-1 flex-wrap items-center gap-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [config.enableSearch && (_jsxs("div", { className: "relative", children: [_jsx(Search, { className: "absolute left-2.5 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { placeholder: config.searchPlaceholder || `Search ${entityName}...`, value: localSearch, onChange: handleSearchChange, className: cn("w-[150px] lg:w-[250px] rounded-md border border-input bg-background pl-9 pr-3 text-sm", "placeholder:text-muted-foreground", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "transition-colors", getInputSizeClass(config.size)) })] })), startToolbarContent, config.enableDateFilter && (_jsx(CalendarDatePicker, { date: {
+                                    from: dates.from,
+                                    to: dates.to,
+                                }, onDateSelect: (range) => {
+                                    setDates({ from: range.from, to: range.to });
+                                    setDateRange({
+                                        from: range.from.toISOString(),
+                                        to: range.to.toISOString(),
+                                    });
+                                }, variant: "outline", className: getInputSizeClass(config.size) }))] }), isFiltered && (_jsxs("button", { onClick: handleResetFilters, className: cn(getButtonSizeClass(config.size), "inline-flex items-center justify-center rounded-md text-sm font-medium", "hover:bg-accent hover:text-accent-foreground transition-colors", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "cursor-pointer"), children: ["Reset", _jsx(X, { className: "ml-2 h-4 w-4" })] }))] }), _jsxs("div", { className: "flex items-center gap-2", children: [customToolbarContent, config.enableExport && (_jsx(DataTableExport, { table: table, data: allItems, selectedCount: totalSelectedItems, getSelectedItems: getSelectedItems, exportConfig: exportConfig, tableConfig: config })), config.enableColumnVisibility && (_jsx(DataTableViewOptions, { table: table, columnMapping: columnMapping, size: config.size })), _jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { className: cn(getButtonSizeClass(config.size, true), "inline-flex items-center justify-center rounded-md border border-input bg-background", "hover:bg-accent hover:text-accent-foreground transition-colors", "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", "cursor-pointer"), title: "Table Settings", children: [_jsx(Settings, { className: "h-4 w-4" }), _jsx("span", { className: "sr-only", children: "Open table settings" })] }) }), _jsx(PopoverContent, { className: "w-60", align: "end", children: _jsxs("div", { className: "grid gap-4", children: [_jsx("div", { className: "space-y-2", children: _jsx("h4", { className: "font-medium leading-none", children: "Table Settings" }) }), _jsxs("div", { className: "grid gap-2", children: [config.enableColumnResizing && resetColumnSizing && (_jsxs("button", { className: cn("inline-flex items-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50", "border border-input bg-background hover:bg-accent hover:text-accent-foreground", getButtonSizeClass(config.size), "justify-start w-full"), onClick: (e) => {
+                                                        e.preventDefault();
+                                                        resetColumnSizing();
+                                                    }, children: [_jsx(Undo2, { className: "mr-2 h-4 w-4" }), "Reset Column Sizes"] })), resetColumnOrder && (_jsxs("button", { className: cn("inline-flex items-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50", "border border-input bg-background hover:bg-accent hover:text-accent-foreground", getButtonSizeClass(config.size), "justify-start w-full"), onClick: (e) => {
+                                                        e.preventDefault();
+                                                        resetColumnOrder();
+                                                    }, children: [_jsx(MoveHorizontal, { className: "mr-2 h-4 w-4" }), "Reset Column Order"] })), config.enableRowSelection && (_jsxs("button", { className: cn("inline-flex items-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50", "border border-input bg-background hover:bg-accent hover:text-accent-foreground", getButtonSizeClass(config.size), "justify-start w-full"), onClick: (e) => {
+                                                        e.preventDefault();
+                                                        table.resetRowSelection();
+                                                        clearSelection();
+                                                    }, children: [_jsx(CheckSquare, { className: "mr-2 h-4 w-4" }), "Clear Selection"] })), !table.getIsAllColumnsVisible() && (_jsxs("button", { className: cn("inline-flex items-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50", "border border-input bg-background hover:bg-accent hover:text-accent-foreground", getButtonSizeClass(config.size), "justify-start w-full"), onClick: () => table.resetColumnVisibility(), children: [_jsx(EyeOff, { className: "mr-2 h-4 w-4" }), "Show All Columns"] }))] })] }) })] })] })] }));
+}
+//# sourceMappingURL=toolbar.js.map

package/dist/toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.js","sourceRoot":"","sources":["../src/toolbar.tsx"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,230 @@
+import type { ColumnDef } from "@tanstack/react-table";
+export interface TableConfig {
+    /** Enable/disable row selection checkboxes */
+    enableRowSelection: boolean;
+    /** Enable/disable keyboard navigation (arrow keys) */
+    enableKeyboardNavigation: boolean;
+    /** Enable/disable clicking a row to select it */
+    enableClickRowSelect: boolean;
+    /** Enable/disable pagination controls */
+    enablePagination: boolean;
+    /** Enable/disable search input */
+    enableSearch: boolean;
+    /** Enable/disable date range filter */
+    enableDateFilter: boolean;
+    /** Enable/disable column visibility toggle */
+    enableColumnVisibility: boolean;
+    /** Enable/disable export dropdown */
+    enableExport: boolean;
+    /** Enable/disable URL state persistence */
+    enableUrlState: boolean;
+    /** Enable/disable column resizing */
+    enableColumnResizing: boolean;
+    /** Enable/disable toolbar */
+    enableToolbar: boolean;
+    /** Size variant for buttons/inputs: 'sm' | 'default' | 'lg' */
+    size: "sm" | "default" | "lg";
+    /** Unique ID for storing column sizing in localStorage */
+    columnResizingTableId?: string;
+    /** Custom placeholder text for search input */
+    searchPlaceholder?: string;
+    /** Default sort column (should match column accessorKey) */
+    defaultSortBy?: string;
+    /** Default sort direction */
+    defaultSortOrder?: "asc" | "desc";
+    /** Default page size */
+    defaultPageSize?: number;
+    /** Page size options for the selector */
+    pageSizeOptions?: number[];
+    /** Allow exporting new columns created by transform function */
+    allowExportNewColumns: boolean;
+}
+export interface QueryParams {
+    page: number;
+    pageSize: number;
+    search: string;
+    sort: string;
+    sortOrder: "asc" | "desc";
+    filters: Record<string, unknown>;
+    dateRange: {
+        from: string;
+        to: string;
+    };
+}
+export interface QueryResult<T = Record<string, unknown>> {
+    data: T[];
+    meta: {
+        total: number | null;
+        page: number;
+        pageSize: number;
+        totalPages: number | null;
+        countMode?: 'exact' | 'estimated';
+    };
+}
+export interface DataAdapter<T = Record<string, unknown>> {
+    /** Fetch data given current table params */
+    query(params: QueryParams): Promise<QueryResult<T>>;
+    /** Fetch items by IDs (for cross-page selection/export) */
+    queryByIds?(ids: (string | number)[]): Promise<T[]>;
+    /** Fetch table metadata (enables auto-column generation) */
+    meta?(): Promise<TableMetadata>;
+    /** Export data in a format */
+    export?(format: "csv" | "json", params?: Partial<QueryParams>): Promise<string>;
+}
+export interface ColumnMetadata {
+    name: string;
+    type: string;
+    label: string;
+    hidden: boolean;
+    sortable: boolean;
+    filterable: boolean;
+    computed?: boolean;
+    source?: "base" | "join" | "computed" | "subquery";
+    joinTable?: string;
+    format?: string;
+    align?: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    options?: {
+        value: string | number | boolean;
+        label: string;
+        color?: string;
+    }[];
+    datePresets?: string[];
+    operators: string[];
+}
+export interface FilterMetadata {
+    field: string;
+    type: string;
+    label: string;
+    operators: string[];
+    options?: {
+        value: string | number | boolean;
+        label: string;
+        color?: string;
+    }[];
+    datePresets?: string[];
+}
+export interface AggregationMetadata {
+    alias: string;
+    type: "count" | "sum" | "avg" | "min" | "max";
+    field: string;
+}
+export interface IncludeMetadata {
+    as: string;
+    table: string;
+    columns?: string[];
+    nested?: IncludeMetadata[];
+}
+export interface TableMetadata {
+    name: string;
+    dateRangeColumn?: string | null;
+    dateColumns?: string[];
+    columns: ColumnMetadata[];
+    capabilities: {
+        search: boolean;
+        searchFields: string[];
+        export: boolean;
+        exportFormats: string[];
+        pagination: {
+            enabled: boolean;
+            defaultPageSize: number;
+            maxPageSize: number;
+            cursor: boolean;
+        };
+        sort: {
+            enabled: boolean;
+            defaultSort: {
+                field: string;
+                order: string;
+            }[];
+        };
+        groupBy: boolean;
+        groupByFields: string[];
+        recursive: boolean;
+    };
+    filters: FilterMetadata[];
+    aggregations: AggregationMetadata[];
+    includes: IncludeMetadata[];
+    staticFilters: string[];
+}
+export interface CellRendererProps<T = unknown> {
+    value: T;
+    row: Record<string, unknown>;
+    column: ColumnMetadataForRenderer;
+}
+export type CellRenderer<T = unknown> = React.ComponentType<CellRendererProps<T>>;
+export interface ColumnMetadataForRenderer {
+    name: string;
+    type: string;
+    format?: string;
+    align?: string;
+    options?: {
+        value: string | number | boolean;
+        label: string;
+        color?: string;
+    }[];
+}
+export type DataTransformFunction<T> = (row: T) => Record<string, unknown>;
+export interface ExportConfig<T = Record<string, unknown>> {
+    entityName: string;
+    columnMapping?: Record<string, string>;
+    columnWidths?: Array<{
+        wch: number;
+    }>;
+    headers?: string[];
+    transformFunction?: DataTransformFunction<T>;
+    enableCsv?: boolean;
+    enableExcel?: boolean;
+}
+export interface DataTableProps<T extends Record<string, unknown>> {
+    /** Data adapter — the bridge to your backend */
+    adapter: DataAdapter<T>;
+    /** Manual column definitions (skip auto-generation from metadata) */
+    columns?: ColumnDef<T, unknown>[];
+    /** Cell renderer overrides: columnType or columnName → Component */
+    renderers?: Record<string, CellRenderer>;
+    /** Table configuration overrides */
+    config?: Partial<TableConfig>;
+    /** Export configuration */
+    exportConfig?: ExportConfig<T>;
+    /** ID field for row tracking (default: 'id') */
+    idField?: keyof T;
+    /** Row click handler */
+    onRowClick?: (row: T, index: number) => void;
+    /** Custom toolbar content (rendered at the start of the toolbar) */
+    startToolbarContent?: React.ReactNode | ((ctx: ToolbarContext<T>) => React.ReactNode);
+    /** Custom toolbar content (rendered after built-in controls) */
+    toolbarContent?: React.ReactNode;
+    /** Render custom toolbar with selection context */
+    renderToolbar?: (ctx: ToolbarContext<T>) => React.ReactNode;
+    /** className for outer wrapper */
+    className?: string;
+    /** Custom page size options */
+    pageSizeOptions?: number[];
+}
+export interface ToolbarContext<T> {
+    selectedRows: T[];
+    selectedIds: string[];
+    totalSelected: number;
+    clearSelection: () => void;
+    search: string;
+    setSearch: (value: string | ((prev: string) => string)) => void;
+    dateRange: {
+        from: string;
+        to: string;
+    };
+    setDateRange: (value: {
+        from: string;
+        to: string;
+    } | ((prev: {
+        from: string;
+        to: string;
+    }) => {
+        from: string;
+        to: string;
+    })) => void;
+}
+export type ExportableData = Record<string, string | number | boolean | null | undefined>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/utils/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAG7C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/utils/cn.js

@@ -0,0 +1,6 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/utils/column-sizing.d.ts

@@ -0,0 +1,18 @@
+import type { ColumnDef } from "@tanstack/react-table";
+/**
+ * Extract default column sizes from column definitions.
+ */
+export declare function extractDefaultColumnSizes<TData>(columns: ColumnDef<TData, unknown>[]): Record<string, number>;
+/**
+ * Initialize column sizes from localStorage or defaults.
+ */
+export declare function initializeColumnSizes<TData>(columns: ColumnDef<TData, unknown>[], tableId: string, setColumnSizing: (sizes: Record<string, number>) => void): void;
+/**
+ * Track column resizing state in document body for styling purposes.
+ */
+export declare function trackColumnResizing(isResizing: boolean, attribute?: string): void;
+/**
+ * Clean up column resizing tracking when component unmounts.
+ */
+export declare function cleanupColumnResizing(attribute?: string): void;
+//# sourceMappingURL=column-sizing.d.ts.map

package/dist/utils/column-sizing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-sizing.d.ts","sourceRoot":"","sources":["../../src/utils/column-sizing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAwBvD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAC7C,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AASD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EACpC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,GACvD,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,OAAO,EACnB,SAAS,SAAkB,GAC1B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,SAAkB,GAAG,IAAI,CAEvE"}

package/dist/utils/column-sizing.js

@@ -0,0 +1,78 @@
+function hasIdAndSize(column) {
+    return ("id" in column &&
+        typeof column.id === "string" &&
+        "size" in column &&
+        typeof column.size === "number");
+}
+function hasAccessorKeyAndSize(column) {
+    return ("accessorKey" in column &&
+        typeof column.accessorKey === "string" &&
+        "size" in column &&
+        typeof column.size === "number");
+}
+/**
+ * Extract default column sizes from column definitions.
+ */
+export function extractDefaultColumnSizes(columns) {
+    const defaultSizing = {};
+    columns.forEach((column) => {
+        if (hasIdAndSize(column)) {
+            defaultSizing[column.id] = column.size;
+        }
+        else if (hasAccessorKeyAndSize(column)) {
+            defaultSizing[column.accessorKey] = column.size;
+        }
+    });
+    return defaultSizing;
+}
+function isValidColumnSizing(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    return Object.values(value).every((size) => typeof size === "number" && !Number.isNaN(size) && size > 0);
+}
+/**
+ * Initialize column sizes from localStorage or defaults.
+ */
+export function initializeColumnSizes(columns, tableId, setColumnSizing) {
+    if (columns.length === 0)
+        return;
+    const defaultSizing = extractDefaultColumnSizes(columns);
+    if (Object.keys(defaultSizing).length === 0)
+        return;
+    try {
+        const savedSizing = localStorage.getItem(`table-column-sizing-${tableId}`);
+        if (!savedSizing) {
+            setColumnSizing(defaultSizing);
+        }
+        else {
+            const parsedSizing = JSON.parse(savedSizing);
+            if (isValidColumnSizing(parsedSizing)) {
+                setColumnSizing(parsedSizing);
+            }
+            else {
+                setColumnSizing(defaultSizing);
+            }
+        }
+    }
+    catch {
+        setColumnSizing(defaultSizing);
+    }
+}
+/**
+ * Track column resizing state in document body for styling purposes.
+ */
+export function trackColumnResizing(isResizing, attribute = "data-resizing") {
+    if (isResizing) {
+        document.body.setAttribute(attribute, "true");
+    }
+    else {
+        document.body.removeAttribute(attribute);
+    }
+}
+/**
+ * Clean up column resizing tracking when component unmounts.
+ */
+export function cleanupColumnResizing(attribute = "data-resizing") {
+    document.body.removeAttribute(attribute);
+}
+//# sourceMappingURL=column-sizing.js.map

package/dist/utils/column-sizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-sizing.js","sourceRoot":"","sources":["../../src/utils/column-sizing.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Format date to YYYY-MM-DD using local date components.
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Validate a YYYY-MM-DD date string.
+ */
+export declare function validateDateString(dateString: string): boolean;
+/**
+ * Parse a YYYY-MM-DD string to a Date object.
+ */
+export declare function parseDateFromUrl(dateString: string): Date | undefined;
+//# sourceMappingURL=date-format.d.ts.map

package/dist/utils/date-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.d.ts","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAM9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAGrE"}

package/dist/utils/date-format.js

@@ -0,0 +1,30 @@
+/**
+ * Format date to YYYY-MM-DD using local date components.
+ */
+export function formatDate(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Validate a YYYY-MM-DD date string.
+ */
+export function validateDateString(dateString) {
+    if (!dateString)
+        return false;
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!dateRegex.test(dateString))
+        return false;
+    const date = new Date(dateString);
+    return !Number.isNaN(date.getTime());
+}
+/**
+ * Parse a YYYY-MM-DD string to a Date object.
+ */
+export function parseDateFromUrl(dateString) {
+    if (!validateDateString(dateString))
+        return undefined;
+    return new Date(dateString);
+}
+//# sourceMappingURL=date-format.js.map

package/dist/utils/date-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.js","sourceRoot":"","sources":["../../src/utils/date-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,SAAS,GAAG,qBAAqB,CAAC;IACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/deep-utils.d.ts

@@ -0,0 +1,15 @@
+type Comparable = string | number | boolean | object | null | undefined | Date | RegExp | Set<unknown> | Map<unknown, unknown>;
+/**
+ * Optimized deep equality check for objects and arrays.
+ */
+export declare function isDeepEqual(a: Comparable, b: Comparable): boolean;
+/**
+ * Creates a debounced function that delays invoking func until after wait ms.
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Reset URL parameters by removing all query parameters.
+ */
+export declare function resetUrlState(pathname?: string): void;
+export {};
+//# sourceMappingURL=deep-utils.d.ts.map

package/dist/utils/deep-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-utils.d.ts","sourceRoot":"","sources":["../../src/utils/deep-utils.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE/H;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CA4EjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAWlC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAUrD"}