@contentful/experience-design-system-cli 2.26.1-dev-build-a852362.0 → 2.26.1-dev-build-f03f014.0

package/dist/src/analyze/select-agent/context-builder.js

@@ -1,197 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-const SCANNED_FILE_EXTENSIONS = new Set(['.astro', '.js', '.jsx', '.svelte', '.ts', '.tsx', '.vue']);
-const IMPORT_PATTERN = /import\s+(?:type\s+)?(.+?)\s+from\s+['"]([^'"]+)['"]/g;
-const EXPORT_NAMED_PATTERN = /export\s+(?:const|function|class|type|interface|enum)\s+([A-Za-z0-9_]+)/g;
-const EXPORT_DEFAULT_PATTERN = /export\s+default\s+([A-Za-z0-9_]+)/g;
-const EXPORT_LIST_PATTERN = /export\s*\{([^}]+)\}/g;
-const RESOLVER_HINT_PATTERN = /(resolver|registry|componentmap|component-map|componentresolver|resolvecomponent)/i;
-const MAX_COMPONENT_SOURCE_CHARS = 8_000;
-const MAX_SIBLING_FILES = 5;
-const MAX_SIBLING_SNIPPET_CHARS = 1_200;
-const MAX_REFERENCE_SNIPPETS = 3;
-const MAX_REFERENCE_CHARS = 800;
-function truncateText(text, maxChars) {
-    if (text.length <= maxChars)
-        return text;
-    return text.slice(0, maxChars) + '\n/* truncated */';
-}
-function isWithinRoot(path, root) {
-    const relativePath = relative(root, path);
-    return relativePath !== '..' && !relativePath.startsWith(`..${sep}`) && !isAbsolute(relativePath);
-}
-function parseImportedNames(importClause) {
-    const names = [];
-    const parts = importClause.split(',').map((part) => part.trim());
-    for (const part of parts) {
-        if (!part)
-            continue;
-        if (part.startsWith('{') && part.endsWith('}')) {
-            for (const named of part
-                .slice(1, -1)
-                .split(',')
-                .map((item) => item.trim())
-                .filter(Boolean)) {
-                const [local] = named.split(/\s+as\s+/i);
-                if (local)
-                    names.push(local.trim());
-            }
-            continue;
-        }
-        const [local] = part.split(/\s+as\s+/i);
-        if (local)
-            names.push(local.trim());
-    }
-    return [...new Set(names)];
-}
-function resolveLocalImportPath(source, componentDirectory, root, filePaths) {
-    const basePath = resolve(componentDirectory, source);
-    const candidates = [
-        basePath,
-        ...[...SCANNED_FILE_EXTENSIONS].map((extension) => `${basePath}${extension}`),
-        ...[...SCANNED_FILE_EXTENSIONS].map((extension) => join(basePath, `index${extension}`)),
-    ];
-    for (const candidate of candidates) {
-        if (filePaths.has(candidate) && isWithinRoot(candidate, root)) {
-            return relative(root, candidate);
-        }
-    }
-    if (isWithinRoot(basePath, root)) {
-        return relative(root, basePath);
-    }
-    return undefined;
-}
-function parseImports(sourceText, componentDirectory, root, filePaths) {
-    const imports = [];
-    for (const match of sourceText.matchAll(IMPORT_PATTERN)) {
-        const importClause = match[1]?.trim() ?? '';
-        const source = match[2]?.trim() ?? '';
-        const local = source.startsWith('.');
-        const names = parseImportedNames(importClause);
-        const record = { source, names, local };
-        if (local) {
-            record.resolvedPath = resolveLocalImportPath(source, componentDirectory, root, filePaths);
-        }
-        imports.push(record);
-    }
-    return imports;
-}
-function parseExports(sourceText) {
-    const exports = new Set();
-    for (const match of sourceText.matchAll(EXPORT_NAMED_PATTERN)) {
-        if (match[1])
-            exports.add(match[1]);
-    }
-    for (const match of sourceText.matchAll(EXPORT_DEFAULT_PATTERN)) {
-        if (match[1])
-            exports.add(`default:${match[1]}`);
-    }
-    for (const match of sourceText.matchAll(EXPORT_LIST_PATTERN)) {
-        const items = match[1]
-            ?.split(',')
-            .map((item) => item.trim())
-            .filter(Boolean) ?? [];
-        for (const item of items)
-            exports.add(item);
-    }
-    return [...exports];
-}
-function extractSnippet(text, token, maxChars) {
-    const index = text.indexOf(token);
-    if (index === -1)
-        return truncateText(text, maxChars);
-    const start = Math.max(0, text.lastIndexOf('\n', Math.max(0, index - Math.floor(maxChars / 2))) + 1);
-    const endBoundary = text.indexOf('\n', index + Math.floor(maxChars / 2));
-    const end = endBoundary === -1 ? text.length : endBoundary;
-    return truncateText(text.slice(start, end).trim(), maxChars);
-}
-function summarizeSiblingFiles(root, files, currentFile) {
-    return files
-        .filter((file) => file.absolutePath !== currentFile)
-        .slice(0, MAX_SIBLING_FILES)
-        .map((file) => ({
-        path: relative(root, file.absolutePath),
-        exports: parseExports(file.text),
-        codeSnippet: truncateText(file.text, MAX_SIBLING_SNIPPET_CHARS),
-    }));
-}
-function findResolverReferences(root, files, componentName, currentFile) {
-    return files
-        .filter((file) => file.absolutePath !== currentFile)
-        .filter((file) => file.text.includes(componentName))
-        .filter((file) => RESOLVER_HINT_PATTERN.test(file.absolutePath) || RESOLVER_HINT_PATTERN.test(file.text))
-        .slice(0, MAX_REFERENCE_SNIPPETS)
-        .map((file) => ({
-        path: relative(root, file.absolutePath),
-        snippet: extractSnippet(file.text, componentName, MAX_REFERENCE_CHARS),
-    }));
-}
-function findParentUsageSite(root, files, componentName, currentFile) {
-    const usagePattern = new RegExp(`<${componentName}\\b|\\b${componentName}\\s*[),}]|\\b${componentName}\\s*:`);
-    const candidates = files.filter((file) => file.absolutePath !== currentFile &&
-        usagePattern.test(file.text) &&
-        !file.text.startsWith('// stub') &&
-        !RESOLVER_HINT_PATTERN.test(file.absolutePath) &&
-        !RESOLVER_HINT_PATTERN.test(file.text));
-    const match = candidates[0];
-    if (!match)
-        return undefined;
-    return {
-        path: relative(root, match.absolutePath),
-        snippet: extractSnippet(match.text, componentName, MAX_REFERENCE_CHARS),
-    };
-}
-export async function buildRepoContextIndex(root, filePaths) {
-    if (filePaths.length === 0)
-        return null;
-    const resolvedRoot = resolve(root);
-    const files = await Promise.all(filePaths.map(async (absolutePath) => ({
-        absolutePath,
-        relativePath: relative(resolvedRoot, absolutePath),
-        directory: dirname(absolutePath),
-        text: await readFile(absolutePath, 'utf8').catch(() => ''),
-    })));
-    const byDirectory = new Map();
-    for (const file of files) {
-        const bucket = byDirectory.get(file.directory) ?? [];
-        bucket.push(file);
-        byDirectory.set(file.directory, bucket);
-    }
-    return {
-        root: resolvedRoot,
-        files,
-        byDirectory,
-        filePaths: new Set(files.map((file) => file.absolutePath)),
-    };
-}
-export function buildSelectionContext(index, component) {
-    const absolutePath = isAbsolute(component.source) ? component.source : resolve(index.root, component.source);
-    if (!isWithinRoot(absolutePath, index.root))
-        return undefined;
-    const componentFile = index.files.find((file) => file.absolutePath === absolutePath);
-    if (!componentFile)
-        return undefined;
-    const siblings = index.byDirectory.get(componentFile.directory) ?? [];
-    return {
-        boundaryRoot: index.root,
-        componentFile: {
-            path: componentFile.relativePath,
-            code: truncateText(componentFile.text, MAX_COMPONENT_SOURCE_CHARS),
-        },
-        imports: parseImports(componentFile.text, componentFile.directory, index.root, index.filePaths),
-        exports: parseExports(componentFile.text),
-        siblingFiles: summarizeSiblingFiles(index.root, siblings, componentFile.absolutePath),
-        resolverReferences: findResolverReferences(index.root, index.files, component.name, componentFile.absolutePath),
-        parentUsageSite: findParentUsageSite(index.root, index.files, component.name, componentFile.absolutePath),
-    };
-}
-export function summarizeSelectionContext(context) {
-    if (!context)
-        return undefined;
-    return {
-        boundaryRoot: context.boundaryRoot,
-        siblingFileCount: context.siblingFiles.length,
-        resolverReferenceCount: context.resolverReferences.length,
-        hasParentUsageSite: Boolean(context.parentUsageSite),
-    };
-}

