agent-ide 0.1.0

package/dist/shared/types/ast.js

@@ -0,0 +1,215 @@
+/**
+ * AST 相關型別定義
+ * 包含 ASTNode、ASTMetadata、AST 等型別
+ */
+import { isPositionInRange } from './core.js';
+/**
+ * 建立 ASTNode 的工廠函式
+ */
+export function createASTNode(type, range, properties = {}, children = []) {
+    if (!type.trim()) {
+        throw new Error('ASTNode 類型不能為空');
+    }
+    // 驗證子節點範圍必須在父節點範圍內
+    for (const child of children) {
+        if (!isRangeContained(child.range, range)) {
+            throw new Error('子節點範圍必須在父節點範圍內');
+        }
+    }
+    // 先建立節點但不設定 parent
+    const childrenCopy = children.map(child => ({ ...child }));
+    const node = {
+        type,
+        range,
+        properties,
+        children: childrenCopy
+    };
+    // 然後遞歸設定所有子節點的 parent 關係
+    setParentRelationships(node);
+    return node;
+}
+/**
+ * 建立 ASTMetadata 的工廠函式
+ */
+export function createASTMetadata(language, version, parserOptions = {}, parseTime = 0, nodeCount = 0) {
+    if (!language.trim()) {
+        throw new Error('語言名稱不能為空');
+    }
+    if (!version.trim()) {
+        throw new Error('版本號不能為空');
+    }
+    return {
+        language,
+        version,
+        parserOptions,
+        parseTime: parseTime || Date.now(),
+        nodeCount
+    };
+}
+/**
+ * 建立 AST 的工廠函式
+ */
+export function createAST(sourceFile, root, metadata) {
+    if (!sourceFile.trim()) {
+        throw new Error('原始檔案名稱不能為空');
+    }
+    // 計算節點數量
+    const nodeCount = countNodes(root);
+    const updatedMetadata = { ...metadata, nodeCount };
+    return {
+        sourceFile,
+        root,
+        metadata: updatedMetadata
+    };
+}
+/**
+ * ASTNode 型別守衛
+ */
+export function isASTNode(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.type === 'string' &&
+        obj.type.trim().length > 0 &&
+        obj.range && typeof obj.range === 'object' &&
+        obj.properties && typeof obj.properties === 'object' &&
+        Array.isArray(obj.children));
+}
+/**
+ * ASTMetadata 型別守衛
+ */
+export function isASTMetadata(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.language === 'string' &&
+        obj.language.trim().length > 0 &&
+        typeof obj.version === 'string' &&
+        obj.version.trim().length > 0 &&
+        obj.parserOptions && typeof obj.parserOptions === 'object' &&
+        typeof obj.parseTime === 'number' &&
+        typeof obj.nodeCount === 'number');
+}
+/**
+ * AST 型別守衛
+ */
+export function isAST(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.sourceFile === 'string' &&
+        obj.sourceFile.trim().length > 0 &&
+        isASTNode(obj.root) &&
+        isASTMetadata(obj.metadata));
+}
+/**
+ * 根據位置找到對應的 AST 節點
+ */
+export function findNodeByPosition(ast, position) {
+    return findNodeByPositionRecursive(ast.root, position);
+}
+/**
+ * 根據類型找到所有匹配的 AST 節點
+ */
+export function findNodesByType(ast, type) {
+    const result = [];
+    findNodesByTypeRecursive(ast.root, type, result);
+    return result;
+}
+/**
+ * 取得節點的路徑（從根節點到該節點的類型路徑）
+ */
+export function getNodePath(node) {
+    const path = [];
+    let currentNode = node;
+    while (currentNode) {
+        path.unshift(currentNode.type);
+        currentNode = currentNode.parent;
+    }
+    return path;
+}
+/**
+ * 計算節點的深度
+ */
+export function getNodeDepth(node) {
+    let depth = 0;
+    let currentNode = node.parent;
+    while (currentNode) {
+        depth++;
+        currentNode = currentNode.parent;
+    }
+    return depth;
+}
+/**
+ * 檢查一個節點是否是另一個節點的祖先
+ */
+export function isNodeAncestorOf(ancestor, descendant) {
+    let currentNode = descendant.parent;
+    while (currentNode) {
+        if (currentNode === ancestor) {
+            return true;
+        }
+        currentNode = currentNode.parent;
+    }
+    return false;
+}
+// 輔助函式
+/**
+ * 檢查一個範圍是否完全包含在另一個範圍內
+ */
+function isRangeContained(inner, outer) {
+    return isPositionInRange(inner.start, outer) && isPositionInRange(inner.end, outer);
+}
+/**
+ * 遞歸計算節點數量
+ */
+function countNodes(node) {
+    let count = 1; // 計算自己
+    for (const child of node.children) {
+        count += countNodes(child);
+    }
+    return count;
+}
+/**
+ * 遞歸搜尋位置對應的節點
+ */
+function findNodeByPositionRecursive(node, position) {
+    if (!isPositionInRange(position, node.range)) {
+        return null;
+    }
+    // 先檢查子節點，找到最具體的節點
+    for (const child of node.children) {
+        const result = findNodeByPositionRecursive(child, position);
+        if (result) {
+            return result;
+        }
+    }
+    // 如果子節點中沒有找到，返回當前節點
+    return node;
+}
+/**
+ * 遞歸搜尋類型匹配的節點
+ */
+function findNodesByTypeRecursive(node, type, result) {
+    if (node.type === type) {
+        result.push(node);
+    }
+    for (const child of node.children) {
+        findNodesByTypeRecursive(child, type, result);
+    }
+}
+/**
+ * 遞歸設定節點的 parent 關係
+ */
+function setParentRelationships(node, parent) {
+    // 設定當前節點的 parent
+    node.parent = parent;
+    // 遞歸設定所有子節點的 parent
+    for (const child of node.children) {
+        setParentRelationships(child, node);
+    }
+}
+//# sourceMappingURL=ast.js.map

