@ctxo/lang-csharp 0.7.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alper Hankendi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { ILanguageAdapter, SymbolNode, GraphEdge, ComplexityMetrics, SymbolKind, CtxoLanguagePlugin } from '@ctxo/plugin-api';
+import Parser, { Tree, SyntaxNode } from 'tree-sitter';
+
+interface RoslynFileResult {
+    type: 'file';
+    file: string;
+    symbols: RoslynSymbol[];
+    edges: RoslynEdge[];
+    complexity: RoslynComplexity[];
+}
+interface RoslynSymbol {
+    symbolId: string;
+    name: string;
+    kind: string;
+    startLine: number;
+    endLine: number;
+    startOffset?: number;
+    endOffset?: number;
+}
+interface RoslynEdge {
+    from: string;
+    to: string;
+    kind: string;
+}
+interface RoslynComplexity {
+    symbolId: string;
+    cyclomatic: number;
+    cognitive: number;
+}
+interface RoslynProjectGraph {
+    type: 'projectGraph';
+    projects: Array<{
+        name: string;
+        path: string;
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+        kind: string;
+    }>;
+}
+interface RoslynBatchResult {
+    files: RoslynFileResult[];
+    projectGraph: RoslynProjectGraph | null;
+    totalFiles: number;
+    elapsed: string;
+}
+
+declare class RoslynAdapter implements ILanguageAdapter {
+    readonly extensions: readonly [".cs"];
+    readonly tier: "full";
+    private roslynProjectDir;
+    private solutionPath;
+    private rootDir;
+    private cache;
+    private keepAlive;
+    private initialized;
+    isSupported(filePath: string): boolean;
+    isReady(): boolean;
+    initialize(rootDir: string): Promise<void>;
+    /**
+     * Run batch analysis for all .cs files in the solution.
+     * Call this once before extractSymbols/extractEdges for best performance.
+     */
+    batchIndex(): Promise<RoslynBatchResult | null>;
+    extractSymbols(filePath: string, _source: string): Promise<SymbolNode[]>;
+    extractEdges(filePath: string, _source: string): Promise<GraphEdge[]>;
+    extractComplexity(filePath: string, _source: string): Promise<ComplexityMetrics[]>;
+    /**
+     * Start keep-alive process for watch mode.
+     */
+    startKeepAlive(): Promise<boolean>;
+    /**
+     * Incremental re-analysis of a single file (keep-alive mode).
+     */
+    reindexFile(relativePath: string): Promise<RoslynFileResult | null>;
+    dispose(): Promise<void>;
+}
+
+/**
+ * Chooses between the full-tier Roslyn launcher and the syntax-tier tree-sitter
+ * adapter at initialize() time. Forwards extract*() calls to the active delegate
+ * and exposes the Roslyn delegate (when active) for cli optimizations such as
+ * watch-mode keep-alive and batch index pre-warm.
+ */
+declare class CSharpCompositeAdapter implements ILanguageAdapter {
+    private delegate;
+    private roslyn;
+    private treeSitter;
+    initialize(rootDir: string): Promise<void>;
+    dispose(): Promise<void>;
+    extractSymbols(filePath: string, source: string): Promise<SymbolNode[]>;
+    extractEdges(filePath: string, source: string): Promise<GraphEdge[]>;
+    extractComplexity(filePath: string, source: string): Promise<ComplexityMetrics[]>;
+    isSupported(filePath: string): boolean;
+    setSymbolRegistry(registry: Map<string, SymbolKind>): void;
+    /** Exposed for cli watch/index optimizations. Null when running in syntax tier. */
+    getRoslynDelegate(): RoslynAdapter | null;
+    /** Current active tier after initialize() resolves. */
+    getTier(): 'full' | 'syntax' | 'unavailable';
+}
+
+type Language = Parameters<InstanceType<typeof Parser>['setLanguage']>[0];
+
+declare abstract class TreeSitterAdapter implements ILanguageAdapter {
+    abstract readonly extensions: readonly string[];
+    readonly tier: "syntax";
+    protected parser: Parser;
+    protected symbolRegistry: Map<string, "function" | "class" | "interface" | "method" | "variable" | "type">;
+    constructor(language: Language);
+    isSupported(filePath: string): boolean;
+    setSymbolRegistry(registry: Map<string, SymbolKind>): void;
+    protected parse(source: string): Tree;
+    protected buildSymbolId(filePath: string, name: string, kind: SymbolKind): string;
+    protected nodeToLineRange(node: SyntaxNode): {
+        startLine: number;
+        endLine: number;
+        startOffset: number;
+        endOffset: number;
+    };
+    protected countCyclomaticComplexity(node: SyntaxNode, branchTypes: string[]): number;
+    abstract extractSymbols(filePath: string, source: string): Promise<SymbolNode[]>;
+    abstract extractEdges(filePath: string, source: string): Promise<GraphEdge[]>;
+    abstract extractComplexity(filePath: string, source: string): Promise<ComplexityMetrics[]>;
+}
+
+declare class CSharpAdapter extends TreeSitterAdapter {
+    readonly extensions: readonly [".cs"];
+    constructor();
+    extractSymbols(filePath: string, source: string): Promise<SymbolNode[]>;
+    extractEdges(filePath: string, source: string): Promise<GraphEdge[]>;
+    extractComplexity(filePath: string, source: string): Promise<ComplexityMetrics[]>;
+    private visitSymbols;
+    private extractMethodSymbols;
+    private visitEdges;
+    private visitComplexity;
+    private countParameters;
+    private isPublic;
+    private resolveBaseType;
+}
+
+declare const plugin: CtxoLanguagePlugin;
+
+export { CSharpAdapter, CSharpCompositeAdapter, RoslynAdapter, TreeSitterAdapter, plugin as default, plugin };