@zipbul/gildash 0.14.0 → 0.15.1

package/dist/src/index.d.ts

@@ -1,19 +1,19 @@
 export { Gildash } from "./gildash";
-export type { GildashOptions, Logger, SymbolDiff, ModuleInterface, HeritageNode, FullSymbol, FileStats, FanMetrics, ResolvedSymbol } from "./gildash";
+export type { GildashOptions, Logger, SymbolDiff, ModuleInterface, HeritageNode, FullSymbol, FileStats, FanMetrics, ResolvedSymbol, BatchParseResult } from "./gildash";
 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";
 export { patternSearch } from "./search/pattern-search";
-export type { PatternMatch, PatternSearchOptions } from "./search/pattern-search";
+export type { PatternMatch } 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, ExtractedSymbol, 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 { WatcherRole, FileChangeEvent } from "./watcher/types";
 export type { ParsedFile } from "./parser/types";
 export type { FileRecord } from "./store/repositories/file.repository";
 export type { ResolvedType, SemanticReference, Implementation, SemanticModuleInterface, SemanticDiagnostic, GetDiagnosticsOptions } from "./semantic/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/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}.
  */
@@ -67,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: {
@@ -78,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

@@ -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/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/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;

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

@@ -554,7 +554,7 @@ export declare const relations: import("drizzle-orm/sqlite-core").SQLiteTableWit
             columnType: "SQLiteText";
             data: string;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -573,7 +573,7 @@ export declare const relations: import("drizzle-orm/sqlite-core").SQLiteTableWit
             columnType: "SQLiteText";
             data: string;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -623,6 +623,42 @@ export declare const relations: import("drizzle-orm/sqlite-core").SQLiteTableWit
         }, {}, {
             length: number | undefined;
         }>;
+        specifier: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "specifier";
+            tableName: "relations";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        isExternal: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "is_external";
+            tableName: "relations";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
     };
     dialect: "sqlite";
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zipbul/gildash",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "TypeScript code indexing and dependency graph engine for Bun",
   "license": "MIT",
   "repository": {
@@ -49,7 +49,8 @@
     "@zipbul/result": "^0.1.4",
     "comment-parser": "1.4.5",
     "drizzle-orm": "^0.45.1",
-    "oxc-parser": "0.115.0"
+    "oxc-parser": "0.121.0",
+    "oxc-walker": "^0.7.0"
   },
   "devDependencies": {
     "@changesets/changelog-github": "^0.5.2",