ai-code-map 0.1.0-alpha.2 → 0.1.0-alpha.3

package/dist/index.d.ts

@@ -1,14 +1,5 @@
-import ts from 'typescript';
 import { z } from 'zod';
-
-declare const SCHEMA_VERSION: 4;
-declare const CONFIG_VERSION: 1;
-declare const ANALYZER_VERSION = "0.4.0";
-
-declare class CodeMapError extends Error {
-    readonly code: string;
-    constructor(code: string, message: string, options?: ErrorOptions);
-}
+import ts from 'typescript';
 
 declare const JsonValueSchema: z.ZodJSONSchema;
 type JsonValue = z.infer<typeof JsonValueSchema>;
@@ -1073,6 +1064,170 @@ interface Analyzer {
     scan(options?: ScanOptions): Promise<ScanResult>;
 }
 
+interface SymbolSearchOptions {
+    limit?: number;
+}
+interface SymbolSearchMatch {
+    id: string;
+    name: string;
+    kind: SymbolKind;
+    file: string;
+    range: SourceRange;
+    /** Normalized query words not found in a partial word match. */
+    unmatchedTerms?: string[];
+}
+interface SymbolSearchResult {
+    query: string;
+    total: number;
+    truncated: boolean;
+    matches: SymbolSearchMatch[];
+}
+declare function findSymbols(map: CodeMap, query: string, options?: SymbolSearchOptions): SymbolSearchResult;
+
+interface ContextOptions {
+    root: string;
+    /** Shared source-line budget, 1..2000; default 800. */
+    maxLines?: number;
+    /** Shared source-character budget including line separators, 256..64000; default 32000. */
+    maxChars?: number;
+    /** Maximum search matches to expand, 1..5; default 3. */
+    seeds?: number;
+}
+interface ContextSnippet {
+    file: string;
+    startLine: number;
+    endLine: number;
+    source: string;
+}
+interface ContextOmission {
+    id: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+}
+interface ContextResult {
+    query: string;
+    matches: SymbolSearchMatch[];
+    moreMatches: number;
+    selected: {
+        id: string;
+        role: "match" | "neighbor";
+    }[];
+    snippets: ContextSnippet[];
+    omitted: ContextOmission[];
+    fileReferences: {
+        file: string;
+        line: number;
+    }[];
+    tests: {
+        file: string;
+        line: number;
+    }[];
+    omittedNavigation: number;
+    usedLines: number;
+    usedChars: number;
+    limits: {
+        maxLines: number;
+        maxChars: number;
+        seeds: number;
+    };
+}
+/** Expand matches and small outgoing dependencies into bounded current source. */
+declare function buildSourceContext(map: CodeMap, query: string, options: ContextOptions): Promise<ContextResult>;
+declare function formatSourceContext(result: ContextResult): string;
+
+interface ReadNavigationLink {
+    direction: "outgoing" | "incoming";
+    type: RelationType;
+    id: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    classification: "exact" | "framework-derived";
+}
+interface ReadNavigation {
+    links: ReadNavigationLink[];
+    /** Exact incoming call sites in paths named *.test.*, *.spec.* or __tests__/. */
+    tests: {
+        file: string;
+        line: number;
+    }[];
+    /** Unique eligible neighbors/sites excluded by the row or character limits. */
+    omittedLinks: number;
+    omittedTests: number;
+}
+
+interface ReadSourceOptions {
+    root: string;
+    /** Maximum source lines per page; integer 1..200, default 80. */
+    limit?: number;
+    /** Zero-based offset within the symbol's window, including two context lines. */
+    offset?: number;
+}
+interface ReadSourceResult {
+    id: string;
+    file: string;
+    symbolRange: SourceRange;
+    startLine: number;
+    endLine: number;
+    source: string;
+    truncated: boolean;
+    nextOffset?: number;
+    /** Bounded direct links and test call sites, present only at offset zero. */
+    navigation?: ReadNavigation;
+}
+/** Read current source using an exact map ID, never a fuzzy selector. */
+declare function readSymbolSource(map: CodeMap, id: string, options: ReadSourceOptions): Promise<ReadSourceResult>;
+
+interface ProjectMapView {
+    project: string;
+    counts: {
+        files: number;
+        symbols: number;
+        endpoints: number;
+        relationGroups: number;
+        relationRecords: number;
+    };
+    files: {
+        ref: string;
+        id: string;
+        path: string;
+    }[];
+    symbols: {
+        ref: string;
+        id: string;
+        name: string;
+        kind: SymbolKind;
+        file: string;
+        range: SourceRange;
+    }[];
+    endpoints: {
+        ref: string;
+        id: string;
+    }[];
+    relations: {
+        from: string;
+        type: RelationType;
+        classification: RelationEvidenceClassification;
+        targets: {
+            ref: string;
+            count: number;
+        }[];
+    }[];
+}
+/** Complete structural projection; no source text or per-occurrence evidence. */
+declare function buildProjectMap(map: CodeMap): ProjectMapView;
+declare function formatProjectMap(map: ProjectMapView): string;
+
+declare const SCHEMA_VERSION: 4;
+declare const CONFIG_VERSION: 1;
+declare const ANALYZER_VERSION = "0.4.0";
+
+declare class CodeMapError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+
 interface InitOptions extends LoadCodeMapOptions {
     force?: boolean;
 }