package/dist/shared/types/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/shared/types/ast.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/core.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 核心型別定義
+ * 包含 Position、Range、Location 等基礎型別
+ */
+/**
+ * 表示程式碼中的位置
+ */
+export interface Position {
+    readonly line: number;
+    readonly column: number;
+    readonly offset: number | undefined;
+}
+/**
+ * 表示程式碼中的範圍
+ */
+export interface Range {
+    readonly start: Position;
+    readonly end: Position;
+}
+/**
+ * 表示檔案中的位置
+ */
+export interface Location {
+    readonly filePath: string;
+    readonly range: Range;
+}
+/**
+ * 建立 Position 的工廠函式
+ */
+export declare function createPosition(line: number, column: number, offset?: number): Position;
+/**
+ * 建立 Range 的工廠函式
+ */
+export declare function createRange(start: Position, end: Position): Range;
+/**
+ * 建立 Location 的工廠函式
+ */
+export declare function createLocation(filePath: string, range: Range): Location;
+/**
+ * Position 型別守衛
+ */
+export declare function isPosition(value: unknown): value is Position;
+/**
+ * Range 型別守衛
+ */
+export declare function isRange(value: unknown): value is Range;
+/**
+ * Location 型別守衛
+ */
+export declare function isLocation(value: unknown): value is Location;
+/**
+ * 比較兩個 Position 的先後順序
+ * @param pos1 第一個位置
+ * @param pos2 第二個位置
+ * @returns pos1 是否在 pos2 之前
+ */
+export declare function isPositionBefore(pos1: Position, pos2: Position): boolean;
+/**
+ * 檢查 Position 是否在 Range 範圍內（包含邊界）
+ * @param position 要檢查的位置
+ * @param range 範圍
+ * @returns 是否在範圍內
+ */
+export declare function isPositionInRange(position: Position, range: Range): boolean;
+//# sourceMappingURL=core.d.ts.map

package/dist/shared/types/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/shared/types/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAgBtF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,KAAK,CASjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,CASvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAc5D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAYtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAY5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAKxE;AASD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAK3E"}

