@wordrhyme/auto-crud 1.8.1 → 1.8.2

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';
 };

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) {
@@ -4112,7 +4090,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 +4098,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: [
@@ -6273,15 +6264,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 +6290,11 @@ 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;
+	if (registered.length === 0) return require_position.positionActions(baseActions).map(withoutRegistryMeta);
 	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 +6308,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 +6319,7 @@ 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)) return [{ ...action$1 }];
 			const builtin = nextActions.find((item) => item.type === action$1.type);
 			return builtin ? [builtin] : [];
 		});
@@ -6345,13 +6338,9 @@ 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
-	];
+	return require_position.positionActions(nextActions, extraActions).map(withoutRegistryMeta);
 }
 const crudActions = {
 	register(registration) {
@@ -6453,8 +6442,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,
@@ -9275,8 +9264,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 +9293,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 +9305,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;

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { a as positionActions, i as matchesPosition, n as actionPositionSchema, r as compareOrder, t as ActionPosition } from "./position-DoBV7yB6.cjs";
 import * as react_jsx_runtime2 from "react/jsx-runtime";
 import * as React$1 from "react";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
@@ -219,9 +220,9 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
+    date: "date";
     text: "text";
     range: "range";
-    date: "date";
     dateRange: "dateRange";
     select: "select";
     multiSelect: "multiSelect";
@@ -691,8 +692,8 @@ type BatchCustomActionItem<TData> = BatchActionMeta & {
   onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
   /** 渲染自定义内容 */
   component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
-  position?: 'start' | 'end';
+  /** start/end 仅在无内置项时生效（默认 end）；也可指定锚点的 before/after。 */
+  position?: ActionPosition;
   variant?: 'default' | 'destructive';
 };
 type BatchActionItem<TData> = BatchBuiltinActionItem<TData> | BatchCustomActionItem<TData>;
@@ -1270,7 +1271,7 @@ type RowCustomActionItem<T> = ActionMeta & {
   label?: string;
   onClick?: (row: T) => void;
   component?: ActionComponent<AutoCrudRowActionContext<T>>;
-  position?: 'start' | 'end';
+  position?: ActionPosition;
   separator?: boolean;
   variant?: 'default' | 'destructive';
 };
@@ -1312,8 +1313,8 @@ type ToolbarCustomActionItem = ActionMeta & {
   type: 'custom';
   /** 渲染自定义内容 */
   component: ActionComponent<AutoCrudToolbarContext>;
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
-  position?: 'start' | 'end';
+  /** start/end 仅在无内置项时生效（默认 end）；也可指定锚点的 before/after。 */
+  position?: ActionPosition;
 };
 type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
 type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
@@ -1720,7 +1721,7 @@ type CrudActionBase = {
   id?: string;
   order?: number;
   hidden?: boolean;
-  position?: 'start' | 'end';
+  position?: ActionPosition;
 };
 type CrudActionEntry<TAction extends CrudActionBase = CrudActionBase> = {
   targetId: string;
@@ -2103,4 +2104,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TablePaginationOptions, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, 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, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TablePaginationOptions, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { a as positionActions, i as matchesPosition, n as actionPositionSchema, r as compareOrder, t as ActionPosition } from "./position-mYekVBBH.js";
 import * as React$1 from "react";
 import * as _tanstack_react_table0 from "@tanstack/react-table";
 import { Column, ColumnDef, ColumnMeta, ColumnSort, Row, RowData, Table, TableOptions, TableState } from "@tanstack/react-table";
@@ -219,9 +220,9 @@ declare const filterItemSchema: z.ZodObject<{
   variant: z.ZodEnum<{
     number: "number";
     boolean: "boolean";
+    date: "date";
     text: "text";
     range: "range";
-    date: "date";
     dateRange: "dateRange";
     select: "select";
     multiSelect: "multiSelect";
@@ -691,8 +692,8 @@ type BatchCustomActionItem<TData> = BatchActionMeta & {
   onClick?: (rows: TData[], context: BatchActionContext<TData>, event: React$1.MouseEvent<HTMLButtonElement>) => void;
   /** 渲染自定义内容 */
   component?: React$1.ReactNode | ((context: BatchActionContext<TData>) => React$1.ReactNode);
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
-  position?: 'start' | 'end';
+  /** start/end 仅在无内置项时生效（默认 end）；也可指定锚点的 before/after。 */
+  position?: ActionPosition;
   variant?: 'default' | 'destructive';
 };
 type BatchActionItem<TData> = BatchBuiltinActionItem<TData> | BatchCustomActionItem<TData>;
@@ -1270,7 +1271,7 @@ type RowCustomActionItem<T> = ActionMeta & {
   label?: string;
   onClick?: (row: T) => void;
   component?: ActionComponent<AutoCrudRowActionContext<T>>;
-  position?: 'start' | 'end';
+  position?: ActionPosition;
   separator?: boolean;
   variant?: 'default' | 'destructive';
 };
@@ -1312,8 +1313,8 @@ type ToolbarCustomActionItem = ActionMeta & {
   type: 'custom';
   /** 渲染自定义内容 */
   component: ActionComponent<AutoCrudToolbarContext>;
-  /** 仅在无内置项时生效：插入到首部还是尾部（默认 end） */
-  position?: 'start' | 'end';
+  /** start/end 仅在无内置项时生效（默认 end）；也可指定锚点的 before/after。 */
+  position?: ActionPosition;
 };
 type ToolbarActionItem = ToolbarBuiltinActionItem | ToolbarCustomActionItem;
 type ToolbarActionConfig = ToolbarActionItem[] | ((defaults: ToolbarBuiltinActionItem[]) => ToolbarActionItem[]);
@@ -1720,7 +1721,7 @@ type CrudActionBase = {
   id?: string;
   order?: number;
   hidden?: boolean;
-  position?: 'start' | 'end';
+  position?: ActionPosition;
 };
 type CrudActionEntry<TAction extends CrudActionBase = CrudActionBase> = {
   targetId: string;
@@ -2103,4 +2104,4 @@ declare function exportAllToCSV<T extends Record<string, unknown>>(data: T[], op
  */
 declare function downloadCSVTemplate(headers: string[], filename?: string): void;
 //#endregion
-export { type ActionConfig, type ActionItem, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TablePaginationOptions, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, 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, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };
+export { type ActionConfig, type ActionItem, type ActionPosition, type ActionsColumnConfig, type AutoCrudActionConfig, type AutoCrudActionsConfig, type AutoCrudDataSourceConfig, type AutoCrudDataSourceContext, type AutoCrudDataSourceEntry, type AutoCrudDataSourceLoader, type AutoCrudDataSourceRegistration, type AutoCrudFormComponentConfig, type AutoCrudLocale, type AutoCrudOption, type AutoCrudQueryCapabilities, type AutoCrudRowActionContext, type AutoCrudRowOpenOptions, AutoCrudTable, type AutoCrudTableProps, type AutoCrudToolbarContext, type AutoCrudToolbarResolver, AutoForm, type AutoFormProps, 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, type CrudActionBase, type CrudActionEntry, type CrudActionRegistration, type CrudActionZone, CrudFormModal, type CrudHooks, type CrudOperationPermissions, type CrudPermissions, type DataSource, DataTable, DataTableAdvancedToolbar, DataTableClassNames, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableRowAction, DataTableToolbar, DataTableViewOptions, type DateFormatPreset, type DateFormatter, type DateLocaleOptions, type EnumOption, ExportDialog, type ExportDialogProps, type ExportMode, ExtendedColumnFilter, ExtendedColumnSort, type Field, type FieldOption, type FieldTableDisplay, type FieldType, type Fields, type FilterConfig, FilterOperator, type FilterVariant, type FormSchemaOverrides, ImportDialog, type ImportDialogProps, type ImportResult, type JSONSchema, type JSONSchemaProperty, JoinOperator, type ListParams, type ListResult, type LocaleProp, MultiCombobox, type MultiComboboxOption, type MultiComboboxProps, type MultiComboboxTriggerRenderProps, Option, type ParsedImportData, type ParsedZodField, type Parser, QueryKeys, type RowActionConfig, type RowActionDialogProps, type RowActionItem, type RowBuiltinActionItem, type RowBuiltinActionType, type RowCustomActionItem, SchemaAdapter, Select, type SelectMode, type SelectOption, type SelectProps, type SelectSearchableDynamicProps, type SelectSearchableMultipleProps, type SelectSearchableProps, type SelectSearchableSingleProps, type SelectSimpleProps, type SelectTriggerRenderProps, type SimpleFieldConfig, type SimpleFieldsConfig, type TablePaginationOptions, type ToastAdapter, type ToolbarActionConfig, type ToolbarActionItem, type ToolbarBuiltinActionItem, type ToolbarBuiltinActionType, type ToolbarCustomActionItem, type UnifiedField, type UnifiedSchema, type UrlStateOptions, type UseAutoCrudResourceOptions, type UseAutoCrudResourceParams, type UseAutoCrudResourceReturn, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { i as positionActions, n as compareOrder, r as matchesPosition, t as actionPositionSchema } from "./position--p6kJnYA.js";
 import * as React from "react";
 import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useReducer, useRef, useState, useSyncExternalStore } 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, RefreshCw, Settings2, Text, Trash2, Upload, X, XCircle } from "lucide-react";
@@ -4074,7 +4075,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__ */ jsxs(Fragment, { children: [
 			renderBuiltinAction({ type: "batchUpdate" }),
 			extraActions,
@@ -4082,7 +4083,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 = positionActions([
+				{ type: "batchUpdate" },
+				...extraActions ? [{
+					type: "custom",
+					component: extraActions
+				}] : [],
+				...showDefaultExport ? [{ type: "export" }] : [],
+				{ type: "delete" }
+			], resolvedActions);
+			hasBuiltin = true;
+		} else resolvedActions = 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__ */ jsxs(Fragment, { children: [
@@ -6235,15 +6249,18 @@ function unregisterOwnerActions(ownerId, options = {}, shouldNotify = true) {
 	if (changed && shouldNotify) notify();
 }
 function sortEntries(left, right) {
-	const orderDiff = left.order - right.order;
+	const orderDiff = 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";
@@ -6258,12 +6275,11 @@ 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;
+	if (registered.length === 0) return positionActions(baseActions).map(withoutRegistryMeta);
 	const nextActions = [...baseActions];
-	const startCustomActions = [];
-	const endCustomActions = [];
+	const extraActions = [];
 	const groups = /* @__PURE__ */ new Map();
 	for (const entry of registered) {
 		if (isMaskedCustom(entry.action)) continue;
@@ -6277,7 +6293,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
@@ -6288,7 +6304,7 @@ 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)) return [{ ...action$1 }];
 			const builtin = nextActions.find((item) => item.type === action$1.type);
 			return builtin ? [builtin] : [];
 		});
@@ -6307,13 +6323,9 @@ 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
-	];
+	return positionActions(nextActions, extraActions).map(withoutRegistryMeta);
 }
 const crudActions = {
 	register(registration) {
@@ -6415,8 +6427,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) && matchesPosition(item.position, "start"));
+	const endItems = items.filter((item) => isCustomAction(item) && !matchesPosition(item.position, "start"));
 	return [
 		...startItems,
 		...defaults,
@@ -9209,4 +9221,4 @@ function createMemoryDataSource(initialData = []) {
 }
 
 //#endregion
-export { AutoCrudTable, AutoForm, AutoTable, AutoTableActionBar, AutoTableSimpleFilters, CrudFormModal, DataTable, DataTableAdvancedToolbar, DataTableColumnHeader, DataTableFacetedFilter, DataTablePagination, DataTableToolbar, DataTableViewOptions, ExportDialog, ImportDialog, MultiCombobox, SchemaAdapter, Select, cn, coerceRowValues, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, 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, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, 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, Select, actionPositionSchema, cn, coerceRowValues, compareOrder, components, createActionsColumn, createEditFormSchema, createFormSchema, createMemoryDataSource, createSelectColumn, createTRPCDataSource, createTableSchema, crudActions, dataSources, dataToCSV, deDE, downloadCSVTemplate, enUS, esES, exportAllToCSV, exportTableToCSV, formComponents, formatDate, frFR, generateCSVTemplate, getUrlParams, humanize, jaJP, koKR, matchesPosition, noopToastAdapter, normalizeDataSourceConfig, normalizeOptions, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringEnum, parseCSV, parseImportFile, parseJSON, parseZodField, positionActions, resolveLocale, setDateFormatter, setSearchParams, setToolbarResolver, tablePagination, useAutoCrudResource, useDataTable, useQueryState, useQueryStates, useReadableFilters, useUrlState, useUrlStates, zhCN };

package/dist/position--p6kJnYA.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+
+//#region src/position.ts
+const actionPositionSchema = z.union([z.enum(["start", "end"]), z.object({
+	anchor: z.string().min(1),
+	side: z.enum(["before", "after"])
+})]);
+function matchesPosition(position, point) {
+	if (typeof position !== "object" || typeof point !== "object") return position === point;
+	return position.anchor === point.anchor && position.side === point.side;
+}
+function compareOrder(left, right) {
+	return (left.order ?? 100) - (right.order ?? 100);
+}
+/** Resolve relative positions after owner ordering and overrides, before removing IDs. */
+function positionActions(items, fills = []) {
+	const anchored = /* @__PURE__ */ new Map();
+	const base = [];
+	for (const item of [
+		...fills.filter((fill) => matchesPosition(fill.position, "start")),
+		...items,
+		...fills.filter((fill) => !matchesPosition(fill.position, "start"))
+	]) {
+		if (item.position !== void 0) actionPositionSchema.parse(item.position);
+		if (typeof item.position !== "object") {
+			base.push(item);
+			continue;
+		}
+		const group = anchored.get(item.position.anchor) ?? [];
+		group.push(item);
+		anchored.set(item.position.anchor, group);
+	}
+	const result = base.flatMap((item) => {
+		const anchor = item.id ?? (item.type === "custom" ? void 0 : item.type);
+		if (!anchor) return [item];
+		const group = anchored.get(anchor) ?? [];
+		anchored.delete(anchor);
+		group.sort(compareOrder);
+		return [
+			...group.filter((action) => matchesPosition(action.position, {
+				anchor,
+				side: "before"
+			})),
+			item,
+			...group.filter((action) => matchesPosition(action.position, {
+				anchor,
+				side: "after"
+			}))
+		];
+	});
+	for (const anchor of anchored.keys()) console.warn(`[Actions] Unavailable anchor "${anchor}"`);
+	return result;
+}
+
+//#endregion
+export { positionActions as i, compareOrder as n, matchesPosition as r, actionPositionSchema as t };

package/dist/position-BlO0bPw6.cjs

@@ -0,0 +1,109 @@
+//#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
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/position.ts
+const actionPositionSchema = zod.z.union([zod.z.enum(["start", "end"]), zod.z.object({
+	anchor: zod.z.string().min(1),
+	side: zod.z.enum(["before", "after"])
+})]);
+function matchesPosition(position, point) {
+	if (typeof position !== "object" || typeof point !== "object") return position === point;
+	return position.anchor === point.anchor && position.side === point.side;
+}
+function compareOrder(left, right) {
+	return (left.order ?? 100) - (right.order ?? 100);
+}
+/** Resolve relative positions after owner ordering and overrides, before removing IDs. */
+function positionActions(items, fills = []) {
+	const anchored = /* @__PURE__ */ new Map();
+	const base = [];
+	for (const item of [
+		...fills.filter((fill) => matchesPosition(fill.position, "start")),
+		...items,
+		...fills.filter((fill) => !matchesPosition(fill.position, "start"))
+	]) {
+		if (item.position !== void 0) actionPositionSchema.parse(item.position);
+		if (typeof item.position !== "object") {
+			base.push(item);
+			continue;
+		}
+		const group = anchored.get(item.position.anchor) ?? [];
+		group.push(item);
+		anchored.set(item.position.anchor, group);
+	}
+	const result = base.flatMap((item) => {
+		const anchor = item.id ?? (item.type === "custom" ? void 0 : item.type);
+		if (!anchor) return [item];
+		const group = anchored.get(anchor) ?? [];
+		anchored.delete(anchor);
+		group.sort(compareOrder);
+		return [
+			...group.filter((action) => matchesPosition(action.position, {
+				anchor,
+				side: "before"
+			})),
+			item,
+			...group.filter((action) => matchesPosition(action.position, {
+				anchor,
+				side: "after"
+			}))
+		];
+	});
+	for (const anchor of anchored.keys()) console.warn(`[Actions] Unavailable anchor "${anchor}"`);
+	return result;
+}
+
+//#endregion
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
+Object.defineProperty(exports, 'actionPositionSchema', {
+  enumerable: true,
+  get: function () {
+    return actionPositionSchema;
+  }
+});
+Object.defineProperty(exports, 'compareOrder', {
+  enumerable: true,
+  get: function () {
+    return compareOrder;
+  }
+});
+Object.defineProperty(exports, 'matchesPosition', {
+  enumerable: true,
+  get: function () {
+    return matchesPosition;
+  }
+});
+Object.defineProperty(exports, 'positionActions', {
+  enumerable: true,
+  get: function () {
+    return positionActions;
+  }
+});

package/dist/position-DoBV7yB6.d.cts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+
+//#region src/position.d.ts
+declare const actionPositionSchema: z.ZodUnion<readonly [z.ZodEnum<{
+  start: "start";
+  end: "end";
+}>, z.ZodObject<{
+  anchor: z.ZodString;
+  side: z.ZodEnum<{
+    before: "before";
+    after: "after";
+  }>;
+}, z.core.$strip>]>;
+type ActionPosition = z.infer<typeof actionPositionSchema>;
+declare function matchesPosition(position?: ActionPosition, point?: ActionPosition): boolean;
+declare function compareOrder(left: {
+  order?: number;
+}, right: {
+  order?: number;
+}): number;
+/** Resolve relative positions after owner ordering and overrides, before removing IDs. */
+declare function positionActions<T extends {
+  id?: string;
+  type: string;
+  order?: number;
+  position?: ActionPosition;
+}>(items: readonly T[], fills?: readonly T[]): T[];
+//#endregion
+export { positionActions as a, matchesPosition as i, actionPositionSchema as n, compareOrder as r, ActionPosition as t };

package/dist/position-mYekVBBH.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+
+//#region src/position.d.ts
+declare const actionPositionSchema: z.ZodUnion<readonly [z.ZodEnum<{
+  start: "start";
+  end: "end";
+}>, z.ZodObject<{
+  anchor: z.ZodString;
+  side: z.ZodEnum<{
+    before: "before";
+    after: "after";
+  }>;
+}, z.core.$strip>]>;
+type ActionPosition = z.infer<typeof actionPositionSchema>;
+declare function matchesPosition(position?: ActionPosition, point?: ActionPosition): boolean;
+declare function compareOrder(left: {
+  order?: number;
+}, right: {
+  order?: number;
+}): number;
+/** Resolve relative positions after owner ordering and overrides, before removing IDs. */
+declare function positionActions<T extends {
+  id?: string;
+  type: string;
+  order?: number;
+  position?: ActionPosition;
+}>(items: readonly T[], fills?: readonly T[]): T[];
+//#endregion
+export { positionActions as a, matchesPosition as i, actionPositionSchema as n, compareOrder as r, ActionPosition as t };

package/dist/position.cjs

@@ -0,0 +1,6 @@
+const require_position = require('./position-BlO0bPw6.cjs');
+
+exports.actionPositionSchema = require_position.actionPositionSchema;
+exports.compareOrder = require_position.compareOrder;
+exports.matchesPosition = require_position.matchesPosition;
+exports.positionActions = require_position.positionActions;

package/dist/position.d.cts

@@ -0,0 +1,2 @@
+import { a as positionActions, i as matchesPosition, n as actionPositionSchema, r as compareOrder, t as ActionPosition } from "./position-DoBV7yB6.cjs";
+export { ActionPosition, actionPositionSchema, compareOrder, matchesPosition, positionActions };

package/dist/position.d.ts

@@ -0,0 +1,2 @@
+import { a as positionActions, i as matchesPosition, n as actionPositionSchema, r as compareOrder, t as ActionPosition } from "./position-mYekVBBH.js";
+export { ActionPosition, actionPositionSchema, compareOrder, matchesPosition, positionActions };

package/dist/position.js

@@ -0,0 +1,3 @@
+import { i as positionActions, n as compareOrder, r as matchesPosition, t as actionPositionSchema } from "./position--p6kJnYA.js";
+
+export { actionPositionSchema, compareOrder, matchesPosition, positionActions };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -20,7 +20,12 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./styles.css": "./dist/styles.css"
+    "./styles.css": "./dist/styles.css",
+    "./position": {
+      "types": "./dist/position.d.ts",
+      "import": "./dist/position.js",
+      "require": "./dist/position.cjs"
+    }
   },
   "files": [
     "dist"
@@ -65,8 +70,8 @@
     "nanoid": "^5.1.6",
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
-    "@wordrhyme/formily-shadcn": "2.1.1",
     "@wordrhyme/shadcn": "2.0.1",
+    "@wordrhyme/formily-shadcn": "2.1.1",
     "@wordrhyme/shadcn-ui": "2.1.1"
   },
   "devDependencies": {
@@ -88,9 +93,9 @@
     "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/prettier-config": "0.0.1",
+    "@internal/eslint-config": "0.3.0",
     "@internal/tsdown-config": "0.1.0",
     "@internal/vitest-config": "0.1.0"
   },