@wordrhyme/auto-crud 1.10.0 → 1.11.0

package/README.md

@@ -265,7 +265,10 @@ interface AutoCrudTableProps<TSchema> {
     hidden?: string[]; // 隐藏的列
     overrides?: Record<string, any>; // 列覆盖配置
     getRowId?: (record: z.output<TSchema>) => string; // 稳定行标识；展开时必填
-    expandedRow?: (record: z.output<TSchema>) => React.ReactNode; // 展开行内容
+    expandedRow?: (
+      record: z.output<TSchema>,
+      row: Row<z.output<TSchema>>,
+    ) => React.ReactNode; // 展开行内容，row 提供已解析的单元格上下文
     filterModes?: FilterMode | FilterMode[]; // 过滤模式
     batchFields?: (string | BatchUpdateField)[]; // 批量更新字段
     /** @deprecated 新代码请使用 actions.batch */
@@ -298,8 +301,9 @@ interface AutoCrudTableProps<TSchema> {
 
 #### 展开行详情
 
-配置 `table.expandedRow` 后，表格自动添加展开箭头。默认全部收起，允许同时展开多行。
+配置 `table.expandedRow` 后，表格自动添加展开箭头。默认全部收起，允许同时展开多行。设置 `table.defaultExpanded: true` 可在首次展示时展开全部行；刷新保留用户的展开选择。该选项仅用于初始化，不控制当前展开状态。
 必须提供 TanStack Table 的 `getRowId`，使用稳定且唯一的业务主键，避免分页、排序后展开错位。
+展开内容可使用 `cqw` 单位，以表格可视区域的宽度为基准，避免宽表中的详情被横向裁切。
 
 ```tsx
 <AutoCrudTable
@@ -317,9 +321,11 @@ interface AutoCrudTableProps<TSchema> {
 明细数据及其字段权限由业务组件和现有服务负责。
 
 详情区域跨全部可见列，不计入分页条数，也不参与主表选择或导出。
-数据更新时，展开状态遵循 TanStack Table 默认重置行为。
+未启用 `defaultExpanded` 时，数据更新后的展开状态遵循 TanStack Table 默认重置行为。
 `AutoTable` 同样支持 `getRowId` 和 `expandedRow`；直接使用 `DataTable` 时，需自行配置 TanStack 展开能力及触发按钮。
 
+`expandedRow` 的第二个参数是当前 TanStack `Row`，可通过 `row.getAllCells()` 读取已解析的列和单元格上下文，复用字段渲染器及数据源标签。只接收订单数据的单参数回调仍可使用。
+
 ### `useAutoCrudResource()`
 
 连接数据源到组件的 Hook。

package/dist/index.cjs

@@ -581,6 +581,7 @@ function DataTable({ table, actionBar, pagination, expandedRow, children, classN
 			children,
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "overflow-hidden rounded-md border",
+				style: expandedRow ? { containerType: "inline-size" } : void 0,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(__wordrhyme_shadcn.Table, {
 					className: classNames?.table,
 					style: hasWidthCap ? {
@@ -622,7 +623,7 @@ function DataTable({ table, actionBar, pagination, expandedRow, children, classN
 								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__wordrhyme_shadcn.TableCell, {
 									colSpan: row.getVisibleCells().length,
 									className: classNames?.td,
-									children: expandedRow(row.original)
+									children: expandedRow(row.original, row)
 								})
 							})] }, row.id)) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__wordrhyme_shadcn.TableRow, {
 								className: classNames?.tr,
@@ -4429,7 +4430,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, getRowId, expandedRow, 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 }) {
+function AutoTable({ schema, data, getRowId, expandedRow, defaultExpanded = false, 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 }) {
 	if (expandedRow && !getRowId) throw new Error("AutoTable requires getRowId when expandedRow is provided.");
 	const enableExpansion = !!expandedRow;
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
@@ -4505,6 +4506,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 	]);
 	const stableInitialState = (0, react.useMemo)(() => ({
 		sorting: initialSorting,
+		expanded: enableExpansion && defaultExpanded ? true : {},
 		columnPinning: pinnedColumns ?? {
 			left: [...enableExpansion ? [expandColumnId] : [], ...enableRowSelection ? ["select"] : []],
 			right: actions ? ["actions"] : []
@@ -4514,6 +4516,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 		pinnedColumns,
 		enableRowSelection,
 		enableExpansion,
+		defaultExpanded,
 		expandColumnId,
 		actions
 	]);
@@ -4524,6 +4527,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 		getRowId,
 		getRowCanExpand: () => enableExpansion,
 		getExpandedRowModel: enableExpansion ? expandedRowModel : void 0,
+		autoResetExpanded: defaultExpanded ? false : void 0,
 		pageCount,
 		...total !== void 0 ? { rowCount: total } : {},
 		enableAdvancedFilter,
@@ -7861,6 +7865,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 				...resource.tableData.total !== void 0 ? { total: resource.tableData.total } : {},
 				getRowId: tableConfig?.getRowId,
 				expandedRow: tableConfig?.expandedRow,
+				defaultExpanded: tableConfig?.defaultExpanded,
 				overrides: tableOverrides,
 				classNames: tableConfig?.classNames,
 				exclude: hiddenColumns.filter((key) => !filterOnly.includes(key)),

package/dist/index.d.cts

@@ -658,8 +658,8 @@ interface DataTableProps<TData> extends ComponentProps<'div'> {
   pagination?: TablePaginationOptions;
   classNames?: DataTableClassNames;
   actionBar?: ReactNode;
-  /** Content mounted below an expanded row. */
-  expandedRow?: (record: TData) => ReactNode;
+  /** Content mounted below an expanded row; row provides resolved cell contexts. */
+  expandedRow?: (record: TData, row: Row<TData>) => ReactNode;
 }
 declare function DataTable<TData>({
   table,
@@ -873,6 +873,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<Data
   data: z.infer<T>[];
   /** Stable row identity; required when expandedRow is provided. */
   getRowId?: TableOptions<z.infer<T>>['getRowId'];
+  /** Initially expand all rows. Defaults to false; only applies with expandedRow. */
+  defaultExpanded?: boolean;
   pageCount?: number;
   pagination?: TablePaginationOptions;
   /** Total rows matching the current search and filters. */
@@ -930,6 +932,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   data,
   getRowId,
   expandedRow,
+  defaultExpanded,
   pageCount,
   pagination,
   total,
@@ -1426,7 +1429,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     batchActions?: BatchActionConfig<z.output<TSchema>>;
     /** 默认排序 */
     defaultSort?: any[];
-  } & Pick<AutoTableProps<TSchema>, 'getRowId' | 'expandedRow'>;
+  } & Pick<AutoTableProps<TSchema>, 'getRowId' | 'expandedRow' | 'defaultExpanded'>;
   /** 表单配置 */
   form?: {
     /** 表单覆盖配置（兼容旧 API，优先级低于 fieldOverrides） */

package/dist/index.d.ts

@@ -658,8 +658,8 @@ interface DataTableProps<TData> extends ComponentProps<'div'> {
   pagination?: TablePaginationOptions;
   classNames?: DataTableClassNames;
   actionBar?: ReactNode;
-  /** Content mounted below an expanded row. */
-  expandedRow?: (record: TData) => ReactNode;
+  /** Content mounted below an expanded row; row provides resolved cell contexts. */
+  expandedRow?: (record: TData, row: Row<TData>) => ReactNode;
 }
 declare function DataTable<TData>({
   table,
@@ -873,6 +873,8 @@ interface AutoTableProps<T extends z.ZodObject<z.ZodRawShape>> extends Pick<Data
   data: z.infer<T>[];
   /** Stable row identity; required when expandedRow is provided. */
   getRowId?: TableOptions<z.infer<T>>['getRowId'];
+  /** Initially expand all rows. Defaults to false; only applies with expandedRow. */
+  defaultExpanded?: boolean;
   pageCount?: number;
   pagination?: TablePaginationOptions;
   /** Total rows matching the current search and filters. */
@@ -930,6 +932,7 @@ declare function AutoTable<T extends z.ZodObject<z.ZodRawShape>>({
   data,
   getRowId,
   expandedRow,
+  defaultExpanded,
   pageCount,
   pagination,
   total,
@@ -1426,7 +1429,7 @@ interface AutoCrudTableProps<TSchema extends z.ZodObject<z.ZodRawShape>> {
     batchActions?: BatchActionConfig<z.output<TSchema>>;
     /** 默认排序 */
     defaultSort?: any[];
-  } & Pick<AutoTableProps<TSchema>, 'getRowId' | 'expandedRow'>;
+  } & Pick<AutoTableProps<TSchema>, 'getRowId' | 'expandedRow' | 'defaultExpanded'>;
   /** 表单配置 */
   form?: {
     /** 表单覆盖配置（兼容旧 API，优先级低于 fieldOverrides） */

package/dist/index.js

@@ -566,6 +566,7 @@ function DataTable({ table, actionBar, pagination, expandedRow, children, classN
 			children,
 			/* @__PURE__ */ jsx("div", {
 				className: "overflow-hidden rounded-md border",
+				style: expandedRow ? { containerType: "inline-size" } : void 0,
 				children: /* @__PURE__ */ jsxs(Table$1, {
 					className: classNames?.table,
 					style: hasWidthCap ? {
@@ -607,7 +608,7 @@ function DataTable({ table, actionBar, pagination, expandedRow, children, classN
 								children: /* @__PURE__ */ jsx(TableCell, {
 									colSpan: row.getVisibleCells().length,
 									className: classNames?.td,
-									children: expandedRow(row.original)
+									children: expandedRow(row.original, row)
 								})
 							})] }, row.id)) : /* @__PURE__ */ jsx(TableRow, {
 								className: classNames?.tr,
@@ -4414,7 +4415,7 @@ const filterModeConfig = {
 		tooltip: "Linear-style command filters"
 	}
 };
-function AutoTable({ schema, data, getRowId, expandedRow, 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 }) {
+function AutoTable({ schema, data, getRowId, expandedRow, defaultExpanded = false, 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 }) {
 	if (expandedRow && !getRowId) throw new Error("AutoTable requires getRowId when expandedRow is provided.");
 	const enableExpansion = !!expandedRow;
 	const modes = filterMode ? Array.isArray(filterMode) ? filterMode : [filterMode] : DEFAULT_MODES;
@@ -4490,6 +4491,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 	]);
 	const stableInitialState = useMemo(() => ({
 		sorting: initialSorting,
+		expanded: enableExpansion && defaultExpanded ? true : {},
 		columnPinning: pinnedColumns ?? {
 			left: [...enableExpansion ? [expandColumnId] : [], ...enableRowSelection ? ["select"] : []],
 			right: actions ? ["actions"] : []
@@ -4499,6 +4501,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 		pinnedColumns,
 		enableRowSelection,
 		enableExpansion,
+		defaultExpanded,
 		expandColumnId,
 		actions
 	]);
@@ -4509,6 +4512,7 @@ function AutoTable({ schema, data, getRowId, expandedRow, pageCount = 1, paginat
 		getRowId,
 		getRowCanExpand: () => enableExpansion,
 		getExpandedRowModel: enableExpansion ? expandedRowModel : void 0,
+		autoResetExpanded: defaultExpanded ? false : void 0,
 		pageCount,
 		...total !== void 0 ? { rowCount: total } : {},
 		enableAdvancedFilter,
@@ -7846,6 +7850,7 @@ function AutoCrudTable({ id, title, description, schema, resource, fields, table
 				...resource.tableData.total !== void 0 ? { total: resource.tableData.total } : {},
 				getRowId: tableConfig?.getRowId,
 				expandedRow: tableConfig?.expandedRow,
+				defaultExpanded: tableConfig?.defaultExpanded,
 				overrides: tableOverrides,
 				classNames: tableConfig?.classNames,
 				exclude: hiddenColumns.filter((key) => !filterOnly.includes(key)),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wordrhyme/auto-crud",
   "type": "module",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Schema-first CRUD components with auto-generated tables and forms",
   "author": "wordrhyme",
   "license": "MIT",
@@ -71,8 +71,8 @@
     "tailwind-merge": "^3.5.0",
     "vaul": "^1.1.2",
     "@wordrhyme/formily-shadcn": "2.1.1",
-    "@wordrhyme/shadcn-ui": "2.1.1",
-    "@wordrhyme/shadcn": "2.0.1"
+    "@wordrhyme/shadcn": "2.0.1",
+    "@wordrhyme/shadcn-ui": "2.1.1"
   },
   "devDependencies": {
     "@storybook/react": "^8.6.18",
@@ -94,10 +94,10 @@
     "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/vitest-config": "0.1.0",
     "@internal/tsdown-config": "0.1.0",
-    "@internal/tsconfig": "0.1.0"
+    "@internal/prettier-config": "0.0.1"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {