@taocompany/magic-grid 0.7.6 → 0.7.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/README.md +10 -5
  2. package/dist/components/MagicGrid/MagicGrid.vue.d.ts +2 -2
  3. package/dist/core/api/gridApi.d.ts +51 -1
  4. package/dist/core/api/gridApi.d.ts.map +1 -1
  5. package/dist/core/event/projectGridEvent.d.ts.map +1 -1
  6. package/dist/core/grid/grid.d.ts +6 -0
  7. package/dist/core/grid/grid.d.ts.map +1 -1
  8. package/dist/core/row/getRowType.d.ts +9 -0
  9. package/dist/core/row/getRowType.d.ts.map +1 -0
  10. package/dist/core/row/getSiblingRowsByRowId.d.ts +33 -0
  11. package/dist/core/row/getSiblingRowsByRowId.d.ts.map +1 -0
  12. package/dist/core/row/resolveDisplayRowById.d.ts +9 -0
  13. package/dist/core/row/resolveDisplayRowById.d.ts.map +1 -0
  14. package/dist/core/types/events.d.ts +14 -8
  15. package/dist/core/types/events.d.ts.map +1 -1
  16. package/dist/core/types/index.d.ts +4 -2
  17. package/dist/core/types/index.d.ts.map +1 -1
  18. package/dist/core/types/selectedRowSnapshot.d.ts +41 -22
  19. package/dist/core/types/selectedRowSnapshot.d.ts.map +1 -1
  20. package/dist/getRowDragCommitHierarchy-Bdhm-T66.cjs +2 -0
  21. package/dist/getRowDragCommitHierarchy-Bdhm-T66.cjs.map +1 -0
  22. package/dist/{getRowDragCommitHierarchy-VyTB8COC.js → getRowDragCommitHierarchy-Bty3JIsM.js} +39 -34
  23. package/dist/getRowDragCommitHierarchy-Bty3JIsM.js.map +1 -0
  24. package/dist/index.cjs.js +4 -4
  25. package/dist/index.cjs.js.map +1 -1
  26. package/dist/index.d.ts +4 -2
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.es.js +3662 -3593
  29. package/dist/index.es.js.map +1 -1
  30. package/dist/types/core.cjs.js +1 -1
  31. package/dist/types/core.d.ts +137 -31
  32. package/dist/types/core.d.ts.map +1 -1
  33. package/dist/types/core.es.js +2 -2
  34. package/package.json +1 -1
  35. package/dist/getRowDragCommitHierarchy-Fzdob1zj.cjs +0 -2
  36. package/dist/getRowDragCommitHierarchy-Fzdob1zj.cjs.map +0 -1
  37. package/dist/getRowDragCommitHierarchy-VyTB8COC.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"selectedRowSnapshot.d.ts","sourceRoot":"","sources":["../../../src/core/types/selectedRowSnapshot.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;AAErD,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,0DAA0D;AAC1D,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAA;AAE1D,uBAAuB;AACvB,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAEpD,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB,CAAC,KAAK,GAAG,OAAO;IAClD,uBAAuB;IACvB,KAAK,EAAE,aAAa,CAAA;IACpB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,oBAAoB,GACxB,mBAAmB,EAAE,CAoBvB;AAwDD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,EAC1D,OAAO,GAAE,cAAmB,GAC3B,KAAK,EAAE,CAIT;AAED,yCAAyC;AACzC,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,oBAAoB,EACzB,OAAO,GAAE,cAAmB,GAC3B,mBAAmB,EAAE,CAKvB"}
