next-data-kit 0.0.1 → 1.0.0

package/dist/client/hooks/useSelection.js

@@ -0,0 +1,99 @@
+/**
+ * next-data-kit - useSelection Hook
+ *
+ * React hook for managing table row selection.
+ */
+'use client';
+import { useState, useCallback, useMemo } from 'react';
+// ** ============================================================================
+// ** Hook
+// ** ============================================================================
+export const useSelection = (initialSelected = []) => {
+    // ** State
+    const [selectedIds, setSelectedIds] = useState(new Set(initialSelected));
+    // ** Select a single item
+    const select = useCallback((id) => {
+        setSelectedIds((prev) => new Set(prev).add(id));
+    }, []);
+    // ** Deselect a single item
+    const deselect = useCallback((id) => {
+        setSelectedIds((prev) => {
+            const next = new Set(prev);
+            next.delete(id);
+            return next;
+        });
+    }, []);
+    // ** Toggle selection of a single item
+    const toggle = useCallback((id) => {
+        setSelectedIds((prev) => {
+            const next = new Set(prev);
+            if (next.has(id))
+                next.delete(id);
+            else
+                next.add(id);
+            return next;
+        });
+    }, []);
+    // ** Select all items
+    const selectAll = useCallback((ids) => {
+        setSelectedIds(new Set(ids));
+    }, []);
+    // ** Deselect all items
+    const deselectAll = useCallback(() => {
+        setSelectedIds(new Set());
+    }, []);
+    // ** Toggle all items selection
+    const toggleAll = useCallback((ids) => {
+        setSelectedIds((prev) => {
+            // ** If all are selected, deselect all
+            if (ids.every((id) => prev.has(id)))
+                return new Set();
+            // ** Otherwise, select all
+            return new Set(ids);
+        });
+    }, []);
+    // ** Check if an item is selected
+    const isSelected = useCallback((id) => selectedIds.has(id), [selectedIds]);
+    // ** Get array of selected IDs
+    const getSelectedArray = useCallback(() => Array.from(selectedIds), [selectedIds]);
+    // ** Calculate derived state
+    const isAllSelected = useMemo(() => selectedIds.size > 0, [selectedIds.size]);
+    const isIndeterminate = useMemo(() => false, []);
+    return {
+        selectedIds,
+        isAllSelected,
+        isIndeterminate,
+        select,
+        deselect,
+        toggle,
+        selectAll,
+        deselectAll,
+        toggleAll,
+        isSelected,
+        getSelectedArray,
+    };
+};
+// ** ============================================================================
+// ** Hook with Total
+// ** ============================================================================
+export const useSelectionWithTotal = (totalItems, initialSelected = []) => {
+    // ** Base selection hook
+    const selection = useSelection(initialSelected);
+    // ** Calculate derived state
+    const isAllSelected = useMemo(() => totalItems.length > 0 && totalItems.every((id) => selection.selectedIds.has(id)), [totalItems, selection.selectedIds]);
+    const isIndeterminate = useMemo(() => selection.selectedIds.size > 0 && selection.selectedIds.size < totalItems.length, [totalItems.length, selection.selectedIds.size]);
+    // ** Override toggleAll to use totalItems
+    const toggleAll = useCallback(() => {
+        if (isAllSelected)
+            selection.deselectAll();
+        else
+            selection.selectAll(totalItems);
+    }, [isAllSelected, selection, totalItems]);
+    return {
+        ...selection,
+        isAllSelected,
+        isIndeterminate,
+        toggleAll,
+    };
+};
+//# sourceMappingURL=useSelection.js.map

package/dist/client/hooks/useSelection.js.map

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

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * react-data-kit - Client Exports
+ * next-data-kit - Client Exports
  *
- * Client-side utilities, hooks, and components for react-data-kit.
+ * Client-side utilities, hooks, and components for next-data-kit.
  */
 export { useDataKit, useSelection, useSelectionWithTotal, usePagination, type TDataKitControllerOptions, type TUsePaginationReturn, } from './hooks';
 export { createDataKitContext, DataKitProvider, useDataKitContext, DataKitContext, type TDataKitContextValue, } from './context';

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACF,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC7B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACF,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,KAAK,oBAAoB,GAC7B,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EACF,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GACpB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACP,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EAEX,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,GACrB,MAAM,UAAU,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,15 @@
+/**
+ * next-data-kit - Client Exports
+ *
+ * Client-side utilities, hooks, and components for next-data-kit.
+ */
+'use client';
+// ** Hooks
+export { useDataKit, useSelection, useSelectionWithTotal, usePagination, } from './hooks';
+// ** Context
+export { createDataKitContext, DataKitProvider, useDataKitContext, DataKitContext, } from './context';
+// ** Components
+export { DataKitTable, DataKit } from './components';
+// ** Utilities
+export { getColumnValue, getSortValue, getNextSortValue, formatNumber, debounce, throttle, sortEntriesToKey, keyToSortEntries, } from './utils';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,CAAC;AAEb,WAAW;AACX,OAAO,EACF,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,aAAa,GAGjB,MAAM,SAAS,CAAC;AAEjB,aAAa;AACb,OAAO,EACF,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,cAAc,GAElB,MAAM,WAAW,CAAC;AAEnB,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAErD,eAAe;AACf,OAAO,EACF,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GACpB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../../src/client/utils/cn.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AACnE,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;AAClE,KAAK,UAAU,GAAG,UAAU,EAAE,CAAC;AAC/B,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,UAAU,CAAC;AAqBvE;;GAEG;AACH,eAAO,MAAM,EAAE,GAAI,GAAG,QAAQ,UAAU,EAAE,KAAG,MAA6D,CAAC"}

package/dist/client/utils/cn.js

@@ -0,0 +1,22 @@
+'use client';
+const toClassString = (input) => {
+    if (!input)
+        return '';
+    if (typeof input === 'string' || typeof input === 'number')
+        return String(input);
+    if (Array.isArray(input)) {
+        return input.map(toClassString).filter(Boolean).join(' ');
+    }
+    if (typeof input === 'object') {
+        return Object.entries(input)
+            .filter(([, value]) => Boolean(value))
+            .map(([key]) => key)
+            .join(' ');
+    }
+    return '';
+};
+/**
+ * Minimal `cn` helper (shadcn-style) without external deps.
+ */
+export const cn = (...inputs) => inputs.map(toClassString).filter(Boolean).join(' ');
+//# sourceMappingURL=cn.js.map

package/dist/client/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../../src/client/utils/cn.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAOb,MAAM,aAAa,GAAG,CAAC,KAAiB,EAAU,EAAE;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aACvB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;aACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAoB,EAAU,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/client/utils/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * react-data-kit - Utility Functions
+ * next-data-kit - Utility Functions
  *
  * Helper utilities for client-side operations.
  */

package/dist/client/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAM3C;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,KAAG,OAGtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,UAAU,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAGzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,KAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAIlE,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAA8B,CAAC;AAM1E;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC7D,IAAI,CAAC,EACL,OAAO,MAAM,KACf,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAMnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC7D,IAAI,CAAC,EACL,OAAO,MAAM,KACf,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASnC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,UAAU,EAAE,KAAG,MACA,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,UAAU,EAMxD,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA8BpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,KAAG,eAwBH,CAAC"}

package/dist/client/utils/index.js

