@taocompany/magic-grid 0.1.0

package/dist/core/editing/cellEditorHost.d.ts

@@ -0,0 +1,29 @@
+import { Column } from '../types';
+import { CellEditorDef, CellEditorFn, CellEditorParams } from '../types/cellEditor';
+export interface CellEditorHostOptions {
+    onUnmountEditor?: (mountEl: HTMLElement) => void;
+    /** Grid 实例级命名编辑器（优先于全局注册表） */
+    byName?: Record<string, CellEditorFn>;
+}
+export interface CellEditorResolveContext {
+    byName?: Record<string, CellEditorFn>;
+}
+export interface MountedCellEditor {
+    mountEl: HTMLElement;
+    getValue(): string;
+    getFocusTarget(): HTMLElement | null;
+    destroy(): void;
+}
+/** 解析列配置的编辑器引用为可执行函数 */
+export declare function resolveCellEditor(editor: CellEditorDef | undefined, ctx?: CellEditorResolveContext): CellEditorFn;
+/** 挂载 / 卸载单元格编辑器 DOM 或 Vue 组件 */
+export declare class CellEditorHost {
+    private readonly onUnmountEditor?;
+    private readonly instanceEditors;
+    constructor(options?: CellEditorHostOptions);
+    register(name: string, editor: CellEditorFn): void;
+    unregister(name: string): boolean;
+    has(name: string): boolean;
+    mount(rowElement: HTMLElement, column: Column, params: CellEditorParams, editor: CellEditorDef | undefined): MountedCellEditor;
+}
+//# sourceMappingURL=cellEditorHost.d.ts.map

package/dist/core/editing/cellEditorHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellEditorHost.d.ts","sourceRoot":"","sources":["../../../src/core/editing/cellEditorHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,wBAAwB,CAAA;AAO/B,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAChD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,IAAI,MAAM,CAAA;IAClB,cAAc,IAAI,WAAW,GAAG,IAAI,CAAA;IACpC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAwB;AACxB,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,GAAG,GAAE,wBAA6B,GACjC,YAAY,CA0Bd;AAED,iCAAiC;AACjC,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAgC;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;gBAElD,OAAO,GAAE,qBAA0B;IAK/C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAQlD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,KAAK,CACH,UAAU,EAAE,WAAW,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,iBAAiB;CA0FrB"}

package/dist/core/editing/cellEditorRegistry.d.ts

@@ -0,0 +1,16 @@
+import { CellEditorFn } from '../types/cellEditor';
+/** 全局注册命名编辑器（跨 Grid 实例共享） */
+export declare function registerCellEditor(name: string, editor: CellEditorFn): void;
+/** 全局注销命名编辑器 */
+export declare function unregisterCellEditor(name: string): boolean;
+/** 读取全局命名编辑器 */
+export declare function getCellEditor(name: string): CellEditorFn | undefined;
+/** 是否已全局注册 */
+export declare function hasCellEditor(name: string): boolean;
+/** 列出全局已注册名称（测试 / 调试） */
+export declare function getRegisteredCellEditorNames(): string[];
+/** 清空全局注册表（测试用） */
+export declare function clearCellEditorRegistry(): void;
+/** 合并 Grid 实例级与全局注册表解析命名编辑器 */
+export declare function resolveNamedCellEditor(name: string, instanceEditors?: Record<string, CellEditorFn>): CellEditorFn | undefined;
+//# sourceMappingURL=cellEditorRegistry.d.ts.map

package/dist/core/editing/cellEditorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellEditorRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/editing/cellEditorRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAM3E;AAED,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpE;AAED,cAAc;AACd,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,yBAAyB;AACzB,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAED,mBAAmB;AACnB,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,+BAA+B;AAC/B,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAM,GACjD,YAAY,GAAG,SAAS,CAE1B"}

package/dist/core/editing/cellValidation.d.ts

@@ -0,0 +1,11 @@
+import { Column } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { CellValidationOutcome, RowValidator, RowValidatorParams, RowValidationResult, ValidationErrors } from '../types/validation';
+export declare function normalizeValidationErrors(errors: ValidationErrors): string[] | null;
+export declare function normalizeRowValidationResult(raw: ValidationErrors | RowValidationResult): RowValidationResult | null;
+/** 行级错误未指定 colIds 时的兜底：优先 min/max 跨字段列 */
+export declare function resolveRowValidationColIds(availableColIds: readonly string[], explicitColIds?: readonly string[]): string[];
+export declare function validateCellEdit(column: Pick<Column, 'cellValidator'>, params: CellEditorParams, parsedValue: unknown, signal: AbortSignal): Promise<string[] | null>;
+export declare function validateRowEdit(validator: RowValidator | undefined, params: RowValidatorParams): Promise<RowValidationResult | null>;
+export declare function runCellValidationForEditor(column: Pick<Column, 'cellValidator'>, params: CellEditorParams, parsedValue: unknown, signal?: AbortSignal): Promise<CellValidationOutcome>;
+//# sourceMappingURL=cellValidation.d.ts.map

