@codeyam/codeyam-cli 0.1.0-staging.a890816 → 0.1.0-staging.ad88eeb

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

@@ -0,0 +1,81 @@
+/**
+ * Filter glossary entries to extract library functions (non-visual entries with test files).
+ */
+export function filterGlossaryFunctions(entries) {
+    return entries
+        .filter((g) => g.testFile &&
+        g.returnType !== 'JSX.Element' &&
+        g.returnType !== 'React.ReactNode')
+        .map((g) => ({
+        name: g.name,
+        filePath: g.filePath,
+        description: g.description || '',
+        testFile: g.testFile,
+        feature: g.feature,
+    }));
+}
+/**
+ * Determine whether a scenario is "complete" based on entity type.
+ * Library entities are complete when they have an executionResult.
+ * Visual entities are complete when they have a screenshot that wasn't skipped.
+ */
+export function isScenarioComplete(scenario, isLibrary) {
+    if (isLibrary)
+        return !!scenario.metadata?.executionResult;
+    return (!!scenario.metadata?.screenshotPaths?.[0] &&
+        !scenario.metadata?.noScreenshotSaved &&
+        !scenario.metadata?.sameAsDefault);
+}
+/**
+ * Map raw Entity objects (with analyses) to the AnalyzedEntityData shape
+ * consumed by the editor UI.
+ */
+export function mapEntitiesToAnalyzedData(entities, glossaryEntries) {
+    return entities
+        .filter((entity) => entity.analyses && entity.analyses.length > 0)
+        .map((entity) => {
+        const analysis = entity.analyses[0];
+        const allScenarios = analysis.scenarios || [];
+        const isAnalyzing = !analysis.status?.finishedAt;
+        const entityType = entity.entityType || 'visual';
+        const isLibrary = entityType === 'library' || entityType === 'functionCall';
+        const completedScenarios = allScenarios.filter((s) => isScenarioComplete(s, isLibrary));
+        const pendingScenarios = allScenarios.filter((s) => !isScenarioComplete(s, isLibrary));
+        const glossaryEntry = glossaryEntries.find((g) => g.filePath === (entity.filePath || ''));
+        return {
+            sha: entity.sha,
+            name: entity.name,
+            entityType,
+            filePath: entity.filePath || '',
+            analysisId: analysis.id,
+            isAnalyzing,
+            scenarioCount: allScenarios.length,
+            scenarios: completedScenarios.map((s) => ({
+                id: s.id,
+                name: s.name,
+                description: s.description || '',
+                screenshotPath: s.metadata?.screenshotPaths?.[0] || null,
+            })),
+            pendingScenarios: pendingScenarios.map((s) => s.name),
+            testFile: glossaryEntry?.testFile,
+        };
+    });
+}
+/**
+ * Build an import graph from entity metadata, filtered to only include
+ * names that exist in the known set of entities/components/functions.
+ */
+export function buildEntityImportGraph(entitiesWithMetadata, knownEntityNames) {
+    const entityImports = {};
+    for (const entity of entitiesWithMetadata) {
+        const importedExports = entity.metadata?.importedExports || [];
+        const importedNames = importedExports
+            .map((ie) => ie.name)
+            .filter((name) => knownEntityNames.has(name));
+        if (importedNames.length > 0) {
+            entityImports[entity.name] = importedNames;
+        }
+    }
+    return entityImports;
+}
+//# sourceMappingURL=editorLoaderHelpers.js.map

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

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

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