package/dist/src/analyze/select-agent/show-rationale.js

@@ -1,92 +0,0 @@
-import { openPipelineDb, findLatestSessionForCommand } from '../../session/db.js';
-const REQUIRED_COLUMNS = ['status', 'reject_reason'];
-function assertSchema(dbPath) {
-    const db = openPipelineDb(dbPath);
-    try {
-        const cols = db.prepare('PRAGMA table_info(raw_components)').all();
-        const have = new Set(cols.map((c) => c.name));
-        const missing = REQUIRED_COLUMNS.filter((c) => !have.has(c));
-        if (missing.length > 0) {
-            throw new Error(`Rationale data missing — run a fresh 'experiences import' on this session first. ` +
-                `(raw_components is missing column(s): ${missing.join(', ')})`);
-        }
-    }
-    finally {
-        db.close();
-    }
-}
-/**
- * Resolves which session to read from. If `sessionFlag` is provided, asserts
- * the session exists and has at least one raw component; otherwise falls back
- * to the most recent completed `analyze select` step.
- */
-export function resolveRationaleSession(sessionFlag, dbPath) {
-    const db = openPipelineDb(dbPath);
-    try {
-        if (sessionFlag) {
-            const row = db.prepare('SELECT 1 AS ok FROM raw_components WHERE session_id = ? LIMIT 1').get(sessionFlag);
-            if (!row) {
-                throw new Error(`Session not found or has no components: '${sessionFlag}'. ` +
-                    `Run 'analyze extract' + 'analyze select-agent' on this session first.`);
-            }
-            return sessionFlag;
-        }
-        const latest = findLatestSessionForCommand(db, 'analyze select');
-        if (!latest) {
-            throw new Error(`No completed 'analyze select' session found. Run 'analyze select-agent' first, or pass --session <id>.`);
-        }
-        return latest;
-    }
-    finally {
-        db.close();
-    }
-}
-export function loadRationaleRows(sessionId, dbPath) {
-    const db = openPipelineDb(dbPath);
-    try {
-        const rows = db
-            .prepare(`SELECT name, status, reject_reason FROM raw_components
-         WHERE session_id = ?
-         ORDER BY name`)
-            .all(sessionId);
-        return rows.map((r) => ({
-            name: r.name,
-            decision: r.status ?? 'extracted',
-            reason: r.reject_reason,
-        }));
-    }
-    finally {
-        db.close();
-    }
-}
-export function formatRationaleTable(rows) {
-    if (rows.length === 0) {
-        return 'No rationale rows found for this session.\n';
-    }
-    const header = { name: 'Component', decision: 'Decision', reason: 'Reason' };
-    const all = [header, ...rows.map((r) => ({ name: r.name, decision: r.decision, reason: r.reason ?? '' }))];
-    const nameWidth = Math.max(...all.map((r) => r.name.length));
-    const decisionWidth = Math.max(...all.map((r) => r.decision.length));
-    const lines = [];
-    const fmt = (n, d, r) => `${n.padEnd(nameWidth)}  ${d.padEnd(decisionWidth)}  ${r}`;
-    lines.push(fmt(header.name, header.decision, header.reason));
-    lines.push(fmt('-'.repeat(nameWidth), '-'.repeat(decisionWidth), '-'.repeat(Math.max(6, header.reason.length))));
-    for (const row of rows) {
-        lines.push(fmt(row.name, row.decision, row.reason ?? ''));
-    }
-    return lines.join('\n') + '\n';
-}
-export function formatRationaleJson(rows) {
-    return (JSON.stringify(rows.map((r) => ({ name: r.name, decision: r.decision, reason: r.reason })), null, 2) + '\n');
-}
-/**
- * Top-level dispatch for `analyze select-agent --show-rationale`. Pure I/O
- * boundary: reads DB, writes formatted output to stdout, throws on error.
- */
-export function runShowRationale(opts) {
-    assertSchema(opts.dbPath);
-    const sessionId = resolveRationaleSession(opts.session, opts.dbPath);
-    const rows = loadRationaleRows(sessionId, opts.dbPath);
-    const output = opts.json ? formatRationaleJson(rows) : formatRationaleTable(rows);
-    process.stdout.write(output);
-}

