@codeyam/codeyam-cli 0.1.0-staging.4c0c3c9 → 0.1.0-staging.54098fa

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

@@ -0,0 +1,77 @@
+import { scenarioEntityName } from "./entityChangeStatus.js";
+/**
+ * Classify scenarios as stale or fresh based on when they were captured
+ * relative to when the current feature started.
+ *
+ * A scenario is "stale" if:
+ * - It belongs to a page entity that is new/edited/impacted
+ * - It was captured BEFORE the current feature started
+ *
+ * A page is "uncovered" if:
+ * - It has a new/edited/impacted entity
+ * - It has NO scenarios at all (not even stale ones)
+ */
+export function classifyScenarioCoverage(scenarios, entityChangeStatus, pageEntityNames, featureStartedAt) {
+    // Convert ISO timestamp to SQLite format for comparison
+    const featureTs = featureStartedAt
+        ? featureStartedAt.replace('T', ' ').replace(/\.\d{3}Z$/, '')
+        : null;
+    const staleScenarios = [];
+    const freshScenarios = [];
+    const coveredPageEntities = new Set();
+    for (const row of scenarios) {
+        // Determine entity name for this scenario, preferring pageFilePath
+        // for precise route-based identity over lossy URL-derived names.
+        const entityName = scenarioEntityName({
+            componentName: row.component_name,
+            pageFilePath: row.page_file_path,
+            url: row.url,
+        });
+        if (!entityName)
+            continue;
+        const status = entityChangeStatus[entityName];
+        if (!status)
+            continue; // Entity not changed — not relevant
+        // Only audit page/app scenarios, not component isolation scenarios
+        if (row.component_name)
+            continue;
+        const createdAt = row.created_at || '';
+        const updatedAt = row.updated_at || '';
+        const isFresh = featureTs
+            ? createdAt >= featureTs || updatedAt >= featureTs
+            : true;
+        if (isFresh) {
+            freshScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+            });
+            coveredPageEntities.add(entityName);
+        }
+        else {
+            staleScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+                changeStatus: status.status,
+                lastCaptured: createdAt,
+            });
+        }
+    }
+    // Find pages with changes but zero scenarios
+    const uncoveredPages = [];
+    for (const [entityName, status] of Object.entries(entityChangeStatus)) {
+        if (!pageEntityNames.has(entityName))
+            continue; // Only pages
+        if (coveredPageEntities.has(entityName))
+            continue; // Has fresh scenarios
+        // Check if it has ANY scenario (even stale)
+        const hasStale = staleScenarios.some((s) => s.entityName === entityName);
+        if (!hasStale) {
+            uncoveredPages.push({ entityName, changeStatus: status.status });
+        }
+    }
+    const pass = staleScenarios.length === 0 && uncoveredPages.length === 0;
+    return { staleScenarios, freshScenarios, uncoveredPages, pass };
+}
+//# sourceMappingURL=scenarioCoverage.js.map

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

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

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