@@ -0,0 +1,248 @@
+/**
+ * Stateful mock state manager for the editor proxy.
+ *
+ * Provides method-aware, stateful mock matching for the editor proxy.
+ * Supports legacy key-based format, route-keyed format, method-prefixed routes,
+ * parameterized routes, and mutable state for CRUD operations.
+ */
+import crypto from 'crypto';
+function hashData(data) {
+    return crypto.createHash('sha256').update(JSON.stringify(data)).digest('hex');
+}
+/**
+ * Parse a route key like "POST /api/drinks/:id" into method, path pattern, and regex.
+ */
+function parseRouteKey(key) {
+    const methodMatch = key.match(/^(GET|POST|PUT|DELETE|PATCH)\s+(\/\S+)$/);
+    if (methodMatch) {
+        return { method: methodMatch[1], pathPattern: methodMatch[2] };
+    }
+    // Path-only — treat as GET
+    return { method: null, pathPattern: key };
+}
+/**
+ * Build a regex and extract param names from a path pattern like /api/drinks/:id.
+ */
+function buildPathRegex(pattern) {
+    const paramNames = [];
+    const regexStr = pattern.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp(`^${regexStr}$`), paramNames };
+}
+/**
+ * Find the state path that corresponds to a given pathname.
+ * For "/api/drinks/1", checks if "/api/drinks" is a state key.
+ */
+function findStateBasePath(pathname, stateKeys) {
+    // Exact match first
+    if (stateKeys.includes(pathname))
+        return pathname;
+    // Try parent path (e.g., /api/drinks/1 → /api/drinks)
+    const lastSlash = pathname.lastIndexOf('/');
+    if (lastSlash > 0) {
+        const parent = pathname.substring(0, lastSlash);
+        if (stateKeys.includes(parent))
+            return parent;
+    }
+    return null;
+}
+export function createMockStateManager() {
+    let routes = [];
+    let mutableState = {};
+    let initialStateSnapshot = null;
+    let scenarioHash = null;
+    let hasState = false;
+    let scenarioData = null;
+    function parseRoutes(data) {
+        const parsed = [];
+        const routesObj = data.routes;
+        if (routesObj && typeof routesObj === 'object') {
+            for (const [key, value] of Object.entries(routesObj)) {
+                const { method, pathPattern } = parseRouteKey(key);
+                const { regex, paramNames } = buildPathRegex(pathPattern);
+                const entry = typeof value === 'object' && value !== null
+                    ? value
+                    : { body: value };
+                parsed.push({
+                    method,
+                    pathPattern,
+                    pathRegex: regex,
+                    paramNames,
+                    response: {
+                        body: entry.body,
+                        status: typeof entry.status === 'number' ? entry.status : 200,
+                    },
+                });
+            }
+        }
+        return parsed;
+    }
+    function initializeState(data) {
+        const stateObj = data.state;
+        if (stateObj && typeof stateObj === 'object') {
+            hasState = true;
+            mutableState = {};
+            for (const [key, value] of Object.entries(stateObj)) {
+                mutableState[key] = Array.isArray(value)
+                    ? JSON.parse(JSON.stringify(value))
+                    : [];
+            }
+            initialStateSnapshot = JSON.stringify(stateObj);
+        }
+        else {
+            hasState = false;
+            mutableState = {};
+            initialStateSnapshot = null;
+        }
+    }
+    return {
+        loadScenario(data) {
+            const newHash = hashData(data);
+            // Smart reload: if same data, preserve mutations
+            if (scenarioHash && newHash === scenarioHash) {
+                return;
+            }
+            scenarioHash = newHash;
+            scenarioData = data;
+            routes = parseRoutes(data);
+            initializeState(data);
+        },
+        matchRequest(method, pathname, body) {
+            if (!scenarioData && routes.length === 0 && !hasState) {
+                return null;
+            }
+            const stateKeys = Object.keys(mutableState);
+            // --- Stateful matching ---
+            if (hasState) {
+                const stateBasePath = findStateBasePath(pathname, stateKeys);
+                if (stateBasePath && method === 'GET' && stateBasePath === pathname) {
+                    // Return mutable state array
+                    return { body: mutableState[stateBasePath], status: 200 };
+                }
+                // For mutations, find a matching route first, then apply state changes
+                if (stateBasePath) {
+                    const matchedRoute = matchRoute(method, pathname);
+                    if (method === 'POST' && stateBasePath === pathname && matchedRoute) {
+                        const arr = mutableState[stateBasePath];
+                        const newItem = typeof body === 'object' && body !== null
+                            ? { ...body }
+                            : {};
+                        if (!('id' in newItem)) {
+                            const maxId = arr.reduce((max, item) => {
+                                const id = typeof item.id === 'number' ? item.id : 0;
+                                return Math.max(max, id);
+                            }, 0);
+                            newItem.id = maxId + 1;
+                        }
+                        arr.push(newItem);
+                        return {
+                            body: newItem,
+                            status: matchedRoute.response.status,
+                        };
+                    }
+                    if (method === 'DELETE' && matchedRoute && matchedRoute.params) {
+                        const idParam = matchedRoute.params.id;
+                        const arr = mutableState[stateBasePath];
+                        const idx = arr.findIndex((item) => String(item.id) === String(idParam));
+                        if (idx === -1) {
+                            return { body: { error: 'Not found' }, status: 404 };
+                        }
+                        arr.splice(idx, 1);
+                        return { body: null, status: matchedRoute.response.status };
+                    }
+                    if (method === 'PUT' && matchedRoute && matchedRoute.params) {
+                        const idParam = matchedRoute.params.id;
+                        const arr = mutableState[stateBasePath];
+                        const idx = arr.findIndex((item) => String(item.id) === String(idParam));
+                        if (idx === -1) {
+                            return { body: { error: 'Not found' }, status: 404 };
+                        }
+                        const replacement = typeof body === 'object' && body !== null
+                            ? { ...body }
+                            : arr[idx];
+                        arr[idx] = replacement;
+                        return { body: replacement, status: matchedRoute.response.status };
+                    }
+                }
+            }
+            // --- Non-stateful route matching ---
+            const matched = matchRoute(method, pathname);
+            if (matched) {
+                return {
+                    body: matched.response.body ?? null,
+                    status: matched.response.status,
+                    params: matched.params,
+                };
+            }
+            // --- Legacy format ---
+            if (scenarioData && method === 'GET') {
+                const apiMatch = pathname.match(/^\/api\/(.+)$/);
+                if (apiMatch) {
+                    const key = apiMatch[1];
+                    if (key in scenarioData && key !== 'routes' && key !== 'state') {
+                        return { body: scenarioData[key], status: 200 };
+                    }
+                }
+            }
+            return null;
+        },
+        resetState() {
+            if (initialStateSnapshot) {
+                const restored = JSON.parse(initialStateSnapshot);
+                mutableState = {};
+                for (const [key, value] of Object.entries(restored)) {
+                    mutableState[key] = Array.isArray(value)
+                        ? JSON.parse(JSON.stringify(value))
+                        : [];
+                }
+            }
+        },
+        getState() {
+            return { ...mutableState };
+        },
+    };
+    function matchRoute(method, pathname) {
+        // Priority 1: Exact method-prefixed match
+        for (const route of routes) {
+            if (route.method !== null &&
+                route.method === method &&
+                route.paramNames.length === 0) {
+                const match = route.pathRegex.exec(pathname);
+                if (match) {
+                    return { response: route.response };
+                }
+            }
+        }
+        // Priority 2: Method-less (GET only)
+        if (method === 'GET') {
+            for (const route of routes) {
+                if (route.method === null && route.paramNames.length === 0) {
+                    const match = route.pathRegex.exec(pathname);
+                    if (match) {
+                        return { response: route.response };
+                    }
+                }
+            }
+        }
+        // Priority 3: Parameterized routes
+        for (const route of routes) {
+            if (route.paramNames.length > 0) {
+                const expectedMethod = route.method ?? 'GET';
+                if (expectedMethod !== method)
+                    continue;
+                const match = route.pathRegex.exec(pathname);
+                if (match) {
+                    const params = {};
+                    for (let i = 0; i < route.paramNames.length; i++) {
+                        params[route.paramNames[i]] = match[i + 1];
+                    }
+                    return { response: route.response, params };
+                }
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=editorMockState.js.map

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

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

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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"}