package/dist/core/editing/cellValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cellValidation.d.ts","sourceRoot":"","sources":["../../../src/core/editing/cellValidation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,wBAAwB,CAAA;AAE/B,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,GAAG,IAAI,CAenF;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,GAC1C,mBAAmB,GAAG,IAAI,CAuB5B;AAED,0CAA0C;AAC1C,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,SAAS,MAAM,EAAE,EAClC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GACjC,MAAM,EAAE,CAWV;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAsB1B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAiBrC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAOhC"}

package/dist/core/editing/editCommitContext.d.ts

@@ -0,0 +1,21 @@
+/** 编辑会话阶段 */
+export type EditSessionPhase = 'idle' | 'editing' | 'committing' | 'cancelling';
+/** 单次提交上下文：abort 与 commitId 防竞态 */
+export interface EditCommitContext {
+    signal: AbortSignal;
+    commitId: number;
+}
+export declare class EditCommitAbortedError extends Error {
+    readonly name = "EditCommitAbortedError";
+    constructor(message?: string);
+}
+export declare function isEditCommitAborted(error: unknown): error is EditCommitAbortedError;
+export interface EditCommitController {
+    context: EditCommitContext;
+    abort: () => void;
+}
+/** 创建新的提交控制器；若传入 previous 则先 abort */
+export declare function createEditCommitController(commitId: number, previous?: EditCommitController | null): EditCommitController;
+export declare function throwIfAborted(signal: AbortSignal): void;
+export declare function onceAborted(signal: AbortSignal): Promise<never>;
+//# sourceMappingURL=editCommitContext.d.ts.map

package/dist/core/editing/editCommitContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editCommitContext.d.ts","sourceRoot":"","sources":["../../../src/core/editing/editCommitContext.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAA;AAE/E,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,4BAA2B;gBAE5B,OAAO,SAAwB;CAG5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAEnF;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,sCAAsC;AACtC,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACrC,oBAAoB,CAiBtB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIxD;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAarE"}

package/dist/core/editing/editorSurface.d.ts

@@ -0,0 +1,9 @@
+/** 注册第三方编辑器浮层选择器（如 Element Plus popper） */
+export declare function registerEditorSurfaceSelectors(selectors: readonly string[]): void;
+/** 测试重置 */
+export declare function resetEditorSurfaceSelectors(): void;
+/** 事件目标是否位于编辑器宿主或已注册的浮层内 */
+export declare function isInsideEditorSurface(target: EventTarget | null): boolean;
+/** document.activeElement 是否仍在编辑表面内 */
+export declare function isFocusInsideEditorSurface(activeElement?: Element | null): boolean;
+//# sourceMappingURL=editorSurface.d.ts.map

package/dist/core/editing/editorSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorSurface.d.ts","sourceRoot":"","sources":["../../../src/core/editing/editorSurface.ts"],"names":[],"mappings":"AAIA,2CAA2C;AAC3C,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAEjF;AAED,WAAW;AACX,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAkBD,4BAA4B;AAC5B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAOzE;AAED,uCAAuC;AACvC,wBAAgB,0BAA0B,CAAC,aAAa,GAAE,OAAO,GAAG,IAA6B,GAAG,OAAO,CAE1G"}

package/dist/core/editing/gridValidation.d.ts

@@ -0,0 +1,21 @@
+import { CellDisableContext } from './cellDisablePipeline';
+import { ValidationFeedbackService } from './validationFeedback';
+import { ColumnModel } from '../column/columnModel';
+import { ClientSideRowModel } from '../rowModel/clientSideRowModel';
+import { RowNode } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { GridValidationResult, RowValidator, ValidateCellsOptions, ValidateGridOptions } from '../types/validation';
+export interface ValidateGridDeps {
+    mountEl: HTMLElement;
+    rowModel: ClientSideRowModel;
+    columnModel: ColumnModel;
+    rowValidator?: RowValidator;
+    validationFeedback: ValidationFeedbackService;
+    createEditorParams: (rowNode: RowNode, column: import('../types').Column) => CellEditorParams;
+    getCellDisableContext?: () => CellDisableContext;
+}
+/** 校验表格持久化数据（全表或指定行），并可选更新 invalid 视觉反馈 */
+export declare function validateGridRows(deps: ValidateGridDeps, options?: ValidateGridOptions): Promise<GridValidationResult>;
+/** 校验指定单元格（不跑 rowValidator），并可选更新 invalid 视觉反馈 */
+export declare function validateGridCells(deps: ValidateGridDeps, options: ValidateCellsOptions): Promise<GridValidationResult>;
+//# sourceMappingURL=gridValidation.d.ts.map

