@ketrics/ketrics-cli 0.5.0 → 0.6.1

package/dist/src/services/remote-template-service.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * Remote Template Service
+ *
+ * Fetches templates from the public ketrics-application-templates GitHub repository.
+ * Uses GitHub tarball download for efficient single-request fetching.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchManifest = fetchManifest;
+exports.downloadAndExtractTarball = downloadAndExtractTarball;
+exports.extractTemplate = extractTemplate;
+exports.readTemplateConfig = readTemplateConfig;
+exports.applyPlaceholders = applyPlaceholders;
+exports.manifestToTemplateInfos = manifestToTemplateInfos;
+exports.getTemplateFilesFromDir = getTemplateFilesFromDir;
+exports.cleanupTmpDir = cleanupTmpDir;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const zlib = __importStar(require("zlib"));
+const promises_1 = require("stream/promises");
+const axios_1 = __importDefault(require("axios"));
+const tar = __importStar(require("tar"));
+const TEMPLATE_REPO_OWNER = 'ketrics';
+const TEMPLATE_REPO_NAME = 'ketrics-application-templates';
+const TEMPLATE_BRANCH = 'main';
+const MANIFEST_URL = `https://raw.githubusercontent.com/${TEMPLATE_REPO_OWNER}/${TEMPLATE_REPO_NAME}/${TEMPLATE_BRANCH}/templates.json`;
+const TARBALL_URL = `https://api.github.com/repos/${TEMPLATE_REPO_OWNER}/${TEMPLATE_REPO_NAME}/tarball/${TEMPLATE_BRANCH}`;
+/**
+ * Fetch the templates.json manifest from the remote repository
+ */
+async function fetchManifest() {
+    const response = await axios_1.default.get(MANIFEST_URL, {
+        timeout: 15000,
+        headers: {
+            'Accept': 'application/json',
+            'User-Agent': 'ketrics-cli',
+        },
+    });
+    const manifest = response.data;
+    if (typeof manifest.version !== 'number' || !Array.isArray(manifest.templates)) {
+        throw new Error('Invalid manifest format');
+    }
+    return manifest;
+}
+/**
+ * Download and extract the repo tarball to a temporary directory.
+ * Returns the path to the extracted repo root.
+ */
+async function downloadAndExtractTarball() {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ketrics-templates-'));
+    const response = await axios_1.default.get(TARBALL_URL, {
+        responseType: 'stream',
+        timeout: 60000,
+        headers: {
+            'Accept': 'application/vnd.github+json',
+            'User-Agent': 'ketrics-cli',
+        },
+    });
+    await (0, promises_1.pipeline)(response.data, zlib.createGunzip(), tar.extract({ cwd: tmpDir }));
+    // GitHub tarball extracts into a directory like: ketrics-ketrics-application-templates-<sha>/
+    const entries = fs.readdirSync(tmpDir);
+    const repoDir = entries.find((e) => fs.statSync(path.join(tmpDir, e)).isDirectory());
+    if (!repoDir) {
+        throw new Error('Failed to find extracted repository directory');
+    }
+    return path.join(tmpDir, repoDir);
+}
+/**
+ * Extract a specific template from the downloaded repo to a destination directory.
+ */
+function extractTemplate(repoDir, templateEntry, destDir, ignorePatterns = []) {
+    const templateSrc = path.join(repoDir, templateEntry.path);
+    if (!fs.existsSync(templateSrc)) {
+        throw new Error(`Template directory not found in repository: ${templateEntry.path}`);
+    }
+    copyDirRecursive(templateSrc, destDir, ignorePatterns);
+}
+/**
+ * Read template.json config from a template directory
+ */
+function readTemplateConfig(templateDir) {
+    const configPath = path.join(templateDir, 'template.json');
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Apply placeholders defined in template.json
+ */
+function applyPlaceholders(projectDir, templateConfig, values) {
+    for (const [key, placeholder] of Object.entries(templateConfig.placeholders)) {
+        const value = values[key];
+        if (!value)
+            continue;
+        for (const filePath of placeholder.files) {
+            const fullPath = path.join(projectDir, filePath);
+            if (!fs.existsSync(fullPath))
+                continue;
+            if (placeholder.jsonField) {
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    const json = JSON.parse(content);
+                    json[placeholder.jsonField] = value;
+                    fs.writeFileSync(fullPath, JSON.stringify(json, null, 2) + '\n', 'utf-8');
+                }
+                catch {
+                    // Skip files that can't be parsed
+                }
+            }
+        }
+    }
+}
+/**
+ * Convert manifest entries to TemplateInfo objects for display
+ */
+function manifestToTemplateInfos(manifest, basePath) {
+    return manifest.templates.map((entry) => ({
+        name: entry.name,
+        path: path.join(basePath, entry.path),
+        description: entry.description,
+        source: 'remote',
+        minCliVersion: entry.minCliVersion,
+        minSdkVersion: entry.minSdkVersion,
+        tags: entry.tags,
+    }));
+}
+/**
+ * Get files that will be copied from a directory (for display)
+ */
+function getTemplateFilesFromDir(templateDir, ignorePatterns = []) {
+    const files = [];
+    function collectFiles(dir, relativePath = '') {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relPath = relativePath ? path.join(relativePath, entry.name) : entry.name;
+            if (shouldIgnore(entry.name, ignorePatterns))
+                continue;
+            if (entry.isDirectory()) {
+                collectFiles(path.join(dir, entry.name), relPath);
+            }
+            else {
+                files.push(relPath);
+            }
+        }
+    }
+    collectFiles(templateDir);
+    return files;
+}
+/**
+ * Clean up temporary directory
+ */
+function cleanupTmpDir(tmpDir) {
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch {
+        // Best effort cleanup
+    }
+}
+// ---- Internal helpers ----
+function shouldIgnore(name, ignorePatterns) {
+    return ignorePatterns.some((pattern) => {
+        if (pattern === name)
+            return true;
+        if (pattern.endsWith('*') && name.startsWith(pattern.slice(0, -1)))
+            return true;
+        return false;
+    });
+}
+function copyDirRecursive(src, dest, ignorePatterns = []) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (shouldIgnore(entry.name, ignorePatterns))
+            continue;
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath, ignorePatterns);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=remote-template-service.js.map