1
+ {"version":3,"file":"selectedRowSnapshot.d.ts","sourceRoot":"","sources":["../../../src/core/types/selectedRowSnapshot.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED,8CAA8C;AAC9C,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAA;AAE1D,sFAAsF;AACtF,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAA;AAEzD;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,GAAG,OAAO;IAClD,uBAAuB;IACvB,KAAK,EAAE,aAAa,CAAA;IACpB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,qCAAqC;AACrC,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,oBAAoB,GACxB,mBAAmB,EAAE,CAoBvB;AAiED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,KAAK,CAE7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,EAC1D,OAAO,GAAE,cAAmB,GAC3B,KAAK,EAAE,CAGT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,EAC1D,OAAO,GAAE,cAAmB,GAC3B,KAAK,EAAE,CAET;AAED,yCAAyC;AACzC,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,GAAG,EAAE,oBAAoB,EACzB,OAAO,GAAE,cAAmB,GAC3B,mBAAmB,EAAE,CAKvB"}
@@ -0,0 +1,2 @@
1
+ var e=`__index__`;function t(e){return Math.max(40,e??40)}function n(e={}){return{label:e.label??``,width:t(e.width),start:e.start??1,focusMode:e.focusMode===`single`?`single`:`multiple`,syncToSelectionColumn:e.syncToSelectionColumn??!1,showRowDragHandle:e.showRowDragHandle??!1,enableRowResizer:e.enableRowResizer??!1,headerAlign:e.headerAlign??`center`,headerValign:e.headerValign??`center`,align:e.align??`center`,valign:e.valign??`center`,footerAlign:e.footerAlign??`center`,footerValign:e.footerValign??`center`,index:e.index}}function r(e={}){return{showIndexColumn:e.showIndexColumn??!1,indexColumn:n(e.indexColumn)}}function i(t){return t===e}function a(e,t){return e.key??e.prop??`col_${t}`}function o(e){}function s(e){return e===!1?{mode:!1,groupSelectsChildren:!0}:e==null?{mode:`single`,groupSelectsChildren:!0}:typeof e==`string`?{mode:e===`multiple`?`multiple`:`single`,groupSelectsChildren:!0}:{mode:e.mode===`multiple`?`multiple`:`single`,groupSelectsChildren:e.groupSelectsChildren??!0}}var c=`__select__`;function l(e){return Math.max(40,e??40)}function u(e={}){return{width:l(e.width),selectAllLabel:e.selectAllLabel??`全选`,rowLabel:e.rowLabel,headerAlign:e.headerAlign??`center`,headerValign:e.headerValign??`center`,align:e.align??`center`,valign:e.valign??`center`,footerAlign:e.footerAlign??`center`,footerValign:e.footerValign??`center`}}function d(e={}){if(e.rowSelection==null)return{enabled:!1,mode:`single`,selectionColumn:u(e.selectionColumn)};let t=s(e.rowSelection),n=t.mode!==!1;return{enabled:n,mode:n&&t.mode!==!1?t.mode:`single`,selectionColumn:u(e.selectionColumn)}}function f(e){return e===c}function p(e){}var m=`__MG_TMP__::`,h=0;function g(){return h+=1,`${Date.now().toString(36)}_${h.toString(36)}`}function _(){return`${m}${typeof crypto<`u`&&typeof crypto.randomUUID==`function`?crypto.randomUUID():g()}`}function v(e){return e.startsWith(m)}function y(e){return e==null||e===``}function b(e){if(e.group)return!0;let t=e.rowKind;return t===`detail`||t===`groupHeader`||t===`groupFooter`}function x(e,t){if(e.isTransient)return null;let n=e.data[t];return!b(e)&&(typeof n==`number`||typeof n==`string`)?n:e.id}function S(e,t,n,r){if(r?.isTransient||v(n))return null;let i=e[t];return typeof i==`number`||typeof i==`string`?i:n}function C(e,t){if(v(e))return null;let n=t.getRowById(e);return n?x(n,t.rowKey):e}function w(e,t){return e.map(e=>C(e,t))}function T(e){return{fromNode:t=>x(t,e.rowKey),fromInternal:t=>C(t,e),fromInternalList:t=>w(t,e)}}function E(e,t){let n=T(t);return{...e,cellErrors:e.cellErrors.map(e=>({...e,rowId:n.fromInternal(String(e.rowId))}))}}function D(e,t){let n={...e.data};return e.isTransient&&(n[t]=null),n}function O(e,t){return e.map(e=>D(e,t))}function k(e,t){let n=T(t),r=[];for(let i of e){let e=t.getRowById(i);e&&r.push({rowId:n.fromNode(e),internalRowId:i,isTransient:e.isTransient===!0||v(i),rowIndex:e.rowIndex,data:D(e,t.rowKey)})}return r}function A(e){return Array.isArray(e)}function j(e){return A(e)?e:[e]}function M(e){return e!==null}function N(e,t){return t===`all`?[...e]:t===`business`?e.filter(e=>!e.isTransient&&M(e.rowId)):e.filter(e=>e.isTransient)}function P(e){return e.isTransient?e.internalRowId:M(e.rowId)?e.rowId:null}function F(e){let t=[];for(let n of e){let e=P(n);e!=null&&t.push(e)}return t}function I(e){return P(e)??e.internalRowId}function L(e,t={}){return F(N(j(e),t.mode??`all`))}function R(e,t={}){return L(e,t)}function z(e,t,n={}){return N(k(e,t),n.mode??`all`)}var B=`overlay`;function V(e){return e===`inline`?`inline`:B}function H(e,t){return i(e)||f(e)?B:V(t)}function U(e){return i(e.colId)||f(e.colId)||V(e.cellEditorMode)!==`inline`?!1:e.cellEditor!=null}function W(e,t){}function G(e,t){}var K=`default`;function q(e={}){let t=e.cellEditorCacheMaxEntries;return{enableCellEditorCache:e.enableCellEditorCache??!1,cellEditorCacheMaxEntries:t!=null&&Number.isFinite(t)&&t>0?Math.floor(t):void 0}}function J(e,t){return e===null?t?`\0${t}`:`\0transient`:String(e)}function Y(e,t,n=K,r){return`${J(e,r?.internalRowId)}::${t}::${n}`}function X(e,t,n){return`${J(e,n?.internalRowId)}::${t}`}function Z(e={}){let{userKey:t,columnCellEditorCache:n}=e,r=typeof n==`string`?n:void 0;return t!=null&&t!==``?r?`${r}::${t}`:t:r||K}function Q(e){return U({colId:e.colId,cellEditorMode:e.cellEditorMode,cellEditor:e.cellEditor})||e.columnCellEditorCache===!1?!1:e.columnCellEditorCache===!0||typeof e.columnCellEditorCache==`string`||e.enableCellEditorCache}function $(e){return e.previousParentRowId!==e.parentRowId||e.previousSiblingIndex!==e.siblingIndex}function ee(e,t=`default`){let n=e.hierarchyChanges??[];return t==="default"?[...n]:n.filter($)}Object.defineProperty(exports,"A",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"B",{enumerable:!0,get:function(){return 1}}),Object.defineProperty(exports,"C",{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,"D",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"E",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"F",{enumerable:!0,get:function(){return 40}}),Object.defineProperty(exports,"G",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"H",{enumerable:!0,get:function(){return 40}}),Object.defineProperty(exports,"I",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"K",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"L",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"M",{enumerable:!0,get:function(){return`全选`}}),Object.defineProperty(exports,"N",{enumerable:!0,get:function(){return 40}}),Object.defineProperty(exports,"O",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"P",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"R",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,"T",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"U",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"V",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"W",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return R}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return Y}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return Q}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return z}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return J}}),Object.defineProperty(exports,"j",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"k",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return B}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return G}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return K}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return q}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return W}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return X}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return Z}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return ee}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return I}}),Object.defineProperty(exports,"w",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return L}}),Object.defineProperty(exports,"z",{enumerable:!0,get:function(){return s}});
2
+ //# sourceMappingURL=getRowDragCommitHierarchy-Bdhm-T66.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getRowDragCommitHierarchy-Bdhm-T66.cjs","names":[],"sources":["../src/core/types/indexColumn.ts","../src/core/types/rowSelectionOptions.ts","../src/core/types/selectionColumn.ts","../src/core/rowModel/transientRowId.ts","../src/core/types/businessRowId.ts","../src/core/rowModel/rowDataExport.ts","../src/core/types/selectedRowSnapshot.ts","../src/core/types/cellEditorMode.ts","../src/core/types/cellEditorCache.ts","../src/core/row/getRowDragCommitHierarchy.ts"],"sourcesContent":["import type { ColumnDef } from '@types'\r\nimport type { GridHorizontalAlign, GridVerticalAlign } from '@core/types/align'\r\n\r\n/** 系统索引列 colId;用户 columns 不得占用 */\r\nexport const INDEX_COLUMN_ID = '__index__'\r\n\r\n/** 索引列最小(默认)宽度 px */\r\nexport const INDEX_COLUMN_MIN_WIDTH = 40\r\n\r\n/** 索引列默认起始序号(1-based 展示 = rowIndex + start) */\r\nexport const DEFAULT_INDEX_COLUMN_START = 1\r\n\r\n/** 索引列配置 */\r\nexport interface IndexColumnOptions {\r\n /** 表头文案;默认空字符串 */\r\n label?: string\r\n /** 列宽 px;默认 40;小于 40 时钳制为 40 */\r\n width?: number\r\n /** 起始序号(1-based 展示 = rowIndex + start);默认 1 */\r\n start?: number\r\n /**\r\n * 辅助定位模式:single / multiple(multiple 支持 Ctrl/Shift/拖拉范围)\r\n * 默认 multiple(Excel 行号式交互)\r\n */\r\n focusMode?: 'single' | 'multiple'\r\n /**\r\n * 索引列定位是否单向同步到行选择列(业务选中);core 默认 false,MagicGrid 组件层默认 true。\r\n * 仅当 indexColumn.focusMode 与 rowSelection 同为 single 或同为 multiple 时生效。\r\n * 用户在索引列上操作(点击/拖选/再次点击取消)或 API `setIndexFocus`(`mode: 'default'`)时同步;\r\n * 点击其他区域清除索引定位、行删除 / rowId 迁移等不同步行选择列。\r\n */\r\n syncToSelectionColumn?: boolean\r\n /** 表头水平对齐;默认 center */\r\n headerAlign?: GridHorizontalAlign\r\n /** 表头垂直对齐;默认 center */\r\n headerValign?: GridVerticalAlign\r\n /** 表体水平对齐;默认 center */\r\n align?: GridHorizontalAlign\r\n /** 表体垂直对齐;默认 center */\r\n valign?: GridVerticalAlign\r\n /** footer 水平对齐;默认 center */\r\n footerAlign?: GridHorizontalAlign\r\n /** footer 垂直对齐;默认 center */\r\n footerValign?: GridVerticalAlign\r\n /**\r\n * 自定义序号展示;入参为 rowsToDisplay 下标。\r\n * 缺省:(rowIndex) => String(rowIndex + start)\r\n */\r\n index?: (rowIndex: number) => number | string\r\n /**\r\n * 在索引列 cell 内显示行拖拽把柄;默认 false。\r\n * 需配合 Grid `rowDragManaged` 或监听 `rowDragEnd` 自行改序。\r\n */\r\n showRowDragHandle?: boolean\r\n /**\r\n * 索引列底边可拖拽调整行高;默认 false。\r\n * 对标 AG Grid Row Numbers `enableRowResizer`。\r\n */\r\n enableRowResizer?: boolean\r\n}\r\n\r\n/** Grid 级索引列开关与配置(块 0 类型;块 1+ 消费) */\r\nexport interface IndexColumnGridOptions {\r\n /** 是否显示最左侧索引列;默认 false */\r\n showIndexColumn?: boolean\r\n /** 索引列配置;showIndexColumn=true 时生效 */\r\n indexColumn?: IndexColumnOptions\r\n}\r\n\r\nexport interface ResolvedIndexColumnOptions {\r\n label: string\r\n width: number\r\n start: number\r\n focusMode: 'single' | 'multiple'\r\n syncToSelectionColumn: boolean\r\n showRowDragHandle: boolean\r\n enableRowResizer: boolean\r\n headerAlign: GridHorizontalAlign\r\n headerValign: GridVerticalAlign\r\n align: GridHorizontalAlign\r\n valign: GridVerticalAlign\r\n footerAlign: GridHorizontalAlign\r\n footerValign: GridVerticalAlign\r\n index?: (rowIndex: number) => number | string\r\n}\r\n\r\nexport interface ResolvedIndexColumnGridOptions {\r\n showIndexColumn: boolean\r\n indexColumn: ResolvedIndexColumnOptions\r\n}\r\n\r\nexport function resolveIndexColumnWidth(width?: number): number {\r\n return Math.max(INDEX_COLUMN_MIN_WIDTH, width ?? INDEX_COLUMN_MIN_WIDTH)\r\n}\r\n\r\nexport function resolveIndexColumnOptions(\r\n options: IndexColumnOptions = {},\r\n): ResolvedIndexColumnOptions {\r\n return {\r\n label: options.label ?? '',\r\n width: resolveIndexColumnWidth(options.width),\r\n start: options.start ?? DEFAULT_INDEX_COLUMN_START,\r\n focusMode: options.focusMode === 'single' ? 'single' : 'multiple',\r\n syncToSelectionColumn: options.syncToSelectionColumn ?? false,\r\n showRowDragHandle: options.showRowDragHandle ?? false,\r\n enableRowResizer: options.enableRowResizer ?? false,\r\n headerAlign: options.headerAlign ?? 'center',\r\n headerValign: options.headerValign ?? 'center',\r\n align: options.align ?? 'center',\r\n valign: options.valign ?? 'center',\r\n footerAlign: options.footerAlign ?? 'center',\r\n footerValign: options.footerValign ?? 'center',\r\n index: options.index,\r\n }\r\n}\r\n\r\nexport function resolveIndexColumnGridOptions(\r\n options: IndexColumnGridOptions = {},\r\n): ResolvedIndexColumnGridOptions {\r\n return {\r\n showIndexColumn: options.showIndexColumn ?? false,\r\n indexColumn: resolveIndexColumnOptions(options.indexColumn),\r\n }\r\n}\r\n\r\nexport function isIndexColumn(colId: string): boolean {\r\n return colId === INDEX_COLUMN_ID\r\n}\r\n\r\n/** `setIndexFocus` 同步策略:default 跟随 grid 配置;manual 由调用方显式控制 */\r\nexport type SetIndexFocusMode = 'default' | 'manual'\r\n\r\n/** `GridApi.setIndexFocus` 可选参数 */\r\nexport interface SetIndexFocusOptions {\r\n /**\r\n * - `default`(默认):与用户点击索引列一致,按 `indexColumn.syncToSelectionColumn` 决定是否同步\r\n * - `manual`:由 `syncToSelectionColumn` 显式控制,可覆盖 grid 配置\r\n */\r\n mode?: SetIndexFocusMode\r\n /** `mode: 'manual'` 时生效;省略时视为 `false` */\r\n syncToSelectionColumn?: boolean\r\n}\r\n\r\nexport function resolveColumnDefColId(column: ColumnDef, index: number): string {\r\n return column.key ?? column.prop ?? `col_${index}`\r\n}\r\n\r\n/** 开发模式:用户 columns 占用系统索引列 colId 时告警 */\r\nexport function warnIfUserColumnsConflictWithIndexColumn(\r\n columns: readonly ColumnDef[],\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n columns.forEach((column, index) => {\r\n const colId = resolveColumnDefColId(column, index)\r\n if (colId === INDEX_COLUMN_ID || column.key === INDEX_COLUMN_ID) {\r\n console.warn(\r\n `[magic-grid] Column \"${INDEX_COLUMN_ID}\" is reserved for the system index column. ` +\r\n 'Remove it from your columns definition or use showIndexColumn instead.',\r\n )\r\n }\r\n })\r\n}\r\n","export type RowSelectionMode = 'single' | 'multiple'\n\n/** 行选择配置(Phase 19 · groupSelectsChildren) */\nexport interface RowSelectionConfig {\n mode: RowSelectionMode\n /**\n * tree 模式下选中父节点是否级联选中子孙。默认 `true`。\n * 对标 AG Grid rowSelection.groupSelectsChildren。\n */\n groupSelectsChildren?: boolean\n}\n\nexport type RowSelectionInput =\n | RowSelectionMode\n | false\n | RowSelectionConfig\n\nexport interface ResolvedRowSelectionOptions {\n mode: RowSelectionMode | false\n groupSelectsChildren: boolean\n}\n\nexport function normalizeRowSelectionInput(\n input: RowSelectionInput | undefined,\n): ResolvedRowSelectionOptions {\n if (input === false) {\n return { mode: false, groupSelectsChildren: true }\n }\n\n if (input == null) {\n return { mode: 'single', groupSelectsChildren: true }\n }\n\n if (typeof input === 'string') {\n return {\n mode: input === 'multiple' ? 'multiple' : 'single',\n groupSelectsChildren: true,\n }\n }\n\n return {\n mode: input.mode === 'multiple' ? 'multiple' : 'single',\n groupSelectsChildren: input.groupSelectsChildren ?? true,\n }\n}\n\nexport function normalizeRowSelectionMode(\n resolved: ResolvedRowSelectionOptions,\n): RowSelectionMode | false {\n return resolved.mode\n}\n","import type { RowSelectionMode } from '@core/selection/selectionService'\r\nimport {\r\n normalizeRowSelectionInput,\r\n type RowSelectionInput,\r\n} from '@core/types/rowSelectionOptions'\r\n\r\nimport { resolveColumnDefColId } from './indexColumn'\r\nimport type { GridHorizontalAlign, GridVerticalAlign } from '@core/types/align'\r\nimport type { ColumnDef } from '@types'\r\n\r\n/** 系统行选择列 colId;用户 columns 不得占用 */\r\nexport const SELECTION_COLUMN_ID = '__select__'\r\n\r\n/** 行选择列最小宽度 px */\r\nexport const SELECTION_COLUMN_MIN_WIDTH = 40\r\n\r\n/** 行选择列默认宽度 px */\r\nexport const SELECTION_COLUMN_DEFAULT_WIDTH = 40\r\n\r\n/** 表头全选 checkbox 默认 aria-label */\r\nexport const DEFAULT_SELECTION_SELECT_ALL_LABEL = '全选'\r\n\r\n/** 行选择列配置 */\r\nexport interface SelectionColumnOptions {\r\n /** 列宽 px;默认 40;小于 40 时钳制为 40 */\r\n width?: number\r\n /** 表头全选 checkbox 的 aria-label;默认「全选」 */\r\n selectAllLabel?: string\r\n /** 行 checkbox 的 aria-label 工厂 */\r\n rowLabel?: (rowIndex: number) => string\r\n /** 表头水平对齐;默认 center */\r\n headerAlign?: GridHorizontalAlign\r\n /** 表头垂直对齐;默认 center */\r\n headerValign?: GridVerticalAlign\r\n /** 表体水平对齐;默认 center */\r\n align?: GridHorizontalAlign\r\n /** 表体垂直对齐;默认 center */\r\n valign?: GridVerticalAlign\r\n /** footer 水平对齐;默认 center */\r\n footerAlign?: GridHorizontalAlign\r\n /** footer 垂直对齐;默认 center */\r\n footerValign?: GridVerticalAlign\r\n}\r\n\r\n/** Grid 级行选择列配置(块 0 类型;块 1+ 消费) */\r\nexport interface SelectionColumnGridOptions {\r\n /** 行选择列配置;rowSelection !== false 时生效 */\r\n selectionColumn?: SelectionColumnOptions\r\n}\r\n\r\nexport interface ResolvedSelectionColumnOptions {\r\n width: number\r\n selectAllLabel: string\r\n rowLabel?: (rowIndex: number) => string\r\n headerAlign: GridHorizontalAlign\r\n headerValign: GridVerticalAlign\r\n align: GridHorizontalAlign\r\n valign: GridVerticalAlign\r\n footerAlign: GridHorizontalAlign\r\n footerValign: GridVerticalAlign\r\n}\r\n\r\nexport interface ResolvedSelectionColumnGridOptions {\r\n /** rowSelection !== false */\r\n enabled: boolean\r\n /** 行选模式;enabled=false 时为占位 single */\r\n mode: RowSelectionMode\r\n selectionColumn: ResolvedSelectionColumnOptions\r\n}\r\n\r\nexport function resolveSelectionColumnWidth(width?: number): number {\r\n return Math.max(SELECTION_COLUMN_MIN_WIDTH, width ?? SELECTION_COLUMN_DEFAULT_WIDTH)\r\n}\r\n\r\nexport function resolveSelectionColumnOptions(\r\n options: SelectionColumnOptions = {},\r\n): ResolvedSelectionColumnOptions {\r\n return {\r\n width: resolveSelectionColumnWidth(options.width),\r\n selectAllLabel: options.selectAllLabel ?? DEFAULT_SELECTION_SELECT_ALL_LABEL,\r\n rowLabel: options.rowLabel,\r\n headerAlign: options.headerAlign ?? 'center',\r\n headerValign: options.headerValign ?? 'center',\r\n align: options.align ?? 'center',\r\n valign: options.valign ?? 'center',\r\n footerAlign: options.footerAlign ?? 'center',\r\n footerValign: options.footerValign ?? 'center',\r\n }\r\n}\r\n\r\nexport function resolveSelectionColumnGridOptions(\r\n options: {\r\n rowSelection?: RowSelectionInput\r\n selectionColumn?: SelectionColumnOptions\r\n } = {},\r\n): ResolvedSelectionColumnGridOptions {\r\n // Grid 直建时缺省 rowSelection 仍不注入行选择列;MagicGrid 默认传 'single'。\r\n if (options.rowSelection == null) {\r\n return {\r\n enabled: false,\r\n mode: 'single',\r\n selectionColumn: resolveSelectionColumnOptions(options.selectionColumn),\r\n }\r\n }\r\n\r\n const resolved = normalizeRowSelectionInput(options.rowSelection)\r\n const enabled = resolved.mode !== false\r\n\r\n return {\r\n enabled,\r\n mode: enabled && resolved.mode !== false ? resolved.mode : 'single',\r\n selectionColumn: resolveSelectionColumnOptions(options.selectionColumn),\r\n }\r\n}\r\n\r\nexport function isSelectionColumn(colId: string): boolean {\r\n return colId === SELECTION_COLUMN_ID\r\n}\r\n\r\n/** 开发模式:用户 columns 占用系统行选择列 colId 时告警 */\r\nexport function warnIfUserColumnsConflictWithSelectionColumn(\r\n columns: readonly ColumnDef[],\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n columns.forEach((column, index) => {\r\n const colId = resolveColumnDefColId(column, index)\r\n if (colId === SELECTION_COLUMN_ID || column.key === SELECTION_COLUMN_ID) {\r\n console.warn(\r\n `[magic-grid] Column \"${SELECTION_COLUMN_ID}\" is reserved for the system row selection column. ` +\r\n 'Remove it from your columns definition; use rowSelection instead.',\r\n )\r\n }\r\n })\r\n}\r\n","/**\n * 临时行(尚未分配业务主键的新增行)的内部 id 生成与识别。\n *\n * - **格式**:`__MG_TMP__::<uuid>`(例:`__MG_TMP__::550e8400-e29b-41d4-a716-446655440000`)\n * - **写入位置**:仅 `RowNode.id`;**不会**写入 `data[rowKey]`\n * - **对外暴露**:`getData()`、`selectedRowIds`、多数事件的 `rowId` 对临时行投影为 `null`\n * - **消费端获取内部 id**:`addRows` 返回的 `RowNode.id`、`getSelectedRows()` 的 `internalRowId`\n */\n/** 新增行内部临时 ID 前缀(不对用户 data[rowKey] 暴露) */\nexport const TRANSIENT_ROW_ID_PREFIX = '__MG_TMP__::' as const\n\nlet transientRowIdCounter = 0\n\nfunction createFallbackUuid(): string {\n transientRowIdCounter += 1\n return `${Date.now().toString(36)}_${transientRowIdCounter.toString(36)}`\n}\n\n/** 生成表格内部使用的临时 rowId */\nexport function createTransientRowId(): string {\n const uuid =\n typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n ? crypto.randomUUID()\n : createFallbackUuid()\n\n return `${TRANSIENT_ROW_ID_PREFIX}${uuid}`\n}\n\n/** 判断 id 是否为内部临时 rowId */\nexport function isTransientRowId(id: string): boolean {\n return id.startsWith(TRANSIENT_ROW_ID_PREFIX)\n}\n\n/** 业务 rowKey 是否为空(视为尚未分配持久化主键) */\nexport function isMissingBusinessRowKey(value: unknown): boolean {\n return value === null || value === undefined || value === ''\n}\n","import { isTransientRowId } from '@core/rowModel/transientRowId'\nimport type { RowData } from '@types'\nimport type { RowNode } from '@core/types/rowNode'\nimport type { RowId } from '@core/types/rowId'\n\n/** 对外 API / 事件 rowId:与用户 data[rowKey] 同型;临时行无业务主键时为 null */\nexport type BusinessRowId = RowId | null\n\nexport interface BusinessRowIdContext {\n rowKey: string\n getRowById: (internalId: string) => RowNode | undefined\n}\n\n/** 无用户业务主键的合成行(分组头、detail 等) */\nexport function isSyntheticRow(rowNode: RowNode): boolean {\n if (rowNode.group) {\n return true\n }\n\n const kind = rowNode.rowKind\n return kind === 'detail' || kind === 'groupHeader' || kind === 'groupFooter'\n}\n\n/** RowNode → 业务 rowId */\nexport function toBusinessRowId(rowNode: RowNode, rowKey: string): BusinessRowId {\n if (rowNode.isTransient) {\n return null\n }\n\n const raw = rowNode.data[rowKey]\n if (!isSyntheticRow(rowNode) && (typeof raw === 'number' || typeof raw === 'string')) {\n return raw\n }\n\n return rowNode.id\n}\n\n/** 从导出的 row.data 快照解析业务 rowId(rowsRemoved 等行已不在模型中时) */\nexport function toBusinessRowIdFromExportedData(\n data: RowData,\n rowKey: string,\n internalId: string,\n options?: { isTransient?: boolean },\n): BusinessRowId {\n if (options?.isTransient || isTransientRowId(internalId)) {\n return null\n }\n\n const raw = data[rowKey]\n if (typeof raw === 'number' || typeof raw === 'string') {\n return raw\n }\n\n return internalId\n}\n\n/** 内核 rowId → 业务 rowId */\nexport function toBusinessRowIdFromInternal(\n internalId: string,\n ctx: BusinessRowIdContext,\n): BusinessRowId {\n if (isTransientRowId(internalId)) {\n return null\n }\n\n const rowNode = ctx.getRowById(internalId)\n if (rowNode) {\n return toBusinessRowId(rowNode, ctx.rowKey)\n }\n\n return internalId\n}\n\nexport function toBusinessRowIdsFromInternal(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n): BusinessRowId[] {\n return internalIds.map((id) => toBusinessRowIdFromInternal(id, ctx))\n}\n\nexport function createBusinessRowIdResolver(ctx: BusinessRowIdContext) {\n return {\n fromNode: (rowNode: RowNode) => toBusinessRowId(rowNode, ctx.rowKey),\n fromInternal: (internalId: string) => toBusinessRowIdFromInternal(internalId, ctx),\n fromInternalList: (internalIds: readonly string[]) =>\n toBusinessRowIdsFromInternal(internalIds, ctx),\n }\n}\n\nexport function projectValidationResult(\n result: import('@core/types/validation').GridValidationResult,\n ctx: BusinessRowIdContext,\n): import('@core/types/validation').GridValidationResult {\n const resolve = createBusinessRowIdResolver(ctx)\n return {\n ...result,\n cellErrors: result.cellErrors.map((error) => ({\n ...error,\n rowId: resolve.fromInternal(String(error.rowId)),\n })),\n }\n}\n","import type { RowNode } from '@core/types'\nimport type { RowData } from '@types'\n\n/** 将 RowNode 转为对外导出的行数据(浅拷贝) */\nexport function toUserRowData(rowNode: RowNode, rowKey: string): RowData {\n const exported: RowData = { ...rowNode.data }\n\n if (rowNode.isTransient) {\n exported[rowKey] = null\n }\n\n return exported\n}\n\n/** 批量导出 RowNode 数组为用户行数据 */\nexport function exportRowData(rows: readonly RowNode[], rowKey: string): RowData[] {\n return rows.map((row) => toUserRowData(row, rowKey))\n}\n","/**\n * 行「双 ID」投影:快照构建与 mutation API 可用的 id 列表工具。\n *\n * ## 为什么有两套 id?\n *\n * | | 持久化行 | 临时行(新增、`id` 为 null/省略) |\n * |---|---------|--------------------------------|\n * | 业务 id | `data[rowKey]`、`rowId` | 恒 `null` |\n * | 内核 id | `internalRowId` ≈ `String(rowId)` | `__MG_TMP__::*` |\n *\n * 事件里的 `*RowIds` 为业务投影(临时行 `null`,仅适合展示)。\n *\n * ## 消费端速查\n *\n * | 场景 | 读快照 | 传给 API 的 id |\n * |------|--------|----------------|\n * | checkbox 选中(单行) | `selectedRows[i]` | `generateRowId(row)` |\n * | checkbox 选中(多行) | `selectedRows` | `generateSelectedRowIds(rows)` 或 `api.removeSelectedRows()` |\n * | 索引 focus(单行) | `focusedRows[i]` | `generateRowId(row)` |\n * | 索引 focus(多行) | `focusedRows` | `generateFocusedRowIds(rows)` 或 `api.getIndexFocusedRowIds()` |\n *\n * **规则**:持久化行 → 业务 `rowId`;临时行 → `internalRowId`(`__MG_TMP__::*`)。\n *\n * ## `RowListOptions.mode`(默认 `'all'`)\n *\n * | mode | 含义 |\n * |------|------|\n * | `'all'` | 持久化 + 临时(mutation 时:持久化→业务 id,临时→`internalRowId`) |\n * | `'business'` | 仅持久化行 |\n * | `'temp'` | 仅临时行 |\n */\nimport { toUserRowData } from '@core/rowModel/rowDataExport'\nimport { isTransientRowId } from '@core/rowModel/transientRowId'\nimport type { RowData } from '@types'\n\nimport {\n createBusinessRowIdResolver,\n type BusinessRowId,\n type BusinessRowIdContext,\n} from './businessRowId'\nimport type { RowId } from './rowId'\n\n/** 行列表过滤模式(选中 / focus 共用) */\nexport type RowListMode = 'all' | 'business' | 'temp'\n\nexport interface RowListOptions {\n /** @default 'all' */\n mode?: RowListMode\n}\n\n/** checkbox 选中:`generateSelectedRowIds` 入参 */\nexport type GenerateSelectedRowIdsOptions = RowListOptions\n\n/** 索引 focus:`generateFocusedRowIds` 入参(与 {@link GenerateSelectedRowIdsOptions} 相同) */\nexport type GenerateFocusedRowIdsOptions = RowListOptions\n\n/**\n * 行快照——`getSelectedRows` / `getIndexFocusedRows` /\n * `selectionChanged.selectedRows` / `indexFocusChanged.focusedRows` 共用。\n */\nexport interface SelectedRowSnapshot<TData = RowData> {\n /** 业务主键;临时行恒 `null` */\n rowId: BusinessRowId\n /** 内核 rowId;临时行为 `__MG_TMP__::*` */\n internalRowId: string\n isTransient: boolean\n rowIndex: number\n /** 与 `api.getData()` 导出规则一致 */\n data: TData\n}\n\n/** @internal internal id 列表 → 行快照 */\nexport function buildSelectedRowSnapshots(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n): SelectedRowSnapshot[] {\n const resolve = createBusinessRowIdResolver(ctx)\n const snapshots: SelectedRowSnapshot[] = []\n\n for (const internalRowId of internalIds) {\n const rowNode = ctx.getRowById(internalRowId)\n if (!rowNode) {\n continue\n }\n\n snapshots.push({\n rowId: resolve.fromNode(rowNode),\n internalRowId,\n isTransient: rowNode.isTransient === true || isTransientRowId(internalRowId),\n rowIndex: rowNode.rowIndex,\n data: toUserRowData(rowNode, ctx.rowKey),\n })\n }\n\n return snapshots\n}\n\nfunction isSnapshotArray(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n): rows is readonly SelectedRowSnapshot[] {\n return Array.isArray(rows)\n}\n\nfunction normalizeSnapshots(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n): readonly SelectedRowSnapshot[] {\n if (isSnapshotArray(rows)) {\n return rows\n }\n\n const singleRow: SelectedRowSnapshot = rows\n return [singleRow]\n}\n\nfunction isUsableBusinessRowId(rowId: BusinessRowId): rowId is RowId {\n return rowId !== null\n}\n\nfunction filterSnapshotsByMode(\n rows: readonly SelectedRowSnapshot[],\n mode: RowListMode,\n): SelectedRowSnapshot[] {\n if (mode === 'all') {\n return [...rows]\n }\n\n if (mode === 'business') {\n return rows.filter((row) => !row.isTransient && isUsableBusinessRowId(row.rowId))\n }\n\n return rows.filter((row) => row.isTransient)\n}\n\n/** 持久化行 → 业务 id;临时行 → internalRowId;无业务 id 时返回 `null` */\nfunction resolveMutationRowId(row: SelectedRowSnapshot): RowId | null {\n if (row.isTransient) {\n return row.internalRowId\n }\n\n if (isUsableBusinessRowId(row.rowId)) {\n return row.rowId\n }\n\n return null\n}\n\n/** 持久化行 → 业务 id;临时行 → internalRowId */\nfunction projectRowIdsFromSnapshots(rows: readonly SelectedRowSnapshot[]): RowId[] {\n const result: RowId[] = []\n\n for (const row of rows) {\n const id = resolveMutationRowId(row)\n if (id != null) {\n result.push(id)\n }\n }\n\n return result\n}\n\n/**\n * 单行快照 → `removeRows` / `moveRows` / `getRowType` 等 API 可用的 id。\n *\n * - 持久化行 → 业务 `rowId`\n * - 临时行 → `internalRowId`(`__MG_TMP__::*`)\n *\n * @example\n * ```ts\n * api.on('indexFocusChanged', (event) => {\n * const id = generateRowId(event.focusedRows[0])\n * api.getRowType(id)\n * })\n * ```\n */\nexport function generateRowId(row: SelectedRowSnapshot): RowId {\n return resolveMutationRowId(row) ?? row.internalRowId\n}\n\n/**\n * checkbox 选中行 → `removeRows` / `moveRows` 可用的 id 列表。\n *\n * @example\n * ```ts\n * gridApi.on('selectionChanged', async (event) => {\n * await api.removeRows({ rowIds: generateSelectedRowIds(event.selectedRows) })\n * })\n * ```\n */\nexport function generateSelectedRowIds(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n options: RowListOptions = {},\n): RowId[] {\n const filtered = filterSnapshotsByMode(normalizeSnapshots(rows), options.mode ?? 'all')\n return projectRowIdsFromSnapshots(filtered)\n}\n\n/**\n * 索引 focus 行 → `moveRows` 可用的 id 列表(规则同 {@link generateSelectedRowIds})。\n *\n * @example\n * ```ts\n * gridApi.on('indexFocusChanged', (event) => {\n * api.moveRows({ rowIds: generateFocusedRowIds(event.focusedRows), toIndex: 0 })\n * })\n * ```\n */\nexport function generateFocusedRowIds(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n options: RowListOptions = {},\n): RowId[] {\n return generateSelectedRowIds(rows, options)\n}\n\n/** @internal `getIndexFocusedRows` 实现 */\nexport function buildIndexFocusRowSnapshots(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n options: RowListOptions = {},\n): SelectedRowSnapshot[] {\n return filterSnapshotsByMode(\n buildSelectedRowSnapshots(internalIds, ctx),\n options.mode ?? 'all',\n )\n}\n","import { isIndexColumn } from '@core/types/indexColumn'\r\nimport { isSelectionColumn } from '@core/types/selectionColumn'\r\nimport { isBuiltInCellEditor } from '@core/types/cellEditor'\r\n\r\n/** 单元格编辑器呈现模式:overlay 进入编辑态;inline 常驻格内 */\r\nexport type CellEditorMode = 'overlay' | 'inline'\r\n\r\n/** 缺省 overlay,与 Phase 3 行为一致 */\r\nexport const DEFAULT_CELL_EDITOR_MODE: CellEditorMode = 'overlay'\r\n\r\n/** 解析列级 cellEditorMode;缺省 overlay */\r\nexport function resolveCellEditorMode(mode?: CellEditorMode): CellEditorMode {\r\n if (mode === 'inline') {\r\n return 'inline'\r\n }\r\n return DEFAULT_CELL_EDITOR_MODE\r\n}\r\n\r\n/** 系统列强制 overlay;用户列解析 cellEditorMode */\r\nexport function resolveColumnCellEditorMode(\r\n colId: string,\r\n mode?: CellEditorMode,\r\n): CellEditorMode {\r\n if (isIndexColumn(colId) || isSelectionColumn(colId)) {\r\n return DEFAULT_CELL_EDITOR_MODE\r\n }\r\n return resolveCellEditorMode(mode)\r\n}\r\n\r\n/** 是否为 inline 常驻编辑器列(须配置 cellEditor;系统列恒 false) */\r\nexport function isInlineEditorColumn(column: {\r\n colId: string\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n}): boolean {\r\n if (isIndexColumn(column.colId) || isSelectionColumn(column.colId)) {\r\n return false\r\n }\r\n\r\n if (resolveCellEditorMode(column.cellEditorMode) !== 'inline') {\r\n return false\r\n }\r\n\r\n return column.cellEditor != null\r\n}\r\n\r\n/** 开发模式:inline 误配告警 */\r\nexport function warnIfInlineEditorMisconfigured(\r\n colId: string,\r\n options: {\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n },\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n const isSystem = isIndexColumn(colId) || isSelectionColumn(colId)\r\n\r\n if (isSystem && options.cellEditorMode === 'inline') {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" is a system column and cannot use cellEditorMode: 'inline'. ` +\r\n 'Inline editors apply to user data columns only.',\r\n )\r\n return\r\n }\r\n\r\n if (options.cellEditorMode === 'inline' && options.cellEditor == null) {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" has cellEditorMode: 'inline' but no cellEditor. ` +\r\n 'Configure cellEditor (e.g. \"checkbox\") or remove inline mode.',\r\n )\r\n }\r\n}\r\n\r\nconst INLINE_NATIVE_EDITORS = new Set(['text', 'number', 'checkbox', 'switch'])\r\n\r\n/** 开发模式:inline 列使用可能依赖 overlay/teleport 的编辑器时告警 */\r\nexport function warnIfInlineOverlayEditor(\r\n colId: string,\r\n options: {\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n },\r\n): void {\r\n if (!import.meta.env.DEV || options.cellEditorMode !== 'inline') {\r\n return\r\n }\r\n\r\n const editor = options.cellEditor\r\n if (editor == null) {\r\n return\r\n }\r\n\r\n if (typeof editor === 'function') {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" uses cellEditorMode: 'inline' with a custom editor function. ` +\r\n 'Inline editors must not use overlay/teleport; prefer checkbox, switch, text, or number.',\r\n )\r\n return\r\n }\r\n\r\n if (typeof editor === 'string' && !INLINE_NATIVE_EDITORS.has(editor) && !isBuiltInCellEditor(editor)) {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" uses cellEditorMode: 'inline' with editor \"${editor}\" ` +\r\n 'which may require an overlay surface. Prefer \"checkbox\", \"switch\", \"text\", or \"number\" for inline columns.',\r\n )\r\n }\r\n}\r\n","/**\n * Cell Editor Cache — 类型与纯函数(Phase 42 / M35)\n *\n * 职责:Grid/列 opt-in 开关解析、存储键规则、是否向 overlay 列注入 API。\n * 可变状态与 LRU 在 {@link CellEditorCacheService}(`cellEditorCacheService.ts`)。\n *\n * 存储键:`${rowPart}::${colId}::${resolvedKey}`\n * - rowPart:业务 rowId 字符串;transient 行为 `\\0${internalRowId}`\n * - resolvedKey:消费方 key + 可选列级 namespace 前缀\n */\nimport type { BusinessRowId } from '@core/types/businessRowId'\nimport type { CellEditorMode } from '@core/types/cellEditorMode'\nimport { isInlineEditorColumn } from '@core/types/cellEditorMode'\n\n/** 消费方未传 key 且列无 string namespace 时的默认 slot */\nexport const DEFAULT_CELL_EDITOR_CACHE_KEY = 'default'\n\n/** 列级 flag:`true` 启用 · `string` 固定 namespace · `false` 全局开启时 opt-out */\nexport type CellEditorCacheColumnFlag = boolean | string\n\n/** Grid 级配置(MagicGrid `enableCellEditorCache` / `cellEditorCacheMaxEntries`) */\nexport interface CellEditorCacheGridOptions {\n /**\n * 为所有 overlay 列注入 get/set/clear API。\n * 默认 false(零开销);列级 `cellEditorCache: false` 可显式 opt-out。\n */\n enableCellEditorCache?: boolean\n\n /**\n * 会话 cache 最大 **cell bucket** 数 `(rowId,colId)`;超出 LRU 淘汰。\n * 默认不限。\n */\n cellEditorCacheMaxEntries?: number\n}\n\nexport interface ResolvedCellEditorCacheGridOptions {\n enableCellEditorCache: boolean\n cellEditorCacheMaxEntries: number | undefined\n}\n\nexport function resolveCellEditorCacheGridOptions(\n options: CellEditorCacheGridOptions = {},\n): ResolvedCellEditorCacheGridOptions {\n const maxEntries = options.cellEditorCacheMaxEntries\n return {\n enableCellEditorCache: options.enableCellEditorCache ?? false,\n cellEditorCacheMaxEntries:\n maxEntries != null && Number.isFinite(maxEntries) && maxEntries > 0\n ? Math.floor(maxEntries)\n : undefined,\n }\n}\n\n/**\n * 存储键 rowId 段。\n * transient 行业务 id 为 null,须传 internalRowId 以免多行新增互相覆盖。\n */\nexport function buildCellEditorCacheRowPart(\n rowId: BusinessRowId,\n internalRowId?: string,\n): string {\n if (rowId !== null) {\n return String(rowId)\n }\n if (internalRowId) {\n return `\\0${internalRowId}`\n }\n return '\\0transient'\n}\n\n/** 完整 Map 键:`rowPart::colId::key` */\nexport function buildCellEditorCacheStorageKey(\n rowId: BusinessRowId,\n colId: string,\n key: string = DEFAULT_CELL_EDITOR_CACHE_KEY,\n options?: { internalRowId?: string },\n): string {\n const rowPart = buildCellEditorCacheRowPart(rowId, options?.internalRowId)\n return `${rowPart}::${colId}::${key}`\n}\n\n/** LRU 粒度:同一格 `(rowId,colId)` 下所有 namespace key 共用一个 bucket */\nexport function buildCellEditorCacheBucketKey(\n rowId: BusinessRowId,\n colId: string,\n options?: { internalRowId?: string },\n): string {\n const rowPart = buildCellEditorCacheRowPart(rowId, options?.internalRowId)\n return `${rowPart}::${colId}`\n}\n\nexport interface ResolveCellEditorCacheKeyOptions {\n userKey?: string\n columnCellEditorCache?: CellEditorCacheColumnFlag\n}\n\n/**\n * 消费方 key → 存储层 key。\n * 列级 `cellEditorCache: 'part'` 时:`getCellCache()` → `part`;`getCellCache('options')` → `part::options`。\n */\nexport function resolveCellEditorCacheKey(\n options: ResolveCellEditorCacheKeyOptions = {},\n): string {\n const { userKey, columnCellEditorCache } = options\n const namespace =\n typeof columnCellEditorCache === 'string' ? columnCellEditorCache : undefined\n\n if (userKey != null && userKey !== '') {\n return namespace ? `${namespace}::${userKey}` : userKey\n }\n\n if (namespace) {\n return namespace\n }\n\n return DEFAULT_CELL_EDITOR_CACHE_KEY\n}\n\nexport interface ShouldInjectCellEditorCacheApiOptions {\n enableCellEditorCache: boolean\n colId: string\n cellEditorMode?: CellEditorMode\n cellEditor?: unknown\n columnCellEditorCache?: CellEditorCacheColumnFlag\n}\n\n/** inline 列、列级 false、或未开启全局开关 → 不注入(CellEditorParams 上无 cache 方法) */\nexport function shouldInjectCellEditorCacheApi(\n options: ShouldInjectCellEditorCacheApiOptions,\n): boolean {\n if (\n isInlineEditorColumn({\n colId: options.colId,\n cellEditorMode: options.cellEditorMode,\n cellEditor: options.cellEditor,\n })\n ) {\n return false\n }\n\n if (options.columnCellEditorCache === false) {\n return false\n }\n\n if (\n options.columnCellEditorCache === true ||\n typeof options.columnCellEditorCache === 'string'\n ) {\n return true\n }\n\n return options.enableCellEditorCache\n}\n","import type { RowDragCommitContext, RowHierarchyChange } from '@core/types/rowDrag'\n\n/** {@link getRowDragCommitHierarchy} 过滤模式 */\nexport type GetRowDragCommitHierarchyOption = 'default' | 'noLevel'\n\nfunction hasParentOrSiblingChange(change: RowHierarchyChange): boolean {\n return (\n change.previousParentRowId !== change.parentRowId ||\n change.previousSiblingIndex !== change.siblingIndex\n )\n}\n\n/**\n * 从 deferred row drag commit 上下文中提取树形层级变更列表。\n *\n * - `default`:返回 `context.hierarchyChanges` 的浅拷贝(含 `treeLevel` 及仅 level 变化的项)。\n * - `noLevel`:仅保留 **parentRowId 或 siblingIndex** 相对变更前发生变化的项,\n * 排除「parent / sibling 均未变、仅 treeLevel 不同」的条目。\n *\n * 对接后端 `parentId` + `order` 持久化时,通常使用 `noLevel`。\n *\n * @example\n * ```ts\n * import { getRowDragCommitHierarchy } from '@taocompany/magic-grid'\n *\n * const toPersist = getRowDragCommitHierarchy(context, 'noLevel')\n * for (const item of toPersist) {\n * await api.update({ id: item.rowId, parentId: item.parentRowId, order: item.siblingIndex })\n * }\n * ```\n */\nexport function getRowDragCommitHierarchy(\n context: RowDragCommitContext,\n option: GetRowDragCommitHierarchyOption = 'default',\n): RowHierarchyChange[] {\n const changes = context.hierarchyChanges ?? []\n\n if (option === 'default') {\n return [...changes]\n }\n\n return changes.filter(hasParentOrSiblingChange)\n}\n"],"mappings":"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"}
@@ -182,62 +182,67 @@ function R(e, t) {
182
182
  return t === "all" ? [...e] : t === "business" ? e.filter((e) => !e.isTransient && L(e.rowId)) : e.filter((e) => e.isTransient);
183
183
  }
