next-data-kit 0.0.1

package/dist/types/database/mongo.d.ts

@@ -0,0 +1,129 @@
+/**
+ * react-data-kit - Database Types (Mongo)
+ *
+ * MongoDB-specific types.
+ * Consolidated into a single file for simplicity.
+ */
+/**
+ * Sort order for database queries
+ */
+export type TSortOrder = 1 | -1 | 'asc' | 'desc' | 'ascending' | 'descending';
+/**
+ * ObjectId placeholder type - compatible with MongoDB ObjectId.
+ */
+export type TObjectId = {
+    toString(): string;
+    toHexString(): string;
+    equals(otherId: TObjectId | string): boolean;
+};
+/**
+ * Generic document type that represents a database document with an ID.
+ */
+export type TDocument<TId = unknown> = {
+    _id: TId;
+    createdAt?: Date;
+    updatedAt?: Date;
+};
+/**
+ * Mongo document base (includes common Mongo-only fields).
+ */
+export type TMongoDocument = TDocument<string | TObjectId> & {
+    __v?: number;
+};
+/**
+ * Hydrated document type - represents a document with methods.
+ */
+export type THydratedDocument<T, TId = unknown> = T & TDocument<TId>;
+/**
+ * Hydrated Mongo document.
+ */
+export type TMongoHydratedDocument<T> = T & TMongoDocument & {
+    toObject(): T;
+    toJSON(): T;
+};
+/**
+ * Filter operators for individual fields (Mongo subset)
+ */
+export type TMongoFilterOperators<T> = {
+    $eq?: T;
+    $ne?: T;
+    $gt?: T;
+    $gte?: T;
+    $lt?: T;
+    $lte?: T;
+    $in?: T[];
+    $nin?: T[];
+    $exists?: boolean;
+    $all?: T extends Array<infer U> ? U[] : never;
+    $elemMatch?: T extends Array<infer U> ? TMongoFilterQuery<U> : never;
+    $size?: number;
+    $regex?: string | RegExp;
+    $options?: string;
+    $type?: string | number;
+};
+/**
+ * Mongo root operators.
+ */
+export type TMongoRootFilterOperators<T> = {
+    $and?: TMongoFilterQuery<T>[];
+    $or?: TMongoFilterQuery<T>[];
+    $nor?: TMongoFilterQuery<T>[];
+    $not?: TMongoFilterQuery<T>;
+    $text?: {
+        $search: string;
+        $language?: string;
+        $caseSensitive?: boolean;
+        $diacriticSensitive?: boolean;
+    };
+    $where?: string | ((this: T) => boolean);
+};
+/**
+ * Mongo filter query type.
+ */
+export type TMongoFilterQuery<T> = {
+    [P in keyof T]?: T[P] | TMongoFilterOperators<T[P]>;
+} & TMongoRootFilterOperators<T>;
+/**
+ * Populate options for query builder.
+ */
+export type TPopulateOptions = {
+    path: string;
+    select?: string | Record<string, 0 | 1>;
+    model?: string;
+    match?: Record<string, unknown>;
+    populate?: TPopulateOptions | TPopulateOptions[];
+};
+/**
+ * Query builder for chaining query operations.
+ */
+export type TQueryBuilder<TResult, TQueryHelpers = object> = Promise<TResult> & {
+    sort(options: Record<string, TSortOrder>): TQueryBuilder<TResult, TQueryHelpers>;
+    limit(count: number): TQueryBuilder<TResult, TQueryHelpers>;
+    skip(count: number): TQueryBuilder<TResult, TQueryHelpers>;
+    select(fields: string | Record<string, 0 | 1>): TQueryBuilder<TResult, TQueryHelpers>;
+    populate(path: string | TPopulateOptions): TQueryBuilder<TResult, TQueryHelpers>;
+    lean(): TQueryBuilder<TResult, TQueryHelpers>;
+    exec(): Promise<TResult>;
+};
+/**
+ * Generic Model type.
+ */
+export type TModel<TRawDocType = unknown, TQueryHelpers = object, TId = unknown, TFilter = unknown> = {
+    countDocuments(filter?: TFilter): Promise<number>;
+    find(filter?: TFilter): TQueryBuilder<TRawDocType[], TQueryHelpers>;
+    findOne(filter?: TFilter): TQueryBuilder<TRawDocType | null, TQueryHelpers>;
+    findById(id: TId): TQueryBuilder<TRawDocType | null, TQueryHelpers>;
+};
+/**
+ * Convenience alias for a Mongo-backed model.
+ */
+export type TMongoModel<TRawDocType = unknown, TQueryHelpers = object> = TModel<TRawDocType, TQueryHelpers, string | TObjectId, TMongoFilterQuery<TRawDocType>>;
+/**
+ * Extract raw document type from a Model
+ */
+export type TExtractDocType<M> = M extends TModel<infer TRawDocType, unknown, unknown, unknown> ? TRawDocType : never;
+/**
+ * Extract hydrated document type from a Model
+ */
+export type TExtractHydratedDoc<M> = M extends TModel<infer TRawDocType, unknown, infer TId, unknown> ? THydratedDocument<TRawDocType, TId> : never;
+//# sourceMappingURL=mongo.d.ts.map

