agent-ide 0.2.0 → 0.3.3

package/dist/core/transform/location/move-member/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Move Member 型別定義
+ * 成員移動功能的核心型別
+ */
+import type { Location } from '../../../../shared/types/core.js';
+/**
+ * 可移動的成員類型
+ */
+export declare enum MemberType {
+    /** 方法 */
+    Method = "method",
+    /** 屬性 */
+    Property = "property",
+    /** 函式（模組層級） */
+    Function = "function",
+    /** 類別 */
+    Class = "class",
+    /** 介面 */
+    Interface = "interface",
+    /** 類型別名 */
+    TypeAlias = "type-alias",
+    /** 常數 */
+    Constant = "constant",
+    /** 列舉 */
+    Enum = "enum"
+}
+/**
+ * 成員定義
+ */
+export interface MemberDefinition {
+    /** 成員名稱 */
+    readonly name: string;
+    /** 成員類型 */
+    readonly type: MemberType;
+    /** 成員位置 */
+    readonly location: Location;
+    /** 成員原始碼 */
+    readonly sourceCode: string;
+    /** 所屬類別（若為類別成員） */
+    readonly className?: string;
+    /** 修飾符 */
+    readonly modifiers: readonly string[];
+    /** JSDoc 或文件註解 */
+    readonly documentation?: string;
+    /** 依賴的其他符號 */
+    readonly dependencies: readonly string[];
+}
+/**
+ * 移動目標類型
+ */
+export declare enum MoveTargetType {
+    /** 移動到現有檔案 */
+    ExistingFile = "existing-file",
+    /** 移動到新檔案 */
+    NewFile = "new-file",
+    /** 移動到現有類別 */
+    ExistingClass = "existing-class"
+}
+/**
+ * 移動目標
+ */
+export interface MoveTarget {
+    /** 目標類型 */
+    readonly type: MoveTargetType;
+    /** 目標檔案路徑 */
+    readonly filePath: string;
+    /** 目標類別名稱（移動到類別時） */
+    readonly className?: string;
+    /** 插入位置（行號，0 表示檔案開頭，-1 表示檔案結尾） */
+    readonly insertPosition?: number;
+}
+/**
+ * Move Member 選項
+ */
+export interface MoveMemberOptions {
+    /** 來源檔案路徑 */
+    readonly sourceFile: string;
+    /** 成員名稱 */
+    readonly memberName: string;
+    /** 成員類型（可選，用於區分同名成員） */
+    readonly memberType?: MemberType;
+    /** 所屬類別（若為類別成員） */
+    readonly sourceClassName?: string;
+    /** 移動目標 */
+    readonly target: MoveTarget;
+    /** 專案根目錄 */
+    readonly projectRoot: string;
+    /** 是否預覽而不執行 */
+    readonly preview?: boolean;
+    /** 是否更新引用 */
+    readonly updateReferences?: boolean;
+    /** 是否保留原位置的 re-export */
+    readonly keepReexport?: boolean;
+}
+/**
+ * 引用更新資訊
+ */
+export interface ReferenceUpdate {
+    /** 檔案路徑 */
+    readonly filePath: string;
+    /** 原始 import 陳述 */
+    readonly originalImport: string;
+    /** 新的 import 陳述 */
+    readonly newImport: string;
+    /** 位置 */
+    readonly location: Location;
+}
+/**
+ * Move Member 結果
+ */
+export interface MoveMemberResult {
+    /** 是否成功 */
+    readonly success: boolean;
+    /** 錯誤訊息（若失敗） */
+    readonly error?: string;
+    /** 被移動的成員 */
+    readonly member: MemberDefinition;
+    /** 移動目標 */
+    readonly target: MoveTarget;
+    /** 來源檔案變更 */
+    readonly sourceFileChange: {
+        readonly filePath: string;
+        readonly originalCode: string;
+        readonly newCode: string;
+    };
+    /** 目標檔案變更 */
+    readonly targetFileChange: {
+        readonly filePath: string;
+        readonly originalCode: string | null;
+        readonly newCode: string;
+        readonly isNewFile: boolean;
+    };
+    /** 引用更新列表 */
+    readonly referenceUpdates: readonly ReferenceUpdate[];
+    /** 是否已執行（false 表示僅預覽） */
+    readonly executed: boolean;
+    /** 統計資訊 */
+    readonly stats: {
+        /** 更新的引用數量 */
+        readonly referencesUpdated: number;
+        /** 影響的檔案數量 */
+        readonly filesAffected: number;
+    };
+}
+/**
+ * 驗證錯誤
+ */
+export interface MoveMemberValidationError {
+    /** 錯誤代碼 */
+    readonly code: MoveMemberErrorCode;
+    /** 錯誤訊息 */
+    readonly message: string;
+}
+/**
+ * 錯誤代碼
+ */
+export declare enum MoveMemberErrorCode {
+    /** 找不到成員 */
+    MemberNotFound = "member-not-found",
+    /** 找不到來源檔案 */
+    SourceFileNotFound = "source-file-not-found",
+    /** 目標檔案已存在同名成員 */
+    DuplicateMemberInTarget = "duplicate-member-in-target",
+    /** 找不到目標類別 */
+    TargetClassNotFound = "target-class-not-found",
+    /** 循環依賴 */
+    CircularDependency = "circular-dependency",
+    /** 不支援的成員類型 */
+    UnsupportedMemberType = "unsupported-member-type",
+    /** 不支援的語言 */
+    UnsupportedLanguage = "unsupported-language",
+    /** 解析錯誤 */
+    ParseError = "parse-error",
+    /** 目標檔案不存在（且不是新檔案模式） */
+    TargetFileNotFound = "target-file-not-found"
+}
+/**
+ * Type Guards
+ */
+export declare function isMemberDefinition(obj: unknown): obj is MemberDefinition;
+export declare function isMoveMemberResult(obj: unknown): obj is MoveMemberResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/transform/location/move-member/types.d.ts.map

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