@@ -0,0 +1,134 @@
+/**
+ * Pure logic for transforming {{scenario:Name:ID}} markers into OSC 8
+ * clickable hyperlinks in terminal output.
+ *
+ * Extracted from terminalServer.ts for testability. Zero side-effects.
+ *
+ * Claude Code's renderer inserts ANSI escape codes (colors/styles) within the
+ * marker text, so we can't regex-match on raw PTY data directly. Instead,
+ * strip ANSI codes to find markers, then map positions back to the original
+ * string for replacement.
+ */
+// Matches CSI sequences: \x1b[ followed by params and a letter.
+// Also handles private-mode params (?) and colon-delimited SGR (e.g., 38:2:R:G:B).
+const ANSI_ESCAPE_RE = /\x1b\[[?]?[0-9;:]*[a-zA-Z]/g;
+// Additional non-CSI escapes: charset selection (\x1b(B), save/restore cursor, etc.
+const OTHER_ESCAPE_RE = /\x1b[()][A-Z0-9]/g;
+/**
+ * Strip all ANSI escape sequences from a string.
+ */
+function stripAnsi(data) {
+    return data.replace(ANSI_ESCAPE_RE, '').replace(OTHER_ESCAPE_RE, '');
+}
+/**
+ * Build a position map from ANSI-stripped indices to original indices.
+ * posMap[strippedIndex] = originalIndex, skipping over ANSI sequences.
+ */
+function buildAnsiPositionMap(data, stripped) {
+    const posMap = [];
+    for (let di = 0, si = 0; di < data.length; di++) {
+        if (data[di] === '\x1b') {
+            // Try CSI sequence (with optional ? for private mode, : for colon-delimited SGR)
+            const seqMatch = data.slice(di).match(/^\x1b\[?\??[0-9;:]*[a-zA-Z]/);
+            if (seqMatch) {
+                di += seqMatch[0].length - 1;
+                continue;
+            }
+            // Try charset selection: \x1b(B, \x1b)0, etc.
+            const charsetMatch = data.slice(di).match(/^\x1b[()][A-Z0-9]/);
+            if (charsetMatch) {
+                di += charsetMatch[0].length - 1;
+                continue;
+            }
+        }
+        posMap[si] = di;
+        si++;
+    }
+    posMap[stripped.length] = data.length; // sentinel for end-of-string markers
+    return posMap;
+}
+const MARKER_RE = /\{\{scenario:([^:}]+):([^}]+)\}\}/g;
+/**
+ * Transform {{scenario:Name:ID}} markers into OSC 8 hyperlinks.
+ * OSC 8 format: \x1b]8;;URL\x07VISIBLE_TEXT\x1b]8;;\x07
+ *
+ * Stateless — operates on a single string. For streaming PTY data,
+ * use createMarkerTransformer() which buffers partial markers.
+ */
+export function transformScenarioMarkers(data, port) {
+    const stripped = stripAnsi(data);
+    if (!stripped.includes('{{scenario:'))
+        return data;
+    const posMap = buildAnsiPositionMap(data, stripped);
+    const replacements = [];
+    let m;
+    while ((m = MARKER_RE.exec(stripped)) !== null) {
+        const url = `http://localhost:${port}/editor?scenario=${m[2]}&ref=link`;
+        const visibleName = m[1];
+        // Pad replacement to match the original marker's visible width so table
+        // columns stay aligned after the shorter hyperlink text replaces the marker.
+        const pad = ' '.repeat(Math.max(0, m[0].length - visibleName.length));
+        replacements.push({
+            origStart: posMap[m.index],
+            origEnd: posMap[m.index + m[0].length],
+            replacement: `\x1b]8;;${url}\x07${visibleName}\x1b]8;;\x07${pad}`,
+        });
+    }
+    if (replacements.length === 0)
+        return data;
+    // Replace from end to start so earlier positions stay valid
+    let result = data;
+    for (let i = replacements.length - 1; i >= 0; i--) {
+        const r = replacements[i];
+        result =
+            result.slice(0, r.origStart) + r.replacement + result.slice(r.origEnd);
+    }
+    return result;
+}
+/**
+ * Create a stateful scenario marker transformer that buffers partial markers
+ * across PTY chunks. Claude Code streams output token by token, so the PTY
+ * can split a {{scenario:Name:ID}} marker across two (or more) data events.
+ *
+ * Also handles Ink-style line rewrites where \r (carriage return) invalidates
+ * buffered content from the same line.
+ */
+export function createMarkerTransformer(port) {
+    let buffer = '';
+    return function transform(data) {
+        // If the incoming data contains \r (carriage return), Ink is rewriting
+        // the current line. Any buffered partial marker from that line is stale —
+        // discard it so the new content isn't confused with old fragments.
+        // The buffer only ever holds content after an unclosed {{ (i.e., a partial
+        // marker on the current line), so discarding it is always safe when the
+        // line is being rewritten.
+        if (buffer && data.includes('\r')) {
+            buffer = '';
+            return transform(data);
+        }
+        // Prepend any buffered partial-marker text from the previous chunk
+        const combined = buffer + data;
+        buffer = '';
+        // Strip ANSI to detect partial markers at the end
+        const stripped = stripAnsi(combined);
+        // Check for an unclosed {{ at the end — potential partial marker
+        const lastOpen = stripped.lastIndexOf('{{');
+        if (lastOpen !== -1 && !stripped.slice(lastOpen).includes('}}')) {
+            // Map the stripped position back to the original string
+            const posMap = buildAnsiPositionMap(combined, stripped);
+            const splitPos = posMap[lastOpen];
+            // Safety: if partial marker exceeds 500 chars, it's not a real marker — flush it
+            if (combined.length - splitPos > 500) {
+                return transformScenarioMarkers(combined, port);
+            }
+            buffer = combined.slice(splitPos);
+            const toSend = combined.slice(0, splitPos);
+            // If nothing to send yet (entire chunk is a partial marker), return empty
+            if (toSend.length === 0)
+                return '';
+            return transformScenarioMarkers(toSend, port);
+        }
+        return transformScenarioMarkers(combined, port);
+    };
+}
+//# sourceMappingURL=scenarioMarkers.js.map

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

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

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

@@ -0,0 +1,307 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveViewportWithProjectDefault } from "./editorScenarios.js";
+/**
+ * Scan .codeyam/editor-scenarios/ for scenario files with embedded _metadata.
+ * Returns an array of { id, metadata } for each file that has _metadata.
+ */
+export function scanScenarioFiles(codeyamRoot) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let files;
+    try {
+        files = fs.readdirSync(scenariosDir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const file of files) {
+        // Only process {uuid}.json files, skip .seed.json and subdirectories
+        if (!file.endsWith('.json') || file.endsWith('.seed.json'))
+            continue;
+        if (file === 'client-errors.json')
+            continue;
+        const filePath = path.join(scenariosDir, file);
+        try {
+            const stat = fs.statSync(filePath);
+            if (!stat.isFile())
+                continue;
+            const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            if (content._metadata) {
+                const id = file.replace(/\.json$/, '');
+                results.push({ id, metadata: content._metadata });
+            }
+        }
+        catch {
+            // Skip unparseable files
+        }
+    }
+    return results;
+}
+/**
+ * Write or update _metadata in a scenario data file.
+ * Preserves all existing data in the file, only adds/updates the _metadata key.
+ */
+export function writeScenarioMetadata(codeyamRoot, scenarioId, metadata) {
+    const filePath = path.join(codeyamRoot, '.codeyam', 'editor-scenarios', `${scenarioId}.json`);
+    let existing = {};
+    try {
+        existing = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        // File doesn't exist yet — will be created by the caller
+        return;
+    }
+    existing._metadata = metadata;
+    fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8');
+}
+/**
+ * Update only the screenshotPath (and updatedAt) in existing scenario metadata.
+ * Unlike writeScenarioMetadata which replaces the entire _metadata object,
+ * this preserves all existing fields (entitySha, displayName, etc.).
+ */
+export function updateScenarioScreenshotInMetadata(codeyamRoot, scenarioId, screenshotPath) {
+    const filePath = path.join(codeyamRoot, '.codeyam', 'editor-scenarios', `${scenarioId}.json`);
+    let existing = {};
+    try {
+        existing = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return;
+    }
+    if (existing._metadata && typeof existing._metadata === 'object') {
+        existing._metadata.screenshotPath =
+            screenshotPath;
+        existing._metadata.updatedAt =
+            new Date().toISOString();
+        fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8');
+    }
+}
+/**
+ * Write a scenario data file, preserving existing fields not being overwritten.
+ *
+ * This is the single write path for scenario {id}.json files during registration.
+ * It reads the existing file first (if any), merges the provided data overrides
+ * on top of existing fields, and always replaces _metadata.
+ *
+ * This prevents re-registration from destroying previously-saved seed data,
+ * sessionCookies, externalApis, etc.
+ */
+export function writeScenarioDataFile(codeyamRoot, scenarioId, metadata, dataOverrides = {}) {
+    const dir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${scenarioId}.json`);
+    // Read existing file to preserve fields not being overwritten
+    let existing = {};
+    try {
+        existing = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        // File doesn't exist yet — start fresh
+    }
+    // Replace _metadata, merge data overrides on top of existing fields
+    const merged = {
+        ...existing,
+        _metadata: metadata,
+        ...dataOverrides,
+    };
+    fs.writeFileSync(filePath, JSON.stringify(merged, null, 2), 'utf8');
+}
+/**
+ * Backfill _metadata into scenario files that don't have it yet.
+ * Uses database rows as the source of truth for metadata.
+ * Returns the number of files updated.
+ */
+export function backfillScenarioMetadata(codeyamRoot, dbRows) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let updated = 0;
+    for (const row of dbRows) {
+        const filePath = path.join(scenariosDir, `${row.id}.json`);
+        try {
+            const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            if (content._metadata)
+                continue; // Already has metadata
+            const r = row;
+            content._metadata = {
+                name: row.name,
+                description: row.description,
+                componentName: row.component_name,
+                componentPath: row.component_path,
+                url: row.url,
+                type: row.type,
+                screenshotPath: row.screenshot_path ?? null,
+                viewportWidth: row.viewport_width ?? null,
+                viewportHeight: row.viewport_height ?? null,
+                dimensions: r.dimensions ? JSON.parse(r.dimensions) : null,
+                screenshotPaths: r.screenshot_paths
+                    ? JSON.parse(r.screenshot_paths)
+                    : null,
+                pageFilePath: r.page_file_path ?? null,
+                entitySha: r.entity_sha ?? null,
+                displayName: r.display_name ?? null,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            };
+            fs.writeFileSync(filePath, JSON.stringify(content, null, 2), 'utf8');
+            updated++;
+        }
+        catch {
+            // File doesn't exist or isn't valid JSON — skip
+        }
+    }
+    return updated;
+}
+/**
+ * Migrate scenario files with bad/legacy formats to the current format.
+ *
+ * Fixes:
+ * 1. Null viewport → resolved via dimension name / project default / 1280×720 fallback
+ * 2. Missing `dimensions` array → wrapped from single `dimension` string
+ * 3. Missing `screenshotPaths` map → built from single `screenshotPath` + dimension name
+ *
+ * This runs during editor startup to repair files created before viewport
+ * resolution was mandatory and before multi-dimension support was added.
+ * It is idempotent — files already in the correct format are skipped.
+ */
+export function migrateScenarioFormats(codeyamRoot) {
+    const entries = scanScenarioFiles(codeyamRoot);
+    if (entries.length === 0) {
+        return { scanned: 0, fixed: 0 };
+    }
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let fixed = 0;
+    for (const { id, metadata } of entries) {
+        let needsWrite = false;
+        const updated = { ...metadata };
+        // Legacy files may still have a `dimension` property (removed from type)
+        const legacyDimension = metadata.dimension;
+        // Fix 1: Null viewport → resolve from dimensions[0] / project default / fallback
+        if (!updated.viewportWidth || !updated.viewportHeight) {
+            const resolved = resolveViewportWithProjectDefault({
+                dimension: updated.dimensions?.[0] ?? legacyDimension ?? undefined,
+                codeyamRoot,
+            });
+            updated.viewportWidth = resolved.width;
+            updated.viewportHeight = resolved.height;
+            needsWrite = true;
+        }
+        // Fix 2: Missing dimensions array → wrap legacy single dimension
+        if (!updated.dimensions && legacyDimension) {
+            updated.dimensions = [legacyDimension];
+            needsWrite = true;
+        }
+        // Fix 3: Missing screenshotPaths map → build from single screenshotPath
+        const primaryDimension = updated.dimensions?.[0] ?? legacyDimension;
+        if (!updated.screenshotPaths &&
+            updated.screenshotPath &&
+            primaryDimension) {
+            updated.screenshotPaths = { [primaryDimension]: updated.screenshotPath };
+            needsWrite = true;
+        }
+        // Fix 4: Strip legacy `dimension` field from metadata
+        if (legacyDimension !== undefined) {
+            delete updated.dimension;
+            needsWrite = true;
+        }
+        if (needsWrite) {
+            // Bump updatedAt so the next syncScenarioFilesToDatabase picks up the fix
+            updated.updatedAt = new Date().toISOString();
+            const filePath = path.join(scenariosDir, `${id}.json`);
+            try {
+                const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+                content._metadata = updated;
+                fs.writeFileSync(filePath, JSON.stringify(content, null, 2), 'utf8');
+                fixed++;
+            }
+            catch {
+                // Non-fatal — skip files that can't be read/written
+            }
+        }
+    }
+    return { scanned: entries.length, fixed };
+}
+/**
+ * Remove a scenario data file (and its .seed.json if present).
+ */
+export function deleteScenarioFiles(codeyamRoot, scenarioId) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    for (const suffix of ['.json', '.seed.json']) {
+        const filePath = path.join(scenariosDir, `${scenarioId}${suffix}`);
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch {
+            // File might not exist
+        }
+    }
+}
+/**
+ * Sync scenario files (with _metadata) to database.
+ * Scans the editor-scenarios/ directory for files with embedded _metadata.
+ */
+export async function syncScenarioFilesToDatabase(codeyamRoot, projectId, existingRows, onInsert, onUpdate) {
+    const entries = scanScenarioFiles(codeyamRoot);
+    if (entries.length === 0) {
+        return { inserted: 0, updated: 0, skipped: 0 };
+    }
+    const existingMap = new Map(existingRows.map((r) => [r.id, r.updated_at]));
+    let inserted = 0;
+    let updated = 0;
+    let skipped = 0;
+    for (const { id, metadata } of entries) {
+        const existingUpdatedAt = existingMap.get(id);
+        if (existingUpdatedAt === undefined) {
+            await onInsert({
+                id,
+                project_id: projectId,
+                name: metadata.name,
+                description: metadata.description,
+                component_name: metadata.componentName,
+                component_path: metadata.componentPath,
+                url: metadata.url,
+                type: metadata.type,
+                screenshot_path: metadata.screenshotPath,
+                viewport_width: metadata.viewportWidth,
+                viewport_height: metadata.viewportHeight,
+                dimensions: metadata.dimensions
+                    ? JSON.stringify(metadata.dimensions)
+                    : null,
+                screenshot_paths: metadata.screenshotPaths
+                    ? JSON.stringify(metadata.screenshotPaths)
+                    : null,
+                page_file_path: metadata.pageFilePath ?? null,
+                entity_sha: metadata.entitySha ?? null,
+                display_name: metadata.displayName ?? null,
+            });
+            inserted++;
+        }
+        else if (metadata.updatedAt > existingUpdatedAt) {
+            await onUpdate(id, {
+                name: metadata.name,
+                description: metadata.description,
+                component_name: metadata.componentName,
+                component_path: metadata.componentPath,
+                url: metadata.url,
+                type: metadata.type,
+                screenshot_path: metadata.screenshotPath,
+                viewport_width: metadata.viewportWidth,
+                viewport_height: metadata.viewportHeight,
+                dimensions: metadata.dimensions
+                    ? JSON.stringify(metadata.dimensions)
+                    : null,
+                screenshot_paths: metadata.screenshotPaths
+                    ? JSON.stringify(metadata.screenshotPaths)
+                    : null,
+                page_file_path: metadata.pageFilePath ?? null,
+                entity_sha: metadata.entitySha ?? null,
+                display_name: metadata.displayName ?? null,
+            });
+            updated++;
+        }
+        else {
+            skipped++;
+        }
+    }
+    return { inserted, updated, skipped };
+}
+//# sourceMappingURL=scenariosManifest.js.map

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

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

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

@@ -0,0 +1,26 @@
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+export function computeScreenshotHash(absolutePath) {
+    try {
+        const buffer = fs.readFileSync(absolutePath);
+        return crypto.createHash('sha256').update(buffer).digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+export function findDuplicateScreenshots(entries) {
+    const hashToNames = new Map();
+    for (const entry of entries) {
+        const existing = hashToNames.get(entry.hash) || [];
+        existing.push(entry.scenarioName);
+        hashToNames.set(entry.hash, existing);
+    }
+    const duplicates = new Map();
+    for (const [hash, names] of hashToNames) {
+        if (names.length > 1)
+            duplicates.set(hash, names);
+    }
+    return duplicates;
+}
+//# sourceMappingURL=screenshotHash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotHash.js","sourceRoot":"","sources":["../../../../src/utils/screenshotHash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAQzB,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA8B;IAE9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}