@prompd/cli 0.3.3

package/dist/lib/compiler/language-map.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Language Mapping Utilities
+ *
+ * Centralized file extension to programming language mappings
+ * used across the compilation pipeline for:
+ * - Wrapping extracted code files in markdown code blocks
+ * - Filtering code blocks based on context file types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXTENSION_TO_LANGUAGE_ALIASES = exports.EXTENSION_TO_LANGUAGE = void 0;
+exports.getLanguageForExtension = getLanguageForExtension;
+exports.getLanguageAliasesForExtension = getLanguageAliasesForExtension;
+/**
+ * Map of file extensions to primary markdown code block language identifier.
+ * Used when wrapping extracted code files in markdown code blocks.
+ */
+exports.EXTENSION_TO_LANGUAGE = {
+    // TypeScript/JavaScript
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    // Python
+    '.py': 'python',
+    '.pyw': 'python',
+    // Go
+    '.go': 'go',
+    // Rust
+    '.rs': 'rust',
+    // Java/Kotlin
+    '.java': 'java',
+    '.kt': 'kotlin',
+    '.kts': 'kotlin',
+    // C/C++
+    '.c': 'c',
+    '.h': 'c',
+    '.cpp': 'cpp',
+    '.hpp': 'cpp',
+    '.cc': 'cpp',
+    // C#
+    '.cs': 'csharp',
+    // Ruby
+    '.rb': 'ruby',
+    // PHP
+    '.php': 'php',
+    // Swift
+    '.swift': 'swift',
+    // Shell
+    '.sh': 'bash',
+    '.bash': 'bash',
+    '.zsh': 'zsh',
+    '.fish': 'fish',
+    // SQL
+    '.sql': 'sql',
+    // Web
+    '.html': 'html',
+    '.htm': 'html',
+    '.css': 'css',
+    '.scss': 'scss',
+    '.sass': 'sass',
+    '.less': 'less',
+    // Data formats
+    '.xml': 'xml',
+    '.svg': 'xml',
+    '.json': 'json',
+    '.yaml': 'yaml',
+    '.yml': 'yaml',
+    '.toml': 'toml',
+    '.csv': 'csv',
+    // Markdown
+    '.md': 'markdown',
+    '.mdx': 'markdown',
+};
+/**
+ * Map of file extensions to all valid code block language identifiers.
+ * Used when filtering code blocks - includes aliases (e.g., 'ts' for 'typescript').
+ */
+exports.EXTENSION_TO_LANGUAGE_ALIASES = {
+    // TypeScript/JavaScript
+    '.ts': ['typescript', 'ts'],
+    '.tsx': ['typescript', 'tsx', 'ts'],
+    '.js': ['javascript', 'js'],
+    '.jsx': ['javascript', 'jsx', 'js'],
+    '.mjs': ['javascript', 'js'],
+    '.cjs': ['javascript', 'js'],
+    // Python
+    '.py': ['python', 'py'],
+    '.pyw': ['python', 'py'],
+    // Go
+    '.go': ['go', 'golang'],
+    // Rust
+    '.rs': ['rust', 'rs'],
+    // Java/Kotlin
+    '.java': ['java'],
+    '.kt': ['kotlin', 'kt'],
+    '.kts': ['kotlin', 'kt'],
+    // C/C++
+    '.c': ['c'],
+    '.h': ['c', 'h'],
+    '.cpp': ['cpp', 'c++', 'cxx'],
+    '.hpp': ['cpp', 'c++', 'hpp'],
+    '.cc': ['cpp', 'c++'],
+    // C#
+    '.cs': ['csharp', 'cs', 'c#'],
+    // Ruby
+    '.rb': ['ruby', 'rb'],
+    // PHP
+    '.php': ['php'],
+    // Swift
+    '.swift': ['swift'],
+    // Shell
+    '.sh': ['bash', 'sh', 'shell'],
+    '.bash': ['bash', 'sh', 'shell'],
+    '.zsh': ['zsh', 'sh', 'shell'],
+    '.fish': ['fish'],
+    // SQL
+    '.sql': ['sql'],
+    // Web
+    '.html': ['html', 'htm'],
+    '.htm': ['html', 'htm'],
+    '.css': ['css'],
+    '.scss': ['scss', 'sass'],
+    '.sass': ['sass', 'scss'],
+    '.less': ['less'],
+    // Data formats
+    '.json': ['json'],
+    '.yaml': ['yaml', 'yml'],
+    '.yml': ['yaml', 'yml'],
+    '.xml': ['xml'],
+    '.svg': ['xml', 'svg'],
+    '.toml': ['toml'],
+    '.csv': ['csv'],
+    // Markdown
+    '.md': ['markdown', 'md'],
+    '.mdx': ['mdx', 'markdown', 'md'],
+};
+/**
+ * Get the primary language identifier for a file extension.
+ * @param ext - File extension (e.g., '.ts')
+ * @returns Primary language identifier or undefined
+ */
+function getLanguageForExtension(ext) {
+    return exports.EXTENSION_TO_LANGUAGE[ext.toLowerCase()];
+}
+/**
+ * Get all valid language identifiers (including aliases) for a file extension.
+ * @param ext - File extension (e.g., '.ts')
+ * @returns Array of language identifiers or empty array
+ */
+function getLanguageAliasesForExtension(ext) {
+    return exports.EXTENSION_TO_LANGUAGE_ALIASES[ext.toLowerCase()] || [];
+}
+//# sourceMappingURL=language-map.js.map

package/dist/lib/compiler/language-map.js.map

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

package/dist/lib/compiler/package-resolver.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Package Resolution Utilities
+ *
+ * Handles resolution of package references to local file paths,
+ * including registry discovery via /.well-known/registry.json
+ */
+import { IFileSystem } from './file-system';
+/**
+ * Options for package resolution.
+ */
+export interface ResolvePackageOptions {
+    /** File system to use (for in-memory package resolution) */
+    fileSystem?: IFileSystem;
+    /** Registry URL for downloading packages */
+    registryUrl?: string;
+    /** Workspace root directory for local package cache */
+    workspaceRoot?: string;
+}
+/**
+ * Resolve a package reference to a local file path or in-memory path.
+ *
+ * @param packageRef - Package reference in format: @namespace/package@version
+ * @param fileSystemOrOptions - Optional file system or options object
+ * @param registryUrl - Optional registry URL (deprecated, use options object)
+ * @returns Resolved local path to the package directory (or virtual path for MemoryFileSystem)
+ */
+export declare function resolvePackage(packageRef: string, fileSystemOrOptions?: IFileSystem | ResolvePackageOptions, registryUrl?: string): Promise<string>;
+/**
+ * Parse package reference into name and version.
+ */
+export declare function parsePackageReference(packageRef: string): {
+    name: string;
+    version: string;
+    scope?: string;
+};
+/**
+ * Validate package reference format.
+ */
+export declare function isValidPackageReference(packageRef: string): boolean;
+/**
+ * Get the global package cache directory (~/.prompd/cache/).
+ */
+export declare function getGlobalCacheDir(): string;
+/**
+ * Get the local project package cache directory (./.prompd/cache/).
+ * @param workspaceRoot - Optional workspace root directory. If not provided, uses process.cwd()
+ */
+export declare function getLocalCacheDir(workspaceRoot?: string): string;
+/**
+ * Get the package cache directory (for backward compatibility).
+ * @deprecated Use getGlobalCacheDir() or getLocalCacheDir() instead
+ */
+export declare function getPackageCacheDir(): string;
+/**
+ * Resolve a file path within a package.
+ *
+ * @param packagePath - Base path to package directory
+ * @param filePath - Relative file path within package
+ * @returns Resolved absolute path
+ */
+export declare function resolvePackageFile(packagePath: string, filePath: string): string;
+/**
+ * Check if a package is installed (in local or global cache).
+ * @param packageRef - Package reference to check
+ * @param workspaceRoot - Optional workspace root directory for local cache
+ */
+export declare function isPackageInstalled(packageRef: string, workspaceRoot?: string): Promise<boolean>;
+//# sourceMappingURL=package-resolver.d.ts.map

