@wordrhyme/auto-crud 1.8.1 → 1.9.0

package/README.md

@@ -803,7 +803,7 @@ type ToolbarBuiltinActionItem = ActionMeta & {
 type ToolbarCustomActionItem = ActionMeta & {
   type: 'custom';
   component: React.ReactNode | ((context: AutoCrudToolbarContext) => React.ReactNode);
-  position?: 'start' | 'end'; // 仅在无内置项时生效，默认 "end"
+  position?: ActionPosition; // start/end 仅无内置项时生效；也支持 { anchor, side }
 };
 
 interface AutoCrudToolbarContext {
@@ -911,6 +911,28 @@ crudActions.register({
 `order` 不再重排同一插件数组内的显示顺序。内置属性覆盖仍沿用原有的 action `order`、`ownerId`、注册序优先级，最后一个配置生效。
 使用 `order` 排列同一插件操作的旧调用方，应把数组调整为所需顺序。最终权限过滤只移除不可用的内置操作，不改变其余操作顺序或授予权限。
 
+### 统一位置契约
+
+AutoCrud action 和 WordRhyme PluginSlot 共用 `ActionPosition`：`"start"`、`"end"`，或 `{ anchor, side: "before" | "after" }`。类型、schema、位置匹配和锚点排序从不依赖 React 的 `@wordrhyme/auto-crud/position` 导出。
+
+`positionActions(ownerActions, fills)` 合并拥有方按钮和扩展数组：`start` fills 放在数组前，`end` 或未指定位置的 fills 放在数组后，相对位置按基础按钮锚点插入。AutoCrud 和 PluginSlot 共用此解析器。原有 action 数组及 start/end 排列规则保持不变。指定锚点时，在原有合并、覆盖和隐藏之后定位，`order` 按升序排列同一锚点的 fills。AutoCrud 使用合并后基础 action 的 `id` 作为锚点；原生按钮未设置 `id` 时使用 `type`。合并后的动作列表不存在锚点时，不显示依赖它的扩展；最终权限过滤继续沿用已有行为。
+
+```tsx
+crudActions.register({
+  targetId: 'com.wordrhyme.shop.products',
+  zone: 'toolbar',
+  ownerId: 'com.wordrhyme.sync',
+  actions: [
+    {
+      type: 'custom',
+      component: SyncButton,
+      position: { anchor: 'create', side: 'before' },
+      order: 30,
+    },
+  ],
+});
+```
+
 ---
 
 ## 🎬 行操作配置
@@ -1005,7 +1027,7 @@ type RowCustomActionItem<T> = ActionMeta & {
   component?:
     | React.ReactNode
     | ((context: AutoCrudRowActionContext<T>) => React.ReactNode);
-  position?: 'start' | 'end'; // 仅无内置项时生效，默认 end
+  position?: ActionPosition; // start/end 仅无内置项时生效；也支持 { anchor, side }
   separator?: boolean;
   variant?: 'default' | 'destructive';
 };
@@ -1629,6 +1651,14 @@ MIT © [wordrhyme](https://github.com/denvey/wordrhyme-components)
 - [Notion](https://notion.so) - 高级筛选器设计
 - [Linear](https://linear.app) - 命令面板设计
 
+### Status badge colors
+
+For `table.display: "badge"`, a scalar field's `table.options` entries may set `badgeTone` to `neutral`, `success`, `warning`, or `info`. This renders a tinted, outlined rounded label with a decorative dot. Labels remain readable without color; omitted tones retain the default badge. `display: "text"` is unaffected. Domain-specific state-to-tone mappings belong in the consuming plugin metadata.
+
+Registered custom actions may set `before: "delete"` (or another builtin action type) to appear immediately before that action. If the builtin is absent, the existing `position` fallback applies. This only controls ordering and does not add or grant the target action.
+
+Custom row components receive `MenuItem` in their action context. Use this supplied primitive instead of importing a menu item from another UI bundle: the menu root and item must share the same Radix runtime context. Prevent the select event's default dismissal when the component owns an open dialog, so the menu does not unmount the workflow.
+
 ### Detail presentation
 
 Details automatically share field labels, `enum`/`dataSource` mappings and
@@ -1689,6 +1719,31 @@ is pinned to the already-published alpha.19 for reproducible ESM tests and type
 checks until alpha.20 is published; it is not the supported CommonJS runtime.
 The CommonJS export/identity regression belongs to the UI provider repository.
 
+### Filter-only fields
+
+Use `table: false` with an explicit `filter` to keep a field in the standard
+filter bar without rendering a data column. Shared `hidden`, permission `deny`,
+and explicit table exclusions still hide the filter. Pass the same filter
+configuration to the resource so URL values use the same variants/operators:
+
+```tsx
+const fields = {
+  customerId: {
+    label: 'Customer',
+    table: false as const,
+    form: false as const,
+    filter: { variant: 'select' as const, dataSource: 'customers', index: 20 },
+  },
+};
+const resource = useAutoCrudResource({ router, schema, fields });
+return <AutoCrudTable schema={schema} resource={resource} fields={fields} />;
+```
+
+The field must exist in the schema or resource metadata, and the server must
+resolve its filter. A data source loads options; it does not translate query
+conditions. Standard filters share URL state, Reset, and pagination. Dynamically
+registered schema fields hydrate existing URL values without resetting the page.
+
 ### 按 ID 隐藏或替换自定义操作
 
 拥有方为 custom 操作声明稳定 `id` 后，扩展可以在相同 CRUD target 和操作区域

package/dist/index.cjs

@@ -1,58 +1,36 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
+const require_position = require('./position-BlO0bPw6.cjs');
 let react = require("react");
-react = __toESM(react);
+react = require_position.__toESM(react);
 let lucide_react = require("lucide-react");
-lucide_react = __toESM(lucide_react);
+lucide_react = require_position.__toESM(lucide_react);
 let __tanstack_react_table = require("@tanstack/react-table");
-__tanstack_react_table = __toESM(__tanstack_react_table);
+__tanstack_react_table = require_position.__toESM(__tanstack_react_table);
 let __wordrhyme_shadcn = require("@wordrhyme/shadcn");
-__wordrhyme_shadcn = __toESM(__wordrhyme_shadcn);
+__wordrhyme_shadcn = require_position.__toESM(__wordrhyme_shadcn);
 let clsx = require("clsx");
-clsx = __toESM(clsx);
+clsx = require_position.__toESM(clsx);
 let tailwind_merge = require("tailwind-merge");
-tailwind_merge = __toESM(tailwind_merge);
+tailwind_merge = require_position.__toESM(tailwind_merge);
 let react_jsx_runtime = require("react/jsx-runtime");
-react_jsx_runtime = __toESM(react_jsx_runtime);
+react_jsx_runtime = require_position.__toESM(react_jsx_runtime);
 let nanoid = require("nanoid");
-nanoid = __toESM(nanoid);
+nanoid = require_position.__toESM(nanoid);
 let __wordrhyme_shadcn_ui = require("@wordrhyme/shadcn-ui");
-__wordrhyme_shadcn_ui = __toESM(__wordrhyme_shadcn_ui);
+__wordrhyme_shadcn_ui = require_position.__toESM(__wordrhyme_shadcn_ui);
 let __wordrhyme_ui = require("@wordrhyme/ui");
-__wordrhyme_ui = __toESM(__wordrhyme_ui);
+__wordrhyme_ui = require_position.__toESM(__wordrhyme_ui);
 let zod = require("zod");
-zod = __toESM(zod);
+zod = require_position.__toESM(zod);
 let __wordrhyme_formily_shadcn = require("@wordrhyme/formily-shadcn");
-__wordrhyme_formily_shadcn = __toESM(__wordrhyme_formily_shadcn);
+__wordrhyme_formily_shadcn = require_position.__toESM(__wordrhyme_formily_shadcn);
 let __formily_core = require("@formily/core");
-__formily_core = __toESM(__formily_core);
+__formily_core = require_position.__toESM(__formily_core);
 let __formily_reactive = require("@formily/reactive");
-__formily_reactive = __toESM(__formily_reactive);
+__formily_reactive = require_position.__toESM(__formily_reactive);
 let sonner = require("sonner");
-sonner = __toESM(sonner);
+sonner = require_position.__toESM(sonner);
 let __tanstack_react_query = require("@tanstack/react-query");
-__tanstack_react_query = __toESM(__tanstack_react_query);
+__tanstack_react_query = require_position.__toESM(__tanstack_react_query);
 
 //#region src/lib/utils.ts
 function cn(...inputs) {
@@ -1034,6 +1012,11 @@ function useReadableFilters(columns, options = {}) {
 		filtersRef.current = initial;
 		return initial;
 	});
+	react.useEffect(() => {
+		const next = parseReadableFilters(getUrlParams(), columnSnapshot);
+		filtersRef.current = next;
+		setFilters((previous) => JSON.stringify(previous) === JSON.stringify(next) ? previous : next);
+	}, [columnSnapshot]);
 	react.useEffect(() => {
 		const handleUrlChange = () => {
 			if (lastWrittenUrlRef.current !== null && window.location.search === lastWrittenUrlRef.current) {
@@ -4112,7 +4095,7 @@ function AutoTableActionBar({ table, onDeleteSelected, onUpdateSelected, batchUp
 			{ type: "export" },
 			{ type: "delete" }
 		]) : actions;
-		const resolvedActions = configuredActions?.filter((action$1) => !action$1.hidden);
+		let resolvedActions = configuredActions?.filter((action$1) => !action$1.hidden);
 		if (configuredActions === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 			renderBuiltinAction({ type: "batchUpdate" }),
 			extraActions,
@@ -4120,7 +4103,20 @@ function AutoTableActionBar({ table, onDeleteSelected, onUpdateSelected, batchUp
 			renderBuiltinAction({ type: "delete" })
 		] });
 		if (!resolvedActions || resolvedActions.length === 0) return null;
-		if (!resolvedActions.some((action$1) => action$1.type !== "custom")) {
+		let hasBuiltin = resolvedActions.some((action$1) => action$1.type !== "custom");
+		if (resolvedActions.some((action$1) => "position" in action$1 && typeof action$1.position === "object")) if (!hasBuiltin) {
+			resolvedActions = require_position.positionActions([
+				{ type: "batchUpdate" },
+				...extraActions ? [{
+					type: "custom",
+					component: extraActions
+				}] : [],
+				...showDefaultExport ? [{ type: "export" }] : [],
+				{ type: "delete" }
+			], resolvedActions);
+			hasBuiltin = true;
+		} else resolvedActions = require_position.positionActions(resolvedActions);
+		if (!hasBuiltin) {
 			const startNodes = resolvedActions.filter(isBatchCustomAction).filter((action$1) => action$1.position === "start").map((action$1, index$1) => renderCustomAction(action$1, index$1));
 			const endNodes = resolvedActions.filter(isBatchCustomAction).filter((action$1) => action$1.position !== "start").map((action$1, index$1) => renderCustomAction(action$1, index$1));
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
@@ -4423,7 +4419,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, pageCount = 1, pagination, total, overrides, classNames, enableRowSelection = true, exclude, actions, pinnedColumns, filterMode, search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, deleteConfirmation, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, onSelectedRowsChange, getSelectedRows }) {
+function AutoTable({ schema, data, pageCount = 1, pagination, total, overrides, classNames, enableRowSelection = true, exclude, filterOnly, actions, pinnedColumns, filterMode, search = false, onDeleteSelected, onUpdateSelected, batchUpdateFields, actionBarExtra, actionBarActions, deleteConfirmation, initialSorting, enableExport = true, showDefaultExport = true, onSelectedCountChange, onSelectedRowsChange, getSelectedRows }) {
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
 	const [currentMode, setCurrentMode] = useQueryState("filterMode", parseAsStringEnum(modes).withDefault(modes[0] ?? "simple"));
 	const showToggle = modes.length > 1;
@@ -4438,9 +4434,24 @@ function AutoTable({ schema, data, pageCount = 1, pagination, total, overrides,
 	const searchConfig = search && typeof search === "object" ? search : {};
 	const enableAdvancedFilter = true;
 	const columns = (0, react.useMemo)(() => {
+		const columnOverrides = Object.assign({}, overrides);
+		for (const key of filterOnly ?? []) {
+			const field = key;
+			Object.assign(columnOverrides, { [field]: {
+				...columnOverrides[field],
+				hidden: false
+			} });
+		}
 		const dataColumns = createTableSchema(schema, {
-			overrides,
+			overrides: columnOverrides,
 			exclude
+		}).map((column) => {
+			const key = column.id ?? ("accessorKey" in column ? String(column.accessorKey) : "");
+			return filterOnly?.includes(key) ? {
+				...column,
+				enableHiding: false,
+				enableSorting: false
+			} : column;
 		});
 		const result = enableRowSelection ? [createSelectColumn(), ...dataColumns] : dataColumns;
 		if (actions) result.push(createActionsColumn(actions));
@@ -4450,7 +4461,8 @@ function AutoTable({ schema, data, pageCount = 1, pagination, total, overrides,
 		overrides,
 		enableRowSelection,
 		exclude,
-		actions
+		actions,
+		filterOnly
 	]);
 	const stableInitialState = (0, react.useMemo)(() => ({
 		sorting: initialSorting,
@@ -4474,6 +4486,16 @@ function AutoTable({ schema, data, pageCount = 1, pagination, total, overrides,
 		shallow: false,
 		clearOnDefault: true
 	});
+	(0, react.useEffect)(() => {
+		if (!filterOnly?.length) return;
+		table.setColumnVisibility((previous) => {
+			if (filterOnly.every((key) => previous[key] === false)) return previous;
+			return {
+				...previous,
+				...Object.fromEntries(filterOnly.map((key) => [key, false]))
+			};
+		});
+	}, [table, filterOnly]);
 	const rowSelection = table.getState().rowSelection;
 	const columnFilters = table.getState().columnFilters;
 	const selectedRows = (0, react.useMemo)(() => table.getFilteredSelectedRowModel().rows.map((row) => row.original), [
@@ -4914,6 +4936,30 @@ function normalizeHasMore(result) {
 
 //#endregion
 //#region src/lib/field-config.ts
+function mergeFieldPart(base, override) {
+	if (override === void 0) return base;
+	if (override === false || base === false || typeof base !== "object" || typeof override !== "object" || base === null || override === null || Array.isArray(base) || Array.isArray(override)) return override;
+	return {
+		...base,
+		...override
+	};
+}
+function mergeFieldConfig(base, override) {
+	return {
+		...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)
+	};
+}
+function mergeFields(base, override) {
+	if (!base && !override) return void 0;
+	const keys = new Set([...Object.keys(base ?? {}), ...Object.keys(override ?? {})]);
+	return Object.fromEntries(Array.from(keys).map((key) => [key, mergeFieldConfig(base?.[key], override?.[key])]));
+}
 function normalizeFieldOptions$1(options) {
 	if (!options || options.length === 0) return void 0;
 	return options.map((option) => ({
@@ -6273,15 +6319,18 @@ function unregisterOwnerActions(ownerId, options = {}, shouldNotify = true) {
 	if (changed && shouldNotify) notify();
 }
 function sortEntries(left, right) {
-	const orderDiff = left.order - right.order;
+	const orderDiff = require_position.compareOrder(left, right);
 	if (orderDiff !== 0) return orderDiff;
 	const ownerDiff = left.ownerId.localeCompare(right.ownerId);
 	if (ownerDiff !== 0) return ownerDiff;
 	return left.seq - right.seq;
 }
 function withoutRegistryMeta(action$1) {
-	const { id, order,...rest } = action$1;
-	return rest;
+	const { id, order, position,...rest } = action$1;
+	return {
+		...rest,
+		...typeof position === "string" ? { position } : {}
+	};
 }
 function isCustomAction$1(action$1) {
 	return action$1.type === "custom";
@@ -6296,12 +6345,10 @@ function resolveActions$1(targetId, zone, ownerActions) {
 		if (isCustomAction$1(action$1) && action$1.id && !isMaskedCustom(action$1)) customOverrides.set(action$1.id, entry);
 	}
 	const ownerCustomIds = new Set(ownerActions.flatMap((action$1) => isCustomAction$1(action$1) && action$1.id ? [action$1.id] : []));
-	const baseActions = ownerActions.filter((action$1) => !action$1.hidden && !isMaskedCustom(action$1)).map((action$1) => withoutRegistryMeta(isCustomAction$1(action$1) && action$1.id ? customOverrides.get(action$1.id)?.action ?? action$1 : action$1));
+	const baseActions = ownerActions.filter((action$1) => !action$1.hidden && !isMaskedCustom(action$1)).map((action$1) => ({ ...isCustomAction$1(action$1) && action$1.id ? customOverrides.get(action$1.id)?.action ?? action$1 : action$1 }));
 	const isReplacedCustom = ({ action: action$1, seq: seq$1 }) => isCustomAction$1(action$1) && Boolean(action$1.id && (ownerCustomIds.has(action$1.id) || customOverrides.get(action$1.id)?.seq !== seq$1));
-	if (registered.length === 0) return baseActions;
 	const nextActions = [...baseActions];
-	const startCustomActions = [];
-	const endCustomActions = [];
+	const extraActions = [];
 	const groups = /* @__PURE__ */ new Map();
 	for (const entry of registered) {
 		if (isMaskedCustom(entry.action)) continue;
@@ -6315,7 +6362,7 @@ function resolveActions$1(targetId, zone, ownerActions) {
 			if (existingIndex >= 0) nextActions.splice(existingIndex, 1);
 			continue;
 		}
-		const builtin = withoutRegistryMeta(action$1);
+		const builtin = action$1;
 		if (existingIndex >= 0) nextActions[existingIndex] = {
 			...nextActions[existingIndex],
 			...builtin
@@ -6326,7 +6373,13 @@ function resolveActions$1(targetId, zone, ownerActions) {
 		const items = group.sort((left, right) => left.seq - right.seq).flatMap((entry) => {
 			const { action: action$1 } = entry;
 			if (action$1.hidden || isReplacedCustom(entry)) return [];
-			if (isCustomAction$1(action$1)) return [withoutRegistryMeta(action$1)];
+			if (isCustomAction$1(action$1)) {
+				if (action$1.before) {
+					extraActions.push({ ...action$1 });
+					return [];
+				}
+				return [{ ...action$1 }];
+			}
 			const builtin = nextActions.find((item) => item.type === action$1.type);
 			return builtin ? [builtin] : [];
 		});
@@ -6345,13 +6398,18 @@ function resolveActions$1(targetId, zone, ownerActions) {
 					cursor += 1;
 				}
 			}
-		} else for (const custom of items) (custom.position === "start" ? startCustomActions : endCustomActions).push(custom);
+		} else extraActions.push(...items);
 	}
-	return [
-		...startCustomActions,
-		...nextActions,
-		...endCustomActions
-	];
+	for (const action$1 of [...nextActions, ...extraActions]) {
+		if (!isCustomAction$1(action$1) || !action$1.before) continue;
+		const anchor = nextActions.find((item) => !isCustomAction$1(item) && item.type === action$1.before);
+		if (anchor) action$1.position = {
+			anchor: anchor.id ?? anchor.type,
+			side: "before"
+		};
+		else if (typeof action$1.position === "object") action$1.position = "end";
+	}
+	return require_position.positionActions(nextActions, extraActions).map(withoutRegistryMeta);
 }
 const crudActions = {
 	register(registration) {
@@ -6453,8 +6511,8 @@ function resolveOwnerActions(config, defaults) {
 	const items = resolved !== void 0 && resolved.length > 0 ? [...resolved] : [];
 	if (items.length === 0) return [...defaults];
 	if (items.some((item) => !isCustomAction(item))) return items;
-	const startItems = items.filter((item) => isCustomAction(item) && item.position === "start");
-	const endItems = items.filter((item) => isCustomAction(item) && item.position !== "start");
+	const startItems = items.filter((item) => isCustomAction(item) && require_position.matchesPosition(item.position, "start"));
+	const endItems = items.filter((item) => isCustomAction(item) && !require_position.matchesPosition(item.position, "start"));
 	return [
 		...startItems,
 		...defaults,
@@ -6500,30 +6558,6 @@ function resolveToolbarActionsWithResolver(targetId, ownerActions, context) {
 	const resolver = autoCrudToolbarResolver;
 	return targetId !== void 0 && targetId.length > 0 && resolver !== null ? resolver(targetId, ownerActions, context) : ownerActions;
 }
-function mergeFieldPart(base, override) {
-	if (override === void 0) return base;
-	if (override === false || base === false || typeof base !== "object" || typeof override !== "object" || base === null || override === null || Array.isArray(base) || Array.isArray(override)) return override;
-	return {
-		...base,
-		...override
-	};
-}
-function mergeFieldConfig(base, override) {
-	return {
-		...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)
-	};
-}
-function mergeFields(base, override) {
-	if (!base && !override) return void 0;
-	const keys = new Set([...Object.keys(base ?? {}), ...Object.keys(override ?? {})]);
-	return Object.fromEntries(Array.from(keys).map((key) => [key, mergeFieldConfig(base?.[key], override?.[key])]));
-}
 function applyResourceTablePresentation(fields, resourceFields) {
 	if (!fields || !resourceFields) return fields;
 	return Object.fromEntries(Object.entries(fields).map(([key, config]) => {
@@ -7425,6 +7459,12 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 	const [exporting, setExporting] = react.useState(false);
 	const getSelectedRowsRef = react.useRef(null);
 	const dynamicFilterOptions = useDynamicFilterOptions(resolvedFields);
+	const filterOnly = react.useMemo(() => Object.entries(resolvedFields).filter(([key, config]) => config.table === false && config.filter && config.hidden !== true && !denyFields?.includes(key) && !tableConfig?.hidden?.includes(key) && tableConfig?.overrides?.[key]?.hidden !== true).map(([key]) => key), [
+		resolvedFields,
+		denyFields,
+		tableConfig?.hidden,
+		tableConfig?.overrides
+	]);
 	const hiddenColumns = react.useMemo(() => buildHiddenColumns(resolvedFields, tableConfig?.hidden, denyFields, tableConfig?.overrides), [
 		resolvedFields,
 		tableConfig?.hidden,
@@ -7775,7 +7815,8 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 				...resource.tableData.total !== void 0 ? { total: resource.tableData.total } : {},
 				overrides: tableOverrides,
 				classNames: tableConfig?.classNames,
-				exclude: hiddenColumns,
+				exclude: hiddenColumns.filter((key) => !filterOnly.includes(key)),
+				filterOnly,
 				filterMode: tableConfig?.filterModes,
 				search: searchConfig,
 				actions: tableRowActions,
@@ -8608,7 +8649,7 @@ function modalReducer(state, action$1) {
 /**
 * Hook 主函数
 */
-function useAutoCrudResource({ router, schema, query: queryTransform, options = {} }) {
+function useAutoCrudResource({ router, schema, query: queryTransform, fields, options = {} }) {
 	const { idKey = "id", defaultVariant = "dialog", hooks, toast: toastAdapter, exportFetcher, defaultSort: defaultSortOption } = options;
 	const toast = (0, react.useMemo)(() => toastAdapter === false ? noopToastAdapter : toastAdapter ?? defaultToastAdapter, [toastAdapter]);
 	const hooksRef = (0, react.useRef)(hooks);
@@ -8620,7 +8661,14 @@ function useAutoCrudResource({ router, schema, query: queryTransform, options =
 	const defaultSorting = (0, react.useMemo)(() => defaultSortOption === false ? [] : defaultSortOption ?? getDefaultSortingForSchema(resolvedSchema), [defaultSortOption, resolvedSchema]);
 	const metadataFields = (0, react.useMemo)(() => readMetadataFields(metadata?.fields), [metadata?.fields]);
 	const capabilities = metadata?.capabilities;
-	const columns = (0, react.useMemo)(() => createTableSchema(resolvedSchema), [resolvedSchema]);
+	const columns = (0, react.useMemo)(() => createTableSchema(resolvedSchema, { overrides: Object.fromEntries(Object.entries(mergeFields(metadataFields, fields) ?? {}).flatMap(([key, field]) => {
+		const filter = field.filter;
+		return filter && typeof filter === "object" && filter.variant ? [[key, { meta: { variant: filter.variant } }]] : [];
+	})) }), [
+		resolvedSchema,
+		fields,
+		metadataFields
+	]);
 	const [urlParams] = useQueryStates({
 		page: parseAsInteger.withDefault(1),
 		perPage: parseAsInteger.withDefault(10),
@@ -9275,8 +9323,10 @@ Object.defineProperty(exports, 'Select', {
     return __wordrhyme_shadcn_ui.Select;
   }
 });
+exports.actionPositionSchema = require_position.actionPositionSchema;
 exports.cn = cn;
 exports.coerceRowValues = coerceRowValues;
+exports.compareOrder = require_position.compareOrder;
 exports.components = components;
 exports.createActionsColumn = createActionsColumn;
 exports.createEditFormSchema = createEditFormSchema;
@@ -9302,6 +9352,7 @@ exports.getUrlParams = getUrlParams;
 exports.humanize = humanize;
 exports.jaJP = jaJP;
 exports.koKR = koKR;
+exports.matchesPosition = require_position.matchesPosition;
 exports.noopToastAdapter = noopToastAdapter;
 exports.normalizeDataSourceConfig = normalizeDataSourceConfig;
 exports.normalizeOptions = normalizeOptions;
@@ -9313,6 +9364,7 @@ exports.parseCSV = parseCSV;
 exports.parseImportFile = parseImportFile;
 exports.parseJSON = parseJSON;
 exports.parseZodField = parseZodField;
+exports.positionActions = require_position.positionActions;
 exports.resolveLocale = resolveLocale;
 exports.setDateFormatter = setDateFormatter;
 exports.setSearchParams = setSearchParams;