@codeyam/codeyam-cli 0.1.0-staging.e38f7bd → 0.1.0-staging.e3d0ba6

package/codeyam-cli/src/utils/editorRoadmap.js

@@ -0,0 +1,301 @@
+/**
+ * Roadmap data utilities for the CodeYam editor.
+ *
+ * Manages `.codeyam/roadmap.json` — a hybrid checklist of predefined and
+ * user-created tasks across Plan, Build, and Deploy phases.
+ */
+import fs from 'fs';
+import path from 'path';
+// ── Default Predefined Tasks ────────────────────────────────────────────
+const DEFAULT_PLAN_TASKS = [
+    {
+        id: 'plan-project-name',
+        label: 'Define project name and description',
+        completed: false,
+        autoDetect: 'project-title-exists',
+    },
+    {
+        id: 'plan-tech-stack',
+        label: 'Review tech stack',
+        completed: false,
+        autoDetect: 'tech-stack-configured',
+    },
+    {
+        id: 'plan-design-system',
+        label: 'Create design system',
+        completed: false,
+        autoDetect: 'design-system-exists',
+    },
+    {
+        id: 'plan-screen-sizes',
+        label: 'Configure screen sizes',
+        completed: false,
+        autoDetect: 'screen-sizes-configured',
+    },
+    {
+        id: 'plan-pages-routes',
+        label: 'Define pages and routes',
+        completed: false,
+    },
+    {
+        id: 'plan-initial-scenarios',
+        label: 'Create initial scenarios',
+        completed: false,
+        autoDetect: 'scenarios-exist',
+    },
+];
+const DEFAULT_DEPLOY_TASKS = [
+    {
+        id: 'deploy-hosting',
+        label: 'Set up hosting provider',
+        completed: false,
+    },
+    {
+        id: 'deploy-env-vars',
+        label: 'Configure environment variables',
+        completed: false,
+    },
+    {
+        id: 'deploy-cicd',
+        label: 'Set up CI/CD pipeline',
+        completed: false,
+    },
+    {
+        id: 'deploy-domain',
+        label: 'Configure custom domain',
+        completed: false,
+    },
+    {
+        id: 'deploy-production',
+        label: 'Deploy to production',
+        completed: false,
+    },
+];
+export function getDefaultRoadmap() {
+    return {
+        plan: DEFAULT_PLAN_TASKS.map((t) => ({ ...t })),
+        deploy: DEFAULT_DEPLOY_TASKS.map((t) => ({ ...t })),
+    };
+}
+// ── Read / Write ────────────────────────────────────────────────────────
+function roadmapPath(projectRoot) {
+    return path.join(projectRoot, '.codeyam', 'roadmap.json');
+}
+/**
+ * Read roadmap data from `.codeyam/roadmap.json`.
+ * Returns default tasks if the file is missing or invalid.
+ */
+export function readRoadmap(projectRoot) {
+    try {
+        const raw = fs.readFileSync(roadmapPath(projectRoot), 'utf8');
+        return sanitizeRoadmapData(JSON.parse(raw));
+    }
+    catch {
+        return getDefaultRoadmap();
+    }
+}
+/**
+ * Write roadmap data to `.codeyam/roadmap.json`.
+ */
+export function writeRoadmap(projectRoot, data) {
+    const filePath = roadmapPath(projectRoot);
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+// ── Sanitization ────────────────────────────────────────────────────────
+function sanitizeTodo(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const obj = raw;
+    if (typeof obj.id !== 'string' || typeof obj.label !== 'string')
+        return null;
+    return {
+        id: obj.id,
+        label: obj.label,
+        completed: obj.completed === true,
+        ...(typeof obj.completedAt === 'string'
+            ? { completedAt: obj.completedAt }
+            : {}),
+        ...(typeof obj.autoDetect === 'string'
+            ? { autoDetect: obj.autoDetect }
+            : {}),
+        ...(obj.userCreated === true ? { userCreated: true } : {}),
+    };
+}
+/**
+ * Merge missing default tasks into an existing list.
+ * New defaults are inserted at the position they appear in the defaults list,
+ * preserving the user's existing order and any user-created tasks.
+ */
+function mergeDefaults(existing, defaults) {
+    const existingIds = new Set(existing.map((t) => t.id));
+    const missing = defaults.filter((d) => !existingIds.has(d.id));
+    if (missing.length === 0)
+        return existing;
+    const merged = [...existing];
+    for (const task of missing) {
+        // Insert after the previous default task's position (or at start)
+        const defaultIdx = defaults.indexOf(task);
+        const prevDefault = defaults[defaultIdx - 1];
+        if (prevDefault) {
+            const insertAfter = merged.findIndex((t) => t.id === prevDefault.id);
+            merged.splice(insertAfter + 1, 0, { ...task });
+        }
+        else {
+            merged.unshift({ ...task });
+        }
+    }
+    return merged;
+}
+/**
+ * Defensively parse raw JSON into RoadmapData.
+ * Invalid entries are dropped; missing sections get defaults.
+ * New default tasks added in code updates are merged into existing data.
+ */
+export function sanitizeRoadmapData(raw) {
+    const defaults = getDefaultRoadmap();
+    if (typeof raw !== 'object' || raw === null)
+        return defaults;
+    const obj = raw;
+    const plan = Array.isArray(obj.plan)
+        ? mergeDefaults(obj.plan.map(sanitizeTodo).filter(Boolean), defaults.plan)
+        : defaults.plan;
+    const deploy = Array.isArray(obj.deploy)
+        ? mergeDefaults(obj.deploy.map(sanitizeTodo).filter(Boolean), defaults.deploy)
+        : defaults.deploy;
+    return { plan, deploy };
+}
+const AUTO_DETECT_CHECKERS = {
+    'project-title-exists': (projectRoot) => {
+        try {
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            return !!config.projectTitle;
+        }
+        catch {
+            return false;
+        }
+    },
+    'tech-stack-configured': (projectRoot) => {
+        try {
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            // Check if techStack has any populated categories
+            if (config.techStack && typeof config.techStack === 'object') {
+                const hasItems = Object.values(config.techStack).some((cat) => Array.isArray(cat) && cat.length > 0);
+                if (hasItems)
+                    return true;
+            }
+            // Fallback: webapps configured still counts
+            return Array.isArray(config.webapps) && config.webapps.length > 0;
+        }
+        catch {
+            return false;
+        }
+    },
+    // Keep old checker for backward compat with existing roadmap.json files
+    'webapps-configured': (projectRoot) => {
+        try {
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            return Array.isArray(config.webapps) && config.webapps.length > 0;
+        }
+        catch {
+            return false;
+        }
+    },
+    'design-system-exists': (projectRoot) => {
+        return fs.existsSync(path.join(projectRoot, '.codeyam', 'design-system.md'));
+    },
+    'screen-sizes-configured': (projectRoot) => {
+        try {
+            const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            return (config.screenSizes != null && Object.keys(config.screenSizes).length > 0);
+        }
+        catch {
+            return false;
+        }
+    },
+    'scenarios-exist': (projectRoot) => {
+        const scenariosDir = path.join(projectRoot, '.codeyam', 'editor-scenarios');
+        try {
+            const files = fs.readdirSync(scenariosDir);
+            return files.some((f) => f.endsWith('.json'));
+        }
+        catch {
+            return false;
+        }
+    },
+};
+/**
+ * Evaluate auto-detect conditions for a list of todos.
+ * Returns a new array with updated completion status for auto-detect tasks.
+ * Manually completed tasks (no autoDetect key) are left unchanged.
+ */
+export function checkAutoDetections(projectRoot, todos) {
+    return todos.map((todo) => {
+        if (!todo.autoDetect)
+            return todo;
+        const checker = AUTO_DETECT_CHECKERS[todo.autoDetect];
+        if (!checker)
+            return todo;
+        const detected = checker(projectRoot);
+        if (detected && !todo.completed) {
+            return {
+                ...todo,
+                completed: true,
+                completedAt: new Date().toISOString(),
+            };
+        }
+        if (!detected && todo.completed && !todo.userCreated) {
+            // Auto-detected task was uncompleted (e.g. design system file deleted)
+            const { completedAt, ...rest } = todo;
+            return { ...rest, completed: false };
+        }
+        return todo;
+    });
+}
+/**
+ * Count journal entries from the journal index file.
+ */
+export function countJournalEntries(projectRoot) {
+    try {
+        const indexPath = path.join(projectRoot, '.codeyam', 'journal', 'index.json');
+        const raw = fs.readFileSync(indexPath, 'utf8');
+        const index = JSON.parse(raw);
+        return Array.isArray(index.entries) ? index.entries.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Return the most recent journal entries (newest first).
+ * Only includes the fields needed for roadmap display.
+ */
+export function getRecentJournalEntries(projectRoot, limit = 3) {
+    try {
+        const indexPath = path.join(projectRoot, '.codeyam', 'journal', 'index.json');
+        const raw = fs.readFileSync(indexPath, 'utf8');
+        const index = JSON.parse(raw);
+        if (!Array.isArray(index.entries))
+            return [];
+        return index.entries
+            .slice()
+            .reverse()
+            .slice(0, limit)
+            .map((e) => ({
+            title: e.title,
+            time: e.time,
+            type: e.type || 'feature',
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=editorRoadmap.js.map

package/codeyam-cli/src/utils/editorRoadmap.js.map

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

package/codeyam-cli/src/utils/editorScenarioSwitch.js

@@ -0,0 +1,149 @@
+/**
+ * Shared scenario switching logic.
+ *
+ * Both `/api/dev-mode-preview` (Express, server.ts) and
+ * `/api/editor-switch-scenario` (React Router action) need to switch
+ * the active scenario. This module consolidates that logic so both
+ * code paths handle seed-based scenarios correctly.
+ */
+import fs from 'fs';
+import path from 'path';
+import { runSeedAdapter, detectSeedAdapter, } from "./editorSeedAdapter.js";
+/**
+ * Track in-flight seed operations to deduplicate concurrent requests
+ * for the same scenario.
+ */
+let activeSeedOperation = null;
+/**
+ * Switch the active editor scenario.
+ *
+ * 1. Resolves the scenario type from the data file if not provided
+ * 2. Writes `active-scenario.json` (including `type`)
+ * 3. Runs the seed adapter for application/user scenarios
+ * 4. Returns the result (caller is responsible for cache invalidation and refresh)
+ */
+export async function switchActiveScenario(params) {
+    const { scenarioId, projectRoot } = params;
+    const codeyamDir = path.join(projectRoot, '.codeyam');
+    const scenariosDir = path.join(codeyamDir, 'editor-scenarios');
+    // Resolve slug from data file if not provided
+    let effectiveSlug = params.scenarioSlug || null;
+    if (!effectiveSlug) {
+        try {
+            const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+            if (fs.existsSync(dataFile)) {
+                const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                effectiveSlug = data.name || scenarioId;
+            }
+            else {
+                effectiveSlug = scenarioId;
+            }
+        }
+        catch {
+            effectiveSlug = scenarioId;
+        }
+    }
+    // Resolve type: prefer explicit param, fall back to data file
+    let effectiveType = params.scenarioType || null;
+    if (!effectiveType) {
+        try {
+            const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+            if (fs.existsSync(dataFile)) {
+                const data = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                effectiveType = data.type || null;
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // Write active-scenario.json — MUST include type so proxy is type-aware
+    const activeScenarioPath = path.join(codeyamDir, 'active-scenario.json');
+    fs.mkdirSync(codeyamDir, { recursive: true });
+    fs.writeFileSync(activeScenarioPath, JSON.stringify({
+        scenarioSlug: effectiveSlug,
+        scenarioName: params.scenarioName || effectiveSlug,
+        scenarioId,
+        type: effectiveType,
+        dataFile: `.codeyam/editor-scenarios/${scenarioId}.json`,
+        switchedAt: new Date().toISOString(),
+    }, null, 2));
+    // Run seed adapter for application/user scenarios
+    let seedResult = null;
+    let sessionCookies;
+    let seedExternalApis;
+    const isSeedScenario = effectiveType === 'application' || effectiveType === 'user';
+    if (isSeedScenario) {
+        // Deduplicate concurrent seed requests for the same scenario
+        if (activeSeedOperation && activeSeedOperation.scenarioId === scenarioId) {
+            seedResult = await activeSeedOperation.promise;
+        }
+        else {
+            const adapterPath = detectSeedAdapter(projectRoot);
+            const seedDataPath = path.join(scenariosDir, `${scenarioId}.seed.json`);
+            if (adapterPath && fs.existsSync(seedDataPath)) {
+                const seedPromise = runSeedAdapter(adapterPath, seedDataPath).then((result) => ({
+                    success: result.success,
+                    error: result.error,
+                    sessionCookies: result.sessionCookies,
+                    externalApis: result.externalApis,
+                }));
+                activeSeedOperation = { scenarioId, promise: seedPromise };
+                try {
+                    const fullResult = await seedPromise;
+                    seedResult = {
+                        success: fullResult.success,
+                        error: fullResult.error,
+                    };
+                    sessionCookies = fullResult.sessionCookies;
+                    seedExternalApis = fullResult.externalApis;
+                }
+                finally {
+                    if (activeSeedOperation &&
+                        activeSeedOperation.scenarioId === scenarioId) {
+                        activeSeedOperation = null;
+                    }
+                }
+                // Persist session cookies and externalApis to the scenario data file
+                if (seedResult?.success) {
+                    const hasSessionCookies = sessionCookies && sessionCookies.length > 0;
+                    const hasExternalApis = seedExternalApis && Object.keys(seedExternalApis).length > 0;
+                    if (hasSessionCookies || hasExternalApis) {
+                        try {
+                            const dataFile = path.join(scenariosDir, `${scenarioId}.json`);
+                            const existing = JSON.parse(fs.readFileSync(dataFile, 'utf-8'));
+                            if (hasSessionCookies) {
+                                existing.sessionCookies = sessionCookies;
+                            }
+                            if (hasExternalApis) {
+                                // Merge with existing externalApis (e.g., Stripe mocks) —
+                                // seed adapter entries (e.g., Supabase auth) layer on top
+                                existing.externalApis = {
+                                    ...existing.externalApis,
+                                    ...seedExternalApis,
+                                };
+                            }
+                            fs.writeFileSync(dataFile, JSON.stringify(existing, null, 2));
+                        }
+                        catch {
+                            // Non-fatal — cookies/externalApis just won't be persisted
+                        }
+                    }
+                }
+            }
+            else if (!adapterPath) {
+                seedResult = { success: false, error: 'No seed adapter found' };
+            }
+        }
+    }
+    return {
+        success: true,
+        scenarioSlug: effectiveSlug,
+        scenarioId,
+        type: effectiveType,
+        seeded: isSeedScenario,
+        ...(seedResult ? { seedResult } : {}),
+        ...(sessionCookies && sessionCookies.length > 0 ? { sessionCookies } : {}),
+    };
+}
+//# sourceMappingURL=editorScenarioSwitch.js.map

package/codeyam-cli/src/utils/editorScenarioSwitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorScenarioSwitch.js","sourceRoot":"","sources":["../../../../src/utils/editorScenarioSwitch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,qBAAqB,CAAC;AAoB7B;;;GAGG;AACH,IAAI,mBAAmB,GAQZ,IAAI,CAAC;AAEhB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA4B;IAE5B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAE/D,8CAA8C;IAC9C,IAAI,aAAa,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC5D,aAAa,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,UAAU,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,aAAa,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC5D,aAAa,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IACzE,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,EAAE,CAAC,aAAa,CACd,kBAAkB,EAClB,IAAI,CAAC,SAAS,CACZ;QACE,YAAY,EAAE,aAAa;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,aAAa;QAClD,UAAU;QACV,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,6BAA6B,UAAU,OAAO;QACxD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IAEF,kDAAkD;IAClD,IAAI,UAAU,GAAgD,IAAI,CAAC;IACnE,IAAI,cAA+C,CAAC;IACpD,IAAI,gBAAqD,CAAC;IAC1D,MAAM,cAAc,GAClB,aAAa,KAAK,aAAa,IAAI,aAAa,KAAK,MAAM,CAAC;IAE9D,IAAI,cAAc,EAAE,CAAC;QACnB,6DAA6D;QAC7D,IAAI,mBAAmB,IAAI,mBAAmB,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACzE,UAAU,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,UAAU,YAAY,CAAC,CAAC;YAExE,IAAI,WAAW,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/C,MAAM,WAAW,GAAG,cAAc,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,IAAI,CAChE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACX,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC,CACH,CAAC;gBAEF,mBAAmB,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;gBAC3D,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC;oBACrC,UAAU,GAAG;wBACX,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;qBACxB,CAAC;oBACF,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;oBAC3C,gBAAgB,GAAG,UAAU,CAAC,YAAY,CAAC;gBAC7C,CAAC;wBAAS,CAAC;oBACT,IACE,mBAAmB;wBACnB,mBAAmB,CAAC,UAAU,KAAK,UAAU,EAC7C,CAAC;wBACD,mBAAmB,GAAG,IAAI,CAAC;oBAC7B,CAAC;gBACH,CAAC;gBAED,qEAAqE;gBACrE,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;oBACxB,MAAM,iBAAiB,GAAG,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;oBACtE,MAAM,eAAe,GACnB,gBAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;oBAE/D,IAAI,iBAAiB,IAAI,eAAe,EAAE,CAAC;wBACzC,IAAI,CAAC;4BACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,UAAU,OAAO,CAAC,CAAC;4BAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;4BAChE,IAAI,iBAAiB,EAAE,CAAC;gCACtB,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;4BAC3C,CAAC;4BACD,IAAI,eAAe,EAAE,CAAC;gCACpB,0DAA0D;gCAC1D,0DAA0D;gCAC1D,QAAQ,CAAC,YAAY,GAAG;oCACtB,GAAG,QAAQ,CAAC,YAAY;oCACxB,GAAG,gBAAgB;iCACpB,CAAC;4BACJ,CAAC;4BACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;wBAChE,CAAC;wBAAC,MAAM,CAAC;4BACP,2DAA2D;wBAC7D,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACxB,UAAU,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,aAAc;QAC5B,UAAU;QACV,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,cAAc;QACtB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC"}