package/dist/core/editing/gridValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridValidation.d.ts","sourceRoot":"","sources":["../../../src/core/editing/gridValidation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAI3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAEV,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,wBAAwB,CAAA;AAI/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,kBAAkB,EAAE,yBAAyB,CAAA;IAC7C,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,aAAa,EAAE,MAAM,KAAK,gBAAgB,CAAA;IAChG,qBAAqB,CAAC,EAAE,MAAM,kBAAkB,CAAA;CACjD;AAED,2CAA2C;AAC3C,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAgD/B;AAED,kDAAkD;AAClD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAqD/B"}

package/dist/core/editing/index.d.ts

@@ -0,0 +1,20 @@
+export { CellEditingService } from './cellEditingService';
+export { RowEditingService } from './rowEditingService';
+export type { RowEditBatchCommitResult, RowEditCommitFailedResult, RowEditCommitHandler, RowEditCommitHandlerResult, } from './rowEditingService';
+export { commitRowEditCells } from './rowEditCommit';
+export type { RowEditCommitCell, RowEditCommitChange, RowEditCommitResult } from './rowEditCommit';
+export { CellEditorHost, resolveCellEditor } from './cellEditorHost';
+export { textCellEditor, numberCellEditor, checkboxCellEditor, INLINE_CHECKBOX_CLASS } from './builtInEditors';
+export { coerceCheckboxEditorValue, formatCheckboxEditorRawValue, readCheckboxControlValue, } from './builtInEditors';
+export { readCellEditorControlValue } from './readCellEditorValue';
+export { clearCellEditorRegistry, getCellEditor, getRegisteredCellEditorNames, hasCellEditor, registerCellEditor, resolveNamedCellEditor, unregisterCellEditor, } from './cellEditorRegistry';
+export { CELL_EDIT_REJECTED, applyCellEditValue, applyCellEditValueSync, isCellEditable, isCellEditRejected, isRowEditMode, parseCellEditValue, resolveEditSettings, resolveEditType, } from './cellEditPipeline';
+export { createCellDisableContext, evaluateCellDisabled, evaluateIsRowDisabled, setCellDisableContextIsRowDisabled, toCellDisableRowNode, } from './cellDisablePipeline';
+export type { CellDisableColumn, CellDisableContext, CellDisableRowNode, } from './cellDisablePipeline';
+export type { ParsedCellEditValue } from './cellEditPipeline';
+export type { CommitEditResult, CellEditCommitHandlerResult, EditingCell } from './cellEditingService';
+export type { EditCommitContext, EditSessionPhase } from './editCommitContext';
+export { EditCommitAbortedError, isEditCommitAborted } from './editCommitContext';
+export type { EditingRow, EditingRowCell, RowEditCellStopResult, RowEditColumnContext, RowEditStopResult, StartRowEditingOptions, } from './rowEditingService';
+export type { CellEditorHostOptions, MountedCellEditor } from './cellEditorHost';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/editing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/editing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC9G,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,4BAA4B,EAC5B,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kCAAkC,EAClC,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACtG,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACjF,YAAY,EACV,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/core/editing/inlineCellCommit.d.ts

@@ -0,0 +1,22 @@
+import { EventBus } from '../event/eventBus';
+import { RowNode, RowNodeTransaction, RowTransaction, Column } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { InvalidEditValueMode } from '../types/validation';
+export interface InlineCellCommitDeps {
+    eventBus: EventBus;
+    applyTransaction: (transaction: RowTransaction) => RowNodeTransaction;
+    syncPinnedRows: () => void;
+    invalidEditValueMode: InvalidEditValueMode;
+}
+export type InlineCellCommitResult = {
+    ok: true;
+    newValue: unknown;
+} | {
+    ok: false;
+    revert?: boolean;
+} | {
+    ok: 'aborted';
+};
+/** inline 编辑器改值提交（无编辑会话；复用 valueParser / 校验 / valueSetter） */
+export declare function commitInlineCellEdit(deps: InlineCellCommitDeps, rowNode: RowNode, column: Column, rawValue: string, editorParams: CellEditorParams, oldValue: unknown, signal: AbortSignal): Promise<InlineCellCommitResult>;
+//# sourceMappingURL=inlineCellCommit.d.ts.map

