@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/help-overlay.js

@@ -0,0 +1,316 @@
+/**
+ * Help Overlay
+ *
+ * Displays available commands in a searchable, categorized list.
+ * Uses TabbedListOverlay for consistent UX patterns.
+ *
+ * Features:
+ * - Tabs: All, Built-in, Custom
+ * - Search with / toggle
+ * - Detail view for full command information
+ * - Info header with shortcuts
+ */
+import chalk from 'chalk';
+import * as terminal from './terminal.js';
+import { getHelpCommands, getCommandByIndex } from '../commands.js';
+import { getCustomCommandRegistry } from '../commands/index.js';
+import { TabbedListOverlay, BaseScreen, stay, popScreen, closeOverlay, isEscape, isCtrlC, isClose, renderBorder, } from './base/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const VERSION = 'compilr.dev/agent';
+const PAGE_SIZE = 10;
+const TABS = [
+    { id: 'all', label: 'All' },
+    { id: 'builtin', label: 'Built-in' },
+    { id: 'custom', label: 'Custom' },
+];
+// =============================================================================
+// Detail Screens
+// =============================================================================
+/**
+ * Built-in command detail screen
+ */
+class CommandDetailScreen extends BaseScreen {
+    item;
+    styles;
+    constructor(item, styles) {
+        super();
+        this.item = item;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const maxLineWidth = cols - 2;
+        const border = renderBorder(cols, s);
+        const cmd = this.item.commandIndex !== undefined
+            ? getCommandByIndex(this.item.commandIndex)
+            : null;
+        const lines = [];
+        lines.push(border);
+        lines.push(' ' + s.primaryBold('Command Reference'));
+        lines.push('');
+        if (!cmd) {
+            lines.push(s.error(' Command not found'));
+            lines.push(border);
+            lines.push(`  ${s.muted('q/Esc Back')}`);
+            lines.push(border);
+            return lines;
+        }
+        // Helper to truncate
+        const truncate = (line, max = maxLineWidth) => {
+            // eslint-disable-next-line no-control-regex
+            const stripped = line.replace(/\x1b\[[0-9;]*m/g, '');
+            if (stripped.length <= max)
+                return line;
+            let visibleLen = 0;
+            let cutIndex = 0;
+            for (let i = 0; i < line.length; i++) {
+                if (line[i] === '\x1b') {
+                    const end = line.indexOf('m', i);
+                    if (end !== -1) {
+                        i = end;
+                        continue;
+                    }
+                }
+                visibleLen++;
+                if (visibleLen >= max - 3) {
+                    cutIndex = i + 1;
+                    break;
+                }
+            }
+            return line.slice(0, cutIndex) + '...';
+        };
+        // Command name
+        lines.push(chalk.bold(` /${cmd.name}`));
+        lines.push('');
+        // Description
+        lines.push(' ' + s.primary('DESCRIPTION'));
+        lines.push(truncate('   ' + cmd.description));
+        lines.push('');
+        // Details
+        if (cmd.details) {
+            lines.push(' ' + s.primary('ABOUT'));
+            const maxWidth = Math.min(cols - 6, 70);
+            const words = cmd.details.split(' ');
+            let currentLine = '   ';
+            for (const word of words) {
+                if (currentLine.length + word.length + 1 > maxWidth) {
+                    lines.push(truncate(currentLine));
+                    currentLine = '   ' + word;
+                }
+                else {
+                    currentLine += (currentLine.length > 3 ? ' ' : '') + word;
+                }
+            }
+            if (currentLine.length > 3) {
+                lines.push(truncate(currentLine));
+            }
+            lines.push('');
+        }
+        // Aliases
+        if (cmd.aliases && cmd.aliases.length > 0) {
+            lines.push(' ' + s.primary('ALIASES'));
+            lines.push(truncate('   ' + cmd.aliases.map((a) => `/${a}`).join(', ')));
+            lines.push('');
+        }
+        // Examples
+        if (cmd.examples && cmd.examples.length > 0) {
+            lines.push(' ' + s.primary('EXAMPLES'));
+            for (const example of cmd.examples) {
+                if (example.description) {
+                    const paddedCode = example.code.padEnd(22);
+                    const exLine = `   ${s.muted(paddedCode)}${s.muted('·')} ${example.description}`;
+                    lines.push(truncate(exLine));
+                }
+                else {
+                    lines.push(truncate('   ' + s.muted(example.code)));
+                }
+            }
+            lines.push('');
+        }
+        // Interactions
+        if (cmd.interactions && cmd.interactions.length > 0) {
+            lines.push(' ' + s.primary('INTERACTIONS'));
+            for (const hint of cmd.interactions) {
+                lines.push(truncate('   ' + s.muted('• ' + hint)));
+            }
+            lines.push('');
+        }
+        // Footer
+        lines.push(border);
+        lines.push(`  ${s.muted('q/Esc Back')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isCtrlC(data)) {
+            return closeOverlay(undefined);
+        }
+        if (isEscape(data) || isClose(data)) {
+            return popScreen();
+        }
+        return stay(false);
+    }
+}
+/**
+ * Custom command detail screen
+ */
+class CustomCommandDetailScreen extends BaseScreen {
+    item;
+    styles;
+    constructor(item, styles) {
+        super();
+        this.item = item;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const registry = getCustomCommandRegistry();
+        const lines = [];
+        lines.push(border);
+        lines.push(' ' + s.primaryBold('Custom Command Details'));
+        lines.push('');
+        // Command name
+        lines.push(chalk.bold(` /${this.item.name}`));
+        lines.push('');
+        // Location
+        lines.push(' ' + s.primary('LOCATION'));
+        const loc = this.item.location ?? 'personal';
+        lines.push(`   ${loc === 'project' ? 'Project' : 'Personal'} (${loc})`);
+        lines.push('');
+        // File path
+        lines.push(' ' + s.primary('FILE'));
+        const basePath = loc === 'project'
+            ? registry.getProjectDir()
+            : registry.getUserDir();
+        lines.push(s.muted(`   ${basePath}/${this.item.name}.md`));
+        lines.push('');
+        // Description
+        lines.push(' ' + s.primary('DESCRIPTION'));
+        lines.push(...this.wrapText(this.item.description, cols - 6, '   '));
+        lines.push('');
+        // Prompt
+        if (this.item.prompt) {
+            lines.push(' ' + s.primary('PROMPT TEMPLATE'));
+            lines.push(...this.wrapText(this.item.prompt, cols - 6, '   '));
+            lines.push('');
+        }
+        // Footer
+        lines.push(border);
+        lines.push(`  ${s.muted('q/Esc Back')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isCtrlC(data)) {
+            return closeOverlay(undefined);
+        }
+        if (isEscape(data) || isClose(data)) {
+            return popScreen();
+        }
+        return stay(false);
+    }
+    wrapText(text, maxWidth, indent) {
+        const words = text.split(' ');
+        const resultLines = [];
+        let currentLine = indent;
+        for (const word of words) {
+            if (currentLine.length + word.length + 1 > maxWidth) {
+                resultLines.push(currentLine);
+                currentLine = indent + word;
+            }
+            else {
+                currentLine += (currentLine.length > indent.length ? ' ' : '') + word;
+            }
+        }
+        if (currentLine.length > indent.length) {
+            resultLines.push(currentLine);
+        }
+        return resultLines;
+    }
+}
+// =============================================================================
+// Help Overlay Class
+// =============================================================================
+class HelpOverlay extends TabbedListOverlay {
+    constructor() {
+        // Build unified items list
+        const items = [];
+        // Add built-in commands
+        const helpCommands = getHelpCommands();
+        for (let i = 0; i < helpCommands.length; i++) {
+            const cmd = helpCommands[i];
+            items.push({
+                name: cmd.name,
+                description: cmd.description,
+                type: 'builtin',
+                commandIndex: i,
+            });
+        }
+        // Add custom commands
+        const registry = getCustomCommandRegistry();
+        const customCommands = registry.getAll();
+        for (const cmd of customCommands) {
+            items.push({
+                name: `/${cmd.name}`,
+                description: cmd.description,
+                type: 'custom',
+                prompt: cmd.prompt,
+                location: cmd.location,
+            });
+        }
+        super({
+            title: VERSION,
+            tabs: TABS,
+            items,
+            pageSize: PAGE_SIZE,
+            filterByTab: (item, tabId) => {
+                if (tabId === 'all')
+                    return true;
+                if (tabId === 'builtin')
+                    return item.type === 'builtin';
+                if (tabId === 'custom')
+                    return item.type === 'custom';
+                return true;
+            },
+            getSearchText: (item) => `${item.name} ${item.description}`,
+            renderItem: (item, isSelected, styles) => {
+                const prefix = isSelected ? styles.primary(' ❯ ') : '   ';
+                const name = isSelected
+                    ? styles.primary(item.name.padEnd(20))
+                    : styles.muted(item.name.padEnd(20));
+                const desc = styles.muted(item.description);
+                const badge = item.type === 'custom' ? styles.muted(' (custom)') : '';
+                return prefix + name + desc + badge;
+            },
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Details · Esc Exit search';
+                }
+                return 'Tab Filter · ↑↓/jk · ←→/hl Pages · / Search · Enter Details · q/Esc Close';
+            },
+            emptyMessage: 'No commands available.',
+            noResultsMessage: 'No commands match the search.',
+            detailScreensFullScreen: false,
+        });
+    }
+    createDetailScreen(item) {
+        if (item.type === 'builtin') {
+            return new CommandDetailScreen(item, this.styles);
+        }
+        return new CustomCommandDetailScreen(item, this.styles);
+    }
+}
+// =============================================================================
+// Export Function
+// =============================================================================
+/**
+ * Show the help overlay
+ */
+export async function showHelp() {
+    return new HelpOverlay().show();
+}

package/dist/ui/index.d.ts

@@ -8,5 +8,5 @@ export * from './terminal.js';
 export * from './conversation.js';
 export * from './overlays.js';
 export * from './todo-zone.js';
-export * from './input-prompt-v2.js';
+export * from './input-prompt.js';
 export * from './footer.js';

package/dist/ui/index.js

@@ -9,7 +9,5 @@ export * from './conversation.js';
 export * from './overlays.js';
 // Refactored components (event-driven, persistent footer)
 export * from './todo-zone.js';
-export * from './input-prompt-v2.js';
+export * from './input-prompt.js';
 export * from './footer.js';
-// Note: ephemeral.js and input-prompt.js are legacy and not re-exported
-// to avoid naming conflicts. Import directly if needed.

package/dist/ui/init-overlay-v2.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Init Overlay (Refactored)
+ *
+ * Modal overlay for the /init wizard - creates new projects with structured workflow.
+ * Uses InlineOverlay base class for consistent lifecycle management.
+ *
+ * Steps:
+ *   0. Project type (new vs existing)
+ *   1. Project name
+ *   2. Description
+ *   3. Repo pattern (single vs two-repo)
+ *   4. Tech stack
+ *   5. Coding standards
+ *   6. Initialize git?
+ *   7. Track with project database?
+ *   8. Workflow mode (if tracking enabled)
+ *   9. Confirmation
+ */
+type WorkflowMode = 'flexible' | 'guided';
+export interface InitResult {
+    created: boolean;
+    projectPath?: string;
+    docsPath?: string;
+    filesCreated?: string[];
+    trackInDatabase?: boolean;
+    workflowMode?: WorkflowMode;
+    projectName?: string;
+    description?: string;
+}
+/**
+ * Show the init wizard overlay
+ */
+export declare function showInitOverlay(): Promise<InitResult>;
+export {};