package/dist/src/analyze/selection-cascade.js

@@ -1,19 +0,0 @@
-import { computeClosure } from './composite-closure.js';
-import { findAllAncestors } from './lineage.js';
-export function computeRejectCascade(target, components) {
-    const out = new Set();
-    out.add(target);
-    for (const ancestor of findAllAncestors(target, components)) {
-        out.add(ancestor);
-    }
-    return out;
-}
-export function computeAcceptCascade(target, components) {
-    const out = new Set();
-    out.add(target);
-    const closure = computeClosure(target, components);
-    for (const node of closure.nodes) {
-        out.add(node.name);
-    }
-    return out;
-}

package/dist/src/analyze/slot-graph.js

@@ -1,17 +0,0 @@
-const REJECTED_STATUSES = new Set(['error', 'rejected']);
-export function buildComponentGraph(components, opts) {
-    const stripRejectedEdges = opts?.stripRejectedEdges === true;
-    return components.map((row) => {
-        if (stripRejectedEdges && row.status !== undefined && REJECTED_STATUSES.has(row.status)) {
-            return { name: row.key, slots: [] };
-        }
-        const slotDefs = row.entry.$slots ?? {};
-        const slots = Object.entries(slotDefs).map(([slotName, slotDef]) => ({
-            name: slotName,
-            allowedComponents: Array.isArray(slotDef?.$allowedComponents)
-                ? slotDef.$allowedComponents.filter((v) => typeof v === 'string')
-                : [],
-        }));
-        return { name: row.key, slots };
-    });
-}