package/dist/shared/types/core.js

@@ -0,0 +1,114 @@
+/**
+ * 核心型別定義
+ * 包含 Position、Range、Location 等基礎型別
+ */
+/**
+ * 建立 Position 的工廠函式
+ */
+export function createPosition(line, column, offset) {
+    if (line < 1) {
+        throw new Error('Line 必須大於等於 1');
+    }
+    if (column < 1) {
+        throw new Error('Column 必須大於等於 1');
+    }
+    if (offset !== undefined && offset < 0) {
+        throw new Error('Offset 必須大於等於 0');
+    }
+    return {
+        line,
+        column,
+        offset: offset !== undefined ? offset : undefined
+    };
+}
+/**
+ * 建立 Range 的工廠函式
+ */
+export function createRange(start, end) {
+    if (isPositionAfter(start, end)) {
+        throw new Error('Range 的 start 不能在 end 之後');
+    }
+    return {
+        start,
+        end
+    };
+}
+/**
+ * 建立 Location 的工廠函式
+ */
+export function createLocation(filePath, range) {
+    if (!filePath.trim()) {
+        throw new Error('檔案路徑不能為空');
+    }
+    return {
+        filePath,
+        range
+    };
+}
+/**
+ * Position 型別守衛
+ */
+export function isPosition(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.line === 'number' &&
+        obj.line >= 1 &&
+        typeof obj.column === 'number' &&
+        obj.column >= 1 &&
+        (obj.offset === undefined || (typeof obj.offset === 'number' && obj.offset >= 0)));
+}
+/**
+ * Range 型別守衛
+ */
+export function isRange(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (isPosition(obj.start) &&
+        isPosition(obj.end) &&
+        !isPositionAfter(obj.start, obj.end));
+}
+/**
+ * Location 型別守衛
+ */
+export function isLocation(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const obj = value;
+    return (typeof obj.filePath === 'string' &&
+        obj.filePath.trim().length > 0 &&
+        isRange(obj.range));
+}
+/**
+ * 比較兩個 Position 的先後順序
+ * @param pos1 第一個位置
+ * @param pos2 第二個位置
+ * @returns pos1 是否在 pos2 之前
+ */
+export function isPositionBefore(pos1, pos2) {
+    if (pos1.line !== pos2.line) {
+        return pos1.line < pos2.line;
+    }
+    return pos1.column < pos2.column;
+}
+/**
+ * 檢查 pos1 是否在 pos2 之後
+ */
+function isPositionAfter(pos1, pos2) {
+    return isPositionBefore(pos2, pos1);
+}
+/**
+ * 檢查 Position 是否在 Range 範圍內（包含邊界）
+ * @param position 要檢查的位置
+ * @param range 範圍
+ * @returns 是否在範圍內
+ */
+export function isPositionInRange(position, range) {
+    return (!isPositionBefore(position, range.start) &&
+        !isPositionAfter(position, range.end));
+}
+//# sourceMappingURL=core.js.map

package/dist/shared/types/core.js.map

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

package/dist/shared/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 核心型別系統統一匯出
+ */
+export * from './core.js';
+export * from './symbol.js';
+export * from './ast.js';
+export type { Position, Range, Location } from './core.js';
+export { SymbolType, ReferenceType, DependencyType } from './symbol.js';
+export type { Scope, Symbol, Reference, Dependency } from './symbol.js';
+export type { ASTNode, ASTMetadata, AST } from './ast.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC;AAG5B,cAAc,UAAU,CAAC;AAGzB,YAAY,EACV,QAAQ,EACR,KAAK,EACL,QAAQ,EACT,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,KAAK,EACL,MAAM,EACN,SAAS,EACT,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,OAAO,EACP,WAAW,EACX,GAAG,EACJ,MAAM,UAAU,CAAC"}

package/dist/shared/types/index.js

