@eduardo-afonso/codebase-intelligence 0.1.0 → 2.0.1

package/dist/context/interfaces.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Context Engine — Core Interfaces
+ *
+ * Defines the contracts for the Context Engine and for future AI/embedding
+ * adapters. None of these interfaces are coupled to a specific LLM SDK or
+ * vector-store implementation.
+ *
+ * Implementations of AIProvider, EmbeddingProvider and VectorStore are
+ * intentionally excluded from the core library and must be provided by
+ * downstream packages (e.g. `codebase-intelligence-openai`).
+ */
+import type { LLMContextPayload, ContextOptions } from './types.js';
+/**
+ * The primary contract for building LLM-ready context payloads from a
+ * codebase that has already been loaded and analysed.
+ *
+ * Consumers should obtain an instance via `codebase.context()` rather than
+ * constructing one directly.
+ */
+export interface IContextEngine {
+    /**
+     * Builds a context payload centred on a specific source file.
+     *
+     * @param file     - Absolute or relative path to the target file.
+     * @param options  - Strategy, token budget, and inclusion flags.
+     */
+    forFile(file: string, options?: ContextOptions): Promise<LLMContextPayload>;
+    /**
+     * Builds a context payload centred on a named symbol (class, function, etc.).
+     * The file that declares the symbol is treated as the target.
+     *
+     * @param symbolName - The exact name of the symbol (e.g. `AuthService`).
+     * @param options    - Strategy, token budget, and inclusion flags.
+     */
+    forSymbol(symbolName: string, options?: ContextOptions): Promise<LLMContextPayload>;
+}
+/**
+ * Minimal adapter contract for any text-completion LLM.
+ *
+ * Implementations should be thin wrappers around their respective SDKs
+ * and must NOT be part of the `codebase-intelligence` core package.
+ *
+ * @example
+ * ```ts
+ * class OpenAIProvider implements AIProvider {
+ *   readonly name = 'openai';
+ *   async complete(prompt, systemPrompt) {
+ *     const res = await openai.chat.completions.create({ ... });
+ *     return res.choices[0].message.content ?? '';
+ *   }
+ * }
+ * ```
+ */
+export interface AIProvider {
+    /** Human-readable identifier, e.g. `'openai'`, `'ollama'`, `'anthropic'`. */
+    readonly name: string;
+    /**
+     * Sends a prompt and returns the model's response as a plain string.
+     *
+     * @param prompt       - The user/human turn of the conversation.
+     * @param systemPrompt - Optional system/instruction turn.
+     */
+    complete(prompt: string, systemPrompt?: string): Promise<string>;
+    /**
+     * Optional streaming variant.
+     * When implemented, callers can iterate over partial response chunks.
+     *
+     * @param prompt       - The user/human turn of the conversation.
+     * @param systemPrompt - Optional system/instruction turn.
+     */
+    stream?(prompt: string, systemPrompt?: string): AsyncIterable<string>;
+}
+/**
+ * Adapter contract for text-embedding models.
+ *
+ * Used by the RAG pipeline to convert `SemanticChunk` content into dense
+ * vectors for similarity search.
+ *
+ * Implementations must NOT live in the core package.
+ *
+ * @example
+ * ```ts
+ * class OllamaEmbeddingProvider implements EmbeddingProvider {
+ *   readonly dimensions = 768;
+ *   async embed(texts) { ... }
+ * }
+ * ```
+ */
+export interface EmbeddingProvider {
+    /** Dimensionality of the vectors produced by this provider. */
+    readonly dimensions: number;
+    /**
+     * Converts an array of text strings into an array of embedding vectors.
+     * The output array has the same length as the input.
+     *
+     * @param texts - Raw text strings to embed.
+     * @returns     A parallel array of numeric vectors.
+     */
+    embed(texts: string[]): Promise<number[][]>;
+}
+/** A single result returned by a vector similarity search. */
+export interface VectorSearchResult {
+    /** The ID that was passed to `upsert`. */
+    id: string;
+    /** Similarity score (higher = more similar; exact range is provider-specific). */
+    score: number;
+    /** Any metadata that was stored alongside the vector. */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Adapter contract for a vector database / similarity store.
+ *
+ * Implementations (Qdrant, pgvector, Chroma, Pinecone, etc.) must NOT live
+ * in the core package.
+ *
+ * @example
+ * ```ts
+ * class QdrantVectorStore implements VectorStore {
+ *   async upsert(id, vector, metadata) { ... }
+ *   async search(vector, topK) { ... }
+ *   async delete(id) { ... }
+ * }
+ * ```
+ */
+export interface VectorStore {
+    /**
+     * Inserts or updates a vector entry.
+     *
+     * @param id       - Stable unique identifier for this entry (e.g. chunk ID).
+     * @param vector   - Dense embedding vector.
+     * @param metadata - Arbitrary key-value metadata to store alongside the vector.
+     */
+    upsert(id: string, vector: number[], metadata: Record<string, unknown>): Promise<void>;
+    /**
+     * Returns the `topK` nearest entries to the query vector.
+     *
+     * @param vector - Query embedding vector.
+     * @param topK   - Maximum number of results to return.
+     */
+    search(vector: number[], topK: number): Promise<VectorSearchResult[]>;
+    /**
+     * Removes a single entry by ID.
+     * Implementations should be idempotent (no error if the ID does not exist).
+     *
+     * @param id - The ID that was passed to `upsert`.
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/context/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/context/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMpE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACrF;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CACvE;AAMD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC7C;AAMD,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/context/interfaces.js

@@ -0,0 +1,13 @@
+/**
+ * Context Engine — Core Interfaces
+ *
+ * Defines the contracts for the Context Engine and for future AI/embedding
+ * adapters. None of these interfaces are coupled to a specific LLM SDK or
+ * vector-store implementation.
+ *
+ * Implementations of AIProvider, EmbeddingProvider and VectorStore are
+ * intentionally excluded from the core library and must be provided by
+ * downstream packages (e.g. `codebase-intelligence-openai`).
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/context/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/context/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/context/strategies/ContextBuildStrategy.d.ts

@@ -0,0 +1,25 @@
+import type { ContextNode } from '../types.js';
+import type { CodebaseFile } from '../../core/types.js';
+import type { SymbolIndex } from '../../index/SymbolIndex.js';
+import { FileContextBuilder } from '../FileContextBuilder.js';
+/**
+ * Contract that each context-build strategy must fulfil.
+ *
+ * A strategy is responsible for converting a target file + its dependency
+ * files into an ordered list of `ContextNode`s.  The `ContextEngine` owns
+ * the budget enforcement and metadata collection; the strategy only decides
+ * *how* each file is represented.
+ */
+export interface ContextBuildStrategy {
+    /**
+     * Builds the ordered list of `ContextNode`s for the payload.
+     *
+     * @param targetFile       - The file the user asked about (always first).
+     * @param dependencyFiles  - Files directly imported by the target.
+     * @param symbolIndex      - Symbol index for signature extraction.
+     * @param codebaseRoot     - Absolute path used for `relativePath` normalisation.
+     */
+    buildNodes(targetFile: CodebaseFile, dependencyFiles: CodebaseFile[], symbolIndex: SymbolIndex, codebaseRoot: string): Promise<ContextNode[]>;
+}
+export { FileContextBuilder };
+//# sourceMappingURL=ContextBuildStrategy.d.ts.map

package/dist/context/strategies/ContextBuildStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBuildStrategy.d.ts","sourceRoot":"","sources":["../../../src/context/strategies/ContextBuildStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,UAAU,CACR,UAAU,EAAE,YAAY,EACxB,eAAe,EAAE,YAAY,EAAE,EAC/B,WAAW,EAAE,WAAW,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC3B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/context/strategies/ContextBuildStrategy.js

@@ -0,0 +1,3 @@
+import { FileContextBuilder } from '../FileContextBuilder.js';
+export { FileContextBuilder };
+//# sourceMappingURL=ContextBuildStrategy.js.map

package/dist/context/strategies/ContextBuildStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBuildStrategy.js","sourceRoot":"","sources":["../../../src/context/strategies/ContextBuildStrategy.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AA2B9D,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/context/strategies/DeepStrategy.d.ts

@@ -0,0 +1,18 @@
+import type { ContextBuildStrategy } from './ContextBuildStrategy.js';
+import type { ContextNode } from '../types.js';
+import type { CodebaseFile } from '../../core/types.js';
+import type { SymbolIndex } from '../../index/SymbolIndex.js';
+/**
+ * `deep` strategy — target file + all dependencies with full source content.
+ *
+ * Use when the LLM needs the complete implementation context, for example
+ * when debugging subtle runtime behaviour or when generating code that must
+ * match a specific implementation detail.
+ *
+ * Token usage is high; pair with a generous `maxTokens` budget.
+ */
+export declare class DeepStrategy implements ContextBuildStrategy {
+    private readonly builder;
+    buildNodes(targetFile: CodebaseFile, dependencyFiles: CodebaseFile[], _symbolIndex: SymbolIndex, codebaseRoot: string): Promise<ContextNode[]>;
+}
+//# sourceMappingURL=DeepStrategy.d.ts.map

package/dist/context/strategies/DeepStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepStrategy.d.ts","sourceRoot":"","sources":["../../../src/context/strategies/DeepStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D;;;;;;;;GAQG;AACH,qBAAa,YAAa,YAAW,oBAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEvC,UAAU,CACrB,UAAU,EAAE,YAAY,EACxB,eAAe,EAAE,YAAY,EAAE,EAC/B,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB;CACF"}

package/dist/context/strategies/DeepStrategy.js

@@ -0,0 +1,19 @@
+import { FileContextBuilder } from '../FileContextBuilder.js';
+/**
+ * `deep` strategy — target file + all dependencies with full source content.
+ *
+ * Use when the LLM needs the complete implementation context, for example
+ * when debugging subtle runtime behaviour or when generating code that must
+ * match a specific implementation detail.
+ *
+ * Token usage is high; pair with a generous `maxTokens` budget.
+ */
+export class DeepStrategy {
+    builder = new FileContextBuilder();
+    async buildNodes(targetFile, dependencyFiles, _symbolIndex, codebaseRoot) {
+        const targetNode = await this.builder.buildFileNode(targetFile, codebaseRoot);
+        const depNodes = await Promise.all(dependencyFiles.map(dep => this.builder.buildFileNode(dep, codebaseRoot)));
+        return [targetNode, ...depNodes];
+    }
+}
+//# sourceMappingURL=DeepStrategy.js.map

package/dist/context/strategies/DeepStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepStrategy.js","sourceRoot":"","sources":["../../../src/context/strategies/DeepStrategy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACN,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE7C,KAAK,CAAC,UAAU,CACrB,UAAwB,EACxB,eAA+B,EAC/B,YAAyB,EACzB,YAAoB;QAEpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAC1E,CAAC;QAEF,OAAO,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/context/strategies/ShallowStrategy.d.ts

@@ -0,0 +1,15 @@
+import type { ContextBuildStrategy } from './ContextBuildStrategy.js';
+import type { ContextNode } from '../types.js';
+import type { CodebaseFile } from '../../core/types.js';
+import type { SymbolIndex } from '../../index/SymbolIndex.js';
+/**
+ * `shallow` strategy — target file only, full content, no dependencies.
+ *
+ * Use when you want the minimum possible context. Ideal for large files
+ * where the LLM should focus exclusively on the file itself.
+ */
+export declare class ShallowStrategy implements ContextBuildStrategy {
+    private readonly builder;
+    buildNodes(targetFile: CodebaseFile, _dependencyFiles: CodebaseFile[], _symbolIndex: SymbolIndex, codebaseRoot: string): Promise<ContextNode[]>;
+}
+//# sourceMappingURL=ShallowStrategy.d.ts.map

package/dist/context/strategies/ShallowStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShallowStrategy.d.ts","sourceRoot":"","sources":["../../../src/context/strategies/ShallowStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,oBAAoB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEvC,UAAU,CACrB,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAAE,EAChC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;CACF"}

package/dist/context/strategies/ShallowStrategy.js

@@ -0,0 +1,15 @@
+import { FileContextBuilder } from '../FileContextBuilder.js';
+/**
+ * `shallow` strategy — target file only, full content, no dependencies.
+ *
+ * Use when you want the minimum possible context. Ideal for large files
+ * where the LLM should focus exclusively on the file itself.
+ */
+export class ShallowStrategy {
+    builder = new FileContextBuilder();
+    async buildNodes(targetFile, _dependencyFiles, _symbolIndex, codebaseRoot) {
+        const targetNode = await this.builder.buildFileNode(targetFile, codebaseRoot);
+        return [targetNode];
+    }
+}
+//# sourceMappingURL=ShallowStrategy.js.map

package/dist/context/strategies/ShallowStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShallowStrategy.js","sourceRoot":"","sources":["../../../src/context/strategies/ShallowStrategy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE7C,KAAK,CAAC,UAAU,CACrB,UAAwB,EACxB,gBAAgC,EAChC,YAAyB,EACzB,YAAoB;QAEpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAC9E,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/context/strategies/SignatureStrategy.d.ts

@@ -0,0 +1,20 @@
+import type { ContextBuildStrategy } from './ContextBuildStrategy.js';
+import type { ContextNode } from '../types.js';
+import type { CodebaseFile } from '../../core/types.js';
+import type { SymbolIndex } from '../../index/SymbolIndex.js';
+/**
+ * `signature` strategy — target file as full content; dependencies as
+ * AST-extracted signatures (no implementation bodies).
+ *
+ * This is the recommended default. It gives the LLM complete type information
+ * (parameter types, return types, generics, modifiers) for every dependency
+ * without including their implementation details. Typically 60–80 % fewer
+ * tokens than `deep` for the same informational value.
+ */
+export declare class SignatureStrategy implements ContextBuildStrategy {
+    private readonly builder;
+    private readonly extractor;
+    buildNodes(targetFile: CodebaseFile, dependencyFiles: CodebaseFile[], _symbolIndex: SymbolIndex, codebaseRoot: string): Promise<ContextNode[]>;
+    private buildAstSignatureNode;
+}
+//# sourceMappingURL=SignatureStrategy.d.ts.map

package/dist/context/strategies/SignatureStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureStrategy.d.ts","sourceRoot":"","sources":["../../../src/context/strategies/SignatureStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,oBAAoB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IAEzC,UAAU,CACrB,UAAU,EAAE,YAAY,EACxB,eAAe,EAAE,YAAY,EAAE,EAC/B,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgBxB;YAIa,qBAAqB;CAgCpC"}

package/dist/context/strategies/SignatureStrategy.js

@@ -0,0 +1,59 @@
+import { FileContextBuilder, buildNodeId } from '../FileContextBuilder.js';
+import { SignatureExtractor } from '../SignatureExtractor.js';
+/**
+ * `signature` strategy — target file as full content; dependencies as
+ * AST-extracted signatures (no implementation bodies).
+ *
+ * This is the recommended default. It gives the LLM complete type information
+ * (parameter types, return types, generics, modifiers) for every dependency
+ * without including their implementation details. Typically 60–80 % fewer
+ * tokens than `deep` for the same informational value.
+ */
+export class SignatureStrategy {
+    builder = new FileContextBuilder();
+    extractor = new SignatureExtractor();
+    async buildNodes(targetFile, dependencyFiles, _symbolIndex, codebaseRoot) {
+        const targetNode = await this.builder.buildFileNode(targetFile, codebaseRoot);
+        const depNodes = [];
+        for (const dep of dependencyFiles) {
+            // Only TypeScript/JavaScript files can be processed by ts-morph.
+            // JSON and other files fall back to the full-file node.
+            if (dep.language === 'typescript' || dep.language === 'javascript') {
+                const node = await this.buildAstSignatureNode(dep, codebaseRoot);
+                depNodes.push(node);
+            }
+            else {
+                depNodes.push(await this.builder.buildFileNode(dep, codebaseRoot));
+            }
+        }
+        return [targetNode, ...depNodes];
+    }
+    // ---- Private helpers -----------------------------------------------------
+    async buildAstSignatureNode(file, codebaseRoot) {
+        const relativePath = this.builder.resolveRelativePath(file, codebaseRoot);
+        let signatureContent;
+        try {
+            signatureContent = this.extractor.extract(file.path);
+        }
+        catch {
+            // If ts-morph fails (e.g. unsupported syntax), fall back to the full file.
+            const fallback = await this.builder.buildFileNode(file, codebaseRoot);
+            return fallback;
+        }
+        // Never produce an empty node — fall back to the full file.
+        if (!signatureContent.trim()) {
+            return this.builder.buildFileNode(file, codebaseRoot);
+        }
+        const totalLines = signatureContent.split('\n').length;
+        return {
+            id: buildNodeId(relativePath, 1, totalLines),
+            file: file.path,
+            relativePath,
+            content: signatureContent,
+            kind: 'signature',
+            startLine: 1,
+            endLine: totalLines,
+        };
+    }
+}
+//# sourceMappingURL=SignatureStrategy.js.map

package/dist/context/strategies/SignatureStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignatureStrategy.js","sourceRoot":"","sources":["../../../src/context/strategies/SignatureStrategy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACnC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE/C,KAAK,CAAC,UAAU,CACrB,UAAwB,EACxB,eAA+B,EAC/B,YAAyB,EACzB,YAAoB;QAEpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,iEAAiE;YACjE,wDAAwD;YACxD,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBACjE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,OAAO,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,qBAAqB,CACjC,IAAkB,EAClB,YAAoB;QAEpB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAE1E,IAAI,gBAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;YAC3E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACtE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,4DAA4D;QAC5D,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAEvD,OAAO;YACL,EAAE,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,UAAU,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY;YACZ,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;CACF"}

package/dist/context/strategies/index.d.ts

@@ -0,0 +1,5 @@
+export { ShallowStrategy } from './ShallowStrategy.js';
+export { SignatureStrategy } from './SignatureStrategy.js';
+export { DeepStrategy } from './DeepStrategy.js';
+export type { ContextBuildStrategy } from './ContextBuildStrategy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/context/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/context/strategies/index.js

@@ -0,0 +1,4 @@
+export { ShallowStrategy } from './ShallowStrategy.js';
+export { SignatureStrategy } from './SignatureStrategy.js';
+export { DeepStrategy } from './DeepStrategy.js';
+//# sourceMappingURL=index.js.map

package/dist/context/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/context/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Context Engine — Public Types
+ *
+ * Defines the data structures produced by the Context Engine. These types are
+ * intentionally decoupled from any specific AI provider or LLM SDK.
+ */
+import type { SymbolKind } from '../core/types.js';
+/**
+ * The granularity of a single context node.
+ *
+ * - `file`      — the full content of a source file
+ * - `class`     — a complete class declaration (body included)
+ * - `function`  — a complete function/arrow-function declaration
+ * - `symbol`    — any other named declaration (variable, type alias, etc.)
+ * - `signature` — the declaration *without* its implementation body;
+ *                 used by the `signature` strategy to save tokens while
+ *                 still conveying type information
+ */
+export type ContextNodeKind = 'file' | 'class' | 'function' | 'symbol' | 'signature';
+/**
+ * A self-contained fragment of code with enough metadata for a LLM to reason
+ * about its location, role, and relationships inside the codebase.
+ */
+export interface ContextNode {
+    /** Unique identifier: `<relativePath>:<startLine>-<endLine>` */
+    id: string;
+    /** Absolute path to the source file. */
+    file: string;
+    /** Path relative to the codebase root (preferred for display). */
+    relativePath: string;
+    /** The raw source code of this fragment. */
+    content: string;
+    /** Granularity of this node. */
+    kind: ContextNodeKind;
+    /** 1-based start line in the source file. */
+    startLine: number;
+    /** 1-based end line in the source file. */
+    endLine: number;
+    /**
+     * Name of the symbol this node represents (when kind ≠ 'file').
+     * Matches the name stored in `SymbolIndex`.
+     */
+    symbolName?: string;
+    /**
+     * `SymbolKind` of the symbol this node represents.
+     * Omitted when kind === 'file'.
+     */
+    symbolKind?: SymbolKind;
+    /**
+     * ID of the parent `ContextNode` when this node is a method or nested
+     * member of a larger declaration (e.g. a method inside a class node).
+     */
+    parentId?: string;
+}
+/**
+ * The three context-resolution strategies control the trade-off between
+ * token usage and information richness.
+ *
+ * | Strategy    | Target file | Dependency content              | Tokens |
+ * |-------------|-------------|---------------------------------|--------|
+ * | `shallow`   | full        | none                            | low    |
+ * | `signature` | full        | declaration only (no body, AST) | medium |
+ * | `deep`      | full        | full source                     | high   |
+ *
+ * `signature` is the recommended default: it preserves all type information
+ * (parameter types, return types, generics) without bloating the prompt with
+ * implementation details the LLM does not need.
+ */
+export type ContextStrategy = 'shallow' | 'signature' | 'deep';
+/**
+ * Options accepted by `ContextEngine.forFile()` and `ContextEngine.forSymbol()`.
+ */
+export interface ContextOptions {
+    /**
+     * How dependency content is included in the payload.
+     * @default 'signature'
+     */
+    strategy?: ContextStrategy;
+    /**
+     * Soft upper bound on the total token estimate of the payload.
+     * When the estimate would exceed this value, lower-priority nodes
+     * (transitive / indirect dependencies) are dropped first.
+     * The target file itself is *never* truncated.
+     * @default 8000
+     */
+    maxTokens?: number;
+    /**
+     * Whether to include related test files in the payload.
+     * @default false
+     */
+    includeTests?: boolean;
+    /**
+     * Whether to include files that depend *on* the target (dependents) in
+     * addition to the files the target depends *on* (dependencies).
+     * Useful when the question is "will my change break callers?".
+     * @default false
+     */
+    includeDependents?: boolean;
+}
+/**
+ * The final structured object delivered to a LLM (or to the caller when
+ * used programmatically).
+ *
+ * `nodes` is ordered: the target node is always first, followed by direct
+ * dependencies, then indirect ones, then dependents (if requested).
+ */
+export interface LLMContextPayload {
+    /** The file or symbol that was the focus of the context request. */
+    target: string;
+    /** The strategy used to build this payload. */
+    strategy: ContextStrategy;
+    /** Ordered list of code fragments to include in the LLM prompt. */
+    nodes: ContextNode[];
+    /**
+     * Rough estimate of the total token count (`totalChars / 4`).
+     * This avoids a hard dependency on tokeniser libraries while being
+     * accurate enough for budget planning.
+     */
+    totalTokenEstimate: number;
+    /** Relational metadata derived from the Dependency Graph. */
+    metadata: ContextPayloadMetadata;
+}
+/**
+ * Relational metadata attached to every `LLMContextPayload`.
+ * Gives the LLM (or the caller) a high-level map of how the target
+ * fits into the broader codebase without requiring it to read all nodes.
+ */
+export interface ContextPayloadMetadata {
+    /** Files directly imported by the target. */
+    directDependencies: string[];
+    /** Files that directly import the target. */
+    directDependents: string[];
+    /** Test files related to the target (by naming convention). */
+    relatedTests: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAM/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,EAAE,eAAe,CAAC;IAC1B,mEAAmE;IACnE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/context/types.js

@@ -0,0 +1,8 @@
+/**
+ * Context Engine — Public Types
+ *
+ * Defines the data structures produced by the Context Engine. These types are
+ * intentionally decoupled from any specific AI provider or LLM SDK.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/Codebase.d.ts

@@ -3,6 +3,11 @@ import type { CodebaseFile, CodeSymbol } from './types.js';
 import type { ProjectInfo } from '../discovery/ProjectDetector.js';
 import type { SearchResult, SearchOptions } from '../search/CodeSearch.js';
 import type { ImpactResult } from '../analysis/ImpactAnalyzer.js';
+import { ContextEngine } from '../context/ContextEngine.js';
+import type { SemanticChunk, ChunkerOptions } from '../context/SemanticChunker.js';
+import { CodebaseWithAI } from '../ai/CodebaseWithAI.js';
+import type { AIProvider } from '../context/interfaces.js';
+import type { ChangeSetOptions, ChangeSetProvider, ChangeSetImpact } from '../diff/types.js';
 export interface CodebaseOptions {
     ignore?: string[];
     /** Enable on-disk caching of parse results. Defaults to true. */
@@ -29,7 +34,52 @@ export declare class Codebase {
     dependencies(file: string): string[];
     dependents(file: string): string[];
     impact(file: string): ImpactResult;
+    /**
+     * Analyzes the impact of a specific list of files without querying a VCS.
+     * Treats all given files as 'modified'.
+     *
+     * @throws if called before `analyze()`.
+     */
+    impactOfFiles(paths: string[]): ChangeSetImpact;
+    /**
+     * Analyzes the impact of a set of changes obtained from a `ChangeSetProvider`.
+     * Defaults to querying the local Git repository for changes.
+     *
+     * @throws if called before `analyze()`.
+     */
+    impactOfChanges(options?: ChangeSetOptions, provider?: ChangeSetProvider): Promise<ChangeSetImpact>;
     isAnalyzed(): boolean;
+    /**
+     * Returns a `ContextEngine` pre-configured with this codebase's graph,
+     * symbol index, and file index.
+     *
+     * Use the returned engine to build LLM-ready context payloads:
+     * ```ts
+     * const payload = await codebase.context().forFile('src/auth/AuthService.ts');
+     * ```
+     *
+     * @throws if called before `analyze()`.
+     */
+    context(): ContextEngine;
+    /**
+     * Returns a `CodebaseWithAI` instance that pairs this codebase with the
+     * given AI provider, exposing the `explain` and `ask` high-level APIs.
+     *
+     * ```ts
+     * const answer = await codebase
+     *   .withAI(new OpenAIProvider())
+     *   .ask('Como funciona a autenticação?');
+     * ```
+     *
+     * @throws if called before `analyze()`.
+     */
+    withAI(provider: AIProvider): CodebaseWithAI;
+    /**
+     * Dividir ficheiros em chunks semânticos (baseados em AST, não em caracteres).
+     *
+     * @throws se chamado antes de `analyze()`.
+     */
+    chunks(options?: ChunkerOptions): Promise<SemanticChunk[]>;
     /**
      * Deletes the on-disk cache for this codebase.
      * Subsequent calls to analyze() will re-parse all files.

package/dist/core/Codebase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Codebase.d.ts","sourceRoot":"","sources":["../../src/core/Codebase.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C,OAAO,eAGN;IAID,OAAoB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqBtF;IAIY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA2CpC;IAIM,KAAK,IAAI,YAAY,EAAE,CAE7B;IAEM,OAAO,IAAI,UAAU,EAAE,CAE7B;IAEM,WAAW,IAAI,WAAW,GAAG,IAAI,CAEvC;IAEM,KAAK,IAAI,eAAe,CAE9B;IAEM,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE,CAGxE;IAEM,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1C;IAEM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExC;IAEM,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExC;IAEM,UAAU,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACI,eAAe,IAAI,IAAI,CAG7B;CACF"}
+{"version":3,"file":"Codebase.d.ts","sourceRoot":"","sources":["../../src/core/Codebase.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAc,MAAM,kBAAkB,CAAC;AAEzG,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA8B;IAE5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C,OAAO,eAGN;IAID,OAAoB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqBtF;IAIY,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA2CpC;IAIM,KAAK,IAAI,YAAY,EAAE,CAE7B;IAEM,OAAO,IAAI,UAAU,EAAE,CAE7B;IAEM,WAAW,IAAI,WAAW,GAAG,IAAI,CAEvC;IAEM,KAAK,IAAI,eAAe,CAE9B;IAEM,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE,CAGxE;IAEM,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1C;IAEM,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExC;IAEM,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExC;IAED;;;;;OAKG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAkBrD;IAED;;;;;OAKG;IACU,eAAe,CAC1B,OAAO,CAAC,EAAE,gBAAgB,EAC1B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAuB1B;IAEM,UAAU,IAAI,OAAO,CAE3B;IAED;;;;;;;;;;OAUG;IACI,OAAO,IAAI,aAAa,CAa9B;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAQlD;IAED;;;;OAIG;IACU,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAStE;IAED;;;OAGG;IACI,eAAe,IAAI,IAAI,CAG7B;CACF"}