@involvex/prompt-enhancer 0.0.2

package/.github/FUNDING.yml

@@ -0,0 +1,9 @@
+# These are supported funding model platforms
+
+github: [involvex]
+custom:
+  [
+    'https://buymeacoffee.com/involvex',
+    'https://paypal.me/involvex',
+    'https://rewards.bing.com/welcome?rh=14525F68&ref=rafsrchae&form=ML2XE3&OCID=ML2XE3&PUBL=RewardsDO&CREA=ML2XE3',
+  ]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 involvex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/app.d.ts

@@ -0,0 +1,5 @@
+interface Props {
+    prompt?: string;
+}
+export default function App({ prompt: _prompt }: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/app.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text } from 'ink';
+import SelectInput from './components/select-input.js';
+import EnhancePromptComponent from './components/enhance-prompt.js';
+import SettingsComponent from './components/settings.js';
+import HistoryComponent from './components/history-viewer.js';
+export default function App({ prompt: _prompt }) {
+    const [state, setState] = useState('menu');
+    const menuItems = [
+        { label: 'Enhance Prompt', value: 'enhance' },
+        { label: 'Settings', value: 'settings' },
+        { label: 'View History', value: 'history' },
+        { label: 'Help', value: 'help' },
+        { label: 'Exit', value: 'exit' },
+    ];
+    const handleMenuSelect = (value) => {
+        if (value === 'exit') {
+            process.exit(0);
+        }
+        setState(value);
+    };
+    if (state === 'menu') {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginY: 1, paddingX: 2, children: _jsx(Text, { bold: true, color: "green", children: "\uD83D\uDE80 Prompt Enhancer" }) }), _jsx(Box, { marginY: 0, paddingX: 2, children: _jsx(Text, { color: "gray", children: "Enhance your prompts with various LLM providers" }) }), _jsx(Box, { marginY: 1, paddingX: 2, children: _jsx(SelectInput, { items: menuItems, onSelect: item => handleMenuSelect(item.value), initialIndex: 0 }) })] }));
+    }
+    if (state === 'enhance') {
+        return _jsx(EnhancePromptComponent, { onBack: () => setState('menu') });
+    }
+    if (state === 'settings') {
+        return _jsx(SettingsComponent, { onBack: () => setState('menu') });
+    }
+    if (state === 'history') {
+        return _jsx(HistoryComponent, { onBack: () => setState('menu') });
+    }
+    if (state === 'help') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "Help" }), _jsx(Text, { children: "Prompt Enhancer is a CLI/TUI tool to enhance prompts using various LLM providers." }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Usage:" }), _jsx(Text, { children: "Interactive mode (TUI): prompt-enhancer" }), _jsx(Text, { children: "CLI mode: prompt-enhancer -p \"your prompt\"" }), _jsx(Text, { children: "Settings: Configure API keys in the Settings menu" }), _jsx(Text, { children: "History: View past enhancements in the History menu" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Supported Providers:" }), _jsx(Text, { children: "- Gemini (requires API key)" }), _jsx(Text, { children: "- Copilot (requires API key)" }), _jsx(Text, { children: "- Kilo (free tier available)" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Features:" }), _jsx(Text, { children: "- Real-time streaming output" }), _jsx(Text, { children: "- Persistent configuration (~/.prompt-enhancer/config.json)" }), _jsx(Text, { children: "- Enhancement history (~/.prompt-enhancer/history.json)" }), _jsx(Text, { children: "- Support for multiple providers" }), _jsx(Text, {}), _jsx(Text, { color: "gray", children: "(Press Ctrl+C to return to menu)" })] }));
+    }
+    return null;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import meow from 'meow';
+import App from './app.js';
+import Help from './commands/help.js';
+import hasFlag from 'has-flag';
+import About from './commands/about.js';
+import DirectEnhance from './commands/direct-enhance.js';
+// Handle Ctrl+C globally to exit from any screen
+process.on('SIGINT', () => {
+    process.exit(0);
+});
+const cli = meow(`
+	Usage
+	  $ prompt-enhancer
+
+	Options
+		--prompt,-p  Your prompt to enhance
+
+	Examples
+	  $ prompt-enhancer
+	  $ prompt-enhancer --prompt="Your prompt here"
+	  $ prompt-enhancer -p "Your prompt here"
+`, {
+    importMeta: import.meta,
+    flags: {
+        prompt: {
+            type: 'string',
+            shortFlag: 'p',
+        },
+    },
+});
+if (cli.input[0] === 'help' || hasFlag('--help')) {
+    render(_jsx(Help, {}));
+}
+else if (cli.flags.prompt) {
+    // Direct enhancement mode when --prompt/-p flag is provided
+    render(_jsx(DirectEnhance, { prompt: cli.flags.prompt }));
+}
+else {
+    // Interactive TUI mode (default)
+    render(_jsx(App, { prompt: "" }));
+}
+if (hasFlag('--debug')) {
+    console.log('Debug flags:', cli.flags);
+}
+if (hasFlag('--version')) {
+    await import('./commands/version.js');
+}
+if (hasFlag('--about')) {
+    render(_jsx(About, {}));
+}