@@ -0,0 +1,12 @@
+/**
+ * 核心型別系統統一匯出
+ */
+// 核心型別
+export * from './core.js';
+// Symbol 相關型別
+export * from './symbol.js';
+// AST 相關型別
+export * from './ast.js';
+// enum 需要正常匯出
+export { SymbolType, ReferenceType, DependencyType } from './symbol.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACP,cAAc,WAAW,CAAC;AAE1B,cAAc;AACd,cAAc,aAAa,CAAC;AAE5B,WAAW;AACX,cAAc,UAAU,CAAC;AASzB,cAAc;AACd,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC"}

package/dist/shared/types/symbol.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Symbol 相關型別定義
+ * 包含 SymbolType、Symbol、Reference、Dependency 等型別
+ */
+import { Location } from './core.js';
+/**
+ * Symbol 類型列舉
+ */
+export declare enum SymbolType {
+    Class = "class",
+    Interface = "interface",
+    Function = "function",
+    Variable = "variable",
+    Constant = "constant",
+    Type = "type",
+    Enum = "enum",
+    Module = "module",
+    Namespace = "namespace"
+}
+/**
+ * Scope 類型
+ */
+export type ScopeType = 'global' | 'module' | 'namespace' | 'class' | 'function' | 'block';
+/**
+ * 表示程式碼作用域
+ */
+export interface Scope {
+    readonly type: ScopeType;
+    readonly name: string | undefined;
+    readonly parent: Scope | undefined;
+}
+/**
+ * 表示程式碼符號
+ */
+export interface Symbol {
+    readonly name: string;
+    readonly type: SymbolType;
+    readonly location: Location;
+    readonly scope: Scope | undefined;
+    readonly modifiers: readonly string[];
+}
+/**
+ * Reference 類型列舉
+ */
+export declare enum ReferenceType {
+    Definition = "definition",
+    Usage = "usage",
+    Declaration = "declaration"
+}
+/**
+ * 表示符號引用
+ */
+export interface Reference {
+    readonly symbol: Symbol;
+    readonly location: Location;
+    readonly type: ReferenceType;
+}
+/**
+ * Dependency 類型列舉
+ */
+export declare enum DependencyType {
+    Import = "import",
+    Require = "require",
+    Include = "include"
+}
+/**
+ * 表示模組依賴
+ */
+export interface Dependency {
+    readonly path: string;
+    readonly type: DependencyType;
+    readonly isRelative: boolean;
+    readonly importedSymbols: readonly string[];
+}
+/**
+ * 建立 Scope 的工廠函式
+ */
+export declare function createScope(type: ScopeType, name?: string, parent?: Scope): Scope;
+/**
+ * 建立 Symbol 的工廠函式
+ */
+export declare function createSymbol(name: string, type: SymbolType, location: Location, scope?: Scope, modifiers?: string[]): Symbol;
+/**
+ * 建立 Reference 的工廠函式
+ */
+export declare function createReference(symbol: Symbol, location: Location, type: ReferenceType): Reference;
+/**
+ * 建立 Dependency 的工廠函式
+ */
+export declare function createDependency(path: string, type: DependencyType, isRelative: boolean, importedSymbols?: string[]): Dependency;
+/**
+ * Scope 型別守衛
+ */
+export declare function isScope(value: unknown): value is Scope;
+/**
+ * Symbol 型別守衛
+ */
+export declare function isSymbol(value: unknown): value is Symbol;
+/**
+ * Reference 型別守衛
+ */
+export declare function isReference(value: unknown): value is Reference;
+/**
+ * Dependency 型別守衛
+ */
+export declare function isDependency(value: unknown): value is Dependency;
+/**
+ * 計算 Scope 的深度
+ */
+export declare function getScopeDepth(scope: Scope): number;
+/**
+ * 檢查兩個 Symbol 是否在同一 Scope
+ */
+export declare function isSameScope(symbol1: Symbol, symbol2: Symbol): boolean;
+/**
+ * 取得 Scope 的完整路徑
+ */
+export declare function getScopePath(scope: Scope): string[];
+//# sourceMappingURL=symbol.d.ts.map

package/dist/shared/types/symbol.d.ts.map

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