package/dist/core/editing/inlineCellCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineCellCommit.d.ts","sourceRoot":"","sources":["../../../src/core/editing/inlineCellCommit.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAA;IAClB,gBAAgB,EAAE,CAAC,WAAW,EAAE,cAAc,KAAK,kBAAkB,CAAA;IACrE,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,oBAAoB,EAAE,oBAAoB,CAAA;CAC3C;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,SAAS,CAAA;CAAE,CAAA;AAErB,8DAA8D;AAC9D,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,sBAAsB,CAAC,CAkDjC"}

package/dist/core/editing/inlineCellEditorHost.d.ts

@@ -0,0 +1,21 @@
+import { Column } from '../types';
+import { CellEditorDef, CellEditorFn, CellEditorParams } from '../types/cellEditor';
+export interface InlineCellEditorHostOptions {
+    onUnmountEditor?: (mountEl: HTMLElement) => void;
+    byName?: Record<string, CellEditorFn>;
+}
+export interface MountedInlineCellEditor {
+    mountEl: HTMLElement;
+    getValue(): string;
+    getFocusTarget(): HTMLElement | null;
+    destroy(): void;
+}
+/** 常驻单元格编辑器宿主：直接挂载到 `.mg-cell__inline-editor` */
+export declare class InlineCellEditorHost {
+    private readonly onUnmountEditor?;
+    private readonly instanceEditors;
+    constructor(options?: InlineCellEditorHostOptions);
+    mount(mountEl: HTMLElement, column: Pick<Column, 'cellEditor'>, params: CellEditorParams): MountedInlineCellEditor;
+}
+export declare function resolveInlineEditorRenderKey(valueCacheVersion: number, rowId: string, colId: string, rawValue: unknown, editable: boolean, cellDisabled: boolean, editor: CellEditorDef | undefined): string;
+//# sourceMappingURL=inlineCellEditorHost.d.ts.map

package/dist/core/editing/inlineCellEditorHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineCellEditorHost.d.ts","sourceRoot":"","sources":["../../../src/core/editing/inlineCellEditorHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,wBAAwB,CAAA;AAK/B,MAAM,WAAW,2BAA2B;IAC1C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,IAAI,MAAM,CAAA;IAClB,cAAc,IAAI,WAAW,GAAG,IAAI,CAAA;IACpC,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,iDAAiD;AACjD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAgC;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;gBAElD,OAAO,GAAE,2BAAgC;IAKrD,KAAK,CACH,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAClC,MAAM,EAAE,gBAAgB,GACvB,uBAAuB;CAwE3B;AAED,wBAAgB,4BAA4B,CAC1C,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,MAAM,CAKR"}

package/dist/core/editing/inlineCellEditorService.d.ts

@@ -0,0 +1,36 @@
+import { EventBus } from '../event/eventBus';
+import { Column, RowNode, RowNodeTransaction, RowTransaction } from '../types';
+import { CellEditorFn, CellEditorParams } from '../types/cellEditor';
+import { InvalidEditValueMode } from '../types/validation';
+import { InlineCellEditorHost } from './inlineCellEditorHost';
+export interface InlineCellEditorServiceDeps {
+    eventBus: EventBus;
+    applyTransaction: (transaction: RowTransaction) => RowNodeTransaction;
+    syncPinnedRows: () => void;
+    invalidEditValueMode: InvalidEditValueMode;
+    onUnmountEditor?: (mountEl: HTMLElement) => void;
+    byName?: Record<string, CellEditorFn>;
+}
+export interface InlineCellEditorRefreshContext {
+    host: InlineCellEditorHost;
+    createParams: (rowNode: RowNode, column: Column) => CellEditorParams;
+    commit: (rowNode: RowNode, column: Column, rawValue: string, oldValue: unknown) => Promise<boolean>;
+}
+/** Grid 级 inline 编辑器编排：params 工厂 + change commit */
+export declare class InlineCellEditorService {
+    private readonly host;
+    private readonly commits;
+    private readonly inFlight;
+    private readonly deps;
+    constructor(deps: InlineCellEditorServiceDeps);
+    getRefreshContext(): InlineCellEditorRefreshContext;
+    isCommitting(): boolean;
+    awaitCommitIdle(): Promise<void>;
+    cancelCommit(rowId?: string, colId?: string): void;
+    private createParams;
+    private isCellCommitting;
+    private abortCommit;
+    private commit;
+    private runCommit;
+}
+//# sourceMappingURL=inlineCellEditorService.d.ts.map