package/dist/types/hook.d.ts

@@ -0,0 +1,100 @@
+/**
+ * react-data-kit - Hook Types
+ *
+ * Types for the react-data-kit hooks and state management.
+ */
+import type { TSortEntry, TFilterConfig, TDataKitInput, TDataKitResult } from './react-data-kit';
+/**
+ * React Data Kit controller state
+ */
+export type TDataKitState<T = unknown> = {
+    page: number;
+    limit: number;
+    sorts: TSortEntry[];
+    filter: Record<string, unknown>;
+    filterConfig?: TFilterConfig;
+    query?: Record<string, unknown>;
+    isLoading: boolean;
+    error: Error | null;
+    items: T[];
+    total: number;
+};
+/**
+ * React Data Kit controller actions
+ */
+export type TDataKitActions<T = unknown, R = unknown> = {
+    setPage: (page: number) => void;
+    setLimit: (limit: number) => void;
+    setSort: (path: string, value: 1 | -1 | null, append?: boolean) => void;
+    setSorts: (sorts: TSortEntry[]) => void;
+    setFilter: (key: string, value: unknown) => void;
+    setFilters: (filters: Record<string, unknown>) => void;
+    clearFilters: () => void;
+    setQuery: (key: string, value: unknown) => void;
+    refresh: () => Promise<void>;
+    reset: () => void;
+    getInput: () => TDataKitInput<T>;
+    setItems: (items: R[]) => void;
+    setItemAt: (index: number, item: R) => void;
+    deleteItemAt: (index: number) => void;
+    itemPush: (item: R, position?: 0 | 1) => void;
+    deleteBulk: (items: R[]) => void;
+};
+/**
+ * Combined react-data-kit controller return type
+ */
+export type TUseDataKitReturn<T = unknown, R = unknown> = {
+    page: number;
+    limit: number;
+    sorts: TSortEntry[];
+    filter: Record<string, unknown>;
+    filterConfig?: TFilterConfig;
+    query?: Record<string, unknown>;
+    items: R[];
+    total: number;
+    state: {
+        isLoading: boolean;
+        error: Error | null;
+    };
+    actions: TDataKitActions<T, R>;
+};
+/**
+ * React Data Kit controller options
+ */
+export type TDataKitControllerOptions<T = unknown, R = unknown> = {
+    initial?: {
+        page?: number;
+        limit?: number;
+        sorts?: TSortEntry[];
+        filter?: Record<string, unknown>;
+        query?: Record<string, unknown>;
+    };
+    state?: 'memory' | 'search-params';
+    filterConfig?: TFilterConfig;
+    action: (input: TDataKitInput<T>) => Promise<TDataKitResult<R>>;
+    onSuccess?: (result: TDataKitResult<R>) => void;
+    onError?: (error: Error) => void;
+    autoFetch?: boolean;
+    debounce?: number;
+};
+/**
+ * Column definition for react-data-kit (headless)
+ */
+export type TDataKitColumn<T = unknown> = {
+    id: string;
+    header: string;
+    accessor: keyof T | ((item: T) => unknown);
+    sortable?: boolean;
+    sortPath?: string;
+    filterable?: boolean;
+    filterKey?: string;
+    width?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    align?: 'left' | 'center' | 'right';
+    cell?: (value: unknown, item: T, index: number) => React.ReactNode;
+    headerCell?: (column: TDataKitColumn<T>) => React.ReactNode;
+    hidden?: boolean;
+    sticky?: 'left' | 'right';
+};
+//# sourceMappingURL=hook.d.ts.map

