@wordrhyme/auto-crud 1.15.0 → 1.16.0

package/README.md

@@ -2124,3 +2124,47 @@ function EditTags({
 独立使用 `TagFilter` 时，在 `AutoCrudProvider` 内传入 `resourceId="crm.customers"` 和 `field="tags"`，默认显示工具栏按钮；表格内部可省略 `resourceId`，自动继承表格的 CRUD id。嵌入自有条件行可传 `variant="input"`；`id` 和 `className` 对应输入样式的触发按钮，`open/onOpenChange` 可控制其展开状态。值仍通过 `value/onChange` 控制，不需要转换成普通多选数组。
 
 `useAutoCrudResource` 返回 `metadataPending`，`AutoCrudTable` 据此等待字段元数据就绪，再恢复上次视图，避免把尚未加载的扩展字段当成已删除字段。自定义资源应在异步字段加载期间提供 `metadataPending: true`；独立 `AutoTable` 使用 `views={{ fieldsReady: false }}` 暂停恢复和视图切换，字段加载完成后改为 `true`。未提供这些状态时沿用同步字段行为。
+
+## 自定义全局搜索
+
+`table.search.render` 可替换搜索输入框。回调的 `value` / `onValueChange` 沿用表格文字搜索和分页状态；额外条件变化时调用 `resetPage()`。未提供 `render` 时保留默认输入框。
+
+自定义输入框应转发 `onCompositionStart` / `onCompositionEnd`，以沿用中文等输入法的组合输入保护，避免选词完成前发起搜索：
+
+```tsx
+render: ({ value, onValueChange, onCompositionStart, onCompositionEnd, placeholder }) => (
+  <Input
+    value={value}
+    onChange={(event) => onValueChange(event.target.value)}
+    onCompositionStart={onCompositionStart}
+    onCompositionEnd={onCompositionEnd}
+    placeholder={placeholder}
+  />
+);
+```
+
+同一次操作可以先调用 `onValueChange(next)` 再调用 `resetPage()`；分页重置会提交最新文字，不会恢复旧关键词。
+
+```tsx
+const resource = useAutoCrudResource({
+  router: api.products,
+  schema: productSchema,
+  query: (params) => ({ ...params, image }),
+  queryContext: { methodOverride: 'POST' },
+});
+
+<AutoCrudTable
+  resource={resource}
+  schema={productSchema}
+  table={{
+    search: {
+      placeholder: '搜索商品',
+      render: (props) => (
+        <ProductSearch {...props} image={image} onImageChange={setImage} />
+      ),
+    },
+  }}
+/>;
+```
+
+`TableSearchProps` / `TableSearchConfig` 可从包入口导入。`queryContext` 透传给 tRPC 列表与自动导出；自定义 `exportFetcher` 需自行传递请求上下文。服务端须支持所选传输方式。`resource.tableData.error` 暴露查询失败，调用方可展示具体错误；它不把失败当成无匹配结果。

package/dist/index.cjs

@@ -5667,12 +5667,13 @@ function SimpleDateFilter({ title, maxDate, multiple, value, onChange }) {
 
 //#endregion
 //#region src/components/auto-crud/auto-table-search.tsx
-function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "page" }) {
+function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "page", render }) {
 	const [value, setValue] = (0, react.useState)(() => getUrlParams().get("search") ?? "");
+	const valueRef = (0, react.useRef)(value);
 	const composing = (0, react.useRef)(false);
-	const commit = (0, react.useCallback)((next) => {
+	const commit = (0, react.useCallback)((next, resetPage = false) => {
 		const params = getUrlParams();
-		if ((params.get("search") ?? "") === next) return;
+		if ((params.get("search") ?? "") === next && !resetPage) return;
 		if (next) params.set("search", next);
 		else params.delete("search");
 		params.delete(pageKey);
@@ -5683,7 +5684,8 @@ function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "
 	(0, react.useEffect)(() => {
 		const sync = () => {
 			cancel();
-			setValue(getUrlParams().get("search") ?? "");
+			valueRef.current = getUrlParams().get("search") ?? "";
+			setValue(valueRef.current);
 		};
 		window.addEventListener("popstate", sync);
 		window.addEventListener("urlchange", sync);
@@ -5694,23 +5696,37 @@ function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "
 		};
 	}, [cancel, pageKey]);
 	const change = (next) => {
+		valueRef.current = next;
 		setValue(next);
 		cancel();
 		if (composing.current) return;
 		if (!next || debounceMs <= 0) commit(next);
 		else debouncedCommit(next);
 	};
+	const onCompositionStart = () => {
+		composing.current = true;
+		cancel();
+	};
+	const onCompositionEnd = (event) => {
+		composing.current = false;
+		change(event.currentTarget.value);
+	};
+	if (render) return render({
+		value,
+		onValueChange: change,
+		onCompositionStart,
+		onCompositionEnd,
+		placeholder,
+		resetPage: () => {
+			cancel();
+			commit(valueRef.current, true);
+		}
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__wordrhyme_shadcn.Input, {
 		value,
 		onChange: (event) => change(event.target.value),
-		onCompositionStart: () => {
-			composing.current = true;
-			cancel();
-		},
-		onCompositionEnd: (event) => {
-			composing.current = false;
-			change(event.currentTarget.value);
-		},
+		onCompositionStart,
+		onCompositionEnd,
 		placeholder,
 		className: "h-8 w-48 shrink-0"
 	});
@@ -10875,7 +10891,7 @@ function modalReducer(state, action$1) {
 /**
 * Hook 主函数
 */
-function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform, fields, options = {} }) {
+function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform, queryContext, fields, options = {} }) {
 	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher, defaultSort: defaultSortOption } = options;
 	const toast$1 = (0, react.useMemo)(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
 	const hooksRef = (0, react.useRef)(hooks);
@@ -10930,6 +10946,7 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 	]);
 	const hasReadyListData = (0, react.useRef)(false);
 	const listQuery = router.list.useQuery(queryInput, {
+		...queryContext !== void 0 ? { trpc: { context: queryContext } } : {},
 		enabled: listReady,
 		placeholderData: hasReadyListData.current ? __tanstack_react_query.keepPreviousData : void 0,
 		staleTime: 0
@@ -10950,7 +10967,10 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 		const { page: _p, perPage: _pp,...rest } = queryInput;
 		return rest;
 	}, [queryInput]);
-	const exportQuery = router.export?.useQuery(exportInput, { enabled: false });
+	const exportQuery = router.export?.useQuery(exportInput, {
+		enabled: false,
+		...queryContext !== void 0 ? { trpc: { context: queryContext } } : {}
+	});
 	const [modal, dispatch] = (0, react.useReducer)(modalReducer, {
 		createOpen: false,
 		editOpen: false,
@@ -11207,7 +11227,8 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 			pageCount: listData?.pageCount ?? 0,
 			...typeof listData?.total === "number" ? { total: listData.total } : {},
 			isLoading: !listReady || listQuery.isLoading,
-			isFetching: !listReady || listQuery.isFetching
+			isFetching: !listReady || listQuery.isFetching,
+			error: listQuery.error
 		},
 		schema: resolvedSchema,
 		metadataPending,

package/dist/index.d.cts

@@ -244,6 +244,7 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
     isLoading: boolean;
     /** 是否正在获取数据（用于显示微妙的加载指示器） */
     isFetching: boolean;
+    error?: Error | null;
   };
   /** Optional schema override from host metadata. */
   schema?: z.ZodObject<z.ZodRawShape>;
@@ -361,6 +362,8 @@ interface UseAutoCrudResourceParams<TSchema extends z.ZodObject<z.ZodRawShape>,
    * ```
    */
   query?: (params: AutoQueryParams) => Record<string, unknown>;
+  /** tRPC operation context shared by list and automatic export requests. */
+  queryContext?: Record<string, unknown>;
   /** 其他配置选项 */
   options?: UseAutoCrudResourceOptions<TSchema, TListItem>;
 }
@@ -372,6 +375,7 @@ declare function useAutoCrudResource<TSchema extends z.ZodObject<z.ZodRawShape>,
   queryKeys,
   schema,
   query: queryTransform,
+  queryContext,
   fields,
   options
 }: UseAutoCrudResourceParams<TSchema, TListItem>): UseAutoCrudResourceReturn<TSchema, TListItem>;
@@ -1408,6 +1412,19 @@ declare function createActionsColumn<T>(items: ActionsColumnConfig<T>): ColumnDe
 //#region src/components/auto-crud/auto-table.d.ts
 /** 过滤模式类型 */
 type FilterMode = 'simple' | 'advanced' | 'command';
+interface TableSearchProps extends Pick<React.ComponentPropsWithoutRef<'input'>, 'onCompositionStart' | 'onCompositionEnd'> {
+  value: string;
+  onValueChange: (value: string) => void;
+  placeholder: string;
+  /** Reset pagination when an additional search criterion changes. */
+  resetPage: () => void;
+}
+interface TableSearchConfig {
+  placeholder?: string;
+  /** Search delay in milliseconds. Defaults to 200; use 0 for immediate queries. */
+  debounceMs?: number;
+  render?: (props: TableSearchProps) => React.ReactNode;
+}
 interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<DataTableProps<z.infer<T>>, 'expandedRow'> {
   /** Stable CRUD identity for saved views and tag services. */
   resourceId?: string;
@@ -1447,11 +1464,7 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<Data
    */
   filterMode?: FilterMode | FilterMode[];
   /** 全局搜索框 */
-  search?: boolean | {
-    placeholder?: string;
-    /** Search delay in milliseconds. Defaults to 200; use 0 for immediate queries. */
-    debounceMs?: number;
-  };
+  search?: boolean | TableSearchConfig;
   /** Extra table controls rendered between sorting and column visibility. */
   toolbarExtra?: React.ReactNode;
   /** Sorting and column visibility strings. Defaults to English for standalone use. */
@@ -2586,4 +2599,4 @@ interface TagAssignmentProps extends TagScope, Pick<RowActionDialogProps, 'open'
 /** Controlled dialog. Callers own the trigger, its appearance and its placement. */
 declare function TagAssignment(props: TagAssignmentProps): react_jsx_runtime17.JSX.Element | null;
 //#endregion
-export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudExportContext, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudProvider, type AutoCrudProviderProps, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, type AutoTableProps, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, type DataTableProps, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DataTableViewOptionsProps, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportIssue, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, type SavedView, type SavedViewsConfig, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TableActionBarLocale, type TableControlsLocale, type TablePaginationLocale, type TablePaginationOptions, TagAssignment, type TagAssignmentProps, TagFilter, type TagFilterProps, type TagFilterValue, type TagInput, type TagOption, type TagScope, type TagService, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, type ViewInput, type ViewQuery, type ViewStorage, type WorkbookSheet, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createLocalViewStorage, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, exportWorkbook, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, tagFilterValueSchema, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudExportContext, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudProvider, type AutoCrudProviderProps, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, type AutoTableProps, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, type DataTableProps, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DataTableViewOptionsProps, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportIssue, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, type SavedView, type SavedViewsConfig, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TableActionBarLocale, type TableControlsLocale, type TablePaginationLocale, type TablePaginationOptions, type TableSearchConfig, type TableSearchProps, TagAssignment, type TagAssignmentProps, TagFilter, type TagFilterProps, type TagFilterValue, type TagInput, type TagOption, type TagScope, type TagService, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, type ViewInput, type ViewQuery, type ViewStorage, type WorkbookSheet, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createLocalViewStorage, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, exportWorkbook, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, tagFilterValueSchema, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.d.ts

@@ -244,6 +244,7 @@ interface UseAutoCrudResourceReturn<TSchema extends z.ZodObject<z.ZodRawShape>,
     isLoading: boolean;
     /** 是否正在获取数据（用于显示微妙的加载指示器） */
     isFetching: boolean;
+    error?: Error | null;
   };
   /** Optional schema override from host metadata. */
   schema?: z.ZodObject<z.ZodRawShape>;
@@ -361,6 +362,8 @@ interface UseAutoCrudResourceParams<TSchema extends z.ZodObject<z.ZodRawShape>,
    * ```
    */
   query?: (params: AutoQueryParams) => Record<string, unknown>;
+  /** tRPC operation context shared by list and automatic export requests. */
+  queryContext?: Record<string, unknown>;
   /** 其他配置选项 */
   options?: UseAutoCrudResourceOptions<TSchema, TListItem>;
 }
@@ -372,6 +375,7 @@ declare function useAutoCrudResource<TSchema extends z.ZodObject<z.ZodRawShape>,
   queryKeys,
   schema,
   query: queryTransform,
+  queryContext,
   fields,
   options
 }: UseAutoCrudResourceParams<TSchema, TListItem>): UseAutoCrudResourceReturn<TSchema, TListItem>;
