@leancodepl/antd-table-hooks 10.1.3

package/dist/lib/filters/index.d.ts

@@ -0,0 +1,37 @@
+import { DefinedSearchSchema, FilterDefinition } from './types';
+export * from './useFilters';
+export * from './types';
+/**
+ * Creates a typed filter definition factory along with a combined Zod search schema for URL param validation.
+ * Call with a query type generic, then pass an array of filter definitions (or a factory function for
+ * context-dependent filters). Returns `{ searchSchema, filters }` where `searchSchema` is used with
+ * `tableSearchSchema` for route validation.
+ *
+ * @returns A function that accepts filter definitions and returns `{ searchSchema, filters }`
+ *
+ * @example
+ * ```typescript
+ * import { defineFilters, FilterDefinition } from "@leancodepl/antd-table-hooks";
+ *
+ * // Static filters
+ * const { searchSchema, filters } = defineFilters<SearchQuery>()([
+ *   myTextFilter({ id: "email", tableId: "users", label: "Email", filter: (v, q) => ({ ...q, Email: v }) }),
+ * ]);
+ *
+ * // Context-dependent filters
+ * const { searchSchema, filters: filtersFn } = defineFilters<SearchQuery, { intl: IntlShape }>()(
+ *   context => [
+ *     myTextFilter({ id: "name", tableId: "users", label: "Name", placeholder: context?.intl.formatMessage({ defaultMessage: "Name" }) }),
+ *   ],
+ * );
+ * ```
+ */
+export declare function defineFilters<TQuery>(): <TFilters extends FilterDefinition<TQuery, any, string>[]>(filters: TFilters) => {
+    searchSchema: DefinedSearchSchema<TFilters>;
+    filters: TFilters;
+};
+export declare function defineFilters<TQuery, TContext extends Record<string, unknown>>(): <TFilters extends FilterDefinition<TQuery, any, string>[]>(filters: (context?: TContext) => TFilters) => {
+    searchSchema: DefinedSearchSchema<TFilters>;
+    filters: (context?: TContext) => TFilters;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/filters/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAA4B,MAAM,SAAS,CAAA;AAEzF,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,MAAM,KAAK,CAAC,QAAQ,SAAS,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EAChG,OAAO,EAAE,QAAQ,KACd;IACH,YAAY,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC3C,OAAO,EAAE,QAAQ,CAAA;CAClB,CAAA;AACD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CACjF,QAAQ,SAAS,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EAExD,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,QAAQ,KACtC;IACH,YAAY,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAA;CAC1C,CAAA"}

package/dist/lib/filters/types.d.ts

@@ -0,0 +1,37 @@
+import { ComponentType } from 'react';
+import { Observable } from 'rxjs';
+import { z } from 'zod';
+type FilterProps<TQuery, TSchema> = {
+    applyFilter(applyFilter: ((query: TQuery) => TQuery) | undefined, value?: unknown): void;
+    reset$: Observable<unknown>;
+    initialValue?: TSchema;
+};
+type SearchSchemaEntries = readonly (readonly [string, z.ZodType])[];
+type InferSearchSchema<T extends SearchSchemaEntries> = {
+    [E in T[number] as E[0]]: z.infer<E[1]>;
+};
+export type FilterDefinition<TQuery, TValue = unknown, TId extends string = string, TSearchSchema extends SearchSchemaEntries = SearchSchemaEntries> = {
+    id: TId;
+    component: ComponentType<FilterProps<TQuery, TValue>>;
+    buildApplyFilter?: (value: TValue) => ((query: TQuery) => TQuery) | undefined;
+} & ({
+    searchSchema: TSearchSchema;
+    toSearchParams: (value: TValue) => InferSearchSchema<TSearchSchema>;
+    fromSearchParams: (params: InferSearchSchema<TSearchSchema>) => TValue | undefined;
+} | {
+    searchSchema?: undefined;
+    toSearchParams?: undefined;
+    fromSearchParams?: undefined;
+});
+type ExtractSearchEntries<F> = F extends {
+    searchSchema: infer SD extends SearchSchemaEntries;
+} ? SD[number] : never;
+export type FiltersSearchSchemaShape<TFilters extends FilterDefinition<any, any, string>[]> = {
+    [E in ExtractSearchEntries<TFilters[number]> as E[0]]: E[1];
+};
+export type InferFiltersSchema<TFilters extends FilterDefinition<any, any, string>[]> = {
+    [K in TFilters[number] as K extends FilterDefinition<any, any, infer Id extends string> ? Id : never]: K extends FilterDefinition<any, infer S, any> ? S : never;
+};
+export type DefinedSearchSchema<TFilters extends FilterDefinition<any, any, string>[]> = z.ZodObject<FiltersSearchSchemaShape<TFilters>>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/filters/types.d.ts.map

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

package/dist/lib/filters/useFilters.d.ts

@@ -0,0 +1,41 @@
+import { ReactNode } from 'react';
+import { FilterDefinition } from './types';
+export type UseFiltersProps<TQuery, TValues extends Record<string, unknown> = Record<string, unknown>> = {
+    filters: FilterDefinition<TQuery, any, string>[];
+    onFiltersChange?: (filters: Record<string, ((value: TQuery) => TQuery) | undefined>, values: TValues) => void;
+    initialValues?: Partial<TValues>;
+};
+/**
+ * Manages filter state and produces an `applyFilters` function that applies all active filters to a query object.
+ * Returns filter React components and helpers for resetting filters and checking if any filter is active.
+ *
+ * @param props.filters - Array of filter definitions (from `defineFilters`)
+ * @param props.onFiltersChange - Callback invoked when any filter value changes, receives all filter functions and current values
+ * @param props.initialValues - Initial filter values (e.g. restored from URL params via `useTable().filters.values`)
+ * @returns Object containing `applyFilters(query)`, `filterComponents` (React nodes), `resetFilters()`, and `anyFilterSet` boolean
+ *
+ * @example
+ * ```typescript
+ * import { useFilters } from "@leancodepl/antd-table-hooks";
+ *
+ * const { applyFilters, filters } = useFilters({
+ *   filters: userFilters,
+ *   onFiltersChange: resetPage,
+ * });
+ *
+ * const query = applyFilters({ PageNumber: page, PageSize: pageSize });
+ * ```
+ */
+export declare function useFilters<TQuery, TValues extends Record<string, unknown> = Record<string, unknown>>({ filters, onFiltersChange, initialValues, }: UseFiltersProps<TQuery, TValues>): {
+    filterComponents: ReactNode[];
+    applyFilters: (query: TQuery) => TQuery;
+    resetFilters: () => void;
+    anyFilterSet: boolean;
+    filters: {
+        filterComponents: ReactNode[];
+        applyFilters: (query: TQuery) => TQuery;
+        resetFilters: () => void;
+        anyFilterSet: boolean;
+    };
+};
+//# sourceMappingURL=useFilters.d.ts.map

package/dist/lib/filters/useFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFilters.d.ts","sourceRoot":"","sources":["../../../src/lib/filters/useFilters.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0C,MAAM,OAAO,CAAA;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C,MAAM,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACvG,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAA;IAChD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7G,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACpG,OAAO,EACP,eAAe,EACf,aAAa,GACd,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;;0BAcvB,MAAM;;;;;8BAAN,MAAM;;;;EAoCjB"}

package/dist/lib/index.d.ts

@@ -0,0 +1,5 @@
+export * from './filters';
+export * from './sorting';
+export * from './pagination';
+export * from './table';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/lib/pagination/index.d.ts

@@ -0,0 +1,53 @@
+import { TablePaginationConfig } from 'antd/lib';
+type UsePaginationProps = {
+    initialDisplayPage?: number;
+    initialPageSize?: number;
+    onPaginationChange?: (props: {
+        displayPage: number;
+        pageSize: number;
+    }) => void;
+};
+type QueryStatePagination = {
+    displayPage: number;
+    pageSize: number;
+    onPaginationChange: (props: {
+        displayPage: number;
+        pageSize: number;
+    }) => void;
+};
+/**
+ * Manages table pagination state with zero-indexed page output for API calls. Supports two modes:
+ * URL-driven (via `useTable().pagination`) or standalone with local state. Returns a
+ * `getTablePagination` helper that produces an Ant Design `TablePaginationConfig`.
+ *
+ * @param props - Either a `QueryStatePagination` object from `useTable().pagination`, or an optional object with `initialDisplayPage`, `initialPageSize`, and `onPaginationChange` callback
+ * @returns Object containing zero-indexed `page`, `pageSize`, `getTablePagination(total)` function, and `resetPage` function
+ *
+ * @example
+ * ```typescript
+ * import { usePagination } from "@leancodepl/antd-table-hooks";
+ *
+ * // With URL state (via useTable)
+ * const { page, pageSize, getTablePagination, resetPage } = usePagination(queryState.pagination);
+ *
+ * // Standalone
+ * const { page, pageSize, getTablePagination, resetPage } = usePagination();
+ *
+ * // Pass to Ant Design table
+ * <Table pagination={getTablePagination(data?.totalCount)} />
+ * ```
+ */
+export declare function usePagination(queryStatePagination: QueryStatePagination): {
+    page: number;
+    pageSize: number;
+    getTablePagination: (total?: number) => TablePaginationConfig;
+    resetPage: () => void;
+};
+export declare function usePagination(props?: UsePaginationProps): {
+    page: number;
+    pageSize: number;
+    getTablePagination: (total?: number) => TablePaginationConfig;
+    resetPage: () => void;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/pagination/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/pagination/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAGhD,KAAK,kBAAkB,GAAG;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CAChF,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CAC/E,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,oBAAoB,EAAE,oBAAoB,GAAG;IACzE,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,qBAAqB,CAAA;IAC7D,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA;AACD,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,qBAAqB,CAAA;IAC7D,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA"}

package/dist/lib/sorting/index.d.ts

@@ -0,0 +1,77 @@
+import { Key } from 'react';
+import { SortOrder } from 'antd/es/table/interface';
+import { SortData } from '../types';
+type QueryStateSorting<TKey extends Key> = {
+    sortKey: TKey;
+    sortDirection: SortOrder;
+    onSortUpdate: (sortKey?: TKey, sortDirection?: SortOrder) => void;
+};
+/**
+ * Manages table column sorting state. Supports two modes: URL-driven (via `useTable().sorting`)
+ * or standalone with local state.
+ *
+ * @param props - Either a `QueryStateSorting` object from `useTable().sorting`, or an object with `defaultSortKey`, `defaultSortDirection`, and optional `onSortUpdate` callback
+ * @returns Object containing `sortData` (pass to Ant Design table's `sort` prop), current `sortKey`, `sortDirection`, and `isDescending` boolean
+ *
+ * @example
+ * ```typescript
+ * import { useSorting } from "@leancodepl/antd-table-hooks";
+ *
+ * // With URL state (via useTable)
+ * const { sortData, sortKey, isDescending } = useSorting(queryState.sorting);
+ *
+ * // Standalone
+ * const { sortData, sortKey, isDescending } = useSorting({
+ *   defaultSortKey: SortKey.Name,
+ *   defaultSortDirection: "ascend",
+ * });
+ * ```
+ */
+export declare function useSorting<TKey extends Key, TData>(queryStateSorting: QueryStateSorting<TKey>): {
+    sortData: SortData<TData>;
+    sortKey: TKey;
+    sortDirection: SortOrder;
+    isDescending: boolean;
+};
+export declare function useSorting<TKey extends Key, TData>(props: {
+    defaultSortKey: TKey;
+    defaultSortDirection: SortOrder;
+    onSortUpdate?: (sortKey?: TKey, sortDirection?: SortOrder) => void;
+}): {
+    sortData: SortData<TData>;
+    sortKey: TKey;
+    sortDirection: SortOrder;
+    isDescending: boolean;
+};
+export declare function useSorting<TKey extends Key, TData>(props: {
+    defaultSortKey: TKey;
+    defaultSortDirection?: SortOrder;
+    onSortUpdate?: (sortKey?: TKey, sortDirection?: SortOrder) => void;
+}): {
+    sortData: SortData<TData>;
+    sortKey: TKey;
+    sortDirection?: SortOrder;
+    isDescending: boolean;
+};
+export declare function useSorting<TKey extends Key, TData>(props: {
+    defaultSortKey?: TKey;
+    defaultSortDirection: SortOrder;
+    onSortUpdate?: (sortKey?: TKey, sortDirection?: SortOrder) => void;
+}): {
+    sortData: SortData<TData>;
+    sortKey?: TKey;
+    sortDirection: SortOrder;
+    isDescending: boolean;
+};
+export declare function useSorting<TKey extends Key, TData>(props: {
+    defaultSortKey?: TKey;
+    defaultSortDirection?: SortOrder;
+    onSortUpdate?: (sortKey?: TKey, sortDirection?: SortOrder) => void;
+}): {
+    sortData: SortData<TData>;
+    sortKey?: TKey;
+    sortDirection?: SortOrder;
+    isDescending: boolean;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/sorting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/sorting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAqB,MAAM,OAAO,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnC,KAAK,iBAAiB,CAAC,IAAI,SAAS,GAAG,IAAI;IACzC,OAAO,EAAE,IAAI,CAAA;IACb,aAAa,EAAE,SAAS,CAAA;IACxB,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;CAClE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAChD,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC,GACzC;IAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAA;AAChG,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;IACzD,cAAc,EAAE,IAAI,CAAA;IACpB,oBAAoB,EAAE,SAAS,CAAA;IAC/B,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;CACnE,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAA;AACjG,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;IACzD,cAAc,EAAE,IAAI,CAAA;IACpB,oBAAoB,CAAC,EAAE,SAAS,CAAA;IAChC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;CACnE,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAA;AAClG,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;IACzD,cAAc,CAAC,EAAE,IAAI,CAAA;IACrB,oBAAoB,EAAE,SAAS,CAAA;IAC/B,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;CACnE,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAA;AAClG,wBAAgB,UAAU,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;IACzD,cAAc,CAAC,EAAE,IAAI,CAAA;IACrB,oBAAoB,CAAC,EAAE,SAAS,CAAA;IAChC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;CACnE,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAA"}

package/dist/lib/table/index.d.ts

@@ -0,0 +1,113 @@
+import { Key } from 'react';
+import { SortOrder } from 'antd/es/table/interface';
+import { default as z } from 'zod';
+import { DefinedSearchSchema, FilterDefinition, InferFiltersSchema } from '../filters/types';
+type UseQueryStateProps<TQueryParams extends Record<string, unknown>, TDefined extends FilterDefinition<any, any, string>[], TSortKey extends Key> = {
+    queryParams: TQueryParams;
+    setQueryParams: (params: TQueryParams) => void;
+    definedFilters: TDefined;
+    tableId: string;
+    defaultSortKey: TSortKey;
+    defaultSortDirection: SortOrder;
+    defaultPageSize?: number;
+};
+/**
+ * Orchestrates table sorting, pagination, and filter state through URL query parameters.
+ * Reads current state from `queryParams` and writes updates via `setQueryParams`, enabling
+ * shareable links, browser navigation, and state restoration on page reload.
+ *
+ * @param props.queryParams - Current URL search params object (e.g. from TanStack Router's `useSearch`)
+ * @param props.setQueryParams - Callback to update URL search params (e.g. via `navigate({ search })`)
+ * @param props.definedFilters - Filter definitions created by `defineFilters`
+ * @param props.tableId - Unique prefix for URL params to avoid collisions between tables on the same route
+ * @param props.defaultSortKey - Initial sort column key
+ * @param props.defaultSortDirection - Initial sort direction (`"ascend"` or `"descend"`)
+ * @param props.defaultPageSize - Initial page size (defaults to 100)
+ * @returns Object with `filters`, `pagination`, and `sorting` state to pass to `useFilters`, `usePagination`, and `useSorting`
+ *
+ * @example
+ * ```typescript
+ * import { useTable, useSorting, usePagination, useFilters } from "@leancodepl/antd-table-hooks";
+ *
+ * const queryState = useTable({
+ *   queryParams: search,
+ *   setQueryParams: params => navigate({ search: params }),
+ *   definedFilters: userFilters,
+ *   tableId: "users",
+ *   defaultSortKey: SortKey.CreatedAt,
+ *   defaultSortDirection: "descend",
+ * });
+ *
+ * const { sortData, sortKey, isDescending } = useSorting(queryState.sorting);
+ * const { page, pageSize, getTablePagination, resetPage } = usePagination(queryState.pagination);
+ * ```
+ */
+export declare function useTable<TQueryParams extends Record<string, unknown>, TFilters extends FilterDefinition<any, any, string>[], TSortKey extends Key = Key>({ queryParams, setQueryParams, definedFilters, tableId, defaultSortKey, defaultSortDirection, defaultPageSize, }: UseQueryStateProps<TQueryParams, TFilters, TSortKey>): {
+    filters: {
+        values: Partial<InferFiltersSchema<TFilters>> | undefined;
+        onFiltersChange: (values?: Partial<InferFiltersSchema<TFilters>>) => void;
+    };
+    pagination: {
+        onPaginationChange: ({ displayPage, pageSize }: {
+            displayPage: number;
+            pageSize: number;
+        }) => void;
+        displayPage: number;
+        pageSize: number;
+    };
+    sorting: {
+        onSortUpdate: (sortKey?: TSortKey, sortDirection?: SortOrder) => void;
+        sortKey: TSortKey;
+        sortDirection: SortOrder;
+    };
+};
+/**
+ * Creates a Zod schema for pagination URL parameters (`{tableId}-displayPage`, `{tableId}-pageSize`).
+ *
+ * @param tableId - Unique table identifier used to prefix parameter names
+ * @returns Zod object schema for pagination params
+ *
+ * @example
+ * ```typescript
+ * import { buildPaginationSearchSchema } from "@leancodepl/antd-table-hooks";
+ *
+ * const paginationSchema = buildPaginationSearchSchema("users");
+ * ```
+ */
+export declare function buildPaginationSearchSchema<TTableId extends string>(tableId: TTableId): z.ZodObject<Record<`${TTableId}-displayPage` | `${TTableId}-pageSize`, z.ZodOptional<z.ZodCoercedNumber<unknown>>> extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
+/**
+ * Creates a Zod schema for sorting URL parameters (`{tableId}-sortKey`, `{tableId}-sortDescending`).
+ *
+ * @param tableId - Unique table identifier used to prefix parameter names
+ * @param sortKeySchema - Zod schema for the sort key type (e.g. `z.coerce.number()` for numeric enums)
+ * @returns Zod object schema for sorting params
+ *
+ * @example
+ * ```typescript
+ * import { buildSortingSearchSchema } from "@leancodepl/antd-table-hooks";
+ * import z from "zod";
+ *
+ * const sortingSchema = buildSortingSearchSchema("users", z.coerce.number());
+ * ```
+ */
+export declare function buildSortingSearchSchema<TTableId extends string, TSortKey extends z.ZodType>(tableId: TTableId, sortKeySchema: TSortKey): z.ZodObject<Record<`${TTableId}-sortDescending`, z.ZodOptional<z.ZodCoercedBoolean<unknown>>> & Record<`${TTableId}-sortKey`, z.ZodOptional<TSortKey>> extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
+/**
+ * Combines filter, pagination, and sorting schemas into a single Zod schema for route validation.
+ * Use the result as the `validateSearch` option in TanStack Router route definitions.
+ *
+ * @param filtersSearchSchema - Search schema returned by `defineFilters`
+ * @param tableId - Unique table identifier used to prefix parameter names
+ * @param sortKeySchema - Zod schema for the sort key type (e.g. `z.coerce.number()` for numeric enums)
+ * @returns Combined Zod object schema covering all table URL parameters
+ *
+ * @example
+ * ```typescript
+ * import { tableSearchSchema } from "@leancodepl/antd-table-hooks";
+ * import z from "zod";
+ *
+ * const searchSchema = tableSearchSchema(filtersSearchSchema, "users", z.coerce.number());
+ * ```
+ */
+export declare const tableSearchSchema: <TTableId extends string, TFilters extends FilterDefinition<any, any, string>[], TSortKey extends z.ZodType>(filtersSearchSchema: DefinedSearchSchema<TFilters>, tableId: TTableId, sortKeySchema: TSortKey) => z.ZodObject<import('..').FiltersSearchSchemaShape<TFilters> & (Record<`${TTableId}-displayPage` | `${TTableId}-pageSize`, z.ZodOptional<z.ZodCoercedNumber<unknown>>> extends infer T_1 ? { -readonly [P_1 in keyof T_1]: T_1[P_1]; } : never) & (Record<`${TTableId}-sortDescending`, z.ZodOptional<z.ZodCoercedBoolean<unknown>>> & Record<`${TTableId}-sortKey`, z.ZodOptional<TSortKey>> extends infer T_2 ? { -readonly [P_2 in keyof T_2]: T_2[P_2]; } : never) extends infer T ? { -readonly [P in keyof T]: T[P]; } : never, z.core.$strip>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/table/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwB,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,CAAC,MAAM,KAAK,CAAA;AACnB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE5F,KAAK,kBAAkB,CACrB,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,QAAQ,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EACrD,QAAQ,SAAS,GAAG,IAClB;IACF,WAAW,EAAE,YAAY,CAAA;IACzB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAC9C,cAAc,EAAE,QAAQ,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,QAAQ,CAAA;IACxB,oBAAoB,EAAE,SAAS,CAAA;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,QAAQ,CACtB,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,QAAQ,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EACrD,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,EACA,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EACP,cAAc,EACd,oBAAoB,EACpB,eAAsC,GACvC,EAAE,kBAAkB,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC;;;mCA6CzC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;;;wDAqCnB;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE;;;;;iCAsB1D,QAAQ,kBAAkB,SAAS;;uBAhEf,SAAS;;EAqG3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,MAAM,EAAE,OAAO,EAAE,QAAQ,oMAOrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,SAAS,MAAM,EAAE,QAAQ,SAAS,CAAC,CAAC,OAAO,EAC1F,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,QAAQ,wOASxB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,MAAM,EACvB,QAAQ,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EACrD,QAAQ,SAAS,CAAC,CAAC,OAAO,EAE1B,qBAAqB,mBAAmB,CAAC,QAAQ,CAAC,EAClD,SAAS,QAAQ,EACjB,eAAe,QAAQ,whBAMrB,CAAA"}

package/dist/lib/types.d.ts

@@ -0,0 +1,6 @@
+import { SorterResult } from 'antd/es/table/interface';
+export type SortData<TData> = {
+    data?: SorterResult<TData>;
+    onChange: (sortData?: SorterResult<TData>) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI;IAC5B,IAAI,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAC1B,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;CACnD,CAAA"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@leancodepl/antd-table-hooks",
+  "version": "10.1.3",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@leancodepl/utils": "10.1.3",
+    "antd": "^5.0.0",
+    "rxjs": ">=7.0.0",
+    "zod": "^4.0.5"
+  },
+  "devDependencies": {
+    "@testing-library/react": "*",
+    "react": "*",
+    "vitest": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leancodepl/js_corelibrary.git",
+    "directory": "packages/antd-table-hooks"
+  },
+  "homepage": "https://github.com/leancodepl/js_corelibrary",
+  "bugs": {
+    "url": "https://github.com/leancodepl/js_corelibrary/issues"
+  },
+  "description": "Ant Design Table hooks for React",
+  "keywords": [
+    "antd",
+    "table",
+    "hooks",
+    "react",
+    "typescript",
+    "javascript",
+    "leancode"
+  ],
+  "author": {
+    "name": "LeanCode",
+    "url": "https://leancode.co"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "!**/*.tsbuildinfo"
+  ]
+}