package/dist/types/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+// src/types/next-data-kit.ts
+var calculatePagination = (page, limit, total) => ({
+  currentPage: page,
+  totalPages: Math.ceil(total / limit),
+  totalItems: total,
+  itemsPerPage: limit,
+  hasNextPage: page * limit < total,
+  hasPrevPage: page > 1
+});
+
+exports.calculatePagination = calculatePagination;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/next-data-kit.ts"],"names":[],"mappings":";;;AAmHO,IAAM,mBAAA,GAAsB,CAAC,IAAA,EAAc,KAAA,EAAe,KAAA,MAAoC;AAAA,EAChG,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY,IAAA,CAAK,IAAA,CAAK,KAAA,GAAQ,KAAK,CAAA;AAAA,EACnC,UAAA,EAAY,KAAA;AAAA,EACZ,YAAA,EAAc,KAAA;AAAA,EACd,WAAA,EAAa,OAAO,KAAA,GAAQ,KAAA;AAAA,EAC5B,aAAa,IAAA,GAAO;AACzB,CAAA","file":"index.cjs","sourcesContent":["/**\n * next-data-kit - React Data Kit Types\n *\n * Core types for the next-data-kit server action and components.\n */\n\nimport type { TMongoFilterQuery, TSortOrder } from './database/mongo';\n\n// ** ============================================================================\n// ** Sort Types\n// ** ============================================================================\n\n/**\n * Sort options type that references keys from the item type\n */\nexport type TSortOptions<T> = {\n     [K in keyof T]?: TSortOrder;\n};\n\n/**\n * Sort entry for array-based sorting\n */\nexport type TSortEntry = {\n     path: string;\n     value: 1 | -1;\n};\n\n// ** ============================================================================\n// ** Filter Types\n// ** ============================================================================\n\n/**\n * Filter configuration for automatic filtering\n */\nexport type TFilterConfig = {\n     [key: string]: {\n          // ** Type of filter matching\n          type: 'regex' | 'exact';\n          // ** Optional: different database field name\n          field?: string;\n     };\n};\n\n/**\n * Custom filter configuration\n * Allows defining custom filter functions for specific filter keys\n */\nexport type TFilterCustomConfig<T = unknown> = {\n     [id: string]: (data: unknown) => TMongoFilterQuery<T>;\n};\n\n/**\n * Variant of TFilterCustomConfig that allows customizing the returned filter shape.\n * Useful for Mongo (operator-based) vs. other ORMs (where clauses) in the future.\n */\nexport type TFilterCustomConfigWithFilter<TDoc = unknown, TFilter = TMongoFilterQuery<TDoc>> = {\n     [id: string]: (data: unknown) => TFilter;\n};\n\n// ** ============================================================================\n// ** Input/Output Types\n// ** ============================================================================\n\n/**\n * React Data Kit server action input\n */\nexport type TDataKitInput<T = unknown> = {\n     // ** Action type - currently only FETCH is supported\n     action?: 'FETCH';\n     // ** Current page number (1-indexed)\n     page?: number;\n     // ** Number of items per page\n     limit?: number;\n     // ** Legacy sort option\n     sort?: TSortOptions<T>;\n     // ** Multi-sort as an array\n     sorts?: TSortEntry[];\n     // ** Query parameters for exact match filtering\n     query?: Record<string, unknown>;\n     // ** Filter parameters\n     filter?: Record<string, unknown>;\n     // ** Filter configuration for automatic filtering\n     filterConfig?: TFilterConfig;\n     // ** Custom filter configuration\n     filterCustom?: TFilterCustomConfig<T>;\n};\n\n/**\n * React Data Kit server action result\n */\nexport type TDataKitResult<R> = {\n     type: 'ITEMS';\n     items: R[];\n     documentTotal: number;\n};\n\n// ** ============================================================================\n// ** Pagination Types\n// ** ============================================================================\n\n/**\n * Pagination info for client-side use\n */\nexport type TPaginationInfo = {\n     currentPage: number;\n     totalPages: number;\n     totalItems: number;\n     itemsPerPage: number;\n     hasNextPage: boolean;\n     hasPrevPage: boolean;\n};\n\n/**\n * Calculate pagination info from next-data-kit result\n */\nexport const calculatePagination = (page: number, limit: number, total: number): TPaginationInfo => ({\n     currentPage: page,\n     totalPages: Math.ceil(total / limit),\n     totalItems: total,\n     itemsPerPage: limit,\n     hasNextPage: page * limit < total,\n     hasPrevPage: page > 1,\n});\n\n// ** ============================================================================\n// ** Adapter Types\n// ** ============================================================================\n\n/**\n * React Data Kit Adapter Interface\n * Defines the contract for a database adapter.\n */\nexport type TDataKitAdapter<T> = (params: Readonly<{\n     filter: Record<string, unknown>;\n     sorts: TSortEntry[];\n     limit: number;\n     page: number;\n     skip: number;\n     input: TDataKitInput<T>;\n}>) => Promise<{ items: T[]; total: number }>;\n"]}

package/dist/types/index.d.cts

@@ -0,0 +1,252 @@
+import { r as TSortEntry, l as TFilterConfig, T as TDataKitInput, f as TDataKitResult } from '../react-data-kit-DmTzxNTc.cjs';
+export { a as TDataKitAdapter, s as TDocument, g as TExtractDocType, v as TExtractHydratedDoc, k as TFilterCustomConfig, d as TFilterCustomConfigWithFilter, i as THydratedDocument, h as TModel, p as TMongoDocument, m as TMongoFilterOperators, c as TMongoFilterQuery, q as TMongoHydratedDocument, b as TMongoModel, n as TMongoRootFilterOperators, o as TObjectId, w as TPaginationInfo, u as TPopulateOptions, t as TQueryBuilder, e as TSortOptions, j as TSortOrder, x as calculatePagination } from '../react-data-kit-DmTzxNTc.cjs';
+
+/**
+ * react-data-kit - Hook Types
+ *
+ * Types for the react-data-kit hooks and state management.
+ */
+
+/**
+ * React Data Kit controller state
+ */
+type TDataKitState<T = unknown> = {
+    page: number;
+    limit: number;
+    sorts: TSortEntry[];
+    filter: Record<string, unknown>;
+    filterConfig?: TFilterConfig;
+    query?: Record<string, unknown>;
+    isLoading: boolean;
+    error: Error | null;
+    items: T[];
+    total: number;
+};
+/**
+ * React Data Kit controller actions
+ */
+type TDataKitActions<T = unknown, R = unknown> = {
+    setPage: (page: number) => void;
+    setLimit: (limit: number) => void;
+    setSort: (path: string, value: 1 | -1 | null, append?: boolean) => void;
+    setSorts: (sorts: TSortEntry[]) => void;
+    setFilter: (key: string, value: unknown) => void;
+    setFilters: (filters: Record<string, unknown>) => void;
+    clearFilters: () => void;
+    setQuery: (key: string, value: unknown) => void;
+    refresh: () => Promise<void>;
+    reset: () => void;
+    getInput: () => TDataKitInput<T>;
+    setItems: (items: R[]) => void;
+    setItemAt: (index: number, item: R) => void;
+    deleteItemAt: (index: number) => void;
+    itemPush: (item: R, position?: 0 | 1) => void;
+    deleteBulk: (items: R[]) => void;
+};
+/**
+ * Combined react-data-kit controller return type
+ */
+type TUseDataKitReturn<T = unknown, R = unknown> = {
+    page: number;
+    limit: number;
+    sorts: TSortEntry[];
+    filter: Record<string, unknown>;
+    filterConfig?: TFilterConfig;
+    query?: Record<string, unknown>;
+    items: R[];
+    total: number;
+    state: {
+        isLoading: boolean;
+        error: Error | null;
+    };
+    actions: TDataKitActions<T, R>;
+};
+/**
+ * React Data Kit controller options
+ */
+type TDataKitControllerOptions<T = unknown, R = unknown> = {
+    initial?: {
+        page?: number;
+        limit?: number;
+        sorts?: TSortEntry[];
+        filter?: Record<string, unknown>;
+        query?: Record<string, unknown>;
+    };
+    state?: 'memory' | 'search-params';
+    filterConfig?: TFilterConfig;
+    action: (input: TDataKitInput<T>) => Promise<TDataKitResult<R>>;
+    onSuccess?: (result: TDataKitResult<R>) => void;
+    onError?: (error: Error) => void;
+    autoFetch?: boolean;
+    debounce?: number;
+};
+/**
+ * Column definition for react-data-kit (headless)
+ */
+type TDataKitColumn<T = unknown> = {
+    id: string;
+    header: string;
+    accessor: keyof T | ((item: T) => unknown);
+    sortable?: boolean;
+    sortPath?: string;
+    filterable?: boolean;
+    filterKey?: string;
+    width?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    align?: 'left' | 'center' | 'right';
+    cell?: (value: unknown, item: T, index: number) => React.ReactNode;
+    headerCell?: (column: TDataKitColumn<T>) => React.ReactNode;
+    hidden?: boolean;
+    sticky?: 'left' | 'right';
+};
+
+/**
+ * react-data-kit - Selectable Types
+ *
+ * Types for selectable/multi-select functionality in tables.
+ */
+/**
+ * Selection state for a table
+ */
+type TSelectionState<T = string> = {
+    selectedIds: Set<T>;
+    isAllSelected: boolean;
+    isIndeterminate: boolean;
+};
+/**
+ * Selection actions for a table
+ */
+type TSelectionActions<T = string> = {
+    select: (id: T) => void;
+    deselect: (id: T) => void;
+    toggle: (id: T) => void;
+    selectAll: (ids: T[]) => void;
+    deselectAll: () => void;
+    toggleAll: (ids: T[]) => void;
+    isSelected: (id: T) => boolean;
+    getSelectedArray: () => T[];
+};
+/**
+ * Combined selection hook return type
+ */
+type TUseSelectionReturn<T = string> = TSelectionState<T> & TSelectionActions<T>;
+/**
+ * Selection mode for tables
+ */
+type TSelectionMode = 'single' | 'multiple' | 'none';
+/**
+ * Selectable item type
+ */
+type TSelectable = {
+    id: string;
+    selected?: boolean;
+    disabled?: boolean;
+};
+
+/**
+ * react-data-kit - Component Types
+ *
+ * Types for the React Data Kit component and related UI elements.
+ */
+
+/**
+ * Extract the item type from a TDataKitResult
+ */
+type TExtractDataKitItemFromResult<R> = R extends TDataKitResult<infer I> ? I : R extends {
+    items: (infer I)[];
+} ? I : R extends [true, infer Ok] ? Ok extends {
+    items: (infer I)[];
+} ? I : never : never;
+/**
+ * Extract the item type from an action function's return type
+ */
+type TExtractDataKitItemType<T> = T extends (input: TDataKitInput<unknown>) => infer R ? TExtractDataKitItemFromResult<Awaited<R>> : never;
+/**
+ * Column definition for React Data Kit component
+ */
+type TDataKitComponentColumn<TItem, TRowState = unknown> = {
+    head: React.ReactNode;
+    body: (props: Readonly<{
+        item: TItem;
+        index: number;
+        state: TRowState;
+        setState: React.Dispatch<React.SetStateAction<TRowState>>;
+        setItem: (item: TItem) => void;
+        deleteItem: () => void;
+    }>) => React.ReactNode;
+    sortable?: {
+        path: string;
+        default: 1 | -1 | 0;
+    };
+};
+/**
+ * Base filter item properties
+ */
+type TDataKitFilterItemBase = {
+    id: string;
+    label: string;
+    placeholder?: string;
+};
+/**
+ * Text filter item
+ */
+type TDataKitFilterItemText = TDataKitFilterItemBase & {
+    type: 'TEXT';
+    defaultValue?: string;
+};
+/**
+ * Select filter item - dataset is required
+ */
+type TDataKitFilterItemSelect = TDataKitFilterItemBase & {
+    type: 'SELECT';
+    dataset: {
+        id: string;
+        name: string;
+        label: string;
+    }[];
+    defaultValue?: string;
+};
+/**
+ * Boolean filter item
+ */
+type TDataKitFilterItemBoolean = TDataKitFilterItemBase & {
+    type: 'BOOLEAN';
+    defaultValue?: boolean;
+};
+/**
+ * Filter item configuration - discriminated union for type safety
+ */
+type TDataKitFilterItem = TDataKitFilterItemText | TDataKitFilterItemSelect | TDataKitFilterItemBoolean;
+/**
+ * Bulk action definition for selectable tables
+ */
+type TDataKitBulkAction<TItem> = {
+    name: string;
+    function: (selectedItems: TItem[]) => Promise<[boolean, {
+        deselectAll?: boolean;
+        updatedItems?: TItem[];
+    } | string]>;
+};
+/**
+ * Controller for external table manipulation
+ */
+type TDataKitComponentController<TItem> = {
+    itemPush: (item: TItem, position?: 0 | 1) => void;
+    refetchData: () => void;
+    deleteBulk: (items: TItem[]) => void;
+    getSelectedItems: () => TItem[];
+    clearSelection: () => void;
+};
+/**
+ * Item with ID for selection purposes
+ */
+type TDataKitSelectableItem = {
+    id: string | number;
+};
+/**
+ * State persistence mode
+ */
+type TDataKitStateMode = 'memory' | 'search-params';
+
+export { type TDataKitActions, type TDataKitBulkAction, type TDataKitColumn, type TDataKitComponentColumn, type TDataKitComponentController, type TDataKitControllerOptions, type TDataKitFilterItem, TDataKitInput, TDataKitResult, type TDataKitSelectableItem, type TDataKitState, type TDataKitStateMode, type TExtractDataKitItemType, TFilterConfig, type TSelectable, type TSelectionActions, type TSelectionMode, type TSelectionState, TSortEntry, type TUseDataKitReturn, type TUseSelectionReturn };

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @muhgholy/tabler - Types
+ *
+ * Re-export all types for easy importing.
+ */
+export type { TSortOrder, TObjectId, TDocument, TMongoDocument, THydratedDocument, TMongoHydratedDocument, TMongoFilterOperators, TMongoRootFilterOperators, TMongoFilterQuery, TQueryBuilder, TPopulateOptions, TModel, TMongoModel, TExtractDocType, TExtractHydratedDoc, } from './database/mongo';
+export type { TSortOptions, TSortEntry, TFilterConfig, TFilterCustomConfig, TFilterCustomConfigWithFilter, TDataKitInput, TDataKitResult, TPaginationInfo, TDataKitAdapter, } from './react-data-kit';
+export { calculatePagination } from './react-data-kit';
+export type { TDataKitState, TDataKitActions, TUseDataKitReturn, TDataKitControllerOptions, TDataKitColumn, } from './hook';
+export type { TSelectionState, TSelectionActions, TUseSelectionReturn, TSelectionMode, TSelectable, } from './selectable';
+export type { TExtractDataKitItemType, TDataKitComponentColumn, TDataKitFilterItem, TDataKitBulkAction, TDataKitComponentController, TDataKitSelectableItem, TDataKitStateMode, } from './component';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.js

