@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/ui/overlay/impl/document-detail-overlay-v2.js

@@ -65,10 +65,12 @@ setupAlternateScreenCleanup();
 import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
 import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
-import { renderBorder, isCtrlC, isClose } from '../../base/index.js';
+import { renderBorder, isCtrlC, isClose, isNavigateUp, isNavigateDown, isUpArrow, isDownArrow, isLeftArrow, isRightArrow, isHome, isEnd, isPageUp, isPageDown, isSpace, isBackspace, isDelete, isEnter, isTab, isEscape, isE, getPrintableChar, } from '../../base/index.js';
 import { documentRepository } from '../../../db/repositories/document-repository.js';
+import { planRepository } from '../../../db/repositories/plan-repository.js';
 import { getCurrentTheme } from '../../../themes/index.js';
 import * as terminal from '../../terminal.js';
+import { DOC_TYPE_LABELS, PLAN_STATUS_LABELS, PLAN_STATUS_COLORS } from '../../constants/labels.js';
 // =============================================================================
 // Register Additional Languages for Syntax Highlighting
 // =============================================================================
@@ -168,11 +170,14 @@ hljs.registerAliases('graphviz', { languageName: 'dot' });
 // =============================================================================
 // Constants
 // =============================================================================
-const DOC_TYPE_LABELS = {
-    'prd': 'PRD',
-    'architecture': 'ARCH',
-    'design': 'DESIGN',
-    'notes': 'NOTES',
+// DOC_TYPE_LABELS, PLAN_STATUS_LABELS, PLAN_STATUS_COLORS imported from '../../constants/labels.js'
+// Valid status transitions
+const VALID_TRANSITIONS = {
+    draft: ['approved', 'abandoned'],
+    approved: ['in_progress', 'abandoned'],
+    in_progress: ['completed', 'abandoned'],
+    completed: [],
+    abandoned: ['draft'],
 };
 const TAB_SIZE = 2;
 // =============================================================================
@@ -401,74 +406,16 @@ function highlightInlineMarkdown(text, theme) {
     return result;
 }
 // =============================================================================
-// Key Detection Helpers
+// Key Detection Helpers (local functions not in ui-core)
 // =============================================================================
-function isNavigateUp(data) {
-    const str = data.toString();
-    return str === '\x1b[A' || str === 'k';
-}
-function isNavigateDown(data) {
-    const str = data.toString();
-    return str === '\x1b[B' || str === 'j';
-}
-function isArrowUp(data) {
-    return data.toString() === '\x1b[A';
-}
-function isArrowDown(data) {
-    return data.toString() === '\x1b[B';
-}
-function isArrowLeft(data) {
-    return data.toString() === '\x1b[D';
-}
-function isArrowRight(data) {
-    return data.toString() === '\x1b[C';
-}
-function isHome(data) {
-    const str = data.toString();
-    return str === '\x1b[H' || str === '\x1b[1~';
-}
-function isEnd(data) {
-    const str = data.toString();
-    return str === '\x1b[F' || str === '\x1b[4~';
-}
-function isPageUp(data) {
-    return data.toString() === '\x1b[5~';
-}
-function isPageDown(data) {
-    return data.toString() === '\x1b[6~';
-}
-function isSpace(data) {
-    return data.length === 1 && data[0] === 0x20;
-}
-function isBackspace(data) {
-    return data.length === 1 && (data[0] === 0x7f || data[0] === 0x08);
-}
-function isDelete(data) {
-    return data.toString() === '\x1b[3~';
-}
-function isEnter(data) {
-    return data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
-}
-function isTab(data) {
-    return data.length === 1 && data[0] === 0x09;
-}
+// Most key detection functions are imported from '../../base/index.js'.
+// Only custom/specialized ones are defined locally here.
 function isCtrlS(data) {
     return data.length === 1 && data[0] === 0x13;
 }
-function isEscape(data) {
-    return data.length === 1 && data[0] === 0x1b;
-}
 function isEditKey(data) {
-    const char = data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f
-        ? String.fromCharCode(data[0])
-        : null;
-    return char === 'e' || char === 'i';
-}
-function isPrintableChar(data) {
-    if (data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f) {
-        return String.fromCharCode(data[0]);
-    }
-    return null;
+    // Check if 'e' or 'i' key is pressed (to enter edit mode)
+    return isE(data) || (data.length === 1 && data[0] === 0x69); // 'i' = 0x69
 }
 // =============================================================================
 // Document Detail Overlay V2
@@ -490,6 +437,10 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
         const termWidth = terminal.getTerminalWidth();
         const contentLines = renderMarkdownSync(document.content, termWidth);
         const rawLines = document.content.split('\n');
+        // Initialize plan-specific state
+        const isPlan = document.docType === 'plan';
+        const planStatus = isPlan ? document.status ?? 'draft' : null;
+        const availableStatuses = planStatus ? VALID_TRANSITIONS[planStatus] : [];
         super({
             contentLines,
             scrollOffset: 0,
@@ -502,6 +453,10 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
             originalContent: document.content,
             showSavePrompt: false,
             saveMessage: null,
+            planStatus,
+            showStatusMenu: false,
+            statusMenuIndex: 0,
+            availableStatuses,
         });
         this.document = document;
     }
