@flyingrobots/bijou 1.1.0 → 1.2.0

package/dist/core/components/markdown.js

@@ -9,375 +9,9 @@
  * blockquotes.
  */
 import { getDefaultContext } from '../../context.js';
-import { separator } from './separator.js';
-import { hyperlink } from './hyperlink.js';
-import { graphemeWidth } from '../text/grapheme.js';
-// ---------------------------------------------------------------------------
-// Block-level parser
-// ---------------------------------------------------------------------------
-/**
- * Parse a markdown source string into an array of block-level elements.
- *
- * Recognizes fenced code blocks, horizontal rules, headings, blockquotes,
- * bullet lists, numbered lists, and paragraphs.
- *
- * @param source - Raw markdown source text.
- * @returns Array of parsed block elements.
- */
-function parseBlocks(source) {
-    const lines = source.split('\n');
-    const blocks = [];
-    let i = 0;
-    while (i < lines.length) {
-        const line = lines[i];
-        // Blank line
-        if (line.trim() === '') {
-            blocks.push({ type: 'blank' });
-            i++;
-            continue;
-        }
-        // Code block (fenced)
-        if (line.trimStart().startsWith('```')) {
-            const lang = line.trimStart().slice(3).trim();
-            const codeLines = [];
-            i++;
-            while (i < lines.length && !lines[i].trimStart().startsWith('```')) {
-                codeLines.push(lines[i]);
-                i++;
-            }
-            if (i < lines.length)
-                i++; // skip closing ```
-            blocks.push({ type: 'code-block', lang, lines: codeLines });
-            continue;
-        }
-        // Horizontal rule
-        if (/^(-{3,}|\*{3,}|_{3,})\s*$/.test(line.trim())) {
-            blocks.push({ type: 'hr' });
-            i++;
-            continue;
-        }
-        // Heading
-        const headingMatch = line.match(/^(#{1,4})\s+(.+)$/);
-        if (headingMatch) {
-            blocks.push({ type: 'heading', level: headingMatch[1].length, text: headingMatch[2] });
-            i++;
-            continue;
-        }
-        // Blockquote
-        if (line.trimStart().startsWith('>')) {
-            const quoteLines = [];
-            while (i < lines.length && lines[i].trimStart().startsWith('>')) {
-                const ql = lines[i];
-                quoteLines.push(ql.replace(/^\s*>\s?/, ''));
-                i++;
-                if (i < lines.length && lines[i].trim() === '')
-                    break;
-            }
-            blocks.push({ type: 'blockquote', lines: quoteLines });
-            continue;
-        }
-        // Bullet list
-        if (/^\s*[-*]\s+/.test(line)) {
-            const items = [];
-            while (i < lines.length && /^\s*[-*]\s+/.test(lines[i])) {
-                items.push(lines[i].replace(/^\s*[-*]\s+/, ''));
-                i++;
-            }
-            blocks.push({ type: 'bullet-list', items });
-            continue;
-        }
-        // Numbered list
-        if (/^\s*\d+\.\s+/.test(line)) {
-            const items = [];
-            while (i < lines.length && /^\s*\d+\.\s+/.test(lines[i])) {
-                items.push(lines[i].replace(/^\s*\d+\.\s+/, ''));
-                i++;
-            }
-            blocks.push({ type: 'numbered-list', items });
-            continue;
-        }
-        // Paragraph: collect consecutive non-special lines
-        let text = line;
-        i++;
-        while (i < lines.length && lines[i].trim() !== '' && !isBlockStart(lines[i])) {
-            text += ' ' + lines[i];
-            i++;
-        }
-        blocks.push({ type: 'paragraph', text });
-    }
-    return blocks;
-}
-/**
- * Test whether a line begins a new block-level element.
- *
- * Used by the paragraph collector to determine when to stop accumulating lines.
- *
- * @param line - The line to test.
- * @returns `true` if the line starts a code fence, heading, HR, blockquote, or list.
- */
-function isBlockStart(line) {
-    if (line.trimStart().startsWith('```'))
-        return true;
-    if (/^(#{1,4})\s+/.test(line))
-        return true;
-    if (/^(-{3,}|\*{3,}|_{3,})\s*$/.test(line.trim()))
-        return true;
-    if (line.trimStart().startsWith('>'))
-        return true;
-    if (/^\s*[-*]\s+/.test(line))
-        return true;
-    if (/^\s*\d+\.\s+/.test(line))
-        return true;
-    return false;
-}
-// ---------------------------------------------------------------------------
-// Inline parser
-// ---------------------------------------------------------------------------
-/**
- * Parse and render inline markdown syntax within a text fragment.
- *
- * Dispatches to mode-specific handlers for styled, plain, or accessible output.
- *
- * @param text - The inline text to parse.
- * @param ctx - Bijou context for styling.
- * @param mode - Current rendering mode.
- * @returns The rendered inline text.
- */
-function parseInline(text, ctx, mode) {
-    if (mode === 'accessible')
-        return parseInlineAccessible(text, ctx);
-    if (mode === 'pipe')
-        return parseInlinePlain(text);
-    return parseInlineStyled(text, ctx);
-}
-/**
- * Render inline markdown with terminal styling (interactive/static mode).
- *
- * Processes links, code spans, bold, and italic with theme-based colors.
- *
- * @param text - The inline text to parse.
- * @param ctx - Bijou context for styling.
- * @returns The styled inline text.
- */
-function parseInlineStyled(text, ctx) {
-    let result = text;
-    // Links: [text](url)
-    result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_m, linkText, url) => {
-        return hyperlink(linkText, url, { ctx });
-    });
-    // Code spans: `text` (before bold/italic to prevent * inside backticks being parsed)
-    result = result.replace(/`([^`]+)`/g, (_m, code) => {
-        return ctx.style.styled(ctx.theme.theme.semantic.warning, code);
-    });
-    // Bold: **text**
-    result = result.replace(/\*\*(.+?)\*\*/g, (_m, bold) => {
-        return ctx.style.bold(bold);
-    });
-    // Italic: *text* (but not inside **)
-    result = result.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, (_m, italic) => {
-        return ctx.style.styled(ctx.theme.theme.semantic.muted, italic);
-    });
-    return result;
-}
-/**
- * Strip inline markdown syntax to plain text (pipe mode).
- *
- * Converts links to `text (url)` format and removes formatting markers.
- *
- * @param text - The inline text to parse.
- * @returns The plain-text inline text.
- */
-function parseInlinePlain(text) {
-    let result = text;
-    // Links: [text](url) → text (url)
-    result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1 ($2)');
-    // Code: `text` → text (before bold/italic to prevent * inside backticks being parsed)
-    result = result.replace(/`([^`]+)`/g, '$1');
-    // Bold: **text** → text
-    result = result.replace(/\*\*(.+?)\*\*/g, '$1');
-    // Italic: *text* → text
-    result = result.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, '$1');
-    return result;
-}
-/**
- * Parse inline markdown for screen-reader-friendly output (accessible mode).
- *
- * Prefixes links with `Link:` and strips formatting markers.
- *
- * @param text - The inline text to parse.
- * @param _ctx - Bijou context (unused, kept for signature consistency).
- * @returns The accessible inline text.
- */
-function parseInlineAccessible(text, _ctx) {
-    let result = text;
-    // Links: [text](url) → Link: text (url)
-    result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, 'Link: $1 ($2)');
-    // Code: `text` → text (before bold/italic to prevent * inside backticks being parsed)
-    result = result.replace(/`([^`]+)`/g, '$1');
-    // Bold: **text** → text
-    result = result.replace(/\*\*(.+?)\*\*/g, '$1');
-    // Italic: *text* → text
-    result = result.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, '$1');
-    return result;
-}
-// ---------------------------------------------------------------------------
-// Word wrapping
-// ---------------------------------------------------------------------------
-/**
- * Wrap text to a maximum column width, breaking on word boundaries.
- *
- * Uses grapheme-aware width measurement to handle wide characters correctly.
- *
- * @param text - The text to wrap.
- * @param width - Maximum line width in columns.
- * @returns Array of wrapped lines.
- */
-function wordWrap(text, width) {
-    if (width <= 0)
-        return [text];
-    const words = text.split(' ');
-    const lines = [];
-    let current = '';
-    let currentWidth = 0;
-    for (const word of words) {
-        const wordWidth = graphemeWidth(word);
-        if (currentWidth === 0) {
-            current = word;
-            currentWidth = wordWidth;
-        }
-        else if (currentWidth + 1 + wordWidth <= width) {
-            current += ' ' + word;
-            currentWidth += 1 + wordWidth;
-        }
-        else {
-            lines.push(current);
-            current = word;
-            currentWidth = wordWidth;
-        }
-    }
-    if (currentWidth > 0)
-        lines.push(current);
-    return lines.length > 0 ? lines : [''];
-}
-// ---------------------------------------------------------------------------
-// Block renderer
-// ---------------------------------------------------------------------------
-/**
- * Render an array of parsed block elements into a final terminal string.
- *
- * Handles mode-specific rendering for each block type and trims trailing blanks.
- *
- * @param blocks - Parsed block-level elements.
- * @param ctx - Bijou context for styling and mode.
- * @param width - Column width for word wrapping.
- * @returns The fully rendered markdown string.
- */
-function renderBlocks(blocks, ctx, width) {
-    const mode = ctx.mode;
-    const lines = [];
-    for (const block of blocks) {
-        switch (block.type) {
-            case 'blank':
-                lines.push('');
-                break;
-            case 'heading': {
-                const text = parseInline(block.text, ctx, mode);
-                if (mode === 'accessible') {
-                    lines.push(`Heading level ${block.level}: ${text}`);
-                }
-                else if (mode === 'pipe') {
-                    lines.push('#'.repeat(block.level) + ' ' + text);
-                }
-                else {
-                    // Interactive: bold, h1 uses primary color
-                    const styled = ctx.style.bold(text);
-                    if (block.level === 1) {
-                        lines.push(ctx.style.styled(ctx.theme.theme.border.primary, styled));
-                    }
-                    else {
-                        lines.push(styled);
-                    }
-                }
-                lines.push('');
-                break;
-            }
-            case 'paragraph': {
-                const wrapped = wordWrap(block.text, width);
-                lines.push(...wrapped.map(line => parseInline(line, ctx, mode)));
-                lines.push('');
-                break;
-            }
-            case 'bullet-list': {
-                for (const item of block.items) {
-                    const bullet = mode === 'pipe' ? '- ' : '  \u2022 ';
-                    const indentWidth = width - bullet.length;
-                    const wrapped = wordWrap(item, indentWidth > 0 ? indentWidth : width);
-                    lines.push(bullet + parseInline(wrapped[0], ctx, mode));
-                    for (let i = 1; i < wrapped.length; i++) {
-                        lines.push(' '.repeat(bullet.length) + parseInline(wrapped[i], ctx, mode));
-                    }
-                }
-                lines.push('');
-                break;
-            }
-            case 'numbered-list': {
-                for (let n = 0; n < block.items.length; n++) {
-                    const prefix = mode === 'pipe' ? `${n + 1}. ` : `  ${n + 1}. `;
-                    const indentWidth = width - prefix.length;
-                    const wrapped = wordWrap(block.items[n], indentWidth > 0 ? indentWidth : width);
-                    lines.push(prefix + parseInline(wrapped[0], ctx, mode));
-                    for (let i = 1; i < wrapped.length; i++) {
-                        lines.push(' '.repeat(prefix.length) + parseInline(wrapped[i], ctx, mode));
-                    }
-                }
-                lines.push('');
-                break;
-            }
-            case 'code-block': {
-                if (mode === 'pipe' || mode === 'accessible') {
-                    lines.push('```' + block.lang);
-                    lines.push(...block.lines);
-                    lines.push('```');
-                }
-                else {
-                    // Interactive: dim styling
-                    for (const codeLine of block.lines) {
-                        lines.push(ctx.style.styled(ctx.theme.theme.semantic.muted, '  ' + codeLine));
-                    }
-                }
-                lines.push('');
-                break;
-            }
-            case 'blockquote': {
-                for (const ql of block.lines) {
-                    const inlined = parseInline(ql, ctx, mode);
-                    if (mode === 'pipe' || mode === 'accessible') {
-                        lines.push('> ' + inlined);
-                    }
-                    else {
-                        const prefix = ctx.style.styled(ctx.theme.theme.border.muted, '\u2502 ');
-                        lines.push(prefix + ctx.style.styled(ctx.theme.theme.semantic.muted, inlined));
-                    }
-                }
-                lines.push('');
-                break;
-            }
-            case 'hr': {
-                lines.push(separator({ width, ctx }));
-                lines.push('');
-                break;
-            }
-        }
-    }
-    // Trim trailing blank lines
-    while (lines.length > 0 && lines[lines.length - 1] === '') {
-        lines.pop();
-    }
-    return lines.join('\n');
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
+import { parseBlocks } from './markdown-parse.js';
+import { renderBlocks } from './markdown-render.js';
+// ── Public API ─────────────────────────────────────────────────────
 /**
  * Render a markdown string for terminal display.
  *
@@ -394,10 +28,11 @@ function renderBlocks(blocks, ctx, width) {
  * @returns The rendered terminal string.
  */
 export function markdown(source, options) {
-    const ctx = options?.ctx ?? getDefaultContext();
-    const width = options?.width ?? ctx.runtime.columns;
     if (source.trim() === '')
         return '';
+    const ctx = options?.ctx ?? getDefaultContext();
+    const rawWidth = options?.width ?? ctx.runtime.columns;
+    const width = Math.max(1, Number.isFinite(rawWidth) ? rawWidth : ctx.runtime.columns);
     const blocks = parseBlocks(source);
     return renderBlocks(blocks, ctx, width);
 }

package/dist/core/components/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/core/components/markdown.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/core/components/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYpD,sEAAsE;AAEtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,OAAyB;IAChE,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * 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 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;
+}
+/**
+ * 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 declare function defaultMatch<T>(query: string, option: FilterOption<T>): boolean;
+/**
+ * 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 declare function interactiveFilter<T>(options: FilterOptions<T>, ctx: BijouContext): Promise<T>;
+//# sourceMappingURL=filter-interactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter-interactive.d.ts","sourceRoot":"","sources":["../../../src/core/forms/filter-interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;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;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAO/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAgOnG"}