@@ -1408,6 +1412,19 @@ declare function createActionsColumn<T>(items: ActionsColumnConfig<T>): ColumnDe
 //#region src/components/auto-crud/auto-table.d.ts
 /** 过滤模式类型 */
 type FilterMode = 'simple' | 'advanced' | 'command';
+interface TableSearchProps extends Pick<React.ComponentPropsWithoutRef<'input'>, 'onCompositionStart' | 'onCompositionEnd'> {
+  value: string;
+  onValueChange: (value: string) => void;
+  placeholder: string;
+  /** Reset pagination when an additional search criterion changes. */
+  resetPage: () => void;
+}
+interface TableSearchConfig {
+  placeholder?: string;
+  /** Search delay in milliseconds. Defaults to 200; use 0 for immediate queries. */
+  debounceMs?: number;
+  render?: (props: TableSearchProps) => React.ReactNode;
+}
 interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<DataTableProps<z.infer<T>>, 'expandedRow'> {
   /** Stable CRUD identity for saved views and tag services. */
   resourceId?: string;
@@ -1447,11 +1464,7 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<Data
    */
   filterMode?: FilterMode | FilterMode[];
   /** 全局搜索框 */
-  search?: boolean | {
-    placeholder?: string;
-    /** Search delay in milliseconds. Defaults to 200; use 0 for immediate queries. */
-    debounceMs?: number;
-  };
+  search?: boolean | TableSearchConfig;
   /** Extra table controls rendered between sorting and column visibility. */
   toolbarExtra?: React.ReactNode;
   /** Sorting and column visibility strings. Defaults to English for standalone use. */
@@ -2586,4 +2599,4 @@ interface TagAssignmentProps extends TagScope, Pick<RowActionDialogProps, 'open'
 /** Controlled dialog. Callers own the trigger, its appearance and its placement. */
 declare function TagAssignment(props: TagAssignmentProps): react_jsx_runtime17.JSX.Element | null;
 //#endregion
-export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudExportContext, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudProvider, type AutoCrudProviderProps, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, type AutoTableProps, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, type DataTableProps, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DataTableViewOptionsProps, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportIssue, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, type SavedView, type SavedViewsConfig, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TableActionBarLocale, type TableControlsLocale, type TablePaginationLocale, type TablePaginationOptions, TagAssignment, type TagAssignmentProps, TagFilter, type TagFilterProps, type TagFilterValue, type TagInput, type TagOption, type TagScope, type TagService, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, type ViewInput, type ViewQuery, type ViewStorage, type WorkbookSheet, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createLocalViewStorage, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, exportWorkbook, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, tagFilterValueSchema, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudExportContext, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudProvider, type AutoCrudProviderProps, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, type AutoQueryParams, AutoTable, AutoTableActionBar, type AutoTableProps, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, type ColumnOverrides, type CreateFormSchemaOptions, type CreateTableSchemaOptions, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, type DataTableProps, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DataTableViewOptionsProps, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportIssue, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, type SavedView, type SavedViewsConfig, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TableActionBarLocale, type TableControlsLocale, type TablePaginationLocale, type TablePaginationOptions, type TableSearchConfig, type TableSearchProps, TagAssignment, type TagAssignmentProps, TagFilter, type TagFilterProps, type TagFilterValue, type TagInput, type TagOption, type TagScope, type TagService, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, type ViewInput, type ViewQuery, type ViewStorage, type WorkbookSheet, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createLocalViewStorage, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, exportWorkbook, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, tagFilterValueSchema, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.js

@@ -5651,12 +5651,13 @@ function SimpleDateFilter({ title, maxDate, multiple, value, onChange }) {
 
 //#endregion
 //#region src/components/auto-crud/auto-table-search.tsx
-function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "page" }) {
+function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "page", render }) {
 	const [value, setValue] = useState(() => getUrlParams().get("search") ?? "");
+	const valueRef = useRef(value);
 	const composing = useRef(false);
-	const commit = useCallback((next) => {
+	const commit = useCallback((next, resetPage = false) => {
 		const params = getUrlParams();
-		if ((params.get("search") ?? "") === next) return;
+		if ((params.get("search") ?? "") === next && !resetPage) return;
 		if (next) params.set("search", next);
 		else params.delete("search");
 		params.delete(pageKey);
@@ -5667,7 +5668,8 @@ function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "
 	useEffect(() => {
 		const sync = () => {
 			cancel();
-			setValue(getUrlParams().get("search") ?? "");
+			valueRef.current = getUrlParams().get("search") ?? "";
+			setValue(valueRef.current);
 		};
 		window.addEventListener("popstate", sync);
 		window.addEventListener("urlchange", sync);
@@ -5678,23 +5680,37 @@ function AutoTableSearch({ placeholder = "搜索", debounceMs = 200, pageKey = "
 		};
 	}, [cancel, pageKey]);
 	const change = (next) => {
+		valueRef.current = next;
 		setValue(next);
 		cancel();
 		if (composing.current) return;
 		if (!next || debounceMs <= 0) commit(next);
 		else debouncedCommit(next);
 	};
+	const onCompositionStart = () => {
+		composing.current = true;
+		cancel();
+	};
+	const onCompositionEnd = (event) => {
+		composing.current = false;
+		change(event.currentTarget.value);
+	};
+	if (render) return render({
+		value,
+		onValueChange: change,
+		onCompositionStart,
+		onCompositionEnd,
+		placeholder,
+		resetPage: () => {
+			cancel();
+			commit(valueRef.current, true);
+		}
+	});
 	return /* @__PURE__ */ jsx(Input, {
 		value,
 		onChange: (event) => change(event.target.value),
-		onCompositionStart: () => {
-			composing.current = true;
-			cancel();
-		},
-		onCompositionEnd: (event) => {
-			composing.current = false;
-			change(event.currentTarget.value);
-		},
+		onCompositionStart,
+		onCompositionEnd,
 		placeholder,
 		className: "h-8 w-48 shrink-0"
 	});
@@ -10859,7 +10875,7 @@ function modalReducer(state, action$1) {
 /**
 * Hook 主函数
 */
-function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform, fields, options = {} }) {
+function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform, queryContext, fields, options = {} }) {
 	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher, defaultSort: defaultSortOption } = options;
 	const toast$1 = useMemo(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
 	const hooksRef = useRef(hooks);
@@ -10914,6 +10930,7 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 	]);
 	const hasReadyListData = useRef(false);
 	const listQuery = router.list.useQuery(queryInput, {
+		...queryContext !== void 0 ? { trpc: { context: queryContext } } : {},
 		enabled: listReady,
 		placeholderData: hasReadyListData.current ? keepPreviousData : void 0,
 		staleTime: 0
@@ -10934,7 +10951,10 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 		const { page: _p, perPage: _pp,...rest } = queryInput;
 		return rest;
 	}, [queryInput]);
-	const exportQuery = router.export?.useQuery(exportInput, { enabled: false });
+	const exportQuery = router.export?.useQuery(exportInput, {
+		enabled: false,
+		...queryContext !== void 0 ? { trpc: { context: queryContext } } : {}
+	});
 	const [modal, dispatch] = useReducer(modalReducer, {
 		createOpen: false,
 		editOpen: false,
@@ -11191,7 +11211,8 @@ function useAutoCrudResource({ router, queryKeys, schema, query: queryTransform,
 			pageCount: listData?.pageCount ?? 0,
 			...typeof listData?.total === "number" ? { total: listData.total } : {},
 			isLoading: !listReady || listQuery.isLoading,
-			isFetching: !listReady || listQuery.isFetching
+			isFetching: !listReady || listQuery.isFetching,
+			error: listQuery.error
 		},
 		schema: resolvedSchema,
 		metadataPending,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -71,9 +71,9 @@
     "nanoid": "^5.1.6",
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
-    "@wordrhyme/formily-shadcn": "2.1.2",
+    "@wordrhyme/formily-shadcn": "2.1.3",
     "@wordrhyme/shadcn": "2.0.2",
-    "@wordrhyme/shadcn-ui": "2.1.2"
+    "@wordrhyme/shadcn-ui": "2.1.3"
   },
   "devDependencies": {
     "@storybook/react": "^8.6.18",