184
184
  function z(e) {
185
+ return e.isTransient ? e.internalRowId : L(e.rowId) ? e.rowId : null;
186
+ }
187
+ function B(e) {
185
188
  let t = [];
186
189
  for (let n of e) {
187
- if (n.isTransient) {
188
- t.push(n.internalRowId);
189
- continue;
190
- }
191
- L(n.rowId) && t.push(n.rowId);
190
+ let e = z(n);
191
+ e != null && t.push(e);
192
192
  }
193
193
  return t;
194
194
  }
195
- function B(e, t = {}) {
196
- let n = t.mode ?? "all";
197
- return z(R(I(e), n));
195
+ function V(e) {
196
+ return z(e) ?? e.internalRowId;
197
+ }
198
+ function H(e, t = {}) {
199
+ return B(R(I(e), t.mode ?? "all"));
200
+ }
201
+ function U(e, t = {}) {
202
+ return H(e, t);
198
203
  }
199
- function V(e, t, n = {}) {
204
+ function W(e, t, n = {}) {
200
205
  return R(P(e, t), n.mode ?? "all");
201
206
  }
202
207
  //#endregion
203
208
  //#region src/core/types/cellEditorMode.ts
204
- var H = "overlay";
205
- function U(e) {
206
- return e === "inline" ? "inline" : H;
209
+ var G = "overlay";
210
+ function K(e) {
211
+ return e === "inline" ? "inline" : G;
207
212
  }
208
- function W(e, t) {
209
- return o(e) || _(e) ? H : U(t);
213
+ function q(e, t) {
214
+ return o(e) || _(e) ? G : K(t);
210
215
  }
211
- function G(e) {
212
- return o(e.colId) || _(e.colId) || U(e.cellEditorMode) !== "inline" ? !1 : e.cellEditor != null;
216
+ function J(e) {
217
+ return o(e.colId) || _(e.colId) || K(e.cellEditorMode) !== "inline" ? !1 : e.cellEditor != null;
213
218
  }
214
- function K(e, t) {}
215
- function q(e, t) {}
219
+ function Y(e, t) {}
220
+ function X(e, t) {}
216
221
  //#endregion
217
222
  //#region src/core/types/cellEditorCache.ts
218
- var J = "default";
219
- function Y(e = {}) {
223
+ var Z = "default";
224
+ function Q(e = {}) {
220
225
  let t = e.cellEditorCacheMaxEntries;
221
226
  return {
222
227
  enableCellEditorCache: e.enableCellEditorCache ?? !1,
223
228
  cellEditorCacheMaxEntries: t != null && Number.isFinite(t) && t > 0 ? Math.floor(t) : void 0
224
229
  };
225
230
  }
226
- function X(e, t) {
231
+ function $(e, t) {
227
232
  return e === null ? t ? `\0${t}` : "\0transient" : String(e);
228
233
  }
229
- function Z(e, t, n = J, r) {
230
- return `${X(e, r?.internalRowId)}::${t}::${n}`;
234
+ function ee(e, t, n = Z, r) {
235
+ return `${$(e, r?.internalRowId)}::${t}::${n}`;
231
236
  }
232
- function Q(e, t, n) {
233
- return `${X(e, n?.internalRowId)}::${t}`;
237
+ function te(e, t, n) {
238
+ return `${$(e, n?.internalRowId)}::${t}`;
234
239
  }
235
- function $(e = {}) {
240
+ function ne(e = {}) {
236
241
  let { userKey: t, columnCellEditorCache: n } = e, r = typeof n == "string" ? n : void 0;
237
- return t != null && t !== "" ? r ? `${r}::${t}` : t : r || J;
242
+ return t != null && t !== "" ? r ? `${r}::${t}` : t : r || Z;
238
243
  }
239
- function ee(e) {
240
- return G({
244
+ function re(e) {
245
+ return J({
241
246
  colId: e.colId,
242
247
  cellEditorMode: e.cellEditorMode,
243
248
  cellEditor: e.cellEditor
@@ -245,14 +250,14 @@ function ee(e) {
245
250
  }
246
251
  //#endregion
247
252
  //#region src/core/row/getRowDragCommitHierarchy.ts
248
- function te(e) {
253
+ function ie(e) {
249
254
  return e.previousParentRowId !== e.parentRowId || e.previousSiblingIndex !== e.siblingIndex;
250
255
  }
251
- function ne(e, t = "default") {
256
+ function ae(e, t = "default") {
252
257
  let n = e.hierarchyChanges ?? [];
253
- return t === "default" ? [...n] : n.filter(te);
258
+ return t === "default" ? [...n] : n.filter(ie);
254
259
  }
255
260
  //#endregion
256
- export { p as A, t as B, E as C, S as D, k as E, g as F, s as H, v as I, l as L, u as M, d as N, w as O, _ as P, n as R, j as S, O as T, a as U, o as V, c as W, B as _, Z as a, A as b, ee as c, U as d, W as f, P as g, V as h, X as i, f as j, C as k, H as l, q as m, J as n, Y as o, K as p, Q as r, $ as s, ne as t, G as u, N as v, D as w, T as x, M as y, e as z };
261
+ export { w as A, n as B, T as C, O as D, D as E, d as F, a as G, t as H, _ as I, c as K, g as L, p as M, f as N, k as O, u as P, v as R, A as S, E as T, o as U, e as V, s as W, U as _, ee as a, N as b, re as c, K as d, q as f, P as g, W as h, $ as i, C as j, S as k, G as l, X as m, Z as n, Q as o, Y as p, te as r, ne as s, ae as t, J as u, V as v, j as w, M as x, H as y, l as z };
257
262
 
258
- //# sourceMappingURL=getRowDragCommitHierarchy-VyTB8COC.js.map
263
+ //# sourceMappingURL=getRowDragCommitHierarchy-Bty3JIsM.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getRowDragCommitHierarchy-Bty3JIsM.js","names":[],"sources":["../src/core/types/indexColumn.ts","../src/core/types/rowSelectionOptions.ts","../src/core/types/selectionColumn.ts","../src/core/rowModel/transientRowId.ts","../src/core/types/businessRowId.ts","../src/core/rowModel/rowDataExport.ts","../src/core/types/selectedRowSnapshot.ts","../src/core/types/cellEditorMode.ts","../src/core/types/cellEditorCache.ts","../src/core/row/getRowDragCommitHierarchy.ts"],"sourcesContent":["import type { ColumnDef } from '@types'\r\nimport type { GridHorizontalAlign, GridVerticalAlign } from '@core/types/align'\r\n\r\n/** 系统索引列 colId;用户 columns 不得占用 */\r\nexport const INDEX_COLUMN_ID = '__index__'\r\n\r\n/** 索引列最小(默认)宽度 px */\r\nexport const INDEX_COLUMN_MIN_WIDTH = 40\r\n\r\n/** 索引列默认起始序号(1-based 展示 = rowIndex + start) */\r\nexport const DEFAULT_INDEX_COLUMN_START = 1\r\n\r\n/** 索引列配置 */\r\nexport interface IndexColumnOptions {\r\n /** 表头文案;默认空字符串 */\r\n label?: string\r\n /** 列宽 px;默认 40;小于 40 时钳制为 40 */\r\n width?: number\r\n /** 起始序号(1-based 展示 = rowIndex + start);默认 1 */\r\n start?: number\r\n /**\r\n * 辅助定位模式:single / multiple(multiple 支持 Ctrl/Shift/拖拉范围)\r\n * 默认 multiple(Excel 行号式交互)\r\n */\r\n focusMode?: 'single' | 'multiple'\r\n /**\r\n * 索引列定位是否单向同步到行选择列(业务选中);core 默认 false,MagicGrid 组件层默认 true。\r\n * 仅当 indexColumn.focusMode 与 rowSelection 同为 single 或同为 multiple 时生效。\r\n * 用户在索引列上操作(点击/拖选/再次点击取消)或 API `setIndexFocus`(`mode: 'default'`)时同步;\r\n * 点击其他区域清除索引定位、行删除 / rowId 迁移等不同步行选择列。\r\n */\r\n syncToSelectionColumn?: boolean\r\n /** 表头水平对齐;默认 center */\r\n headerAlign?: GridHorizontalAlign\r\n /** 表头垂直对齐;默认 center */\r\n headerValign?: GridVerticalAlign\r\n /** 表体水平对齐;默认 center */\r\n align?: GridHorizontalAlign\r\n /** 表体垂直对齐;默认 center */\r\n valign?: GridVerticalAlign\r\n /** footer 水平对齐;默认 center */\r\n footerAlign?: GridHorizontalAlign\r\n /** footer 垂直对齐;默认 center */\r\n footerValign?: GridVerticalAlign\r\n /**\r\n * 自定义序号展示;入参为 rowsToDisplay 下标。\r\n * 缺省:(rowIndex) => String(rowIndex + start)\r\n */\r\n index?: (rowIndex: number) => number | string\r\n /**\r\n * 在索引列 cell 内显示行拖拽把柄;默认 false。\r\n * 需配合 Grid `rowDragManaged` 或监听 `rowDragEnd` 自行改序。\r\n */\r\n showRowDragHandle?: boolean\r\n /**\r\n * 索引列底边可拖拽调整行高;默认 false。\r\n * 对标 AG Grid Row Numbers `enableRowResizer`。\r\n */\r\n enableRowResizer?: boolean\r\n}\r\n\r\n/** Grid 级索引列开关与配置(块 0 类型;块 1+ 消费) */\r\nexport interface IndexColumnGridOptions {\r\n /** 是否显示最左侧索引列;默认 false */\r\n showIndexColumn?: boolean\r\n /** 索引列配置;showIndexColumn=true 时生效 */\r\n indexColumn?: IndexColumnOptions\r\n}\r\n\r\nexport interface ResolvedIndexColumnOptions {\r\n label: string\r\n width: number\r\n start: number\r\n focusMode: 'single' | 'multiple'\r\n syncToSelectionColumn: boolean\r\n showRowDragHandle: boolean\r\n enableRowResizer: boolean\r\n headerAlign: GridHorizontalAlign\r\n headerValign: GridVerticalAlign\r\n align: GridHorizontalAlign\r\n valign: GridVerticalAlign\r\n footerAlign: GridHorizontalAlign\r\n footerValign: GridVerticalAlign\r\n index?: (rowIndex: number) => number | string\r\n}\r\n\r\nexport interface ResolvedIndexColumnGridOptions {\r\n showIndexColumn: boolean\r\n indexColumn: ResolvedIndexColumnOptions\r\n}\r\n\r\nexport function resolveIndexColumnWidth(width?: number): number {\r\n return Math.max(INDEX_COLUMN_MIN_WIDTH, width ?? INDEX_COLUMN_MIN_WIDTH)\r\n}\r\n\r\nexport function resolveIndexColumnOptions(\r\n options: IndexColumnOptions = {},\r\n): ResolvedIndexColumnOptions {\r\n return {\r\n label: options.label ?? '',\r\n width: resolveIndexColumnWidth(options.width),\r\n start: options.start ?? DEFAULT_INDEX_COLUMN_START,\r\n focusMode: options.focusMode === 'single' ? 'single' : 'multiple',\r\n syncToSelectionColumn: options.syncToSelectionColumn ?? false,\r\n showRowDragHandle: options.showRowDragHandle ?? false,\r\n enableRowResizer: options.enableRowResizer ?? false,\r\n headerAlign: options.headerAlign ?? 'center',\r\n headerValign: options.headerValign ?? 'center',\r\n align: options.align ?? 'center',\r\n valign: options.valign ?? 'center',\r\n footerAlign: options.footerAlign ?? 'center',\r\n footerValign: options.footerValign ?? 'center',\r\n index: options.index,\r\n }\r\n}\r\n\r\nexport function resolveIndexColumnGridOptions(\r\n options: IndexColumnGridOptions = {},\r\n): ResolvedIndexColumnGridOptions {\r\n return {\r\n showIndexColumn: options.showIndexColumn ?? false,\r\n indexColumn: resolveIndexColumnOptions(options.indexColumn),\r\n }\r\n}\r\n\r\nexport function isIndexColumn(colId: string): boolean {\r\n return colId === INDEX_COLUMN_ID\r\n}\r\n\r\n/** `setIndexFocus` 同步策略:default 跟随 grid 配置;manual 由调用方显式控制 */\r\nexport type SetIndexFocusMode = 'default' | 'manual'\r\n\r\n/** `GridApi.setIndexFocus` 可选参数 */\r\nexport interface SetIndexFocusOptions {\r\n /**\r\n * - `default`(默认):与用户点击索引列一致,按 `indexColumn.syncToSelectionColumn` 决定是否同步\r\n * - `manual`:由 `syncToSelectionColumn` 显式控制,可覆盖 grid 配置\r\n */\r\n mode?: SetIndexFocusMode\r\n /** `mode: 'manual'` 时生效;省略时视为 `false` */\r\n syncToSelectionColumn?: boolean\r\n}\r\n\r\nexport function resolveColumnDefColId(column: ColumnDef, index: number): string {\r\n return column.key ?? column.prop ?? `col_${index}`\r\n}\r\n\r\n/** 开发模式:用户 columns 占用系统索引列 colId 时告警 */\r\nexport function warnIfUserColumnsConflictWithIndexColumn(\r\n columns: readonly ColumnDef[],\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n columns.forEach((column, index) => {\r\n const colId = resolveColumnDefColId(column, index)\r\n if (colId === INDEX_COLUMN_ID || column.key === INDEX_COLUMN_ID) {\r\n console.warn(\r\n `[magic-grid] Column \"${INDEX_COLUMN_ID}\" is reserved for the system index column. ` +\r\n 'Remove it from your columns definition or use showIndexColumn instead.',\r\n )\r\n }\r\n })\r\n}\r\n","export type RowSelectionMode = 'single' | 'multiple'\n\n/** 行选择配置(Phase 19 · groupSelectsChildren) */\nexport interface RowSelectionConfig {\n mode: RowSelectionMode\n /**\n * tree 模式下选中父节点是否级联选中子孙。默认 `true`。\n * 对标 AG Grid rowSelection.groupSelectsChildren。\n */\n groupSelectsChildren?: boolean\n}\n\nexport type RowSelectionInput =\n | RowSelectionMode\n | false\n | RowSelectionConfig\n\nexport interface ResolvedRowSelectionOptions {\n mode: RowSelectionMode | false\n groupSelectsChildren: boolean\n}\n\nexport function normalizeRowSelectionInput(\n input: RowSelectionInput | undefined,\n): ResolvedRowSelectionOptions {\n if (input === false) {\n return { mode: false, groupSelectsChildren: true }\n }\n\n if (input == null) {\n return { mode: 'single', groupSelectsChildren: true }\n }\n\n if (typeof input === 'string') {\n return {\n mode: input === 'multiple' ? 'multiple' : 'single',\n groupSelectsChildren: true,\n }\n }\n\n return {\n mode: input.mode === 'multiple' ? 'multiple' : 'single',\n groupSelectsChildren: input.groupSelectsChildren ?? true,\n }\n}\n\nexport function normalizeRowSelectionMode(\n resolved: ResolvedRowSelectionOptions,\n): RowSelectionMode | false {\n return resolved.mode\n}\n","import type { RowSelectionMode } from '@core/selection/selectionService'\r\nimport {\r\n normalizeRowSelectionInput,\r\n type RowSelectionInput,\r\n} from '@core/types/rowSelectionOptions'\r\n\r\nimport { resolveColumnDefColId } from './indexColumn'\r\nimport type { GridHorizontalAlign, GridVerticalAlign } from '@core/types/align'\r\nimport type { ColumnDef } from '@types'\r\n\r\n/** 系统行选择列 colId;用户 columns 不得占用 */\r\nexport const SELECTION_COLUMN_ID = '__select__'\r\n\r\n/** 行选择列最小宽度 px */\r\nexport const SELECTION_COLUMN_MIN_WIDTH = 40\r\n\r\n/** 行选择列默认宽度 px */\r\nexport const SELECTION_COLUMN_DEFAULT_WIDTH = 40\r\n\r\n/** 表头全选 checkbox 默认 aria-label */\r\nexport const DEFAULT_SELECTION_SELECT_ALL_LABEL = '全选'\r\n\r\n/** 行选择列配置 */\r\nexport interface SelectionColumnOptions {\r\n /** 列宽 px;默认 40;小于 40 时钳制为 40 */\r\n width?: number\r\n /** 表头全选 checkbox 的 aria-label;默认「全选」 */\r\n selectAllLabel?: string\r\n /** 行 checkbox 的 aria-label 工厂 */\r\n rowLabel?: (rowIndex: number) => string\r\n /** 表头水平对齐;默认 center */\r\n headerAlign?: GridHorizontalAlign\r\n /** 表头垂直对齐;默认 center */\r\n headerValign?: GridVerticalAlign\r\n /** 表体水平对齐;默认 center */\r\n align?: GridHorizontalAlign\r\n /** 表体垂直对齐;默认 center */\r\n valign?: GridVerticalAlign\r\n /** footer 水平对齐;默认 center */\r\n footerAlign?: GridHorizontalAlign\r\n /** footer 垂直对齐;默认 center */\r\n footerValign?: GridVerticalAlign\r\n}\r\n\r\n/** Grid 级行选择列配置(块 0 类型;块 1+ 消费) */\r\nexport interface SelectionColumnGridOptions {\r\n /** 行选择列配置;rowSelection !== false 时生效 */\r\n selectionColumn?: SelectionColumnOptions\r\n}\r\n\r\nexport interface ResolvedSelectionColumnOptions {\r\n width: number\r\n selectAllLabel: string\r\n rowLabel?: (rowIndex: number) => string\r\n headerAlign: GridHorizontalAlign\r\n headerValign: GridVerticalAlign\r\n align: GridHorizontalAlign\r\n valign: GridVerticalAlign\r\n footerAlign: GridHorizontalAlign\r\n footerValign: GridVerticalAlign\r\n}\r\n\r\nexport interface ResolvedSelectionColumnGridOptions {\r\n /** rowSelection !== false */\r\n enabled: boolean\r\n /** 行选模式;enabled=false 时为占位 single */\r\n mode: RowSelectionMode\r\n selectionColumn: ResolvedSelectionColumnOptions\r\n}\r\n\r\nexport function resolveSelectionColumnWidth(width?: number): number {\r\n return Math.max(SELECTION_COLUMN_MIN_WIDTH, width ?? SELECTION_COLUMN_DEFAULT_WIDTH)\r\n}\r\n\r\nexport function resolveSelectionColumnOptions(\r\n options: SelectionColumnOptions = {},\r\n): ResolvedSelectionColumnOptions {\r\n return {\r\n width: resolveSelectionColumnWidth(options.width),\r\n selectAllLabel: options.selectAllLabel ?? DEFAULT_SELECTION_SELECT_ALL_LABEL,\r\n rowLabel: options.rowLabel,\r\n headerAlign: options.headerAlign ?? 'center',\r\n headerValign: options.headerValign ?? 'center',\r\n align: options.align ?? 'center',\r\n valign: options.valign ?? 'center',\r\n footerAlign: options.footerAlign ?? 'center',\r\n footerValign: options.footerValign ?? 'center',\r\n }\r\n}\r\n\r\nexport function resolveSelectionColumnGridOptions(\r\n options: {\r\n rowSelection?: RowSelectionInput\r\n selectionColumn?: SelectionColumnOptions\r\n } = {},\r\n): ResolvedSelectionColumnGridOptions {\r\n // Grid 直建时缺省 rowSelection 仍不注入行选择列;MagicGrid 默认传 'single'。\r\n if (options.rowSelection == null) {\r\n return {\r\n enabled: false,\r\n mode: 'single',\r\n selectionColumn: resolveSelectionColumnOptions(options.selectionColumn),\r\n }\r\n }\r\n\r\n const resolved = normalizeRowSelectionInput(options.rowSelection)\r\n const enabled = resolved.mode !== false\r\n\r\n return {\r\n enabled,\r\n mode: enabled && resolved.mode !== false ? resolved.mode : 'single',\r\n selectionColumn: resolveSelectionColumnOptions(options.selectionColumn),\r\n }\r\n}\r\n\r\nexport function isSelectionColumn(colId: string): boolean {\r\n return colId === SELECTION_COLUMN_ID\r\n}\r\n\r\n/** 开发模式:用户 columns 占用系统行选择列 colId 时告警 */\r\nexport function warnIfUserColumnsConflictWithSelectionColumn(\r\n columns: readonly ColumnDef[],\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n columns.forEach((column, index) => {\r\n const colId = resolveColumnDefColId(column, index)\r\n if (colId === SELECTION_COLUMN_ID || column.key === SELECTION_COLUMN_ID) {\r\n console.warn(\r\n `[magic-grid] Column \"${SELECTION_COLUMN_ID}\" is reserved for the system row selection column. ` +\r\n 'Remove it from your columns definition; use rowSelection instead.',\r\n )\r\n }\r\n })\r\n}\r\n","/**\n * 临时行(尚未分配业务主键的新增行)的内部 id 生成与识别。\n *\n * - **格式**:`__MG_TMP__::<uuid>`(例:`__MG_TMP__::550e8400-e29b-41d4-a716-446655440000`)\n * - **写入位置**:仅 `RowNode.id`;**不会**写入 `data[rowKey]`\n * - **对外暴露**:`getData()`、`selectedRowIds`、多数事件的 `rowId` 对临时行投影为 `null`\n * - **消费端获取内部 id**:`addRows` 返回的 `RowNode.id`、`getSelectedRows()` 的 `internalRowId`\n */\n/** 新增行内部临时 ID 前缀(不对用户 data[rowKey] 暴露) */\nexport const TRANSIENT_ROW_ID_PREFIX = '__MG_TMP__::' as const\n\nlet transientRowIdCounter = 0\n\nfunction createFallbackUuid(): string {\n transientRowIdCounter += 1\n return `${Date.now().toString(36)}_${transientRowIdCounter.toString(36)}`\n}\n\n/** 生成表格内部使用的临时 rowId */\nexport function createTransientRowId(): string {\n const uuid =\n typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n ? crypto.randomUUID()\n : createFallbackUuid()\n\n return `${TRANSIENT_ROW_ID_PREFIX}${uuid}`\n}\n\n/** 判断 id 是否为内部临时 rowId */\nexport function isTransientRowId(id: string): boolean {\n return id.startsWith(TRANSIENT_ROW_ID_PREFIX)\n}\n\n/** 业务 rowKey 是否为空(视为尚未分配持久化主键) */\nexport function isMissingBusinessRowKey(value: unknown): boolean {\n return value === null || value === undefined || value === ''\n}\n","import { isTransientRowId } from '@core/rowModel/transientRowId'\nimport type { RowData } from '@types'\nimport type { RowNode } from '@core/types/rowNode'\nimport type { RowId } from '@core/types/rowId'\n\n/** 对外 API / 事件 rowId:与用户 data[rowKey] 同型;临时行无业务主键时为 null */\nexport type BusinessRowId = RowId | null\n\nexport interface BusinessRowIdContext {\n rowKey: string\n getRowById: (internalId: string) => RowNode | undefined\n}\n\n/** 无用户业务主键的合成行(分组头、detail 等) */\nexport function isSyntheticRow(rowNode: RowNode): boolean {\n if (rowNode.group) {\n return true\n }\n\n const kind = rowNode.rowKind\n return kind === 'detail' || kind === 'groupHeader' || kind === 'groupFooter'\n}\n\n/** RowNode → 业务 rowId */\nexport function toBusinessRowId(rowNode: RowNode, rowKey: string): BusinessRowId {\n if (rowNode.isTransient) {\n return null\n }\n\n const raw = rowNode.data[rowKey]\n if (!isSyntheticRow(rowNode) && (typeof raw === 'number' || typeof raw === 'string')) {\n return raw\n }\n\n return rowNode.id\n}\n\n/** 从导出的 row.data 快照解析业务 rowId(rowsRemoved 等行已不在模型中时) */\nexport function toBusinessRowIdFromExportedData(\n data: RowData,\n rowKey: string,\n internalId: string,\n options?: { isTransient?: boolean },\n): BusinessRowId {\n if (options?.isTransient || isTransientRowId(internalId)) {\n return null\n }\n\n const raw = data[rowKey]\n if (typeof raw === 'number' || typeof raw === 'string') {\n return raw\n }\n\n return internalId\n}\n\n/** 内核 rowId → 业务 rowId */\nexport function toBusinessRowIdFromInternal(\n internalId: string,\n ctx: BusinessRowIdContext,\n): BusinessRowId {\n if (isTransientRowId(internalId)) {\n return null\n }\n\n const rowNode = ctx.getRowById(internalId)\n if (rowNode) {\n return toBusinessRowId(rowNode, ctx.rowKey)\n }\n\n return internalId\n}\n\nexport function toBusinessRowIdsFromInternal(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n): BusinessRowId[] {\n return internalIds.map((id) => toBusinessRowIdFromInternal(id, ctx))\n}\n\nexport function createBusinessRowIdResolver(ctx: BusinessRowIdContext) {\n return {\n fromNode: (rowNode: RowNode) => toBusinessRowId(rowNode, ctx.rowKey),\n fromInternal: (internalId: string) => toBusinessRowIdFromInternal(internalId, ctx),\n fromInternalList: (internalIds: readonly string[]) =>\n toBusinessRowIdsFromInternal(internalIds, ctx),\n }\n}\n\nexport function projectValidationResult(\n result: import('@core/types/validation').GridValidationResult,\n ctx: BusinessRowIdContext,\n): import('@core/types/validation').GridValidationResult {\n const resolve = createBusinessRowIdResolver(ctx)\n return {\n ...result,\n cellErrors: result.cellErrors.map((error) => ({\n ...error,\n rowId: resolve.fromInternal(String(error.rowId)),\n })),\n }\n}\n","import type { RowNode } from '@core/types'\nimport type { RowData } from '@types'\n\n/** 将 RowNode 转为对外导出的行数据(浅拷贝) */\nexport function toUserRowData(rowNode: RowNode, rowKey: string): RowData {\n const exported: RowData = { ...rowNode.data }\n\n if (rowNode.isTransient) {\n exported[rowKey] = null\n }\n\n return exported\n}\n\n/** 批量导出 RowNode 数组为用户行数据 */\nexport function exportRowData(rows: readonly RowNode[], rowKey: string): RowData[] {\n return rows.map((row) => toUserRowData(row, rowKey))\n}\n","/**\n * 行「双 ID」投影:快照构建与 mutation API 可用的 id 列表工具。\n *\n * ## 为什么有两套 id?\n *\n * | | 持久化行 | 临时行(新增、`id` 为 null/省略) |\n * |---|---------|--------------------------------|\n * | 业务 id | `data[rowKey]`、`rowId` | 恒 `null` |\n * | 内核 id | `internalRowId` ≈ `String(rowId)` | `__MG_TMP__::*` |\n *\n * 事件里的 `*RowIds` 为业务投影(临时行 `null`,仅适合展示)。\n *\n * ## 消费端速查\n *\n * | 场景 | 读快照 | 传给 API 的 id |\n * |------|--------|----------------|\n * | checkbox 选中(单行) | `selectedRows[i]` | `generateRowId(row)` |\n * | checkbox 选中(多行) | `selectedRows` | `generateSelectedRowIds(rows)` 或 `api.removeSelectedRows()` |\n * | 索引 focus(单行) | `focusedRows[i]` | `generateRowId(row)` |\n * | 索引 focus(多行) | `focusedRows` | `generateFocusedRowIds(rows)` 或 `api.getIndexFocusedRowIds()` |\n *\n * **规则**:持久化行 → 业务 `rowId`;临时行 → `internalRowId`(`__MG_TMP__::*`)。\n *\n * ## `RowListOptions.mode`(默认 `'all'`)\n *\n * | mode | 含义 |\n * |------|------|\n * | `'all'` | 持久化 + 临时(mutation 时:持久化→业务 id,临时→`internalRowId`) |\n * | `'business'` | 仅持久化行 |\n * | `'temp'` | 仅临时行 |\n */\nimport { toUserRowData } from '@core/rowModel/rowDataExport'\nimport { isTransientRowId } from '@core/rowModel/transientRowId'\nimport type { RowData } from '@types'\n\nimport {\n createBusinessRowIdResolver,\n type BusinessRowId,\n type BusinessRowIdContext,\n} from './businessRowId'\nimport type { RowId } from './rowId'\n\n/** 行列表过滤模式(选中 / focus 共用) */\nexport type RowListMode = 'all' | 'business' | 'temp'\n\nexport interface RowListOptions {\n /** @default 'all' */\n mode?: RowListMode\n}\n\n/** checkbox 选中:`generateSelectedRowIds` 入参 */\nexport type GenerateSelectedRowIdsOptions = RowListOptions\n\n/** 索引 focus:`generateFocusedRowIds` 入参(与 {@link GenerateSelectedRowIdsOptions} 相同) */\nexport type GenerateFocusedRowIdsOptions = RowListOptions\n\n/**\n * 行快照——`getSelectedRows` / `getIndexFocusedRows` /\n * `selectionChanged.selectedRows` / `indexFocusChanged.focusedRows` 共用。\n */\nexport interface SelectedRowSnapshot<TData = RowData> {\n /** 业务主键;临时行恒 `null` */\n rowId: BusinessRowId\n /** 内核 rowId;临时行为 `__MG_TMP__::*` */\n internalRowId: string\n isTransient: boolean\n rowIndex: number\n /** 与 `api.getData()` 导出规则一致 */\n data: TData\n}\n\n/** @internal internal id 列表 → 行快照 */\nexport function buildSelectedRowSnapshots(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n): SelectedRowSnapshot[] {\n const resolve = createBusinessRowIdResolver(ctx)\n const snapshots: SelectedRowSnapshot[] = []\n\n for (const internalRowId of internalIds) {\n const rowNode = ctx.getRowById(internalRowId)\n if (!rowNode) {\n continue\n }\n\n snapshots.push({\n rowId: resolve.fromNode(rowNode),\n internalRowId,\n isTransient: rowNode.isTransient === true || isTransientRowId(internalRowId),\n rowIndex: rowNode.rowIndex,\n data: toUserRowData(rowNode, ctx.rowKey),\n })\n }\n\n return snapshots\n}\n\nfunction isSnapshotArray(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n): rows is readonly SelectedRowSnapshot[] {\n return Array.isArray(rows)\n}\n\nfunction normalizeSnapshots(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n): readonly SelectedRowSnapshot[] {\n if (isSnapshotArray(rows)) {\n return rows\n }\n\n const singleRow: SelectedRowSnapshot = rows\n return [singleRow]\n}\n\nfunction isUsableBusinessRowId(rowId: BusinessRowId): rowId is RowId {\n return rowId !== null\n}\n\nfunction filterSnapshotsByMode(\n rows: readonly SelectedRowSnapshot[],\n mode: RowListMode,\n): SelectedRowSnapshot[] {\n if (mode === 'all') {\n return [...rows]\n }\n\n if (mode === 'business') {\n return rows.filter((row) => !row.isTransient && isUsableBusinessRowId(row.rowId))\n }\n\n return rows.filter((row) => row.isTransient)\n}\n\n/** 持久化行 → 业务 id;临时行 → internalRowId;无业务 id 时返回 `null` */\nfunction resolveMutationRowId(row: SelectedRowSnapshot): RowId | null {\n if (row.isTransient) {\n return row.internalRowId\n }\n\n if (isUsableBusinessRowId(row.rowId)) {\n return row.rowId\n }\n\n return null\n}\n\n/** 持久化行 → 业务 id;临时行 → internalRowId */\nfunction projectRowIdsFromSnapshots(rows: readonly SelectedRowSnapshot[]): RowId[] {\n const result: RowId[] = []\n\n for (const row of rows) {\n const id = resolveMutationRowId(row)\n if (id != null) {\n result.push(id)\n }\n }\n\n return result\n}\n\n/**\n * 单行快照 → `removeRows` / `moveRows` / `getRowType` 等 API 可用的 id。\n *\n * - 持久化行 → 业务 `rowId`\n * - 临时行 → `internalRowId`(`__MG_TMP__::*`)\n *\n * @example\n * ```ts\n * api.on('indexFocusChanged', (event) => {\n * const id = generateRowId(event.focusedRows[0])\n * api.getRowType(id)\n * })\n * ```\n */\nexport function generateRowId(row: SelectedRowSnapshot): RowId {\n return resolveMutationRowId(row) ?? row.internalRowId\n}\n\n/**\n * checkbox 选中行 → `removeRows` / `moveRows` 可用的 id 列表。\n *\n * @example\n * ```ts\n * gridApi.on('selectionChanged', async (event) => {\n * await api.removeRows({ rowIds: generateSelectedRowIds(event.selectedRows) })\n * })\n * ```\n */\nexport function generateSelectedRowIds(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n options: RowListOptions = {},\n): RowId[] {\n const filtered = filterSnapshotsByMode(normalizeSnapshots(rows), options.mode ?? 'all')\n return projectRowIdsFromSnapshots(filtered)\n}\n\n/**\n * 索引 focus 行 → `moveRows` 可用的 id 列表(规则同 {@link generateSelectedRowIds})。\n *\n * @example\n * ```ts\n * gridApi.on('indexFocusChanged', (event) => {\n * api.moveRows({ rowIds: generateFocusedRowIds(event.focusedRows), toIndex: 0 })\n * })\n * ```\n */\nexport function generateFocusedRowIds(\n rows: SelectedRowSnapshot | readonly SelectedRowSnapshot[],\n options: RowListOptions = {},\n): RowId[] {\n return generateSelectedRowIds(rows, options)\n}\n\n/** @internal `getIndexFocusedRows` 实现 */\nexport function buildIndexFocusRowSnapshots(\n internalIds: readonly string[],\n ctx: BusinessRowIdContext,\n options: RowListOptions = {},\n): SelectedRowSnapshot[] {\n return filterSnapshotsByMode(\n buildSelectedRowSnapshots(internalIds, ctx),\n options.mode ?? 'all',\n )\n}\n","import { isIndexColumn } from '@core/types/indexColumn'\r\nimport { isSelectionColumn } from '@core/types/selectionColumn'\r\nimport { isBuiltInCellEditor } from '@core/types/cellEditor'\r\n\r\n/** 单元格编辑器呈现模式:overlay 进入编辑态;inline 常驻格内 */\r\nexport type CellEditorMode = 'overlay' | 'inline'\r\n\r\n/** 缺省 overlay,与 Phase 3 行为一致 */\r\nexport const DEFAULT_CELL_EDITOR_MODE: CellEditorMode = 'overlay'\r\n\r\n/** 解析列级 cellEditorMode;缺省 overlay */\r\nexport function resolveCellEditorMode(mode?: CellEditorMode): CellEditorMode {\r\n if (mode === 'inline') {\r\n return 'inline'\r\n }\r\n return DEFAULT_CELL_EDITOR_MODE\r\n}\r\n\r\n/** 系统列强制 overlay;用户列解析 cellEditorMode */\r\nexport function resolveColumnCellEditorMode(\r\n colId: string,\r\n mode?: CellEditorMode,\r\n): CellEditorMode {\r\n if (isIndexColumn(colId) || isSelectionColumn(colId)) {\r\n return DEFAULT_CELL_EDITOR_MODE\r\n }\r\n return resolveCellEditorMode(mode)\r\n}\r\n\r\n/** 是否为 inline 常驻编辑器列(须配置 cellEditor;系统列恒 false) */\r\nexport function isInlineEditorColumn(column: {\r\n colId: string\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n}): boolean {\r\n if (isIndexColumn(column.colId) || isSelectionColumn(column.colId)) {\r\n return false\r\n }\r\n\r\n if (resolveCellEditorMode(column.cellEditorMode) !== 'inline') {\r\n return false\r\n }\r\n\r\n return column.cellEditor != null\r\n}\r\n\r\n/** 开发模式:inline 误配告警 */\r\nexport function warnIfInlineEditorMisconfigured(\r\n colId: string,\r\n options: {\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n },\r\n): void {\r\n if (!import.meta.env.DEV) {\r\n return\r\n }\r\n\r\n const isSystem = isIndexColumn(colId) || isSelectionColumn(colId)\r\n\r\n if (isSystem && options.cellEditorMode === 'inline') {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" is a system column and cannot use cellEditorMode: 'inline'. ` +\r\n 'Inline editors apply to user data columns only.',\r\n )\r\n return\r\n }\r\n\r\n if (options.cellEditorMode === 'inline' && options.cellEditor == null) {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" has cellEditorMode: 'inline' but no cellEditor. ` +\r\n 'Configure cellEditor (e.g. \"checkbox\") or remove inline mode.',\r\n )\r\n }\r\n}\r\n\r\nconst INLINE_NATIVE_EDITORS = new Set(['text', 'number', 'checkbox', 'switch'])\r\n\r\n/** 开发模式:inline 列使用可能依赖 overlay/teleport 的编辑器时告警 */\r\nexport function warnIfInlineOverlayEditor(\r\n colId: string,\r\n options: {\r\n cellEditorMode?: CellEditorMode\r\n cellEditor?: unknown\r\n },\r\n): void {\r\n if (!import.meta.env.DEV || options.cellEditorMode !== 'inline') {\r\n return\r\n }\r\n\r\n const editor = options.cellEditor\r\n if (editor == null) {\r\n return\r\n }\r\n\r\n if (typeof editor === 'function') {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" uses cellEditorMode: 'inline' with a custom editor function. ` +\r\n 'Inline editors must not use overlay/teleport; prefer checkbox, switch, text, or number.',\r\n )\r\n return\r\n }\r\n\r\n if (typeof editor === 'string' && !INLINE_NATIVE_EDITORS.has(editor) && !isBuiltInCellEditor(editor)) {\r\n console.warn(\r\n `[magic-grid] Column \"${colId}\" uses cellEditorMode: 'inline' with editor \"${editor}\" ` +\r\n 'which may require an overlay surface. Prefer \"checkbox\", \"switch\", \"text\", or \"number\" for inline columns.',\r\n )\r\n }\r\n}\r\n","/**\n * Cell Editor Cache — 类型与纯函数(Phase 42 / M35)\n *\n * 职责:Grid/列 opt-in 开关解析、存储键规则、是否向 overlay 列注入 API。\n * 可变状态与 LRU 在 {@link CellEditorCacheService}(`cellEditorCacheService.ts`)。\n *\n * 存储键:`${rowPart}::${colId}::${resolvedKey}`\n * - rowPart:业务 rowId 字符串;transient 行为 `\\0${internalRowId}`\n * - resolvedKey:消费方 key + 可选列级 namespace 前缀\n */\nimport type { BusinessRowId } from '@core/types/businessRowId'\nimport type { CellEditorMode } from '@core/types/cellEditorMode'\nimport { isInlineEditorColumn } from '@core/types/cellEditorMode'\n\n/** 消费方未传 key 且列无 string namespace 时的默认 slot */\nexport const DEFAULT_CELL_EDITOR_CACHE_KEY = 'default'\n\n/** 列级 flag:`true` 启用 · `string` 固定 namespace · `false` 全局开启时 opt-out */\nexport type CellEditorCacheColumnFlag = boolean | string\n\n/** Grid 级配置(MagicGrid `enableCellEditorCache` / `cellEditorCacheMaxEntries`) */\nexport interface CellEditorCacheGridOptions {\n /**\n * 为所有 overlay 列注入 get/set/clear API。\n * 默认 false(零开销);列级 `cellEditorCache: false` 可显式 opt-out。\n */\n enableCellEditorCache?: boolean\n\n /**\n * 会话 cache 最大 **cell bucket** 数 `(rowId,colId)`;超出 LRU 淘汰。\n * 默认不限。\n */\n cellEditorCacheMaxEntries?: number\n}\n\nexport interface ResolvedCellEditorCacheGridOptions {\n enableCellEditorCache: boolean\n cellEditorCacheMaxEntries: number | undefined\n}\n\nexport function resolveCellEditorCacheGridOptions(\n options: CellEditorCacheGridOptions = {},\n): ResolvedCellEditorCacheGridOptions {\n const maxEntries = options.cellEditorCacheMaxEntries\n return {\n enableCellEditorCache: options.enableCellEditorCache ?? false,\n cellEditorCacheMaxEntries:\n maxEntries != null && Number.isFinite(maxEntries) && maxEntries > 0\n ? Math.floor(maxEntries)\n : undefined,\n }\n}\n\n/**\n * 存储键 rowId 段。\n * transient 行业务 id 为 null,须传 internalRowId 以免多行新增互相覆盖。\n */\nexport function buildCellEditorCacheRowPart(\n rowId: BusinessRowId,\n internalRowId?: string,\n): string {\n if (rowId !== null) {\n return String(rowId)\n }\n if (internalRowId) {\n return `\\0${internalRowId}`\n }\n return '\\0transient'\n}\n\n/** 完整 Map 键:`rowPart::colId::key` */\nexport function buildCellEditorCacheStorageKey(\n rowId: BusinessRowId,\n colId: string,\n key: string = DEFAULT_CELL_EDITOR_CACHE_KEY,\n options?: { internalRowId?: string },\n): string {\n const rowPart = buildCellEditorCacheRowPart(rowId, options?.internalRowId)\n return `${rowPart}::${colId}::${key}`\n}\n\n/** LRU 粒度:同一格 `(rowId,colId)` 下所有 namespace key 共用一个 bucket */\nexport function buildCellEditorCacheBucketKey(\n rowId: BusinessRowId,\n colId: string,\n options?: { internalRowId?: string },\n): string {\n const rowPart = buildCellEditorCacheRowPart(rowId, options?.internalRowId)\n return `${rowPart}::${colId}`\n}\n\nexport interface ResolveCellEditorCacheKeyOptions {\n userKey?: string\n columnCellEditorCache?: CellEditorCacheColumnFlag\n}\n\n/**\n * 消费方 key → 存储层 key。\n * 列级 `cellEditorCache: 'part'` 时:`getCellCache()` → `part`;`getCellCache('options')` → `part::options`。\n */\nexport function resolveCellEditorCacheKey(\n options: ResolveCellEditorCacheKeyOptions = {},\n): string {\n const { userKey, columnCellEditorCache } = options\n const namespace =\n typeof columnCellEditorCache === 'string' ? columnCellEditorCache : undefined\n\n if (userKey != null && userKey !== '') {\n return namespace ? `${namespace}::${userKey}` : userKey\n }\n\n if (namespace) {\n return namespace\n }\n\n return DEFAULT_CELL_EDITOR_CACHE_KEY\n}\n\nexport interface ShouldInjectCellEditorCacheApiOptions {\n enableCellEditorCache: boolean\n colId: string\n cellEditorMode?: CellEditorMode\n cellEditor?: unknown\n columnCellEditorCache?: CellEditorCacheColumnFlag\n}\n\n/** inline 列、列级 false、或未开启全局开关 → 不注入(CellEditorParams 上无 cache 方法) */\nexport function shouldInjectCellEditorCacheApi(\n options: ShouldInjectCellEditorCacheApiOptions,\n): boolean {\n if (\n isInlineEditorColumn({\n colId: options.colId,\n cellEditorMode: options.cellEditorMode,\n cellEditor: options.cellEditor,\n })\n ) {\n return false\n }\n\n if (options.columnCellEditorCache === false) {\n return false\n }\n\n if (\n options.columnCellEditorCache === true ||\n typeof options.columnCellEditorCache === 'string'\n ) {\n return true\n }\n\n return options.enableCellEditorCache\n}\n","import type { RowDragCommitContext, RowHierarchyChange } from '@core/types/rowDrag'\n\n/** {@link getRowDragCommitHierarchy} 过滤模式 */\nexport type GetRowDragCommitHierarchyOption = 'default' | 'noLevel'\n\nfunction hasParentOrSiblingChange(change: RowHierarchyChange): boolean {\n return (\n change.previousParentRowId !== change.parentRowId ||\n change.previousSiblingIndex !== change.siblingIndex\n )\n}\n\n/**\n * 从 deferred row drag commit 上下文中提取树形层级变更列表。\n *\n * - `default`:返回 `context.hierarchyChanges` 的浅拷贝(含 `treeLevel` 及仅 level 变化的项)。\n * - `noLevel`:仅保留 **parentRowId 或 siblingIndex** 相对变更前发生变化的项,\n * 排除「parent / sibling 均未变、仅 treeLevel 不同」的条目。\n *\n * 对接后端 `parentId` + `order` 持久化时,通常使用 `noLevel`。\n *\n * @example\n * ```ts\n * import { getRowDragCommitHierarchy } from '@taocompany/magic-grid'\n *\n * const toPersist = getRowDragCommitHierarchy(context, 'noLevel')\n * for (const item of toPersist) {\n * await api.update({ id: item.rowId, parentId: item.parentRowId, order: item.siblingIndex })\n * }\n * ```\n */\nexport function getRowDragCommitHierarchy(\n context: RowDragCommitContext,\n option: GetRowDragCommitHierarchyOption = 'default',\n): RowHierarchyChange[] {\n const changes = context.hierarchyChanges ?? []\n\n if (option === 'default') {\n return [...changes]\n }\n\n return changes.filter(hasParentOrSiblingChange)\n}\n"],"mappings":"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"}