cli-node-graph 1.0.1

package/dist/parser/visitors/TypeReferenceVisitor.js

@@ -0,0 +1,85 @@
+import ts from 'typescript';
+import { EdgeKind } from '../../model/EdgeKind.js';
+import { NodeKind } from '../../model/NodeKind.js';
+import { addLocatedEdge, registerSymbolNode } from './context.js';
+/** Captures type references in signatures and type annotations. */
+export class TypeReferenceVisitor {
+    ctx;
+    name = 'TypeReferenceVisitor';
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    visit(node, vctx) {
+        if (ts.isTypeReferenceNode(node)) {
+            this.handleTypeReference(node, vctx);
+        }
+    }
+    handleTypeReference(node, vctx) {
+        const type = vctx.checker.getTypeFromTypeNode(node);
+        const symbol = type.getSymbol() ?? type.aliasSymbol;
+        if (!symbol)
+            return;
+        const resolved = this.ctx.symbolResolver.resolveAlias(symbol);
+        const decl = this.ctx.symbolResolver.getDeclaration(resolved);
+        if (!decl)
+            return;
+        const typeName = this.ctx.symbolResolver.getSymbolName(resolved);
+        const typeId = registerSymbolNode(this.ctx, {
+            kind: this.inferTypeKind(resolved),
+            name: typeName,
+            node: decl,
+            sourceFile: decl.getSourceFile(),
+        });
+        const enclosing = this.ctx.symbolResolver.getEnclosingSymbol(node);
+        if (!enclosing)
+            return;
+        const enclosingDecl = this.ctx.symbolResolver.getDeclaration(enclosing);
+        if (!enclosingDecl)
+            return;
+        const enclosingName = this.getEnclosingName(enclosingDecl);
+        const enclosingId = registerSymbolNode(this.ctx, {
+            kind: this.inferEnclosingKind(enclosingDecl),
+            name: enclosingName,
+            node: enclosingDecl,
+            sourceFile: enclosingDecl.getSourceFile(),
+        });
+        addLocatedEdge(this.ctx, {
+            source: enclosingId,
+            target: typeId,
+            kind: EdgeKind.TYPE_REFERENCE,
+            sourceFile: vctx.sourceFile,
+            node,
+        });
+    }
+    inferTypeKind(symbol) {
+        if (symbol.flags & ts.SymbolFlags.Interface)
+            return NodeKind.Interface;
+        if (symbol.flags & ts.SymbolFlags.Class)
+            return NodeKind.Class;
+        if (symbol.flags & ts.SymbolFlags.Enum)
+            return NodeKind.Enum;
+        return NodeKind.TypeAlias;
+    }
+    inferEnclosingKind(decl) {
+        if (ts.isClassDeclaration(decl))
+            return NodeKind.Class;
+        if (ts.isInterfaceDeclaration(decl))
+            return NodeKind.Interface;
+        if (ts.isFunctionDeclaration(decl))
+            return NodeKind.Function;
+        if (ts.isMethodDeclaration(decl))
+            return NodeKind.Method;
+        return NodeKind.Variable;
+    }
+    getEnclosingName(decl) {
+        if ('name' in decl && decl.name && ts.isIdentifier(decl.name)) {
+            const name = decl.name.text;
+            if (ts.isMethodDeclaration(decl) && decl.parent && ts.isClassDeclaration(decl.parent) && decl.parent.name) {
+                return `${decl.parent.name.text}.${name}`;
+            }
+            return name;
+        }
+        return 'anonymous';
+    }
+}
+//# sourceMappingURL=TypeReferenceVisitor.js.map

package/dist/parser/visitors/TypeReferenceVisitor.js.map

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

package/dist/parser/visitors/VariableVisitor.d.ts

@@ -0,0 +1,11 @@
+import ts from 'typescript';
+import type { ASTVisitor, VisitorContext } from '../ASTWalker.js';
+import type { GraphBuildContext } from './context.js';
+/** Captures variable declarations. */
+export declare class VariableVisitor implements ASTVisitor {
+    private readonly ctx;
+    readonly name = "VariableVisitor";
+    constructor(ctx: GraphBuildContext);
+    visit(node: ts.Node, vctx: VisitorContext): void;
+}
+//# sourceMappingURL=VariableVisitor.d.ts.map

package/dist/parser/visitors/VariableVisitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableVisitor.d.ts","sourceRoot":"","sources":["../../../src/parser/visitors/VariableVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGtD,sCAAsC;AACtC,qBAAa,eAAgB,YAAW,UAAU;IAGpC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,QAAQ,CAAC,IAAI,qBAAqB;gBAEL,GAAG,EAAE,iBAAiB;IAEnD,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;CAiBjD"}

package/dist/parser/visitors/VariableVisitor.js

@@ -0,0 +1,27 @@
+import ts from 'typescript';
+import { NodeKind } from '../../model/NodeKind.js';
+import { registerSymbolNode } from './context.js';
+/** Captures variable declarations. */
+export class VariableVisitor {
+    ctx;
+    name = 'VariableVisitor';
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    visit(node, vctx) {
+        if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name)) {
+            const parent = node.parent?.parent;
+            const isExported = parent && ts.isVariableStatement(parent) && ts.canHaveModifiers(parent)
+                ? !!(ts.getCombinedModifierFlags(parent) & ts.ModifierFlags.Export)
+                : false;
+            registerSymbolNode(this.ctx, {
+                kind: NodeKind.Variable,
+                name: node.name.text,
+                node,
+                sourceFile: vctx.sourceFile,
+                metadata: { exported: isExported ?? false },
+            });
+        }
+    }
+}
+//# sourceMappingURL=VariableVisitor.js.map

package/dist/parser/visitors/VariableVisitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableVisitor.js","sourceRoot":"","sources":["../../../src/parser/visitors/VariableVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,sCAAsC;AACtC,MAAM,OAAO,eAAe;IAGG;IAFpB,IAAI,GAAG,iBAAiB,CAAC;IAElC,YAA6B,GAAsB;QAAtB,QAAG,GAAH,GAAG,CAAmB;IAAG,CAAC;IAEvD,KAAK,CAAC,IAAa,EAAE,IAAoB;QACvC,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;YACnC,MAAM,UAAU,GACd,MAAM,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;gBACrE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,wBAAwB,CAAC,MAAmC,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC;gBAChG,CAAC,CAAC,KAAK,CAAC;YAEZ,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC3B,IAAI,EAAE,QAAQ,CAAC,QAAQ;gBACvB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;gBACpB,IAAI;gBACJ,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,IAAI,KAAK,EAAE;aAC5C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/parser/visitors/context.d.ts

