agents-reverse-engineer 0.1.1

package/dist/generation/prompts/templates.js

@@ -0,0 +1,247 @@
+const BASE_SYSTEM_PROMPT = `You are analyzing source code to generate documentation for AI coding assistants.
+
+Guidelines:
+- Be concise but comprehensive (300-500 words)
+- Focus on what the code DOES and HOW to use it
+- Include key function signatures as code snippets
+- Note dependencies and their purposes
+- Mention only critical TODOs (security, breaking issues)
+- Reference tightly coupled files (used together)`;
+const COMPONENT_TEMPLATE = {
+    fileType: 'component',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this {{FRAMEWORK}} component and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What this component renders and when it's used
+2. **Props**: List props with types and descriptions
+3. **State**: Key state variables and their roles
+4. **Hooks**: Custom hooks used and why
+5. **Events**: Key event handlers and their behavior
+6. **Dependencies**: Imported modules and their usage
+7. **Related Files**: Tightly coupled components/utilities`,
+    focusAreas: ['props', 'state', 'rendering logic', 'event handlers'],
+};
+const SERVICE_TEMPLATE = {
+    fileType: 'service',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this service module and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What business logic this service handles
+2. **Public Interface**: Exported functions/methods with signatures
+3. **Dependencies**: External services, APIs, databases used
+4. **Error Handling**: How errors are managed
+5. **Side Effects**: External mutations, API calls, file operations
+6. **Patterns**: Notable patterns (singleton, factory, etc.)`,
+    focusAreas: ['public methods', 'dependencies', 'error handling', 'side effects'],
+};
+const UTIL_TEMPLATE = {
+    fileType: 'util',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this utility module and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What problems these utilities solve
+2. **Functions**: List each exported function with signature and brief description
+3. **Pure vs Impure**: Note which functions have side effects
+4. **Common Usage**: Typical use cases
+5. **Edge Cases**: Notable edge case handling`,
+    focusAreas: ['function signatures', 'input/output types', 'edge cases'],
+};
+const TYPE_TEMPLATE = {
+    fileType: 'type',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this type definitions file and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What domain these types represent
+2. **Main Types**: List key interfaces/types with descriptions
+3. **Relationships**: How types relate to each other
+4. **Usage**: Where these types are typically used
+5. **Constraints**: Notable validation or narrowing`,
+    focusAreas: ['interface definitions', 'type relationships', 'generics'],
+};
+const TEST_TEMPLATE = {
+    fileType: 'test',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this test file and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Subject**: What module/function is being tested
+2. **Test Cases**: Group and describe test scenarios
+3. **Coverage**: What behaviors are tested
+4. **Fixtures**: Test data and mocks used
+5. **Patterns**: Testing patterns (AAA, mocking strategy)`,
+    focusAreas: ['test descriptions', 'assertions', 'mocks'],
+};
+const CONFIG_TEMPLATE = {
+    fileType: 'config',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this configuration file and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What this configures
+2. **Key Settings**: Important configuration values
+3. **Defaults**: Notable default values
+4. **Environment**: Environment-specific settings
+5. **Dependencies**: What tools/libraries this configures`,
+    focusAreas: ['settings', 'defaults', 'environment variables'],
+};
+const API_TEMPLATE = {
+    fileType: 'api',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this API route/handler and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Endpoint**: HTTP method and path
+2. **Request**: Expected request body/params/query
+3. **Response**: Response format and status codes
+4. **Auth**: Authentication/authorization requirements
+5. **Validation**: Input validation rules
+6. **Errors**: Error responses and codes`,
+    focusAreas: ['HTTP methods', 'request/response shapes', 'validation', 'auth'],
+};
+const MODEL_TEMPLATE = {
+    fileType: 'model',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this data model/entity and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Entity**: What this model represents
+2. **Fields**: List fields with types and constraints
+3. **Relations**: Relationships to other models
+4. **Indexes**: Database indexes defined
+5. **Methods**: Model methods and their purposes`,
+    focusAreas: ['fields', 'relations', 'constraints', 'indexes'],
+};
+const HOOK_TEMPLATE = {
+    fileType: 'hook',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this React hook and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What state/behavior this hook provides
+2. **Parameters**: Input parameters with types
+3. **Return Value**: What the hook returns
+4. **State**: Internal state managed
+5. **Effects**: Side effects and cleanup
+6. **Dependencies**: Hooks and utilities used`,
+    focusAreas: ['parameters', 'return value', 'effects', 'cleanup'],
+};
+const SCHEMA_TEMPLATE = {
+    fileType: 'schema',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this validation schema and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What data this schema validates
+2. **Shape**: Top-level structure of the schema
+3. **Fields**: Key fields with validation rules
+4. **Transforms**: Data transformations applied
+5. **Defaults**: Default values
+6. **Errors**: Custom error messages`,
+    focusAreas: ['validation rules', 'transforms', 'defaults', 'errors'],
+};
+const GENERIC_TEMPLATE = {
+    fileType: 'generic',
+    systemPrompt: BASE_SYSTEM_PROMPT,
+    userPrompt: `Analyze this source file and generate a summary.
+
+File: {{FILE_PATH}}
+
+\`\`\`{{LANG}}
+{{CONTENT}}
+\`\`\`
+
+Include in your summary:
+1. **Purpose**: What this file does
+2. **Exports**: Public interface (functions, classes, constants)
+3. **Dependencies**: Imported modules and their usage
+4. **Patterns**: Notable implementation patterns
+5. **Related**: Tightly coupled files`,
+    focusAreas: ['exports', 'dependencies', 'patterns'],
+};
+/**
+ * Map of file types to their prompt templates.
+ */
+export const TEMPLATES = {
+    component: COMPONENT_TEMPLATE,
+    service: SERVICE_TEMPLATE,
+    util: UTIL_TEMPLATE,
+    type: TYPE_TEMPLATE,
+    test: TEST_TEMPLATE,
+    config: CONFIG_TEMPLATE,
+    api: API_TEMPLATE,
+    model: MODEL_TEMPLATE,
+    hook: HOOK_TEMPLATE,
+    schema: SCHEMA_TEMPLATE,
+    generic: GENERIC_TEMPLATE,
+};
+/**
+ * Get the prompt template for a file type.
+ */
+export function getTemplate(fileType) {
+    return TEMPLATES[fileType];
+}
+//# sourceMappingURL=templates.js.map

