agent-ide 0.1.10 → 0.3.3

package/dist/core/transform/location/shift/shift-service.js

@@ -0,0 +1,199 @@
+/**
+ * Shift 服務 - 協調行移動操作
+ */
+import * as path from 'node:path';
+import { LineExtractor } from '../../../transform/location/shift/line-extractor.js';
+import { FileGenerator } from '../../../transform/location/shift/file-generator.js';
+import { ShiftOperationType, createShiftResult, createShiftValidationError } from '../../../transform/location/shift/types.js';
+/**
+ * Shift 服務類別
+ */
+export class ShiftService {
+    lineExtractor;
+    fileGenerator;
+    fileSystem;
+    constructor(fileSystem) {
+        this.lineExtractor = new LineExtractor();
+        this.fileGenerator = new FileGenerator(fileSystem);
+        this.fileSystem = fileSystem;
+    }
+    /**
+     * 執行行移動操作
+     * @param options - 移動選項
+     * @returns 移動結果
+     */
+    async shift(options) {
+        try {
+            // 驗證選項
+            const validationErrors = await this.validateOptions(options);
+            if (validationErrors.length > 0) {
+                const errorMessages = validationErrors.map(e => e.message).join('; ');
+                return createShiftResult(false, ShiftOperationType.WITHIN_FILE, options, '驗證失敗', { error: errorMessages });
+            }
+            // 決定操作類型並執行
+            const isSameFile = !options.targetFile || options.targetFile === options.sourceFile;
+            if (isSameFile) {
+                return this.shiftWithinFile(options);
+            }
+            return this.shiftBetweenFiles(options);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return createShiftResult(false, ShiftOperationType.WITHIN_FILE, options, '執行失敗', { error: errorMessage });
+        }
+    }
+    /**
+     * 單檔案內行移動
+     * @param options - 移動選項
+     * @returns 移動結果
+     */
+    async shiftWithinFile(options) {
+        const { sourceFile, fromLine, toLine, position, preview } = options;
+        // 讀取檔案內容
+        const content = await this.readFile(sourceFile);
+        // 驗證行號和位置
+        if (!this.lineExtractor.validateLineRange(content, fromLine, toLine)) {
+            throw new Error(`無效的行號範圍：${fromLine}-${toLine}`);
+        }
+        if (!this.lineExtractor.validatePosition(content, position)) {
+            throw new Error(`無效的插入位置：${position}`);
+        }
+        // 檢查是否需要移動（位置在移動範圍內）
+        if (position > fromLine && position <= toLine + 1) {
+            return createShiftResult(true, ShiftOperationType.WITHIN_FILE, options, '目標位置在移動範圍內，無需移動');
+        }
+        // 提取要移動的行
+        const extractionResult = this.lineExtractor.extractLines(content, fromLine, toLine);
+        // 調整插入位置（如果插入位置在移動範圍之後）
+        const adjustedPosition = position > toLine ? position - extractionResult.linesCount : position;
+        // 在新位置插入行
+        const insertionResult = this.lineExtractor.insertLines(extractionResult.remainingContent, extractionResult.extractedLines, adjustedPosition);
+        // 預覽模式或實際寫入
+        if (!preview) {
+            await this.writeFile(sourceFile, insertionResult.content);
+        }
+        return createShiftResult(true, ShiftOperationType.WITHIN_FILE, options, preview ? '預覽：單檔案內行移動' : '成功移動行', {
+            movedLines: extractionResult.extractedLines,
+            sourceContent: insertionResult.content
+        });
+    }
+    /**
+     * 跨檔案行移動
+     * @param options - 移動選項
+     * @returns 移動結果
+     */
+    async shiftBetweenFiles(options) {
+        const { sourceFile, targetFile, fromLine, toLine, position, preview } = options;
+        if (!targetFile) {
+            throw new Error('跨檔案移動需要指定目標檔案');
+        }
+        // 讀取來源檔案內容
+        const sourceContent = await this.readFile(sourceFile);
+        // 驗證來源檔案的行號範圍
+        if (!this.lineExtractor.validateLineRange(sourceContent, fromLine, toLine)) {
+            throw new Error(`來源檔案無效的行號範圍：${fromLine}-${toLine}`);
+        }
+        // 提取要移動的行
+        const extractionResult = this.lineExtractor.extractLines(sourceContent, fromLine, toLine);
+        // 處理目標檔案
+        const targetFileExists = await this.fileExists(targetFile);
+        let finalTargetPath = targetFile;
+        let operationType = ShiftOperationType.BETWEEN_FILES;
+        if (!targetFileExists) {
+            // 目標檔案不存在，生成唯一檔名
+            const sourceExt = path.extname(sourceFile);
+            const targetDir = path.dirname(targetFile);
+            const targetBasePath = path.join(targetDir, path.parse(targetFile).name);
+            const generationResult = await this.fileGenerator.generateUniqueFilename(targetBasePath, sourceExt);
+            finalTargetPath = generationResult.filePath;
+            operationType = ShiftOperationType.TO_NEW_FILE;
+        }
+        // 讀取或初始化目標檔案內容
+        const targetContent = targetFileExists ? await this.readFile(finalTargetPath) : '';
+        // 驗證目標檔案的插入位置
+        if (!this.lineExtractor.validatePosition(targetContent, position)) {
+            throw new Error(`目標檔案無效的插入位置：${position}`);
+        }
+        // 在目標檔案插入行
+        const insertionResult = this.lineExtractor.insertLines(targetContent, extractionResult.extractedLines, position);
+        // 預覽模式或實際寫入
+        if (!preview) {
+            await this.writeFile(sourceFile, extractionResult.remainingContent);
+            await this.writeFile(finalTargetPath, insertionResult.content);
+        }
+        const message = preview
+            ? `預覽：從 ${path.basename(sourceFile)} 移動到 ${path.basename(finalTargetPath)}`
+            : `成功從 ${path.basename(sourceFile)} 移動到 ${path.basename(finalTargetPath)}`;
+        return createShiftResult(true, operationType, { ...options, targetFile: finalTargetPath }, message, {
+            movedLines: extractionResult.extractedLines,
+            sourceContent: extractionResult.remainingContent,
+            targetContent: insertionResult.content
+        });
+    }
+    /**
+     * 驗證選項
+     * @param options - 移動選項
+     * @returns 驗證錯誤列表
+     */
+    async validateOptions(options) {
+        const errors = [];
+        // 檢查來源檔案是否存在
+        if (!(await this.fileExists(options.sourceFile))) {
+            errors.push(createShiftValidationError('source_not_found', `來源檔案不存在：${options.sourceFile}`, options.sourceFile));
+        }
+        // 檢查行號範圍
+        if (options.fromLine < 1) {
+            errors.push(createShiftValidationError('invalid_line_range', `起始行號必須 >= 1，實際值：${options.fromLine}`, options.sourceFile, options.fromLine));
+        }
+        if (options.toLine < options.fromLine) {
+            errors.push(createShiftValidationError('invalid_line_range', `結束行號 (${options.toLine}) 不可小於起始行號 (${options.fromLine})`, options.sourceFile, options.toLine));
+        }
+        // 檢查插入位置
+        if (options.position < 1) {
+            errors.push(createShiftValidationError('invalid_position', `插入位置必須 >= 1，實際值：${options.position}`, options.targetFile || options.sourceFile, options.position));
+        }
+        return errors;
+    }
+    /**
+     * 讀取檔案內容
+     * @param filePath - 檔案路徑
+     * @returns 檔案內容
+     */
+    async readFile(filePath) {
+        try {
+            return await this.fileSystem.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`無法讀取檔案 ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 寫入檔案內容
+     * @param filePath - 檔案路徑
+     * @param content - 檔案內容
+     */
+    async writeFile(filePath, content) {
+        try {
+            const directory = path.dirname(filePath);
+            await this.fileGenerator.ensureDirectoryExists(directory);
+            await this.fileSystem.writeFile(filePath, content);
+        }
+        catch (error) {
+            throw new Error(`無法寫入檔案 ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 檢查檔案是否存在
+     * @param filePath - 檔案路徑
+     * @returns 是否存在
+     */
+    async fileExists(filePath) {
+        try {
+            return await this.fileSystem.exists(filePath);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=shift-service.js.map

package/dist/core/transform/location/shift/shift-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-service.js","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/shift-service.ts"],"names":[],"mappings":"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"}

package/dist/core/transform/location/shift/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Shift 模組的核心型別定義
+ */
+/**
+ * 行移動操作狀態
+ */
+export declare enum ShiftStatus {
+    PENDING = "pending",
+    IN_PROGRESS = "in_progress",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * 行移動操作類型
+ */
+export declare enum ShiftOperationType {
+    WITHIN_FILE = "within_file",
+    BETWEEN_FILES = "between_files",
+    TO_NEW_FILE = "to_new_file"
+}
+/**
+ * 行移動選項
+ */
+export interface ShiftOptions {
+    /**
+     * 來源檔案路徑
+     */
+    readonly sourceFile: string;
+    /**
+     * 起始行號（1-based）
+     */
+    readonly fromLine: number;
+    /**
+     * 結束行號（1-based，包含）
+     */
+    readonly toLine: number;
+    /**
+     * 目標檔案路徑（選填，預設為來源檔案）
+     */
+    readonly targetFile?: string;
+    /**
+     * 目標位置行號（1-based，插入到此行之前）
+     */
+    readonly position: number;
+    /**
+     * 是否為預覽模式（不實際寫入）
+     */
+    readonly preview?: boolean;
+    /**
+     * 專案根目錄路徑
+     */
+    readonly projectRoot?: string;
+}
+/**
+ * 行移動結果
+ */
+export interface ShiftResult {
+    /**
+     * 操作是否成功
+     */
+    readonly success: boolean;
+    /**
+     * 操作類型
+     */
+    readonly operationType: ShiftOperationType;
+    /**
+     * 來源檔案路徑
+     */
+    readonly sourceFile: string;
+    /**
+     * 目標檔案路徑
+     */
+    readonly targetFile: string;
+    /**
+     * 移動的起始行號
+     */
+    readonly fromLine: number;
+    /**
+     * 移動的結束行號
+     */
+    readonly toLine: number;
+    /**
+     * 插入的目標位置
+     */
+    readonly position: number;
+    /**
+     * 移動的行數
+     */
+    readonly linesCount: number;
+    /**
+     * 是否實際執行了移動（預覽模式為 false）
+     */
+    readonly executed: boolean;
+    /**
+     * 結果訊息
+     */
+    readonly message: string;
+    /**
+     * 錯誤訊息（如果失敗）
+     */
+    readonly error?: string;
+    /**
+     * 移動的行內容（預覽模式下）
+     */
+    readonly movedLines?: readonly string[];
+    /**
+     * 來源檔案的新內容（預覽模式下）
+     */
+    readonly sourceContent?: string;
+    /**
+     * 目標檔案的新內容（預覽模式下）
+     */
+    readonly targetContent?: string;
+}
+/**
+ * 檔案生成結果
+ */
+export interface FileGenerationResult {
+    /**
+     * 生成的檔案路徑
+     */
+    readonly filePath: string;
+    /**
+     * 是否為新建檔案
+     */
+    readonly isNew: boolean;
+    /**
+     * 是否發生了檔名衝突
+     */
+    readonly hasConflict: boolean;
+    /**
+     * 原始檔名（衝突前）
+     */
+    readonly originalName?: string;
+}
+/**
+ * 行提取結果
+ */
+export interface LineExtractionResult {
+    /**
+     * 提取的行內容
+     */
+    readonly extractedLines: readonly string[];
+    /**
+     * 移除指定行後的內容
+     */
+    readonly remainingContent: string;
+    /**
+     * 提取的行數
+     */
+    readonly linesCount: number;
+}
+/**
+ * 行插入結果
+ */
+export interface LineInsertionResult {
+    /**
+     * 插入行後的完整內容
+     */
+    readonly content: string;
+    /**
+     * 插入的位置（實際插入的行號）
+     */
+    readonly insertedAt: number;
+    /**
+     * 插入的行數
+     */
+    readonly linesCount: number;
+}
+/**
+ * Shift 操作驗證錯誤
+ */
+export interface ShiftValidationError {
+    readonly type: 'source_not_found' | 'invalid_line_range' | 'invalid_position' | 'permission_denied';
+    readonly message: string;
+    readonly filePath?: string;
+    readonly lineNumber?: number;
+}
+/**
+ * 建立 ShiftResult 的工廠函式
+ */
+export declare function createShiftResult(success: boolean, operationType: ShiftOperationType, options: ShiftOptions, message: string, additionalData?: Partial<ShiftResult>): ShiftResult;
+/**
+ * 建立 ShiftValidationError 的工廠函式
+ */
+export declare function createShiftValidationError(type: ShiftValidationError['type'], message: string, filePath?: string, lineNumber?: number): ShiftValidationError;
+/**
+ * 型別守衛 - 檢查是否為有效的 ShiftOptions
+ */
+export declare function isValidShiftOptions(value: unknown): value is ShiftOptions;
+/**
+ * 型別守衛 - 檢查是否為有效的 ShiftResult
+ */
+export declare function isValidShiftResult(value: unknown): value is ShiftResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/transform/location/shift/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACpG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,kBAAkB,EACjC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACpC,WAAW,CAiBb;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,oBAAoB,CAOtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAgBzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAmBvE"}

package/dist/core/transform/location/shift/types.js

@@ -0,0 +1,89 @@
+/**
+ * Shift 模組的核心型別定義
+ */
+/**
+ * 行移動操作狀態
+ */
+export var ShiftStatus;
+(function (ShiftStatus) {
+    ShiftStatus["PENDING"] = "pending";
+    ShiftStatus["IN_PROGRESS"] = "in_progress";
+    ShiftStatus["COMPLETED"] = "completed";
+    ShiftStatus["FAILED"] = "failed";
+})(ShiftStatus || (ShiftStatus = {}));
+/**
+ * 行移動操作類型
+ */
+export var ShiftOperationType;
+(function (ShiftOperationType) {
+    ShiftOperationType["WITHIN_FILE"] = "within_file";
+    ShiftOperationType["BETWEEN_FILES"] = "between_files";
+    ShiftOperationType["TO_NEW_FILE"] = "to_new_file";
+})(ShiftOperationType || (ShiftOperationType = {}));
+/**
+ * 建立 ShiftResult 的工廠函式
+ */
+export function createShiftResult(success, operationType, options, message, additionalData) {
+    const targetFile = options.targetFile || options.sourceFile;
+    const linesCount = options.toLine - options.fromLine + 1;
+    return {
+        success,
+        operationType,
+        sourceFile: options.sourceFile,
+        targetFile,
+        fromLine: options.fromLine,
+        toLine: options.toLine,
+        position: options.position,
+        linesCount,
+        executed: !options.preview,
+        message,
+        ...additionalData
+    };
+}
+/**
+ * 建立 ShiftValidationError 的工廠函式
+ */
+export function createShiftValidationError(type, message, filePath, lineNumber) {
+    return {
+        type,
+        message,
+        filePath,
+        lineNumber
+    };
+}
+/**
+ * 型別守衛 - 檢查是否為有效的 ShiftOptions
+ */
+export function isValidShiftOptions(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.sourceFile === 'string' &&
+        typeof obj.fromLine === 'number' &&
+        typeof obj.toLine === 'number' &&
+        typeof obj.position === 'number' &&
+        obj.fromLine > 0 &&
+        obj.toLine >= obj.fromLine &&
+        obj.position > 0);
+}
+/**
+ * 型別守衛 - 檢查是否為有效的 ShiftResult
+ */
+export function isValidShiftResult(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.success === 'boolean' &&
+        Object.values(ShiftOperationType).includes(obj.operationType) &&
+        typeof obj.sourceFile === 'string' &&
+        typeof obj.targetFile === 'string' &&
+        typeof obj.fromLine === 'number' &&
+        typeof obj.toLine === 'number' &&
+        typeof obj.position === 'number' &&
+        typeof obj.linesCount === 'number' &&
+        typeof obj.executed === 'boolean' &&
+        typeof obj.message === 'string');
+}
+//# sourceMappingURL=types.js.map

package/dist/core/transform/location/shift/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,0CAA2B,CAAA;IAC3B,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;AACnB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,iDAA2B,CAAA;IAC3B,qDAA+B,CAAA;IAC/B,iDAA2B,CAAA;AAC7B,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AAgMD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,aAAiC,EACjC,OAAqB,EACrB,OAAe,EACf,cAAqC;IAErC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IAEzD,OAAO;QACL,OAAO;QACP,aAAa;QACb,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU;QACV,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU;QACV,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO;QAC1B,OAAO;QACP,GAAG,cAAc;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAkC,EAClC,OAAe,EACf,QAAiB,EACjB,UAAmB;IAEnB,OAAO;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,OAAO,CACL,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAChC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAChC,GAAG,CAAC,QAAQ,GAAG,CAAC;QAChB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ;QAC1B,GAAG,CAAC,QAAQ,GAAG,CAAC,CACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,OAAO,CACL,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS;QAChC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAmC,CAAC;QACnF,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAChC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAChC,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,QAAQ,KAAK,SAAS;QACjC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC"}

package/dist/core/transform/shared/code-editor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 統一的程式碼編輯器
+ * 處理所有 TextChange 的應用，確保位置偏移正確
+ */
+import type { TextChange, FileChange } from '../types.js';
+/**
+ * 程式碼編輯器
+ * 提供統一的文字變更應用機制
+ */
+export declare class CodeEditor {
+    /**
+     * 應用多個文字變更到內容
+     * 自動處理位置偏移（從後往前應用）
+     */
+    applyChanges(content: string, changes: readonly TextChange[]): string;
+    /**
+     * 建立 FileChange 物件
+     */
+    createFileChange(filePath: string, originalContent: string, changes: readonly TextChange[]): FileChange;
+    /**
+     * 計算變更的預覽（不實際應用）
+     */
+    previewChanges(content: string, changes: readonly TextChange[]): PreviewedChange[];
+    /**
+     * 合併重疊的變更
+     */
+    mergeOverlappingChanges(changes: readonly TextChange[]): TextChange[];
+    /**
+     * 驗證變更是否有效
+     */
+    validateChanges(content: string, changes: readonly TextChange[]): ValidationResult;
+    /**
+     * 應用單一變更
+     */
+    private applySingleChange;
+    /**
+     * 檢查兩個範圍是否重疊
+     */
+    private rangesOverlap;
+    /**
+     * 合併兩個重疊的變更
+     */
+    private mergeChanges;
+    /**
+     * 比較兩個位置的先後
+     */
+    private isPositionBefore;
+}
+/**
+ * 預覽變更結果
+ */
+export interface PreviewedChange {
+    readonly change: TextChange;
+    readonly contextBefore: string;
+    readonly affectedLines: string;
+    readonly contextAfter: string;
+}
+/**
+ * 驗證結果
+ */
+interface ValidationResult {
+    readonly isValid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * 建立 CodeEditor 實例
+ */
+export declare function createCodeEditor(): CodeEditor;
+export {};
+//# sourceMappingURL=code-editor.d.ts.map

package/dist/core/transform/shared/code-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-editor.d.ts","sourceRoot":"","sources":["../../../../src/core/transform/shared/code-editor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM;IAuBrE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU;IAWvG;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,eAAe,EAAE;IAkBlF;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE;IAiCrE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,gBAAgB;IAgClF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAMzB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}