@wordrhyme/auto-crud 1.2.0 → 1.2.3

package/dist/index.cjs

@@ -61,6 +61,8 @@ let __formily_react = require("@formily/react");
 __formily_react = __toESM(__formily_react);
 let sonner = require("sonner");
 sonner = __toESM(sonner);
+let __tanstack_react_query = require("@tanstack/react-query");
+__tanstack_react_query = __toESM(__tanstack_react_query);
 
 //#region src/lib/utils.ts
 function cn(...inputs) {
@@ -5173,12 +5175,8 @@ function getComponentProps(type, parsed) {
 function createFormSchema(schema, options) {
 	const shape = schema.shape;
 	const properties = {};
-	const { overrides, exclude = [], layout = "vertical", gridColumns = 1, labelAlign = "top", labelWidth, labelCol, wrapperCol } = options ?? {};
+	const { overrides, exclude = [], layout = "vertical", gridColumns = 1 } = options ?? {};
 	const decoratorProps = { className: "space-y-2" };
-	if (labelAlign) decoratorProps.labelAlign = labelAlign;
-	if (labelWidth) decoratorProps.labelWidth = labelWidth;
-	if (labelCol) decoratorProps.labelCol = labelCol;
-	if (wrapperCol) decoratorProps.wrapperCol = wrapperCol;
 	for (const [key, fieldSchema] of Object.entries(shape)) {
 		if (exclude.includes(key)) continue;
 		const parsed = parseZodField(fieldSchema);
@@ -5237,8 +5235,12 @@ function createEditFormSchema(schema, options) {
 function createRegistry(label) {
 	const entries = /* @__PURE__ */ new Map();
 	const listeners = /* @__PURE__ */ new Set();
+	let notifyScheduled = false;
 	const notify = () => {
+		if (notifyScheduled) return;
+		notifyScheduled = true;
 		queueMicrotask(() => {
+			notifyScheduled = false;
 			for (const listener of listeners) listener();
 		});
 	};
@@ -5268,20 +5270,32 @@ function createRegistry(label) {
 	};
 }
 const formComponents = createRegistry("form component");
-const dataSources = createRegistry("data source");
-function normalizeDataSourceConfig(config) {
-	if (typeof config === "string") return config.length > 0 ? {
-		key: config,
-		dependsOn: [],
-		resetOnChange: false
-	} : void 0;
-	if (!config?.key) return void 0;
+const components = formComponents;
+function normalizeDataSourceRegistration(registration) {
+	if (typeof registration === "function") return {
+		dependencies: [],
+		reset: false,
+		load: registration
+	};
 	return {
-		key: config.key,
-		dependsOn: Array.isArray(config.dependsOn) ? config.dependsOn : [],
-		resetOnChange: config.resetOnChange === true
+		dependencies: Array.isArray(registration.dependencies) ? registration.dependencies : [],
+		reset: registration.reset === true,
+		load: registration.load
 	};
 }
+const dataSourceRegistry = createRegistry("data source");
+const dataSources = {
+	register(name, registration) {
+		dataSourceRegistry.register(name, normalizeDataSourceRegistration(registration));
+	},
+	unregister: dataSourceRegistry.unregister,
+	get: dataSourceRegistry.get,
+	all: dataSourceRegistry.all,
+	subscribe: dataSourceRegistry.subscribe
+};
+function normalizeDataSourceConfig(config) {
+	if (typeof config === "string") return config.length > 0 ? { key: config } : void 0;
+}
 function normalizeOptions(result) {
 	const options = Array.isArray(result) ? result : result?.options;
 	if (!Array.isArray(options)) return [];
@@ -5347,9 +5361,7 @@ function useRegistryVersion$1(subscribe) {
 	return version;
 }
 function isDataSourceConfig(value) {
-	if (typeof value === "string") return value.length > 0;
-	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-	return typeof value.key === "string";
+	return typeof value === "string" && value.length > 0;
 }
 function collectDataSourceConfigs(schema, result = {}) {
 	const properties = schema.properties;
@@ -5379,17 +5391,17 @@ function useFormDataSources(form, schema) {
 		const loadFieldOptions = async (fieldName, source) => {
 			const version = (loadVersions.get(fieldName) ?? 0) + 1;
 			loadVersions.set(fieldName, version);
-			const loader = dataSources.get(source.key);
-			if (!loader) {
+			const entry = dataSources.get(source.key);
+			if (!entry) {
 				form.setFieldState(fieldName, (state) => {
 					state.dataSource = [];
 				});
 				return;
 			}
 			try {
-				const options = normalizeOptions(await loader({
+				const options = normalizeOptions(await entry.load({
 					field: fieldName,
-					values: Object.fromEntries(source.dependsOn.map((dependency) => [dependency, form.getValuesIn(dependency)])),
+					values: Object.fromEntries(entry.dependencies.map((dependency) => [dependency, form.getValuesIn(dependency)])),
 					signal: controller?.signal
 				}));
 				if (!active || loadVersions.get(fieldName) !== version) return;
@@ -5406,10 +5418,11 @@ function useFormDataSources(form, schema) {
 		};
 		for (const [fieldName, source] of sourceEntries) loadFieldOptions(fieldName, source);
 		form.addEffects(effectId, () => {
-			for (const dependency of new Set(sourceEntries.flatMap(([, source]) => source.dependsOn))) (0, __formily_core.onFieldValueChange)(dependency, () => {
+			for (const dependency of new Set(sourceEntries.flatMap(([, source]) => dataSources.get(source.key)?.dependencies ?? []))) (0, __formily_core.onFieldValueChange)(dependency, () => {
 				for (const [fieldName, source] of sourceEntries) {
-					if (!source.dependsOn.includes(dependency)) continue;
-					if (source.resetOnChange) form.setValuesIn(fieldName, void 0);
+					const entry = dataSources.get(source.key);
+					if (!entry?.dependencies.includes(dependency)) continue;
+					if (entry.reset) form.setValuesIn(fieldName, void 0);
 					loadFieldOptions(fieldName, source);
 				}
 			});
@@ -5430,20 +5443,26 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 	const formSchema = (0, react.useMemo)(() => createEditFormSchema(zodSchema, {
 		overrides,
 		layout: "grid",
-		gridColumns,
-		labelAlign,
-		labelWidth
+		gridColumns
 	}), [
 		zodSchema,
 		overrides,
-		gridColumns,
-		labelAlign,
-		labelWidth
+		gridColumns
 	]);
+	const formLayout = (0, react.useMemo)(() => {
+		const inlineLabel = labelAlign === "left" || labelAlign === "right";
+		return {
+			labelPlacement: inlineLabel ? "start" : "top",
+			itemProps: inlineLabel ? { label: {
+				className: labelAlign === "right" ? "text-right" : void 0,
+				style: labelWidth != null ? { width: labelWidth } : void 0
+			} } : void 0
+		};
+	}, [labelAlign, labelWidth]);
 	const fieldComponents = (0, react.useMemo)(() => ({ fields: {
 		...defaultFieldComponents,
-		...formComponents.all()
-	} }), [useRegistryVersion$1(formComponents.subscribe)]);
+		...components.all()
+	} }), [useRegistryVersion$1(components.subscribe)]);
 	useFormDataSources(form, formSchema);
 	const handleSubmit = async () => {
 		await form.validate();
@@ -5452,6 +5471,7 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 	(0, react.useImperativeHandle)(ref, () => ({ submit: handleSubmit }));
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__pixpilot_formily_shadcn.Form, {
 		form,
+		layout: formLayout,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_formily_shadcn.JsonSchemaField, {
 			schema: formSchema,
 			components: fieldComponents
@@ -6341,10 +6361,10 @@ function useDynamicFilterOptions(fields) {
 		let active = true;
 		const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
 		Promise.all(sourceEntries.map(async ({ field, source }) => {
-			const loader = dataSources.get(source.key);
-			if (!loader) return [field, []];
+			const entry = dataSources.get(source.key);
+			if (!entry) return [field, []];
 			try {
-				return [field, normalizeOptions(await loader({
+				return [field, normalizeOptions(await entry.load({
 					field,
 					values: {},
 					signal: controller?.signal
@@ -6578,7 +6598,7 @@ function renderFieldValue(value, type, booleanLocale, options) {
 /**
 * ViewModal 组件 - 详情查看弹窗
 */
-function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, denyFields, locale }) {
+function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, dynamicOptions, denyFields, locale }) {
 	if (!data) return null;
 	const shape = schema.shape;
 	const denySet = new Set(denyFields ?? []);
@@ -6591,7 +6611,7 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 			const parsed = parseZodField(fieldSchema);
 			const label = fieldConfig?.[key]?.label ?? humanize(key);
 			const value = data[key];
-			const options = normalizeFieldOptions(fieldConfig?.[key]?.enum);
+			const options = normalizeFieldOptions(fieldConfig?.[key]?.enum) ?? normalizeFieldOptions(dynamicOptions?.[key]);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "grid grid-cols-3 items-start gap-4",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("dt", {
@@ -6613,6 +6633,7 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 		open,
 		onOpenChange,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__pixpilot_shadcn.DialogContent, {
+			"aria-describedby": void 0,
 			className: "max-w-2xl max-h-[80vh] overflow-y-auto",
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.DialogHeader, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.DialogTitle, { children: locale.viewModal.title }) }), content]
 		})
@@ -6917,6 +6938,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				data: resource.modal.selected,
 				schema: resolvedSchema,
 				fields: resolvedFields,
+				dynamicOptions: dynamicFilterOptions,
 				denyFields,
 				locale
 			}),
@@ -7560,13 +7582,6 @@ function DataTableToolbarFilter({ column }) {
 	}
 }
 
-//#endregion
-//#region ../../node_modules/.pnpm/@tanstack+query-core@5.90.20/node_modules/@tanstack/query-core/build/modern/utils.js
-var isServer = typeof window === "undefined" || "Deno" in globalThis;
-function keepPreviousData(previousData) {
-	return previousData;
-}
-
 //#endregion
 //#region src/hooks/use-auto-crud-resource.ts
 /** 默认 toast 适配器（使用 sonner） */
@@ -7716,7 +7731,7 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 		queryTransform
 	]);
 	const listQuery = router.list.useQuery(queryInput, {
-		placeholderData: keepPreviousData,
+		placeholderData: __tanstack_react_query.keepPreviousData,
 		staleTime: 0
 	});
 	const tableRows = listQuery.data?.data ?? [];
@@ -8329,6 +8344,7 @@ exports.MultiCombobox = MultiCombobox;
 exports.SchemaAdapter = SchemaAdapter;
 exports.cn = cn;
 exports.coerceRowValues = coerceRowValues;
+exports.components = components;
 exports.createActionsColumn = createActionsColumn;
 exports.createEditFormSchema = createEditFormSchema;
 exports.createFormSchema = createFormSchema;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime2 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";
@@ -24,7 +24,7 @@ declare const noopToastAdapter: ToastAdapter;
 /**
  * Modal 状态类型
  */
-type ModalVariant$1 = "dialog" | "sheet";
+type ModalVariant$1 = 'dialog' | 'sheet';
 interface ModalState<T> {
   createOpen: boolean;
   editOpen: boolean;
@@ -66,9 +66,9 @@ interface CrudHooks<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
    */
   beforeDelete?: (item: TListItem) => boolean | void | Promise<boolean | void>;
   /** 操作成功回调 */
-  onSuccess?: (op: "create" | "update" | "delete", payload: unknown) => void;
+  onSuccess?: (op: 'create' | 'update' | 'delete', payload: unknown) => void;
   /** 操作失败回调 */
-  onError?: (op: "create" | "update" | "delete", error: Error) => void;
+  onError?: (op: 'create' | 'update' | 'delete', error: Error) => void;
 }
 /**
  * Hook 配置选项
@@ -204,7 +204,7 @@ interface AutoQueryParams {
   }>;
   search?: string;
   filters: any[];
-  joinOperator: "and" | "or";
+  joinOperator: 'and' | 'or';
 }
 /**
  * Hook 配置参数
@@ -362,17 +362,17 @@ declare function AutoTableActionBar<TData>({
   enableDelete,
   extraActions,
   actions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
  * 字段类型映射
  */
-type FieldType = "string" | "number" | "boolean" | "date" | "enum" | "array" | "object";
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
 /**
  * DataTable Filter Variant
  */
-type FilterVariant = "text" | "number" | "boolean" | "select" | "multiSelect" | "date" | "dateRange" | "range";
+type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
 /**
  * 解析后的 Zod 字段信息
  */
@@ -408,10 +408,10 @@ interface CreateTableSchemaOptions<T> {
 interface CreateFormSchemaOptions {
   overrides?: FormSchemaOverrides;
   exclude?: string[];
-  layout?: "vertical" | "horizontal" | "grid";
+  layout?: 'vertical' | 'horizontal' | 'grid';
   gridColumns?: number;
   /** Label 对齐方式 */
-  labelAlign?: "left" | "top" | "right";
+  labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
   /** Label 栅格占位 */
@@ -450,7 +450,7 @@ interface ResolvedActionItem<T> {
   label: string;
   onClick: (row: T) => void;
   separator?: boolean;
-  variant?: "default" | "destructive";
+  variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
@@ -530,7 +530,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   showDefaultExport,
   onSelectedCountChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -646,10 +646,16 @@ type AutoCrudDataSourceResult = AutoCrudOption[] | {
   options?: AutoCrudOption[];
 };
 type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
-type AutoCrudDataSourceConfig = string | {
-  key: string;
-  dependsOn?: string[];
-  resetOnChange?: boolean;
+type AutoCrudDataSourceConfig = string;
+type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
+  dependencies?: string[];
+  reset?: boolean;
+  load: AutoCrudDataSourceLoader;
+};
+type AutoCrudDataSourceEntry = {
+  dependencies: string[];
+  reset: boolean;
+  load: AutoCrudDataSourceLoader;
 };
 type RegistryListener = () => void;
 declare const formComponents: {
@@ -659,17 +665,22 @@ declare const formComponents: {
   all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
-declare const dataSources: {
-  register(name: string, value: AutoCrudDataSourceLoader): void;
+declare const components: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
-  get(name: string): AutoCrudDataSourceLoader | undefined;
-  all(): Record<string, AutoCrudDataSourceLoader>;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
+declare const dataSources: {
+  register(name: string, registration: AutoCrudDataSourceRegistration): void;
+  unregister: (name: string) => void;
+  get: (name: string) => AutoCrudDataSourceEntry | undefined;
+  all: () => Record<string, AutoCrudDataSourceEntry>;
+  subscribe: (listener: RegistryListener) => () => void;
+};
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
-  dependsOn: string[];
-  resetOnChange: boolean;
 } | undefined;
 declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
@@ -935,7 +946,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime2.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>> {
@@ -967,7 +978,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime2.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>;
@@ -1209,7 +1220,7 @@ declare const filterItemSchema: z.ZodObject<{
 type FilterItemSchema = z.infer<typeof filterItemSchema>;
 //#endregion
 //#region src/types/data-table.d.ts
-declare module "@tanstack/react-table" {
+declare module '@tanstack/react-table' {
   interface TableMeta<TData extends RowData> {
     queryKeys?: QueryKeys;
     queryStateOptions?: UrlStateOptions;
@@ -1224,7 +1235,7 @@ declare module "@tanstack/react-table" {
     unit?: string;
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
     /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-    modes?: Array<"simple" | "advanced" | "command">;
+    modes?: Array<'simple' | 'advanced' | 'command'>;
   }
 }
 interface QueryKeys {
@@ -1241,10 +1252,10 @@ interface Option {
   count?: number;
   icon?: React.FC<React.SVGProps<SVGSVGElement>>;
 }
-type FilterOperator = DataTableConfig["operators"][number];
-type FilterVariant$1 = DataTableConfig["filterVariants"][number];
-type JoinOperator = DataTableConfig["joinOperators"][number];
-interface ExtendedColumnSort<TData> extends Omit<ColumnSort, "id"> {
+type FilterOperator = DataTableConfig['operators'][number];
+type FilterVariant$1 = DataTableConfig['filterVariants'][number];
+type JoinOperator = DataTableConfig['joinOperators'][number];
+interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
   id: Extract<keyof TData, string>;
 }
 interface ExtendedColumnFilter<TData> extends FilterItemSchema {
@@ -1252,7 +1263,7 @@ interface ExtendedColumnFilter<TData> extends FilterItemSchema {
 }
 interface DataTableRowAction<TData> {
   row: Row<TData>;
-  variant: "update" | "delete";
+  variant: 'update' | 'delete';
 }
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.d.ts
@@ -1269,7 +1280,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime2.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";
@@ -1311,7 +1322,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime2.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1333,7 +1344,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime2.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1353,7 +1364,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime2.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"> {
@@ -1366,7 +1377,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime2.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"> {
@@ -1377,7 +1388,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime2.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> {
@@ -1389,7 +1400,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime2.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> {
@@ -1403,7 +1414,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime2.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"> {
@@ -1415,7 +1426,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime2.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"> {
@@ -1426,7 +1437,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime2.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> {
@@ -1437,7 +1448,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime2.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#region src/components/ui/multi-combobox.d.ts
 interface MultiComboboxOption {
@@ -1523,7 +1534,7 @@ declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema:
 /**
  * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
  */
-declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, "exclude">): ISchema;
+declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion
 //#region src/lib/schema-bridge/schema-adapter.d.ts
 /**
@@ -1814,4 +1825,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceLoader, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, 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 FieldOption, 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, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, 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 FieldOption, 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, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
 import { Command, DropdownMenuTrigger, PopoverContent } from "@pixpilot/shadcn";
 import { ClassValue } from "clsx";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { z } from "zod";
 import { ISchema } from "@formily/json-schema";
 
@@ -24,7 +24,7 @@ declare const noopToastAdapter: ToastAdapter;
 /**
  * Modal 状态类型
  */
-type ModalVariant$1 = "dialog" | "sheet";
+type ModalVariant$1 = 'dialog' | 'sheet';
 interface ModalState<T> {
   createOpen: boolean;
   editOpen: boolean;
@@ -66,9 +66,9 @@ interface CrudHooks<TSchema extends z.ZodObject<z.ZodRawShape>, TListItem> {
    */
   beforeDelete?: (item: TListItem) => boolean | void | Promise<boolean | void>;
   /** 操作成功回调 */
-  onSuccess?: (op: "create" | "update" | "delete", payload: unknown) => void;
+  onSuccess?: (op: 'create' | 'update' | 'delete', payload: unknown) => void;
   /** 操作失败回调 */
-  onError?: (op: "create" | "update" | "delete", error: Error) => void;
+  onError?: (op: 'create' | 'update' | 'delete', error: Error) => void;
 }
 /**
  * Hook 配置选项
@@ -204,7 +204,7 @@ interface AutoQueryParams {
   }>;
   search?: string;
   filters: any[];
-  joinOperator: "and" | "or";
+  joinOperator: 'and' | 'or';
 }
 /**
  * Hook 配置参数
@@ -362,17 +362,17 @@ declare function AutoTableActionBar<TData>({
   enableDelete,
   extraActions,
   actions
-}: AutoTableActionBarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: AutoTableActionBarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/lib/schema-bridge/types.d.ts
 /**
  * 字段类型映射
  */
-type FieldType = "string" | "number" | "boolean" | "date" | "enum" | "array" | "object";
+type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'enum' | 'array' | 'object';
 /**
  * DataTable Filter Variant
  */
-type FilterVariant = "text" | "number" | "boolean" | "select" | "multiSelect" | "date" | "dateRange" | "range";
+type FilterVariant = 'text' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'date' | 'dateRange' | 'range';
 /**
  * 解析后的 Zod 字段信息
  */
@@ -408,10 +408,10 @@ interface CreateTableSchemaOptions<T> {
 interface CreateFormSchemaOptions {
   overrides?: FormSchemaOverrides;
   exclude?: string[];
-  layout?: "vertical" | "horizontal" | "grid";
+  layout?: 'vertical' | 'horizontal' | 'grid';
   gridColumns?: number;
   /** Label 对齐方式 */
-  labelAlign?: "left" | "top" | "right";
+  labelAlign?: 'left' | 'top' | 'right';
   /** Label 宽度（labelAlign 为 left 时有效） */
   labelWidth?: number | string;
   /** Label 栅格占位 */
@@ -450,7 +450,7 @@ interface ResolvedActionItem<T> {
   label: string;
   onClick: (row: T) => void;
   separator?: boolean;
-  variant?: "default" | "destructive";
+  variant?: 'default' | 'destructive';
 }
 /**
  * 操作列配置（ResolvedActionItem 数组）
@@ -530,7 +530,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   showDefaultExport,
   onSelectedCountChange,
   getSelectedRows
-}: AutoTableProps<T>): react_jsx_runtime3.JSX.Element;
+}: AutoTableProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/i18n/locale.d.ts
 /**
@@ -646,10 +646,16 @@ type AutoCrudDataSourceResult = AutoCrudOption[] | {
   options?: AutoCrudOption[];
 };
 type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
-type AutoCrudDataSourceConfig = string | {
-  key: string;
-  dependsOn?: string[];
-  resetOnChange?: boolean;
+type AutoCrudDataSourceConfig = string;
+type AutoCrudDataSourceRegistration = AutoCrudDataSourceLoader | {
+  dependencies?: string[];
+  reset?: boolean;
+  load: AutoCrudDataSourceLoader;
+};
+type AutoCrudDataSourceEntry = {
+  dependencies: string[];
+  reset: boolean;
+  load: AutoCrudDataSourceLoader;
 };
 type RegistryListener = () => void;
 declare const formComponents: {
@@ -659,17 +665,22 @@ declare const formComponents: {
   all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
-declare const dataSources: {
-  register(name: string, value: AutoCrudDataSourceLoader): void;
+declare const components: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
   unregister(name: string): void;
-  get(name: string): AutoCrudDataSourceLoader | undefined;
-  all(): Record<string, AutoCrudDataSourceLoader>;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
   subscribe(listener: RegistryListener): () => void;
 };
+declare const dataSources: {
+  register(name: string, registration: AutoCrudDataSourceRegistration): void;
+  unregister: (name: string) => void;
+  get: (name: string) => AutoCrudDataSourceEntry | undefined;
+  all: () => Record<string, AutoCrudDataSourceEntry>;
+  subscribe: (listener: RegistryListener) => () => void;
+};
 declare function normalizeDataSourceConfig(config: AutoCrudDataSourceConfig | undefined): {
   key: string;
-  dependsOn: string[];
-  resetOnChange: boolean;
 } | undefined;
 declare function normalizeOptions(result: AutoCrudDataSourceResult | undefined): AutoCrudOption[];
 //#endregion
@@ -935,7 +946,7 @@ declare function AutoCrudTable<TSchema extends z.ZodObject<z.ZodRawShape>>({
   toolbarActions,
   locale: localeProp,
   onCreate
-}: AutoCrudTableProps<TSchema>): react_jsx_runtime3.JSX.Element;
+}: AutoCrudTableProps<TSchema>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/auto-form.d.ts
 interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
@@ -967,7 +978,7 @@ declare function AutoFormInner<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   showSubmitButton
-}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime3.JSX.Element;
+}: AutoFormProps<T>, ref: React.Ref<AutoFormRef>): react_jsx_runtime2.JSX.Element;
 declare const AutoForm: <T extends z.ZodObject<z.ZodRawShape>>(props: AutoFormProps<T> & {
   ref?: React.Ref<AutoFormRef>;
 }) => ReturnType<typeof AutoFormInner>;
@@ -1209,7 +1220,7 @@ declare const filterItemSchema: z.ZodObject<{
 type FilterItemSchema = z.infer<typeof filterItemSchema>;
 //#endregion
 //#region src/types/data-table.d.ts
-declare module "@tanstack/react-table" {
+declare module '@tanstack/react-table' {
   interface TableMeta<TData extends RowData> {
     queryKeys?: QueryKeys;
     queryStateOptions?: UrlStateOptions;
@@ -1224,7 +1235,7 @@ declare module "@tanstack/react-table" {
     unit?: string;
     icon?: React.FC<React.SVGProps<SVGSVGElement>>;
     /** 控制在哪些筛选模式下显示（未设置则在所有模式显示） */
-    modes?: Array<"simple" | "advanced" | "command">;
+    modes?: Array<'simple' | 'advanced' | 'command'>;
   }
 }
 interface QueryKeys {
@@ -1241,10 +1252,10 @@ interface Option {
   count?: number;
   icon?: React.FC<React.SVGProps<SVGSVGElement>>;
 }
-type FilterOperator = DataTableConfig["operators"][number];
-type FilterVariant$1 = DataTableConfig["filterVariants"][number];
-type JoinOperator = DataTableConfig["joinOperators"][number];
-interface ExtendedColumnSort<TData> extends Omit<ColumnSort, "id"> {
+type FilterOperator = DataTableConfig['operators'][number];
+type FilterVariant$1 = DataTableConfig['filterVariants'][number];
+type JoinOperator = DataTableConfig['joinOperators'][number];
+interface ExtendedColumnSort<TData> extends Omit<ColumnSort, 'id'> {
   id: Extract<keyof TData, string>;
 }
 interface ExtendedColumnFilter<TData> extends FilterItemSchema {
@@ -1252,7 +1263,7 @@ interface ExtendedColumnFilter<TData> extends FilterItemSchema {
 }
 interface DataTableRowAction<TData> {
   row: Row<TData>;
-  variant: "update" | "delete";
+  variant: 'update' | 'delete';
 }
 //#endregion
 //#region src/components/auto-crud/auto-table-simple-filters.d.ts
@@ -1269,7 +1280,7 @@ declare function AutoTableSimpleFilters<TData>({
   filters: externalFilters,
   onFiltersChange,
   leading
-}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime3.JSX.Element | null;
+}: AutoTableSimpleFiltersProps<TData>): react_jsx_runtime2.JSX.Element | null;
 //#endregion
 //#region src/components/auto-crud/form-modal.d.ts
 type ModalVariant = "dialog" | "sheet";
@@ -1311,7 +1322,7 @@ declare function CrudFormModal<T extends z.ZodObject<z.ZodRawShape>>({
   labelAlign,
   labelWidth,
   className
-}: CrudFormModalProps<T>): react_jsx_runtime3.JSX.Element;
+}: CrudFormModalProps<T>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/import-dialog.d.ts
 interface ImportDialogProps {
@@ -1333,7 +1344,7 @@ declare function ImportDialog({
   columns,
   title,
   locale
-}: ImportDialogProps): react_jsx_runtime3.JSX.Element;
+}: ImportDialogProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/auto-crud/export-dialog.d.ts
 type ExportMode = "selected" | "filtered";
@@ -1353,7 +1364,7 @@ declare function ExportDialog({
   selectedCount,
   onExport,
   canExportFiltered
-}: ExportDialogProps): react_jsx_runtime3.JSX.Element;
+}: ExportDialogProps): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table.d.ts
 interface DataTableProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1366,7 +1377,7 @@ declare function DataTable<TData>({
   children,
   className,
   ...props
-}: DataTableProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-advanced-toolbar.d.ts
 interface DataTableAdvancedToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1377,7 +1388,7 @@ declare function DataTableAdvancedToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableAdvancedToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-column-header.d.ts
 interface DataTableColumnHeaderProps<TData, TValue> extends React.ComponentProps<typeof DropdownMenuTrigger> {
@@ -1389,7 +1400,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   label,
   className,
   ...props
-}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableColumnHeaderProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-faceted-filter.d.ts
 interface DataTableFacetedFilterProps<TData, TValue> {
@@ -1403,7 +1414,7 @@ declare function DataTableFacetedFilter<TData, TValue>({
   title,
   options,
   multiple
-}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime3.JSX.Element;
+}: DataTableFacetedFilterProps<TData, TValue>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-pagination.d.ts
 interface DataTablePaginationProps<TData> extends React.ComponentProps<"div"> {
@@ -1415,7 +1426,7 @@ declare function DataTablePagination<TData>({
   pageSizeOptions,
   className,
   ...props
-}: DataTablePaginationProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTablePaginationProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-toolbar.d.ts
 interface DataTableToolbarProps<TData> extends React$1.ComponentProps<"div"> {
@@ -1426,7 +1437,7 @@ declare function DataTableToolbar<TData>({
   children,
   className,
   ...props
-}: DataTableToolbarProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableToolbarProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/data-table/data-table-view-options.d.ts
 interface DataTableViewOptionsProps<TData> extends React$1.ComponentProps<typeof PopoverContent> {
@@ -1437,7 +1448,7 @@ declare function DataTableViewOptions<TData>({
   table,
   disabled,
   ...props
-}: DataTableViewOptionsProps<TData>): react_jsx_runtime3.JSX.Element;
+}: DataTableViewOptionsProps<TData>): react_jsx_runtime2.JSX.Element;
 //#endregion
 //#region src/components/ui/multi-combobox.d.ts
 interface MultiComboboxOption {
@@ -1523,7 +1534,7 @@ declare function createFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema:
 /**
  * 为编辑模式创建 Form Schema（排除 id, createdAt, updatedAt）
  */
-declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, "exclude">): ISchema;
+declare function createEditFormSchema<T extends z.ZodObject<z.ZodRawShape>>(schema: T, options?: Omit<CreateFormSchemaOptions, 'exclude'>): ISchema;
 //#endregion
 //#region src/lib/schema-bridge/schema-adapter.d.ts
 /**
@@ -1814,4 +1825,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceLoader, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, 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 FieldOption, 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, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionItem, type ActionsColumnConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, AutoCrudTable, type AutoCrudTableProps, AutoForm, type AutoQueryParams, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, type BatchActionConfig, type BatchActionContext, type BatchActionItem, type BatchBuiltinActionItem, type BatchBuiltinActionType, type BatchCustomActionItem, type BatchUpdateField, 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 FieldOption, 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, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, SchemaAdapter, type SimpleFieldConfig, type SimpleFieldsConfig, type ToastAdapter, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.js

@@ -19,6 +19,7 @@ import { createForm, onFieldValueChange } from "@formily/core";
 import { Form, JsonSchemaField } from "@pixpilot/formily-shadcn";
 import { connect, mapProps } from "@formily/react";
 import { toast } from "sonner";
+import { keepPreviousData } from "@tanstack/react-query";
 
 //#region src/lib/utils.ts
 function cn(...inputs) {
@@ -5131,12 +5132,8 @@ function getComponentProps(type, parsed) {
 function createFormSchema(schema, options) {
 	const shape = schema.shape;
 	const properties = {};
-	const { overrides, exclude = [], layout = "vertical", gridColumns = 1, labelAlign = "top", labelWidth, labelCol, wrapperCol } = options ?? {};
+	const { overrides, exclude = [], layout = "vertical", gridColumns = 1 } = options ?? {};
 	const decoratorProps = { className: "space-y-2" };
-	if (labelAlign) decoratorProps.labelAlign = labelAlign;
-	if (labelWidth) decoratorProps.labelWidth = labelWidth;
-	if (labelCol) decoratorProps.labelCol = labelCol;
-	if (wrapperCol) decoratorProps.wrapperCol = wrapperCol;
 	for (const [key, fieldSchema] of Object.entries(shape)) {
 		if (exclude.includes(key)) continue;
 		const parsed = parseZodField(fieldSchema);
@@ -5195,8 +5192,12 @@ function createEditFormSchema(schema, options) {
 function createRegistry(label) {
 	const entries = /* @__PURE__ */ new Map();
 	const listeners = /* @__PURE__ */ new Set();
+	let notifyScheduled = false;
 	const notify = () => {
+		if (notifyScheduled) return;
+		notifyScheduled = true;
 		queueMicrotask(() => {
+			notifyScheduled = false;
 			for (const listener of listeners) listener();
 		});
 	};
@@ -5226,20 +5227,32 @@ function createRegistry(label) {
 	};
 }
 const formComponents = createRegistry("form component");
-const dataSources = createRegistry("data source");
-function normalizeDataSourceConfig(config) {
-	if (typeof config === "string") return config.length > 0 ? {
-		key: config,
-		dependsOn: [],
-		resetOnChange: false
-	} : void 0;
-	if (!config?.key) return void 0;
+const components = formComponents;
+function normalizeDataSourceRegistration(registration) {
+	if (typeof registration === "function") return {
+		dependencies: [],
+		reset: false,
+		load: registration
+	};
 	return {
-		key: config.key,
-		dependsOn: Array.isArray(config.dependsOn) ? config.dependsOn : [],
-		resetOnChange: config.resetOnChange === true
+		dependencies: Array.isArray(registration.dependencies) ? registration.dependencies : [],
+		reset: registration.reset === true,
+		load: registration.load
 	};
 }
+const dataSourceRegistry = createRegistry("data source");
+const dataSources = {
+	register(name, registration) {
+		dataSourceRegistry.register(name, normalizeDataSourceRegistration(registration));
+	},
+	unregister: dataSourceRegistry.unregister,
+	get: dataSourceRegistry.get,
+	all: dataSourceRegistry.all,
+	subscribe: dataSourceRegistry.subscribe
+};
+function normalizeDataSourceConfig(config) {
+	if (typeof config === "string") return config.length > 0 ? { key: config } : void 0;
+}
 function normalizeOptions(result) {
 	const options = Array.isArray(result) ? result : result?.options;
 	if (!Array.isArray(options)) return [];
@@ -5305,9 +5318,7 @@ function useRegistryVersion$1(subscribe) {
 	return version;
 }
 function isDataSourceConfig(value) {
-	if (typeof value === "string") return value.length > 0;
-	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-	return typeof value.key === "string";
+	return typeof value === "string" && value.length > 0;
 }
 function collectDataSourceConfigs(schema, result = {}) {
 	const properties = schema.properties;
@@ -5337,17 +5348,17 @@ function useFormDataSources(form, schema) {
 		const loadFieldOptions = async (fieldName, source) => {
 			const version = (loadVersions.get(fieldName) ?? 0) + 1;
 			loadVersions.set(fieldName, version);
-			const loader = dataSources.get(source.key);
-			if (!loader) {
+			const entry = dataSources.get(source.key);
+			if (!entry) {
 				form.setFieldState(fieldName, (state) => {
 					state.dataSource = [];
 				});
 				return;
 			}
 			try {
-				const options = normalizeOptions(await loader({
+				const options = normalizeOptions(await entry.load({
 					field: fieldName,
-					values: Object.fromEntries(source.dependsOn.map((dependency) => [dependency, form.getValuesIn(dependency)])),
+					values: Object.fromEntries(entry.dependencies.map((dependency) => [dependency, form.getValuesIn(dependency)])),
 					signal: controller?.signal
 				}));
 				if (!active || loadVersions.get(fieldName) !== version) return;
@@ -5364,10 +5375,11 @@ function useFormDataSources(form, schema) {
 		};
 		for (const [fieldName, source] of sourceEntries) loadFieldOptions(fieldName, source);
 		form.addEffects(effectId, () => {
-			for (const dependency of new Set(sourceEntries.flatMap(([, source]) => source.dependsOn))) onFieldValueChange(dependency, () => {
+			for (const dependency of new Set(sourceEntries.flatMap(([, source]) => dataSources.get(source.key)?.dependencies ?? []))) onFieldValueChange(dependency, () => {
 				for (const [fieldName, source] of sourceEntries) {
-					if (!source.dependsOn.includes(dependency)) continue;
-					if (source.resetOnChange) form.setValuesIn(fieldName, void 0);
+					const entry = dataSources.get(source.key);
+					if (!entry?.dependencies.includes(dependency)) continue;
+					if (entry.reset) form.setValuesIn(fieldName, void 0);
 					loadFieldOptions(fieldName, source);
 				}
 			});
@@ -5388,20 +5400,26 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 	const formSchema = useMemo(() => createEditFormSchema(zodSchema, {
 		overrides,
 		layout: "grid",
-		gridColumns,
-		labelAlign,
-		labelWidth
+		gridColumns
 	}), [
 		zodSchema,
 		overrides,
-		gridColumns,
-		labelAlign,
-		labelWidth
+		gridColumns
 	]);
+	const formLayout = useMemo(() => {
+		const inlineLabel = labelAlign === "left" || labelAlign === "right";
+		return {
+			labelPlacement: inlineLabel ? "start" : "top",
+			itemProps: inlineLabel ? { label: {
+				className: labelAlign === "right" ? "text-right" : void 0,
+				style: labelWidth != null ? { width: labelWidth } : void 0
+			} } : void 0
+		};
+	}, [labelAlign, labelWidth]);
 	const fieldComponents = useMemo(() => ({ fields: {
 		...defaultFieldComponents,
-		...formComponents.all()
-	} }), [useRegistryVersion$1(formComponents.subscribe)]);
+		...components.all()
+	} }), [useRegistryVersion$1(components.subscribe)]);
 	useFormDataSources(form, formSchema);
 	const handleSubmit = async () => {
 		await form.validate();
@@ -5410,6 +5428,7 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 	useImperativeHandle(ref, () => ({ submit: handleSubmit }));
 	return /* @__PURE__ */ jsxs(Form, {
 		form,
+		layout: formLayout,
 		children: [/* @__PURE__ */ jsx(JsonSchemaField, {
 			schema: formSchema,
 			components: fieldComponents
@@ -6299,10 +6318,10 @@ function useDynamicFilterOptions(fields) {
 		let active = true;
 		const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
 		Promise.all(sourceEntries.map(async ({ field, source }) => {
-			const loader = dataSources.get(source.key);
-			if (!loader) return [field, []];
+			const entry = dataSources.get(source.key);
+			if (!entry) return [field, []];
 			try {
-				return [field, normalizeOptions(await loader({
+				return [field, normalizeOptions(await entry.load({
 					field,
 					values: {},
 					signal: controller?.signal
@@ -6536,7 +6555,7 @@ function renderFieldValue(value, type, booleanLocale, options) {
 /**
 * ViewModal 组件 - 详情查看弹窗
 */
-function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, denyFields, locale }) {
+function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldConfig, dynamicOptions, denyFields, locale }) {
 	if (!data) return null;
 	const shape = schema.shape;
 	const denySet = new Set(denyFields ?? []);
@@ -6549,7 +6568,7 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 			const parsed = parseZodField(fieldSchema);
 			const label = fieldConfig?.[key]?.label ?? humanize(key);
 			const value = data[key];
-			const options = normalizeFieldOptions(fieldConfig?.[key]?.enum);
+			const options = normalizeFieldOptions(fieldConfig?.[key]?.enum) ?? normalizeFieldOptions(dynamicOptions?.[key]);
 			return /* @__PURE__ */ jsxs("div", {
 				className: "grid grid-cols-3 items-start gap-4",
 				children: [/* @__PURE__ */ jsx("dt", {
@@ -6571,6 +6590,7 @@ function ViewModal({ open, onOpenChange, variant, data, schema, fields: fieldCon
 		open,
 		onOpenChange,
 		children: /* @__PURE__ */ jsxs(DialogContent, {
+			"aria-describedby": void 0,
 			className: "max-w-2xl max-h-[80vh] overflow-y-auto",
 			children: [/* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsx(DialogTitle, { children: locale.viewModal.title }) }), content]
 		})
@@ -6875,6 +6895,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 				data: resource.modal.selected,
 				schema: resolvedSchema,
 				fields: resolvedFields,
+				dynamicOptions: dynamicFilterOptions,
 				denyFields,
 				locale
 			}),
@@ -7518,13 +7539,6 @@ function DataTableToolbarFilter({ column }) {
 	}
 }
 
-//#endregion
-//#region ../../node_modules/.pnpm/@tanstack+query-core@5.90.20/node_modules/@tanstack/query-core/build/modern/utils.js
-var isServer = typeof window === "undefined" || "Deno" in globalThis;
-function keepPreviousData(previousData) {
-	return previousData;
-}
-
 //#endregion
 //#region src/hooks/use-auto-crud-resource.ts
 /** 默认 toast 适配器（使用 sonner） */
@@ -8268,4 +8282,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, MultiCombobox, SchemaAdapter, cn, coerceRowValues, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, MultiCombobox, SchemaAdapter, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, resolveLocale, setSearchParams, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "1.2.0",
+  "version": "1.2.3",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -27,6 +27,7 @@
     "access": "public"
   },
   "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "sonner": "^2.0.0",
@@ -71,6 +72,7 @@
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.15",
+    "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@trpc/server": "^11.0.0",
     "@types/node": "^22.19.17",
@@ -78,15 +80,17 @@
     "@types/react-dom": "^19.2.3",
     "drizzle-orm": "1.0.0-beta.15-859cf75",
     "eslint": "^9.39.4",
+    "jsdom": "^27.4.0",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "tsdown": "^0.15.12",
     "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
     "@internal/eslint-config": "0.3.0",
     "@internal/prettier-config": "0.0.1",
+    "@internal/tsconfig": "0.1.0",
     "@internal/tsdown-config": "0.1.0",
-    "@internal/vitest-config": "0.1.0",
-    "@internal/tsconfig": "0.1.0"
+    "@internal/vitest-config": "0.1.0"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {