@zipbul/gildash 0.13.0 → 0.15.0

package/dist/migrations/0008_external_imports.sql

@@ -0,0 +1,26 @@
+PRAGMA foreign_keys=OFF;--> statement-breakpoint
+CREATE TABLE `__new_relations` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`project` text NOT NULL,
+	`type` text NOT NULL,
+	`src_file_path` text NOT NULL,
+	`src_symbol_name` text,
+	`dst_project` text,
+	`dst_file_path` text,
+	`dst_symbol_name` text,
+	`meta_json` text,
+	`specifier` text,
+	`is_external` integer NOT NULL DEFAULT 0,
+	FOREIGN KEY (`project`,`src_file_path`) REFERENCES `files`(`project`,`file_path`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+INSERT INTO `__new_relations`("id", "project", "type", "src_file_path", "src_symbol_name", "dst_project", "dst_file_path", "dst_symbol_name", "meta_json", "specifier", "is_external") SELECT "id", "project", "type", "src_file_path", "src_symbol_name", "dst_project", "dst_file_path", "dst_symbol_name", "meta_json", NULL, 0 FROM `relations`;--> statement-breakpoint
+DROP TABLE `relations`;--> statement-breakpoint
+ALTER TABLE `__new_relations` RENAME TO `relations`;--> statement-breakpoint
+PRAGMA foreign_keys=ON;--> statement-breakpoint
+CREATE INDEX `idx_relations_src` ON `relations` (`project`,`src_file_path`);--> statement-breakpoint
+CREATE INDEX `idx_relations_dst` ON `relations` (`dst_project`,`dst_file_path`);--> statement-breakpoint
+CREATE INDEX `idx_relations_type` ON `relations` (`project`,`type`);--> statement-breakpoint
+CREATE INDEX `idx_relations_project_type_src` ON `relations` (`project`,`type`,`src_file_path`);--> statement-breakpoint
+CREATE INDEX `idx_relations_specifier` ON `relations` (`project`,`specifier`);--> statement-breakpoint
+INSERT OR REPLACE INTO sqlite_sequence (name, seq) SELECT 'relations', COALESCE(MAX(id), 0) FROM relations;

package/dist/migrations/meta/_journal.json

@@ -57,6 +57,13 @@
       "when": 1773878400001,
       "tag": "0007_symbol_changelog",
       "breakpoints": true
+    },
+    {
+      "idx": 8,
+      "version": "6",
+      "when": 1774588800000,
+      "tag": "0008_external_imports",
+      "breakpoints": true
     }
   ]
 }

package/dist/src/common/path-utils.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Normalize a file path to always use forward slashes.
+ *
+ * On Windows, Node.js `path.resolve` / `path.relative` return backslash
+ * separators.  Gildash stores and returns forward-slash paths exclusively,
+ * so every path that enters the system must pass through this function.
+ */
+export declare function normalizePath(p: string): string;
 export declare function toRelativePath(projectRoot: string, absolutePath: string): string;
 export declare function toAbsolutePath(projectRoot: string, relativePath: string): string;

package/dist/src/errors.d.ts

@@ -12,13 +12,3 @@ export declare class GildashError extends Error {
         cause?: unknown;
     });
 }
-/**
- * Factory function that creates a {@link GildashError} value.
- *
- * @param type    - One of the {@link GildashErrorType} variants.
- * @param message - Human-readable description of the error.
- * @param cause   - Optional root cause (any value). When `undefined`, the `cause`
- *                  property is omitted from the returned object entirely.
- * @deprecated Use `new GildashError(type, message, { cause })` instead.
- */
-export declare function gildashError(type: GildashErrorType, message: string, cause?: unknown): GildashError;

package/dist/src/extractor/imports-extractor.d.ts

@@ -1,4 +1,6 @@
-import type { Program } from 'oxc-parser';
+import type { Program, EcmaScriptModule } from 'oxc-parser';
 import type { TsconfigPaths } from '../common/tsconfig-resolver';
 import type { CodeRelation } from './types';