package/dist/lib/compiler/package-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.d.ts","sourceRoot":"","sources":["../../../src/lib/compiler/package-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,WAAW,EAAoB,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,mBAAmB,CAAC,EAAE,WAAW,GAAG,qBAAqB,EACzD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAwGjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgB3G;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAoBnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAehF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrG"}

package/dist/lib/compiler/package-resolver.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Package Resolution Utilities
+ *
+ * Handles resolution of package references to local file paths,
+ * including registry discovery via /.well-known/registry.json
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePackage = resolvePackage;
+exports.parsePackageReference = parsePackageReference;
+exports.isValidPackageReference = isValidPackageReference;
+exports.getGlobalCacheDir = getGlobalCacheDir;
+exports.getLocalCacheDir = getLocalCacheDir;
+exports.getPackageCacheDir = getPackageCacheDir;
+exports.resolvePackageFile = resolvePackageFile;
+exports.isPackageInstalled = isPackageInstalled;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const os = __importStar(require("os"));
+const registry_1 = require("../registry");
+const errors_1 = require("../errors");
+const file_system_1 = require("./file-system");
+/**
+ * Resolve a package reference to a local file path or in-memory path.
+ *
+ * @param packageRef - Package reference in format: @namespace/package@version
+ * @param fileSystemOrOptions - Optional file system or options object
+ * @param registryUrl - Optional registry URL (deprecated, use options object)
+ * @returns Resolved local path to the package directory (or virtual path for MemoryFileSystem)
+ */
+async function resolvePackage(packageRef, fileSystemOrOptions, registryUrl) {
+    // Handle both legacy (fileSystem, registryUrl) and new (options) signatures
+    let fileSystem;
+    let resolvedRegistryUrl;
+    let workspaceRoot;
+    if (fileSystemOrOptions && 'exists' in fileSystemOrOptions) {
+        // Legacy: fileSystem passed directly
+        fileSystem = fileSystemOrOptions;
+        resolvedRegistryUrl = registryUrl;
+    }
+    else if (fileSystemOrOptions) {
+        // New: options object
+        const opts = fileSystemOrOptions;
+        fileSystem = opts.fileSystem;
+        resolvedRegistryUrl = opts.registryUrl;
+        workspaceRoot = opts.workspaceRoot;
+    }
+    // Security: Validate package reference format
+    if (!isValidPackageReference(packageRef)) {
+        throw new errors_1.SecurityError(`Invalid package reference format: ${packageRef}`);
+    }
+    // Parse package reference
+    const { name, version } = parsePackageReference(packageRef);
+    // Handle in-memory file system
+    if (fileSystem instanceof file_system_1.MemoryFileSystem) {
+        const packagePath = fileSystem.getPackagePath(name, version);
+        // Check if package already loaded in memory
+        if (fileSystem.exists(packagePath)) {
+            return packagePath;
+        }
+        // Package not in memory - download and add it
+        try {
+            // Create registry client with optional URL override
+            const registry = new registry_1.RegistryClient(resolvedRegistryUrl ? { registryUrl: resolvedRegistryUrl } : undefined);
+            // Create download function for MemoryFileSystem
+            const downloadFn = async (pkgName, pkgVersion) => {
+                return await registry.downloadPackageBuffer(pkgName, pkgVersion);
+            };
+            await fileSystem.addPackageFromRegistry(packageRef, downloadFn);
+            return packagePath;
+        }
+        catch (error) {
+            throw new Error(`Failed to load package into memory ${packageRef}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Default: disk-based resolution
+    // Resolution order (matches Python CLI):
+    // 1. Check local project cache (./.prompd/cache/)
+    // 2. Check global cache (~/.prompd/cache/)
+    // 3. Download from registry
+    // Package path follows Python CLI structure: @namespace/package-name/version
+    // e.g., @prompd/public-examples -> cache/@prompd/public-examples/1.1.0/
+    // Also check legacy format: @namespace/package-name@version (frontend packageCache)
+    const localCacheDir = getLocalCacheDir(workspaceRoot);
+    const globalCacheDir = getGlobalCacheDir();
+    // Check local project cache first (both formats)
+    const localPackageDir = path.join(localCacheDir, name, version);
+    if (await fs.pathExists(localPackageDir)) {
+        return localPackageDir;
+    }
+    // Legacy format: name@version as single directory (frontend packageCache.ts format)
+    const localPackageDirLegacy = path.join(localCacheDir, `${name}@${version}`);
+    if (await fs.pathExists(localPackageDirLegacy)) {
+        return localPackageDirLegacy;
+    }
+    // Check global cache (both formats)
+    const globalPackageDir = path.join(globalCacheDir, name, version);
+    if (await fs.pathExists(globalPackageDir)) {
+        return globalPackageDir;
+    }
+    const globalPackageDirLegacy = path.join(globalCacheDir, `${name}@${version}`);
+    if (await fs.pathExists(globalPackageDirLegacy)) {
+        return globalPackageDirLegacy;
+    }
+    // Package not cached - try to install it
+    try {
+        // Create registry client with optional URL override
+        const registry = new registry_1.RegistryClient(resolvedRegistryUrl ? { registryUrl: resolvedRegistryUrl } : undefined);
+        await registry.install(packageRef, { skipCache: false });
+        // After installation, check both caches again
+        if (await fs.pathExists(localPackageDir)) {
+            return localPackageDir;
+        }
+        if (await fs.pathExists(globalPackageDir)) {
+            return globalPackageDir;
+        }
+        throw new Error(`Package installation succeeded but package not found in cache: ${packageRef}`);
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve package ${packageRef}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Parse package reference into name and version.
+ */
+function parsePackageReference(packageRef) {
+    // Format: @namespace/package@version or @namespace/package (latest)
+    const match = packageRef.match(/^(@[\w.-]+\/[\w.-]+)@?([\w.-]+)?$/);
+    if (!match) {
+        throw new Error(`Invalid package reference format: ${packageRef}`);
+    }
+    const name = match[1];
+    const version = match[2] || 'latest';
+    // Extract scope
+    const scopeMatch = name.match(/^(@[\w.-]+)\//);
+    const scope = scopeMatch ? scopeMatch[1] : undefined;
+    return { name, version, scope };
+}
+/**
+ * Validate package reference format.
+ */
+function isValidPackageReference(packageRef) {
+    // Security: Ensure package ref follows npm-style scoped package format
+    // Format: @namespace/package@version
+    const pattern = /^@[\w.-]+\/[\w.-]+(@[\w.-]+)?$/;
+    if (!pattern.test(packageRef)) {
+        return false;
+    }
+    // Security: Check for path traversal attempts
+    if (packageRef.includes('..') || packageRef.includes('//')) {
+        return false;
+    }
+    // Security: Check for null bytes
+    if (packageRef.includes('\0')) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get the global package cache directory (~/.prompd/cache/).
+ */
+function getGlobalCacheDir() {
+    return path.join(os.homedir(), '.prompd', 'cache');
+}
+/**
+ * Get the local project package cache directory (./.prompd/cache/).
+ * @param workspaceRoot - Optional workspace root directory. If not provided, uses process.cwd()
+ */
+function getLocalCacheDir(workspaceRoot) {
+    const basePath = workspaceRoot || process.cwd();
+    return path.join(basePath, '.prompd', 'cache');
+}
+/**
+ * Get the package cache directory (for backward compatibility).
+ * @deprecated Use getGlobalCacheDir() or getLocalCacheDir() instead
+ */
+function getPackageCacheDir() {
+    return getGlobalCacheDir();
+}
+/**
+ * Resolve a file path within a package.
+ *
+ * @param packagePath - Base path to package directory
+ * @param filePath - Relative file path within package
+ * @returns Resolved absolute path
+ */
+function resolvePackageFile(packagePath, filePath) {
+    // Security: Path traversal protection
+    const normalized = path.normalize(filePath);
+    if (normalized.startsWith('..') || path.isAbsolute(normalized)) {
+        throw new errors_1.SecurityError(`Invalid file path within package: ${filePath}`);
+    }
+    const resolvedPath = path.join(packagePath, normalized);
+    // Security: Ensure resolved path is within package directory
+    if (!resolvedPath.startsWith(packagePath)) {
+        throw new errors_1.SecurityError(`Path traversal detected: ${filePath}`);
+    }
+    return resolvedPath;
+}
+/**
+ * Check if a package is installed (in local or global cache).
+ * @param packageRef - Package reference to check
+ * @param workspaceRoot - Optional workspace root directory for local cache
+ */
+async function isPackageInstalled(packageRef, workspaceRoot) {
+    try {
+        const { name, version } = parsePackageReference(packageRef);
+        // Check local cache first
+        const localPackageDir = path.join(getLocalCacheDir(workspaceRoot), name, version);
+        if (await fs.pathExists(localPackageDir)) {
+            return true;
+        }
+        // Check global cache
+        const globalPackageDir = path.join(getGlobalCacheDir(), name, version);
+        return await fs.pathExists(globalPackageDir);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=package-resolver.js.map

package/dist/lib/compiler/package-resolver.js.map

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

package/dist/lib/compiler/pipeline.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Compilation pipeline orchestrator.
+ *
+ * Manages the execution of the 6-stage compilation pipeline, ensuring stages
+ * run in order and errors are properly propagated.
+ */
+import { CompilationContext, CompilationOptions, CompilerStage, SecurityConfig } from './types';
+/**
+ * The main compiler pipeline orchestrator.
+ */
+export declare class CompilerPipeline {
+    private stages;
+    private securityConfig;
+    constructor(stages?: CompilerStage[], securityConfig?: SecurityConfig);
+    /**
+     * Register a compilation stage.
+     */
+    registerStage(stage: CompilerStage): void;
+    /**
+     * Execute the compilation pipeline.
+     *
+     * @param source - Path to .prmd file or package reference
+     * @param options - Compilation options
+     * @returns Compilation context with result or errors
+     */
+    execute(source: string, options?: CompilationOptions): Promise<CompilationContext>;
+    /**
+     * Resolve source to file path (handles package references).
+     *
+     * @param source - Package reference or file path
+     * @param fileSystem - File system to use for resolution
+     * @param customFileSystem - Optional custom file system (used to detect in-memory mode)
+     * @param registryUrl - Optional registry URL for package resolution
+     * @param workspaceRoot - Optional workspace root for package cache location
+     */
+    private resolveSource;
+    /**
+     * Find all .prmd files in a directory.
+     *
+     * @param dir - Directory path
+     * @param fileSystem - File system to use
+     */
+    private findPromdFiles;
+    /**
+     * Validate source file for security.
+     */
+    private validateSourceFile;
+    /**
+     * Get registered stages.
+     */
+    getStages(): CompilerStage[];
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/lib/compiler/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/lib/compiler/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EAEb,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,MAAM,CAAC,EAAE,aAAa,EAAE,EAAE,cAAc,CAAC,EAAE,cAAc;IAKrE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIzC;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoC5F;;;;;;;;OAQG;YACW,aAAa;IAuC3B;;;;;OAKG;YACW,cAAc;IAyB5B;;OAEG;YACW,kBAAkB;IAoChC;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;CAG7B"}