@flyingrobots/bijou 7.1.0 → 8.0.0-rc.1

package/dist/core/forms/form-utils.d.ts

@@ -1,156 +1,4 @@
-/**
- * Shared form utilities extracted from duplicated patterns across
- * select, multiselect, filter, textarea, input, and confirm.
- *
- * These are internal helpers — not exported from the public barrel.
- *
- * @module core/forms/form-utils
- */
-import type { BijouContext } from '../../ports/context.js';
-import type { KeyInputMsg, RawInputHandle } from '../../ports/io.js';
-import type { TokenValue } from '../theme/tokens.js';
-/**
- * Format a form title with the `?` prefix and theme-aware styling.
- *
- * Returns `? title` with styling in color mode, or plain `? title`
- * in noColor/accessible modes. The `?` prefix is always included
- * for visual parity across modes.
- *
- * @param title - The form prompt text.
- * @param ctx - Bijou context for styling and mode detection.
- * @returns The formatted title string (no trailing newline).
- */
-export declare function formatFormTitle(title: string, ctx: BijouContext): string;
-/**
- * Write a styled validation error message to the output.
- *
- * Applies `semantic.error` styling in color mode, plain text in
- * noColor/accessible modes.
- *
- * @param message - The error message to display.
- * @param ctx - Bijou context for styling and mode detection.
- */
-export declare function writeValidationError(message: string, ctx: BijouContext): void;
-/**
- * Render a numbered list of options to the output.
- *
- * Used by form fallback modes (select, multiselect, filter) when
- * interactive arrow-key navigation is unavailable.
- *
- * @param options - Array of options with `label` and optional `description`.
- * @param ctx - Bijou context for output.
- */
-export declare function renderNumberedOptions(options: ReadonlyArray<{
-    label: string;
-    description?: string;
-}>, ctx: BijouContext): void;
-/**
- * ANSI terminal rendering utilities for interactive form components.
- *
- * Provides cursor control helpers that replace the duplicated raw ANSI
- * escape sequences scattered across form interactive modes.
- */
-export interface TerminalRenderer {
-    /** Hide the terminal cursor. */
-    hideCursor(): void;
-    /** Show the terminal cursor. */
-    showCursor(): void;
-    /** Clear the current line and write text followed by a newline. */
-    writeLine(text: string): void;
-    /** Move the cursor up by the given number of lines. */
-    moveUp(lines: number): void;
-    /** Clear a block of N lines and return the cursor to the top of the block. */
-    clearBlock(lineCount: number): void;
-}
-/**
- * Create a {@link TerminalRenderer} that writes ANSI escape sequences
- * to `ctx.io`.
- *
- * @param ctx - Bijou context for I/O access.
- * @returns A renderer with cursor control methods.
- */
-export declare function terminalRenderer(ctx: BijouContext): TerminalRenderer;
-/**
- * Create a noColor-safe styling function.
- *
- * Returns an identity function `(token, text) => text` when `noColor`
- * is true or mode is `accessible`, or `ctx.style.styled` otherwise.
- * Eliminates per-callsite `noColor ? text : styledFn(token, text)` guards.
- *
- * @param ctx - Bijou context for noColor/accessible detection and style access.
- * @returns A function `(token, text) => string`.
- */
-export declare function createStyledFn(ctx: BijouContext): (token: TokenValue, text: string) => string;
-/**
- * Create a noColor-safe bold function.
- *
- * Returns an identity function when `noColor` is true or mode is
- * `accessible`, or `ctx.style.bold` otherwise.
- *
- * @param ctx - Bijou context for noColor/accessible detection and style access.
- * @returns A function `(text) => string`.
- */
-export declare function createBoldFn(ctx: BijouContext): (text: string) => string;
-/**
- * Keep a scroll offset so the cursor stays within a visible window.
- *
- * First adjusts the offset relative to the cursor position, then
- * clamps to the absolute bounds `[0, max(0, itemCount - maxVisible)]`.
- *
- * @param cursor - Current cursor index.
- * @param scrollOffset - Current scroll offset.
- * @param maxVisible - Maximum number of items visible at once.
- * @param itemCount - Total number of items.
- * @returns The updated scroll offset.
- */
-export declare function clampScroll(cursor: number, scrollOffset: number, maxVisible: number, itemCount: number): number;
-/**
- * Subscribe to semantic form key input, preferring `ctx.io.keyInput()` when
- * available and falling back to decoding `rawInput()` sequences otherwise.
- *
- * This keeps interactive forms deterministic in tests without forcing
- * production adapters away from the lower-level raw-input contract.
- *
- * @param ctx - Bijou context providing the input port.
- * @param onKey - Callback invoked for each semantic key.
- * @returns A disposable handle that stops further key delivery.
- */
-export declare function subscribeFormKeyInput(ctx: BijouContext, onKey: (key: KeyInputMsg) => void): RawInputHandle;
-/**
- * Whether a semantic key carries printable text.
- *
- * @param key - The semantic key to test.
- * @returns `true` when the key represents typed text.
- */
-export declare function isPrintableKey(key: KeyInputMsg): key is KeyInputMsg & {
-    text: string;
-};
-/**
- * Match a semantic key by logical key name and optional modifier flags.
- *
- * @param msg - The key message to test.
- * @param key - Expected logical key name.
- * @param mods - Optional modifier constraints.
- * @returns `true` when the key matches.
- */
-export declare function isKey(msg: KeyInputMsg, key: string, mods?: Partial<Pick<KeyInputMsg, 'ctrl' | 'alt' | 'shift'>>): boolean;
-/**
- * Handle up/down (arrow key or j/k) navigation in a wrapping list.
- *
- * @param key - The semantic keypress.
- * @param cursor - Current cursor index.
- * @param length - Total number of items.
- * @returns The new cursor index, or `null` if the key was not a vertical nav key.
- */
-export declare function handleVerticalNav(key: KeyInputMsg, cursor: number, length: number): number | null;
-/**
- * Route a form to its interactive or fallback handler based on
- * output mode and TTY state.
- *
- * @param ctx - Resolved bijou context.
- * @param interactive - Handler for interactive TTY mode.
- * @param fallback - Handler for non-interactive / pipe / static / accessible modes.
- * @returns The result from whichever handler was selected.
- */
-export declare function formDispatch<T>(ctx: BijouContext, interactive: (ctx: BijouContext) => Promise<T>, fallback: (ctx: BijouContext) => Promise<T>): Promise<T>;
+export { clampScroll, createBoldFn, createStyledFn, formatFormTitle, isPrintableKey, renderNumberedOptions, subscribeFormKeyInput, terminalRenderer, writeValidationError } from './form-utils.part01.js';
+export type { TerminalRenderer } from './form-utils.part01.js';
+export { formDispatch, handleVerticalNav, isKey } from './form-utils.part02.js';
 //# sourceMappingURL=form-utils.d.ts.map

