@taocompany/magic-grid 0.9.8 → 0.9.10

package/dist/core/types/rowMutation.d.ts

@@ -42,6 +42,46 @@ export interface AddRowsByArrayOptions {
     /** 排序执行顺序，默认 'desc' */
     order?: AddRowsByArrayInsertOrder;
 }
+/** {@link GridApi.addGroupRows} / addGroupRowsByArray 目标分组（groupId 与 groupPath 二选一） */
+export type AddGroupRowsTarget = {
+    groupId: string;
+} | {
+    groupPath: readonly {
+        field: string;
+        key: string;
+    }[];
+};
+export interface AddGroupRowsOptions {
+    /** 目标分组（groupId 或 groupPath 二选一） */
+    target: AddGroupRowsTarget;
+    rows: AddRowItem[];
+    /**
+     * 组内 leaf 插入下标；省略 = 追加到该组末。
+     * 0 = 组内首位。坐标系同 moveUp/moveDown（collation 后 source 子序列）。
+     * 配置 `groupSortKey` 时由 applyTransaction 在 collation 前 sync 字段，保留组内位。
+     */
+    index?: number;
+    /** 下标基准，默认 'source' */
+    indexMode?: RowIndexMode;
+}
+/** {@link GridApi.addGroupRowsByArray} 单项：目标分组 + 组内 index + 行数据 */
+export interface AddGroupRowByArrayItem {
+    /** 目标分组 */
+    target: AddGroupRowsTarget;
+    /** 组内 leaf 插入下标；省略时按同组已占用下标续编 */
+    index?: number;
+    row: RowData;
+}
+/**
+ * {@link GridApi.addGroupRowsByArray} 配置项。
+ * index 规范化在读取 options 之前完成，与 order / indexMode 无关。
+ */
+export interface AddGroupRowsByArrayOptions {
+    /** 下标基准，默认 'source' */
+    indexMode?: RowIndexMode;
+    /** 排序执行顺序，默认 'desc' */
+    order?: AddRowsByArrayInsertOrder;
+}
 export interface RemoveRowsOptions {
     /** 内部 rowId 或业务 rowKey 值（number / string） */
     rowIds?: RowId[];

package/dist/core/types/rowMutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rowMutation.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowMutation.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,gGAAgG;AAChG,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,KAAK,CAAA;AAEtD,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,GAAG,EAAE,OAAO,CAAA;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,uBAAuB;IACvB,KAAK,CAAC,EAAE,yBAAyB,CAAA;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,CAAC,EAAE,YAAY,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAA;IACb,kDAAkD;IAClD,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,EAAE,CAAA;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO;IAC9C,GAAG,EAAE,OAAO,uBAAuB,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IACvD,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,KAAK,EAAE,KAAK,CAAA;IACZ,4CAA4C;IAC5C,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC,iCAAiC;AACjC,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,KAAK,EAAE,aAAa,CAAA;IACpB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;CACd"}
+{"version":3,"file":"rowMutation.d.ts","sourceRoot":"","sources":["../../../src/core/types/rowMutation.ts"],"names":[],"mappings":"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"}