package/dist/src/analyze/tui/AnalyzeView.js

@@ -1,64 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Box, Text, useStdout } from 'ink';
-import { TopBar } from '../select/tui/components/TopBar.js';
-import { useImmediateInput } from '../select/tui/hooks/useImmediateInput.js';
-function truncateName(name, maxLen = 30) {
-    if (name.length <= maxLen)
-        return name;
-    return name.slice(0, maxLen - 1) + '…';
-}
-export function AnalyzeView({ result, onExit }) {
-    const [scrollOffset, setScrollOffset] = useState(0);
-    const { stdout } = useStdout();
-    // Header lines: TopBar(1) + summary(3) + blank(1) + dividers+header(3) + blank(1) + footer(1) + footer-bar(1) = ~12
-    const HEADER_ROWS = 12;
-    const terminalRows = stdout?.rows ?? 24;
-    const visibleCount = Math.max(1, terminalRows - HEADER_ROWS);
-    const maxOffset = Math.max(0, result.components.length - visibleCount);
-    useImmediateInput((input, key) => {
-        if (input === 'q' || key.return) {
-            onExit();
-            return;
-        }
-        if (key.upArrow || input === 'k') {
-            setScrollOffset((o) => Math.max(0, o - 1));
-        }
-        else if (key.downArrow || input === 'j') {
-            setScrollOffset((o) => Math.min(maxOffset, o + 1));
-        }
-        else if (input === 'g') {
-            setScrollOffset(0);
-        }
-        else if (input === 'G') {
-            setScrollOffset(maxOffset);
-        }
-    });
-    const visible = result.components.slice(scrollOffset, scrollOffset + visibleCount);
-    const showScrollUp = scrollOffset > 0;
-    const showScrollDown = scrollOffset + visibleCount < result.components.length;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(TopBar, { subcommand: "analyze", hints: [
-                    { key: '?', label: 'help' },
-                    { key: 'q', label: 'quit' },
-                ] }), _jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Text, { children: 'Scanned ' + result.fileCount + ' source files in ' + result.sourceDirectory }), _jsx(Text, { children: 'Extracted ' + result.components.length + ' components' }), _jsx(Text, { dimColor: true, children: 'Session: ' + result.sessionId }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, children: 'Components' +
-                            (showScrollUp || showScrollDown
-                                ? '  (' +
-                                    (scrollOffset + 1) +
-                                    '–' +
-                                    Math.min(scrollOffset + visibleCount, result.components.length) +
-                                    ' of ' +
-                                    result.components.length +
-                                    ')'
-                                : '') }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), showScrollUp && _jsx(Text, { dimColor: true, children: " \u25B2 scroll up" }), visible.map((component) => {
-                        const conf = component.extractionConfidence;
-                        const confColor = conf === null ? 'gray' : component.needsReview ? 'red' : conf >= 4 ? 'white' : conf >= 3 ? 'yellow' : 'red';
-                        const confLabel = conf === null ? '—' : (component.needsReview ? '⚑ ' : '') + String(conf);
-                        return (_jsxs(Box, { children: [component.errors.length > 0 && _jsx(Text, { color: "red", children: "\u2717 " }), component.errors.length === 0 && component.warnings.length > 0 && _jsx(Text, { color: "yellow", children: "\u26A0 " }), component.errors.length === 0 && component.warnings.length === 0 && _jsx(Text, { children: " " }), _jsx(Text, { children: truncateName(component.name).padEnd(20) }), _jsx(Text, { dimColor: true, children: component.framework.padEnd(10) }), _jsx(Text, { children: (component.propCount + ' props').padEnd(10) }), _jsx(Text, { children: (component.slotCount + ' ' + (component.slotCount === 1 ? 'slot' : 'slots')).padEnd(8) }), _jsx(Text, { color: confColor, children: confLabel }), component.errors.length > 0 && (_jsx(Text, { color: "red", children: '  ✗ ' + component.errors.length + ' error' + (component.errors.length === 1 ? '' : 's') })), component.errors.length === 0 && component.warnings.length > 0 && (_jsx(Text, { color: "yellow", children: '  ⚠ ' + component.warnings.length + ' warning' + (component.warnings.length === 1 ? '' : 's') }))] }, component.name));
-                    }), showScrollDown && _jsx(Text, { dimColor: true, children: " \u25BC scroll down" }), result.totalErrors > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, color: "red", children: 'Errors (' + result.totalErrors + ')' }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), result.components
-                                .filter((c) => c.errors.length > 0)
-                                .flatMap((c) => c.errors.map((e) => ({ component: c.name, error: e })))
-                                .map((e, i) => (_jsx(Text, { color: "red", children: '  ✗ ' + e.component + ': ' + e.error }, i)))] })), result.totalWarnings > 0 && (_jsxs(_Fragment, { children: [_jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { bold: true, color: "yellow", children: 'Warnings (' + result.totalWarnings + ')' }), _jsx(Text, { dimColor: true, children: '─'.repeat(70) }), _jsx(Text, { children: " " }), (result.globalWarnings ?? []).map((w, i) => (_jsx(Text, { color: "yellow", children: '  ⚠ ' + w }, `g${i}`))), result.components
-                                .filter((c) => c.warnings.length > 0)
-                                .flatMap((c) => c.warnings.map((w) => ({ component: c.name, warning: w })))
-                                .map((w, i) => (_jsx(Text, { color: "yellow", children: '  ⚠ ' + (w.warning.startsWith(w.component + ': ') ? w.warning : w.component + ': ' + w.warning) }, `c${i}`)))] })), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: 'Run: analyze select --session ' + result.sessionId }), _jsx(Text, { children: " " })] }), _jsx(Box, { borderStyle: "single", paddingX: 1, children: _jsx(Text, { dimColor: true, children: "Press Enter or q to exit" }) })] }));
-}