@@ -0,0 +1,54 @@
+import type { GraphEdge } from '../../model/GraphEdge.js';
+import type { SourceRange } from '../../model/GraphNode.js';
+import { EdgeKind } from '../../model/EdgeKind.js';
+import { NodeKind } from '../../model/NodeKind.js';
+import type { EdgeFactory } from '../../graph/EdgeFactory.js';
+import type { NodeFactory } from '../../graph/NodeFactory.js';
+import type { Graph } from '../../graph/Graph.js';
+import type { ModuleResolver } from '../../resolver/ModuleResolver.js';
+import type { PathResolver } from '../../resolver/ModuleResolver.js';
+import type { SymbolResolver } from '../../resolver/SymbolResolver.js';
+import type { TypeResolver } from '../../resolver/TypeResolver.js';
+import ts from 'typescript';
+/** Shared context for graph-building visitors. */
+export interface GraphBuildContext {
+    graph: Graph;
+    nodeFactory: NodeFactory;
+    edgeFactory: EdgeFactory;
+    symbolResolver: SymbolResolver;
+    typeResolver: TypeResolver;
+    moduleResolver: ModuleResolver;
+    pathResolver: PathResolver;
+    projectRoot: string;
+    symbolNodeMap: Map<string, string>;
+    fileNodeMap: Map<string, string>;
+}
+/** Get source range from a node. */
+export declare function getSourceRange(node: ts.Node, sourceFile: ts.SourceFile): SourceRange;
+/** Get line/column for a node. */
+export declare function getLocation(node: ts.Node, sourceFile: ts.SourceFile): {
+    line: number;
+    column: number;
+};
+/** Ensure structural nodes (project, folders, files) exist. */
+export declare function ensureFileNode(ctx: GraphBuildContext, filePath: string): string;
+/** Register a symbol node and return its id. */
+export declare function registerSymbolNode(ctx: GraphBuildContext, params: {
+    kind: NodeKind;
+    name: string;
+    node: ts.Node;
+    sourceFile: ts.SourceFile;
+    metadata?: Record<string, string | number | boolean | string[] | undefined>;
+}): string;
+/** Add an edge with standard location metadata. */
+export declare function addLocatedEdge(ctx: GraphBuildContext, params: {
+    source: string;
+    target: string;
+    kind: EdgeKind;
+    sourceFile: ts.SourceFile;
+    node: ts.Node;
+    confidence?: 'high' | 'medium' | 'low';
+    static?: boolean;
+    extra?: Record<string, string | number | boolean | string[] | undefined>;
+}): GraphEdge;
+//# sourceMappingURL=context.d.ts.map

package/dist/parser/visitors/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/parser/visitors/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,WAAW,CAapF;AAED,kCAAkC;AAClC,wBAAgB,WAAW,CACzB,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,UAAU,EAAE,EAAE,CAAC,UAAU,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGlC;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY/E;AA0CD,gDAAgD;AAChD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE;IACN,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAC7E,GACA,MAAM,CAqCR;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC;IAC1B,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAC1E,GACA,SAAS,CAiBX"}

package/dist/parser/visitors/context.js

@@ -0,0 +1,117 @@
+import { EdgeKind } from '../../model/EdgeKind.js';
+import { NodeKind } from '../../model/NodeKind.js';
+import { toPosixPath } from '../../utils/path.js';
+/** Get source range from a node. */
+export function getSourceRange(node, sourceFile) {
+    const { line: startLine, character: startColumn } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+    const { line: endLine, character: endColumn } = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+    return {
+        startLine: startLine + 1,
+        startColumn: startColumn + 1,
+        endLine: endLine + 1,
+        endColumn: endColumn + 1,
+    };
+}
+/** Get line/column for a node. */
+export function getLocation(node, sourceFile) {
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+    return { line: line + 1, column: character + 1 };
+}
+/** Ensure structural nodes (project, folders, files) exist. */
+export function ensureFileNode(ctx, filePath) {
+    const normalized = toPosixPath(filePath);
+    const existing = ctx.fileNodeMap.get(normalized);
+    if (existing)
+        return existing;
+    const fileName = normalized.split('/').pop() ?? normalized;
+    const fileNode = ctx.nodeFactory.file(fileName, normalized);
+    ctx.graph.addNode(fileNode);
+    ctx.fileNodeMap.set(normalized, fileNode.id);
+    ensureFolderHierarchy(ctx, normalized);
+    return fileNode.id;
+}
+function ensureFolderHierarchy(ctx, filePath) {
+    const parts = filePath.split('/');
+    parts.pop();
+    let currentPath = '';
+    let parentId;
+    const projectNodes = ctx.graph.getNodesByKind(NodeKind.Project);
+    parentId = projectNodes[0]?.id;
+    for (const part of parts) {
+        currentPath = currentPath ? `${currentPath}/${part}` : part;
+        const folderId = `Folder:${currentPath}`;
+        if (!ctx.graph.getNode(folderId)) {
+            const folderNode = ctx.nodeFactory.folder(part, currentPath);
+            ctx.graph.addNode(folderNode);
+            if (parentId) {
+                ctx.graph.addEdge(ctx.edgeFactory.create({
+                    source: folderNode.id,
+                    target: parentId,
+                    kind: EdgeKind.BELONGS_TO,
+                }));
+            }
+        }
+        parentId = folderId;
+    }
+    const fileNodeId = ctx.fileNodeMap.get(filePath);
+    if (fileNodeId && parentId) {
+        ctx.graph.addEdge(ctx.edgeFactory.create({
+            source: fileNodeId,
+            target: parentId,
+            kind: EdgeKind.BELONGS_TO,
+        }));
+    }
+}
+/** Register a symbol node and return its id. */
+export function registerSymbolNode(ctx, params) {
+    const filePath = toPosixPath(params.sourceFile.fileName);
+    ensureFileNode(ctx, filePath);
+    const loc = getLocation(params.node, params.sourceFile);
+    const range = getSourceRange(params.node, params.sourceFile);
+    const graphNode = ctx.nodeFactory.create({
+        kind: params.kind,
+        label: params.name,
+        file: filePath,
+        line: loc.line,
+        column: loc.column,
+        range,
+        metadata: params.metadata,
+    });
+    ctx.graph.addNode(graphNode);
+    const fileNodeId = ctx.fileNodeMap.get(filePath);
+    if (fileNodeId) {
+        ctx.graph.addEdge(ctx.edgeFactory.create({
+            source: graphNode.id,
+            target: fileNodeId,
+            kind: EdgeKind.CONTAINS,
+            metadata: {
+                file: filePath,
+                line: loc.line,
+                column: loc.column,
+                confidence: 'high',
+                static: true,
+            },
+        }));
+    }
+    return graphNode.id;
+}
+/** Add an edge with standard location metadata. */
+export function addLocatedEdge(ctx, params) {
+    const loc = getLocation(params.node, params.sourceFile);
+    const edge = ctx.edgeFactory.create({
+        source: params.source,
+        target: params.target,
+        kind: params.kind,
+        metadata: {
+            file: toPosixPath(params.sourceFile.fileName),
+            line: loc.line,
+            column: loc.column,
+            confidence: params.confidence ?? 'high',
+            static: params.static ?? true,
+            ...params.extra,
+        },
+    });
+    ctx.graph.addEdge(edge);
+    return edge;
+}
+//# sourceMappingURL=context.js.map