-export declare function extractImports(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[]): CodeRelation[];
+type ResolveImportFn = (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[];
+export declare function extractImports(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: ResolveImportFn, module?: EcmaScriptModule): CodeRelation[];
+export {};

package/dist/src/extractor/relation-extractor.d.ts

@@ -1,5 +1,5 @@
-import type { Program } from 'oxc-parser';
+import type { Program, EcmaScriptModule } from 'oxc-parser';
 import type { TsconfigPaths } from '../common/tsconfig-resolver';
 import type { CodeRelation } from './types';
 export type ResolveImportFn = (currentFilePath: string, importPath: string, tsconfigPaths?: TsconfigPaths) => string[];
-export declare function extractRelations(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: ResolveImportFn): CodeRelation[];
+export declare function extractRelations(ast: Program, filePath: string, tsconfigPaths?: TsconfigPaths, resolveImportFn?: ResolveImportFn, module?: EcmaScriptModule): CodeRelation[];

package/dist/src/extractor/types.d.ts

@@ -11,7 +11,7 @@ import type { SourcePosition, SourceSpan } from '../parser/types';
  * - `'enum'` — enum declarations
  * - `'property'` — class properties and interface/type members
  */
-export type SymbolKind = 'function' | 'method' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'property';
+export type SymbolKind = 'function' | 'method' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'namespace' | 'property';
 /**
  * TypeScript declaration modifiers attached to a symbol.
  */
@@ -154,14 +154,16 @@ export interface CodeRelation {
     srcFilePath: string;
     /** Source symbol name, or `null` for module-level relationships. */
     srcSymbolName: string | null;
-    /** File path of the target. */
-    dstFilePath: string;
+    /** File path of the target. `null` for external/unresolved imports. */
+    dstFilePath: string | null;
     /** Target symbol name, or `null` for module-level imports. */
     dstSymbolName: string | null;
     /** Optional JSON-encoded metadata about the relation. */
     metaJson?: string;
     /** Parsed metadata object derived from `metaJson`. */
     meta?: Record<string, unknown>;
+    /** Raw import specifier (e.g. `'lodash'`, `'./missing'`). Present for unresolved/external imports. */
+    specifier?: string;
 }
 export type AnnotationSource = 'jsdoc' | 'line' | 'block';
 export interface ExtractedAnnotation {

package/dist/src/gildash/context.d.ts

@@ -57,7 +57,7 @@ export type CoordinatorLike = Pick<IndexCoordinator, 'fullIndex' | 'shutdown' |
     handleWatcherEvent?(event: FileChangeEvent): void;
 };
 export type WatcherLike = Pick<ProjectWatcher, 'start' | 'close'>;
-export type SemanticLayerLike = Pick<SemanticLayer, 'collectTypeAt' | 'collectFileTypes' | 'findReferences' | 'findImplementations' | 'isTypeAssignableTo' | 'isTypeAssignableToType' | 'getModuleInterface' | 'getSymbolNode' | 'getDiagnostics' | 'notifyFileChanged' | 'notifyFileDeleted' | 'dispose' | 'isDisposed' | 'lineColumnToPosition' | 'findNamePosition'>;
+export type SemanticLayerLike = Pick<SemanticLayer, 'collectTypeAt' | 'collectFileTypes' | 'findReferences' | 'findImplementations' | 'isTypeAssignableTo' | 'isTypeAssignableToType' | 'getModuleInterface' | 'getSymbolNode' | 'getBaseTypes' | 'getDiagnostics' | 'notifyFileChanged' | 'notifyFileDeleted' | 'dispose' | 'isDisposed' | 'lineColumnToPosition' | 'findNamePosition'>;
 /** Internal shared state for all Gildash API modules. */
 export interface GildashContext {
     readonly projectRoot: string;

package/dist/src/gildash/index.d.ts

@@ -118,6 +118,7 @@ export declare class Gildash {
     lineColumnToPosition(filePath: string, line: number, column: number): number | null;
     findNamePosition(filePath: string, declarationPos: number, name: string): number | null;
     getSymbolNode(filePath: string, position: number): SymbolNode | null;
+    getBaseTypes(filePath: string, position: number): ResolvedType[] | null;
     getSemanticDiagnostics(filePath: string, options?: GetDiagnosticsOptions): SemanticDiagnostic[];
     diffSymbols(before: SymbolSearchResult[], after: SymbolSearchResult[]): SymbolDiff;
     onIndexed(callback: (result: IndexResult) => void): () => void;

package/dist/src/gildash/semantic-api.d.ts

@@ -38,6 +38,8 @@ export declare function isTypeAssignableToAt(ctx: GildashContext, opts: {
 }): boolean | null;
 /** Retrieve the semantic module interface — exported symbols with resolved types. */
 export declare function getSemanticModuleInterface(ctx: GildashContext, filePath: string): SemanticModuleInterface;
+/** Retrieve the base types (supertypes) of a class/interface at a byte offset. */
+export declare function getBaseTypes(ctx: GildashContext, filePath: string, position: number): ResolvedType[] | null;
 /** Retrieve the resolved type at a byte offset without line/column conversion. */
 export declare function getResolvedTypeAtPosition(ctx: GildashContext, filePath: string, position: number): ResolvedType | null;
 /** Find all semantic references at a byte offset. */

package/dist/src/gildash/types.d.ts

@@ -1,6 +1,6 @@
 import type { ParsedFile } from '../parser/types';
-import type { SymbolSearchResult } from '../search/symbol-search';
-import type { SymbolKind } from '../extractor/types';
+import type { SymbolSearchResult, SymbolDetail } from '../search/symbol-search';
+import type { SymbolKind, Decorator } from '../extractor/types';
 import type { ResolvedType } from '../semantic/types';
 /**
  * Minimal logger interface accepted by {@link Gildash}.
@@ -52,32 +52,24 @@ export interface HeritageNode {
 /**
  * Full symbol detail including members, documentation, and type information.
  * Returned by {@link Gildash.getFullSymbol}.
+ *
+ * Fields are lifted directly from {@link SymbolDetail} for convenient access.
  */
 export interface FullSymbol extends SymbolSearchResult {
     /** Class/interface members (methods, properties, constructors, accessors). */
-    members?: Array<{
-        name: string;
-        kind: string;
-        type?: string;
-        visibility?: string;
-        isStatic?: boolean;
-        isReadonly?: boolean;
-    }>;
-    /** JSDoc comment attached to the symbol. */
-    jsDoc?: string;
-    /** Stringified parameter list (functions/methods). */
-    parameters?: string;
-    /** Stringified return type (functions/methods). */
+    members?: SymbolDetail['members'];
+    /** Parsed JSDoc comment attached to the symbol. */
+    jsDoc?: SymbolDetail['jsDoc'];
+    /** Function/method parameters. */
+    parameters?: SymbolDetail['parameters'];
+    /** Return type annotation as source text. */
     returnType?: string;
-    /** Superclass/interface names (classes/interfaces with heritage). */
-    heritage?: string[];
+    /** Heritage clauses (`extends` / `implements`). */
+    heritage?: SymbolDetail['heritage'];
     /** Decorators applied to the symbol. */
-    decorators?: Array<{
-        name: string;
-        arguments?: string;
-    }>;
-    /** Stringified type parameters (generic symbols). */
-    typeParameters?: string;
+    decorators?: Decorator[];
+    /** Generic type parameter names. */
+    typeParameters?: string[];
     /** Resolved type from the Semantic Layer (available when `semantic: true`). */
     resolvedType?: ResolvedType;
 }

package/dist/src/index.d.ts

@@ -1,9 +1,9 @@
 export { Gildash } from "./gildash";
 export type { GildashOptions, Logger, SymbolDiff, ModuleInterface, HeritageNode, FullSymbol, FileStats, FanMetrics, ResolvedSymbol } from "./gildash";
-export { GildashError, gildashError } from "./errors";
+export { GildashError } from "./errors";
 export type { GildashErrorType } from "./errors";
 export { symbolSearch } from "./search/symbol-search";
-export type { SymbolSearchQuery, SymbolSearchResult } from "./search/symbol-search";
+export type { SymbolSearchQuery, SymbolSearchResult, SymbolDetail } from "./search/symbol-search";
 export { relationSearch } from "./search/relation-search";
 export type { RelationSearchQuery, StoredCodeRelation } from "./search/relation-search";
 export { DependencyGraph } from "./search/dependency-graph";
@@ -11,7 +11,7 @@ export { patternSearch } from "./search/pattern-search";
 export type { PatternMatch, PatternSearchOptions } from "./search/pattern-search";
 export type { IndexResult } from "./indexer/index-coordinator";
 export type { ProjectBoundary } from "./common/project-discovery";
-export type { CodeRelation, SymbolKind } from "./extractor/types";
+export type { CodeRelation, SymbolKind, Decorator, Parameter, Heritage, Modifier, JsDocBlock, JsDocTag } from "./extractor/types";
 export type { SymbolStats } from "./store/repositories/symbol.repository";
 export type { WatcherRole } from "./watcher/types";
 export type { ParsedFile } from "./parser/types";
@@ -21,3 +21,8 @@ export type { SymbolNode } from "./semantic/symbol-graph";
 export type { AnnotationSource, ExtractedAnnotation } from "./extractor/types";
 export type { AnnotationSearchQuery, AnnotationSearchResult } from "./search/annotation-search";
 export type { SymbolChange, SymbolChangeType, SymbolChangeQueryOptions } from "./gildash/types";
+export { buildLineOffsets, getLineColumn } from './parser/source-position';
+export type { SourcePosition, SourceSpan } from './parser/types';
+export type { Program, Node } from 'oxc-parser';
+export { Visitor, visitorKeys } from 'oxc-parser';
+export type { VisitorObject } from 'oxc-parser';

package/dist/src/indexer/index-coordinator.d.ts

@@ -79,19 +79,19 @@ export interface IndexResult {
         added: Array<{
             type: string;
             srcFilePath: string;
-            dstFilePath: string;
+            dstFilePath: string | null;
             srcSymbolName: string | null;
             dstSymbolName: string | null;
-            dstProject: string;
+            dstProject: string | null;
             metaJson: string | null;
         }>;
         removed: Array<{
             type: string;
             srcFilePath: string;
-            dstFilePath: string;
+            dstFilePath: string | null;
             srcSymbolName: string | null;
             dstSymbolName: string | null;
-            dstProject: string;
+            dstProject: string | null;
             metaJson: string | null;
         }>;
     };
@@ -132,6 +132,7 @@ export interface IndexCoordinatorOptions {
             newDstProject?: string;
         }): void;
         deleteFileRelations(project: string, filePath: string): void;
+        deleteIncomingRelations(dstProject: string, dstFilePath: string): void;
         getOutgoing(project: string, srcFilePath: string): RelationRecord[];
     };
     annotationRepo?: {

package/dist/src/indexer/relation-indexer.d.ts

@@ -6,10 +6,12 @@ export interface RelationDbRow {
     type: string;
     srcFilePath: string;
     srcSymbolName: string | null;
-    dstProject: string;
-    dstFilePath: string;
+    dstProject: string | null;
+    dstFilePath: string | null;
     dstSymbolName: string | null;
     metaJson: string | null;
+    specifier: string | null;
+    isExternal: number;
 }
 interface RelationRepoPart {
     replaceFileRelations(project: string, filePath: string, relations: RelationDbRow[]): void;
@@ -25,6 +27,8 @@ export interface IndexFileRelationsOptions {
     knownFiles?: Set<string>;
     /** 프로젝트 경계 목록 (dstProject 결정용) */
     boundaries?: ProjectBoundary[];
+    /** Pre-extracted module metadata for re-export pattern B/C detection. */
+    module?: import('oxc-parser').EcmaScriptModule;
 }
 export declare function indexFileRelations(opts: IndexFileRelationsOptions): number;
 export {};

package/dist/src/parser/ast-utils.d.ts

@@ -1,8 +1,4 @@
 import type { QualifiedName } from '../extractor/types';
-export declare function isNode(value: unknown): value is Record<string, unknown>;
-export declare function isNodeArray(value: unknown): value is ReadonlyArray<unknown>;
-export declare function visit(node: unknown, callback: (node: Record<string, unknown>) => void): void;
-export declare function collectNodes(root: unknown, predicate: (node: Record<string, unknown>) => boolean): Record<string, unknown>[];
 export declare function getNodeHeader(node: Record<string, unknown>, parent?: Record<string, unknown> | null): string;
 export declare function isFunctionNode(node: Record<string, unknown>): boolean;
 export declare function getNodeName(node: unknown): string | null;

package/dist/src/parser/index.d.ts

@@ -1,6 +1,6 @@
 export { parseSource } from './parse-source';
 export { ParseCache } from './parse-cache';
 export { buildLineOffsets, getLineColumn, } from './source-position';
-export { isNode, isNodeArray, visit, collectNodes, getNodeHeader, isFunctionNode, getNodeName, getStringLiteralValue, getQualifiedName, } from './ast-utils';
+export { getNodeHeader, isFunctionNode, getNodeName, getStringLiteralValue, getQualifiedName, } from './ast-utils';
 export { parseJsDoc } from './jsdoc-parser';
 export type { ParsedFile, SourcePosition, SourceSpan } from './types';

package/dist/src/parser/jsdoc-parser.d.ts

@@ -1,4 +1,4 @@
 import { type Result } from '@zipbul/result';
 import type { JsDocBlock } from '../extractor/types';
-import { type GildashError } from '../errors';
+import { GildashError } from '../errors';
 export declare function parseJsDoc(commentText: string): Result<JsDocBlock, GildashError>;

package/dist/src/parser/parse-source.d.ts

@@ -2,5 +2,5 @@ import { type Result } from '@zipbul/result';
 import { parseSync as defaultParseSync } from 'oxc-parser';
 import type { ParserOptions } from 'oxc-parser';
 import type { ParsedFile } from './types';
-import { type GildashError } from '../errors';
+import { GildashError } from '../errors';
 export declare function parseSource(filePath: string, sourceText: string, options?: ParserOptions, parseSyncFn?: typeof defaultParseSync): Result<ParsedFile, GildashError>;

package/dist/src/parser/types.d.ts

@@ -1,4 +1,4 @@
-import type { Program, Comment, OxcError } from 'oxc-parser';
+import type { Program, Comment, OxcError, EcmaScriptModule } from 'oxc-parser';
 export interface SourcePosition {
     line: number;
     column: number;
@@ -31,4 +31,6 @@ export interface ParsedFile {
     comments: readonly Comment[];
     /** Raw source text that was parsed. */
     sourceText: string;
+    /** Pre-extracted ESM module metadata (imports, exports, dynamic imports). */
+    module: EcmaScriptModule;
 }

package/dist/src/search/annotation-search.d.ts

@@ -34,7 +34,7 @@ export interface IAnnotationRepo {
         symbolName?: string;
         source?: string;
         ftsQuery?: string;
-        limit: number;
+        limit?: number;
     }): AnnotationRecord[];
 }
 export declare function annotationSearch(options: {

package/dist/src/search/relation-search.d.ts

@@ -5,7 +5,7 @@ import type { RelationRecord } from '../store/repositories/relation.repository';
  * as stored in the relation index.
  */
 export interface StoredCodeRelation extends CodeRelation {
-    dstProject: string;
+    dstProject: string | null;
 }
 /**
  * Filters for {@link relationSearch}.
@@ -31,8 +31,12 @@ export interface RelationSearchQuery {
     type?: CodeRelation['type'];
     /** Limit results to this project. */
     project?: string;
-    /** Maximum number of results. Defaults to `500`. */
+    /** Maximum number of results. When omitted, no limit is applied. */
     limit?: number;
+    /** Filter by raw import specifier. */
+    specifier?: string;
+    /** Filter by external package flag. */
+    isExternal?: boolean;
 }
 export interface IRelationRepo {
     searchRelations(opts: {
@@ -43,7 +47,9 @@ export interface IRelationRepo {
         dstProject?: string;
         type?: string;
         project?: string;
-        limit: number;
+        specifier?: string;
+        isExternal?: boolean;
+        limit?: number;
     }): RelationRecord[];
 }
 /**

package/dist/src/search/symbol-search.d.ts

@@ -1,4 +1,4 @@
-import type { SymbolKind } from '../extractor/types';
+import type { SymbolKind, Modifier, Decorator, JsDocBlock } from '../extractor/types';
 import type { SymbolRecord } from '../store/repositories/symbol.repository';
 /**
  * Filters for {@link symbolSearch}.
@@ -18,7 +18,7 @@ export interface SymbolSearchQuery {
     isExported?: boolean;
     /** Limit results to this project. Defaults to the primary project. */
     project?: string;
-    /** Maximum number of results. Defaults to `100`. */
+    /** Maximum number of results. When omitted, no limit is applied. */
     limit?: number;
     /**
      * Filter by decorator name (LEG-1).
@@ -36,6 +36,48 @@ export interface SymbolSearchQuery {
      */
     resolvedType?: string;
 }
+/**
+ * Typed detail fields stored in the symbol's `detailJson` column.
+ *
+ * These fields match what {@link buildDetailJson} in `symbol-indexer.ts` serialises.
+ * Not every field is present on every symbol — only the fields relevant to the
+ * symbol's kind are populated.
+ */
+export interface SymbolDetail {
+    /** Function/method parameters. */
+    parameters?: Array<{
+        name: string;
+        type?: string;
+        isOptional: boolean;
+        defaultValue?: string;
+        decorators?: Decorator[];
+    }>;
+    /** Return type annotation as source text. */
+    returnType?: string;
+    /** Heritage clauses (`extends` / `implements`). */
+    heritage?: Array<{
+        kind: 'extends' | 'implements';
+        name: string;
+        typeArguments?: string[];
+    }>;
+    /** Decorators applied to this symbol. */
+    decorators?: Decorator[];
+    /** Generic type parameter names. */
+    typeParameters?: string[];
+    /** Declaration modifiers. */
+    modifiers?: Modifier[];
+    /** Class/interface members. */
+    members?: Array<{
+        name: string;
+        kind: string;
+        type?: string;
+        visibility?: string;
+        isStatic?: boolean;
+        isReadonly?: boolean;
+    }>;
+    /** Parsed JSDoc comment associated with this symbol. */
+    jsDoc?: JsDocBlock;
+}
 /**
  * A single result returned by {@link symbolSearch}.
  */
@@ -46,8 +88,10 @@ export interface SymbolSearchResult {
     filePath: string;
     /** Kind of the symbol (function, class, variable, etc.). */
     kind: SymbolKind;
-    /** Symbol name. */
+    /** Symbol name (qualified for members, e.g. `"ClassName.methodName"`). */
     name: string;
+    /** Unqualified member name (e.g. `"methodName"`), or `null` for top-level symbols. */
+    memberName: string | null;
     /** Source location span (start/end line and column). */
     span: {
         start: {
@@ -65,8 +109,8 @@ export interface SymbolSearchResult {
     signature: string | null;
     /** Content-hash fingerprint for change detection. */
     fingerprint: string | null;
-    /** Arbitrary detail fields stored as JSON. */
-    detail: Record<string, unknown>;
+    /** Typed detail fields parsed from the stored JSON. */
+    detail: SymbolDetail;
 }
 export interface ISymbolRepo {
     searchByQuery(opts: {
@@ -76,7 +120,7 @@ export interface ISymbolRepo {
         filePath?: string;
         isExported?: boolean;
         project?: string;
-        limit: number;
+        limit?: number;
         decorator?: string;
         regex?: string;
         resolvedType?: string;

package/dist/src/semantic/index.d.ts

@@ -5,7 +5,7 @@
  * 하나의 facade로 통합한다.
  */
 import { type Result } from "@zipbul/result";
-import { type GildashError } from "../errors";
+import { GildashError } from "../errors";
 import { type TscProgramOptions } from "./tsc-program";
 import { TypeCollector } from "./type-collector";
 import { SymbolGraph, type SymbolNode } from "./symbol-graph";
@@ -46,6 +46,13 @@ export declare class SemanticLayer {
         anyConstituent?: boolean;
     }): boolean | null;
     getSymbolNode(filePath: string, position: number): SymbolNode | null;
+    /**
+     * Return the base types (supertypes) of the class/interface at the given position.
+     *
+     * Uses `checker.getBaseTypes()` which only works on interface/class types.
+     * Returns `null` if the type at position is not a class or interface.
+     */
+    getBaseTypes(filePath: string, position: number): ResolvedType[] | null;
     getModuleInterface(filePath: string): SemanticModuleInterface;
     notifyFileChanged(filePath: string, content: string): void;
     /**

package/dist/src/semantic/tsc-program.d.ts

@@ -9,7 +9,7 @@
  */
 import ts from "typescript";
 import { type Result } from "@zipbul/result";
-import { type GildashError } from "../errors";
+import { GildashError } from "../errors";
 /**
  * Reads a file at `path` and returns its content, or `undefined` if missing.
  */

package/dist/src/semantic/type-collector.d.ts

@@ -4,8 +4,15 @@
  * TscProgram에서 Program/TypeChecker를 가져와 AST를 탐색하고
  * 각 심볼 위치의 타입을 ResolvedType으로 변환한다.
  */
+import ts from "typescript";
 import type { ResolvedType } from "./types";
 import type { TscProgram } from "./tsc-program";
+/**
+ * `ts.Type`을 `ResolvedType`으로 재귀 변환한다.
+ *
+ * 순환 타입에 대비해 `depth`로 재귀 깊이를 제한한다.
+ */
+export declare function buildResolvedType(checker: ts.TypeChecker, type: ts.Type, depth?: number): ResolvedType;
 export declare class TypeCollector {
     private readonly program;
     constructor(program: TscProgram);

package/dist/src/semantic/types.d.ts

@@ -40,6 +40,15 @@ export interface ResolvedType {
      * e.g. `Promise<string>` → `[{ text: "string", ... }]`
      */
     typeArguments?: ResolvedType[];
+    /**
+     * Properties of an object type, enumerated via `checker.getPropertiesOfType()`.
+     * Only populated for non-union, non-intersection, non-primitive object types.
+     * Capped at 50 properties to avoid huge type expansions.
+     */
+    properties?: Array<{
+        name: string;
+        type: ResolvedType;
+    }>;
 }
 /**
  * A single reference to a symbol, resolved via `LanguageService.findReferences`.

package/dist/src/store/connection.d.ts

@@ -1,6 +1,6 @@
 import { type Result } from '@zipbul/result';
 import { type BunSQLiteDatabase } from 'drizzle-orm/bun-sqlite';
-import { type GildashError } from '../errors';
+import { GildashError } from '../errors';
 import * as schema from './schema';
 export interface DbConnectionOptions {
     projectRoot: string;

package/dist/src/store/repositories/annotation.repository.d.ts

@@ -25,6 +25,6 @@ export declare class AnnotationRepository {
         symbolName?: string;
         source?: string;
         ftsQuery?: string;
-        limit: number;
+        limit?: number;
     }): AnnotationRecord[];
 }

package/dist/src/store/repositories/relation.repository.d.ts

@@ -4,10 +4,12 @@ export interface RelationRecord {
     type: string;
     srcFilePath: string;
     srcSymbolName: string | null;
-    dstProject: string;
-    dstFilePath: string;
+    dstProject: string | null;
+    dstFilePath: string | null;
     dstSymbolName: string | null;
     metaJson: string | null;
+    specifier: string | null;
+    isExternal: number;
 }
 export declare class RelationRepository {
     private readonly db;
@@ -20,6 +22,7 @@ export declare class RelationRepository {
     }): RelationRecord[];
     getByType(project: string, type: string): RelationRecord[];
     deleteFileRelations(project: string, srcFilePath: string): void;
+    deleteIncomingRelations(dstProject: string, dstFilePath: string): void;
     searchRelations(opts: {
         srcFilePath?: string;
         srcSymbolName?: string;
@@ -28,7 +31,9 @@ export declare class RelationRepository {
         dstSymbolName?: string;
         type?: string;
         project?: string;
-        limit: number;
+        specifier?: string;
+        isExternal?: boolean;
+        limit?: number;
     }): RelationRecord[];
     retargetRelations(opts: {
         dstProject: string;

package/dist/src/store/repositories/symbol.repository.d.ts

@@ -49,7 +49,7 @@ export declare class SymbolRepository {
         filePath?: string;
         isExported?: boolean;
         project?: string;
-        limit: number;
+        limit?: number;
         decorator?: string;
         regex?: string;
         resolvedType?: string;