package/dist/core/transform/location/move-member/types.js

@@ -0,0 +1,75 @@
+/**
+ * Move Member 型別定義
+ * 成員移動功能的核心型別
+ */
+/**
+ * 可移動的成員類型
+ */
+export var MemberType;
+(function (MemberType) {
+    /** 方法 */
+    MemberType["Method"] = "method";
+    /** 屬性 */
+    MemberType["Property"] = "property";
+    /** 函式（模組層級） */
+    MemberType["Function"] = "function";
+    /** 類別 */
+    MemberType["Class"] = "class";
+    /** 介面 */
+    MemberType["Interface"] = "interface";
+    /** 類型別名 */
+    MemberType["TypeAlias"] = "type-alias";
+    /** 常數 */
+    MemberType["Constant"] = "constant";
+    /** 列舉 */
+    MemberType["Enum"] = "enum";
+})(MemberType || (MemberType = {}));
+/**
+ * 移動目標類型
+ */
+export var MoveTargetType;
+(function (MoveTargetType) {
+    /** 移動到現有檔案 */
+    MoveTargetType["ExistingFile"] = "existing-file";
+    /** 移動到新檔案 */
+    MoveTargetType["NewFile"] = "new-file";
+    /** 移動到現有類別 */
+    MoveTargetType["ExistingClass"] = "existing-class";
+})(MoveTargetType || (MoveTargetType = {}));
+/**
+ * 錯誤代碼
+ */
+export var MoveMemberErrorCode;
+(function (MoveMemberErrorCode) {
+    /** 找不到成員 */
+    MoveMemberErrorCode["MemberNotFound"] = "member-not-found";
+    /** 找不到來源檔案 */
+    MoveMemberErrorCode["SourceFileNotFound"] = "source-file-not-found";
+    /** 目標檔案已存在同名成員 */
+    MoveMemberErrorCode["DuplicateMemberInTarget"] = "duplicate-member-in-target";
+    /** 找不到目標類別 */
+    MoveMemberErrorCode["TargetClassNotFound"] = "target-class-not-found";
+    /** 循環依賴 */
+    MoveMemberErrorCode["CircularDependency"] = "circular-dependency";
+    /** 不支援的成員類型 */
+    MoveMemberErrorCode["UnsupportedMemberType"] = "unsupported-member-type";
+    /** 不支援的語言 */
+    MoveMemberErrorCode["UnsupportedLanguage"] = "unsupported-language";
+    /** 解析錯誤 */
+    MoveMemberErrorCode["ParseError"] = "parse-error";
+    /** 目標檔案不存在（且不是新檔案模式） */
+    MoveMemberErrorCode["TargetFileNotFound"] = "target-file-not-found";
+})(MoveMemberErrorCode || (MoveMemberErrorCode = {}));
+/**
+ * Type Guards
+ */
+export function isMemberDefinition(obj) {
+    return typeof obj === 'object' && obj !== null &&
+        'name' in obj && typeof obj.name === 'string' &&
+        'type' in obj && Object.values(MemberType).includes(obj.type);
+}
+export function isMoveMemberResult(obj) {
+    return typeof obj === 'object' && obj !== null &&
+        'success' in obj && typeof obj.success === 'boolean';
+}
+//# sourceMappingURL=types.js.map