package/dist/parser/visitors/context.js.map

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

package/dist/resolver/ModuleResolver.d.ts

@@ -0,0 +1,16 @@
+import ts from 'typescript';
+/** Resolves module specifiers to absolute file paths. */
+export declare class ModuleResolver {
+    resolveImport(moduleSpecifier: string, containingFile: string, program: ts.Program): string | undefined;
+    isPackageImport(moduleSpecifier: string): boolean;
+    getPackageName(moduleSpecifier: string): string;
+}
+/** Resolves file system paths relative to project root. */
+export declare class PathResolver {
+    private readonly projectRoot;
+    constructor(projectRoot: string);
+    toAbsolute(relativePath: string): string;
+    toRelative(absolutePath: string): string;
+    folderPath(filePath: string): string;
+}
+//# sourceMappingURL=ModuleResolver.d.ts.map

package/dist/resolver/ModuleResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleResolver.d.ts","sourceRoot":"","sources":["../../src/resolver/ModuleResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,yDAAyD;AACzD,qBAAa,cAAc;IACzB,aAAa,CACX,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,EAAE,CAAC,OAAO,GAClB,MAAM,GAAG,SAAS;IAarB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAIjD,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CAOhD;AAED,2DAA2D;AAC3D,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEhD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIxC,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAOxC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/resolver/ModuleResolver.js

