agent-ide 0.1.10 → 0.3.3

package/dist/interfaces/cli/commands/snapshot.command.js

@@ -0,0 +1,68 @@
+/**
+ * Snapshot 命令
+ * 產生模組快照供 AI 理解
+ */
+import * as path from 'path';
+import { SnapshotGenerator, isProjectSnapshot } from '../../../core/snapshot/index.js';
+import { createUnifiedOutputHandler, parseOutputFormat, OutputFormat } from '../../cli/unified-output-handler.js';
+import { QueryCommand } from '../../../infrastructure/formatters/query-types.js';
+/**
+ * 設定 snapshot 命令
+ */
+export function setupSnapshotCommand(program, context) {
+    program
+        .command('snapshot')
+        .description('產生模組快照供 AI 理解')
+        .option('-p, --path <path>', '目標路徑', '.')
+        .option('--format <format>', '輸出格式 (json|summary)', 'json')
+        .action(async (options) => {
+        await handleSnapshotCommand(options, context);
+    });
+}
+/**
+ * 處理 snapshot 命令
+ */
+async function handleSnapshotCommand(options, context) {
+    const outputHandler = createUnifiedOutputHandler();
+    let format;
+    try {
+        format = parseOutputFormat(options.format, false);
+    }
+    catch {
+        outputHandler.outputError('不支援的輸出格式。可用格式: json, summary', OutputFormat.Summary);
+        process.exitCode = 1;
+        return;
+    }
+    const targetPath = path.resolve(options.path);
+    // 檢查路徑是否存在
+    const exists = await context.fileSystem.exists(targetPath);
+    if (!exists) {
+        outputHandler.outputError(`路徑不存在: ${targetPath}`, format);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const generator = new SnapshotGenerator(context.fileSystem);
+        const rawResult = await generator.generate(targetPath);
+        // 建構 SnapshotResult
+        const isProject = isProjectSnapshot(rawResult);
+        const result = {
+            command: QueryCommand.Snapshot,
+            success: true,
+            summary: {
+                totalScanned: isProject
+                    ? Object.keys(rawResult.modules).length
+                    : 1
+            },
+            snapshotType: isProject ? 'project' : 'module',
+            snapshot: rawResult
+        };
+        outputHandler.outputQuery(result, format);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '未知錯誤';
+        outputHandler.outputError(`產生快照失敗: ${message}`, format);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=snapshot.command.js.map

package/dist/interfaces/cli/commands/snapshot.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.command.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/snapshot.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACxH,OAAO,EAAE,YAAY,EAA0E,MAAM,2CAA2C,CAAC;AASjJ;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAuB;IAC5E,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,GAAG,CAAC;SACxC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,OAAwB,EAAE,EAAE;QACzC,MAAM,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAAwB,EAAE,OAAuB;IACpF,MAAM,aAAa,GAAG,0BAA0B,EAAE,CAAC;IACnD,IAAI,MAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,WAAW,CAAC,8BAA8B,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAChF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,WAAW;IACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,WAAW,CAAC,UAAU,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEvD,oBAAoB;QACpB,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAmB;YAC7B,OAAO,EAAE,YAAY,CAAC,QAAQ;YAC9B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,SAAS;oBACrB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM;oBACvC,CAAC,CAAC,CAAC;aACN;YACD,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAC9C,QAAQ,EAAE,SAAqD;SAChE,CAAC;QAEF,aAAa,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAChE,aAAa,CAAC,WAAW,CAAC,WAAW,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/interfaces/cli/commands/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI 命令共用型別定義
+ */
+import type { Command } from 'commander';
+import type { IFileSystem } from '../../../infrastructure/storage/index.js';
+/**
+ * 命令共用 Context
+ * 包含所有命令可能需要的共用依賴
+ */
+export interface CommandContext {
+    /** 檔案系統實例 */
+    readonly fileSystem: IFileSystem;
+}
+/**
+ * 命令設定函數簽章
+ */
+export type CommandSetup = (program: Command, context: CommandContext) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/interfaces/cli/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/dist/interfaces/cli/commands/types.js

@@ -0,0 +1,5 @@
+/**
+ * CLI 命令共用型別定義
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/interfaces/cli/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/interfaces/cli/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/interfaces/cli/index.d.ts

@@ -2,6 +2,6 @@
 /**
  * CLI 入口點
  */
-import { AgentIdeCLI } from './cli.js';
+import { AgentIdeCLI } from '../cli/cli.js';
 export { AgentIdeCLI };
 //# sourceMappingURL=index.d.ts.map

package/dist/interfaces/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBvC,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAkBrD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/interfaces/cli/index.js

@@ -2,7 +2,7 @@
 /**
  * CLI 入口點
  */
-import { AgentIdeCLI } from './cli.js';
+import { AgentIdeCLI } from '../cli/cli.js';
 // 啟動 CLI
 async function main() {
     const cli = new AgentIdeCLI();

package/dist/interfaces/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,SAAS;AACT,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/cli/index.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,SAAS;AACT,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/interfaces/cli/preview-output-handler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * CLI Preview 輸出處理器
+ * 統一處理所有支援 dry-run 命令的輸出
+ */
+import { type PreviewResult, type PreviewInput } from '../../infrastructure/formatters/index.js';
+/** CLI 輸出格式選項 */
+export declare enum OutputFormatOption {
+    Diff = "diff",
+    Json = "json",
+    Summary = "summary"
+}
+/** 輸出選項 */
+export interface PreviewOutputOptions {
+    /** 輸出格式 */
+    format: OutputFormatOption;
+    /** 是否啟用顏色 */
+    color?: boolean;
+    /** 上下文行數 */
+    contextLines?: number;
+}
+/**
+ * Preview 輸出處理器
+ * 統一處理 dry-run 和實際執行的輸出
+ */
+export declare class PreviewOutputHandler {
+    private readonly formatter;
+    constructor(options?: Partial<PreviewOutputOptions>);
+    /**
+     * 從 PreviewInput 生成並輸出 PreviewResult
+     */
+    output(input: PreviewInput, format: OutputFormatOption): void;
+    /**
+     * 直接輸出 PreviewResult
+     */
+    outputResult(result: PreviewResult, format: OutputFormatOption): void;
+    /**
+     * 取得 PreviewResult（不輸出）
+     */
+    createResult(input: PreviewInput): PreviewResult;
+    /**
+     * 格式化為字串（不輸出）
+     */
+    formatResult(result: PreviewResult, format: OutputFormatOption): string;
+    /**
+     * CLI format 選項映射到 PreviewFormat
+     */
+    private mapFormat;
+}
+/**
+ * 建立 PreviewOutputHandler 的工廠函數
+ */
+export declare function createOutputHandler(options?: Partial<PreviewOutputOptions>): PreviewOutputHandler;
+//# sourceMappingURL=preview-output-handler.d.ts.map

package/dist/interfaces/cli/preview-output-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-output-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/preview-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAElD,iBAAiB;AACjB,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,WAAW;AACX,MAAM,WAAW,oBAAoB;IACnC,WAAW;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAEf,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAOvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAK7D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAKrE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAIhD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAKvE;;OAEG;IACH,OAAO,CAAC,SAAS;CAWlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAEjG"}

package/dist/interfaces/cli/preview-output-handler.js

@@ -0,0 +1,73 @@
+/**
+ * CLI Preview 輸出處理器
+ * 統一處理所有支援 dry-run 命令的輸出
+ */
+import { createPreviewFormatter, PreviewFormat } from '../../infrastructure/formatters/index.js';
+/** CLI 輸出格式選項 */
+export var OutputFormatOption;
+(function (OutputFormatOption) {
+    OutputFormatOption["Diff"] = "diff";
+    OutputFormatOption["Json"] = "json";
+    OutputFormatOption["Summary"] = "summary";
+})(OutputFormatOption || (OutputFormatOption = {}));
+/**
+ * Preview 輸出處理器
+ * 統一處理 dry-run 和實際執行的輸出
+ */
+export class PreviewOutputHandler {
+    formatter;
+    constructor(options = {}) {
+        this.formatter = createPreviewFormatter({
+            contextLines: options.contextLines ?? 3,
+            color: options.color ?? (process.stdout.isTTY ?? false)
+        });
+    }
+    /**
+     * 從 PreviewInput 生成並輸出 PreviewResult
+     */
+    output(input, format) {
+        const result = this.formatter.createPreview(input);
+        this.outputResult(result, format);
+    }
+    /**
+     * 直接輸出 PreviewResult
+     */
+    outputResult(result, format) {
+        const outputFormat = this.mapFormat(format);
+        console.log(this.formatter.format(result, outputFormat));
+    }
+    /**
+     * 取得 PreviewResult（不輸出）
+     */
+    createResult(input) {
+        return this.formatter.createPreview(input);
+    }
+    /**
+     * 格式化為字串（不輸出）
+     */
+    formatResult(result, format) {
+        const outputFormat = this.mapFormat(format);
+        return this.formatter.format(result, outputFormat);
+    }
+    /**
+     * CLI format 選項映射到 PreviewFormat
+     */
+    mapFormat(format) {
+        switch (format) {
+            case OutputFormatOption.Json:
+                return PreviewFormat.Json;
+            case OutputFormatOption.Summary:
+                return PreviewFormat.Summary;
+            case OutputFormatOption.Diff:
+            default:
+                return PreviewFormat.Diff;
+        }
+    }
+}
+/**
+ * 建立 PreviewOutputHandler 的工廠函數
+ */
+export function createOutputHandler(options) {
+    return new PreviewOutputHandler(options);
+}
+//# sourceMappingURL=preview-output-handler.js.map

package/dist/interfaces/cli/preview-output-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-output-handler.js","sourceRoot":"","sources":["../../../src/interfaces/cli/preview-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sBAAsB,EACtB,aAAa,EAGd,MAAM,0CAA0C,CAAC;AAElD,iBAAiB;AACjB,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mCAAa,CAAA;IACb,yCAAmB,CAAA;AACrB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AAYD;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,CAAC;IAE3B,YAAY,UAAyC,EAAE;QACrD,IAAI,CAAC,SAAS,GAAG,sBAAsB,CAAC;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;YACvC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAmB,EAAE,MAA0B;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAqB,EAAE,MAA0B;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAmB;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAqB,EAAE,MAA0B;QAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,MAA0B;QAC1C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,kBAAkB,CAAC,IAAI;gBAC1B,OAAO,aAAa,CAAC,IAAI,CAAC;YAC5B,KAAK,kBAAkB,CAAC,OAAO;gBAC7B,OAAO,aAAa,CAAC,OAAO,CAAC;YAC/B,KAAK,kBAAkB,CAAC,IAAI,CAAC;YAC7B;gBACE,OAAO,aAAa,CAAC,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuC;IACzE,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/interfaces/cli/unified-output-handler.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 統一輸出處理器
+ * 整合變更類（PreviewFormatter）和唯讀類（QueryFormatter）的輸出處理
+ */
+import { type PreviewResult, type PreviewInput } from '../../infrastructure/formatters/index.js';
+import type { QueryResult } from '../../infrastructure/formatters/query-types.js';
+/** 統一輸出格式 */
+export declare enum OutputFormat {
+    /** JSON 格式（機器可讀） */
+    Json = "json",
+    /** 摘要格式（人類可讀） */
+    Summary = "summary",
+    /** Diff 格式（僅變更類命令） */
+    Diff = "diff"
+}
+/** 輸出處理器選項 */
+export interface UnifiedOutputOptions {
+    /** 是否啟用顏色 */
+    color?: boolean;
+    /** 上下文行數（僅變更類命令） */
+    contextLines?: number;
+}
+/**
+ * 統一輸出處理器
+ * 處理所有 CLI 命令的輸出
+ */
+export declare class UnifiedOutputHandler {
+    private readonly previewFormatter;
+    private readonly queryFormatter;
+    constructor(options?: UnifiedOutputOptions);
+    /**
+     * 從 PreviewInput 生成並輸出變更類結果
+     */
+    outputMutation(input: PreviewInput, format: OutputFormat): void;
+    /**
+     * 直接輸出變更類結果
+     */
+    outputMutationResult(result: PreviewResult, format: OutputFormat): void;
+    /**
+     * 格式化變更類結果（不輸出）
+     */
+    formatMutationResult(result: PreviewResult, format: OutputFormat): string;
+    /**
+     * 建立變更類結果（不輸出）
+     */
+    createMutationResult(input: PreviewInput): PreviewResult;
+    /**
+     * 輸出唯讀類結果
+     */
+    outputQuery(result: QueryResult, format: OutputFormat): void;
+    /**
+     * 格式化唯讀類結果（不輸出）
+     */
+    formatQueryResult(result: QueryResult, format: OutputFormat): string;
+    /**
+     * 輸出錯誤
+     */
+    outputError(error: Error | string, format: OutputFormat): void;
+    /**
+     * 映射 OutputFormat 到 PreviewFormat
+     */
+    private mapToPreviewFormat;
+    /**
+     * 映射 OutputFormat 到 QueryFormat
+     */
+    private mapToQueryFormat;
+}
+/**
+ * 建立 UnifiedOutputHandler 的工廠函數
+ */
+export declare function createUnifiedOutputHandler(options?: UnifiedOutputOptions): UnifiedOutputHandler;
+/**
+ * 解析 format 字串為 OutputFormat
+ * @throws Error 如果格式無效
+ */
+export declare function parseOutputFormat(format: string, allowDiff?: boolean): OutputFormat;
+//# sourceMappingURL=unified-output-handler.d.ts.map

package/dist/interfaces/cli/unified-output-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-output-handler.d.ts","sourceRoot":"","sources":["../../../src/interfaces/cli/unified-output-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAC;AAKlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAE7E,aAAa;AACb,oBAAY,YAAY;IACtB,oBAAoB;IACpB,IAAI,SAAS;IACb,iBAAiB;IACjB,OAAO,YAAY;IACnB,sBAAsB;IACtB,IAAI,SAAS;CACd;AAED,cAAc;AACd,MAAM,WAAW,oBAAoB;IACnC,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAEpB,OAAO,GAAE,oBAAyB;IAa9C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAK/D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAIvE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAKzE;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAMxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAI5D;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM;IAOpE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAY9D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAE/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,YAAY,CAchF"}

package/dist/interfaces/cli/unified-output-handler.js

@@ -0,0 +1,140 @@
+/**
+ * 統一輸出處理器
+ * 整合變更類（PreviewFormatter）和唯讀類（QueryFormatter）的輸出處理
+ */
+import { createPreviewFormatter, PreviewFormat } from '../../infrastructure/formatters/index.js';
+import { createQueryFormatter, QueryFormat } from '../../infrastructure/formatters/query-formatter.js';
+/** 統一輸出格式 */
+export var OutputFormat;
+(function (OutputFormat) {
+    /** JSON 格式（機器可讀） */
+    OutputFormat["Json"] = "json";
+    /** 摘要格式（人類可讀） */
+    OutputFormat["Summary"] = "summary";
+    /** Diff 格式（僅變更類命令） */
+    OutputFormat["Diff"] = "diff";
+})(OutputFormat || (OutputFormat = {}));
+/**
+ * 統一輸出處理器
+ * 處理所有 CLI 命令的輸出
+ */
+export class UnifiedOutputHandler {
+    previewFormatter;
+    queryFormatter;
+    constructor(options = {}) {
+        const color = options.color ?? (process.stdout.isTTY ?? false);
+        this.previewFormatter = createPreviewFormatter({
+            contextLines: options.contextLines ?? 3,
+            color
+        });
+        this.queryFormatter = createQueryFormatter({ color });
+    }
+    // ========== 變更類命令（Mutation）方法 ==========
+    /**
+     * 從 PreviewInput 生成並輸出變更類結果
+     */
+    outputMutation(input, format) {
+        const result = this.previewFormatter.createPreview(input);
+        this.outputMutationResult(result, format);
+    }
+    /**
+     * 直接輸出變更類結果
+     */
+    outputMutationResult(result, format) {
+        console.log(this.formatMutationResult(result, format));
+    }
+    /**
+     * 格式化變更類結果（不輸出）
+     */
+    formatMutationResult(result, format) {
+        const previewFormat = this.mapToPreviewFormat(format);
+        return this.previewFormatter.format(result, previewFormat);
+    }
+    /**
+     * 建立變更類結果（不輸出）
+     */
+    createMutationResult(input) {
+        return this.previewFormatter.createPreview(input);
+    }
+    // ========== 唯讀類命令（Query）方法 ==========
+    /**
+     * 輸出唯讀類結果
+     */
+    outputQuery(result, format) {
+        console.log(this.formatQueryResult(result, format));
+    }
+    /**
+     * 格式化唯讀類結果（不輸出）
+     */
+    formatQueryResult(result, format) {
+        const queryFormat = this.mapToQueryFormat(format);
+        return this.queryFormatter.format(result, queryFormat);
+    }
+    // ========== 通用方法 ==========
+    /**
+     * 輸出錯誤
+     */
+    outputError(error, format) {
+        const message = error instanceof Error ? error.message : error;
+        if (format === OutputFormat.Json) {
+            console.error(JSON.stringify({ success: false, error: message }));
+        }
+        else {
+            console.error(`\n❌ 錯誤: ${message}`);
+        }
+    }
+    // ========== Private 方法 ==========
+    /**
+     * 映射 OutputFormat 到 PreviewFormat
+     */
+    mapToPreviewFormat(format) {
+        switch (format) {
+            case OutputFormat.Json:
+                return PreviewFormat.Json;
+            case OutputFormat.Summary:
+                return PreviewFormat.Summary;
+            case OutputFormat.Diff:
+            default:
+                return PreviewFormat.Diff;
+        }
+    }
+    /**
+     * 映射 OutputFormat 到 QueryFormat
+     */
+    mapToQueryFormat(format) {
+        switch (format) {
+            case OutputFormat.Json:
+                return QueryFormat.Json;
+            case OutputFormat.Summary:
+            case OutputFormat.Diff: // 唯讀命令不支援 diff，fallback 到 summary
+            default:
+                return QueryFormat.Summary;
+        }
+    }
+}
+/**
+ * 建立 UnifiedOutputHandler 的工廠函數
+ */
+export function createUnifiedOutputHandler(options) {
+    return new UnifiedOutputHandler(options);
+}
+/**
+ * 解析 format 字串為 OutputFormat
+ * @throws Error 如果格式無效
+ */
+export function parseOutputFormat(format, allowDiff = true) {
+    switch (format.toLowerCase()) {
+        case 'json':
+            return OutputFormat.Json;
+        case 'summary':
+            return OutputFormat.Summary;
+        case 'diff':
+            if (!allowDiff) {
+                throw new Error(`不支援的輸出格式: ${format}。可用格式: json, summary`);
+            }
+            return OutputFormat.Diff;
+        default:
+            throw new Error(`不支援的輸出格式: ${format}。可用格式: json, summary${allowDiff ? ', diff' : ''}`);
+    }
+}
+//# sourceMappingURL=unified-output-handler.js.map

package/dist/interfaces/cli/unified-output-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-output-handler.js","sourceRoot":"","sources":["../../../src/interfaces/cli/unified-output-handler.ts"],"names":[],"mappings":"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"}

package/dist/plugins/javascript/index.d.ts

@@ -4,8 +4,8 @@
  */
 export type { JavaScriptAST, JavaScriptASTNode, JavaScriptSymbol, JavaScriptParseOptions, BabelPlugin } from './types.js';
 export { DEFAULT_PARSE_OPTIONS, JavaScriptParseError, createJavaScriptASTNode, createParseError, babelLocationToPosition, getNodeName, isValidIdentifier, isSymbolDeclaration, isDependencyNode, getDependencyPath, isRelativePath, getImportedSymbols, getPluginsForFile, getScopeType, isReservedWord, BABEL_NODE_TYPE_MAP, BABEL_SYMBOL_TYPE_MAP } from './types.js';
-import { JavaScriptParser } from './parser.js';
-import type { JavaScriptParseOptions } from './types.js';
+import { JavaScriptParser } from '../javascript/parser.js';
+import type { JavaScriptParseOptions } from '../javascript/types.js';
 export { JavaScriptParser };
 export declare function createJavaScriptParser(options?: Partial<JavaScriptParseOptions>): JavaScriptParser;
 export default JavaScriptParser;

package/dist/plugins/javascript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAG5B,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,oBAE/E;AAGD,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAG5B,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,oBAE/E;AAGD,eAAe,gBAAgB,CAAC"}

package/dist/plugins/javascript/index.js

@@ -5,7 +5,7 @@
 // 工具函式
 export { DEFAULT_PARSE_OPTIONS, JavaScriptParseError, createJavaScriptASTNode, createParseError, babelLocationToPosition, getNodeName, isValidIdentifier, isSymbolDeclaration, isDependencyNode, getDependencyPath, isRelativePath, getImportedSymbols, getPluginsForFile, getScopeType, isReservedWord, BABEL_NODE_TYPE_MAP, BABEL_SYMBOL_TYPE_MAP } from './types.js';
 // 主要 Parser 類別
-import { JavaScriptParser } from './parser.js';
+import { JavaScriptParser } from '../javascript/parser.js';
 export { JavaScriptParser };
 // 建立 Parser 實例的工廠函式
 export function createJavaScriptParser(options) {

package/dist/plugins/javascript/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/javascript/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO;AACP,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,oBAAoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,OAAyC;IAC9E,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,OAAO;AACP,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/javascript/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO;AACP,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,oBAAoB;AACpB,MAAM,UAAU,sBAAsB,CAAC,OAAyC;IAC9E,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,OAAO;AACP,eAAe,gBAAgB,CAAC"}

package/dist/plugins/javascript/parser.d.ts

@@ -94,5 +94,46 @@ export declare class JavaScriptParser implements ParserPlugin {
     private symbolTypeToDefinitionKind;
     private findSymbolAtPosition;
     private isPositionInRange;
+    /**
+     * 檢測未使用的符號（JavaScript 基本實作）
+     */
+    detectUnusedSymbols(_ast: AST, _allSymbols: Symbol[]): Promise<any[]>;
+    /**
+     * 分析程式碼複雜度
+     */
+    analyzeComplexity(_code: string, _ast: AST): Promise<any>;
+    /**
+     * 提取程式碼片段（用於重複代碼檢測）
+     */
+    extractCodeFragments(code: string, filePath: string): Promise<import('../../infrastructure/parser/analysis-types.js').CodeFragment[]>;
+    private extractTopLevelComments;
+    private extractMethods;
+    private extractConstants;
+    private extractConfigObjects;
+    private tokenizeCode;
+    /**
+     * 檢測樣板模式
+     */
+    detectPatterns(_code: string, _ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').PatternMatch[]>;
+    /**
+     * 檢查型別安全問題（JavaScript 無型別系統）
+     */
+    checkTypeSafety(_code: string, _ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').TypeSafetyIssue[]>;
+    /**
+     * 檢查錯誤處理問題
+     */
+    checkErrorHandling(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').ErrorHandlingIssue[]>;
+    /**
+     * 檢查安全性問題
+     */
+    checkSecurity(code: string, ast: AST): Promise<import('../../infrastructure/parser/analysis-types.js').SecurityIssue[]>;
+    /**
+     * 檢查命名規範問題
+     */
+    checkNamingConventions(symbols: Symbol[], filePath: string): Promise<import('../../infrastructure/parser/analysis-types.js').NamingIssue[]>;
+    /**
+     * 判斷檔案是否為測試檔案
+     */
+    isTestFile(filePath: string): boolean;
 }
 //# sourceMappingURL=parser.d.ts.map

package/dist/plugins/javascript/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,gBAAgB,EAOjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EACN,SAAS,EACT,UAAU,EACV,QAAQ,EACR,KAAK,EACN,MAAM,6BAA6B,CAAC;AAWrC,OAAO,EAIL,sBAAsB,EAgBvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,OAAO,WAAW;IAClC,SAAgB,mBAAmB,2CAA4C;IAC/E,SAAgB,kBAAkB,iCAAkC;IAEpE,OAAO,CAAC,YAAY,CAAyB;gBAEjC,YAAY,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAI1D;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwCzD;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmDjD;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAuCpE;;OAEG;IACG,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA0B1D;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA8BhF;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKtE;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAW9E;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAS5D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsB3C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;OAGG;IACH,yBAAyB,IAAI,MAAM,EAAE;IA2BrC;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IA+B3C;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM9C,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,uBAAuB;IAqB/B,OAAO,CAAC,+BAA+B;IA4CvC,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,0BAA0B;YAyBpB,oBAAoB;IAalC,OAAO,CAAC,iBAAiB;CAe1B"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/parser.ts"],"names":[],"mappings":"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"}