@@ -0,0 +1,13 @@
+// src/types/next-data-kit.ts
+var calculatePagination = (page, limit, total) => ({
+  currentPage: page,
+  totalPages: Math.ceil(total / limit),
+  totalItems: total,
+  itemsPerPage: limit,
+  hasNextPage: page * limit < total,
+  hasPrevPage: page > 1
+});
+
+export { calculatePagination };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/next-data-kit.ts"],"names":[],"mappings":";AAmHO,IAAM,mBAAA,GAAsB,CAAC,IAAA,EAAc,KAAA,EAAe,KAAA,MAAoC;AAAA,EAChG,WAAA,EAAa,IAAA;AAAA,EACb,UAAA,EAAY,IAAA,CAAK,IAAA,CAAK,KAAA,GAAQ,KAAK,CAAA;AAAA,EACnC,UAAA,EAAY,KAAA;AAAA,EACZ,YAAA,EAAc,KAAA;AAAA,EACd,WAAA,EAAa,OAAO,KAAA,GAAQ,KAAA;AAAA,EAC5B,aAAa,IAAA,GAAO;AACzB,CAAA","file":"index.js","sourcesContent":["/**\n * next-data-kit - React Data Kit Types\n *\n * Core types for the next-data-kit server action and components.\n */\n\nimport type { TMongoFilterQuery, TSortOrder } from './database/mongo';\n\n// ** ============================================================================\n// ** Sort Types\n// ** ============================================================================\n\n/**\n * Sort options type that references keys from the item type\n */\nexport type TSortOptions<T> = {\n     [K in keyof T]?: TSortOrder;\n};\n\n/**\n * Sort entry for array-based sorting\n */\nexport type TSortEntry = {\n     path: string;\n     value: 1 | -1;\n};\n\n// ** ============================================================================\n// ** Filter Types\n// ** ============================================================================\n\n/**\n * Filter configuration for automatic filtering\n */\nexport type TFilterConfig = {\n     [key: string]: {\n          // ** Type of filter matching\n          type: 'regex' | 'exact';\n          // ** Optional: different database field name\n          field?: string;\n     };\n};\n\n/**\n * Custom filter configuration\n * Allows defining custom filter functions for specific filter keys\n */\nexport type TFilterCustomConfig<T = unknown> = {\n     [id: string]: (data: unknown) => TMongoFilterQuery<T>;\n};\n\n/**\n * Variant of TFilterCustomConfig that allows customizing the returned filter shape.\n * Useful for Mongo (operator-based) vs. other ORMs (where clauses) in the future.\n */\nexport type TFilterCustomConfigWithFilter<TDoc = unknown, TFilter = TMongoFilterQuery<TDoc>> = {\n     [id: string]: (data: unknown) => TFilter;\n};\n\n// ** ============================================================================\n// ** Input/Output Types\n// ** ============================================================================\n\n/**\n * React Data Kit server action input\n */\nexport type TDataKitInput<T = unknown> = {\n     // ** Action type - currently only FETCH is supported\n     action?: 'FETCH';\n     // ** Current page number (1-indexed)\n     page?: number;\n     // ** Number of items per page\n     limit?: number;\n     // ** Legacy sort option\n     sort?: TSortOptions<T>;\n     // ** Multi-sort as an array\n     sorts?: TSortEntry[];\n     // ** Query parameters for exact match filtering\n     query?: Record<string, unknown>;\n     // ** Filter parameters\n     filter?: Record<string, unknown>;\n     // ** Filter configuration for automatic filtering\n     filterConfig?: TFilterConfig;\n     // ** Custom filter configuration\n     filterCustom?: TFilterCustomConfig<T>;\n};\n\n/**\n * React Data Kit server action result\n */\nexport type TDataKitResult<R> = {\n     type: 'ITEMS';\n     items: R[];\n     documentTotal: number;\n};\n\n// ** ============================================================================\n// ** Pagination Types\n// ** ============================================================================\n\n/**\n * Pagination info for client-side use\n */\nexport type TPaginationInfo = {\n     currentPage: number;\n     totalPages: number;\n     totalItems: number;\n     itemsPerPage: number;\n     hasNextPage: boolean;\n     hasPrevPage: boolean;\n};\n\n/**\n * Calculate pagination info from next-data-kit result\n */\nexport const calculatePagination = (page: number, limit: number, total: number): TPaginationInfo => ({\n     currentPage: page,\n     totalPages: Math.ceil(total / limit),\n     totalItems: total,\n     itemsPerPage: limit,\n     hasNextPage: page * limit < total,\n     hasPrevPage: page > 1,\n});\n\n// ** ============================================================================\n// ** Adapter Types\n// ** ============================================================================\n\n/**\n * React Data Kit Adapter Interface\n * Defines the contract for a database adapter.\n */\nexport type TDataKitAdapter<T> = (params: Readonly<{\n     filter: Record<string, unknown>;\n     sorts: TSortEntry[];\n     limit: number;\n     page: number;\n     skip: number;\n     input: TDataKitInput<T>;\n}>) => Promise<{ items: T[]; total: number }>;\n"]}

