gitnexus 1.6.11-rc.14 → 1.6.11-rc.16

package/dist/core/ingestion/languages/csharp/razor-view-components.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ASP.NET Core ViewComponent convention support.
+ *
+ * Same bound as Spring Boot DI in Java/Kotlin: do not resolve into the SDK
+ * (`Microsoft.AspNetCore.Mvc.ViewComponent`, `IViewComponentHelper`,
+ * `Component.InvokeAsync` itself). Those types live outside the workspace.
+ * The only hop worth taking is the framework convention that lands on an
+ * **in-repo** class — `InvokeAsync("Foo")` → workspace `FooViewComponent`,
+ * just as a Spring `@Autowired IFoo` fans out to an in-repo `@Service`,
+ * not to `ApplicationContext`.
+ *
+ * Razor templates are not parsed as C# (markup + code would poison
+ * tree-sitter-c-sharp). A small Razor state machine extracts C# islands and
+ * markup tag helpers; C# files use a string/comment-aware lexer so attributes
+ * and literals are not mistaken for helper calls. Literal names are enough
+ * because the target catalog is already built from parsed `.cs` classes.
+ */
+import type { ParsedFile } from '../../../../_shared/index.js';
+import type { KnowledgeGraph } from '../../../graph/types.js';
+import type { GraphNodeLookup } from '../../scope-resolution/graph-bridge/node-lookup.js';
+export interface RazorViewComponentConfig {
+    /** Repo-relative `.cshtml` path → extracted invocation names. */
+    readonly views: ReadonlyMap<string, readonly string[]>;
+}
+export interface ViewComponentAliasBind {
+    readonly className: string;
+    /** 1-based line of the type declaration (including leading attributes). */
+    readonly startLine: number;
+    /** 0-based column of the type declaration (including leading attributes). */
+    readonly startCol: number;
+    readonly aliases: readonly string[];
+}
+/** In-repo C# `Component.InvokeAsync("X")` / `ViewComponent("X")` literals. */
+export declare function extractCsharpViewComponentInvocations(source: string): string[];
+/**
+ * Explicit `[ViewComponent(Name = "...")]` aliases keyed to the following
+ * class declaration. Positional constructor arguments are ignored: the MVC
+ * attribute only exposes `Name` as a property.
+ */
+export declare function extractViewComponentAliasBinds(source: string): ViewComponentAliasBind[];
+/** Extract explicit `[ViewComponent(Name = "...")]` aliases by class name. */
+export declare function extractViewComponentAliases(source: string): ReadonlyMap<string, readonly string[]>;
+/** Extract statically resolvable ViewComponent names from one Razor template. */
+export declare function extractRazorViewComponentInvocations(source: string): string[];
+/**
+ * Read Razor views once per C# resolution pass. The same ignore rules and file
+ * size ceiling as repository scanning are applied, and edge emission later
+ * additionally requires a live File node. This prevents ignored, oversized,
+ * or concurrently removed templates from entering the graph.
+ */
+export declare function loadRazorViewComponentConfig(repoRoot: string): Promise<RazorViewComponentConfig>;
+/**
+ * Emit workspace File → in-repo ViewComponent Class CALLS edges.
+ *
+ * Targets are only Class nodes produced from this repo's `.cs` files. There is
+ * no lookup of ASP.NET SDK types; `: ViewComponent` in source is a naming
+ * hint, not a resolved EXTENDS edge to `Microsoft.AspNetCore.Mvc.ViewComponent`.
+ *
+ * Ambiguous component names fail closed: two in-repo classes claiming the
+ * same name is not evidence for picking either one.
+ */
+export declare function emitRazorViewComponentEdges(graph: KnowledgeGraph, parsedFiles: readonly ParsedFile[], nodeLookup: GraphNodeLookup, config: RazorViewComponentConfig | undefined, csharpSources: ReadonlyMap<string, string>): void;