package/dist/src/services/remote-template-service.js.map

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

package/dist/src/services/template-cache-service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Template Cache Service
+ *
+ * Manages local caching of fetched remote templates.
+ * Cache location: ~/.ketrics/templates-cache/
+ */
+import type { TemplateManifest } from '../types';
+/**
+ * Check if the cached manifest is still fresh
+ */
+export declare function isCacheFresh(): boolean;
+/**
+ * Read cached manifest
+ */
+export declare function getCachedManifest(): TemplateManifest | null;
+/**
+ * Save manifest to cache
+ */
+export declare function saveCachedManifest(manifest: TemplateManifest): void;
+/**
+ * Get the path to a cached template directory
+ */
+export declare function getCachedTemplatePath(templateName: string): string;
+/**
+ * Check if a template is cached
+ */
+export declare function isTemplateCached(templateName: string): boolean;
+/**
+ * Save a template to the cache by copying from a source directory
+ */
+export declare function cacheTemplate(templateName: string, sourceDir: string): void;
+/**
+ * Get the cache directory path
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the cached templates directory path
+ */
+export declare function getCachedTemplatesDir(): string;
+/**
+ * Clear all cached templates
+ */
+export declare function clearCache(): void;
+//# sourceMappingURL=template-cache-service.d.ts.map

package/dist/src/services/template-cache-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-cache-service.d.ts","sourceRoot":"","sources":["../../../src/services/template-cache-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,UAAU,CAAC;AAkCjE;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAmBtC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,GAAG,IAAI,CAY3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAUnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAW3E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC"}