@@ -537,7 +492,16 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
         // Header
         const typeLabel = DOC_TYPE_LABELS[this.document.docType] || this.document.docType.toUpperCase();
         lines.push(border);
-        lines.push(` ${s.primaryBold(typeLabel)}${s.muted(' │ ')}${chalk.bold(this.document.title)}`);
+        // For plans, show status in header
+        if (this.state.planStatus) {
+            const statusLabel = PLAN_STATUS_LABELS[this.state.planStatus];
+            const statusColor = PLAN_STATUS_COLORS[this.state.planStatus];
+            const styledStatus = s[statusColor](statusLabel);
+            lines.push(` ${s.primaryBold(typeLabel)}${s.muted(' │ ')}${chalk.bold(this.document.title)}  ${styledStatus}`);
+        }
+        else {
+            lines.push(` ${s.primaryBold(typeLabel)}${s.muted(' │ ')}${chalk.bold(this.document.title)}`);
+        }
         lines.push(border);
         // Calculate content area
         const headerLines = 3;
@@ -579,7 +543,19 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
             ? Math.round(((this.state.scrollOffset + contentHeight) / totalLines) * 100)
             : 100;
         lines.push(border);
-        lines.push(s.muted(` ${arrows} ${position} (${String(scrollPercent)}%)  ↑↓/jk Scroll · e/i Edit · q/Esc Back`));
+        // Show status menu if open
+        if (this.state.showStatusMenu && this.state.availableStatuses.length > 0) {
+            const statusOptions = this.state.availableStatuses.map((status, idx) => {
+                const label = PLAN_STATUS_LABELS[status];
+                return idx === this.state.statusMenuIndex ? s.primary(`[${label}]`) : s.muted(label);
+            }).join('  ');
+            lines.push(s.warning(' Change status: ') + statusOptions + s.muted('  ↑↓ Select · Enter Confirm · Esc Cancel'));
+        }
+        else {
+            // Normal footer with plan-specific hint
+            const planHint = this.state.planStatus && this.state.availableStatuses.length > 0 ? ' · s Status' : '';
+            lines.push(s.muted(` ${arrows} ${position} (${String(scrollPercent)}%)  ↑↓/jk Scroll · e/i Edit${planHint} · q/Esc Back`));
+        }
         lines.push(border);
         return lines;
     }
@@ -735,6 +711,10 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
         if (this.state.showSavePrompt) {
             return this.handleSavePromptKey(data);
         }
+        // Handle status menu
+        if (this.state.showStatusMenu) {
+            return this.handleStatusMenuKey(data);
+        }
         // Handle edit mode
         if (this.state.isEditMode) {
             return this.handleEditModeKey(data);
@@ -746,7 +726,7 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
     // View Mode Key Handling
     // ===========================================================================
     handleViewModeKey(data) {
-        const char = isPrintableChar(data);
+        const char = getPrintableChar(data);
         const keyStr = data.toString();
         const rows = terminal.getTerminalHeight();
         const contentHeight = rows - 6;
@@ -769,6 +749,12 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
             this.state.saveMessage = null;
             return this.rerender();
         }
+        // s - open status menu (plans only)
+        if (char === 's' && this.state.planStatus && this.state.availableStatuses.length > 0) {
+            this.state.showStatusMenu = true;
+            this.state.statusMenuIndex = 0;
+            return this.rerender();
+        }
         // Up / k
         if (isNavigateUp(data)) {
             if (this.state.scrollOffset > 0) {
@@ -844,16 +830,16 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
             return this.exitEditMode();
         }
         // Navigation
-        if (isArrowUp(data)) {
+        if (isUpArrow(data)) {
             return this.moveCursorUp();
         }
-        if (isArrowDown(data)) {
+        if (isDownArrow(data)) {
             return this.moveCursorDown();
         }
-        if (isArrowLeft(data)) {
+        if (isLeftArrow(data)) {
             return this.moveCursorLeft();
         }
-        if (isArrowRight(data)) {
+        if (isRightArrow(data)) {
             return this.moveCursorRight();
         }
         if (isHome(data)) {
@@ -892,7 +878,7 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
             return this.insertText(' '.repeat(TAB_SIZE));
         }
         // Printable characters
-        const char = isPrintableChar(data);
+        const char = getPrintableChar(data);
         if (char) {
             return this.insertText(char);
         }
@@ -902,7 +888,7 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
     // Save Prompt Key Handling
     // ===========================================================================
     handleSavePromptKey(data) {
-        const char = isPrintableChar(data);
+        const char = getPrintableChar(data);
         // y = save and exit edit mode
         if (char === 'y' || char === 'Y') {
             this.saveDocument();
@@ -929,6 +915,61 @@ export class DocumentDetailOverlayV2 extends BaseOverlayV2 {
         return this.noAction();
     }
     // ===========================================================================
+    // Status Menu Key Handling (Plans only)
+    // ===========================================================================
+    handleStatusMenuKey(data) {
+        // Ctrl+C closes everything
+        if (isCtrlC(data)) {
+            return this.close({ goBack: false });
+        }
+        // Escape - close status menu
+        if (isEscape(data)) {
+            this.state.showStatusMenu = false;
+            return this.rerender();
+        }
+        // Up arrow - previous status
+        if (isUpArrow(data)) {
+            if (this.state.statusMenuIndex > 0) {
+                this.state.statusMenuIndex--;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Down arrow - next status
+        if (isDownArrow(data)) {
+            if (this.state.statusMenuIndex < this.state.availableStatuses.length - 1) {
+                this.state.statusMenuIndex++;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Enter - confirm status change
+        if (isEnter(data)) {
+            const newStatus = this.state.availableStatuses[this.state.statusMenuIndex];
+            return this.changeStatus(newStatus);
+        }
+        return this.noAction();
+    }
+    changeStatus(newStatus) {
+        try {
+            // Update the plan status in the database
+            planRepository.update(this.document.id, { status: newStatus });
+            // Update local state
+            this.state.planStatus = newStatus;
+            this.state.availableStatuses = VALID_TRANSITIONS[newStatus];
+            this.state.showStatusMenu = false;
+            this.state.statusMenuIndex = 0;
+            // Also update the document's status field for consistency
+            this.document.status = newStatus;
+            return this.rerender();
+        }
+        catch {
+            // On error, just close the menu
+            this.state.showStatusMenu = false;
+            return this.rerender();
+        }
+    }
+    // ===========================================================================
     // Cursor Movement
     // ===========================================================================
     moveCursorUp() {

package/dist/ui/overlay/impl/filter-overlay-v2.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Filter Overlay V2
+ *
+ * Modal overlay for selecting which agents to show in conversation.
+ * The filter is display-only - full history is preserved.
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../index.js';
+export interface FilterOverlayV2Config {
+    /** All agents available for filtering */
+    agents: Array<{
+        id: string;
+        displayName: string;
+        mascot: string;
+        selected: boolean;
+    }>;
+    /** Currently filtered agent IDs (empty = show all) */
+    currentFilter: string[];
+}
+export type FilterOverlayV2Result = {
+    type: 'apply';
+    agentIds: string[];
+} | {
+    type: 'cancelled';
+};
+interface FilterOverlayState {
+    /** Currently selected agent index */
+    selectedIndex: number;
+    /** Selection state for each agent */
+    selections: Map<string, boolean>;
+    /** Agent list */
+    agents: FilterOverlayV2Config['agents'];
+}
+export declare class FilterOverlayV2 extends BaseOverlayV2<FilterOverlayState, FilterOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "filter-overlay-v2";
+    constructor(config: FilterOverlayV2Config);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(event: KeyEvent): OverlayAction<FilterOverlayV2Result>;
+}
+export {};

package/dist/ui/overlay/impl/filter-overlay-v2.js

@@ -0,0 +1,110 @@
+/**
+ * Filter Overlay V2
+ *
+ * Modal overlay for selecting which agents to show in conversation.
+ * The filter is display-only - full history is preserved.
+ */
+import chalk from 'chalk';
+import { BaseOverlayV2 } from '../../base/index.js';
+import * as terminal from '../../terminal.js';
+// =============================================================================
+// Filter Overlay V2 Class
+// =============================================================================
+export class FilterOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'filter-overlay-v2';
+    constructor(config) {
+        // Initialize selections from config
+        const selections = new Map();
+        for (const agent of config.agents) {
+            selections.set(agent.id, agent.selected);
+        }
+        super({
+            selectedIndex: 0,
+            selections,
+            agents: config.agents,
+        });
+        this.minHeight = 8 + config.agents.length;
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const lines = [];
+        const cols = terminal.getTerminalWidth();
+        const border = s.muted('─'.repeat(Math.max(1, cols - 1)));
+        // Header
+        lines.push(border);
+        lines.push(' ' + chalk.bold('Conversation Filter'));
+        lines.push(border);
+        lines.push('');
+        // Instructions
+        lines.push(s.muted('  Show messages from:'));
+        lines.push('');
+        // Agent list with checkboxes
+        for (let i = 0; i < this.state.agents.length; i++) {
+            const agent = this.state.agents[i];
+            const isSelected = i === this.state.selectedIndex;
+            const isChecked = this.state.selections.get(agent.id) ?? true;
+            const checkbox = isChecked ? s.success('[x]') : s.muted('[ ]');
+            const mascot = agent.mascot;
+            const id = `$${agent.id}`;
+            const name = `(${agent.displayName})`;
+            const line = `  ${checkbox} ${mascot} ${id} ${s.muted(name)}`;
+            if (isSelected) {
+                lines.push(s.primary(line));
+            }
+            else {
+                lines.push(line);
+            }
+        }
+        lines.push('');
+        // Footer with shortcuts
+        lines.push(border);
+        lines.push(s.muted(' ↑↓ Navigate · Space Toggle · a All · n None · Enter Apply · Esc Cancel'));
+        return lines;
+    }
+    handleKey(event) {
+        const { name, raw } = event;
+        // Navigation
+        if (name === 'up' || (raw.length === 3 && raw[0] === 0x1b && raw[1] === 0x5b && raw[2] === 0x41)) {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            return { type: 'render' };
+        }
+        if (name === 'down' || (raw.length === 3 && raw[0] === 0x1b && raw[1] === 0x5b && raw[2] === 0x42)) {
+            this.state.selectedIndex = Math.min(this.state.agents.length - 1, this.state.selectedIndex + 1);
+            return { type: 'render' };
+        }
+        // Toggle selection
+        if (name === 'space') {
+            const agent = this.state.agents[this.state.selectedIndex];
+            const current = this.state.selections.get(agent.id) ?? true;
+            this.state.selections.set(agent.id, !current);
+            return { type: 'render' };
+        }
+        // Select all
+        if (name === 'a') {
+            for (const agent of this.state.agents) {
+                this.state.selections.set(agent.id, true);
+            }
+            return { type: 'render' };
+        }
+        // Select none
+        if (name === 'n') {
+            for (const agent of this.state.agents) {
+                this.state.selections.set(agent.id, false);
+            }
+            return { type: 'render' };
+        }
+        // Apply
+        if (name === 'return' || name === 'enter') {
+            const selectedIds = this.state.agents
+                .filter(agent => this.state.selections.get(agent.id))
+                .map(agent => agent.id);
+            return { type: 'close', result: { type: 'apply', agentIds: selectedIds } };
+        }
+        // Cancel
+        if (name === 'escape') {
+            return { type: 'close', cancelled: true };
+        }
+        return { type: 'none' };
+    }
+}

package/dist/ui/overlay/impl/games-overlay-v2.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Games Overlay V2
+ *
+ * Arcade menu for the games easter egg.
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+import { type GameInfo } from '../../../games/index.js';
+export interface GamesOverlayV2Result {
+    action: 'close' | 'play';
+    game?: GameInfo;
+}
+interface GamesState {
+    selectedIndex: number;
+    showInsertCoin: boolean;
+    gameToPlay: GameInfo | null;
+    gotDailyBonus: boolean;
+}
+export interface GamesOverlayV2Options {
+    gotDailyBonus?: boolean;
+}
+export declare class GamesOverlayV2 extends BaseOverlayV2<GamesState, GamesOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "games";
+    constructor(options?: GamesOverlayV2Options);
+    protected renderContent(ctx: RenderContext): string[];
+    private renderGamesList;
+    private renderInsertCoinScreen;
+    handleKey(event: KeyEvent): OverlayAction<GamesOverlayV2Result>;
+}
+export {};

package/dist/ui/overlay/impl/games-overlay-v2.js

@@ -0,0 +1,135 @@
+/**
+ * Games Overlay V2
+ *
+ * Arcade menu for the games easter egg.
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import { getAvailableGames, getCoins, hasCoins, formatCoinsDisplay, getBestScore, formatScore, COIN_COST_START_GAME, } from '../../../games/index.js';
+export class GamesOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'games';
+    constructor(options) {
+        super({
+            selectedIndex: 0,
+            showInsertCoin: false,
+            gameToPlay: null,
+            gotDailyBonus: options?.gotDailyBonus ?? false,
+        });
+        this.minHeight = 20;
+    }
+    renderContent(ctx) {
+        const s = ctx.styles;
+        const games = getAvailableGames();
+        const coins = getCoins();
+        if (this.state.showInsertCoin) {
+            return this.renderInsertCoinScreen(s, coins);
+        }
+        return this.renderGamesList(s, games, coins);
+    }
+    renderGamesList(s, games, coins) {
+        const lines = [];
+        // Title
+        lines.push('');
+        lines.push(s.primaryBold('  ╔═══════════════════════════════════════════════════╗'));
+        lines.push(s.primaryBold('  ║              A   R   C   A   D   E                ║'));
+        lines.push(s.primaryBold('  ╚═══════════════════════════════════════════════════╝'));
+        // Daily bonus notification
+        if (this.state.gotDailyBonus) {
+            lines.push(s.success('                   🎁 Daily bonus: +1 coin!'));
+        }
+        else {
+            lines.push('');
+        }
+        // Games list
+        lines.push(s.muted('  ┌─────────────────────────────────────────────────┐'));
+        for (let i = 0; i < games.length; i++) {
+            const game = games[i];
+            const isSelected = i === this.state.selectedIndex;
+            const cursor = isSelected ? s.primary('❯') : ' ';
+            if (game.available) {
+                const bestScore = getBestScore(game.id);
+                const scoreText = bestScore ? `Best: ${formatScore(bestScore.score)}` : '';
+                if (isSelected) {
+                    lines.push(`  │ ${cursor} ${s.primaryBold(game.name.padEnd(18))} ${s.muted(scoreText.padStart(20))} │`);
+                }
+                else {
+                    lines.push(`  │ ${cursor} ${s.primary(game.name.padEnd(18))} ${s.muted(scoreText.padStart(20))} │`);
+                }
+            }
+            else {
+                // Coming soon
+                lines.push(`  │ ${cursor} ${s.muted(game.name.padEnd(18))} ${s.muted('Coming Soon...'.padStart(20))} │`);
+            }
+        }
+        lines.push(s.muted('  └─────────────────────────────────────────────────┘'));
+        lines.push('');
+        // Coins display
+        const coinsDisplay = formatCoinsDisplay(coins, 10);
+        lines.push(`  ${s.warning('COINS:')} ${s.primary(coinsDisplay)} (${String(coins)})`);
+        lines.push('');
+        // Controls
+        lines.push(s.muted('  ↑↓ Select   Enter Play   Q Exit'));
+        lines.push('');
+        return lines;
+    }
+    renderInsertCoinScreen(s, coins) {
+        const lines = [];
+        lines.push('');
+        lines.push('');
+        lines.push('');
+        lines.push(s.warning('       ╔═════════════════════════════╗'));
+        lines.push(s.warning('       ║                             ║'));
+        lines.push(s.warning('       ║   I N S E R T   C O I N     ║'));
+        lines.push(s.warning('       ║                             ║'));
+        lines.push(s.warning('       ╚═════════════════════════════╝'));
+        lines.push('');
+        lines.push(`       ${s.muted(`You have ${String(coins)} coin${coins !== 1 ? 's' : ''}.`)}`);
+        lines.push('');
+        lines.push(s.muted('       Earn coins by:'));
+        lines.push(s.muted('       • Completing work items'));
+        lines.push(s.muted('       • Creating projects'));
+        lines.push(s.muted('       • Daily usage'));
+        lines.push('');
+        lines.push(s.muted('       [Press any key to go back]'));
+        lines.push('');
+        return lines;
+    }
+    handleKey(event) {
+        const games = getAvailableGames();
+        // Handle insert coin screen
+        if (this.state.showInsertCoin) {
+            this.state.showInsertCoin = false;
+            return this.rerender();
+        }
+        // Navigation
+        if (this.isUpKey(event)) {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            return this.rerender();
+        }
+        if (this.isDownKey(event)) {
+            this.state.selectedIndex = Math.min(games.length - 1, this.state.selectedIndex + 1);
+            return this.rerender();
+        }
+        // Play game
+        if (this.isEnterKey(event)) {
+            const game = games[this.state.selectedIndex];
+            if (!game.available) {
+                // Game not available yet
+                return this.rerender();
+            }
+            // Check coins (but don't spend yet - game will spend when actually starting)
+            if (!hasCoins(COIN_COST_START_GAME)) {
+                this.state.showInsertCoin = true;
+                return this.rerender();
+            }
+            // Launch game (coin will be spent after pre-game screen)
+            this.state.gameToPlay = game;
+            return this.close({ action: 'play', game: game });
+        }
+        // Close
+        if (this.isCloseKey(event)) {
+            return this.close({ action: 'close' });
+        }
+        return this.noAction();
+    }
+}

package/dist/ui/overlay/impl/help-overlay-v2.d.ts

@@ -11,6 +11,28 @@
  * - Works with TerminalUI's overlay management
  */
 import { TabbedListOverlayV2, BaseScreen } from '../../base/index.js';
+/** Command detail info returned by getCommand(). */
+interface CommandDetail {
+    name: string;
+    description: string;
+    details?: string;
+    aliases?: string[];
+    examples?: {
+        code: string;
+        description?: string;
+    }[];
+    interactions?: string[];
+}
+/** Options for creating HelpOverlayV2. */
+export interface HelpOverlayV2Options {
+    /** Get all commands for the help list. */
+    getHelpCommands: () => {
+        name: string;
+        description: string;
+    }[];
+    /** Get detailed info for a single command. */
+    getCommand: (name: string) => CommandDetail | undefined;
+}
 interface HelpItem {
     name: string;
     description: string;
@@ -18,8 +40,8 @@ interface HelpItem {
     /** For custom commands */
     prompt?: string;
     location?: 'project' | 'personal';
-    /** Index in COMMANDS array for built-in commands */
-    commandIndex?: number;
+    /** Command name for built-in commands (without leading /) */
+    commandName?: string;
 }
 /**
  * Help overlay using the new Overlay interface.
@@ -28,7 +50,8 @@ interface HelpItem {
 export declare class HelpOverlayV2 extends TabbedListOverlayV2<HelpItem> {
     readonly type: "inline";
     readonly id = "help-overlay-v2";
-    constructor();
+    private readonly getCommandDetail;
+    constructor(options: HelpOverlayV2Options);
     protected createDetailScreen(item: HelpItem): BaseScreen | null;
 }
 export {};