package/dist/commands/about.d.ts

@@ -0,0 +1 @@
+export default function About(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/about.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import pkg from '../../package.json' with { type: 'json' };
+import { Text, Box } from 'ink';
+export default function About() {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, children: pkg.description }), _jsxs(Text, { children: ["Version: ", pkg.version] }), _jsxs(Text, { children: ["Author: ", pkg.author] }), _jsxs(Text, { children: ["License: ", pkg.license] }), _jsxs(Text, { children: ["Repository: ", pkg.repository.url] })] }));
+}

package/dist/commands/direct-enhance.d.ts

@@ -0,0 +1,5 @@
+interface DirectEnhanceProps {
+    prompt: string;
+}
+export default function DirectEnhance({ prompt }: DirectEnhanceProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/commands/direct-enhance.js

@@ -0,0 +1,52 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Text, Box } from 'ink';
+import { ConfigManager } from '../lib/config/manager.js';
+import { HistoryManager } from '../lib/history/manager.js';
+import { EnhancementEngine } from '../lib/enhancement/engine.js';
+export default function DirectEnhance({ prompt }) {
+    const [status, setStatus] = useState('initializing');
+    const [output, setOutput] = useState('');
+    const [error, setError] = useState('');
+    useEffect(() => {
+        (async () => {
+            try {
+                // Initialize managers
+                const configManager = new ConfigManager();
+                await configManager.load(); // Load config from file
+                const historyManager = new HistoryManager();
+                await historyManager.load(); // Load history from file
+                const engine = new EnhancementEngine(configManager, historyManager);
+                setStatus('enhancing');
+                // Stream enhancement
+                let result = '';
+                const generator = engine.enhanceStream({
+                    prompt,
+                    saveToHistory: true,
+                });
+                for await (const chunk of generator) {
+                    result += chunk;
+                    setOutput(result);
+                }
+                if (!result.trim()) {
+                    throw new Error('Enhancement returned an empty result — the model may be rate-limited or temporarily unavailable.');
+                }
+                setStatus('complete');
+            }
+            catch (err) {
+                setStatus('error');
+                setError(err instanceof Error ? err.message : String(err));
+            }
+        })();
+    }, [prompt]);
+    if (status === 'error') {
+        return (_jsx(Box, { flexDirection: "column", marginY: 1, children: _jsxs(Text, { color: "red", children: ["Error: ", error] }) }));
+    }
+    if (status === 'initializing') {
+        return _jsx(Text, { children: "Initializing..." });
+    }
+    if (status === 'enhancing') {
+        return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Enhancing prompt..." }), _jsx(Text, { children: output })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, children: [_jsx(Text, { bold: true, color: "green", children: "Enhanced prompt:" }), _jsx(Text, { children: output })] }));
+}

package/dist/commands/enhanceprompt.d.ts

@@ -0,0 +1 @@
+export default function EnhancePrompt(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/enhanceprompt.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, Box } from 'ink';
+// import React from 'react';
+export default function EnhancePrompt() {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, children: "Usage" }), _jsx(Text, { children: " $ %NAME%" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Options" }), _jsx(Text, { children: " --name Your name" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Examples" }), _jsx(Text, { children: " $ %NAME% --name=Jane" }), _jsx(Text, { children: " Hello, Jane" })] }));
+}

package/dist/commands/help.d.ts

@@ -0,0 +1 @@
+export default function Help(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/help.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// import React from 'react';
+import { Text, Box } from 'ink';
+export default function Help() {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, children: "Usage" }), _jsx(Text, { children: " $ %NAME%" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Options" }), _jsx(Text, { children: " --name Your name" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Examples" }), _jsx(Text, { children: " $ %NAME% --name=Jane" }), _jsx(Text, { children: " Hello, Jane" })] }));
+}

package/dist/commands/settings.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/settings.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/version.d.ts

@@ -0,0 +1 @@
+export default function DisplayVersion(): import("react/jsx-runtime").JSX.Element;

package/dist/commands/version.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import pkg from '../../package.json' with { type: 'json' };
+import { Text, Box } from 'ink';
+export default function DisplayVersion() {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, children: pkg.description }), _jsxs(Text, { children: [pkg.name, " v", pkg.version] })] }));
+}

package/dist/components/enhance-prompt.d.ts

@@ -0,0 +1,5 @@
+interface EnhancePromptProps {
+    onBack: () => void;
+}
+export default function EnhancePrompt({ onBack: _onBack }: EnhancePromptProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/enhance-prompt.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import TextInput from 'ink-text-input';
+import { ConfigManager } from '../lib/config/manager.js';
+import { HistoryManager } from '../lib/history/manager.js';
+import { EnhancementEngine } from '../lib/enhancement/engine.js';
+export default function EnhancePrompt({ onBack: _onBack }) {
+    const [state, setState] = useState('input');
+    const [prompt, setPrompt] = useState('');
+    const [enhancedText, setEnhancedText] = useState('');
+    const [error, setError] = useState('');
+    const [defaultProvider, setDefaultProvider] = useState('kilo');
+    const [loading, setLoading] = useState(true);
+    useEffect(() => {
+        (async () => {
+            try {
+                const configManager = new ConfigManager();
+                await configManager.load();
+                const cfg = configManager.getConfig();
+                setDefaultProvider(cfg.defaultProvider ?? 'kilo');
+                setLoading(false);
+            }
+            catch (_err) {
+                setError('Failed to load configuration');
+                setLoading(false);
+            }
+        })();
+    }, []);
+    const handleInputComplete = () => {
+        if (!prompt.trim()) {
+            setError('Prompt cannot be empty');
+            return;
+        }
+        setError('');
+        void enhancePrompt(defaultProvider);
+    };
+    const enhancePrompt = async (provider) => {
+        setState('enhancing');
+        try {
+            const configManager = new ConfigManager();
+            await configManager.load();
+            const historyManager = new HistoryManager();
+            await historyManager.load();
+            const engine = new EnhancementEngine(configManager, historyManager);
+            let result = '';
+            const generator = engine.enhanceStream({
+                prompt,
+                provider: provider,
+                saveToHistory: true,
+            });
+            for await (const chunk of generator) {
+                result += chunk;
+                setEnhancedText(result);
+            }
+            if (!result.trim()) {
+                throw new Error('Enhancement returned an empty result — the model may be rate-limited or temporarily unavailable. Try a different model.');
+            }
+            setState('complete');
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+            setState('error');
+        }
+    };
+    if (loading) {
+        return (_jsx(Box, { paddingX: 2, children: _jsx(Text, { color: "yellow", children: "Loading configuration..." }) }));
+    }
+    if (state === 'input') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "Enter prompt to enhance:" }), _jsxs(Box, { marginY: 1, children: [_jsx(Text, { children: "Prompt: " }), _jsx(TextInput, { value: prompt, onChange: setPrompt, onSubmit: handleInputComplete, placeholder: "Type your prompt here..." })] }), error && _jsxs(Text, { color: "red", children: ["Error: ", error] })] }));
+    }
+    if (state === 'enhancing') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsxs(Text, { bold: true, color: "cyan", children: ["Enhancing with ", defaultProvider, "..."] }), _jsx(Box, { marginY: 1, children: _jsx(Text, { children: enhancedText }) })] }));
+    }
+    if (state === 'complete') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "green", children: "\u2713 Enhancement complete!" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Original:" }), _jsx(Text, { children: prompt }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Enhanced:" }), _jsx(Text, { children: enhancedText }), _jsx(Text, {}), _jsx(Text, { color: "gray", children: "(Press Ctrl+C to return to menu)" })] }));
+    }
+    if (state === 'error') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "red", children: "\u2717 Error:" }), _jsx(Text, { color: "red", children: error }), _jsx(Text, {}), _jsx(Text, { color: "gray", children: "(Press Ctrl+C to return to menu)" })] }));
+    }
+    return null;
+}

package/dist/components/history-viewer.d.ts

@@ -0,0 +1,5 @@
+interface HistoryProps {
+    onBack: () => void;
+}
+export default function HistoryViewer({ onBack }: HistoryProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/components/history-viewer.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text } from 'ink';
+import SelectInput from './select-input.js';
+import { HistoryManager } from '../lib/history/manager.js';
+export default function HistoryViewer({ onBack }) {
+    const [state, setState] = useState('empty');
+    const [entries, setEntries] = useState([]);
+    const [selectedEntry, setSelectedEntry] = useState(null);
+    const [message, setMessage] = useState('');
+    useEffect(() => {
+        (async () => {
+            try {
+                const historyManager = new HistoryManager();
+                await historyManager.load();
+                const allEntries = historyManager.getEntries();
+                if (allEntries.length === 0) {
+                    setState('empty');
+                }
+                else {
+                    setEntries(allEntries);
+                    setState('list');
+                }
+            }
+            catch (err) {
+                setMessage(err instanceof Error ? err.message : String(err));
+                setState('error');
+            }
+        })();
+    }, []);
+    const handleListSelect = (index) => {
+        if (index < entries.length) {
+            const entry = entries[index];
+            if (entry) {
+                setSelectedEntry(entry);
+                setState('detail');
+            }
+        }
+        else if (index === entries.length) {
+            // Back option
+            onBack();
+        }
+    };
+    if (state === 'empty') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { color: "yellow", children: "No enhancement history yet." }), _jsx(Text, { children: "Enhance a prompt to get started!" }), _jsx(Text, {}), _jsx(Text, { color: "gray", children: "(Press Ctrl+C to return to menu)" })] }));
+    }
+    if (state === 'error') {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsxs(Text, { color: "red", children: ["Error loading history: ", message] }), _jsx(Text, { color: "gray", children: "(Press Ctrl+C to return to menu)" })] }));
+    }
+    if (state === 'list') {
+        const items = entries.map((entry, idx) => ({
+            label: `${new Date(entry.timestamp).toISOString().substring(0, 10)} - ${entry.provider}${entry.originalPrompt.length > 50
+                ? `: ${entry.originalPrompt.substring(0, 50)}...`
+                : `: ${entry.originalPrompt}`}`,
+            value: idx,
+        }));
+        items.push({ label: 'Back', value: entries.length });
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "Enhancement History" }), _jsx(Box, { marginY: 1, children: _jsx(SelectInput, { items: items, onSelect: item => handleListSelect(item.value), initialIndex: 0 }) })] }));
+    }
+    if (state === 'detail' && selectedEntry) {
+        return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: "Enhancement Details" }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Date:" }), _jsx(Text, { children: new Date(selectedEntry.timestamp).toISOString() }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Provider:" }), _jsx(Text, { children: selectedEntry.provider }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Model:" }), _jsx(Text, { children: selectedEntry.model }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Original Prompt:" }), _jsx(Text, { children: selectedEntry.originalPrompt }), _jsx(Text, {}), _jsx(Text, { bold: true, children: "Enhanced Result:" }), _jsx(Text, { children: selectedEntry.enhancedPrompt }), _jsx(Text, {}), _jsx(Box, { marginY: 1, children: _jsx(SelectInput, { items: [{ label: 'Back to List', value: 'back' }], onSelect: () => setState('list'), initialIndex: 0 }) })] }));
+    }
+    return null;
+}

