@flyingrobots/bijou 1.1.0 → 1.2.0

package/dist/core/forms/filter-interactive.js

@@ -0,0 +1,241 @@
+/**
+ * Interactive filter select UI with real-time search and vim-style modes.
+ *
+ * Starts in **normal mode** where `j`/`k` navigate and any printable character
+ * (except `j`/`k`) switches to insert mode and types the character. Press `/`
+ * to enter insert mode without typing. In **insert mode**, all keys are
+ * printable (including `j`/`k`), arrow keys navigate, and Escape returns to
+ * normal mode. Ctrl+C cancels from either mode; Escape in normal mode cancels.
+ */
+import { formatFormTitle, terminalRenderer, createStyledFn, createBoldFn } from './form-utils.js';
+/**
+ * Default case-insensitive substring matcher for filter options.
+ *
+ * Check the option label first, then fall back to keyword matches.
+ *
+ * @param query - User's search input.
+ * @param option - Option to test against.
+ * @returns `true` if the query matches the label or any keyword.
+ */
+export function defaultMatch(query, option) {
+    const q = query.toLowerCase();
+    if (option.label.toLowerCase().includes(q))
+        return true;
+    if (option.keywords) {
+        return option.keywords.some((kw) => kw.toLowerCase().includes(q));
+    }
+    return false;
+}
+/**
+ * Render a keyboard-navigable filter select with vim-style normal/insert modes.
+ *
+ * Starts in normal mode: `j`/`k` navigate, `/` enters insert mode, any other
+ * printable enters insert mode and types the character. In insert mode, all keys
+ * are printable, arrow keys navigate, Escape returns to normal mode. Enter
+ * confirms from either mode, Ctrl+C cancels from either mode, Escape in normal
+ * mode cancels.
+ *
+ * @param options - Filter field configuration.
+ * @param ctx - Bijou context.
+ * @returns The value of the selected (or default/first) option.
+ */
+export async function interactiveFilter(options, ctx) {
+    if (options.options.length === 0) {
+        throw new Error('[bijou] filter(): options array must contain at least one option');
+    }
+    const noColor = ctx.theme.noColor;
+    const t = ctx.theme;
+    const styledFn = createStyledFn(ctx);
+    const boldFn = createBoldFn(ctx);
+    const matchFn = options.match ?? defaultMatch;
+    const maxVisible = options.maxVisible ?? 7;
+    const term = terminalRenderer(ctx);
+    let mode = 'normal';
+    let query = '';
+    let cursor = 0;
+    let scrollOffset = 0;
+    let filtered = [...options.options];
+    function applyFilter() {
+        if (query === '') {
+            filtered = [...options.options];
+        }
+        else {
+            filtered = options.options.filter((opt) => matchFn(query, opt));
+        }
+        cursor = Math.min(cursor, Math.max(0, filtered.length - 1));
+        clampScroll();
+    }
+    function clampScroll() {
+        if (cursor < scrollOffset) {
+            scrollOffset = cursor;
+        }
+        else if (cursor >= scrollOffset + maxVisible) {
+            scrollOffset = cursor - maxVisible + 1;
+        }
+        scrollOffset = Math.max(0, Math.min(scrollOffset, Math.max(0, filtered.length - maxVisible)));
+    }
+    function visibleItems() {
+        return filtered.slice(scrollOffset, scrollOffset + maxVisible);
+    }
+    function renderLineCount() {
+        return 2 + Math.min(filtered.length, maxVisible) + 1; // header + filter input + items + status
+    }
+    function render() {
+        const label = formatFormTitle(options.title, ctx);
+        term.writeLine(label);
+        // Filter input with mode indicator (: normal, / insert)
+        const indicator = mode === 'insert' ? '/' : ':';
+        const filterDisplay = query || (options.placeholder ? styledFn(t.theme.semantic.muted, options.placeholder) : '');
+        ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, indicator)} ${filterDisplay}\n`);
+        // Visible items
+        const vis = visibleItems();
+        for (let i = 0; i < vis.length; i++) {
+            const opt = vis[i];
+            const isCurrent = scrollOffset + i === cursor;
+            const prefix = isCurrent ? '❯' : ' ';
+            if (isCurrent && !noColor) {
+                ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, prefix)} ${boldFn(opt.label)}\n`);
+            }
+            else {
+                ctx.io.write(`\x1b[K  ${prefix} ${opt.label}\n`);
+            }
+        }
+        // Status
+        const status = `${filtered.length}/${options.options.length} items`;
+        ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.muted, status)}\n`);
+    }
+    function clearRender(lineCount) {
+        term.moveUp(lineCount);
+    }
+    function clearAndRerender(prevLineCount) {
+        clearRender(prevLineCount);
+        term.clearBlock(prevLineCount);
+        render();
+    }
+    function cleanup() {
+        const total = renderLineCount();
+        clearRender(total);
+        term.clearBlock(total);
+        const selected = filtered[cursor];
+        const selectedLabel = selected ? selected.label : '(none)';
+        const label = formatFormTitle(options.title, ctx) + ' ' + styledFn(t.theme.semantic.info, selectedLabel);
+        ctx.io.write(`\x1b[K${label}\n`);
+        term.showCursor();
+    }
+    term.hideCursor();
+    render();
+    // navigateUp/navigateDown use clearRender + render instead of clearAndRerender
+    // because render() uses per-line \x1b[K (clear-to-end-of-line), making a full
+    // clearBlock unnecessary for a simple cursor position change.
+    function navigateUp() {
+        if (filtered.length === 0)
+            return;
+        const prevLineCount = renderLineCount();
+        cursor = (cursor - 1 + filtered.length) % filtered.length;
+        clampScroll();
+        clearRender(prevLineCount);
+        render();
+    }
+    function navigateDown() {
+        if (filtered.length === 0)
+            return;
+        const prevLineCount = renderLineCount();
+        cursor = (cursor + 1) % filtered.length;
+        clampScroll();
+        clearRender(prevLineCount);
+        render();
+    }
+    function typeChar(ch) {
+        const prevLineCount = renderLineCount();
+        query += ch;
+        applyFilter();
+        clearAndRerender(prevLineCount);
+    }
+    // switchMode uses the same lightweight rerender pattern as navigate functions —
+    // only the mode indicator line changes, and render() clears each line with \x1b[K.
+    function switchMode(newMode) {
+        mode = newMode;
+        const prevLineCount = renderLineCount();
+        clearRender(prevLineCount);
+        render();
+    }
+    return new Promise((resolve) => {
+        const handle = ctx.io.rawInput((key) => {
+            // ── Mode-independent ───────────────────────────────────
+            if (key === '\r' || key === '\n') {
+                handle.dispose();
+                cleanup();
+                resolve(filtered[cursor]?.value ?? options.defaultValue ?? options.options[0].value);
+                return;
+            }
+            if (key === '\x03') {
+                // Ctrl+C — cancel from either mode
+                handle.dispose();
+                cleanup();
+                resolve(options.defaultValue ?? options.options[0].value);
+                return;
+            }
+            // ── Normal mode ────────────────────────────────────────
+            if (mode === 'normal') {
+                if (key === '\x1b') {
+                    // Escape in normal mode — cancel
+                    // TODO: bare \x1b may false-trigger on slow connections where escape
+                    // sequences arrive as separate bytes. Timer-based disambiguation is a
+                    // shared debt with textarea-editor.ts — unify in a future PR.
+                    handle.dispose();
+                    cleanup();
+                    resolve(options.defaultValue ?? options.options[0].value);
+                    return;
+                }
+                if (key === 'j' || key === '\x1b[B') {
+                    navigateDown();
+                    return;
+                }
+                if (key === 'k' || key === '\x1b[A') {
+                    navigateUp();
+                    return;
+                }
+                if (key === '/') {
+                    // Enter insert mode without typing
+                    switchMode('insert');
+                    return;
+                }
+                // Any other printable — enter insert mode and type the char
+                if (key.length === 1 && key >= ' ') {
+                    mode = 'insert';
+                    typeChar(key);
+                    return;
+                }
+                return;
+            }
+            // ── Insert mode ────────────────────────────────────────
+            if (key === '\x1b') {
+                // Escape in insert mode — return to normal
+                switchMode('normal');
+                return;
+            }
+            if (key === '\x1b[A') {
+                navigateUp();
+                return;
+            }
+            if (key === '\x1b[B') {
+                navigateDown();
+                return;
+            }
+            if (key === '\x7f' || key === '\b') {
+                if (query.length > 0) {
+                    const prevLineCount = renderLineCount();
+                    query = query.slice(0, -1);
+                    applyFilter();
+                    clearAndRerender(prevLineCount);
+                }
+                return;
+            }
+            // Printable character (all printable keys including j/k)
+            if (key.length === 1 && key >= ' ') {
+                typeChar(key);
+            }
+        });
+    });
+}
+//# sourceMappingURL=filter-interactive.js.map

package/dist/core/forms/filter-interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-interactive.js","sourceRoot":"","sources":["../../../src/core/forms/filter-interactive.ts"],"names":[],"mappings":"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"}

package/dist/core/forms/filter.d.ts

@@ -1,35 +1,5 @@
-import type { FieldOptions } from './types.js';
-import type { BijouContext } from '../../ports/context.js';
-/**
- * Single option in a filterable select list.
- *
- * @typeParam T - Type of the option's value.
- */
-export interface FilterOption<T> {
-    /** Display label shown in the option list. */
-    label: string;
-    /** Value returned when this option is selected. */
-    value: T;
-    /** Additional search keywords that match this option during filtering. */
-    keywords?: string[];
-}
-/**
- * Options for the filterable select field.
- *
- * @typeParam T - Type of each option's value.
- */
-export interface FilterOptions<T> extends FieldOptions<T> {
-    /** List of filterable options. */
-    options: FilterOption<T>[];
-    /** Placeholder text shown in the filter input when empty. */
-    placeholder?: string;
-    /** Maximum number of options visible at once. Default: 7. */
-    maxVisible?: number;
-    /** Custom match function for filtering. Defaults to case-insensitive label/keyword substring match. */
-    match?: (query: string, option: FilterOption<T>) => boolean;
-    /** Bijou context for IO, styling, and mode detection. */
-    ctx?: BijouContext;
-}
+export type { FilterOption, FilterOptions } from './filter-interactive.js';
+import type { FilterOptions } from './filter-interactive.js';
 /**
  * Prompt the user to choose one item from a filterable list.
  *

package/dist/core/forms/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/core/forms/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,EAAE,CAAC,CAAC;IACT,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IACvD,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IAC5D,yDAAyD;IACzD,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAarE"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/core/forms/filter.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAarE"}

package/dist/core/forms/filter.js

@@ -1,23 +1,6 @@
 import { resolveCtx } from '../resolve-ctx.js';
-import { formatFormTitle, renderNumberedOptions, terminalRenderer, formDispatch, createStyledFn, createBoldFn } from './form-utils.js';
-/**
- * Default case-insensitive substring matcher for filter options.
- *
- * Check the option label first, then fall back to keyword matches.
- *
- * @param query - User's search input.
- * @param option - Option to test against.
- * @returns `true` if the query matches the label or any keyword.
- */
-function defaultMatch(query, option) {
-    const q = query.toLowerCase();
-    if (option.label.toLowerCase().includes(q))
-        return true;
-    if (option.keywords) {
-        return option.keywords.some((kw) => kw.toLowerCase().includes(q));
-    }
-    return false;
-}
+import { formatFormTitle, renderNumberedOptions, formDispatch } from './form-utils.js';
+import { defaultMatch, interactiveFilter } from './filter-interactive.js';
 /**
  * Prompt the user to choose one item from a filterable list.
  *
@@ -69,152 +52,4 @@ async function fallbackFilter(options, ctx) {
     }
     return options.defaultValue ?? options.options[0].value;
 }
-/**
- * Render a keyboard-navigable filter select using raw terminal input.
- *
- * Typing narrows the visible options in real time. Arrow keys navigate,
- * Enter confirms, Backspace edits the query, Ctrl+C or Escape cancels.
- *
- * @param options - Filter field configuration.
- * @param ctx - Bijou context.
- * @returns The value of the selected (or default/first) option.
- */
-async function interactiveFilter(options, ctx) {
-    const noColor = ctx.theme.noColor;
-    const t = ctx.theme;
-    const styledFn = createStyledFn(ctx);
-    const boldFn = createBoldFn(ctx);
-    const matchFn = options.match ?? defaultMatch;
-    const maxVisible = options.maxVisible ?? 7;
-    const term = terminalRenderer(ctx);
-    let query = '';
-    let cursor = 0;
-    let filtered = [...options.options];
-    function applyFilter() {
-        if (query === '') {
-            filtered = [...options.options];
-        }
-        else {
-            filtered = options.options.filter((opt) => matchFn(query, opt));
-        }
-        cursor = Math.min(cursor, Math.max(0, filtered.length - 1));
-    }
-    function visibleItems() {
-        return filtered.slice(0, maxVisible);
-    }
-    function renderLineCount() {
-        return 2 + Math.min(filtered.length, maxVisible) + 1; // header + filter input + items + status
-    }
-    function render() {
-        const label = formatFormTitle(options.title, ctx);
-        term.hideCursor();
-        term.writeLine(label);
-        // Filter input
-        const filterDisplay = query || (options.placeholder ? styledFn(t.theme.semantic.muted, options.placeholder) : '');
-        ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, '/')} ${filterDisplay}\n`);
-        // Visible items
-        const vis = visibleItems();
-        for (let i = 0; i < vis.length; i++) {
-            const opt = vis[i];
-            const isCurrent = i === cursor;
-            const prefix = isCurrent ? '❯' : ' ';
-            if (isCurrent && !noColor) {
-                ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.info, prefix)} ${boldFn(opt.label)}\n`);
-            }
-            else {
-                ctx.io.write(`\x1b[K  ${prefix} ${opt.label}\n`);
-            }
-        }
-        // Status
-        const status = `${filtered.length}/${options.options.length} items`;
-        ctx.io.write(`\x1b[K  ${styledFn(t.theme.semantic.muted, status)}\n`);
-    }
-    function clearRender() {
-        const total = renderLineCount();
-        term.moveUp(total);
-    }
-    function clearAndRerender(prevLineCount) {
-        term.moveUp(prevLineCount);
-        term.clearBlock(prevLineCount);
-        render();
-    }
-    function cleanup() {
-        const total = renderLineCount();
-        clearRender();
-        term.clearBlock(total);
-        const selected = filtered[cursor];
-        const selectedLabel = selected ? selected.label : '(none)';
-        const label = formatFormTitle(options.title, ctx) + ' ' + styledFn(t.theme.semantic.info, selectedLabel);
-        ctx.io.write(`\x1b[K${label}\n`);
-        term.showCursor();
-    }
-    render();
-    return new Promise((resolve) => {
-        const handle = ctx.io.rawInput((key) => {
-            if (key === '\r' || key === '\n') {
-                // Enter — select
-                handle.dispose();
-                cleanup();
-                resolve(filtered[cursor]?.value ?? options.defaultValue ?? options.options[0].value);
-                return;
-            }
-            if (key === '\x03' || key === '\x1b') {
-                // Ctrl+C or Escape — cancel
-                // Note: bare \x1b may false-trigger on slow connections where escape
-                // sequences arrive as separate bytes. Timer-based disambiguation is a
-                // separate future improvement.
-                handle.dispose();
-                cleanup();
-                resolve(options.defaultValue ?? options.options[0].value);
-                return;
-            }
-            if (key === '\x1b[A' || key === 'k') {
-                // Up
-                if (filtered.length === 0)
-                    return;
-                cursor = (cursor - 1 + filtered.length) % filtered.length;
-                clearRender();
-                render();
-                return;
-            }
-            if (key === '\x1b[B' || key === 'j') {
-                // Down — but only when query is empty (j is a printable char for filtering)
-                if (key === 'j' && query === '') {
-                    // Start filtering with 'j'
-                    query += key;
-                    applyFilter();
-                    clearRender();
-                    render();
-                    return;
-                }
-                if (key === '\x1b[B') {
-                    if (filtered.length === 0)
-                        return;
-                    cursor = (cursor + 1) % filtered.length;
-                    clearRender();
-                    render();
-                    return;
-                }
-                // j when query is non-empty — fall through to printable handler
-            }
-            if (key === '\x7f' || key === '\b') {
-                // Backspace
-                if (query.length > 0) {
-                    const prevLineCount = renderLineCount();
-                    query = query.slice(0, -1);
-                    applyFilter();
-                    clearAndRerender(prevLineCount);
-                }
-                return;
-            }
-            // Printable character (filter input)
-            if (key.length === 1 && key >= ' ') {
-                const prevLineCount = renderLineCount();
-                query += key;
-                applyFilter();
-                clearAndRerender(prevLineCount);
-            }
-        });
-    });
-}
 //# sourceMappingURL=filter.js.map

package/dist/core/forms/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/core/forms/filter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/core/forms/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI1E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAyB;IACvD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,YAAY,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,OAAO,YAAY,CACjB,GAAG,EACH,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,EACpC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAClC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,cAAc,CAAI,OAAyB,EAAE,GAAiB;IAC3E,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,qBAAqB,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAE9B,8BAA8B;IAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC,KAAK,CAAC;IACrC,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACrE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC;AAC3D,CAAC"}

package/dist/core/forms/textarea-editor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Interactive textarea editor state machine.
+ *
+ * Renders a scrollable multi-line editor with cursor navigation,
+ * optional line numbers, placeholder text, and max-length guard.
+ * Ctrl+D submits; Ctrl+C or Escape cancels.
+ */
+import type { FieldOptions } from './types.js';
+import type { BijouContext } from '../../ports/context.js';
+/**
+ * Options for the multi-line textarea field.
+ */
+export interface TextareaOptions extends FieldOptions<string> {
+    /** Placeholder text shown when the textarea is empty. */
+    placeholder?: string;
+    /** Maximum character count (including newlines). */
+    maxLength?: number;
+    /** Display line numbers in the gutter. Default: false. */
+    showLineNumbers?: boolean;
+    /** Visible editor height in lines. Default: 6. */
+    height?: number;
+    /** Render width in columns. Default: 80. */
+    width?: number;
+    /** Bijou context for IO, styling, and mode detection. */
+    ctx?: BijouContext;
+}
+/**
+ * Render a full interactive textarea editor using raw terminal input.
+ *
+ * Supports arrow-key cursor movement, scrolling, line wrapping,
+ * optional line numbers, placeholder text, and a max-length guard.
+ * Ctrl+D submits; Ctrl+C or Escape cancels.
+ *
+ * @param options - Textarea field configuration.
+ * @param ctx - Bijou context.
+ * @returns The entered text (newline-joined), or the default value on cancel.
+ */
+export declare function interactiveTextarea(options: TextareaOptions, ctx: BijouContext): Promise<string>;
+//# sourceMappingURL=textarea-editor.d.ts.map

package/dist/core/forms/textarea-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea-editor.d.ts","sourceRoot":"","sources":["../../../src/core/forms/textarea-editor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,MAAM,CAAC;IAC3D,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAsMtG"}