@codeyam/codeyam-cli 0.1.0-staging.4c0c3c9 → 0.1.0-staging.57cd50f

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

@@ -0,0 +1,135 @@
+/**
+ * Pure redirect and mock-matching functions for the Node.js preload module.
+ *
+ * Extracted so they can be unit-tested without loading the actual preload
+ * (which patches global fetch and http).
+ */
+/**
+ * If `url` points to the dev server, return a redirected URL going through the proxy.
+ * Otherwise return the original URL unchanged.
+ */
+export function redirectUrl(url, devServerUrl, proxyUrl) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        // Relative URL or invalid — pass through
+        return url;
+    }
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    if (parsed.hostname === dev.hostname && parsed.port === dev.port) {
+        parsed.hostname = proxy.hostname;
+        parsed.port = proxy.port;
+        parsed.protocol = proxy.protocol;
+        return parsed.toString();
+    }
+    return url;
+}
+/**
+ * If http.request options target the dev server, patch them to go through the proxy.
+ * Returns the original options object if no redirect is needed.
+ */
+export function redirectOptions(options, devServerUrl, proxyUrl) {
+    const dev = new URL(devServerUrl);
+    const proxy = new URL(proxyUrl);
+    const devPort = parseInt(dev.port, 10);
+    const proxyPort = parseInt(proxy.port, 10);
+    // Match on hostname + port
+    if (options.hostname &&
+        parseInt(String(options.port), 10) === devPort &&
+        options.hostname === dev.hostname) {
+        return {
+            ...options,
+            hostname: proxy.hostname,
+            port: proxyPort,
+            headers: options.headers
+                ? { ...options.headers, host: `${proxy.hostname}:${proxyPort}` }
+                : options.headers,
+        };
+    }
+    // Match on host field (hostname:port combined)
+    if (options.host) {
+        const expectedHost = `${dev.hostname}:${devPort}`;
+        if (options.host === expectedHost) {
+            return {
+                ...options,
+                host: `${proxy.hostname}:${proxyPort}`,
+            };
+        }
+    }
+    return options;
+}
+/**
+ * Match a request URL against scenario mock data routes.
+ *
+ * Supports:
+ * - Path-only routes:    "/api/drinks" matches fetch("http://localhost:3000/api/drinks")
+ * - Full URL routes:     "https://api.stripe.com/v1/charges" matches external API calls
+ * - Method-prefixed:     "POST /api/drinks" matches POST requests only
+ *
+ * Returns the mock response if matched, or null if no match.
+ */
+export function matchScenarioRoute(requestUrl, method, scenarioData) {
+    const routes = scenarioData.routes;
+    if (!routes || typeof routes !== 'object')
+        return null;
+    // Extract pathname from the request URL
+    let pathname;
+    try {
+        const parsed = new URL(requestUrl);
+        pathname = parsed.pathname;
+    }
+    catch {
+        // Relative URL — use as-is
+        pathname = requestUrl.split('?')[0];
+    }
+    const upperMethod = method.toUpperCase();
+    for (const [routeKey, routeValue] of Object.entries(routes)) {
+        if (!routeValue || typeof routeValue !== 'object')
+            continue;
+        const entry = routeValue;
+        // Check for method-prefixed route: "POST /api/drinks"
+        const spaceIdx = routeKey.indexOf(' ');
+        if (spaceIdx !== -1) {
+            const routeMethod = routeKey.slice(0, spaceIdx).toUpperCase();
+            const routePath = routeKey.slice(spaceIdx + 1);
+            if (routeMethod === upperMethod && routePath === pathname) {
+                return {
+                    body: entry.body ?? routeValue,
+                    status: typeof entry.status === 'number' ? entry.status : 200,
+                };
+            }
+            continue;
+        }
+        // Full URL route: "https://api.stripe.com/v1/charges"
+        if (routeKey.startsWith('http://') || routeKey.startsWith('https://')) {
+            try {
+                const routeParsed = new URL(routeKey);
+                const reqParsed = new URL(requestUrl);
+                if (routeParsed.hostname === reqParsed.hostname &&
+                    routeParsed.port === reqParsed.port &&
+                    routeParsed.pathname === reqParsed.pathname) {
+                    return {
+                        body: entry.body ?? routeValue,
+                        status: typeof entry.status === 'number' ? entry.status : 200,
+                    };
+                }
+            }
+            catch {
+                // Invalid URL in route key — skip
+            }
+            continue;
+        }
+        // Path-only route: "/api/drinks"
+        if (routeKey === pathname) {
+            return {
+                body: entry.body ?? routeValue,
+                status: typeof entry.status === 'number' ? entry.status : 200,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=editorPreloadHelpers.js.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * Preview URL construction and viewport scaling for the editor.
+ *
+ * Extracted from inline logic in editor.tsx (previewUrl useMemo and previewScale useMemo).
+ */
+import { generateScenarioSlug } from "./editorScenarios.js";
+/**
+ * Resolve the preview URL based on current editor state.
+ *
+ * Priority:
+ * 1. Analyzed scenario with interactive server URL
+ * 2. Active scenario with path-based URL → combine with proxy/dev server
+ * 3. Active scenario with full URL → use directly
+ * 4. Zoom component with scenario → __codeyam__ isolation URL
+ * 5. Base proxy/dev server URL
+ */
+export function buildPreviewUrl(params) {
+    const { activeAnalyzedScenario, analyzedPreviewUrl, activeScenarioId, scenarios, proxyUrl, devServerUrl, zoomComponent, } = params;
+    // When viewing an analyzed scenario, use the interactive server URL
+    if (activeAnalyzedScenario && analyzedPreviewUrl) {
+        return analyzedPreviewUrl;
+    }
+    // If analyzed scenario is active but no URL, fall through to check other sources
+    // but if nothing else matches either, return null
+    if (activeAnalyzedScenario && !analyzedPreviewUrl) {
+        return null;
+    }
+    // Component isolation scenarios store a path (e.g. /isolated-components/DrinkCard?s=Default)
+    if (activeScenarioId) {
+        const scenario = scenarios.find((s) => s.id === activeScenarioId);
+        if (scenario?.url) {
+            const base = proxyUrl || devServerUrl;
+            if (!base)
+                return null;
+            if (scenario.url.startsWith('/')) {
+                return `${base}${scenario.url}`;
+            }
+            return scenario.url;
+        }
+    }
+    const baseUrl = proxyUrl || devServerUrl;
+    if (!baseUrl)
+        return null;
+    if (zoomComponent && activeScenarioId) {
+        const scenario = scenarios.find((s) => s.id === activeScenarioId);
+        const scenarioSlug = scenario
+            ? generateScenarioSlug(scenario.name)
+            : 'Default';
+        return `${baseUrl}/__codeyam__/${zoomComponent}/${scenarioSlug}`;
+    }
+    return baseUrl;
+}
+/**
+ * Apply a navigation path override to a preview URL.
+ *
+ * Correctly handles paths with query strings (e.g. `/isolated-components/DrinkCard?s=Default`)
+ * by parsing the path into pathname + search components instead of naively assigning
+ * to `URL.pathname` (which would URL-encode the `?`).
+ */
+export function applyNavigatePath(previewUrl, navigatePath) {
+    if (!previewUrl)
+        return previewUrl;
+    if (!navigatePath)
+        return previewUrl;
+    try {
+        const base = new URL(previewUrl);
+        // Parse navigatePath to separate pathname from query string
+        const qIndex = navigatePath.indexOf('?');
+        if (qIndex >= 0) {
+            base.pathname = navigatePath.slice(0, qIndex);
+            base.search = navigatePath.slice(qIndex);
+        }
+        else {
+            base.pathname = navigatePath;
+            base.search = '';
+        }
+        return base.href;
+    }
+    catch {
+        return previewUrl;
+    }
+}
+/**
+ * Compute CSS scale factor to fit a viewport in a container.
+ * Returns 1 if the target fits, otherwise the smallest scale that fits both dimensions.
+ */
+/**
+ * Determines whether the proxy needs to be synced to the active scenario.
+ * Returns true only when activeScenarioId actually changes — NOT when
+ * allScenarios gets a new array reference from SSE revalidation.
+ */
+export function shouldSyncScenarioToProxy(activeScenarioId, lastSyncedId) {
+    if (!activeScenarioId)
+        return false;
+    return activeScenarioId !== lastSyncedId;
+}
+export function calculatePreviewScale(containerSize, targetSize) {
+    const targetW = targetSize.width;
+    const targetH = targetSize.height ?? 900;
+    const availW = containerSize.width;
+    const availH = containerSize.height;
+    if (targetW <= availW && targetH <= availH)
+        return 1;
+    return Math.min(availW / targetW, availH / targetH);
+}
+//# sourceMappingURL=editorPreview.js.map

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

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

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

@@ -0,0 +1,112 @@
+/**
+ * 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;
+    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,
+                }));
+                activeSeedOperation = { scenarioId, promise: seedPromise };
+                try {
+                    seedResult = await seedPromise;
+                }
+                finally {
+                    if (activeSeedOperation &&
+                        activeSeedOperation.scenarioId === scenarioId) {
+                        activeSeedOperation = null;
+                    }
+                }
+            }
+            else if (!adapterPath) {
+                seedResult = { success: false, error: 'No seed adapter found' };
+            }
+        }
+    }
+    return {
+        success: true,
+        scenarioSlug: effectiveSlug,
+        scenarioId,
+        type: effectiveType,
+        seeded: isSeedScenario,
+        ...(seedResult ? { seedResult } : {}),
+    };
+}
+//# 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":"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"}

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

@@ -0,0 +1,126 @@
+/**
+ * Shared scenario utilities used across editor routes and components.
+ *
+ * Extracted from inline logic in editor.tsx, api.editor-journal-entry.ts,
+ * and api.editor-register-scenario.ts.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Generic Map-based deduplication that keeps the last item for each key.
+ * Items are iterated in order, so later entries overwrite earlier ones.
+ * Map preserves insertion order of first appearance.
+ */
+export function deduplicateByName(items, keyFn) {
+    const byKey = new Map();
+    for (const item of items) {
+        byKey.set(keyFn(item), item);
+    }
+    return [...byKey.values()];
+}
+/**
+ * Convert a scenario name to a URL-safe slug.
+ * Replaces any run of non-alphanumeric, non-underscore characters with a single underscore.
+ */
+export function generateScenarioSlug(name) {
+    return name.replace(/[^a-zA-Z0-9_]+/g, '_');
+}
+/**
+ * Convert an ISO 8601 timestamp (e.g. "2026-02-28T19:00:00.000Z") to
+ * SQLite-compatible format (e.g. "2026-02-28 19:00:00").
+ *
+ * SQLite's CURRENT_TIMESTAMP uses space-separated "YYYY-MM-DD HH:MM:SS" format,
+ * so we need this conversion for date comparisons.
+ */
+export function convertIsoToSqliteTimestamp(iso) {
+    return iso.replace('T', ' ').replace(/\.\d{3}Z$/, '');
+}
+/**
+ * Resolve which URL to use for Playwright screenshot capture.
+ *
+ * Priority:
+ * 1. Path-based URL + proxy → combine (component isolation with API interception)
+ * 2. Full URL → use directly (legacy)
+ * 3. No URL → proxy root or dev server root (page scenarios)
+ */
+/**
+ * Resolve the navigation path for preview refresh.
+ * Priority: explicit path > scenario URL from DB > undefined (plain refresh).
+ */
+export function resolvePreviewNavPath(explicitPath, scenarioUrl) {
+    if (explicitPath)
+        return explicitPath;
+    if (scenarioUrl)
+        return scenarioUrl;
+    return undefined;
+}
+/**
+ * Clear the editor step state file (for starting a new feature).
+ * This should NOT touch the user prompt file — the prompt is captured
+ * by the hook before step 1 runs, so deleting it here would lose it.
+ */
+export function clearEditorState(root) {
+    const statePath = path.join(root, '.codeyam', 'editor-step.json');
+    try {
+        fs.unlinkSync(statePath);
+    }
+    catch {
+        // File doesn't exist, that's fine
+    }
+}
+/**
+ * Clear the user prompt file so the hook can capture the next feature request.
+ * Call this after a feature is committed, not during step 1.
+ */
+export function clearEditorUserPrompt(root) {
+    const promptPath = path.join(root, '.codeyam', 'editor-user-prompt.txt');
+    try {
+        fs.unlinkSync(promptPath);
+    }
+    catch {
+        // File doesn't exist, that's fine
+    }
+}
+export function determineCaptureUrl(url, proxyUrl, devServerUrl) {
+    const isPath = url && url.startsWith('/');
+    if (isPath && proxyUrl) {
+        return `${proxyUrl}${url}`;
+    }
+    else if (url && !isPath) {
+        return url;
+    }
+    else {
+        return proxyUrl || devServerUrl || null;
+    }
+}
+/**
+ * Read the project's default screen size from .codeyam/config.json.
+ * Returns { width, height } or null if not configured.
+ */
+export function readDefaultScreenSize(codeyamRoot) {
+    try {
+        const configPath = path.join(codeyamRoot, '.codeyam', 'config.json');
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        if (config.defaultScreenSize?.width && config.defaultScreenSize?.height) {
+            return {
+                width: config.defaultScreenSize.width,
+                height: config.defaultScreenSize.height,
+            };
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return null;
+}
+/**
+ * Resolve the viewport dimensions for a scenario capture.
+ * Priority: explicit body values > project default > hardcoded fallback (1280×720).
+ */
+export function resolveScenarioViewport(params) {
+    return {
+        width: params.bodyWidth || params.projectDefault?.width || 1280,
+        height: params.bodyHeight || params.projectDefault?.height || 720,
+    };
+}
+//# sourceMappingURL=editorScenarios.js.map

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

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

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

@@ -0,0 +1,173 @@
+/**
+ * Seed adapter runner for application/user scenarios.
+ *
+ * Runs the project's seed-adapter script to wipe and re-seed
+ * the dev database with scenario-specific data.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Run a seed adapter script, passing the seed data JSON file path as the first CLI arg.
+ *
+ * For .ts files, runs via `npx tsx`. For other files, runs directly.
+ * The cwd defaults to the project root (parent of `.codeyam/`) so the adapter
+ * can access node_modules, prisma/, etc.
+ */
+export function runSeedAdapter(scriptPath, seedDataPath, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    // Default cwd: go up from .codeyam/ to project root
+    const cwd = options?.cwd ??
+        (path.basename(path.dirname(scriptPath)) === '.codeyam'
+            ? path.dirname(path.dirname(scriptPath))
+            : path.dirname(scriptPath));
+    return new Promise((resolve) => {
+        const start = Date.now();
+        const isTsFile = scriptPath.endsWith('.ts');
+        const command = isTsFile ? 'npx' : scriptPath;
+        const args = isTsFile ? ['tsx', scriptPath, seedDataPath] : [seedDataPath];
+        const child = spawn(command, args, {
+            cwd,
+            env: { ...process.env },
+        });
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        const timer = setTimeout(() => {
+            killed = true;
+            child.kill('SIGTERM');
+        }, timeoutMs);
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - start;
+            if (killed) {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: `Seed adapter timeout after ${timeoutMs}ms`,
+                    durationMs,
+                });
+            }
+            else if (code === 0) {
+                resolve({ success: true, output: stdout, durationMs });
+            }
+            else {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: stderr || `Seed adapter exited with code ${code}`,
+                    durationMs,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({
+                success: false,
+                output: '',
+                error: err.message,
+                durationMs: Date.now() - start,
+            });
+        });
+    });
+}
+/**
+ * Extract just the seed data from a scenario JSON file and write it to a
+ * temporary file. The adapter receives clean seed data ({drinks: [...]})
+ * without the CodeYam envelope ({type, seed, externalApis}).
+ *
+ * Returns the path to the temp file (caller should clean up after use).
+ */
+export function prepareSeedDataFile(scenarioFilePath) {
+    try {
+        const raw = fs.readFileSync(scenarioFilePath, 'utf-8');
+        const data = JSON.parse(raw);
+        // Extract seed data from envelope, or use as-is if no envelope
+        const seedData = data.seed || data;
+        const tempPath = scenarioFilePath.replace(/\.json$/, '.seed.json');
+        fs.writeFileSync(tempPath, JSON.stringify(seedData, null, 2));
+        return tempPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Clean up a temporary seed data file created by prepareSeedDataFile.
+ */
+export function cleanupSeedDataFile(tempPath) {
+    try {
+        if (fs.existsSync(tempPath)) {
+            fs.unlinkSync(tempPath);
+        }
+    }
+    catch {
+        // Best effort
+    }
+}
+/**
+ * Detect a seed adapter script in the project's .codeyam directory.
+ * Returns the absolute path if found, null otherwise.
+ */
+export function detectSeedAdapter(projectRoot) {
+    const candidates = ['seed-adapter.ts', 'seed-adapter.js'];
+    for (const filename of candidates) {
+        const fullPath = path.join(projectRoot, '.codeyam', filename);
+        try {
+            fs.accessSync(fullPath);
+            return fullPath;
+        }
+        catch {
+            // Try next
+        }
+    }
+    return null;
+}
+/**
+ * Validate that seed data has the expected structure:
+ * a non-empty object where every value is an array of objects (table rows).
+ */
+export function validateSeedData(data) {
+    const errors = [];
+    const keys = Object.keys(data);
+    if (keys.length === 0) {
+        errors.push('Seed data must contain at least one table');
+        return { valid: false, errors };
+    }
+    for (const key of keys) {
+        const value = data[key];
+        if (!Array.isArray(value)) {
+            errors.push(`"${key}" must be an array of objects, got ${typeof value}`);
+            continue;
+        }
+        for (let i = 0; i < value.length; i++) {
+            if (typeof value[i] !== 'object' || value[i] === null) {
+                errors.push(`"${key}[${i}]" must be an object, got ${typeof value[i]}`);
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Merge base scenario seed data with an overlay (user scenario).
+ * Overlay tables replace base tables entirely (no row-level merge).
+ * Does not mutate inputs.
+ */
+export function mergeSeedData(base, overlay) {
+    const result = {};
+    for (const [key, value] of Object.entries(base)) {
+        result[key] = JSON.parse(JSON.stringify(value));
+    }
+    for (const [key, value] of Object.entries(overlay)) {
+        result[key] = JSON.parse(JSON.stringify(value));
+    }
+    return result;
+}
+//# sourceMappingURL=editorSeedAdapter.js.map