package/dist/components/menu.d.ts

@@ -0,0 +1,11 @@
+export interface MenuItem {
+    label: string;
+    value: string;
+}
+interface MenuProps {
+    title: string;
+    items: MenuItem[];
+    onSelect: (value: string) => void;
+}
+export default function Menu({ title, items, onSelect }: MenuProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/menu.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import SelectInput from './select-input.js';
+export default function Menu({ title, items, onSelect }) {
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, children: [_jsx(Text, { bold: true, color: "cyan", children: title }), _jsx(Box, { children: _jsx(SelectInput, { items: items, onSelect: item => onSelect(item.value), initialIndex: 0 }) })] }));
+}

package/dist/components/select-input.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Custom SelectInput that avoids ink-select-input's handler re-registration
+ * bug. The useInput handler has stable identity (empty deps), so ink never
+ * tears down / re-adds the listener when selectedIndex changes. Current state
+ * is accessed through refs that are updated synchronously on every render.
+ */
+export interface SelectItem<T = string> {
+    label: string;
+    value: T;
+}
+interface Props<T = string> {
+    items: Array<SelectItem<T>>;
+    onSelect: (item: SelectItem<T>) => void;
+    initialIndex?: number;
+    isFocused?: boolean;
+    limit?: number;
+}
+export default function SelectInput<T = string>({ items, onSelect, initialIndex, isFocused, limit, }: Props<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/select-input.js

@@ -0,0 +1,51 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Custom SelectInput that avoids ink-select-input's handler re-registration
+ * bug. The useInput handler has stable identity (empty deps), so ink never
+ * tears down / re-adds the listener when selectedIndex changes. Current state
+ * is accessed through refs that are updated synchronously on every render.
+ */
+import { useState, useEffect, useRef, useCallback } from 'react';
+import { Box, Text, useInput } from 'ink';
+export default function SelectInput({ items, onSelect, initialIndex = 0, isFocused = true, limit, }) {
+    const [selectedIndex, setSelectedIndex] = useState(initialIndex);
+    // Refs updated synchronously each render — always current inside the stable handler
+    const indexRef = useRef(selectedIndex);
+    const itemsRef = useRef(items);
+    const onSelectRef = useRef(onSelect);
+    indexRef.current = selectedIndex;
+    itemsRef.current = items;
+    onSelectRef.current = onSelect;
+    // Reset selection when the items list changes
+    useEffect(() => {
+        setSelectedIndex(0);
+        indexRef.current = 0;
+    }, [items]);
+    // Stable handler — empty deps means ink registers this ONCE and never
+    // tears it down while the component is mounted.
+    const handleInput = useCallback((_input, key) => {
+        const current = indexRef.current;
+        const list = itemsRef.current;
+        if (key.upArrow) {
+            const next = current > 0 ? current - 1 : list.length - 1;
+            indexRef.current = next;
+            setSelectedIndex(next);
+        }
+        else if (key.downArrow) {
+            const next = current < list.length - 1 ? current + 1 : 0;
+            indexRef.current = next;
+            setSelectedIndex(next);
+        }
+        else if (key.return) {
+            const item = list[indexRef.current];
+            if (item)
+                onSelectRef.current(item);
+        }
+    }, []); // intentionally empty — accesses all live values via refs
+    useInput(handleInput, { isActive: isFocused });
+    const displayItems = limit ? items.slice(0, limit) : items;
+    return (_jsx(Box, { flexDirection: "column", children: displayItems.map((item, index) => {
+            const isSelected = index === selectedIndex;
+            return (_jsx(Box, { children: _jsxs(Text, { color: isSelected ? 'blue' : undefined, children: [isSelected ? '❯ ' : '  ', item.label] }) }, String(item.value)));
+        }) }));
+}

package/dist/components/settings.d.ts

@@ -0,0 +1,5 @@
+interface SettingsProps {
+    onBack: () => void;
+}
+export default function Settings({ onBack }: SettingsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};