@prodisco/search-libs 0.1.0

package/dist/library-indexer.js

@@ -0,0 +1,295 @@
+/**
+ * LibraryIndexer - High-level API for indexing and searching TypeScript libraries
+ */
+import { extractFromPackage } from './extractor/index.js';
+import { parseScript, parseScriptsFromDirectory } from './script/index.js';
+import { buildTypeDocument, buildMethodDocument, buildFunctionDocument, buildScriptDocument, } from './schema/schema-builder.js';
+import { SearchEngine } from './search/search-engine.js';
+/**
+ * Build a compact type definition string for an extracted type.
+ * Recursively expands nested type references up to maxDepth levels.
+ */
+function buildCompactTypeDefinition(type, typeRegistry, depth = 0, maxDepth = 2) {
+    const props = type.properties
+        .slice(0, 10)
+        .map(p => {
+        let propType = p.type;
+        // Recursively expand nested types if we haven't hit max depth
+        if (depth < maxDepth && !isPrimitiveOrBuiltin(p.type)) {
+            const baseTypeName = extractBaseTypeName(p.type);
+            const nestedType = typeRegistry.get(baseTypeName);
+            if (nestedType) {
+                const nestedDef = buildCompactTypeDefinition(nestedType, typeRegistry, depth + 1, maxDepth);
+                // Preserve array notation
+                if (p.type.endsWith('[]')) {
+                    propType = `${nestedDef}[]`;
+                }
+                else if (p.type.startsWith('Array<')) {
+                    propType = `${nestedDef}[]`;
+                }
+                else {
+                    propType = nestedDef;
+                }
+            }
+        }
+        return `${p.name}${p.optional ? '?' : ''}: ${propType}`;
+    })
+        .join(', ');
+    const more = type.properties.length > 10 ? `, ... +${type.properties.length - 10} more` : '';
+    return `{ ${props}${more} }`;
+}
+/**
+ * Expand parameter types using a type registry
+ */
+function expandMethodTypes(method, typeRegistry) {
+    // Expand parameter types
+    const expandedParams = method.parameters.map(param => {
+        // Skip primitives and built-in types
+        if (isPrimitiveOrBuiltin(param.type)) {
+            return param;
+        }
+        // Extract the base type name (handle Promise<X>, Array<X>, etc.)
+        const baseTypeName = extractBaseTypeName(param.type);
+        const typeInfo = typeRegistry.get(baseTypeName);
+        if (typeInfo) {
+            return {
+                ...param,
+                typeDefinition: buildCompactTypeDefinition(typeInfo, typeRegistry),
+            };
+        }
+        return param;
+    });
+    // Expand return type
+    let returnTypeDefinition;
+    const returnBaseType = extractBaseTypeName(method.returnType);
+    const returnTypeInfo = typeRegistry.get(returnBaseType);
+    if (returnTypeInfo && !isPrimitiveOrBuiltin(method.returnType)) {
+        returnTypeDefinition = buildCompactTypeDefinition(returnTypeInfo, typeRegistry);
+    }
+    return {
+        ...method,
+        parameters: expandedParams,
+        returnTypeDefinition,
+    };
+}
+/**
+ * Check if a type is a primitive or built-in type
+ */
+function isPrimitiveOrBuiltin(typeName) {
+    const primitives = new Set([
+        'string', 'number', 'boolean', 'void', 'null', 'undefined',
+        'any', 'unknown', 'never', 'object', 'Date', 'RegExp',
+        'Promise', 'Array', 'Map', 'Set', 'Record',
+    ]);
+    const baseType = extractBaseTypeName(typeName);
+    return primitives.has(baseType);
+}
+/**
+ * Extract the base type name from a complex type
+ * e.g., "Promise<TimeRange>" -> "TimeRange"
+ *       "Array<Sample>" -> "Sample"
+ *       "TimeRange" -> "TimeRange"
+ */
+function extractBaseTypeName(typeName) {
+    // Handle Promise<X>, Array<X>, etc.
+    const genericMatch = typeName.match(/^(?:Promise|Array|Set|Map)<(.+)>$/);
+    if (genericMatch) {
+        return extractBaseTypeName(genericMatch[1]);
+    }
+    // Handle arrays like X[]
+    if (typeName.endsWith('[]')) {
+        return extractBaseTypeName(typeName.slice(0, -2));
+    }
+    // Handle union types - take the first non-null type
+    if (typeName.includes('|')) {
+        const parts = typeName.split('|').map(p => p.trim());
+        for (const part of parts) {
+            if (part !== 'null' && part !== 'undefined') {
+                return extractBaseTypeName(part);
+            }
+        }
+    }
+    return typeName.trim();
+}
+/**
+ * High-level API for indexing and searching TypeScript libraries
+ */
+export class LibraryIndexer {
+    options;
+    engine;
+    initialized = false;
+    indexedScripts = new Set();
+    constructor(options) {
+        this.options = options;
+        this.engine = new SearchEngine();
+    }
+    /**
+     * Initialize the indexer - extracts and indexes all configured packages
+     */
+    async initialize() {
+        if (this.initialized) {
+            return { indexed: 0, errors: [], packageCounts: {} };
+        }
+        await this.engine.initialize();
+        const errors = [];
+        const packageCounts = {};
+        let totalIndexed = 0;
+        for (const packageConfig of this.options.packages) {
+            const result = await this.indexPackage(packageConfig);
+            errors.push(...result.errors);
+            packageCounts[packageConfig.name] = result.indexed;
+            totalIndexed += result.indexed;
+        }
+        this.initialized = true;
+        return {
+            indexed: totalIndexed,
+            errors,
+            packageCounts,
+        };
+    }
+    /**
+     * Index a single package
+     */
+    async indexPackage(config) {
+        const result = extractFromPackage({
+            packageName: config.name,
+            typeFilter: config.typeFilter,
+            methodFilter: config.methodFilter,
+            classFilter: config.classFilter,
+            basePath: this.options.basePath,
+        });
+        const documents = [];
+        // Build a type registry for expanding method parameter/return types
+        const typeRegistry = new Map();
+        for (const type of result.types) {
+            typeRegistry.set(type.name, type);
+        }
+        // Build documents from extracted types
+        for (const type of result.types) {
+            documents.push(buildTypeDocument(type));
+        }
+        // Build documents from extracted methods with expanded types
+        for (const method of result.methods) {
+            const expandedMethod = expandMethodTypes(method, typeRegistry);
+            documents.push(buildMethodDocument(expandedMethod));
+        }
+        // Build documents from extracted functions
+        for (const func of result.functions) {
+            documents.push(buildFunctionDocument(func));
+        }
+        // Insert all documents
+        if (documents.length > 0) {
+            await this.engine.insertBatch(documents);
+        }
+        return {
+            indexed: documents.length,
+            errors: result.errors,
+        };
+    }
+    /**
+     * Add a script to the index
+     */
+    async addScript(filePath) {
+        await this.ensureInitialized();
+        // Skip if already indexed
+        if (this.indexedScripts.has(filePath)) {
+            return false;
+        }
+        const script = parseScript(filePath);
+        if (!script) {
+            return false;
+        }
+        const doc = buildScriptDocument(script);
+        await this.engine.insert(doc);
+        this.indexedScripts.add(filePath);
+        return true;
+    }
+    /**
+     * Add all scripts from a directory
+     */
+    async addScriptsFromDirectory(dirPath, options) {
+        await this.ensureInitialized();
+        const scripts = parseScriptsFromDirectory(dirPath, {
+            recursive: options?.recursive,
+        });
+        let added = 0;
+        for (const script of scripts) {
+            if (!this.indexedScripts.has(script.filePath)) {
+                const doc = buildScriptDocument(script);
+                await this.engine.insert(doc);
+                this.indexedScripts.add(script.filePath);
+                added++;
+            }
+        }
+        return added;
+    }
+    /**
+     * Remove a script from the index
+     */
+    async removeScript(filePath) {
+        if (!this.indexedScripts.has(filePath)) {
+            return false;
+        }
+        // Find the script filename to build the ID
+        const filename = filePath.split('/').pop() || filePath.split('\\').pop() || filePath;
+        const id = `script:${filename}`;
+        try {
+            await this.engine.remove(id);
+            this.indexedScripts.delete(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Add custom documents to the index
+     */
+    async addDocuments(docs) {
+        await this.ensureInitialized();
+        await this.engine.insertBatch(docs);
+    }
+    /**
+     * Search the index
+     */
+    async search(options) {
+        await this.ensureInitialized();
+        return this.engine.search(options);
+    }
+    /**
+     * Get the underlying search engine
+     */
+    getEngine() {
+        return this.engine;
+    }
+    /**
+     * Check if initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Shutdown the indexer
+     */
+    async shutdown() {
+        await this.engine.shutdown();
+        this.initialized = false;
+        this.indexedScripts.clear();
+    }
+    /**
+     * Add a new package to an already-initialized indexer
+     */
+    async addPackage(config) {
+        await this.ensureInitialized();
+        return this.indexPackage(config);
+    }
+    /**
+     * Ensure the indexer is initialized
+     */
+    async ensureInitialized() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+    }
+}
+//# sourceMappingURL=library-indexer.js.map

package/dist/library-indexer.js.map

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

package/dist/schema/base-schema.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Base Orama schema for indexing TypeScript libraries and scripts
+ */
+/**
+ * Orama schema type definition
+ */
+export type OramaSchemaType = Record<string, 'string' | 'number' | 'boolean' | 'enum' | 'string[]' | 'number[]' | 'boolean[]'>;
+/**
+ * Base schema fields that all indexed documents share.
+ * Consumers can extend this with domain-specific fields.
+ *
+ * Design decisions based on Orama best practices:
+ * - `string` types for full-text searchable fields
+ * - `enum` types for exact-match filterable fields
+ */
+export declare const baseSchema: {
+    readonly id: "string";
+    readonly documentType: "enum";
+    readonly name: "string";
+    readonly description: "string";
+    readonly searchTokens: "string";
+    readonly library: "enum";
+    readonly category: "enum";
+    readonly properties: "string";
+    readonly typeDefinition: "string";
+    readonly nestedTypes: "string";
+    readonly typeKind: "enum";
+    readonly parameters: "string";
+    readonly returnType: "string";
+    readonly returnTypeDefinition: "string";
+    readonly signature: "string";
+    readonly className: "string";
+    readonly filePath: "string";
+    readonly keywords: "string";
+};
+/**
+ * Type for documents indexed with the base schema
+ */
+export type BaseDocument = {
+    id: string;
+    documentType: 'type' | 'method' | 'function' | 'script' | 'metric';
+    name: string;
+    description: string;
+    searchTokens: string;
+    library: string;
+    category: string;
+    properties: string;
+    typeDefinition: string;
+    nestedTypes: string;
+    typeKind: string;
+    parameters: string;
+    returnType: string;
+    returnTypeDefinition: string;
+    signature: string;
+    className: string;
+    filePath: string;
+    keywords: string;
+};
+/**
+ * Create an empty base document with default values
+ */
+export declare function createEmptyDocument(): BaseDocument;
+//# sourceMappingURL=base-schema.d.ts.map

package/dist/schema/base-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-schema.d.ts","sourceRoot":"","sources":["../../src/schema/base-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAE/H;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CA8Ba,CAAC;AAErC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IAGjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IAGjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAqBlD"}

package/dist/schema/base-schema.js

@@ -0,0 +1,63 @@
+/**
+ * Base Orama schema for indexing TypeScript libraries and scripts
+ */
+/**
+ * Base schema fields that all indexed documents share.
+ * Consumers can extend this with domain-specific fields.
+ *
+ * Design decisions based on Orama best practices:
+ * - `string` types for full-text searchable fields
+ * - `enum` types for exact-match filterable fields
+ */
+export const baseSchema = {
+    // === Identity ===
+    id: 'string',
+    documentType: 'enum', // 'type' | 'method' | 'function' | 'script'
+    name: 'string',
+    // === Search Content ===
+    description: 'string',
+    searchTokens: 'string', // CamelCase split tokens for better matching
+    // === Organization ===
+    library: 'enum', // Package name
+    category: 'enum', // Kind or action category
+    // === Type-specific fields ===
+    properties: 'string', // JSON array of PropertyInfo
+    typeDefinition: 'string', // Formatted type definition
+    nestedTypes: 'string', // Comma-separated referenced type names
+    typeKind: 'enum', // 'class' | 'interface' | 'enum' | 'type-alias'
+    // === Method/function-specific fields ===
+    parameters: 'string', // JSON array of ParameterInfo (includes typeDefinition for complex types)
+    returnType: 'string',
+    returnTypeDefinition: 'string', // Expanded return type definition for complex types
+    signature: 'string',
+    className: 'string', // For methods, the owning class
+    // === Script-specific fields ===
+    filePath: 'string',
+    keywords: 'string',
+};
+/**
+ * Create an empty base document with default values
+ */
+export function createEmptyDocument() {
+    return {
+        id: '',
+        documentType: 'type',
+        name: '',
+        description: '',
+        searchTokens: '',
+        library: '',
+        category: '',
+        properties: '',
+        typeDefinition: '',
+        nestedTypes: '',
+        typeKind: '',
+        parameters: '',
+        returnType: '',
+        returnTypeDefinition: '',
+        signature: '',
+        className: '',
+        filePath: '',
+        keywords: '',
+    };
+}
+//# sourceMappingURL=base-schema.js.map

package/dist/schema/base-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-schema.js","sourceRoot":"","sources":["../../src/schema/base-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mBAAmB;IACnB,EAAE,EAAE,QAAQ;IACZ,YAAY,EAAE,MAAM,EAAE,4CAA4C;IAClE,IAAI,EAAE,QAAQ;IAEd,yBAAyB;IACzB,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,QAAQ,EAAE,6CAA6C;IAErE,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,eAAe;IAChC,QAAQ,EAAE,MAAM,EAAE,0BAA0B;IAE5C,+BAA+B;IAC/B,UAAU,EAAE,QAAQ,EAAE,6BAA6B;IACnD,cAAc,EAAE,QAAQ,EAAE,4BAA4B;IACtD,WAAW,EAAE,QAAQ,EAAE,wCAAwC;IAC/D,QAAQ,EAAE,MAAM,EAAE,gDAAgD;IAElE,0CAA0C;IAC1C,UAAU,EAAE,QAAQ,EAAE,0EAA0E;IAChG,UAAU,EAAE,QAAQ;IACpB,oBAAoB,EAAE,QAAQ,EAAE,oDAAoD;IACpF,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,QAAQ,EAAE,gCAAgC;IAErD,iCAAiC;IACjC,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,QAAQ;CACgB,CAAC;AAgCrC;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,EAAE,EAAE,EAAE;QACN,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,EAAE;QACxB,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Schema module - Orama schema definitions and builders
+ */
+export { baseSchema, type BaseDocument, createEmptyDocument } from './base-schema.js';
+export { buildSchema, buildDocument, buildTypeDocument, buildMethodDocument, buildFunctionDocument, buildScriptDocument, type SchemaBuilderOptions, type ExtensionSchema, } from './schema-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EACL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,6 @@
+/**
+ * Schema module - Orama schema definitions and builders
+ */
+export { baseSchema, createEmptyDocument } from './base-schema.js';
+export { buildSchema, buildDocument, buildTypeDocument, buildMethodDocument, buildFunctionDocument, buildScriptDocument, } from './schema-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAqB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EACL,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC"}

package/dist/schema/schema-builder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Extensible schema builder for custom fields
+ */
+import { baseSchema, type BaseDocument } from './base-schema.js';
+import type { ExtractedType, ExtractedMethod, ExtractedFunction } from '../extractor/types.js';
+import type { CachedScript } from '../script/types.js';
+/**
+ * Extension schema type - additional fields to add to base schema
+ */
+export type ExtensionSchema = Record<string, 'string' | 'enum' | 'number' | 'boolean'>;
+/**
+ * Options for building an extended schema
+ */
+export interface SchemaBuilderOptions<T extends ExtensionSchema> {
+    /** Additional fields to add to the base schema */
+    extensions?: T;
+    /** Tokenizer options */
+    tokenizerOptions?: {
+        stemming?: boolean;
+        stemmerSkipProperties?: string[];
+    };
+}
+/**
+ * Build a schema with optional extensions
+ */
+export declare function buildSchema<T extends ExtensionSchema = Record<string, never>>(options?: SchemaBuilderOptions<T>): typeof baseSchema & T;
+/**
+ * Build a document from an extracted type
+ */
+export declare function buildTypeDocument(type: ExtractedType): BaseDocument;
+/**
+ * Build a document from an extracted method
+ */
+export declare function buildMethodDocument(method: ExtractedMethod): BaseDocument;
+/**
+ * Build a document from an extracted function
+ */
+export declare function buildFunctionDocument(func: ExtractedFunction): BaseDocument;
+/**
+ * Build a document from a cached script
+ */
+export declare function buildScriptDocument(script: CachedScript): BaseDocument;
+/**
+ * Build a document from any extracted item
+ */
+export declare function buildDocument(item: ExtractedType | ExtractedMethod | ExtractedFunction | CachedScript): BaseDocument;
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/schema/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../src/schema/schema-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAuB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,eAAe;IAC7D,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC;IAEf,wBAAwB;IACxB,gBAAgB,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC3E,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAChC,OAAO,UAAU,GAAG,CAAC,CASvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA0BnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CA4BzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAwB3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAmCtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,GACvE,YAAY,CAWd"}