package/dist/core/editing/inlineCellEditorService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineCellEditorService.d.ts","sourceRoot":"","sources":["../../../src/core/editing/inlineCellEditorService.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAA;IAClB,gBAAgB,EAAE,CAAC,WAAW,EAAE,cAAc,KAAK,kBAAkB,CAAA;IACrE,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,oBAAoB,CAAA;IAC1B,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,gBAAgB,CAAA;IACpE,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,KACd,OAAO,CAAC,OAAO,CAAC,CAAA;CACtB;AAUD,oDAAoD;AACpD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;gBAEtC,IAAI,EAAE,2BAA2B;IAQ7C,iBAAiB,IAAI,8BAA8B;IASnD,YAAY,IAAI,OAAO;IAIjB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtC,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAWlD,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,WAAW;YAUL,MAAM;YAmBN,SAAS;CA4ExB"}

package/dist/core/editing/persistedCellValidation.d.ts

@@ -0,0 +1,17 @@
+import { Column, RowNode } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { RowValidator } from '../types/validation';
+export interface PersistedValidationCellInput {
+    column: Column;
+    editorParams: CellEditorParams;
+}
+/** 对已持久化的单元格值做校验，供编辑结束后的 invalid 反馈使用 */
+export declare function collectPersistedValidationErrors(rowNode: RowNode, cells: readonly PersistedValidationCellInput[], options?: {
+    rowValidator?: RowValidator;
+    signal?: AbortSignal;
+    rowKey?: string;
+}): Promise<Array<{
+    colId: string;
+    errors: string[];
+}>>;
+//# sourceMappingURL=persistedCellValidation.d.ts.map

package/dist/core/editing/persistedCellValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistedCellValidation.d.ts","sourceRoot":"","sources":["../../../src/core/editing/persistedCellValidation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAG1D,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,gBAAgB,CAAA;CAC/B;AAiBD,yCAAyC;AACzC,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,4BAA4B,EAAE,EAC9C,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAuCrD"}

package/dist/core/editing/readCellEditorValue.d.ts

@@ -0,0 +1,5 @@
+type EditorControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+/** 从挂载容器内的编辑器控件读取提交用字符串 */
+export declare function readCellEditorControlValue(control: EditorControl): string;
+export {};
+//# sourceMappingURL=readCellEditorValue.d.ts.map

package/dist/core/editing/readCellEditorValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readCellEditorValue.d.ts","sourceRoot":"","sources":["../../../src/core/editing/readCellEditorValue.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAAA;AAE/E,2BAA2B;AAC3B,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAMzE"}

package/dist/core/editing/rowEditCommit.d.ts