package/dist/types/react-data-kit.d.ts

@@ -0,0 +1,95 @@
+/**
+ * react-data-kit - React Data Kit Types
+ *
+ * Core types for the react-data-kit server action and components.
+ */
+import type { TMongoFilterQuery, TSortOrder } from './database/mongo';
+/**
+ * Sort options type that references keys from the item type
+ */
+export type TSortOptions<T> = {
+    [K in keyof T]?: TSortOrder;
+};
+/**
+ * Sort entry for array-based sorting
+ */
+export type TSortEntry = {
+    path: string;
+    value: 1 | -1;
+};
+/**
+ * Filter configuration for automatic filtering
+ */
+export type TFilterConfig = {
+    [key: string]: {
+        type: 'regex' | 'exact';
+        field?: string;
+    };
+};
+/**
+ * Custom filter configuration
+ * Allows defining custom filter functions for specific filter keys
+ */
+export type TFilterCustomConfig<T = unknown> = {
+    [id: string]: (data: unknown) => TMongoFilterQuery<T>;
+};
+/**
+ * Variant of TFilterCustomConfig that allows customizing the returned filter shape.
+ * Useful for Mongo (operator-based) vs. other ORMs (where clauses) in the future.
+ */
+export type TFilterCustomConfigWithFilter<TDoc = unknown, TFilter = TMongoFilterQuery<TDoc>> = {
+    [id: string]: (data: unknown) => TFilter;
+};
+/**
+ * React Data Kit server action input
+ */
+export type TDataKitInput<T = unknown> = {
+    action?: 'FETCH';
+    page?: number;
+    limit?: number;
+    sort?: TSortOptions<T>;
+    sorts?: TSortEntry[];
+    query?: Record<string, unknown>;
+    filter?: Record<string, unknown>;
+    filterConfig?: TFilterConfig;
+    filterCustom?: TFilterCustomConfig<T>;
+};
+/**
+ * React Data Kit server action result
+ */
+export type TDataKitResult<R> = {
+    type: 'ITEMS';
+    items: R[];
+    documentTotal: number;
+};
+/**
+ * Pagination info for client-side use
+ */
+export type TPaginationInfo = {
+    currentPage: number;
+    totalPages: number;
+    totalItems: number;
+    itemsPerPage: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+};
+/**
+ * Calculate pagination info from react-data-kit result
+ */
+export declare const calculatePagination: (page: number, limit: number, total: number) => TPaginationInfo;
+/**
+ * React Data Kit Adapter Interface
+ * Defines the contract for a database adapter.
+ */
+export type TDataKitAdapter<T> = (params: Readonly<{
+    filter: Record<string, unknown>;
+    sorts: TSortEntry[];
+    limit: number;
+    page: number;
+    skip: number;
+    input: TDataKitInput<T>;
+}>) => Promise<{
+    items: T[];
+    total: number;
+}>;
+//# sourceMappingURL=react-data-kit.d.ts.map