package/dist/core/forms/form-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-utils.d.ts","sourceRoot":"","sources":["../../../src/core/forms/form-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAKxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAM7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/D,GAAG,EAAE,YAAY,GAChB,IAAI,CAMN;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,gCAAgC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8EAA8E;IAC9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CA2BpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAG7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAGxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAChC,cAAc,CAShB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAEtF;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,CAAM,GAC9D,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,QAAQ,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAKZ"}
+{"version":3,"file":"form-utils.d.ts","sourceRoot":"","sources":["../../../src/core/forms/form-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC1M,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/core/forms/form-utils.js

@@ -1,232 +1,3 @@
-/**
- * Shared form utilities extracted from duplicated patterns across
- * select, multiselect, filter, textarea, input, and confirm.
- *
- * These are internal helpers — not exported from the public barrel.
- *
- * @module core/forms/form-utils
- */
-import { cursorGuard } from '../components/cursor-guard.js';
-import { CLEAR_LINE_RETURN } from '../ansi.js';
-import { decodeRawKeySequence } from '../key-input.js';
-/**
- * Format a form title with the `?` prefix and theme-aware styling.
- *
- * Returns `? title` with styling in color mode, or plain `? title`
- * in noColor/accessible modes. The `?` prefix is always included
- * for visual parity across modes.
- *
- * @param title - The form prompt text.
- * @param ctx - Bijou context for styling and mode detection.
- * @returns The formatted title string (no trailing newline).
- */
-export function formatFormTitle(title, ctx) {
-    if (ctx.theme.noColor || ctx.mode === 'accessible') {
-        return `? ${title}`;
-    }
-    return ctx.style.styled(ctx.semantic('info'), '? ') + ctx.style.bold(title);
-}
-/**
- * Write a styled validation error message to the output.
- *
- * Applies `semantic.error` styling in color mode, plain text in
- * noColor/accessible modes.
- *
- * @param message - The error message to display.
- * @param ctx - Bijou context for styling and mode detection.
- */
-export function writeValidationError(message, ctx) {
-    if (ctx.theme.noColor || ctx.mode === 'accessible') {
-        ctx.io.write(message + '\n');
-    }
-    else {
-        ctx.io.write(ctx.style.styled(ctx.semantic('error'), message) + '\n');
-    }
-}
-/**
- * Render a numbered list of options to the output.
- *
- * Used by form fallback modes (select, multiselect, filter) when
- * interactive arrow-key navigation is unavailable.
- *
- * @param options - Array of options with `label` and optional `description`.
- * @param ctx - Bijou context for output.
- */
-export function renderNumberedOptions(options, ctx) {
-    for (let i = 0; i < options.length; i++) {
-        const opt = options[i];
-        const desc = opt.description ? ` \u2014 ${opt.description}` : '';
-        ctx.io.write(`  ${i + 1}. ${opt.label}${desc}\n`);
-    }
-}
-/**
- * Create a {@link TerminalRenderer} that writes ANSI escape sequences
- * to `ctx.io`.
- *
- * @param ctx - Bijou context for I/O access.
- * @returns A renderer with cursor control methods.
- */
-export function terminalRenderer(ctx) {
-    let cursorHandle = null;
-    return {
-        hideCursor() {
-            if (cursorHandle === null) {
-                cursorHandle = cursorGuard(ctx.io).hide();
-            }
-        },
-        showCursor() {
-            if (cursorHandle !== null) {
-                cursorHandle.dispose();
-                cursorHandle = null;
-            }
-        },
-        writeLine(text) {
-            ctx.io.write(`${CLEAR_LINE_RETURN}${text}\n`);
-        },
-        moveUp(lines) {
-            if (lines <= 0)
-                return;
-            ctx.io.write(`\x1b[${lines}A`);
-        },
-        clearBlock(lineCount) {
-            if (lineCount <= 0)
-                return;
-            for (let i = 0; i < lineCount; i++)
-                ctx.io.write('\x1b[K\n');
-            ctx.io.write(`\x1b[${lineCount}A`);
-        },
-    };
-}
-/**
- * Create a noColor-safe styling function.
- *
- * Returns an identity function `(token, text) => text` when `noColor`
- * is true or mode is `accessible`, or `ctx.style.styled` otherwise.
- * Eliminates per-callsite `noColor ? text : styledFn(token, text)` guards.
- *
- * @param ctx - Bijou context for noColor/accessible detection and style access.
- * @returns A function `(token, text) => string`.
- */
-export function createStyledFn(ctx) {
-    if (ctx.theme.noColor || ctx.mode === 'accessible')
-        return (_token, text) => text;
-    return (token, text) => ctx.style.styled(token, text);
-}
-/**
- * Create a noColor-safe bold function.
- *
- * Returns an identity function when `noColor` is true or mode is
- * `accessible`, or `ctx.style.bold` otherwise.
- *
- * @param ctx - Bijou context for noColor/accessible detection and style access.
- * @returns A function `(text) => string`.
- */
-export function createBoldFn(ctx) {
-    if (ctx.theme.noColor || ctx.mode === 'accessible')
-        return (text) => text;
-    return (text) => ctx.style.bold(text);
-}
-/**
- * Keep a scroll offset so the cursor stays within a visible window.
- *
- * First adjusts the offset relative to the cursor position, then
- * clamps to the absolute bounds `[0, max(0, itemCount - maxVisible)]`.
- *
- * @param cursor - Current cursor index.
- * @param scrollOffset - Current scroll offset.
- * @param maxVisible - Maximum number of items visible at once.
- * @param itemCount - Total number of items.
- * @returns The updated scroll offset.
- */
-export function clampScroll(cursor, scrollOffset, maxVisible, itemCount) {
-    let offset = scrollOffset;
-    if (cursor < offset) {
-        offset = cursor;
-    }
-    else if (cursor >= offset + maxVisible) {
-        offset = cursor - maxVisible + 1;
-    }
-    return Math.max(0, Math.min(offset, Math.max(0, itemCount - maxVisible)));
-}
-/**
- * Subscribe to semantic form key input, preferring `ctx.io.keyInput()` when
- * available and falling back to decoding `rawInput()` sequences otherwise.
- *
- * This keeps interactive forms deterministic in tests without forcing
- * production adapters away from the lower-level raw-input contract.
- *
- * @param ctx - Bijou context providing the input port.
- * @param onKey - Callback invoked for each semantic key.
- * @returns A disposable handle that stops further key delivery.
- */
-export function subscribeFormKeyInput(ctx, onKey) {
-    if (typeof ctx.io.keyInput === 'function') {
-        return ctx.io.keyInput(onKey);
-    }
-    return ctx.io.rawInput((key) => {
-        for (const msg of decodeRawKeySequence(key)) {
-            onKey(msg);
-        }
-    });
-}
-/**
- * Whether a semantic key carries printable text.
- *
- * @param key - The semantic key to test.
- * @returns `true` when the key represents typed text.
- */
-export function isPrintableKey(key) {
-    return key.text !== undefined;
-}
-/**
- * Match a semantic key by logical key name and optional modifier flags.
- *
- * @param msg - The key message to test.
- * @param key - Expected logical key name.
- * @param mods - Optional modifier constraints.
- * @returns `true` when the key matches.
- */
-export function isKey(msg, key, mods = {}) {
-    if (msg.key !== key)
-        return false;
-    if (mods.ctrl !== undefined && msg.ctrl !== mods.ctrl)
-        return false;
-    if (mods.alt !== undefined && msg.alt !== mods.alt)
-        return false;
-    if (mods.shift !== undefined && msg.shift !== mods.shift)
-        return false;
-    return true;
-}
-/**
- * Handle up/down (arrow key or j/k) navigation in a wrapping list.
- *
- * @param key - The semantic keypress.
- * @param cursor - Current cursor index.
- * @param length - Total number of items.
- * @returns The new cursor index, or `null` if the key was not a vertical nav key.
- */
-export function handleVerticalNav(key, cursor, length) {
-    if (isKey(key, 'up') || key.text === 'k') {
-        return (cursor - 1 + length) % length;
-    }
-    if (isKey(key, 'down') || key.text === 'j') {
-        return (cursor + 1) % length;
-    }
-    return null;
-}
-/**
- * Route a form to its interactive or fallback handler based on
- * output mode and TTY state.
- *
- * @param ctx - Resolved bijou context.
- * @param interactive - Handler for interactive TTY mode.
- * @param fallback - Handler for non-interactive / pipe / static / accessible modes.
- * @returns The result from whichever handler was selected.
- */
-export function formDispatch(ctx, interactive, fallback) {
-    if (ctx.mode === 'interactive' && ctx.runtime.stdinIsTTY && ctx.runtime.stdoutIsTTY) {
-        return interactive(ctx);
-    }
-    return fallback(ctx);
-}
+export { clampScroll, createBoldFn, createStyledFn, formatFormTitle, isPrintableKey, renderNumberedOptions, subscribeFormKeyInput, terminalRenderer, writeValidationError } from './form-utils.part01.js';
+export { formDispatch, handleVerticalNav, isKey } from './form-utils.part02.js';
 //# sourceMappingURL=form-utils.js.map

package/dist/core/forms/form-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-utils.js","sourceRoot":"","sources":["../../../src/core/forms/form-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-utils.js","sourceRoot":"","sources":["../../../src/core/forms/form-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE1M,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/core/forms/form-utils.part01.d.ts

@@ -0,0 +1,30 @@
+import type { BijouContext } from '../../ports/context.js';
+import type { KeyInputMsg, RawInputHandle } from '../../ports/io.js';
+import type { TokenValue } from '../theme/tokens.js';
+export declare function formatFormTitle(title: string, ctx: BijouContext): string;
+export declare function writeValidationError(message: string, ctx: BijouContext): void;
+export declare function renderNumberedOptions(options: readonly {
+    label: string;
+    description?: string;
+}[], ctx: BijouContext): void;
+export interface TerminalRenderer {
+    /** Hide the terminal cursor. */
+    hideCursor(): void;
+    /** Show the terminal cursor. */
+    showCursor(): void;
+    /** Clear the current line and write text followed by a newline. */
+    writeLine(text: string): void;
+    /** Move the cursor up by the given number of lines. */
+    moveUp(lines: number): void;
+    /** Clear a block of N lines and return the cursor to the top of the block. */
+    clearBlock(lineCount: number): void;
+}
+export declare function terminalRenderer(ctx: BijouContext): TerminalRenderer;
+export declare function createStyledFn(ctx: BijouContext): (token: TokenValue, text: string) => string;
+export declare function createBoldFn(ctx: BijouContext): (text: string) => string;
+export declare function clampScroll(cursor: number, scrollOffset: number, maxVisible: number, itemCount: number): number;
+export declare function subscribeFormKeyInput(ctx: BijouContext, onKey: (key: KeyInputMsg) => void): RawInputHandle;
+export declare function isPrintableKey(key: KeyInputMsg): key is KeyInputMsg & {
+    text: string;
+};
+//# sourceMappingURL=form-utils.part01.d.ts.map

package/dist/core/forms/form-utils.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-utils.part01.d.ts","sourceRoot":"","sources":["../../../src/core/forms/form-utils.part01.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AASrD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAKxE;AACD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAM7E;AACD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3D,GAAG,EAAE,YAAY,GAChB,IAAI,CAKN;AACD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,gCAAgC;IAChC,UAAU,IAAI,IAAI,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8EAA8E;IAC9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AACD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAyBpE;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAG7F;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAGxE;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ/G;AACD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,GAChC,cAAc,CAShB;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAEtF"}

package/dist/core/forms/form-utils.part01.js

@@ -0,0 +1,86 @@
+import { cursorGuard } from '../components/cursor-guard.js';
+import { CLEAR_LINE, CLEAR_LINE_RETURN, cursorUp } from '../ansi.js';
+import { decodeRawKeySequence } from '../key-input.js';
+export function formatFormTitle(title, ctx) {
+    if (ctx.theme.noColor || ctx.mode === 'accessible') {
+        return `? ${title}`;
+    }
+    return ctx.style.styled(ctx.semantic('info'), '? ') + ctx.style.bold(title);
+}
+export function writeValidationError(message, ctx) {
+    if (ctx.theme.noColor || ctx.mode === 'accessible') {
+        ctx.io.write(message + '\n');
+    }
+    else {
+        ctx.io.write(ctx.style.styled(ctx.semantic('error'), message) + '\n');
+    }
+}
+export function renderNumberedOptions(options, ctx) {
+    for (const [i, opt] of options.entries()) {
+        const desc = opt.description ? ` \u2014 ${opt.description}` : '';
+        ctx.io.write(`  ${String(i + 1)}. ${opt.label}${desc}\n`);
+    }
+}
+export function terminalRenderer(ctx) {
+    let cursorHandle = null;
+    return {
+        hideCursor() {
+            cursorHandle ??= cursorGuard(ctx.io).hide();
+        },
+        showCursor() {
+            if (cursorHandle !== null) {
+                cursorHandle.dispose();
+                cursorHandle = null;
+            }
+        },
+        writeLine(text) {
+            ctx.io.write(`${CLEAR_LINE_RETURN}${text}\n`);
+        },
+        moveUp(lines) {
+            if (lines <= 0)
+                return;
+            ctx.io.write(cursorUp(lines));
+        },
+        clearBlock(lineCount) {
+            if (lineCount <= 0)
+                return;
+            for (let i = 0; i < lineCount; i++)
+                ctx.io.write(`${CLEAR_LINE}\n`);
+            ctx.io.write(cursorUp(lineCount));
+        },
+    };
+}
+export function createStyledFn(ctx) {
+    if (ctx.theme.noColor || ctx.mode === 'accessible')
+        return (_token, text) => text;
+    return (token, text) => ctx.style.styled(token, text);
+}
+export function createBoldFn(ctx) {
+    if (ctx.theme.noColor || ctx.mode === 'accessible')
+        return (text) => text;
+    return (text) => ctx.style.bold(text);
+}
+export function clampScroll(cursor, scrollOffset, maxVisible, itemCount) {
+    let offset = scrollOffset;
+    if (cursor < offset) {
+        offset = cursor;
+    }
+    else if (cursor >= offset + maxVisible) {
+        offset = cursor - maxVisible + 1;
+    }
+    return Math.max(0, Math.min(offset, Math.max(0, itemCount - maxVisible)));
+}
+export function subscribeFormKeyInput(ctx, onKey) {
+    if (typeof ctx.io.keyInput === 'function') {
+        return ctx.io.keyInput(onKey);
+    }
+    return ctx.io.rawInput((key) => {
+        for (const msg of decodeRawKeySequence(key)) {
+            onKey(msg);
+        }
+    });
+}
+export function isPrintableKey(key) {
+    return key.text !== undefined;
+}
+//# sourceMappingURL=form-utils.part01.js.map

package/dist/core/forms/form-utils.part01.js.map

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

package/dist/core/forms/form-utils.part02.d.ts

@@ -0,0 +1,6 @@
+import type { BijouContext } from '../../ports/context.js';
+import type { KeyInputMsg } from '../../ports/io.js';
+export declare function isKey(msg: KeyInputMsg, key: string, mods?: Partial<Pick<KeyInputMsg, 'ctrl' | 'alt' | 'shift'>>): boolean;
+export declare function handleVerticalNav(key: KeyInputMsg, cursor: number, length: number): number | null;
+export declare function formDispatch<T>(ctx: BijouContext, interactive: (ctx: BijouContext) => Promise<T>, fallback: (ctx: BijouContext) => Promise<T>): Promise<T>;
+//# sourceMappingURL=form-utils.part02.d.ts.map

package/dist/core/forms/form-utils.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-utils.part02.d.ts","sourceRoot":"","sources":["../../../src/core/forms/form-utils.part02.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,wBAAgB,KAAK,CACnB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,CAAM,GAC9D,OAAO,CAMT;AACD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjG;AACD,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,QAAQ,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC,CAKZ"}

package/dist/core/forms/form-utils.part02.js

@@ -0,0 +1,27 @@
+export function isKey(msg, key, mods = {}) {
+    if (msg.key !== key)
+        return false;
+    if (mods.ctrl !== undefined && msg.ctrl !== mods.ctrl)
+        return false;
+    if (mods.alt !== undefined && msg.alt !== mods.alt)
+        return false;
+    if (mods.shift !== undefined && msg.shift !== mods.shift)
+        return false;
+    return true;
+}
+export function handleVerticalNav(key, cursor, length) {
+    if (isKey(key, 'up') || key.text === 'k') {
+        return (cursor - 1 + length) % length;
+    }
+    if (isKey(key, 'down') || key.text === 'j') {
+        return (cursor + 1) % length;
+    }
+    return null;
+}
+export function formDispatch(ctx, interactive, fallback) {
+    if (ctx.mode === 'interactive' && ctx.runtime.stdinIsTTY && ctx.runtime.stdoutIsTTY) {
+        return interactive(ctx);
+    }
+    return fallback(ctx);
+}
+//# sourceMappingURL=form-utils.part02.js.map

package/dist/core/forms/form-utils.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-utils.part02.js","sourceRoot":"","sources":["../../../src/core/forms/form-utils.part02.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,KAAK,CACnB,GAAgB,EAChB,GAAW,EACX,OAA6D,EAAE;IAE/D,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACpE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,GAAgB,EAAE,MAAc,EAAE,MAAc;IAChF,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACzC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QAC3C,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,UAAU,YAAY,CAC1B,GAAiB,EACjB,WAA8C,EAC9C,QAA2C;IAE3C,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACpF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/core/forms/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,KAAK,OAAO,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,MAAM,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAS9B"}
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/core/forms/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,KAAK,OAAO,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,MAAM,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACxC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAU9B"}

package/dist/core/forms/group.js

@@ -23,6 +23,11 @@ export async function group(fields) {
         const fieldFn = fields[key];
         values[key] = await fieldFn();
     }
+    assertCompleteGroupValues(values);
     return { values, cancelled: false };
 }
+function assertCompleteGroupValues(_values) {
+    void _values;
+    // `group()` assigns every key from `fields` before returning.
+}
 //# sourceMappingURL=group.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/core/forms/group.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAyC;IAEzC,MAAM,MAAM,GAAG,EAAO,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../../src/core/forms/group.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAyC;IAEzC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgB,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAmB;IAEnB,KAAK,OAAO,CAAC;IACb,8DAA8D;AAChE,CAAC"}

package/dist/core/forms/input.js

@@ -18,7 +18,7 @@ export async function input(options) {
     const noColor = ctx.theme.noColor;
     const prompt = buildPrompt(options, noColor, ctx);
     const answer = await ctx.io.question(prompt);
-    const value = answer.trim() || options.defaultValue || '';
+    const value = answer.trim() || (options.defaultValue ?? '');
     if (options.required && value === '') {
         writeValidationError('This field is required.', ctx);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/core/forms/input.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAqB;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAElC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAE1D,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACrC,oBAAoB,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,MAAM,GAAqB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,OAAqB,EAAE,OAAgB,EAAE,GAAiB;IAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;QAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,WAAW,IAAI;QACxE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,WAAW,IAAI;QAC9C,WAAW,EAAE,GAAG,EAAE;YAChB,IAAI,OAAO;gBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,WAAW,IAAI,CAAC;YACvD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/G,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC;QAC5B,CAAC;KACF,EAAE,OAAO,CAAC,CAAC;AACd,CAAC"}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/core/forms/input.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAqB;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IAElC,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACrC,oBAAoB,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,MAAM,GAAqB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,OAAqB,EAAE,OAAgB,EAAE,GAAiB;IAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE;QAC5B,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,WAAW,IAAI;QACxE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,WAAW,IAAI;QAC9C,WAAW,EAAE,GAAG,EAAE;YAChB,IAAI,OAAO;gBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,WAAW,IAAI,CAAC;YACvD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/G,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC;QAC5B,CAAC;KACF,EAAE,OAAO,CAAC,CAAC;AACd,CAAC"}

package/dist/core/forms/multiselect-interactive.d.ts

@@ -0,0 +1,4 @@
+import type { BijouContext } from '../../ports/context.js';
+import type { MultiselectOptions } from './multiselect.js';
+export declare function interactiveMultiselect<T>(options: MultiselectOptions<T>, ctx: BijouContext): Promise<T[]>;
+//# sourceMappingURL=multiselect-interactive.d.ts.map

package/dist/core/forms/multiselect-interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiselect-interactive.d.ts","sourceRoot":"","sources":["../../../src/core/forms/multiselect-interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAY3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAc3D,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC9B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CAuHd"}