package/dist/src/services/template-cache-service.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Template Cache Service
+ *
+ * Manages local caching of fetched remote templates.
+ * Cache location: ~/.ketrics/templates-cache/
+ */
+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.isCacheFresh = isCacheFresh;
+exports.getCachedManifest = getCachedManifest;
+exports.saveCachedManifest = saveCachedManifest;
+exports.getCachedTemplatePath = getCachedTemplatePath;
+exports.isTemplateCached = isTemplateCached;
+exports.cacheTemplate = cacheTemplate;
+exports.getCacheDir = getCacheDir;
+exports.getCachedTemplatesDir = getCachedTemplatesDir;
+exports.clearCache = clearCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const version_1 = require("../version");
+const CACHE_BASE_DIR = path.join(os.homedir(), '.ketrics');
+const CACHE_DIR = path.join(CACHE_BASE_DIR, 'templates-cache');
+const MANIFEST_CACHE_FILE = path.join(CACHE_DIR, 'manifest.json');
+const TEMPLATES_CACHE_DIR = path.join(CACHE_DIR, 'templates');
+/** Default cache TTL: 24 hours */
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/**
+ * Get the cache TTL in milliseconds. Can be overridden via KETRICS_TEMPLATE_CACHE_TTL env var (in seconds).
+ */
+function getCacheTtlMs() {
+    const envTtl = process.env.KETRICS_TEMPLATE_CACHE_TTL;
+    if (envTtl) {
+        const seconds = parseInt(envTtl, 10);
+        if (!isNaN(seconds) && seconds > 0) {
+            return seconds * 1000;
+        }
+    }
+    return DEFAULT_CACHE_TTL_MS;
+}
+/**
+ * Ensure the cache directories exist
+ */
+function ensureCacheDir() {
+    if (!fs.existsSync(TEMPLATES_CACHE_DIR)) {
+        fs.mkdirSync(TEMPLATES_CACHE_DIR, { recursive: true });
+    }
+}
+/**
+ * Check if the cached manifest is still fresh
+ */
+function isCacheFresh() {
+    if (!fs.existsSync(MANIFEST_CACHE_FILE)) {
+        return false;
+    }
+    try {
+        const content = fs.readFileSync(MANIFEST_CACHE_FILE, 'utf-8');
+        const cached = JSON.parse(content);
+        // Invalidate if CLI version changed (manifest format may differ)
+        if (cached.cliVersion !== version_1.VERSION) {
+            return false;
+        }
+        const age = Date.now() - cached.fetchedAt;
+        return age < getCacheTtlMs();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read cached manifest
+ */
+function getCachedManifest() {
+    if (!fs.existsSync(MANIFEST_CACHE_FILE)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(MANIFEST_CACHE_FILE, 'utf-8');
+        const cached = JSON.parse(content);
+        return cached.manifest;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save manifest to cache
+ */
+function saveCachedManifest(manifest) {
+    ensureCacheDir();
+    const cached = {
+        manifest,
+        fetchedAt: Date.now(),
+        cliVersion: version_1.VERSION,
+    };
+    fs.writeFileSync(MANIFEST_CACHE_FILE, JSON.stringify(cached, null, 2), 'utf-8');
+}
+/**
+ * Get the path to a cached template directory
+ */
+function getCachedTemplatePath(templateName) {
+    return path.join(TEMPLATES_CACHE_DIR, templateName);
+}
+/**
+ * Check if a template is cached
+ */
+function isTemplateCached(templateName) {
+    const templatePath = getCachedTemplatePath(templateName);
+    return fs.existsSync(templatePath) && fs.existsSync(path.join(templatePath, 'ketrics.config.json'));
+}
+/**
+ * Save a template to the cache by copying from a source directory
+ */
+function cacheTemplate(templateName, sourceDir) {
+    ensureCacheDir();
+    const destDir = getCachedTemplatePath(templateName);
+    // Remove old cached version
+    if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+    }
+    copyDirRecursive(sourceDir, destDir);
+}
+/**
+ * Get the cache directory path
+ */
+function getCacheDir() {
+    return CACHE_DIR;
+}
+/**
+ * Get the cached templates directory path
+ */
+function getCachedTemplatesDir() {
+    return TEMPLATES_CACHE_DIR;
+}
+/**
+ * Clear all cached templates
+ */
+function clearCache() {
+    if (fs.existsSync(CACHE_DIR)) {
+        fs.rmSync(CACHE_DIR, { recursive: true, force: true });
+    }
+}
+// ---- Internal helpers ----
+function copyDirRecursive(src, dest) {
+    if (!fs.existsSync(dest)) {
+        fs.mkdirSync(dest, { recursive: true });
+    }
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=template-cache-service.js.map

package/dist/src/services/template-cache-service.js.map

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

package/dist/src/services/template-service.d.ts

@@ -1,51 +1,45 @@
 /**
- * Template Service
+ * Template Service (Orchestrator)
  *
- * Handles template discovery, listing, and copying for the init command.
+ * Coordinates between remote and local template sources.
+ * Strategy: remote-first with cache, falling back to bundled local templates.
  */
-import type { TemplateInfo } from '../types';
+import type { TemplateInfo, TemplateConfig } from '../types';
 /**
- * Get list of available templates
+ * Get available templates, preferring remote with local fallback.
  */
-export declare function getAvailableTemplates(): TemplateInfo[];
+export declare function getAvailableTemplates(options: {
+    refresh?: boolean;
+    local?: boolean;
+}): Promise<TemplateInfo[]>;
 /**
  * Get a specific template by name
  */
-export declare function getTemplate(name: string): TemplateInfo | undefined;
+export declare function getTemplate(name: string, options: {
+    refresh?: boolean;
+    local?: boolean;
+}): Promise<TemplateInfo | undefined>;
 /**
- * Validation result for destination directory
+ * Copy a template to the destination directory.
+ * For remote templates: downloads, extracts, and copies from tarball.
+ * For local templates: copies from bundled directory.
  */
-export interface DestinationValidation {
-    valid: boolean;
-    errors: string[];
-}
+export declare function copyTemplateToDestination(template: TemplateInfo, destDir: string): Promise<TemplateConfig | null>;
 /**
- * Validate destination directory before copying template
+ * Apply customizations to a copied template.
+ * Uses template.json placeholders if available, falls back to hardcoded updateAppName.
  */
-export declare function validateDestination(destDir: string): DestinationValidation;
+export declare function applyCustomizations(projectDir: string, appName: string, templateConfig: TemplateConfig | null): void;
 /**
- * Copy template to destination directory
- */
-export declare function copyTemplate(template: TemplateInfo, destDir: string): void;
-/**
- * Get files that will be copied from template
+ * Get the list of files in a template (for display purposes)
  */
 export declare function getTemplateFiles(template: TemplateInfo): string[];
 /**
- * Update app name in project files
- *
- * Updates the name field in:
- * - ketrics.config.json
- * - frontend/package.json
- * - backend/package.json
- */
-export declare function updateAppName(projectDir: string, appName: string): void;
-/**
- * Check if a directory exists
+ * Clear the template cache
  */
-export declare function directoryExists(dirPath: string): boolean;
+export declare function clearCache(): void;
 /**
- * Create a directory
+ * Re-export utilities needed by create command
  */
-export declare function createDirectory(dirPath: string): void;
+export { directoryExists, createDirectory } from './local-template-service';
 //# sourceMappingURL=template-service.d.ts.map

package/dist/src/services/template-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../../src/services/template-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAqB7C;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,EAAE,CA+BtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGlE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAsB1E;AAyBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAoBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAmBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAErD"}
+{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../../src/services/template-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EACV,YAAY,EAGZ,cAAc,EAEf,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA8B1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAGnC;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAqChC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,EAAE,CAajE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}