@wordrhyme/auto-crud 1.1.7 → 1.2.0

package/dist/index.cjs

@@ -5232,6 +5232,67 @@ function createEditFormSchema(schema, options) {
 	});
 }
 
+//#endregion
+//#region src/lib/registries.ts
+function createRegistry(label) {
+	const entries = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	const notify = () => {
+		queueMicrotask(() => {
+			for (const listener of listeners) listener();
+		});
+	};
+	return {
+		register(name, value) {
+			if (entries.has(name)) {
+				console.warn(`[AutoCrud] ${label} "${name}" is already registered.`);
+				return;
+			}
+			entries.set(name, value);
+			notify();
+		},
+		unregister(name) {
+			if (!entries.delete(name)) return;
+			notify();
+		},
+		get(name) {
+			return entries.get(name);
+		},
+		all() {
+			return Object.fromEntries(entries);
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+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;
+	return {
+		key: config.key,
+		dependsOn: Array.isArray(config.dependsOn) ? config.dependsOn : [],
+		resetOnChange: config.resetOnChange === true
+	};
+}
+function normalizeOptions(result) {
+	const options = Array.isArray(result) ? result : result?.options;
+	if (!Array.isArray(options)) return [];
+	return options.filter((option) => {
+		return typeof option === "object" && option !== null && typeof option.value === "string" && typeof option.label === "string";
+	}).map((option) => ({
+		...option,
+		value: String(option.value)
+	}));
+}
+
 //#endregion
 //#region src/components/auto-crud/auto-form.tsx
 const COMBOBOX_LIST_CLASS = "[&_[cmdk-list]]:max-h-[360px] [&_[cmdk-list]]:overflow-x-hidden [&_[cmdk-list]]:overflow-y-auto";
@@ -5266,6 +5327,104 @@ function AutoCrudMultiCombobox({ options = [],...props }) {
 		options
 	});
 }
+const defaultFieldComponents = {
+	Combobox: {
+		component: FormilyCombobox,
+		decorator: "FormItem"
+	},
+	MultiCombobox: {
+		component: FormilyMultiCombobox,
+		decorator: "FormItem"
+	},
+	Switch: {
+		component: FormilySwitch,
+		decorator: "FormItem"
+	}
+};
+function useRegistryVersion$1(subscribe) {
+	const [version, setVersion] = (0, react.useState)(0);
+	(0, react.useEffect)(() => subscribe(() => setVersion((current) => current + 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";
+}
+function collectDataSourceConfigs(schema, result = {}) {
+	const properties = schema.properties;
+	if (!properties || typeof properties !== "object") return result;
+	for (const [key, property] of Object.entries(properties)) {
+		if (!property || typeof property !== "object" || Array.isArray(property)) continue;
+		const record = property;
+		const customDataSource = record["x-data-source"];
+		const schemaDataSource = record.dataSource;
+		const dataSourceConfig = isDataSourceConfig(customDataSource) ? customDataSource : isDataSourceConfig(schemaDataSource) ? schemaDataSource : void 0;
+		if (dataSourceConfig) result[key] = dataSourceConfig;
+		collectDataSourceConfigs(record, result);
+	}
+	return result;
+}
+function useFormDataSources(form, schema) {
+	(0, react.useEffect)(() => {
+		const sourceEntries = Object.entries(collectDataSourceConfigs(schema)).map(([fieldName, config]) => {
+			const normalized = normalizeDataSourceConfig(config);
+			return normalized ? [fieldName, normalized] : void 0;
+		}).filter((entry) => entry !== void 0);
+		if (sourceEntries.length === 0) return;
+		let active = true;
+		const effectId = Symbol("autoCrudDataSources");
+		const loadVersions = /* @__PURE__ */ new Map();
+		const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
+		const loadFieldOptions = async (fieldName, source) => {
+			const version = (loadVersions.get(fieldName) ?? 0) + 1;
+			loadVersions.set(fieldName, version);
+			const loader = dataSources.get(source.key);
+			if (!loader) {
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = [];
+				});
+				return;
+			}
+			try {
+				const options = normalizeOptions(await loader({
+					field: fieldName,
+					values: Object.fromEntries(source.dependsOn.map((dependency) => [dependency, form.getValuesIn(dependency)])),
+					signal: controller?.signal
+				}));
+				if (!active || loadVersions.get(fieldName) !== version) return;
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = options;
+				});
+			} catch (error) {
+				if (!active || controller?.signal.aborted) return;
+				console.warn(`[AutoCrud] Failed to load data source "${source.key}".`, error);
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = [];
+				});
+			}
+		};
+		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 [fieldName, source] of sourceEntries) {
+					if (!source.dependsOn.includes(dependency)) continue;
+					if (source.resetOnChange) form.setValuesIn(fieldName, void 0);
+					loadFieldOptions(fieldName, source);
+				}
+			});
+		});
+		return () => {
+			active = false;
+			controller?.abort();
+			form.removeEffects(effectId);
+		};
+	}, [
+		form,
+		schema,
+		useRegistryVersion$1(dataSources.subscribe)
+	]);
+}
 function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides, mode = "create", loading = false, gridColumns = 1, labelAlign = "top", labelWidth, showSubmitButton = true }, ref) {
 	const form = (0, react.useMemo)(() => (0, __formily_core.createForm)({ initialValues }), [JSON.stringify(initialValues)]);
 	const formSchema = (0, react.useMemo)(() => createEditFormSchema(zodSchema, {
@@ -5281,6 +5440,11 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 		labelAlign,
 		labelWidth
 	]);
+	const fieldComponents = (0, react.useMemo)(() => ({ fields: {
+		...defaultFieldComponents,
+		...formComponents.all()
+	} }), [useRegistryVersion$1(formComponents.subscribe)]);
+	useFormDataSources(form, formSchema);
 	const handleSubmit = async () => {
 		await form.validate();
 		if (form.valid) await onSubmit(form.values);
@@ -5290,20 +5454,7 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 		form,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_formily_shadcn.JsonSchemaField, {
 			schema: formSchema,
-			components: { fields: {
-				Combobox: {
-					component: FormilyCombobox,
-					decorator: "FormItem"
-				},
-				MultiCombobox: {
-					component: FormilyMultiCombobox,
-					decorator: "FormItem"
-				},
-				Switch: {
-					component: FormilySwitch,
-					decorator: "FormItem"
-				}
-			} }
+			components: fieldComponents
 		}), showSubmitButton && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			className: "flex justify-end gap-2 mt-6",
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__pixpilot_shadcn.Button, {
@@ -6117,6 +6268,7 @@ function mergeFieldConfig(base, override) {
 		...base,
 		...override,
 		enum: override?.enum ?? base?.enum,
+		dataSource: override?.dataSource ?? base?.dataSource,
 		table: mergeFieldPart(base?.table, override?.table),
 		filter: mergeFieldPart(base?.filter, override?.filter),
 		form: mergeFieldPart(base?.form, override?.form)
@@ -6149,6 +6301,69 @@ function toBatchOptions(options) {
 		value
 	}));
 }
+function getFilterDataSource(config) {
+	if (config.filter && typeof config.filter === "object") return config.filter.dataSource ?? config.dataSource;
+	return config.dataSource;
+}
+function shouldLoadDynamicFilterOptions(config) {
+	if (config.filter === false) return false;
+	if (normalizeFieldOptions(config.enum)) return false;
+	if (config.filter && typeof config.filter === "object") {
+		if (config.filter.enabled === false || config.filter.hidden === true) return false;
+		if (normalizeFieldOptions(config.filter.options)) return false;
+	}
+	return normalizeDataSourceConfig(getFilterDataSource(config)) !== void 0;
+}
+function useRegistryVersion(subscribe) {
+	const [version, setVersion] = react.useState(0);
+	react.useEffect(() => subscribe(() => setVersion((current) => current + 1)), [subscribe]);
+	return version;
+}
+function useDynamicFilterOptions(fields) {
+	const registryVersion = useRegistryVersion(dataSources.subscribe);
+	const [optionsByField, setOptionsByField] = react.useState({});
+	const sourceEntries = react.useMemo(() => {
+		if (!fields) return [];
+		return Object.entries(fields).flatMap(([field, config]) => {
+			if (!shouldLoadDynamicFilterOptions(config)) return [];
+			const source = normalizeDataSourceConfig(getFilterDataSource(config));
+			return source ? [{
+				field,
+				source
+			}] : [];
+		});
+	}, [fields]);
+	react.useEffect(() => {
+		if (sourceEntries.length === 0) {
+			setOptionsByField({});
+			return;
+		}
+		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, []];
+			try {
+				return [field, normalizeOptions(await loader({
+					field,
+					values: {},
+					signal: controller?.signal
+				}))];
+			} catch (error) {
+				if (!controller?.signal.aborted) console.warn(`[AutoCrud] Failed to load filter data source "${source.key}".`, error);
+				return [field, []];
+			}
+		})).then((entries) => {
+			if (!active) return;
+			setOptionsByField(Object.fromEntries(entries));
+		});
+		return () => {
+			active = false;
+			controller?.abort();
+		};
+	}, [sourceEntries, registryVersion]);
+	return optionsByField;
+}
 function getOptionLabel(value, options) {
 	const stringValue = String(value);
 	return options?.find((option) => option.value === stringValue)?.label ?? stringValue;
@@ -6157,15 +6372,21 @@ function getOptionLabel(value, options) {
 * 从统一配置生成表格 overrides
 * 当 filter 配置存在时，合并到 meta 中（不影响列隐藏）
 */
-function buildTableOverrides(fields, legacyOverrides) {
+function buildTableOverrides(fields, legacyOverrides, dynamicFilterOptions) {
 	const result = { ...legacyOverrides };
 	if (fields) for (const [key, config] of Object.entries(fields)) {
-		const tableOptions = toTableOptions(normalizeFieldOptions(config.enum));
+		const fieldOptions = normalizeFieldOptions(config.enum);
+		const tableOptions = toTableOptions(fieldOptions);
+		const dynamicOptions = !fieldOptions ? toTableOptions(normalizeFieldOptions(dynamicFilterOptions?.[key])) : void 0;
 		const tableMeta = config.table !== false && typeof config.table === "object" ? config.table.meta : void 0;
 		const fieldEnumMeta = tableOptions ? {
 			options: tableOptions,
 			variant: "multiSelect"
 		} : void 0;
+		const fieldDataSourceMeta = dynamicOptions ? {
+			options: dynamicOptions,
+			variant: "multiSelect"
+		} : void 0;
 		let filterMeta;
 		if (config.filter && typeof config.filter === "object") {
 			if (config.filter.enabled !== false && config.filter.hidden !== true) {
@@ -6183,11 +6404,12 @@ function buildTableOverrides(fields, legacyOverrides) {
 				enableColumnFilter: false
 			};
 		}
-		if (fieldEnumMeta || tableMeta || filterMeta) result[key] = {
+		if (fieldEnumMeta || fieldDataSourceMeta || tableMeta || filterMeta) result[key] = {
 			...result[key],
 			meta: {
 				...result[key]?.meta ?? {},
 				...fieldEnumMeta ?? {},
+				...fieldDataSourceMeta ?? {},
 				...tableMeta ?? {},
 				...filterMeta ?? {}
 			}
@@ -6225,7 +6447,8 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 		"x-hidden": true
 	};
 	if (fields) for (const [key, config] of Object.entries(fields)) {
-		const fieldOptions = normalizeFieldOptions(config.enum);
+		const fieldOptions = normalizeFieldOptions((config.form && typeof config.form === "object" ? config.form : void 0)?.enum) ?? normalizeFieldOptions(config.enum);
+		const fieldDataSource = fieldOptions || !config.dataSource ? void 0 : normalizeDataSourceConfig(config.dataSource);
 		if (config.label) result[key] = {
 			...result[key],
 			title: config.label
@@ -6238,6 +6461,10 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 			...result[key],
 			enum: fieldOptions
 		};
+		if (fieldDataSource) result[key] = {
+			...result[key],
+			"x-data-source": config.dataSource
+		};
 		if (config.form === false) result[key] = {
 			...result[key],
 			"x-hidden": true
@@ -6495,6 +6722,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 	const [selectedCount, setSelectedCount] = react.useState(0);
 	const [exporting, setExporting] = react.useState(false);
 	const getSelectedRowsRef = react.useRef(null);
+	const dynamicFilterOptions = useDynamicFilterOptions(resolvedFields);
 	const importColumns = react.useMemo(() => {
 		const shape = resolvedSchema.shape;
 		const denySet = new Set(denyFields ?? []);
@@ -6531,7 +6759,11 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 			setExporting(false);
 		}
 	}, [selectedCount, handleExport]);
-	const tableOverrides = react.useMemo(() => buildTableOverrides(resolvedFields, tableConfig?.overrides), [resolvedFields, tableConfig?.overrides]);
+	const tableOverrides = react.useMemo(() => buildTableOverrides(resolvedFields, tableConfig?.overrides, dynamicFilterOptions), [
+		resolvedFields,
+		tableConfig?.overrides,
+		dynamicFilterOptions
+	]);
 	const formOverrides = react.useMemo(() => buildFormOverrides(resolvedFields, formConfig?.overrides, denyFields), [
 		resolvedFields,
 		formConfig?.overrides,
@@ -8104,6 +8336,7 @@ exports.createMemoryDataSource = createMemoryDataSource;
 exports.createSelectColumn = createSelectColumn;
 exports.createTRPCDataSource = createTRPCDataSource;
 exports.createTableSchema = createTableSchema;
+exports.dataSources = dataSources;
 exports.dataToCSV = dataToCSV;
 exports.deDE = deDE;
 exports.downloadCSVTemplate = downloadCSVTemplate;
@@ -8111,6 +8344,7 @@ exports.enUS = enUS;
 exports.esES = esES;
 exports.exportAllToCSV = exportAllToCSV;
 exports.exportTableToCSV = exportTableToCSV;
+exports.formComponents = formComponents;
 exports.formatDate = formatDate;
 exports.frFR = frFR;
 exports.generateCSVTemplate = generateCSVTemplate;
@@ -8119,6 +8353,8 @@ exports.humanize = humanize;
 exports.jaJP = jaJP;
 exports.koKR = koKR;
 exports.noopToastAdapter = noopToastAdapter;
+exports.normalizeDataSourceConfig = normalizeDataSourceConfig;
+exports.normalizeOptions = normalizeOptions;
 exports.parseAsArrayOf = parseAsArrayOf;
 exports.parseAsInteger = parseAsInteger;
 exports.parseAsString = parseAsString;

package/dist/index.d.cts

@@ -622,6 +622,57 @@ type LocaleProp = string | DeepPartial<AutoCrudLocale>;
  */
 declare function resolveLocale(localeProp?: LocaleProp): AutoCrudLocale;
 //#endregion
+//#region src/lib/registries.d.ts
+type AutoCrudFormComponentConfig = {
+  component: React$1.ComponentType<any>;
+  decorator?: string | React$1.ComponentType<any>;
+  [key: string]: unknown;
+};
+type AutoCrudOption = {
+  value: string;
+  label: string;
+  searchText?: string | string[];
+  keywords?: string[];
+  count?: number;
+  disabled?: boolean;
+};
+type AutoCrudDataSourceContext = {
+  field: string;
+  search?: string;
+  values?: Record<string, unknown>;
+  signal?: AbortSignal;
+};
+type AutoCrudDataSourceResult = AutoCrudOption[] | {
+  options?: AutoCrudOption[];
+};
+type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
+type AutoCrudDataSourceConfig = string | {
+  key: string;
+  dependsOn?: string[];
+  resetOnChange?: boolean;
+};
+type RegistryListener = () => void;
+declare const formComponents: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
+  subscribe(listener: RegistryListener): () => void;
+};
+declare const dataSources: {
+  register(name: string, value: AutoCrudDataSourceLoader): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudDataSourceLoader | undefined;
+  all(): Record<string, AutoCrudDataSourceLoader>;
+  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
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
  * 筛选器独立配置
@@ -634,6 +685,8 @@ interface FilterConfig {
   variant?: 'text' | 'number' | 'range' | 'date' | 'dateRange' | 'boolean' | 'select' | 'multiSelect';
   /** select/multiSelect 的选项列表 */
   options?: FieldOption[];
+  /** select/multiSelect 的动态选项源 */
+  dataSource?: AutoCrudDataSourceConfig;
   /** range 的最小/最大值 */
   range?: [number, number];
   /** number 的单位 */
@@ -664,6 +717,8 @@ interface Field {
   label?: string;
   /** 字段级静态选项（表单、筛选、展示共用） */
   enum?: FieldOption[];
+  /** 字段级动态选项源（表单、筛选、展示共用） */
+  dataSource?: AutoCrudDataSourceConfig;
   /** 是否隐藏（表格和表单都隐藏） */
   hidden?: boolean;
   /** 是否参与 AutoCrud 全局搜索 */
@@ -1404,7 +1459,7 @@ interface MultiComboboxTriggerRenderProps {
   disabled?: boolean;
   readOnly?: boolean;
 }
-interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value' | 'onChange' | 'onValueChange'> {
+interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value' | 'defaultValue' | 'onChange' | 'onValueChange'> {
   value?: string[];
   defaultValue?: string[];
   onChange?: (value: string[]) => void;
@@ -1759,4 +1814,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 AutoCrudLocale, 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, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, 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 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 };

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_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { z } from "zod";
 import { ISchema } from "@formily/json-schema";
 
@@ -362,7 +362,7 @@ 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
 /**
@@ -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
 /**
@@ -622,6 +622,57 @@ type LocaleProp = string | DeepPartial<AutoCrudLocale>;
  */
 declare function resolveLocale(localeProp?: LocaleProp): AutoCrudLocale;
 //#endregion
+//#region src/lib/registries.d.ts
+type AutoCrudFormComponentConfig = {
+  component: React$1.ComponentType<any>;
+  decorator?: string | React$1.ComponentType<any>;
+  [key: string]: unknown;
+};
+type AutoCrudOption = {
+  value: string;
+  label: string;
+  searchText?: string | string[];
+  keywords?: string[];
+  count?: number;
+  disabled?: boolean;
+};
+type AutoCrudDataSourceContext = {
+  field: string;
+  search?: string;
+  values?: Record<string, unknown>;
+  signal?: AbortSignal;
+};
+type AutoCrudDataSourceResult = AutoCrudOption[] | {
+  options?: AutoCrudOption[];
+};
+type AutoCrudDataSourceLoader = (context: AutoCrudDataSourceContext) => AutoCrudDataSourceResult | Promise<AutoCrudDataSourceResult>;
+type AutoCrudDataSourceConfig = string | {
+  key: string;
+  dependsOn?: string[];
+  resetOnChange?: boolean;
+};
+type RegistryListener = () => void;
+declare const formComponents: {
+  register(name: string, value: AutoCrudFormComponentConfig): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudFormComponentConfig | undefined;
+  all(): Record<string, AutoCrudFormComponentConfig>;
+  subscribe(listener: RegistryListener): () => void;
+};
+declare const dataSources: {
+  register(name: string, value: AutoCrudDataSourceLoader): void;
+  unregister(name: string): void;
+  get(name: string): AutoCrudDataSourceLoader | undefined;
+  all(): Record<string, AutoCrudDataSourceLoader>;
+  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
 //#region src/components/auto-crud/auto-crud-table.d.ts
 /**
  * 筛选器独立配置
@@ -634,6 +685,8 @@ interface FilterConfig {
   variant?: 'text' | 'number' | 'range' | 'date' | 'dateRange' | 'boolean' | 'select' | 'multiSelect';
   /** select/multiSelect 的选项列表 */
   options?: FieldOption[];
+  /** select/multiSelect 的动态选项源 */
+  dataSource?: AutoCrudDataSourceConfig;
   /** range 的最小/最大值 */
   range?: [number, number];
   /** number 的单位 */
@@ -664,6 +717,8 @@ interface Field {
   label?: string;
   /** 字段级静态选项（表单、筛选、展示共用） */
   enum?: FieldOption[];
+  /** 字段级动态选项源（表单、筛选、展示共用） */
+  dataSource?: AutoCrudDataSourceConfig;
   /** 是否隐藏（表格和表单都隐藏） */
   hidden?: boolean;
   /** 是否参与 AutoCrud 全局搜索 */
@@ -880,7 +935,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>> {
@@ -912,7 +967,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>;
@@ -1214,7 +1269,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";
@@ -1256,7 +1311,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 {
@@ -1278,7 +1333,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";
@@ -1298,7 +1353,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"> {
@@ -1311,7 +1366,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"> {
@@ -1322,7 +1377,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> {
@@ -1334,7 +1389,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> {
@@ -1348,7 +1403,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"> {
@@ -1360,7 +1415,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"> {
@@ -1371,7 +1426,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> {
@@ -1382,7 +1437,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 {
@@ -1404,7 +1459,7 @@ interface MultiComboboxTriggerRenderProps {
   disabled?: boolean;
   readOnly?: boolean;
 }
-interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value' | 'onChange' | 'onValueChange'> {
+interface MultiComboboxProps extends Omit<ComponentProps<typeof Command>, 'value' | 'defaultValue' | 'onChange' | 'onValueChange'> {
   value?: string[];
   defaultValue?: string[];
   onChange?: (value: string[]) => void;
@@ -1759,4 +1814,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 AutoCrudLocale, 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, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, 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 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 };

package/dist/index.js

@@ -1,5 +1,5 @@
 import * as React from "react";
-import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useReducer, useRef } from "react";
+import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useReducer, useRef, useState } from "react";
 import { ArrowDownUp, BadgeCheck, CalendarIcon, Check, CheckCircle2, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, ChevronsLeft, ChevronsRight, ChevronsUpDown, CommandIcon, Download, Ellipsis, EyeOff, FileDown, FileSpreadsheetIcon, GripVertical, ListFilter, ListFilterIcon, Loader2, PlusCircle, Settings2, Text, Trash2, Upload, X, XCircle } from "lucide-react";
 import { flexRender, getCoreRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getPaginationRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Badge, Button, Calendar, Checkbox, Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuTrigger, Input, Label, Popover, PopoverContent, PopoverTrigger, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Separator, Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, Slider, Switch, cn as cn$1 } from "@pixpilot/shadcn";
@@ -15,7 +15,7 @@ import { Slot } from "@radix-ui/react-slot";
 import * as ReactDOM from "react-dom";
 import { useDirection } from "@radix-ui/react-direction";
 import { z } from "zod";
-import { createForm } from "@formily/core";
+import { createForm, onFieldValueChange } from "@formily/core";
 import { Form, JsonSchemaField } from "@pixpilot/formily-shadcn";
 import { connect, mapProps } from "@formily/react";
 import { toast } from "sonner";
@@ -5190,6 +5190,67 @@ function createEditFormSchema(schema, options) {
 	});
 }
 
+//#endregion
+//#region src/lib/registries.ts
+function createRegistry(label) {
+	const entries = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	const notify = () => {
+		queueMicrotask(() => {
+			for (const listener of listeners) listener();
+		});
+	};
+	return {
+		register(name, value) {
+			if (entries.has(name)) {
+				console.warn(`[AutoCrud] ${label} "${name}" is already registered.`);
+				return;
+			}
+			entries.set(name, value);
+			notify();
+		},
+		unregister(name) {
+			if (!entries.delete(name)) return;
+			notify();
+		},
+		get(name) {
+			return entries.get(name);
+		},
+		all() {
+			return Object.fromEntries(entries);
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+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;
+	return {
+		key: config.key,
+		dependsOn: Array.isArray(config.dependsOn) ? config.dependsOn : [],
+		resetOnChange: config.resetOnChange === true
+	};
+}
+function normalizeOptions(result) {
+	const options = Array.isArray(result) ? result : result?.options;
+	if (!Array.isArray(options)) return [];
+	return options.filter((option) => {
+		return typeof option === "object" && option !== null && typeof option.value === "string" && typeof option.label === "string";
+	}).map((option) => ({
+		...option,
+		value: String(option.value)
+	}));
+}
+
 //#endregion
 //#region src/components/auto-crud/auto-form.tsx
 const COMBOBOX_LIST_CLASS = "[&_[cmdk-list]]:max-h-[360px] [&_[cmdk-list]]:overflow-x-hidden [&_[cmdk-list]]:overflow-y-auto";
@@ -5224,6 +5285,104 @@ function AutoCrudMultiCombobox({ options = [],...props }) {
 		options
 	});
 }
+const defaultFieldComponents = {
+	Combobox: {
+		component: FormilyCombobox,
+		decorator: "FormItem"
+	},
+	MultiCombobox: {
+		component: FormilyMultiCombobox,
+		decorator: "FormItem"
+	},
+	Switch: {
+		component: FormilySwitch,
+		decorator: "FormItem"
+	}
+};
+function useRegistryVersion$1(subscribe) {
+	const [version, setVersion] = useState(0);
+	useEffect(() => subscribe(() => setVersion((current) => current + 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";
+}
+function collectDataSourceConfigs(schema, result = {}) {
+	const properties = schema.properties;
+	if (!properties || typeof properties !== "object") return result;
+	for (const [key, property] of Object.entries(properties)) {
+		if (!property || typeof property !== "object" || Array.isArray(property)) continue;
+		const record = property;
+		const customDataSource = record["x-data-source"];
+		const schemaDataSource = record.dataSource;
+		const dataSourceConfig = isDataSourceConfig(customDataSource) ? customDataSource : isDataSourceConfig(schemaDataSource) ? schemaDataSource : void 0;
+		if (dataSourceConfig) result[key] = dataSourceConfig;
+		collectDataSourceConfigs(record, result);
+	}
+	return result;
+}
+function useFormDataSources(form, schema) {
+	useEffect(() => {
+		const sourceEntries = Object.entries(collectDataSourceConfigs(schema)).map(([fieldName, config]) => {
+			const normalized = normalizeDataSourceConfig(config);
+			return normalized ? [fieldName, normalized] : void 0;
+		}).filter((entry) => entry !== void 0);
+		if (sourceEntries.length === 0) return;
+		let active = true;
+		const effectId = Symbol("autoCrudDataSources");
+		const loadVersions = /* @__PURE__ */ new Map();
+		const controller = typeof AbortController === "undefined" ? void 0 : new AbortController();
+		const loadFieldOptions = async (fieldName, source) => {
+			const version = (loadVersions.get(fieldName) ?? 0) + 1;
+			loadVersions.set(fieldName, version);
+			const loader = dataSources.get(source.key);
+			if (!loader) {
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = [];
+				});
+				return;
+			}
+			try {
+				const options = normalizeOptions(await loader({
+					field: fieldName,
+					values: Object.fromEntries(source.dependsOn.map((dependency) => [dependency, form.getValuesIn(dependency)])),
+					signal: controller?.signal
+				}));
+				if (!active || loadVersions.get(fieldName) !== version) return;
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = options;
+				});
+			} catch (error) {
+				if (!active || controller?.signal.aborted) return;
+				console.warn(`[AutoCrud] Failed to load data source "${source.key}".`, error);
+				form.setFieldState(fieldName, (state) => {
+					state.dataSource = [];
+				});
+			}
+		};
+		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 [fieldName, source] of sourceEntries) {
+					if (!source.dependsOn.includes(dependency)) continue;
+					if (source.resetOnChange) form.setValuesIn(fieldName, void 0);
+					loadFieldOptions(fieldName, source);
+				}
+			});
+		});
+		return () => {
+			active = false;
+			controller?.abort();
+			form.removeEffects(effectId);
+		};
+	}, [
+		form,
+		schema,
+		useRegistryVersion$1(dataSources.subscribe)
+	]);
+}
 function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides, mode = "create", loading = false, gridColumns = 1, labelAlign = "top", labelWidth, showSubmitButton = true }, ref) {
 	const form = useMemo(() => createForm({ initialValues }), [JSON.stringify(initialValues)]);
 	const formSchema = useMemo(() => createEditFormSchema(zodSchema, {
@@ -5239,6 +5398,11 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 		labelAlign,
 		labelWidth
 	]);
+	const fieldComponents = useMemo(() => ({ fields: {
+		...defaultFieldComponents,
+		...formComponents.all()
+	} }), [useRegistryVersion$1(formComponents.subscribe)]);
+	useFormDataSources(form, formSchema);
 	const handleSubmit = async () => {
 		await form.validate();
 		if (form.valid) await onSubmit(form.values);
@@ -5248,20 +5412,7 @@ function AutoFormInner({ schema: zodSchema, initialValues, onSubmit, overrides,
 		form,
 		children: [/* @__PURE__ */ jsx(JsonSchemaField, {
 			schema: formSchema,
-			components: { fields: {
-				Combobox: {
-					component: FormilyCombobox,
-					decorator: "FormItem"
-				},
-				MultiCombobox: {
-					component: FormilyMultiCombobox,
-					decorator: "FormItem"
-				},
-				Switch: {
-					component: FormilySwitch,
-					decorator: "FormItem"
-				}
-			} }
+			components: fieldComponents
 		}), showSubmitButton && /* @__PURE__ */ jsx("div", {
 			className: "flex justify-end gap-2 mt-6",
 			children: /* @__PURE__ */ jsx(Button, {
@@ -6075,6 +6226,7 @@ function mergeFieldConfig(base, override) {
 		...base,
 		...override,
 		enum: override?.enum ?? base?.enum,
+		dataSource: override?.dataSource ?? base?.dataSource,
 		table: mergeFieldPart(base?.table, override?.table),
 		filter: mergeFieldPart(base?.filter, override?.filter),
 		form: mergeFieldPart(base?.form, override?.form)
@@ -6107,6 +6259,69 @@ function toBatchOptions(options) {
 		value
 	}));
 }
+function getFilterDataSource(config) {
+	if (config.filter && typeof config.filter === "object") return config.filter.dataSource ?? config.dataSource;
+	return config.dataSource;
+}
+function shouldLoadDynamicFilterOptions(config) {
+	if (config.filter === false) return false;
+	if (normalizeFieldOptions(config.enum)) return false;
+	if (config.filter && typeof config.filter === "object") {
+		if (config.filter.enabled === false || config.filter.hidden === true) return false;
+		if (normalizeFieldOptions(config.filter.options)) return false;
+	}
+	return normalizeDataSourceConfig(getFilterDataSource(config)) !== void 0;
+}
+function useRegistryVersion(subscribe) {
+	const [version, setVersion] = React.useState(0);
+	React.useEffect(() => subscribe(() => setVersion((current) => current + 1)), [subscribe]);
+	return version;
+}
+function useDynamicFilterOptions(fields) {
+	const registryVersion = useRegistryVersion(dataSources.subscribe);
+	const [optionsByField, setOptionsByField] = React.useState({});
+	const sourceEntries = React.useMemo(() => {
+		if (!fields) return [];
+		return Object.entries(fields).flatMap(([field, config]) => {
+			if (!shouldLoadDynamicFilterOptions(config)) return [];
+			const source = normalizeDataSourceConfig(getFilterDataSource(config));
+			return source ? [{
+				field,
+				source
+			}] : [];
+		});
+	}, [fields]);
+	React.useEffect(() => {
+		if (sourceEntries.length === 0) {
+			setOptionsByField({});
+			return;
+		}
+		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, []];
+			try {
+				return [field, normalizeOptions(await loader({
+					field,
+					values: {},
+					signal: controller?.signal
+				}))];
+			} catch (error) {
+				if (!controller?.signal.aborted) console.warn(`[AutoCrud] Failed to load filter data source "${source.key}".`, error);
+				return [field, []];
+			}
+		})).then((entries) => {
+			if (!active) return;
+			setOptionsByField(Object.fromEntries(entries));
+		});
+		return () => {
+			active = false;
+			controller?.abort();
+		};
+	}, [sourceEntries, registryVersion]);
+	return optionsByField;
+}
 function getOptionLabel(value, options) {
 	const stringValue = String(value);
 	return options?.find((option) => option.value === stringValue)?.label ?? stringValue;
@@ -6115,15 +6330,21 @@ function getOptionLabel(value, options) {
 * 从统一配置生成表格 overrides
 * 当 filter 配置存在时，合并到 meta 中（不影响列隐藏）
 */
-function buildTableOverrides(fields, legacyOverrides) {
+function buildTableOverrides(fields, legacyOverrides, dynamicFilterOptions) {
 	const result = { ...legacyOverrides };
 	if (fields) for (const [key, config] of Object.entries(fields)) {
-		const tableOptions = toTableOptions(normalizeFieldOptions(config.enum));
+		const fieldOptions = normalizeFieldOptions(config.enum);
+		const tableOptions = toTableOptions(fieldOptions);
+		const dynamicOptions = !fieldOptions ? toTableOptions(normalizeFieldOptions(dynamicFilterOptions?.[key])) : void 0;
 		const tableMeta = config.table !== false && typeof config.table === "object" ? config.table.meta : void 0;
 		const fieldEnumMeta = tableOptions ? {
 			options: tableOptions,
 			variant: "multiSelect"
 		} : void 0;
+		const fieldDataSourceMeta = dynamicOptions ? {
+			options: dynamicOptions,
+			variant: "multiSelect"
+		} : void 0;
 		let filterMeta;
 		if (config.filter && typeof config.filter === "object") {
 			if (config.filter.enabled !== false && config.filter.hidden !== true) {
@@ -6141,11 +6362,12 @@ function buildTableOverrides(fields, legacyOverrides) {
 				enableColumnFilter: false
 			};
 		}
-		if (fieldEnumMeta || tableMeta || filterMeta) result[key] = {
+		if (fieldEnumMeta || fieldDataSourceMeta || tableMeta || filterMeta) result[key] = {
 			...result[key],
 			meta: {
 				...result[key]?.meta ?? {},
 				...fieldEnumMeta ?? {},
+				...fieldDataSourceMeta ?? {},
 				...tableMeta ?? {},
 				...filterMeta ?? {}
 			}
@@ -6183,7 +6405,8 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 		"x-hidden": true
 	};
 	if (fields) for (const [key, config] of Object.entries(fields)) {
-		const fieldOptions = normalizeFieldOptions(config.enum);
+		const fieldOptions = normalizeFieldOptions((config.form && typeof config.form === "object" ? config.form : void 0)?.enum) ?? normalizeFieldOptions(config.enum);
+		const fieldDataSource = fieldOptions || !config.dataSource ? void 0 : normalizeDataSourceConfig(config.dataSource);
 		if (config.label) result[key] = {
 			...result[key],
 			title: config.label
@@ -6196,6 +6419,10 @@ function buildFormOverrides(fields, legacyOverrides, denyFields) {
 			...result[key],
 			enum: fieldOptions
 		};
+		if (fieldDataSource) result[key] = {
+			...result[key],
+			"x-data-source": config.dataSource
+		};
 		if (config.form === false) result[key] = {
 			...result[key],
 			"x-hidden": true
@@ -6453,6 +6680,7 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 	const [selectedCount, setSelectedCount] = React.useState(0);
 	const [exporting, setExporting] = React.useState(false);
 	const getSelectedRowsRef = React.useRef(null);
+	const dynamicFilterOptions = useDynamicFilterOptions(resolvedFields);
 	const importColumns = React.useMemo(() => {
 		const shape = resolvedSchema.shape;
 		const denySet = new Set(denyFields ?? []);
@@ -6489,7 +6717,11 @@ function AutoCrudTable({ title, description, schema, resource, fields, table: ta
 			setExporting(false);
 		}
 	}, [selectedCount, handleExport]);
-	const tableOverrides = React.useMemo(() => buildTableOverrides(resolvedFields, tableConfig?.overrides), [resolvedFields, tableConfig?.overrides]);
+	const tableOverrides = React.useMemo(() => buildTableOverrides(resolvedFields, tableConfig?.overrides, dynamicFilterOptions), [
+		resolvedFields,
+		tableConfig?.overrides,
+		dynamicFilterOptions
+	]);
 	const formOverrides = React.useMemo(() => buildFormOverrides(resolvedFields, formConfig?.overrides, denyFields), [
 		resolvedFields,
 		formConfig?.overrides,
@@ -8036,4 +8268,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, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, noopToastAdapter, 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, 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.1.7",
+  "version": "1.2.0",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -65,9 +65,9 @@
     "nanoid": "^5.1.6",
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
-    "@pixpilot/shadcn": "1.2.7",
     "@pixpilot/formily-shadcn": "1.11.20",
-    "@pixpilot/shadcn-ui": "1.21.1"
+    "@pixpilot/shadcn-ui": "1.21.1",
+    "@pixpilot/shadcn": "1.2.7"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.90.15",
@@ -82,11 +82,11 @@
     "react-dom": "19.2.4",
     "tsdown": "^0.15.12",
     "typescript": "^5.9.3",
-    "@internal/prettier-config": "0.0.1",
     "@internal/eslint-config": "0.3.0",
-    "@internal/tsconfig": "0.1.0",
+    "@internal/prettier-config": "0.0.1",
+    "@internal/tsdown-config": "0.1.0",
     "@internal/vitest-config": "0.1.0",
-    "@internal/tsdown-config": "0.1.0"
+    "@internal/tsconfig": "0.1.0"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {