synarcx 0.1.0

package/dist/core/workspace/openers.d.ts

@@ -0,0 +1,21 @@
+import { WorkspacePreferredOpener, WorkspaceSupportedOpenerValue } from './foundation.js';
+export interface WorkspaceOpenerChoice {
+    value: WorkspaceSupportedOpenerValue;
+    label: string;
+    opener: WorkspacePreferredOpener;
+    executable: string;
+    available: boolean;
+    unavailableNote: string | null;
+}
+export declare function isWorkspaceExecutableAvailable(executable: string, options?: {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}): boolean;
+export declare function getWorkspaceOpenerExecutable(opener: WorkspacePreferredOpener): string;
+export declare function getWorkspaceOpenerLabel(opener: WorkspacePreferredOpener): string;
+export declare function listWorkspaceOpenerChoices(options?: {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+}): WorkspaceOpenerChoice[];
+export declare function getDefaultWorkspaceOpenerChoiceValue(choices: WorkspaceOpenerChoice[]): WorkspaceSupportedOpenerValue;
+//# sourceMappingURL=openers.d.ts.map

package/dist/core/workspace/openers.js

@@ -0,0 +1,119 @@
+import * as nodeFs from 'node:fs';
+import * as path from 'node:path';
+import { parseWorkspacePreferredOpenerValue, } from './foundation.js';
+const fs = nodeFs;
+const WORKSPACE_OPENER_CHOICE_DEFINITIONS = [
+    {
+        value: 'editor',
+        label: 'VS Code editor',
+        executable: 'code',
+    },
+    {
+        value: 'codex',
+        label: 'Codex',
+        executable: 'codex',
+    },
+    {
+        value: 'claude',
+        label: 'Claude',
+        executable: 'claude',
+    },
+    {
+        value: 'github-copilot',
+        label: 'GitHub Copilot in VS Code',
+        executable: 'code',
+    },
+];
+function getPathValue(env) {
+    return env.PATH ?? env.Path ?? env.path ?? '';
+}
+function getPathExts(env, platform) {
+    if (platform !== 'win32') {
+        return [''];
+    }
+    const pathExt = env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD';
+    return pathExt
+        .split(';')
+        .map((extension) => extension.trim())
+        .filter((extension) => extension.length > 0);
+}
+function isExecutableFile(candidatePath, platform) {
+    try {
+        const stats = fs.statSync(candidatePath);
+        if (!stats.isFile()) {
+            return false;
+        }
+        if (platform === 'win32') {
+            return true;
+        }
+        fs.accessSync(candidatePath, fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isWorkspaceExecutableAvailable(executable, options = {}) {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? process.platform;
+    if (executable.includes('/') || executable.includes('\\')) {
+        return isExecutableFile(executable, platform);
+    }
+    const pathEntries = getPathValue(env)
+        .split(path.delimiter)
+        .filter((entry) => entry.length > 0);
+    const pathExts = getPathExts(env, platform);
+    for (const entry of pathEntries) {
+        for (const extension of pathExts) {
+            const candidate = path.join(entry, executable + extension);
+            if (isExecutableFile(candidate, platform)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function getWorkspaceOpenerExecutable(opener) {
+    if (opener.kind === 'editor') {
+        return 'code';
+    }
+    if (opener.id === 'github-copilot') {
+        return 'code';
+    }
+    return opener.id;
+}
+export function getWorkspaceOpenerLabel(opener) {
+    if (opener.kind === 'editor') {
+        return 'VS Code editor';
+    }
+    if (opener.id === 'github-copilot') {
+        return 'GitHub Copilot in VS Code';
+    }
+    if (opener.id === 'codex') {
+        return 'Codex';
+    }
+    return 'Claude';
+}
+export function listWorkspaceOpenerChoices(options = {}) {
+    const choices = WORKSPACE_OPENER_CHOICE_DEFINITIONS.map((definition) => {
+        const available = isWorkspaceExecutableAvailable(definition.executable, options);
+        return {
+            value: definition.value,
+            label: definition.label,
+            opener: parseWorkspacePreferredOpenerValue(definition.value),
+            executable: definition.executable,
+            available,
+            unavailableNote: available ? null : `${definition.executable} not found on PATH`,
+        };
+    });
+    return choices.sort((a, b) => {
+        if (a.available !== b.available) {
+            return a.available ? -1 : 1;
+        }
+        return 0;
+    });
+}
+export function getDefaultWorkspaceOpenerChoiceValue(choices) {
+    return choices.find((choice) => choice.available)?.value ?? 'editor';
+}
+//# sourceMappingURL=openers.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cli/index.js';
+export * from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './cli/index.js';
+export * from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/searchable-multi-select.d.ts

@@ -0,0 +1,28 @@
+interface Choice {
+    name: string;
+    value: string;
+    description?: string;
+    configured?: boolean;
+    detected?: boolean;
+    configuredLabel?: string;
+    preSelected?: boolean;
+}
+interface Config {
+    message: string;
+    choices: Choice[];
+    pageSize?: number;
+    validate?: (selected: string[]) => boolean | string;
+}
+/**
+ * A searchable multi-select prompt with visible search box,
+ * selected items display, and intuitive keyboard navigation.
+ *
+ * - Type to filter choices
+ * - ↑↓ to navigate
+ * - Space to toggle highlighted item selection
+ * - Backspace to remove last selected item (or delete search char)
+ * - Enter to confirm selections
+ */
+export declare function searchableMultiSelect(config: Config): Promise<string[]>;
+export default searchableMultiSelect;
+//# sourceMappingURL=searchable-multi-select.d.ts.map

package/dist/prompts/searchable-multi-select.js

@@ -0,0 +1,159 @@
+import chalk from 'chalk';
+/**
+ * Create the searchable multi-select prompt.
+ * Uses dynamic import to prevent pre-commit hook hangs (see #367).
+ */
+async function createSearchableMultiSelect() {
+    const { createPrompt, useState, useKeypress, useMemo, usePrefix, isEnterKey, isBackspaceKey, isUpKey, isDownKey, } = await import('@inquirer/core');
+    return createPrompt((config, done) => {
+        const { message, choices, pageSize = 15, validate } = config;
+        const [searchText, setSearchText] = useState('');
+        const [selectedValues, setSelectedValues] = useState(() => choices.filter(c => c.preSelected).map(c => c.value));
+        const [cursor, setCursor] = useState(0);
+        const [status, setStatus] = useState('idle');
+        const [error, setError] = useState(null);
+        const prefix = usePrefix({ status });
+        // Filter choices by search
+        const filteredChoices = useMemo(() => {
+            if (!searchText.trim())
+                return choices;
+            const term = searchText.toLowerCase();
+            return choices.filter((c) => c.name.toLowerCase().includes(term) ||
+                c.value.toLowerCase().includes(term));
+        }, [searchText, choices]);
+        const selectedSet = useMemo(() => new Set(selectedValues), [selectedValues]);
+        const choiceMap = useMemo(() => new Map(choices.map((c) => [c.value, c])), [choices]);
+        useKeypress((key) => {
+            if (status === 'done')
+                return;
+            // Enter to confirm/submit
+            if (isEnterKey(key)) {
+                if (validate) {
+                    const result = validate(selectedValues);
+                    if (result !== true) {
+                        setError(typeof result === 'string' ? result : 'Invalid');
+                        return;
+                    }
+                }
+                setStatus('done');
+                done(selectedValues);
+                return;
+            }
+            // Space to toggle selection
+            if (key.name === 'space') {
+                const choice = filteredChoices[cursor];
+                if (choice) {
+                    if (selectedSet.has(choice.value)) {
+                        setSelectedValues(selectedValues.filter(v => v !== choice.value));
+                    }
+                    else {
+                        setSelectedValues([...selectedValues, choice.value]);
+                    }
+                }
+                return;
+            }
+            // Backspace to remove or delete search char
+            if (isBackspaceKey(key)) {
+                if (searchText === '' && selectedValues.length > 0) {
+                    setSelectedValues(selectedValues.slice(0, -1));
+                }
+                else {
+                    setSearchText(searchText.slice(0, -1));
+                    setCursor(0);
+                }
+                return;
+            }
+            // Navigation
+            if (isUpKey(key)) {
+                setCursor(Math.max(0, cursor - 1));
+                return;
+            }
+            if (isDownKey(key)) {
+                setCursor(Math.min(filteredChoices.length - 1, cursor + 1));
+                return;
+            }
+            // Character input - handle printable characters
+            if (key.name && key.name.length === 1 && !key.ctrl) {
+                setSearchText(searchText + key.name);
+                setCursor(0);
+            }
+        });
+        // Render done state
+        if (status === 'done') {
+            const names = selectedValues
+                .map((v) => choiceMap.get(v)?.name ?? v)
+                .join(', ');
+            return `${prefix} ${chalk.bold(message)} ${chalk.cyan(names || '(none)')}`;
+        }
+        // Render active state
+        const lines = [];
+        lines.push(`${prefix} ${chalk.bold(message)}`);
+        // Selected chips
+        const chips = selectedValues.length > 0
+            ? selectedValues
+                .map((v) => chalk.bgCyan.black(` ${choiceMap.get(v)?.name} `))
+                .join(' ')
+            : chalk.dim('(none selected)');
+        lines.push(`  Selected: ${chips}`);
+        // Search box
+        lines.push(`  Search: ${chalk.yellow('[')}${searchText || chalk.dim('type to filter')}${chalk.yellow(']')}`);
+        // Instructions
+        lines.push(`  ${chalk.cyan('↑↓')} navigate • ${chalk.cyan('Space')} toggle • ${chalk.cyan('Backspace')} remove • ${chalk.cyan('Enter')} confirm`);
+        // List
+        if (filteredChoices.length === 0) {
+            lines.push(chalk.yellow('  No matches'));
+        }
+        else {
+            // Calculate pagination
+            const startIndex = Math.max(0, Math.min(cursor - Math.floor(pageSize / 2), filteredChoices.length - pageSize));
+            const endIndex = Math.min(startIndex + pageSize, filteredChoices.length);
+            const visibleChoices = filteredChoices.slice(startIndex, endIndex);
+            for (let i = 0; i < visibleChoices.length; i++) {
+                const item = visibleChoices[i];
+                const actualIndex = startIndex + i;
+                const isActive = actualIndex === cursor;
+                const selected = selectedSet.has(item.value);
+                const icon = selected ? chalk.green('◉') : chalk.dim('○');
+                const arrow = isActive ? chalk.cyan('›') : ' ';
+                const name = isActive ? chalk.cyan(item.name) : item.name;
+                const isRefresh = selected && item.configured;
+                const statusLabel = !selected
+                    ? item.configured
+                        ? ' (configured)'
+                        : item.detected
+                            ? ' (detected)'
+                            : ''
+                    : '';
+                const suffix = selected
+                    ? chalk.dim(isRefresh ? ' (refresh)' : ' (selected)')
+                    : chalk.dim(statusLabel);
+                lines.push(`  ${arrow} ${icon} ${name}${suffix}`);
+            }
+            // Show pagination indicator if needed
+            if (filteredChoices.length > pageSize) {
+                const currentPage = Math.floor(cursor / pageSize) + 1;
+                const totalPages = Math.ceil(filteredChoices.length / pageSize);
+                lines.push(chalk.dim(`  (${currentPage}/${totalPages})`));
+            }
+        }
+        if (error)
+            lines.push(chalk.red(`  ${error}`));
+        return lines.join('\n');
+    });
+}
+/**
+ * A searchable multi-select prompt with visible search box,
+ * selected items display, and intuitive keyboard navigation.
+ *
+ * - Type to filter choices
+ * - ↑↓ to navigate
+ * - Space to toggle highlighted item selection
+ * - Backspace to remove last selected item (or delete search char)
+ * - Enter to confirm selections
+ */
+export async function searchableMultiSelect(config) {
+    const prompt = await createSearchableMultiSelect();
+    return prompt(config);
+}
+export default searchableMultiSelect;
+//# sourceMappingURL=searchable-multi-select.js.map

package/dist/ui/ascii-patterns.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ASCII art animation patterns for the welcome screen.
+ * SynArcX snowflake animation — grows from center outward,
+ * then the nucleus goes hollow (like a real snowflake crystal).
+ */
+/**
+ * 9-column grid (rows 3-9 active), shifted right by 1 column:
+ *
+ *   Col:  0  1  2  3  4  5  6  7  8
+ *   Row 3: .  .  .  .  F  F  .  .  .   top arm tip
+ *   Row 4: .  .  F  .  F  F  .  F  .   branches off arm
+ *   Row 5: .  .  .  F  F  F  F  .  .   arm widens
+ *   Row 6: .  F  F  F  F  F  F  F  F   full horizontal arm
+ *   Row 7: .  .  .  F  F  F  F  .  .   arm widens
+ *   Row 8: .  .  F  .  F  F  .  F  .   branches off arm
+ *   Row 9: .  .  .  .  F  F  .  .  .   bottom arm tip
+ *
+ * Frame 8 — hollow center: cols 4-5 on rows 5-7 go dark,
+ * leaving the crystal arms and a hollow nucleus.
+ */
+export declare const WELCOME_ANIMATION: {
+    interval: number;
+    frames: string[][];
+};
+//# sourceMappingURL=ascii-patterns.d.ts.map

package/dist/ui/ascii-patterns.js

@@ -0,0 +1,140 @@
+/**
+ * ASCII art animation patterns for the welcome screen.
+ * SynArcX snowflake animation — grows from center outward,
+ * then the nucleus goes hollow (like a real snowflake crystal).
+ */
+// Detect if full Unicode is supported
+const supportsUnicode = process.platform !== 'win32' ||
+    !!process.env.WT_SESSION || // Windows Terminal
+    !!process.env.TERM_PROGRAM; // Modern terminal
+const CHARS = supportsUnicode
+    ? { full: '██', dim: '░░', empty: '  ' }
+    : { full: '##', dim: '++', empty: '  ' };
+const _ = CHARS.empty;
+const F = CHARS.full;
+const D = CHARS.dim;
+/**
+ * 9-column grid (rows 3-9 active), shifted right by 1 column:
+ *
+ *   Col:  0  1  2  3  4  5  6  7  8
+ *   Row 3: .  .  .  .  F  F  .  .  .   top arm tip
+ *   Row 4: .  .  F  .  F  F  .  F  .   branches off arm
+ *   Row 5: .  .  .  F  F  F  F  .  .   arm widens
+ *   Row 6: .  F  F  F  F  F  F  F  F   full horizontal arm
+ *   Row 7: .  .  .  F  F  F  F  .  .   arm widens
+ *   Row 8: .  .  F  .  F  F  .  F  .   branches off arm
+ *   Row 9: .  .  .  .  F  F  .  .  .   bottom arm tip
+ *
+ * Frame 8 — hollow center: cols 4-5 on rows 5-7 go dark,
+ * leaving the crystal arms and a hollow nucleus.
+ */
+export const WELCOME_ANIMATION = {
+    interval: 130,
+    frames: [
+        // Frame 1: Empty
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 2: Nucleus glows dim
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 3: Nucleus solid, first arm stubs dim
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}${_}`,
+            `${_}${_}${_}${D}${F}${F}${D}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 4: Arms grow outward (dim)
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${_}${D}${F}${F}${D}${_}${_}`,
+            `${_}${_}${D}${F}${F}${F}${F}${D}${_}`,
+            `${_}${_}${_}${D}${F}${F}${D}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 5: Inner arms solid, outer ring dim
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}${_}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${D}${F}${F}${F}${F}${F}${F}${D}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+        ],
+        // Frame 6: Outer arms solid, tips dim
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}${_}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${F}${F}${F}${F}${F}${F}${F}${F}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}${_}`,
+        ],
+        // Frame 7: Full snowflake — all solid
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}${_}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${F}${F}${F}${F}${F}${F}${F}${F}`,
+            `${_}${_}${_}${F}${F}${F}${F}${_}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}${_}`,
+        ],
+        // Frame 8: Hollow center — nucleus (cols 4-5, rows 5-7) goes dark
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}${_}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}${_}`,
+            `${_}${F}${F}${F}${_}${_}${F}${F}${F}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}${_}`,
+        ],
+    ],
+};
+//# sourceMappingURL=ascii-patterns.js.map

package/dist/ui/welcome-screen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Animated welcome screen for the experimental artifact workflow setup.
+ * Shows side-by-side layout with animated ASCII art on left and welcome text on right.
+ */
+/**
+ * Shows the animated welcome screen.
+ * Returns when user presses Enter.
+ */
+export declare function showWelcomeScreen(): Promise<void>;
+//# sourceMappingURL=welcome-screen.d.ts.map

package/dist/ui/welcome-screen.js

@@ -0,0 +1,144 @@
+/**
+ * Animated welcome screen for the experimental artifact workflow setup.
+ * Shows side-by-side layout with animated ASCII art on left and welcome text on right.
+ */
+import chalk from 'chalk';
+import { WELCOME_ANIMATION } from './ascii-patterns.js';
+// Minimum terminal width for side-by-side layout
+const MIN_WIDTH = 60;
+// Width of the ASCII art column (with padding)
+const ART_COLUMN_WIDTH = 24;
+/**
+ * Welcome text content (right column)
+ */
+function getWelcomeText() {
+    return [
+        chalk.white.bold('Welcome to SynArcX'),
+        chalk.dim('Spec-driven development, extended'),
+        '',
+        chalk.white('This setup will configure:'),
+        chalk.dim('  • Agent Skills for AI tools'),
+        chalk.dim('  • /syn:* slash commands'),
+        `  ${chalk.yellow('/syn:propose')}  ${chalk.dim('Propose a change')}`,
+        `  ${chalk.yellow('/syn:explore')}  ${chalk.dim('Explore & think')}`,
+        `  ${chalk.yellow('/syn:apply')}    ${chalk.dim('Implement tasks')}`,
+        '',
+        chalk.cyan('Press Enter to select tools...'),
+    ];
+}
+/**
+ * Renders a single frame with side-by-side layout
+ */
+function renderFrame(artLines, textLines) {
+    const maxLines = Math.max(artLines.length, textLines.length);
+    const lines = [];
+    for (let i = 0; i < maxLines; i++) {
+        const artLine = artLines[i] || '';
+        const textLine = textLines[i] || '';
+        // Pad the art column to fixed width
+        const paddedArt = artLine.padEnd(ART_COLUMN_WIDTH);
+        // Color the ASCII art with cyan for visual appeal
+        const coloredArt = chalk.cyan(paddedArt);
+        // Clear line before writing to prevent residual characters
+        lines.push(`\x1b[2K${coloredArt}${textLine}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Checks if the terminal supports animation
+ */
+function canAnimate() {
+    // Must be TTY
+    if (!process.stdout.isTTY)
+        return false;
+    // Respect NO_COLOR
+    if (process.env.NO_COLOR)
+        return false;
+    // Check terminal width
+    const columns = process.stdout.columns || 80;
+    if (columns < MIN_WIDTH)
+        return false;
+    return true;
+}
+/**
+ * Wait for Enter key press
+ */
+function waitForEnter() {
+    return new Promise((resolve) => {
+        const { stdin } = process;
+        // Handle non-TTY gracefully
+        if (!stdin.isTTY) {
+            resolve();
+            return;
+        }
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        const onData = (data) => {
+            const char = data.toString();
+            // Enter key or Ctrl+C
+            if (char === '\r' || char === '\n' || char === '\u0003') {
+                stdin.removeListener('data', onData);
+                stdin.setRawMode(wasRaw);
+                stdin.pause();
+                // Handle Ctrl+C
+                if (char === '\u0003') {
+                    process.stdout.write('\n');
+                    process.exit(0);
+                }
+                resolve();
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+/**
+ * Shows the animated welcome screen.
+ * Returns when user presses Enter.
+ */
+export async function showWelcomeScreen() {
+    const textLines = getWelcomeText();
+    if (!canAnimate()) {
+        // Fallback: show static welcome
+        const frame = WELCOME_ANIMATION.frames[3]; // Peak frame
+        process.stdout.write('\n' + renderFrame(frame, textLines) + '\n\n');
+        return;
+    }
+    let frameIndex = 0;
+    let running = true;
+    let isFirstRender = true;
+    // Content height for cursor movement between frames
+    const numContentLines = Math.max(WELCOME_ANIMATION.frames[0].length, textLines.length);
+    const frameHeight = numContentLines + 1; // internal newlines (11) + trailing newlines (2) = 13
+    // Total height including initial newline (for cleanup)
+    const totalHeight = frameHeight + 1; // 14
+    // Initial render
+    process.stdout.write('\n');
+    // Animation loop
+    const interval = setInterval(() => {
+        if (!running)
+            return;
+        const frame = WELCOME_ANIMATION.frames[frameIndex];
+        // Move cursor up to overwrite previous frame (always after first render)
+        if (!isFirstRender) {
+            process.stdout.write(`\x1b[${frameHeight}A`);
+        }
+        isFirstRender = false;
+        // Render current frame
+        process.stdout.write(renderFrame(frame, textLines) + '\n\n');
+        // Advance to next frame
+        frameIndex = (frameIndex + 1) % WELCOME_ANIMATION.frames.length;
+    }, WELCOME_ANIMATION.interval);
+    // Wait for Enter
+    await waitForEnter();
+    // Stop animation
+    running = false;
+    clearInterval(interval);
+    // Clear the welcome screen and move on
+    process.stdout.write(`\x1b[${totalHeight}A`);
+    for (let i = 0; i < totalHeight; i++) {
+        process.stdout.write('\x1b[2K\n'); // Clear line
+    }
+    process.stdout.write(`\x1b[${totalHeight}A`); // Move back up
+}
+//# sourceMappingURL=welcome-screen.js.map