@@ -0,0 +1,47 @@
+import { RowNode, Column } from '../types';
+import { CellEditorParams } from '../types/cellEditor';
+import { RowValidator, InvalidEditValueMode } from '../types/validation';
+export interface RowEditCommitCell {
+    column: Column;
+    editorParams: CellEditorParams;
+    rawValue: string;
+    oldValue: unknown;
+}
+export interface RowEditCommitChange {
+    colId: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+export interface RowEditValidationWarnings {
+    cellErrors?: Array<{
+        colId: string;
+        errors: string[];
+    }>;
+    rowErrors?: string[];
+    rowErrorColIds?: string[];
+}
+export type RowEditCommitResult = {
+    ok: true;
+    changes: RowEditCommitChange[];
+    validationWarnings?: RowEditValidationWarnings;
+} | {
+    ok: false;
+    failedColId: string;
+    errors?: string[];
+    cellErrors?: Array<{
+        colId: string;
+        errors: string[];
+    }>;
+    rowErrors?: string[];
+    rowErrorColIds?: string[];
+    revert?: boolean;
+};
+export interface CommitRowEditCellsOptions {
+    signal?: AbortSignal;
+    rowValidator?: RowValidator;
+    invalidEditValueMode?: InvalidEditValueMode;
+    rowKey?: string;
+}
+/** 行编辑批量提交：先全量校验，再一次性写回；任一失败则不写入（支持 async valueSetter） */
+export declare function commitRowEditCells(rowNode: RowNode, cells: readonly RowEditCommitCell[], options?: CommitRowEditCellsOptions): Promise<RowEditCommitResult>;
+//# sourceMappingURL=rowEditCommit.d.ts.map

package/dist/core/editing/rowEditCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowEditCommit.d.ts","sourceRoot":"","sources":["../../../src/core/editing/rowEditCommit.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAEhF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,gBAAgB,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,yBAAyB,CAAA;CAAE,GAC5F;IACE,EAAE,EAAE,KAAK,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAEL,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAkJ9B"}

package/dist/core/editing/rowEditingService.d.ts

@@ -0,0 +1,133 @@
+import { Column, RowNode } from '../types';
+import { CellEditorKeyboardPolicy, CellEditorParams } from '../types/cellEditor';
+import { EditSessionPhase, EditCommitContext } from './editCommitContext';
+import { CellEditorHost, MountedCellEditor } from './cellEditorHost';
+import { RowEditValidationWarnings } from './rowEditCommit';
+export interface RowEditCommitHandlerResult {
+    ok: true;
+    cells: RowEditCellStopResult[];
+    validationWarnings?: RowEditValidationWarnings;
+}
+export interface RowEditCommitFailedResult {
+    ok: false;
+    failedColId: string;
+    errors?: string[];
+    cellErrors?: Array<{
+        colId: string;
+        errors: string[];
+    }>;
+    rowErrors?: string[];
+    rowErrorColIds?: string[];
+    revert?: boolean;
+}
+export type RowEditBatchCommitResult = RowEditCommitHandlerResult | RowEditCommitFailedResult | {
+    ok: 'aborted';
+};
+export type RowEditCommitHandler = (values: ReadonlyMap<string, string>, ctx: EditCommitContext) => RowEditBatchCommitResult | Promise<RowEditBatchCommitResult>;
+export interface EditingRowCell {
+    colId: string;
+    column: Column;
+    oldValue: unknown;
+    mountedEditor: MountedCellEditor;
+    keyboardPolicy: CellEditorKeyboardPolicy;
+}
+export interface EditingRow {
+    rowId: string;
+    rowIndex: number;
+    rowElement: HTMLElement;
+    focusColId?: string;
+    cells: Map<string, EditingRowCell>;
+}
+export interface RowEditCellStopResult {
+    colId: string;
+    committed: boolean;
+    oldValue: unknown;
+    newValue: unknown;
+}
+export interface RowEditStopResult {
+    rowId: string;
+    rowIndex: number;
+    committed: boolean;
+    cells: RowEditCellStopResult[];
+}
+export interface RowEditColumnContext {
+    column: Column;
+    params: Omit<CellEditorParams, 'stopEditing' | 'setKeyboardPolicy' | 'cancelCommit' | 'getEditPhase'>;
+    oldValue: unknown;
+}
+export interface StartRowEditingOptions {
+    rowElement: HTMLElement;
+    rowNode: RowNode;
+    columns: RowEditColumnContext[];
+    focusColId?: string;
+    onCommitRow: RowEditCommitHandler;
+    onFocusColChange?: (colId: string) => void;
+    onCancel?: () => void;
+    onRowEditingStopped?: (result: RowEditStopResult) => void;
+    onCommitLifecycle?: {
+        onStarted?: () => void;
+        onFinished?: (result: RowEditBatchCommitResult) => void;
+        onAborted?: () => void;
+    };
+}
+/** 行编辑：同行多列同时挂载编辑器；块 7 支持 async commit */
+export declare class RowEditingService {
+    private editing;
+    private onCommitRow;
+    private onFocusColChange;
+    private activeColId;
+    private onCancel;
+    private onRowEditingStopped;
+    private onCommitLifecycle;
+    private blurCommitAfterClickListener;
+    private blurCommitFallbackTimer;
+    private readonly attachedListeners;
+    private readonly pinnedRowIds;
+    private readonly editorHost;
+    private phase;
+    private commitController;
+    private inflightCommit;
+    private nextCommitId;
+    private readonly handleEditorKeyDown;
+    private readonly handleEditorBlur;
+    constructor(editorHost?: CellEditorHost);
+    getEditingRow(): Pick<EditingRow, 'rowId' | 'rowIndex'> | null;
+    /** 行编辑中当前激活的编辑器列 */
+    getActiveColId(): string | null;
+    /** 行编辑中切换激活列（Tab / 点击同行其它格） */
+    focusEditingColumn(colId: string): boolean;
+    getEditingCells(): Array<{
+        rowId: string;
+        rowIndex: number;
+        colId: string;
+    }>;
+    getEditorValue(colId: string): string | null;
+    getEditorMountEl(colId: string): HTMLElement | null;
+    isEditing(): boolean;
+    isCommitting(): boolean;
+    getEditSessionPhase(): EditSessionPhase;
+    awaitCommitIdle(): Promise<void>;
+    cancelCommit(): void;
+    isPinnedRow(rowId: string): boolean;
+    getPinnedRowIds(): ReadonlySet<string>;
+    startRowEditing(options: StartRowEditingOptions): boolean;
+    stopRowEditing(commit: boolean): Promise<RowEditStopResult | null>;
+    destroy(): void;
+    private commitRowEditingSession;
+    private revertRowEditingSession;
+    private cancelRowEditingSession;
+    private finalizeSuccessfulCommit;
+    private teardownEditingState;
+    private setCommittingVisual;
+    private finishCommittingVisual;
+    private attachEditorListeners;
+    private detachEditorListeners;
+    private focusRowEditor;
+    private getOrderedEditableColIds;
+    private navigateRowTab;
+    private resolveColIdFromEvent;
+    private isFocusWithinRowEditors;
+    private scheduleBlurCommitAfterClick;
+    private clearPendingBlurCommit;
+}
+//# sourceMappingURL=rowEditingService.d.ts.map

package/dist/core/editing/rowEditingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowEditingService.d.ts","sourceRoot":"","sources":["../../../src/core/editing/rowEditingService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAI3D,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAEhE,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,IAAI,CAAA;IACR,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,kBAAkB,CAAC,EAAE,yBAAyB,CAAA;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,KAAK,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,wBAAwB,GAChC,0BAA0B,GAC1B,yBAAyB,GACzB;IAAE,EAAE,EAAE,SAAS,CAAA;CAAE,CAAA;AAErB,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,GAAG,EAAE,iBAAiB,KACnB,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEjE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,iBAAiB,CAAA;IAChC,cAAc,EAAE,wBAAwB,CAAA;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,WAAW,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,qBAAqB,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,mBAAmB,GAAG,cAAc,GAAG,cAAc,CAAC,CAAA;IACrG,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,WAAW,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,oBAAoB,CAAA;IACjC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACzD,iBAAiB,CAAC,EAAE;QAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;QACtB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAA;QACvD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;KACvB,CAAA;CACF;AAOD,0CAA0C;AAC1C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,mBAAmB,CAAqD;IAChF,OAAO,CAAC,iBAAiB,CAMV;IACf,OAAO,CAAC,4BAA4B,CAA6C;IACjF,OAAO,CAAC,uBAAuB,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,YAAY,CAAI;IAExB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAmCnC;IAED,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAkBhC;gBAEW,UAAU,CAAC,EAAE,cAAc;IAIvC,aAAa,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG,IAAI;IAW9D,oBAAoB;IACpB,cAAc,IAAI,MAAM,GAAG,IAAI;IAgB/B,+BAA+B;IAC/B,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAS1C,eAAe,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAY5E,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI5C,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAInD,SAAS,IAAI,OAAO;IAIpB,YAAY,IAAI,OAAO;IAIvB,mBAAmB,IAAI,gBAAgB;IAIvC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,YAAY,IAAI,IAAI;IAYpB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInC,eAAe,IAAI,WAAW,CAAC,MAAM,CAAC;IAItC,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO;IAmEnD,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA6BxE,OAAO,IAAI,IAAI;YAgBD,uBAAuB;IAuErC,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,uBAAuB;IAyC/B,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,qBAAqB;IAuB7B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,4BAA4B;IA4BpC,OAAO,CAAC,sBAAsB;CAW/B"}

package/dist/core/editing/validationFeedback.d.ts

@@ -0,0 +1,63 @@
+/** 编辑态 / 展示态校验失败视觉反馈：invalid 样式 + tooltip */
+export interface InvalidCellFeedback {
+    colId: string;
+    errors: string[];
+    editorMountEl?: HTMLElement | null;
+}
+export declare class ValidationFeedbackService {
+    /** rowId → colId → errors */
+    private registry;
+    /** 当前存在校验错误的列 id */
+    private invalidColIds;
+    private domStates;
+    showCellInvalid(options: {
+        rowId: string;
+        rowElement: HTMLElement;
+        colId: string;
+        errors: string[];
+        editorMountEl?: HTMLElement | null;
+    }): void;
+    showCellsInvalid(options: {
+        rowId: string;
+        rowElement: HTMLElement;
+        cells: readonly InvalidCellFeedback[];
+    }): void;
+    /** 更新单行的 invalid 状态，不影响其他行 */
+    setRowInvalid(rowId: string, rowElement: HTMLElement | null, cells: readonly InvalidCellFeedback[]): void;
+    /** 全表校验后批量更新；未出现在 rows 中的行会从 registry 清除 */
+    applyGridValidationFeedback(mountEl: HTMLElement, rows: ReadonlyArray<{
+        rowId: string;
+        cells: readonly InvalidCellFeedback[];
+    }>): void;
+    /** 部分行校验后仅更新指定行 */
+    applyRowsValidationFeedback(mountEl: HTMLElement, rows: ReadonlyArray<{
+        rowId: string;
+        cells: readonly InvalidCellFeedback[];
+    }>): void;
+    clearRow(rowId: string, rowElement?: HTMLElement | null): void;
+    /** 清除单行内指定列的 invalid 状态，保留同行其他列 */
+    clearRowCell(rowId: string, rowElement: HTMLElement | null, colId: string): void;
+    /** 更新单行内指定列的 invalid 状态，保留同行其他列 */
+    setRowCellInvalid(rowId: string, rowElement: HTMLElement | null, cell: InvalidCellFeedback): void;
+    clear(mountEl?: HTMLElement): void;
+    /** 虚拟滚动重绘后，将 registry 中的 invalid 状态同步到当前 DOM */
+    syncDom(mountEl: HTMLElement): void;
+    hasInvalidCells(): boolean;
+    hasColErrors(colId: string): boolean;
+    getInvalidColIds(): ReadonlySet<string>;
+    /** 将 registry 中的列级错误状态同步到表头 DOM */
+    syncHeaderDom(headerRowEl: HTMLElement, columns: ReadonlyArray<{
+        colId: string;
+        validationRequired?: boolean;
+    }>): void;
+    getRegistry(): ReadonlyMap<string, ReadonlyMap<string, readonly string[]>>;
+    /** promoteRowId 后迁移校验 registry 与 DOM 行键 */
+    migrateRowId(oldRowId: string, newRowId: string, mountEl: HTMLElement): void;
+    private rebuildInvalidColIds;
+    private findRowElement;
+    private clearRowDom;
+    private applyCellDom;
+    private removeCellDom;
+    private removeRegistryDom;
+}
+//# sourceMappingURL=validationFeedback.d.ts.map

package/dist/core/editing/validationFeedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationFeedback.d.ts","sourceRoot":"","sources":["../../../src/core/editing/validationFeedback.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;CACnC;AAQD,qBAAa,yBAAyB;IACpC,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAA2C;IAC3D,oBAAoB;IACpB,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAyB;IAE1C,eAAe,CAAC,OAAO,EAAE;QACvB,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,WAAW,CAAA;QACvB,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;KACnC,GAAG,IAAI;IAQR,gBAAgB,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,WAAW,CAAA;QACvB,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;KACtC,GAAG,IAAI;IAIR,8BAA8B;IAC9B,aAAa,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,IAAI;IAwBP,4CAA4C;IAC5C,2BAA2B,CACzB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;KAAE,CAAC,GAC5E,IAAI;IAgBP,mBAAmB;IACnB,2BAA2B,CACzB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAA;KAAE,CAAC,GAC5E,IAAI;IAOP,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAM9D,mCAAmC;IACnC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BhF,mCAAmC;IACnC,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,IAAI,EAAE,mBAAmB,GACxB,IAAI;IAiCP,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAUlC,gDAAgD;IAChD,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAmBnC,eAAe,IAAI,OAAO;IAI1B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpC,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC;IAIvC,mCAAmC;IACnC,aAAa,CACX,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,GACtE,IAAI;IAcP,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAI1E,2CAA2C;IAC3C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAmB5E,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,iBAAiB;CAc1B"}

package/dist/core/event/eventBus.d.ts

@@ -0,0 +1,16 @@
+import { GridEventMap, GridEventType } from '../types';
+import { BusinessRowIdContext } from '../types/businessRowId';
+export type GridEventProjector = (type: GridEventType, event: unknown) => GridEventMap[GridEventType];
+/** 单向事件总线，destroy 后清空订阅 */
+export declare class EventBus {
+    private readonly listeners;
+    private destroyed;
+    private projector;
+    setProjector(projector: GridEventProjector | null): void;
+    on<T extends GridEventType>(type: T, handler: (event: GridEventMap[T]) => void): () => void;
+    /** 内核 emit：payload 使用 internal string rowId；listener 收到投影后的 BusinessRowId */
+    emit<T extends GridEventType>(type: T, event: unknown): void;
+    destroy(): void;
+}
+export declare function createGridEventProjector(ctx: BusinessRowIdContext): GridEventProjector;
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/core/event/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../../src/core/event/eventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGrE,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,OAAO,KACX,YAAY,CAAC,aAAa,CAAC,CAAA;AAEhC,2BAA2B;AAC3B,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0D;IACpF,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAkC;IAEnD,YAAY,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAIxD,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAmB3F,6EAA6E;IAC7E,IAAI,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAiB5D,OAAO,IAAI,IAAI;CAKhB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAEtF"}

package/dist/core/event/index.d.ts

@@ -0,0 +1,2 @@
+export { EventBus } from './eventBus';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/core/event/projectGridEvent.d.ts

@@ -0,0 +1,5 @@
+import { BusinessRowIdContext } from '../types/businessRowId';
+import { GridEventMap, GridEventType } from '../types/events';
+/** 将内核 string rowId 事件投影为对外 BusinessRowId 事件 */
+export declare function projectGridEvent<T extends GridEventType>(type: T, event: unknown, ctx: BusinessRowIdContext): GridEventMap[T];
+//# sourceMappingURL=projectGridEvent.d.ts.map

package/dist/core/event/projectGridEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectGridEvent.d.ts","sourceRoot":"","sources":["../../../src/core/event/projectGridEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAgBrE,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,aAAa,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,oBAAoB,GACxB,YAAY,CAAC,CAAC,CAAC,CA6PjB"}