package/dist/types/selectable.d.ts

@@ -0,0 +1,43 @@
+/**
+ * react-data-kit - Selectable Types
+ *
+ * Types for selectable/multi-select functionality in tables.
+ */
+/**
+ * Selection state for a table
+ */
+export type TSelectionState<T = string> = {
+    selectedIds: Set<T>;
+    isAllSelected: boolean;
+    isIndeterminate: boolean;
+};
+/**
+ * Selection actions for a table
+ */
+export type TSelectionActions<T = string> = {
+    select: (id: T) => void;
+    deselect: (id: T) => void;
+    toggle: (id: T) => void;
+    selectAll: (ids: T[]) => void;
+    deselectAll: () => void;
+    toggleAll: (ids: T[]) => void;
+    isSelected: (id: T) => boolean;
+    getSelectedArray: () => T[];
+};
+/**
+ * Combined selection hook return type
+ */
+export type TUseSelectionReturn<T = string> = TSelectionState<T> & TSelectionActions<T>;
+/**
+ * Selection mode for tables
+ */
+export type TSelectionMode = 'single' | 'multiple' | 'none';
+/**
+ * Selectable item type
+ */
+export type TSelectable = {
+    id: string;
+    selected?: boolean;
+    disabled?: boolean;
+};
+//# sourceMappingURL=selectable.d.ts.map