package/dist/core/transform/location/move-member/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/transform/location/move-member/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,CAAN,IAAY,UAiBX;AAjBD,WAAY,UAAU;IACpB,SAAS;IACT,+BAAiB,CAAA;IACjB,SAAS;IACT,mCAAqB,CAAA;IACrB,eAAe;IACf,mCAAqB,CAAA;IACrB,SAAS;IACT,6BAAe,CAAA;IACf,SAAS;IACT,qCAAuB,CAAA;IACvB,WAAW;IACX,sCAAwB,CAAA;IACxB,SAAS;IACT,mCAAqB,CAAA;IACrB,SAAS;IACT,2BAAa,CAAA;AACf,CAAC,EAjBW,UAAU,KAAV,UAAU,QAiBrB;AAwBD;;GAEG;AACH,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,cAAc;IACd,gDAA8B,CAAA;IAC9B,aAAa;IACb,sCAAoB,CAAA;IACpB,cAAc;IACd,kDAAgC,CAAA;AAClC,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAsGD;;GAEG;AACH,MAAM,CAAN,IAAY,mBAmBX;AAnBD,WAAY,mBAAmB;IAC7B,YAAY;IACZ,0DAAmC,CAAA;IACnC,cAAc;IACd,mEAA4C,CAAA;IAC5C,kBAAkB;IAClB,6EAAsD,CAAA;IACtD,cAAc;IACd,qEAA8C,CAAA;IAC9C,WAAW;IACX,iEAA0C,CAAA;IAC1C,eAAe;IACf,wEAAiD,CAAA;IACjD,aAAa;IACb,mEAA4C,CAAA;IAC5C,WAAW;IACX,iDAA0B,CAAA;IAC1B,wBAAwB;IACxB,mEAA4C,CAAA;AAC9C,CAAC,EAnBW,mBAAmB,KAAnB,mBAAmB,QAmB9B;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,MAAM,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,IAAI,KAAK,QAAQ;QACnE,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAE,GAAwB,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAC5C,SAAS,IAAI,GAAG,IAAI,OAAQ,GAAwB,CAAC,OAAO,KAAK,SAAS,CAAC;AAC/E,CAAC"}

package/dist/core/transform/location/shift/file-generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 檔案生成器 - 處理檔名衝突
+ */
+import type { IFileSystem } from '../../../../infrastructure/storage/index.js';
+import type { FileGenerationResult } from '../../../transform/location/shift/types.js';
+/**
+ * 檔案生成器類別
+ */
+export declare class FileGenerator {
+    private readonly fileSystem;
+    constructor(fileSystem: IFileSystem);
+    /**
+     * 生成唯一檔名
+     * @param basePath - 基礎路徑（不含副檔名）
+     * @param extension - 副檔名（含點號，如 '.ts'）
+     * @returns 唯一的檔案路徑
+     */
+    generateUniqueFilename(basePath: string, extension: string): Promise<FileGenerationResult>;
+    /**
+     * 從目標路徑生成唯一檔名
+     * @param targetPath - 目標路徑（可能包含 "newfile" 等基礎名稱）
+     * @param sourceExtension - 來源檔案的副檔名
+     * @param directory - 目標目錄
+     * @returns 生成結果
+     */
+    generateFromTargetPath(targetPath: string, sourceExtension: string, directory: string): Promise<FileGenerationResult>;
+    /**
+     * 檢查檔案是否存在
+     * @param filePath - 檔案路徑
+     * @returns 是否存在
+     */
+    private fileExists;
+    /**
+     * 確保目錄存在
+     * @param dirPath - 目錄路徑
+     */
+    ensureDirectoryExists(dirPath: string): Promise<void>;
+    /**
+     * 建立新檔案
+     * @param filePath - 檔案路徑
+     * @param content - 檔案內容
+     */
+    createFile(filePath: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=file-generator.d.ts.map

package/dist/core/transform/location/shift/file-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-generator.d.ts","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/file-generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAEpF;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,WAAW;IACpD;;;;;OAKG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgChG;;;;;;OAMG;IACG,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IAahC;;;;OAIG;YACW,UAAU;IAQxB;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKnE"}

package/dist/core/transform/location/shift/file-generator.js

@@ -0,0 +1,94 @@
+/**
+ * 檔案生成器 - 處理檔名衝突
+ */
+import * as path from 'node:path';
+/**
+ * 檔案生成器類別
+ */
+export class FileGenerator {
+    fileSystem;
+    constructor(fileSystem) {
+        this.fileSystem = fileSystem;
+    }
+    /**
+     * 生成唯一檔名
+     * @param basePath - 基礎路徑（不含副檔名）
+     * @param extension - 副檔名（含點號，如 '.ts'）
+     * @returns 唯一的檔案路徑
+     */
+    async generateUniqueFilename(basePath, extension) {
+        const originalPath = `${basePath}${extension}`;
+        if (!(await this.fileExists(originalPath))) {
+            return {
+                filePath: originalPath,
+                isNew: true,
+                hasConflict: false
+            };
+        }
+        let suffix = 1;
+        let candidatePath = '';
+        do {
+            const paddedSuffix = suffix.toString().padStart(2, '0');
+            candidatePath = `${basePath}${paddedSuffix}${extension}`;
+            suffix++;
+        } while ((await this.fileExists(candidatePath)) && suffix < 100);
+        if (suffix >= 100) {
+            throw new Error(`無法生成唯一檔名：已存在 100 個相同名稱的檔案 (${basePath})`);
+        }
+        return {
+            filePath: candidatePath,
+            isNew: true,
+            hasConflict: true,
+            originalName: path.basename(originalPath)
+        };
+    }
+    /**
+     * 從目標路徑生成唯一檔名
+     * @param targetPath - 目標路徑（可能包含 "newfile" 等基礎名稱）
+     * @param sourceExtension - 來源檔案的副檔名
+     * @param directory - 目標目錄
+     * @returns 生成結果
+     */
+    async generateFromTargetPath(targetPath, sourceExtension, directory) {
+        const parsedPath = path.parse(targetPath);
+        // 如果目標路徑已經有副檔名，使用原有副檔名
+        const extension = parsedPath.ext || sourceExtension;
+        // 如果目標路徑沒有副檔名，需要添加
+        const baseName = parsedPath.ext ? parsedPath.name : parsedPath.base;
+        const basePath = path.join(directory, baseName);
+        return this.generateUniqueFilename(basePath, extension);
+    }
+    /**
+     * 檢查檔案是否存在
+     * @param filePath - 檔案路徑
+     * @returns 是否存在
+     */
+    async fileExists(filePath) {
+        try {
+            return await this.fileSystem.exists(filePath);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 確保目錄存在
+     * @param dirPath - 目錄路徑
+     */
+    async ensureDirectoryExists(dirPath) {
+        if (!(await this.fileSystem.exists(dirPath))) {
+            await this.fileSystem.createDirectory(dirPath);
+        }
+    }
+    /**
+     * 建立新檔案
+     * @param filePath - 檔案路徑
+     * @param content - 檔案內容
+     */
+    async createFile(filePath, content) {
+        const directory = path.dirname(filePath);
+        await this.ensureDirectoryExists(directory);
+        await this.fileSystem.writeFile(filePath, content);
+    }
+}
+//# sourceMappingURL=file-generator.js.map

package/dist/core/transform/location/shift/file-generator.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Shift 子模組
+ * 行級程式碼移動功能
+ */
+export { ShiftService } from './shift-service.js';
+export { LineExtractor } from './line-extractor.js';
+export { FileGenerator } from './file-generator.js';
+export type { ShiftOptions, ShiftResult, FileGenerationResult, LineExtractionResult, LineInsertionResult, ShiftValidationError } from './types.js';
+export { ShiftStatus, ShiftOperationType } from './types.js';
+export { createShiftResult, createShiftValidationError, isValidShiftOptions, isValidShiftResult } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Shift 子模組
+ * 行級程式碼移動功能
+ */
+// 核心服務類別
+export { ShiftService } from './shift-service.js';
+export { LineExtractor } from './line-extractor.js';
+export { FileGenerator } from './file-generator.js';
+// 列舉型別
+export { ShiftStatus, ShiftOperationType } from './types.js';
+// 工廠函式
+export { createShiftResult, createShiftValidationError, isValidShiftOptions, isValidShiftResult } from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYpD,OAAO;AACP,OAAO,EACL,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,OAAO;AACP,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC"}

package/dist/core/transform/location/shift/line-extractor.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 行提取器 - 負責行的提取、刪除和插入
+ */
+import type { LineExtractionResult, LineInsertionResult } from '../../../transform/location/shift/types.js';
+/**
+ * 行提取器類別
+ */
+export declare class LineExtractor {
+    /**
+     * 從內容中提取指定範圍的行
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號（1-based，包含）
+     * @param toLine - 結束行號（1-based，包含）
+     * @returns 提取結果
+     */
+    extractLines(content: string, fromLine: number, toLine: number): LineExtractionResult;
+    /**
+     * 在指定位置插入行
+     * @param content - 目標檔案內容
+     * @param linesToInsert - 要插入的行
+     * @param position - 插入位置（1-based，插入到此行之前）
+     * @returns 插入結果
+     */
+    insertLines(content: string, linesToInsert: readonly string[], position: number): LineInsertionResult;
+    /**
+     * 從內容中移除指定範圍的行
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號（1-based，包含）
+     * @param toLine - 結束行號（1-based，包含）
+     * @returns 移除後的內容
+     */
+    removeLines(content: string, fromLine: number, toLine: number): string;
+    /**
+     * 計算檔案的總行數
+     * @param content - 檔案內容
+     * @returns 總行數
+     */
+    countLines(content: string): number;
+    /**
+     * 驗證行號範圍是否有效
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號
+     * @param toLine - 結束行號
+     * @returns 是否有效
+     */
+    validateLineRange(content: string, fromLine: number, toLine: number): boolean;
+    /**
+     * 驗證插入位置是否有效
+     * @param content - 檔案內容
+     * @param position - 插入位置
+     * @returns 是否有效
+     */
+    validatePosition(content: string, position: number): boolean;
+}
+//# sourceMappingURL=line-extractor.d.ts.map

package/dist/core/transform/location/shift/line-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-extractor.d.ts","sourceRoot":"","sources":["../../../../../src/core/transform/location/shift/line-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEzG;;GAEG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB;IAyCrF;;;;;;OAMG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,QAAQ,EAAE,MAAM,GACf,mBAAmB;IA+BtB;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKtE;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAW7E;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAI7D"}

package/dist/core/transform/location/shift/line-extractor.js

@@ -0,0 +1,123 @@
+/**
+ * 行提取器 - 負責行的提取、刪除和插入
+ */
+/**
+ * 行提取器類別
+ */
+export class LineExtractor {
+    /**
+     * 從內容中提取指定範圍的行
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號（1-based，包含）
+     * @param toLine - 結束行號（1-based，包含）
+     * @returns 提取結果
+     */
+    extractLines(content, fromLine, toLine) {
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        // 驗證行號範圍
+        if (fromLine < 1) {
+            throw new Error(`起始行號必須 >= 1，實際值：${fromLine}`);
+        }
+        if (toLine < fromLine) {
+            throw new Error(`結束行號 (${toLine}) 不可小於起始行號 (${fromLine})`);
+        }
+        if (fromLine > totalLines) {
+            throw new Error(`起始行號 (${fromLine}) 超出檔案總行數 (${totalLines})`);
+        }
+        if (toLine > totalLines) {
+            throw new Error(`結束行號 (${toLine}) 超出檔案總行數 (${totalLines})`);
+        }
+        // 轉換為 0-based index
+        const startIndex = fromLine - 1;
+        const endIndex = toLine;
+        // 提取行（包含 fromLine 和 toLine）
+        const extractedLines = lines.slice(startIndex, endIndex);
+        // 移除提取的行
+        const remainingLines = [
+            ...lines.slice(0, startIndex),
+            ...lines.slice(endIndex)
+        ];
+        return {
+            extractedLines,
+            remainingContent: remainingLines.join('\n'),
+            linesCount: extractedLines.length
+        };
+    }
+    /**
+     * 在指定位置插入行
+     * @param content - 目標檔案內容
+     * @param linesToInsert - 要插入的行
+     * @param position - 插入位置（1-based，插入到此行之前）
+     * @returns 插入結果
+     */
+    insertLines(content, linesToInsert, position) {
+        const lines = content.split('\n');
+        const totalLines = lines.length;
+        // 驗證插入位置
+        if (position < 1) {
+            throw new Error(`插入位置必須 >= 1，實際值：${position}`);
+        }
+        // 允許插入到檔案末尾後（position = totalLines + 1）
+        if (position > totalLines + 1) {
+            throw new Error(`插入位置 (${position}) 超出有效範圍 (1-${totalLines + 1})`);
+        }
+        // 轉換為 0-based index
+        const insertIndex = position - 1;
+        // 插入行到指定位置之前
+        const resultLines = [
+            ...lines.slice(0, insertIndex),
+            ...linesToInsert,
+            ...lines.slice(insertIndex)
+        ];
+        return {
+            content: resultLines.join('\n'),
+            insertedAt: position,
+            linesCount: linesToInsert.length
+        };
+    }
+    /**
+     * 從內容中移除指定範圍的行
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號（1-based，包含）
+     * @param toLine - 結束行號（1-based，包含）
+     * @returns 移除後的內容
+     */
+    removeLines(content, fromLine, toLine) {
+        const result = this.extractLines(content, fromLine, toLine);
+        return result.remainingContent;
+    }
+    /**
+     * 計算檔案的總行數
+     * @param content - 檔案內容
+     * @returns 總行數
+     */
+    countLines(content) {
+        return content.split('\n').length;
+    }
+    /**
+     * 驗證行號範圍是否有效
+     * @param content - 檔案內容
+     * @param fromLine - 起始行號
+     * @param toLine - 結束行號
+     * @returns 是否有效
+     */
+    validateLineRange(content, fromLine, toLine) {
+        const totalLines = this.countLines(content);
+        return (fromLine >= 1 &&
+            toLine >= fromLine &&
+            fromLine <= totalLines &&
+            toLine <= totalLines);
+    }
+    /**
+     * 驗證插入位置是否有效
+     * @param content - 檔案內容
+     * @param position - 插入位置
+     * @returns 是否有效
+     */
+    validatePosition(content, position) {
+        const totalLines = this.countLines(content);
+        return position >= 1 && position <= totalLines + 1;
+    }
+}
+//# sourceMappingURL=line-extractor.js.map

package/dist/core/transform/location/shift/line-extractor.js.map

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