@@ -1121,7 +1276,13 @@ declare function computeManifestIntegrityHash(manifest: ManifestRecord): string;
 declare function checkFreshness(options?: LoadCodeMapOptions): Promise<FreshnessResult>;
 
 declare function showSymbol(map: CodeMap, selector: string): ShowResult;
-declare function formatShowResult(result: ShowResult): string;
+interface ShowFormatOptions {
+    /** Preserve the verbose text view. JSON and showSymbol always retain full records. */
+    full?: boolean;
+    /** Total relation groups across the compact view; integer 1..50, default 12. */
+    limit?: number;
+}
+declare function formatShowResult(result: ShowResult, options?: ShowFormatOptions): string;
 
 declare class CoreAnalyzer implements FrameworkAnalyzer {
     readonly name = "typescript-node";
@@ -1175,4 +1336,4 @@ declare class TypeScriptSemanticResolver implements SemanticResolver {
 }
 declare function createTypeScriptSemanticResolver(): SemanticResolver;
 
-export { ANALYZER_VERSION, type AnalysisContext, type AnalysisContribution, type Analyzer, type ArtifactIntegrityRecord, ArtifactIntegrityRecordSchema, CONFIG_VERSION, type CodeMap, type CodeMapConfig, CodeMapError, CodeMapSchema, type CompilerUnitRecord, CompilerUnitRecordSchema, ConfigSchema, CoreAnalyzer, type DiagnosticCode, type DiagnosticRecord, DiagnosticRecordSchema, type DiagnosticSeverity, type ExportRecord, type ExternalOperation, type ExternalOperationKind, FallbackParserAdapter, type FileRecord, FileRecordSchema, type Framework, type FrameworkAnalyzer, type FrameworkSelection, type FreshnessResult, type FreshnessStatus, GitIgnoreAdapter, type IgnoreAdapter, type ImportRecord, type ImportSpecifierRecord, type InitOptions, type InitResult, type JsonPrimitive, type JsonValue, type Language, type LoadCodeMapOptions, type ManifestRecord, ManifestRecordSchema, ManypkgWorkspaceDiscovery, type MapCounts, NestJsAnalyzer, NextJsAnalyzer, type ProducerRecord, ProducerRecordSchema, type ProjectRecord, ProjectRecordSchema, ReactAnalyzer, type RelationEvidenceClassification, type RelationOrigin, type RelationRecord, RelationRecordSchema, type RelationType, SCHEMA_VERSION, type ScanChanges, type ScanOptions, type ScanResult, type SemanticInputObservation, type SemanticInputRecord, SemanticInputRecordSchema, type SemanticModuleResolution, type SemanticResolution, type SemanticResolveInput, type SemanticResolver, type ShowResult, type SourceRange, type SymbolKind, type SymbolRecord, SymbolRecordSchema, type SyntaxFact, type SyntaxFactKind, type SyntaxIssue, type SyntaxParseInput, type SyntaxParseResult, type SyntaxParserAdapter, type SyntaxSummary, TypeScriptParserAdapter, TypeScriptSemanticResolver, type WorkspaceDiscovery, type WorkspaceDiscoveryResult, type WorkspacePackage, buildOverview, checkFreshness, computeManifestIntegrityHash, createAnalyzer, createDefaultConfig, createGitIgnoreAdapter, createTypeScriptParserAdapter, createTypeScriptSemanticResolver, createWorkspaceDiscovery, findProjectRoot, formatShowResult, initProject, loadCodeMap, scanProject, showSymbol };
+export { ANALYZER_VERSION, type AnalysisContext, type AnalysisContribution, type Analyzer, type ArtifactIntegrityRecord, ArtifactIntegrityRecordSchema, CONFIG_VERSION, type CodeMap, type CodeMapConfig, CodeMapError, CodeMapSchema, type CompilerUnitRecord, CompilerUnitRecordSchema, ConfigSchema, type ContextOmission, type ContextOptions, type ContextResult, type ContextSnippet, CoreAnalyzer, type DiagnosticCode, type DiagnosticRecord, DiagnosticRecordSchema, type DiagnosticSeverity, type ExportRecord, type ExternalOperation, type ExternalOperationKind, FallbackParserAdapter, type FileRecord, FileRecordSchema, type Framework, type FrameworkAnalyzer, type FrameworkSelection, type FreshnessResult, type FreshnessStatus, GitIgnoreAdapter, type IgnoreAdapter, type ImportRecord, type ImportSpecifierRecord, type InitOptions, type InitResult, type JsonPrimitive, type JsonValue, type Language, type LoadCodeMapOptions, type ManifestRecord, ManifestRecordSchema, ManypkgWorkspaceDiscovery, type MapCounts, NestJsAnalyzer, NextJsAnalyzer, type ProducerRecord, ProducerRecordSchema, type ProjectMapView, type ProjectRecord, ProjectRecordSchema, ReactAnalyzer, type ReadNavigation, type ReadNavigationLink, type ReadSourceOptions, type ReadSourceResult, type RelationEvidenceClassification, type RelationOrigin, type RelationRecord, RelationRecordSchema, type RelationType, SCHEMA_VERSION, type ScanChanges, type ScanOptions, type ScanResult, type SemanticInputObservation, type SemanticInputRecord, SemanticInputRecordSchema, type SemanticModuleResolution, type SemanticResolution, type SemanticResolveInput, type SemanticResolver, type ShowFormatOptions, type ShowResult, type SourceRange, type SymbolKind, type SymbolRecord, SymbolRecordSchema, type SymbolSearchMatch, type SymbolSearchOptions, type SymbolSearchResult, type SyntaxFact, type SyntaxFactKind, type SyntaxIssue, type SyntaxParseInput, type SyntaxParseResult, type SyntaxParserAdapter, type SyntaxSummary, TypeScriptParserAdapter, TypeScriptSemanticResolver, type WorkspaceDiscovery, type WorkspaceDiscoveryResult, type WorkspacePackage, buildOverview, buildProjectMap, buildSourceContext, checkFreshness, computeManifestIntegrityHash, createAnalyzer, createDefaultConfig, createGitIgnoreAdapter, createTypeScriptParserAdapter, createTypeScriptSemanticResolver, createWorkspaceDiscovery, findProjectRoot, findSymbols, formatProjectMap, formatShowResult, formatSourceContext, initProject, loadCodeMap, readSymbolSource, scanProject, showSymbol };