@@ -0,0 +1,148 @@
+/**
+ * next-data-kit - Utility Functions
+ *
+ * Helper utilities for client-side operations.
+ */
+export { cn } from './cn';
+// ** ============================================================================
+// ** Column Utilities
+// ** ============================================================================
+/**
+ * Get the value from an item using a column accessor
+ */
+export const getColumnValue = (item, column) => {
+    const { accessor } = column;
+    return typeof accessor === 'function' ? accessor(item) : item[accessor];
+};
+/**
+ * Get the sort value for a column
+ */
+export const getSortValue = (sorts, path) => {
+    const sort = sorts.find((s) => s.path === path);
+    return sort?.value ?? null;
+};
+/**
+ * Get the next sort value in the cycle: null -> 1 -> -1 -> null
+ */
+export const getNextSortValue = (current) => {
+    if (current === null)
+        return 1;
+    if (current === 1)
+        return -1;
+    return null;
+};
+// ** ============================================================================
+// ** Formatting Utilities
+// ** ============================================================================
+/**
+ * Format a number with commas
+ */
+export const formatNumber = (num) => num.toLocaleString();
+// ** ============================================================================
+// ** Function Utilities
+// ** ============================================================================
+/**
+ * Debounce a function
+ */
+export const debounce = (fn, delay) => {
+    let timeoutId;
+    return (...args) => {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn(...args), delay);
+    };
+};
+/**
+ * Throttle a function
+ */
+export const throttle = (fn, limit) => {
+    let inThrottle = false;
+    return (...args) => {
+        if (!inThrottle) {
+            fn(...args);
+            inThrottle = true;
+            setTimeout(() => { inThrottle = false; }, limit);
+        }
+    };
+};
+// ** ============================================================================
+// ** Sort Entry Utilities
+// ** ============================================================================
+/**
+ * Create a stable object key from sort entries
+ */
+export const sortEntriesToKey = (sorts) => sorts.map((s) => `${s.path}:${s.value}`).join(',');
+/**
+ * Parse a sort key back to sort entries
+ */
+export const keyToSortEntries = (key) => {
+    if (!key)
+        return [];
+    return key.split(',').map((part) => {
+        const [path, value] = part.split(':');
+        return { path: path ?? '', value: parseInt(value ?? '1', 10) };
+    });
+};
+// ** ============================================================================
+// ** URL State Utilities
+// ** ============================================================================
+/**
+ * Parse URL search params into tabler state
+ */
+export const parseUrlParams = (search) => {
+    const params = new URLSearchParams(search);
+    const state = {};
+    // ** Page
+    const page = params.get('page');
+    if (page)
+        state.page = parseInt(page, 10);
+    // ** Limit
+    const limit = params.get('limit');
+    if (limit)
+        state.limit = parseInt(limit, 10);
+    // ** Sorts
+    const sort = params.get('sort');
+    if (sort)
+        state.sorts = keyToSortEntries(sort);
+    // ** Filter (f_key) and Query (q_key)
+    const filter = {};
+    const query = {};
+    params.forEach((value, key) => {
+        if (key.startsWith('f_'))
+            filter[key.slice(2)] = value;
+        else if (key.startsWith('q_'))
+            query[key.slice(2)] = value;
+    });
+    if (Object.keys(filter).length > 0)
+        state.filter = filter;
+    if (Object.keys(query).length > 0)
+        state.query = query;
+    return state;
+};
+/**
+ * Convert tabler state to URL search params
+ */
+export const stateToUrlParams = (state) => {
+    const params = new URLSearchParams();
+    if (state.page && state.page > 1)
+        params.set('page', state.page.toString());
+    if (state.limit)
+        params.set('limit', state.limit.toString());
+    if (state.sorts && state.sorts.length > 0)
+        params.set('sort', sortEntriesToKey(state.sorts));
+    if (state.filter) {
+        Object.entries(state.filter).forEach(([key, value]) => {
+            if (value !== undefined && value !== null && value !== '') {
+                params.set(`f_${key}`, String(value));
+            }
+        });
+    }
+    if (state.query) {
+        Object.entries(state.query).forEach(([key, value]) => {
+            if (value !== undefined && value !== null && value !== '') {
+                params.set(`q_${key}`, String(value));
+            }
+        });
+    }
+    return params;
+};
+//# sourceMappingURL=index.js.map

package/dist/client/utils/index.js.map

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

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 /**
- * react-data-kit/client
+ * next-data-kit/client
  *
- * Client-side entry point for react-data-kit.
+ * Client-side entry point for next-data-kit.
  */
 export * from './client/index';
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,cAAc,gBAAgB,CAAC"}

package/dist/client.js

@@ -0,0 +1,8 @@
+/**
+ * next-data-kit/client
+ *
+ * Client-side entry point for next-data-kit.
+ */
+'use client';
+export * from './client/index';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,CAAC;AAEb,cAAc,gBAAgB,CAAC"}