export declare const COMMIT_OPERATIONS: readonly ["tile_set", "tile_fill", "tile_erase", "tile_clear", "tileset_assign", "node_property", "node_add"]; export type CommitOp = typeof COMMIT_OPERATIONS[number]; /** * IMPORTANT-7 (review): 校验 operations 数组结构。每个 op 必须有合法 op 字段 * (对齐 COMMIT_OPERATIONS)。原 scene-commit-tool 用 as unknown as CommitOperation[] 无运行时校验, * 畸形 op(op 字段缺失/非法值)会让 generateCommitScript 运行时崩溃或生成畸形 .gd。 * @returns null 全部合法;否则首条错误信息(含索引与合法值清单)。 */ export declare function validateCommitOperations(operations: Array>): string | null; interface TileSetOp { op: 'tile_set'; node_path: string; coords: { x: number; y: number; }; source_id: number; atlas: { x: number; y: number; }; alternative_tile?: number; } interface TileFillOp { op: 'tile_fill'; node_path: string; region: { x: number; y: number; w: number; h: number; }; source_id: number; atlas: { x: number; y: number; }; alternative_tile?: number; } interface TileEraseOp { op: 'tile_erase'; node_path: string; coords: { x: number; y: number; }; } interface TileClearOp { op: 'tile_clear'; node_path: string; } interface TilesetAssignOp { op: 'tileset_assign'; node_path: string; tileset_path: string; } interface NodePropertyOp { op: 'node_property'; path: string; property: string; value: unknown; } interface NodeAddOp { op: 'node_add'; parent: string; name: string; type: string; properties?: Record; } export type CommitOperation = TileSetOp | TileFillOp | TileEraseOp | TileClearOp | TilesetAssignOp | NodePropertyOp | NodeAddOp; /** * Generate a complete GDScript that executes all operations in sequence, * optionally saves the scene, and reports structured results. */ export declare function generateCommitScript(scenePath: string, operations: CommitOperation[], save: boolean, stopOnError?: boolean): string; export {};