@@ -0,0 +1,40 @@
+import { dirname, resolve } from 'node:path';
+import ts from 'typescript';
+import { toPosixPath } from '../utils/path.js';
+/** Resolves module specifiers to absolute file paths. */
+export class ModuleResolver {
+    resolveImport(moduleSpecifier, containingFile, program) {
+        const resolved = ts.resolveModuleName(moduleSpecifier, containingFile, program.getCompilerOptions(), ts.sys);
+        if (resolved.resolvedModule) {
+            return toPosixPath(resolved.resolvedModule.resolvedFileName);
+        }
+        return undefined;
+    }
+    isPackageImport(moduleSpecifier) {
+        return !moduleSpecifier.startsWith('.') && !moduleSpecifier.startsWith('/');
+    }
+    getPackageName(moduleSpecifier) {
+        if (moduleSpecifier.startsWith('@')) {
+            const parts = moduleSpecifier.split('/');
+            return parts.slice(0, 2).join('/');
+        }
+        return moduleSpecifier.split('/')[0] ?? moduleSpecifier;
+    }
+}
+/** Resolves file system paths relative to project root. */
+export class PathResolver {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    toAbsolute(relativePath) {
+        return toPosixPath(resolve(this.projectRoot, relativePath));
+    }
+    toRelative(absolutePath) {
+        return toPosixPath(resolve(absolutePath)).replace(toPosixPath(resolve(this.projectRoot)) + '/', '');
+    }
+    folderPath(filePath) {
+        return toPosixPath(dirname(filePath));
+    }
+}
+//# sourceMappingURL=ModuleResolver.js.map

package/dist/resolver/ModuleResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleResolver.js","sourceRoot":"","sources":["../../src/resolver/ModuleResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,yDAAyD;AACzD,MAAM,OAAO,cAAc;IACzB,aAAa,CACX,eAAuB,EACvB,cAAsB,EACtB,OAAmB;QAEnB,MAAM,QAAQ,GAAG,EAAE,CAAC,iBAAiB,CACnC,eAAe,EACf,cAAc,EACd,OAAO,CAAC,kBAAkB,EAAE,EAC5B,EAAE,CAAC,GAAG,CACP,CAAC;QACF,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,eAAe,CAAC,eAAuB;QACrC,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,cAAc,CAAC,eAAuB;QACpC,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC;IAC1D,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEpD,UAAU,CAAC,YAAoB;QAC7B,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,UAAU,CAAC,YAAoB;QAC7B,OAAO,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAC/C,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,GAAG,EAC5C,EAAE,CACH,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,OAAO,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/resolver/SymbolResolver.d.ts

@@ -0,0 +1,15 @@
+import ts from 'typescript';
+/** Resolves TypeScript symbols to their original declarations. */
+export declare class SymbolResolver {
+    private readonly checker;
+    private readonly cache;
+    constructor(checker: ts.TypeChecker);
+    getSymbolAtLocation(node: ts.Node): ts.Symbol | undefined;
+    resolveAlias(symbol: ts.Symbol): ts.Symbol;
+    getDeclaration(symbol: ts.Symbol): ts.Declaration | undefined;
+    getDeclarationFile(symbol: ts.Symbol): string | undefined;
+    getSymbolName(symbol: ts.Symbol): string;
+    getExportsOfModule(sourceFile: ts.SourceFile): ts.Symbol[];
+    getEnclosingSymbol(node: ts.Node): ts.Symbol | undefined;
+}
+//# sourceMappingURL=SymbolResolver.d.ts.map

package/dist/resolver/SymbolResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolResolver.d.ts","sourceRoot":"","sources":["../../src/resolver/SymbolResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,kEAAkE;AAClE,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;gBAE7C,OAAO,EAAE,EAAE,CAAC,WAAW;IAEpD,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS;IAWzD,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM;IAO1C,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,WAAW,GAAG,SAAS;IAI7D,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS;IAMzD,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,MAAM;IAIxC,kBAAkB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,MAAM,EAAE;IAM1D,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS;CAkBzD"}

package/dist/resolver/SymbolResolver.js

