@wordrhyme/auto-crud 0.10.0 → 1.0.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { z } from "zod";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
@@ -314,7 +314,7 @@ declare function AutoTableActionBar<TData>({
   enableExport,
   enableDelete,
   extraActions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime1.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
@@ -463,9 +463,34 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   enableExport,
   onSelectedCountChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime1.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-crud-table.d.ts
+/**
+ * 筛选器独立配置
+ * 可独立于 table.meta 配置筛选器行为
+ */
+interface FilterConfig {
+  /** 是否启用筛选（默认跟随 table.meta.variant 推断） */
+  enabled?: boolean;
+  /** 筛选器类型 */
+  variant?: "text" | "number" | "range" | "date" | "dateRange" | "boolean" | "select" | "multiSelect";
+  /** select/multiSelect 的选项列表 */
+  options?: Array<{
+    label: string;
+    value: string;
+    count?: number;
+    icon?: React$1.FC<React$1.SVGProps<SVGSVGElement>>;
+  }>;
+  /** range 的最小/最大值 */
+  range?: [number, number];
+  /** number 的单位 */
+  unit?: string;
+  /** 过滤器占位符 */
+  placeholder?: string;
+  /** 是否在筛选栏中隐藏（隐藏筛选但不影响表格列显示） */
+  hidden?: boolean;
+}
 /**
  * 统一字段配置
  * 支持共用配置 + 表格/表单特定配置
@@ -475,6 +500,11 @@ interface Field {
   label?: string;
   /** 是否隐藏（表格和表单都隐藏） */
   hidden?: boolean;
+  /**
+   * 筛选器独立配置
+   * 独立于 table.meta 控制筛选器行为，不影响表格列显示/隐藏
+   */
+  filter?: FilterConfig;
   /** 表格特定配置 */
   table?: {
     /** 是否在表格中隐藏 */
@@ -591,7 +621,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   form: formConfig,
   slots,
   permissions
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime1.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -623,11 +653,87 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime1.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime3.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
 //#endregion
+//#region src/hooks/use-url-state.d.ts
+/**
+ * URL 状态管理 Hook - 替代 nuqs
+ * 将 React 状态同步到 URL query string
+ *
+ * 架构说明：
+ * - 使用 queueMicrotask 延迟 URL 更新，确保在渲染完成后执行
+ * - 符合 React 渲染规则，不会触发 "Cannot update a component while rendering" 错误
+ */
+interface UrlStateOptions {
+  /** 历史记录模式: push 添加新记录, replace 替换当前记录 */
+  history?: "push" | "replace";
+  /** 是否浅层更新（不触发页面刷新） */
+  shallow?: boolean;
+  /** 节流时间（毫秒） */
+  throttleMs?: number;
+  /** 防抖时间（毫秒） */
+  debounceMs?: number;
+  /** 当值等于默认值时是否清除 URL 参数 */
+  clearOnDefault?: boolean;
+  /** 滚动到顶部 */
+  scroll?: boolean;
+  /** React transition */
+  startTransition?: React$1.TransitionStartFunction;
+}
+interface Parser<T> {
+  parse: (value: string) => T;
+  serialize: (value: T) => string;
+}
+declare const parseAsInteger: Parser<number> & {
+  withDefault: (defaultValue: number) => Parser<number> & {
+    defaultValue: number;
+  };
+};
+declare const parseAsString: Parser<string> & {
+  withDefault: (defaultValue: string) => Parser<string> & {
+    defaultValue: string;
+  };
+};
+declare function parseAsStringEnum<T extends string>(validValues: readonly T[]): Parser<T | null> & {
+  withDefault: (defaultValue: T) => Parser<T> & {
+    defaultValue: T;
+  };
+};
+declare function parseAsArrayOf<T>(itemParser: Parser<T>, separator?: string): Parser<T[]> & {
+  withDefault: (defaultValue: T[]) => Parser<T[]> & {
+    defaultValue: T[];
+  };
+};
+declare function getUrlParams(): URLSearchParams;
+declare function setSearchParams(params: URLSearchParams, options?: Pick<UrlStateOptions, "history" | "scroll">): void;
+/**
+ * 单个 URL 状态参数
+ */
+declare function useUrlState<T>(key: string, parser: Parser<T> & {
+  defaultValue?: T;
+}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => void];
+/**
+ * 多个 URL 状态参数
+ */
+declare function useUrlStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
+  defaultValue?: T[K];
+} }, options?: UrlStateOptions): [T, (values: Partial<T>) => void];
+/**
+ * nuqs 兼容层 - useQueryState
+ */
+declare function useQueryState<T>(key: string, parser: Parser<T> & {
+  defaultValue?: T;
+}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => Promise<URLSearchParams>];
+/**
+ * nuqs 兼容层 - useQueryStates
+ */
+declare function useQueryStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
+  defaultValue?: T[K];
+} }, options?: UrlStateOptions): [T, (values: Partial<T>) => Promise<URLSearchParams>];
+//#endregion
 //#region src/config/data-table.d.ts
 type DataTableConfig = typeof dataTableConfig;
 declare const dataTableConfig: {
@@ -754,82 +860,6 @@ declare const dataTableConfig: {
   joinOperators: readonly ["and", "or"];
 };
 //#endregion
-//#region src/hooks/use-url-state.d.ts
-/**
- * URL 状态管理 Hook - 替代 nuqs
- * 将 React 状态同步到 URL query string
- *
- * 架构说明：
- * - 使用 queueMicrotask 延迟 URL 更新，确保在渲染完成后执行
- * - 符合 React 渲染规则，不会触发 "Cannot update a component while rendering" 错误
- */
-interface UrlStateOptions {
-  /** 历史记录模式: push 添加新记录, replace 替换当前记录 */
-  history?: "push" | "replace";
-  /** 是否浅层更新（不触发页面刷新） */
-  shallow?: boolean;
-  /** 节流时间（毫秒） */
-  throttleMs?: number;
-  /** 防抖时间（毫秒） */
-  debounceMs?: number;
-  /** 当值等于默认值时是否清除 URL 参数 */
-  clearOnDefault?: boolean;
-  /** 滚动到顶部 */
-  scroll?: boolean;
-  /** React transition */
-  startTransition?: React$1.TransitionStartFunction;
-}
-interface Parser<T> {
-  parse: (value: string) => T;
-  serialize: (value: T) => string;
-}
-declare const parseAsInteger: Parser<number> & {
-  withDefault: (defaultValue: number) => Parser<number> & {
-    defaultValue: number;
-  };
-};
-declare const parseAsString: Parser<string> & {
-  withDefault: (defaultValue: string) => Parser<string> & {
-    defaultValue: string;
-  };
-};
-declare function parseAsStringEnum<T extends string>(validValues: readonly T[]): Parser<T | null> & {
-  withDefault: (defaultValue: T) => Parser<T> & {
-    defaultValue: T;
-  };
-};
-declare function parseAsArrayOf<T>(itemParser: Parser<T>, separator?: string): Parser<T[]> & {
-  withDefault: (defaultValue: T[]) => Parser<T[]> & {
-    defaultValue: T[];
-  };
-};
-declare function getUrlParams(): URLSearchParams;
-declare function setSearchParams(params: URLSearchParams, options?: Pick<UrlStateOptions, "history" | "scroll">): void;
-/**
- * 单个 URL 状态参数
- */
-declare function useUrlState<T>(key: string, parser: Parser<T> & {
-  defaultValue?: T;
-}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => void];
-/**
- * 多个 URL 状态参数
- */
-declare function useUrlStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
-  defaultValue?: T[K];
-} }, options?: UrlStateOptions): [T, (values: Partial<T>) => void];
-/**
- * nuqs 兼容层 - useQueryState
- */
-declare function useQueryState<T>(key: string, parser: Parser<T> & {
-  defaultValue?: T;
-}, options?: UrlStateOptions): [T, (value: T | ((prev: T) => T)) => Promise<URLSearchParams>];
-/**
- * nuqs 兼容层 - useQueryStates
- */
-declare function useQueryStates<T extends Record<string, unknown>>(parsers: { [K in keyof T]: Parser<T[K]> & {
-  defaultValue?: T[K];
-} }, options?: UrlStateOptions): [T, (values: Partial<T>) => Promise<URLSearchParams>];
-//#endregion
 //#region src/lib/parsers.d.ts
 declare const filterItemSchema: z.ZodObject<{
   id: z.ZodString;
@@ -868,6 +898,7 @@ type FilterItemSchema = z.infer<typeof filterItemSchema>;
 declare module "@tanstack/react-table" {
   interface TableMeta<TData extends RowData> {
     queryKeys?: QueryKeys;
+    queryStateOptions?: UrlStateOptions;
   }
   interface ColumnMeta<TData extends RowData, TValue> {
     label?: string;
@@ -918,7 +949,7 @@ declare function AutoTableSimpleFilters<TData>({
   shallow,
   filters: externalFilters,
   onFiltersChange
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime1.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -953,7 +984,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   title,
   labelAlign,
   labelWidth
-}: CrudFormModalProps<T>): react_jsx_runtime1.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -972,7 +1003,7 @@ declare function ImportDialog({
   onImport,
   columns,
   title
-}: ImportDialogProps): react_jsx_runtime1.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -992,7 +1023,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime1.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1005,7 +1036,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime1.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1016,7 +1047,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime1.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1028,7 +1059,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime1.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1042,7 +1073,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime1.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1054,7 +1085,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime1.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1065,7 +1096,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime1.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1076,7 +1107,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime1.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/hooks/use-data-table.d.ts
 interface UseDataTableProps<TData> extends Omit<TableOptions<TData>, "state" | "pageCount" | "getCoreRowModel" | "manualFiltering" | "manualPagination" | "manualSorting">, Required<Pick<TableOptions<TData>, "pageCount">> {
@@ -1411,4 +1442,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataToCSV, downloadCSVTemplate, exportAllToCSV, exportTableToCSV, formatDate, generateCSVTemplate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };
+export { type ActionsColumnConfig, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataToCSV, downloadCSVTemplate, exportAllToCSV, exportTableToCSV, formatDate, generateCSVTemplate, getUrlParams, humanize, noopToastAdapter, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates };