@nokecy/qc-ui-components 2.0.0-beta.0 → 2.0.0-beta.1

package/dist/cjs/array-table/theme.d.ts

@@ -1,10 +1,40 @@
+import type { GridDensity, GridDensityOverrides, GridDensityValues } from '../ag-grid-plus/density';
 /**
- * 行高 38:放得下 32px 高的输入框。网格选项 rowHeight 与主题参数 rowHeight 必须同值——
- * AG-Grid 单元格文字的行高(--ag-internal-content-line-height)是从主题的 --ag-row-height 算的,
- * 只设网格选项会让文字的行盒仍是主题默认行高(29.6-3=26.6px),顶在 37px 的格子上方(偏上约 4.5px)。
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
  */
-export declare const ARRAY_TABLE_ROW_HEIGHT = 38;
+export declare const ARRAY_TABLE_FALLBACK_DENSITY: GridDensity;
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+export declare const ARRAY_TABLE_ROW_HEIGHT: number;
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+export declare function resolveArrayTableMetrics(density?: GridDensity, overrides?: GridDensityOverrides): GridDensityValues;
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+export declare function useArrayTableMetrics(): GridDensityValues;
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+export declare const ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
 /** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
 export declare const ARRAY_TABLE_FEEDBACK_CLASS = "ag-array-table-has-feedback";
-/** 根据当前 antd 主题生成编辑态或阅读态明细表格主题。@author nokecy */
+/**
+ * 单元格里的表单项与内容区垂直居中(只对使用本主题的网格生效,共用主题不受影响):
+ *  - .ag-cell-wrapper 撑满格子,align-items:center 才起作用(默认只有内容高,贴在格子顶部);
+ *    表格里有出错行时(外层带 ARRAY_TABLE_FEEDBACK_CLASS)内容高度不超过标准行高对应的高度:出错行会被撑高(见 rowFeedback.ts),
+ *    内容仍居中在上面那一段,多出来的高度留给输入框下方的错误文字,出错时输入框不会被挤得上下跳;
+ *  - FormItem 默认 margin-bottom:24px(loose 反馈布局给错误文字预留的位置),会把 Editable 外壳撑到 56px、
+ *    输入框偏上、还超出 37px 的格子,归零;
+ *  - AG-Grid 的 .ag-cell-value 默认 overflow:hidden,会把输入框下方的错误文字剪掉,只在格里正显示错误文字时放开;
+ *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+export declare const ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .ag-array-table-has-feedback & .ag-cell .ag-cell-wrapper,\n    &.ag-array-table-has-feedback .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: 20px !important; line-height: 18px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ";
+export declare const arrayTableCellFit: import("ag-grid-community").Part<{}>;
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
 export declare function useArrayTableTheme(editable?: boolean): import("ag-grid-community").Theme<import("ag-grid-community").CoreParams & import("ag-grid-community").ButtonStyleParams & import("ag-grid-community").CheckboxStyleParams & import("ag-grid-community").TabStyleParams & import("ag-grid-community").InputStyleParams & {}>;

package/dist/cjs/array-table/theme.js

@@ -3,10 +3,14 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_FEEDBACK_CLASS = void 0;
+exports.arrayTableCellFit = exports.ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_HELP_LINE_HEIGHT = exports.ARRAY_TABLE_FEEDBACK_CLASS = exports.ARRAY_TABLE_FALLBACK_DENSITY = exports.ARRAY_TABLE_CELL_FIT_CSS = void 0;
+exports.resolveArrayTableMetrics = resolveArrayTableMetrics;
+exports.useArrayTableMetrics = useArrayTableMetrics;
 exports.useArrayTableTheme = useArrayTableTheme;
 var _agGridCommunity = require("ag-grid-community");
 var _react = require("react");
+var _gridContext = require("../ag-grid-plus/context/gridContext");
+var _density = require("../ag-grid-plus/density");
 var _theme = require("../ag-grid-plus/theme");
 /**
  * ArrayTable(明细表格)的 AG-Grid 主题:编辑态(index.tsx)与阅读态(preview.tsx)共用。
@@ -15,11 +19,41 @@ var _theme = require("../ag-grid-plus/theme");
  */
 
 /**
- * 行高 38:放得下 32px 高的输入框。网格选项 rowHeight 与主题参数 rowHeight 必须同值——
- * AG-Grid 单元格文字的行高(--ag-internal-content-line-height)是从主题的 --ag-row-height 算的,
- * 只设网格选项会让文字的行盒仍是主题默认行高(29.6-3=26.6px),顶在 37px 的格子上方(偏上约 4.5px)。
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
  */
-var ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_ROW_HEIGHT = 38;
+var ARRAY_TABLE_FALLBACK_DENSITY = exports.ARRAY_TABLE_FALLBACK_DENSITY = 'compact';
+
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+var ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_ROW_HEIGHT = _density.GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY].rowHeight;
+
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+function resolveArrayTableMetrics(density, overrides) {
+  var _resolveGridDensity;
+  return (_resolveGridDensity = (0, _density.resolveGridDensity)(density, overrides)) !== null && _resolveGridDensity !== void 0 ? _resolveGridDensity : _density.GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY];
+}
+
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+function useArrayTableMetrics() {
+  var _useContext = (0, _react.useContext)(_gridContext.GridPlusContext),
+    density = _useContext.density,
+    densityValues = _useContext.densityValues;
+  return (0, _react.useMemo)(function () {
+    return resolveArrayTableMetrics(density, densityValues);
+  }, [density, densityValues]);
+}
+
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+var ARRAY_TABLE_HELP_LINE_HEIGHT = exports.ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
 
 /** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
 var ARRAY_TABLE_FEEDBACK_CLASS = exports.ARRAY_TABLE_FEEDBACK_CLASS = 'ag-array-table-has-feedback';
@@ -35,19 +69,22 @@ var ARRAY_TABLE_FEEDBACK_CLASS = exports.ARRAY_TABLE_FEEDBACK_CLASS = 'ag-array-
  *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
  *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
  */
-var arrayTableCellFit = (0, _agGridCommunity.createPart)({
+var ARRAY_TABLE_CELL_FIT_CSS = exports.ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .".concat(ARRAY_TABLE_FEEDBACK_CLASS, " & .ag-cell .ag-cell-wrapper,\n    &.").concat(ARRAY_TABLE_FEEDBACK_CLASS, " .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT, "px !important; line-height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT - 2, "px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ");
+var arrayTableCellFit = exports.arrayTableCellFit = (0, _agGridCommunity.createPart)({
   feature: 'arrayTableCellFit',
-  css: "\n    .ag-cell .ag-cell-wrapper { height: 100%; }\n    .".concat(ARRAY_TABLE_FEEDBACK_CLASS, " .ag-cell .ag-cell-wrapper { height: min(100%, ").concat(ARRAY_TABLE_ROW_HEIGHT - 3, "px); }\n    .ag-cell .ant-formily-item { margin-bottom: 0; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    .ag-cell .ant-formily-item-help { position: absolute; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n  ")
+  css: ARRAY_TABLE_CELL_FIT_CSS
 });
 
-/** 根据当前 antd 主题生成编辑态或阅读态明细表格主题。@author nokecy */
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
 function useArrayTableTheme() {
   var editable = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
-  var agGridTheme = (0, _theme.useAgGridTheme)();
+  var metrics = useArrayTableMetrics();
+  // 叠加而非替换：useAgGridTheme 把密度的字号/行高/表头高/水平内边距写进主题，随后只追加本表格的部件。
+  var agGridTheme = (0, _theme.useAgGridTheme)({
+    density: metrics
+  });
   return (0, _react.useMemo)(function () {
-    var previewTheme = agGridTheme.withParams({
-      rowHeight: ARRAY_TABLE_ROW_HEIGHT
-    }).withPart(arrayTableCellFit);
+    var previewTheme = agGridTheme.withPart(arrayTableCellFit);
     return editable ? previewTheme.withParams({
       focusShadow: 'none',
       rangeSelectionBorderColor: 'transparent',

package/dist/cjs/array-table/title.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+export declare const ArrayTableTitle: React.FC<React.PropsWithChildren>;

package/dist/cjs/array-table/title.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ArrayTableTitle = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+var ArrayTableTitle = exports.ArrayTableTitle = function ArrayTableTitle(_ref) {
+  var children = _ref.children;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("span", {
+    style: {
+      display: 'inline-flex',
+      alignItems: 'center',
+      gap: 8,
+      fontWeight: 600
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      style: {
+        width: 3,
+        height: 14,
+        background: 'var(--ind-primary, var(--ant-color-primary))',
+        borderRadius: 1
+      }
+    }), children]
+  });
+};

package/dist/cjs/array-table/utils.d.ts

@@ -38,6 +38,7 @@ declare const LazyAgField: (params: any) => React.JSX.Element;
  * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
  */
 declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
+declare const findDataFieldSchema: (columnSchema: Schema, name: string) => any;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 /**
  * 找到 schema 里的 ArrayTable.Addition 占位节点,返回它的 x-component-props(新增按钮的 title / defaultValue / onAdd 等)。
@@ -51,7 +52,7 @@ declare const useAddition: () => {
     schema: Schema;
     props: Record<string, any>;
 } | null;
-export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };
+export { findDataFieldSchema, isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };
 export type LazyColumnDefault = {
     key: string;
     value: any;

package/dist/cjs/array-table/utils.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.collectLazyDefaults = exports.buildArrayTableColumns = exports.applyLazyDefaults = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
+exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.findDataFieldSchema = exports.collectLazyDefaults = exports.buildArrayTableColumns = exports.applyLazyDefaults = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _antd = require("antd");
 var _formilyReact = require("@nokecy/formily-react");
@@ -15,6 +15,7 @@ var _readOnlyFormatters = require("./readOnlyFormatters");
 var _columnGroup = require("./columnGroup");
 var _fixedGuard = require("./fixedGuard");
 var _cellFocusScope = require("./cellFocusScope");
+var _cellEditorMarker = require("./cellEditorMarker");
 var _sorting = require("./sorting");
 var _indexColumn = require("./indexColumn");
 var _gridSequence = require("../shared/gridSequence");
@@ -178,7 +179,8 @@ var AgField = function AgField(_ref3) {
     dataSource = _ref3.dataSource,
     schema = _ref3.schema,
     field = _ref3.field,
-    node = _ref3.node;
+    node = _ref3.node,
+    editorComponent = _ref3.editorComponent;
   var _resolveCellRow = resolveCellRow(field, record, node, dataSource),
     index = _resolveCellRow.index;
   if (index < 0) return null;
@@ -199,7 +201,10 @@ var AgField = function AgField(_ref3) {
       onlyRenderProperties: true
     })
   });
-  return children;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_cellEditorMarker.CellEditorMarker, {
+    kind: (0, _cellEditorMarker.resolveCellEditorKind)(editorComponent),
+    children: children
+  });
 };
 
 /**
@@ -580,7 +585,8 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
           dataSource: dataSource,
           schema: schema,
           field: field,
-          node: node
+          node: node,
+          editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
         });
       }
       // Editable 装饰器会把非新增行的格转成只读态、不参与校验(见 editable/index.tsx),
@@ -603,7 +609,8 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
             dataSource: dataSource,
             schema: schema,
             field: field,
-            node: node
+            node: node,
+            editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
           })
         });
       }
@@ -618,7 +625,8 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
           dataSource: dataSource,
           schema: schema,
           field: field,
-          node: node
+          node: node,
+          editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
         });
       }
       var ctx = {
@@ -705,7 +713,7 @@ var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(para
 };
 
 // 在 Column 的子 schema 里递归找到内层数据字段(可读 x-component / x-pattern / x-reactions / enum) @author nokecy
-var findDataFieldSchema = function findDataFieldSchema(columnSchema, name) {
+var findDataFieldSchema = exports.findDataFieldSchema = function findDataFieldSchema(columnSchema, name) {
   if (!columnSchema || !columnSchema.properties) return null;
   var matched = null;
   var firstField = null;
@@ -749,6 +757,45 @@ var isColumnReadOnlyEligible = function isColumnReadOnlyEligible(arrayPattern, d
   return false;
 };
 
+/**
+ * 静态解析 x-reactions 依赖里指向「同表其他列」的列名。
+ *
+ * 懒挂载/只读快路径的格子不创建 Formily 字段，而 reaction 的依赖是按字段节点取值的：
+ * 被依赖列没有字段，依赖读到 undefined，金额=数量×单价这类联动初始显示 0。
+ * 所以被依赖列必须创建字段（走 eager）。选「标记 eager」而不是「预建字段/改读 form values」的理由：
+ * 前者沿用 Formily 自己的求值与订阅路径（字段创建后依赖自动重算），不引入第二套取值逻辑；
+ * 代价只是依赖列失去懒挂载优化，而依赖列通常是少数几列。
+ *
+ * 只认能确定指向本表某一列的写法：相对路径 `.qty`（可带 `#value` 之类的属性后缀）、
+ * 带通配的绝对路径 `items.*.price`（前缀必须是本数组字段）。`..xx`、不带通配的绝对路径、
+ * 表达式串等解析不了的一律忽略，保持原有行为。@author nokecy
+ */
+var collectReactionDependencyColumns = function collectReactionDependencyColumns(arrayField, reactions) {
+  var _arrayField$path, _arrayField$path$toSt, _arrayField$address, _arrayField$address$t;
+  var names = [];
+  var arrayPaths = [arrayField === null || arrayField === void 0 || (_arrayField$path = arrayField.path) === null || _arrayField$path === void 0 || (_arrayField$path$toSt = _arrayField$path.toString) === null || _arrayField$path$toSt === void 0 ? void 0 : _arrayField$path$toSt.call(_arrayField$path), arrayField === null || arrayField === void 0 || (_arrayField$address = arrayField.address) === null || _arrayField$address === void 0 || (_arrayField$address$t = _arrayField$address.toString) === null || _arrayField$address$t === void 0 ? void 0 : _arrayField$address$t.call(_arrayField$address)].filter(Boolean);
+  var take = function take(dep) {
+    var source = typeof dep === 'string' ? dep : dep && _typeof(dep) === 'object' && typeof dep.source === 'string' ? dep.source : null;
+    if (!source || source.includes('{{')) return;
+    var path = source.split('#')[0].trim();
+    if (path.startsWith('..')) return;
+    if (path.startsWith('.')) {
+      var name = path.slice(1);
+      if (name && !name.includes('*') && isFastPathFieldName(name)) names.push(name);
+      return;
+    }
+    var matched = /^(.+)\.\*\.([^.*]+)$/.exec(path);
+    if (matched && arrayPaths.includes(matched[1])) names.push(matched[2]);
+  };
+  var visit = function visit(reaction) {
+    if (!reaction || _typeof(reaction) !== 'object') return;
+    var deps = reaction.dependencies;
+    if (Array.isArray(deps)) deps.forEach(take);else if (deps && _typeof(deps) === 'object') Object.values(deps).forEach(take);
+  };
+  (Array.isArray(reactions) ? reactions : [reactions]).forEach(visit);
+  return names;
+};
+
 /** 明细单元格里的数字输入组件(antd InputNumber 及其 Formily 封装) */
 var NUMBER_INPUT_COMPONENTS = new Set(['NumberPicker', 'InputNumber']);
 
@@ -773,13 +820,27 @@ var applyNumberInputDefaults = function applyNumberInputDefaults(dataField) {
 // 重命名自 useArrayTableColumns:内部无任何 Hook 调用,use 前缀违反 Hook 命名约定且曾在 useMemo 内被调用 @author nokecy
 var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArrayTableColumns(dataSource, field, sources) {
   var arrayPattern = field === null || field === void 0 ? void 0 : field.pattern;
-  return sources.reduce(function (buf, _ref7, key) {
-    var _dataField$xDecorato, _ref8, _getReadOnlyFormatter, _dataField$xComponen, _parseObjectDestructu, _dataField$xComponen2, _dataField$xComponen3, _dataField$xComponen4, _dataField$xComponen5;
+  // 被其他列 x-reactions 依赖的列：必须创建字段，见 collectReactionDependencyColumns。
+  var reactionDependencyColumns = new Set();
+  sources.forEach(function (_ref7) {
+    var _findDataFieldSchema;
     var name = _ref7.name,
-      columnProps = _ref7.columnProps,
       schema = _ref7.schema,
-      display = _ref7.display,
-      components = _ref7.components;
+      display = _ref7.display;
+    if (display && display !== 'visible') return;
+    if (!isColumnComponent(schema)) return;
+    var reactions = (_findDataFieldSchema = findDataFieldSchema(schema, name)) === null || _findDataFieldSchema === void 0 ? void 0 : _findDataFieldSchema['x-reactions'];
+    if (reactions) collectReactionDependencyColumns(field, reactions).forEach(function (dep) {
+      return reactionDependencyColumns.add(dep);
+    });
+  });
+  return sources.reduce(function (buf, _ref8, key) {
+    var _dataField$xDecorato, _ref9, _getReadOnlyFormatter, _dataField$xComponen, _parseObjectDestructu, _dataField$xComponen2, _dataField$xComponen3, _dataField$xComponen4, _dataField$xComponen5;
+    var name = _ref8.name,
+      columnProps = _ref8.columnProps,
+      schema = _ref8.schema,
+      display = _ref8.display,
+      components = _ref8.components;
     if (display && display !== 'visible') return buf;
     if (!isColumnComponent(schema)) return buf;
 
@@ -851,9 +912,9 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     // 仅把标量码交给 fallback 会跳过这些逻辑。解构值自带名称、显式编码展示及已登记格式化器仍走快路径。
     // 登记渲染器的组件只读列也可用兜底格式化器判空。@author nokecy
     var renderer = (0, _readOnlyFormatters.getReadOnlyRenderer)(component);
-    var formatter = (_ref8 = (_getReadOnlyFormatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component, components)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : (dataField === null || dataField === void 0 || (_dataField$xComponen = dataField['x-component-props']) === null || _dataField$xComponen === void 0 ? void 0 : _dataField$xComponen.displayField) === 'value' ? _readOnlyFormatters.fallbackFormatter : null) !== null && _ref8 !== void 0 ? _ref8 : (!readOnly || renderer) && (renderer || (_parseObjectDestructu = parseObjectDestructure(dataField === null || dataField === void 0 ? void 0 : dataField.name)) !== null && _parseObjectDestructu !== void 0 && _parseObjectDestructu.some(function (_ref9) {
-      var _ref10 = _slicedToArray(_ref9, 1),
-        key = _ref10[0];
+    var formatter = (_ref9 = (_getReadOnlyFormatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component, components)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : (dataField === null || dataField === void 0 || (_dataField$xComponen = dataField['x-component-props']) === null || _dataField$xComponen === void 0 ? void 0 : _dataField$xComponen.displayField) === 'value' ? _readOnlyFormatters.fallbackFormatter : null) !== null && _ref9 !== void 0 ? _ref9 : (!readOnly || renderer) && (renderer || (_parseObjectDestructu = parseObjectDestructure(dataField === null || dataField === void 0 ? void 0 : dataField.name)) !== null && _parseObjectDestructu !== void 0 && _parseObjectDestructu.some(function (_ref10) {
+      var _ref11 = _slicedToArray(_ref10, 1),
+        key = _ref11[0];
       return key === 'label';
     })) && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? _readOnlyFormatters.fallbackFormatter : null;
     var displayColumnProps = formatter && ((0, _readOnlyFormatters.getReadOnlyFormatter)(component, components) !== (0, _readOnlyFormatters.getReadOnlyFormatter)(component) || (dataField === null || dataField === void 0 || (_dataField$xComponen2 = dataField['x-component-props']) === null || _dataField$xComponen2 === void 0 ? void 0 : _dataField$xComponen2.displayField) === 'value') ? {
@@ -873,7 +934,16 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     // 可编辑格由 LazyAgField 按当前 scope 编译格式化表达式；静态只读路径仍交给真实字段。@author nokecy
     var schemaFormatter = dataField === null || dataField === void 0 || (_dataField$xComponen5 = dataField['x-component-props']) === null || _dataField$xComponen5 === void 0 ? void 0 : _dataField$xComponen5.formatter;
     var hasFormatterExpression = typeof schemaFormatter === 'string' && schemaFormatter.includes('{{');
-    var forceEager = (columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true || formatter === (0, _readOnlyFormatters.getReadOnlyFormatter)('Select') && hasOptionExpression || readOnly && hasFormatterExpression;
+    var isReactionDependency = reactionDependencyColumns.has(name) || !!(dataField !== null && dataField !== void 0 && dataField.name) && reactionDependencyColumns.has(dataField.name);
+    var forceEager = (columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true || isReactionDependency || formatter === (0, _readOnlyFormatters.getReadOnlyFormatter)('Select') && hasOptionExpression || readOnly && hasFormatterExpression;
+    // 平时就是真控件的格（必填/带校验规则、带联动、强制 eager）缺省不带 placeholder 时整格空白，与懒挂载格的「请输入/请选择」不一致；
+    // 补上同一句。只补单值的 antd 输入类组件（范围选择的 placeholder 是数组，不碰）。@author nokecy
+    var editorProps = dataField === null || dataField === void 0 ? void 0 : dataField['x-component-props'];
+    if (!readOnly && dataField && (isRequiredSchema(dataField) || hasValidatorRule(dataField) || hasReactions || forceEager) && (0, _cellEditorMarker.resolveCellEditorKind)(dataField['x-component']) && !String(dataField['x-component']).includes('RangePicker') && (editorProps == null || _typeof(editorProps) === 'object' && editorProps.placeholder == null)) {
+      dataField['x-component-props'] = _objectSpread(_objectSpread({}, editorProps !== null && editorProps !== void 0 ? editorProps : {}), {}, {
+        placeholder: resolveEmptyPlaceholder(dataField)
+      });
+    }
     // Switch/Checkbox 是「单击直控」组件:可编辑态本就该常驻渲染真控件(优化前即如此)。
     // 懒挂载会把它降成「是/否」纯文本(点击才挂出开关),用户会以为开关消失。故可编辑态强制 eager。
     // 只读态(下方 ① 路径)仍走「是/否」文本快路径不受影响。@author nokecy
@@ -978,7 +1048,8 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
       cellRendererParams: {
         dataSource: dataSource,
         schema: schema,
-        field: field
+        field: field,
+        editorComponent: component
       },
       cellRenderer: AgField
     }));
@@ -1027,9 +1098,9 @@ var collectLazyDefaults = exports.collectLazyDefaults = function collectLazyDefa
       key: String((_fieldSchema$name3 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name3 !== void 0 ? _fieldSchema$name3 : col.field),
       value: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.default
     };
-  }).filter(function (_ref11) {
-    var key = _ref11.key,
-      value = _ref11.value;
+  }).filter(function (_ref12) {
+    var key = _ref12.key,
+      value = _ref12.value;
     return SIMPLE_FIELD_NAME.test(key) && value !== undefined && value !== null && !(typeof value === 'string' && value.includes('{{'));
   });
 };
@@ -1048,9 +1119,9 @@ var applyLazyDefaults = exports.applyLazyDefaults = function applyLazyDefaults(a
     // 已落库的行（带 id）保持库里的样子：补默认值会让受控字段凭空出现「变更」，
     // 已审批的数据保存时还会被要求填变更原因。只补新增行（按钮之外的途径推进来的行）。
     if (row.id != null || row._id != null) return;
-    defaults.forEach(function (_ref12) {
-      var key = _ref12.key,
-        value = _ref12.value;
+    defaults.forEach(function (_ref13) {
+      var key = _ref13.key,
+        value = _ref13.value;
       if (row[key] == null) {
         form.setValuesIn(arrayField.path.concat(index).concat(key), _typeof(value) === 'object' ? JSON.parse(JSON.stringify(value)) : value);
       }

package/dist/cjs/card/pro-card/Card/useLegacyItems.d.ts

@@ -18,8 +18,8 @@ export declare function useLegacyItems(items?: TabsProps['items'], children?: Re
     className?: string | undefined;
     id?: string | undefined;
     disabled?: boolean | undefined;
-    prefixCls?: string | undefined;
     icon?: React.ReactNode;
+    prefixCls?: string | undefined;
     active?: boolean | undefined;
     closable?: boolean | undefined;
     closeIcon?: React.ReactNode;

package/dist/cjs/dateCellEditor/DateCellEditor.d.ts

@@ -14,6 +14,11 @@ export interface DateCellEditorParams {
     disabledDate?: (current: Dayjs) => boolean;
     /** 是否允许清空；为 `true` 时清空并提交 `null`，默认 `false`。 */
     allowClear?: boolean;
+    /**
+     * 进入编辑时是否自动展开日期面板，默认 `true`：键盘到达即展开，保持原有行为。
+     * 只想聚焦输入、直接键入覆盖时传 `false`。
+     */
+    defaultOpen?: boolean;
 }
 /**
  * 日期单元格编辑器的完整属性：AG Grid 编辑器属性与 {@link DateCellEditorParams} 的合并。

package/dist/cjs/dateCellEditor/DateCellEditor.js

@@ -78,13 +78,35 @@ var DateCellEditor = exports.DateCellEditor = function DateCellEditor(_ref) {
     format = _ref$format === void 0 ? DEFAULT_DATE_CELL_FORMAT : _ref$format,
     disabledDate = _ref.disabledDate,
     _ref$allowClear = _ref.allowClear,
-    allowClear = _ref$allowClear === void 0 ? false : _ref$allowClear;
+    allowClear = _ref$allowClear === void 0 ? false : _ref$allowClear,
+    _ref$defaultOpen = _ref.defaultOpen,
+    defaultOpen = _ref$defaultOpen === void 0 ? true : _ref$defaultOpen;
+  var pickerRef = _react.default.useRef(null);
+  // 打开时全选：光标留在末尾的话，键入会追加成 `2026-11-012026-11-25`。
+  _react.default.useEffect(function () {
+    var _pickerRef$current, _pickerRef$current$qu;
+    var input = (_pickerRef$current = pickerRef.current) === null || _pickerRef$current === void 0 || (_pickerRef$current = _pickerRef$current.nativeElement) === null || _pickerRef$current === void 0 || (_pickerRef$current$qu = _pickerRef$current.querySelector) === null || _pickerRef$current$qu === void 0 ? void 0 : _pickerRef$current$qu.call(_pickerRef$current, 'input');
+    input === null || input === void 0 || input.select();
+  }, []);
   var current = parseDateCellValue(value, format);
   // 不同 antd 版本点击清空图标时 onChange 可能连续触发，提交只认第一次。
   var committed = _react.default.useRef(false);
+  /** 提交：写入值后下一拍 stopEditing，保证表格取到新值；只认第一次。 */
+  var commit = function commit(next) {
+    if (committed.current) return;
+    committed.current = true;
+    onValueChange(next);
+    setTimeout(function () {
+      return stopEditing();
+    }, 0);
+  };
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.DatePicker, {
-    autoFocus: true,
-    defaultOpen: true,
+    ref: pickerRef,
+    autoFocus: true
+    // 单元格编辑态已有一层框，选择器自己不再画第二层。
+    ,
+    variant: "borderless",
+    defaultOpen: defaultOpen,
     allowClear: allowClear,
     value: current,
     format: format,
@@ -97,22 +119,25 @@ var DateCellEditor = exports.DateCellEditor = function DateCellEditor(_ref) {
       return (_trigger$parentElemen = trigger.parentElement) !== null && _trigger$parentElemen !== void 0 ? _trigger$parentElemen : document.body;
     },
     onChange: function onChange(date) {
-      if (committed.current) return;
-      if (!date) {
-        // antd 仅在点击清空图标时回调 null；未允许清空时忽略。
-        if (!allowClear) return;
-        onValueChange(null);
-      } else {
-        onValueChange(date.format(format));
-      }
-      committed.current = true;
-      // 先让值写入编辑器，再提交，保证表格取到新日期。
-      setTimeout(function () {
-        return stopEditing();
-      }, 0);
+      // antd 仅在点击清空图标时回调 null；未允许清空时忽略。
+      if (!date && !allowClear) return;
+      commit(date ? date.format(format) : null);
     },
     onKeyDown: function onKeyDown(event) {
-      if (event.key === 'Escape') stopEditing(true);
+      var _value;
+      if (event.key === 'Escape') {
+        stopEditing(true);
+        return;
+      }
+      if (event.key !== 'Enter' && event.key !== 'Tab') return;
+      // 键入完整日期后 Enter/Tab 以键入值提交：antd 的 onChange 只在面板选中/失焦校验时触发，这里直接读输入框。
+      var text = (_value = event.target.value) === null || _value === void 0 ? void 0 : _value.trim();
+      if (!text) return;
+      var typed = (0, _dayjs.default)(text, format, true);
+      if (!typed.isValid() || disabledDate !== null && disabledDate !== void 0 && disabledDate(typed)) return;
+      // 与当前值相同时没有新键入，交给面板/表格原有流程。
+      if (current && current.format(format) === text) return;
+      commit(typed.format(format));
     }
   });
 };

package/dist/cjs/deleteConfirm/index.d.ts

@@ -23,9 +23,23 @@ export interface DeleteConfirmProps {
      * @author nokecy
      */
     danger?: boolean;
+    /**
+     * 三级「输入确认」（DESIGN.md §9.2）：传入对象名称或数量，用户原样键入后确认按钮才可点。
+     * 用于影响面大且不可恢复的操作（清空草稿箱、删除主数据、批量作废超过 50 张）。不传则为二级确认。
+     */
+    confirmText?: string;
+    /**
+     * 确认框默认焦点，默认 `'cancel'`：Enter 不会直接触发危险操作（§9.2）。
+     * 传 `'ok'` 或 `null` 可恢复 antd 的旧行为。
+     */
+    autoFocusButton?: 'ok' | 'cancel' | null;
+    /** 确认框宽度，默认 560（弹层宽度三档之一，§9.0）。 */
+    width?: number | string;
     /** 子组件（触发按钮） */
     children: React.ReactNode;
 }
+/** 确认框默认宽度，对应规范「确认、单字段编辑 Modal 560」。 */
+export declare const CONFIRM_DIALOG_WIDTH = 560;
 /**
  * DeleteConfirm 删除确认组件
  *