package/dist/generation/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/generation/prompts/templates.ts"],"names":[],"mappings":"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"}

package/dist/generation/prompts/types.d.ts

@@ -0,0 +1,71 @@
+import type { FileType } from '../types.js';
+/**
+ * Template for generating file summaries.
+ * Each file type has a dedicated template with specific instructions.
+ */
+export interface PromptTemplate {
+    /** File type this template applies to */
+    fileType: FileType;
+    /** System instructions for the LLM */
+    systemPrompt: string;
+    /** User prompt template with placeholders */
+    userPrompt: string;
+    /** Sections to emphasize in analysis */
+    focusAreas: string[];
+}
+/**
+ * Context provided when building a prompt.
+ */
+export interface PromptContext {
+    /** Absolute path to the file */
+    filePath: string;
+    /** File content to analyze */
+    content: string;
+    /** Detected file type */
+    fileType: FileType;
+    /** Related files for additional context */
+    contextFiles?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+/**
+ * Guidelines for summary generation (from CONTEXT.md).
+ */
+export declare const SUMMARY_GUIDELINES: {
+    /** Target word count range */
+    readonly targetLength: {
+        readonly min: 300;
+        readonly max: 500;
+    };
+    /** What to include */
+    readonly include: readonly ["Purpose and responsibility", "Public interface (exports, key functions)", "Key patterns and notable algorithms", "Dependencies with usage context", "Key function signatures as code snippets", "Tightly coupled sibling files"];
+    /** What to exclude */
+    readonly exclude: readonly ["Internal implementation details", "Generic TODOs/FIXMEs (keep only security/breaking)", "Broad architectural relationships (handled by AGENTS.md)"];
+};
+/**
+ * Context for chunk summarization (large files).
+ */
+export interface ChunkContext extends PromptContext {
+    /** Chunk index (0-based) */
+    chunkIndex: number;
+    /** Total number of chunks */
+    totalChunks: number;
+    /** Line range in original file */
+    lineRange: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Context for synthesizing chunk summaries.
+ */
+export interface SynthesisContext {
+    /** Original file path */
+    filePath: string;
+    /** Detected file type */
+    fileType: FileType;
+    /** Summaries from each chunk */
+    chunkSummaries: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generation/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generation/prompts/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,8BAA8B;;;;;IAE9B,sBAAsB;;IAStB,sBAAsB;;CAMd,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,gCAAgC;IAChC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/generation/prompts/types.js

@@ -0,0 +1,23 @@
+/**
+ * Guidelines for summary generation (from CONTEXT.md).
+ */
+export const SUMMARY_GUIDELINES = {
+    /** Target word count range */
+    targetLength: { min: 300, max: 500 },
+    /** What to include */
+    include: [
+        'Purpose and responsibility',
+        'Public interface (exports, key functions)',
+        'Key patterns and notable algorithms',
+        'Dependencies with usage context',
+        'Key function signatures as code snippets',
+        'Tightly coupled sibling files',
+    ],
+    /** What to exclude */
+    exclude: [
+        'Internal implementation details',
+        'Generic TODOs/FIXMEs (keep only security/breaking)',
+        'Broad architectural relationships (handled by AGENTS.md)',
+    ],
+};
+//# sourceMappingURL=types.js.map

package/dist/generation/prompts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/generation/prompts/types.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,8BAA8B;IAC9B,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACpC,sBAAsB;IACtB,OAAO,EAAE;QACP,4BAA4B;QAC5B,2CAA2C;QAC3C,qCAAqC;QACrC,iCAAiC;QACjC,0CAA0C;QAC1C,+BAA+B;KAChC;IACD,sBAAsB;IACtB,OAAO,EAAE;QACP,iCAAiC;QACjC,oDAAoD;QACpD,0DAA0D;KAC3D;CACO,CAAC"}

package/dist/generation/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Types for the documentation generation pipeline
+ */
+/**
+ * FileType enum - 11 categories for template selection
+ * Used to select appropriate prompts for different file types
+ */
+export type FileType = 'component' | 'service' | 'util' | 'type' | 'test' | 'config' | 'api' | 'model' | 'hook' | 'schema' | 'generic';
+/**
+ * Request to analyze a file
+ */
+export interface AnalysisRequest {
+    /** Path to the file being analyzed */
+    filePath: string;
+    /** Content of the file */
+    content: string;
+    /** Detected file type for prompt selection */
+    fileType: FileType;
+    /** Token count for the file content */
+    tokens: number;
+    /** Related files for context */
+    contextFiles?: string[];
+}
+/**
+ * Result of file analysis (populated by LLM via host)
+ */
+export interface AnalysisResult {
+    /** Generated summary text */
+    summary: string;
+    /** Extracted metadata */
+    metadata: SummaryMetadata;
+}
+/**
+ * Metadata extracted during analysis
+ */
+export interface SummaryMetadata {
+    /** Primary purpose of the file */
+    purpose: string;
+    /** Public exports/interface */
+    publicInterface: string[];
+    /** External dependencies */
+    dependencies: string[];
+    /** Design patterns used */
+    patterns: string[];
+    /** Only security/breaking issues */
+    criticalTodos?: string[];
+    /** Tightly coupled siblings */
+    relatedFiles?: string[];
+}
+/**
+ * Options for summary generation
+ */
+export interface SummaryOptions {
+    /** Target length for generated summaries */
+    targetLength: 'short' | 'standard' | 'detailed';
+    /** Whether to include code snippets in output */
+    includeCodeSnippets: boolean;
+}
+/**
+ * Configuration for the generation process
+ */
+export interface GenerationConfig {
+    /** Maximum token budget for generation */
+    tokenBudget: number;
+    /** Directory for supplementary docs */
+    outputDir?: string;
+    /** Whether to generate architecture doc */
+    generateArchitecture: boolean;
+    /** Whether to generate stack doc */
+    generateStack: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generation/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,KAAK,GACL,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,YAAY,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAChD,iDAAiD;IACjD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,aAAa,EAAE,OAAO,CAAC;CACxB"}

package/dist/generation/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the documentation generation pipeline
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generation/types.js.map

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

package/dist/generation/writers/agents-md.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Reference to a file in a directory.
+ */
+export interface FileRef {
+    /** File name */
+    name: string;
+    /** Brief description from .sum file */
+    description: string;
+    /** Whether this is a critical/frequently modified file */
+    critical?: boolean;
+}
+/**
+ * Group of files by purpose.
+ */
+export interface FileGroup {
+    /** Purpose/category of this group */
+    purpose: string;
+    /** Files in this group */
+    files: FileRef[];
+}
+/**
+ * Summary of a subdirectory.
+ */
+export interface SubdirSummary {
+    /** Directory name */
+    name: string;
+    /** Brief summary (from child AGENTS.md or inferred) */
+    summary: string;
+}
+/**
+ * Complete directory documentation structure.
+ */
+export interface DirectoryDoc {
+    /** Directory path (relative to project root) */
+    path: string;
+    /** Directory description */
+    description: string;
+    /** Files grouped by purpose */
+    files: FileGroup[];
+    /** Subdirectories with summaries */
+    subdirectories: SubdirSummary[];
+    /** Related directories (from imports, config) */
+    relatedDirectories: string[];
+    /** Patterns/conventions in this directory */
+    patterns: string[];
+}
+/**
+ * Build AGENTS.md content from directory documentation.
+ */
+export declare function buildAgentsMd(doc: DirectoryDoc): string;
+/**
+ * Build directory documentation from .sum files.
+ */
+export declare function buildDirectoryDoc(dirPath: string, projectRoot: string): Promise<DirectoryDoc>;
+/**
+ * Write AGENTS.md for a directory.
+ *
+ * @param dirPath - Directory to write AGENTS.md for
+ * @param projectRoot - Project root for relative paths
+ * @returns Path to written AGENTS.md
+ */
+export declare function writeAgentsMd(dirPath: string, projectRoot: string): Promise<string>;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/generation/writers/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../src/generation/writers/agents-md.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oCAAoC;IACpC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAqDvD;AA+GD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAyEvB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CASjB"}