@@ -0,0 +1,62 @@
+import ts from 'typescript';
+import { LookupCache } from '../utils/cache.js';
+import { toPosixPath } from '../utils/path.js';
+/** Resolves TypeScript symbols to their original declarations. */
+export class SymbolResolver {
+    checker;
+    cache = new LookupCache();
+    constructor(checker) {
+        this.checker = checker;
+    }
+    getSymbolAtLocation(node) {
+        const key = `${node.getSourceFile().fileName}:${node.getStart()}`;
+        if (this.cache.has(key)) {
+            return this.cache.get(key);
+        }
+        const symbol = this.checker.getSymbolAtLocation(node);
+        const resolved = symbol ? this.resolveAlias(symbol) : undefined;
+        this.cache.set(key, resolved);
+        return resolved;
+    }
+    resolveAlias(symbol) {
+        if (symbol.flags & ts.SymbolFlags.Alias) {
+            return this.checker.getAliasedSymbol(symbol);
+        }
+        return symbol;
+    }
+    getDeclaration(symbol) {
+        return symbol.valueDeclaration ?? symbol.declarations?.[0];
+    }
+    getDeclarationFile(symbol) {
+        const decl = this.getDeclaration(symbol);
+        if (!decl)
+            return undefined;
+        return toPosixPath(decl.getSourceFile().fileName);
+    }
+    getSymbolName(symbol) {
+        return symbol.getName();
+    }
+    getExportsOfModule(sourceFile) {
+        const moduleSymbol = this.checker.getSymbolAtLocation(sourceFile);
+        if (!moduleSymbol)
+            return [];
+        return this.checker.getExportsOfModule(moduleSymbol);
+    }
+    getEnclosingSymbol(node) {
+        let current = node;
+        while (current) {
+            const symbol = this.getSymbolAtLocation(current);
+            if (symbol &&
+                symbol.flags &
+                    (ts.SymbolFlags.Class |
+                        ts.SymbolFlags.Function |
+                        ts.SymbolFlags.Method |
+                        ts.SymbolFlags.Interface)) {
+                return symbol;
+            }
+            current = current.parent;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=SymbolResolver.js.map

package/dist/resolver/SymbolResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolResolver.js","sourceRoot":"","sources":["../../src/resolver/SymbolResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,kEAAkE;AAClE,MAAM,OAAO,cAAc;IAGI;IAFZ,KAAK,GAAG,IAAI,WAAW,EAAiC,CAAC;IAE1E,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,mBAAmB,CAAC,IAAa;QAC/B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAY,CAAC,MAAiB;QAC5B,IAAI,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,cAAc,CAAC,MAAiB;QAC9B,OAAO,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,kBAAkB,CAAC,MAAiB;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,aAAa,CAAC,MAAiB;QAC7B,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAED,kBAAkB,CAAC,UAAyB;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IAED,kBAAkB,CAAC,IAAa;QAC9B,IAAI,OAAO,GAAwB,IAAI,CAAC;QACxC,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACjD,IACE,MAAM;gBACN,MAAM,CAAC,KAAK;oBACV,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK;wBACnB,EAAE,CAAC,WAAW,CAAC,QAAQ;wBACvB,EAAE,CAAC,WAAW,CAAC,MAAM;wBACrB,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAC7B,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/resolver/TypeResolver.d.ts

@@ -0,0 +1,13 @@
+import ts from 'typescript';
+/** Resolves TypeScript types at AST locations. */
+export declare class TypeResolver {
+    private readonly checker;
+    private readonly cache;
+    constructor(checker: ts.TypeChecker);
+    getTypeAtLocation(node: ts.Node): ts.Type;
+    getCallSignature(type: ts.Type): ts.Signature | undefined;
+    getReturnType(signature: ts.Signature): ts.Type;
+    getTypeName(type: ts.Type): string;
+    isPromise(type: ts.Type): boolean;
+}
+//# sourceMappingURL=TypeResolver.d.ts.map

package/dist/resolver/TypeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeResolver.d.ts","sourceRoot":"","sources":["../../src/resolver/TypeResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,kDAAkD;AAClD,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;gBAE/B,OAAO,EAAE,EAAE,CAAC,WAAW;IAEpD,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI;IASzC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,SAAS,GAAG,SAAS;IAIzD,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC,IAAI;IAI/C,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM;IAIlC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO;CAIlC"}

package/dist/resolver/TypeResolver.js

@@ -0,0 +1,32 @@
+import { LookupCache } from '../utils/cache.js';
+/** Resolves TypeScript types at AST locations. */
+export class TypeResolver {
+    checker;
+    cache = new LookupCache();
+    constructor(checker) {
+        this.checker = checker;
+    }
+    getTypeAtLocation(node) {
+        const key = `${node.getSourceFile().fileName}:${node.getStart()}`;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const type = this.checker.getTypeAtLocation(node);
+        this.cache.set(key, type);
+        return type;
+    }
+    getCallSignature(type) {
+        return type.getCallSignatures()[0];
+    }
+    getReturnType(signature) {
+        return this.checker.getReturnTypeOfSignature(signature);
+    }
+    getTypeName(type) {
+        return this.checker.typeToString(type);
+    }
+    isPromise(type) {
+        const symbol = type.getSymbol();
+        return symbol?.getName() === 'Promise';
+    }
+}
+//# sourceMappingURL=TypeResolver.js.map

package/dist/resolver/TypeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeResolver.js","sourceRoot":"","sources":["../../src/resolver/TypeResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,kDAAkD;AAClD,MAAM,OAAO,YAAY;IAGM;IAFZ,KAAK,GAAG,IAAI,WAAW,EAAmB,CAAC;IAE5D,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iBAAiB,CAAC,IAAa;QAC7B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,IAAa;QAC5B,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,SAAuB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,WAAW,CAAC,IAAa;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,SAAS,CAAC,IAAa;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,EAAE,OAAO,EAAE,KAAK,SAAS,CAAC;IACzC,CAAC;CACF"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,12 @@
+/** Simple LRU-style cache for symbol lookups. */
+export declare class LookupCache<K, V> {
+    private readonly map;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,SAAS;IAI5B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAS1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAY3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/utils/cache.js

@@ -0,0 +1,38 @@
+/** Simple LRU-style cache for symbol lookups. */
+export class LookupCache {
+    map = new Map();
+    maxSize;
+    constructor(maxSize = 10_000) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.map.get(key);
+        if (value !== undefined) {
+            this.map.delete(key);
+            this.map.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.map.has(key)) {
+            this.map.delete(key);
+        }
+        else if (this.map.size >= this.maxSize) {
+            const firstKey = this.map.keys().next().value;
+            if (firstKey !== undefined) {
+                this.map.delete(firstKey);
+            }
+        }
+        this.map.set(key, value);
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    clear() {
+        this.map.clear();
+    }
+    get size() {
+        return this.map.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,OAAO,WAAW;IACL,GAAG,GAAG,IAAI,GAAG,EAAQ,CAAC;IACtB,OAAO,CAAS;IAEjC,YAAY,OAAO,GAAG,MAAM;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/utils/id.d.ts

@@ -0,0 +1,7 @@
+/** Create a stable hash-based id from parts. */
+export declare function hashId(...parts: string[]): string;
+/** Build a node id from kind, file, and name. */
+export declare function nodeId(kind: string, file: string, name: string, line?: number): string;
+/** Build an edge id from source, target, and kind. */
+export declare function edgeId(source: string, target: string, kind: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAEA,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtF;AAED,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/utils/id.js

@@ -0,0 +1,15 @@
+import { createHash } from 'node:crypto';
+/** Create a stable hash-based id from parts. */
+export function hashId(...parts) {
+    return createHash('sha256').update(parts.join('|')).digest('hex').slice(0, 16);
+}
+/** Build a node id from kind, file, and name. */
+export function nodeId(kind, file, name, line) {
+    const linePart = line !== undefined ? String(line) : '';
+    return `${kind}:${hashId(file, name, linePart)}`;
+}
+/** Build an edge id from source, target, and kind. */
+export function edgeId(source, target, kind) {
+    return `edge:${hashId(source, target, kind)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,gDAAgD;AAChD,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAa;IAC5E,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY;IACjE,OAAO,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;AAChD,CAAC"}