@flyingrobots/bijou-tui 7.1.0 → 8.0.0-rc.1

package/dist/help-surface.js

@@ -0,0 +1,31 @@
+import { createSurface, parseAnsiToSurface, sanitizePositiveInt, } from '@flyingrobots/bijou';
+import { helpFor, helpShort, helpView } from './help-text.js';
+import { visibleLength } from './viewport.js';
+/**
+ * Render grouped help into a structured terminal surface.
+ */
+export function helpViewSurface(keymap, options) {
+    return renderHelpSurface(helpView(keymap, options), options);
+}
+/**
+ * Render a single-line help summary into a structured terminal surface.
+ */
+export function helpShortSurface(keymap, options) {
+    return renderHelpSurface(helpShort(keymap, options), options);
+}
+/**
+ * Render one group-prefix selection into a structured terminal surface.
+ */
+export function helpForSurface(keymap, groupPrefix, options) {
+    return renderHelpSurface(helpFor(keymap, groupPrefix, options), options);
+}
+function renderHelpSurface(text, options) {
+    const lines = text.length === 0 ? [''] : text.split('\n');
+    const contentWidth = Math.max(1, ...lines.map((line) => visibleLength(line)));
+    const width = Math.max(contentWidth, sanitizePositiveInt(options?.width, 1));
+    const height = sanitizePositiveInt(options?.height, lines.length);
+    return text.length === 0
+        ? createSurface(width, height)
+        : parseAnsiToSurface(text, width, height);
+}
+//# sourceMappingURL=help-surface.js.map

package/dist/help-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-surface.js","sourceRoot":"","sources":["../src/help-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAqB,EACrB,OAA4B;IAE5B,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAqB,EACrB,OAA2E;IAE3E,OAAO,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,WAAmB,EACnB,OAA4B;IAE5B,OAAO,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAY,EACZ,OAAsD;IAEtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC;QACtB,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;QAC9B,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/help-text.d.ts

@@ -0,0 +1,27 @@
+import type { BindingSource, HelpOptions } from './help-types.js';
+/**
+ * Render full, grouped, multi-line help text.
+ *
+ * @param keymap - Source of key binding information.
+ * @param options - Filtering, formatting, title, and fallback-group options.
+ * @returns Grouped help text, or an empty string when no binding matches.
+ */
+export declare function helpView(keymap: BindingSource, options?: HelpOptions): string;
+/**
+ * Render enabled key bindings as a single-line summary.
+ *
+ * @param keymap - Source of key binding information.
+ * @param options - Optional enabled-state and group-prefix filters.
+ * @returns Key descriptions separated by bullets.
+ */
+export declare function helpShort(keymap: BindingSource, options?: Pick<HelpOptions, 'enabledOnly' | 'groupFilter'>): string;
+/**
+ * Render grouped help for one case-insensitive group prefix.
+ *
+ * @param keymap - Source of key binding information.
+ * @param groupPrefix - Group-name prefix to include.
+ * @param options - Remaining help formatting options.
+ * @returns Filtered grouped help text.
+ */
+export declare function helpFor(keymap: BindingSource, groupPrefix: string, options?: HelpOptions): string;
+//# sourceMappingURL=help-text.d.ts.map

package/dist/help-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../src/help-text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkBlE;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAiC7E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC,GACzD,MAAM,CAIR;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,CAKR"}

package/dist/help-text.js

@@ -0,0 +1,78 @@
+import { formatKeyCombo } from './keybindings.js';
+function filteredBindings(source, options) {
+    const enabledOnly = options?.enabledOnly ?? true;
+    const groupFilter = options?.groupFilter?.toLowerCase();
+    return source
+        .bindings()
+        .filter((binding) => !enabledOnly || binding.enabled)
+        .filter((binding) => groupFilter === undefined ||
+        binding.group.toLowerCase().startsWith(groupFilter));
+}
+/**
+ * Render full, grouped, multi-line help text.
+ *
+ * @param keymap - Source of key binding information.
+ * @param options - Filtering, formatting, title, and fallback-group options.
+ * @returns Grouped help text, or an empty string when no binding matches.
+ */
+export function helpView(keymap, options) {
+    const bindings = filteredBindings(keymap, options);
+    if (bindings.length === 0)
+        return '';
+    const defaultGroupName = options?.defaultGroupName ?? 'General';
+    const groups = new Map();
+    for (const binding of bindings) {
+        const group = binding.group || defaultGroupName;
+        const existing = groups.get(group);
+        if (existing === undefined) {
+            groups.set(group, [binding]);
+        }
+        else {
+            existing.push(binding);
+        }
+    }
+    const maximumKeyLength = Math.max(...bindings.map((binding) => formatKeyCombo(binding.combo).length));
+    const separator = options?.separator ?? '  ';
+    const lines = [];
+    if (options?.title)
+        lines.push(options.title, '');
+    let first = true;
+    for (const [groupName, groupBindings] of groups) {
+        if (!first)
+            lines.push('');
+        first = false;
+        lines.push(groupName);
+        for (const binding of groupBindings) {
+            const key = formatKeyCombo(binding.combo).padEnd(maximumKeyLength);
+            lines.push(`  ${key}${separator}${binding.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Render enabled key bindings as a single-line summary.
+ *
+ * @param keymap - Source of key binding information.
+ * @param options - Optional enabled-state and group-prefix filters.
+ * @returns Key descriptions separated by bullets.
+ */
+export function helpShort(keymap, options) {
+    return filteredBindings(keymap, options)
+        .map((binding) => `${formatKeyCombo(binding.combo)} ${binding.description}`)
+        .join(' • ');
+}
+/**
+ * Render grouped help for one case-insensitive group prefix.
+ *
+ * @param keymap - Source of key binding information.
+ * @param groupPrefix - Group-name prefix to include.
+ * @param options - Remaining help formatting options.
+ * @returns Filtered grouped help text.
+ */
+export function helpFor(keymap, groupPrefix, options) {
+    return helpView(keymap, {
+        ...options,
+        groupFilter: groupPrefix,
+    });
+}
+//# sourceMappingURL=help-text.js.map

package/dist/help-text.js.map

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

package/dist/help-types.d.ts

@@ -0,0 +1,27 @@
+import type { BindingInfo } from './keybindings.js';
+/** Anything that can enumerate registered key bindings. */
+export interface BindingSource {
+    /** Return all registered key bindings. */
+    bindings(): readonly BindingInfo[];
+}
+/** Filtering and formatting options for text help views. */
+export interface HelpOptions {
+    /** Only show enabled bindings. Defaults to `true`. */
+    enabledOnly?: boolean;
+    /** Include only groups matching this case-insensitive prefix. */
+    groupFilter?: string;
+    /** Separate each formatted key from its description. Defaults to two spaces. */
+    separator?: string;
+    /** Add a title above the grouped help. */
+    title?: string;
+    /** Label bindings without a group. Defaults to `General`. */
+    defaultGroupName?: string;
+}
+/** Text help options plus optional `Surface` dimensions. */
+export interface HelpSurfaceOptions extends HelpOptions {
+    /** Fixed minimum width. Defaults to the widest visible line. */
+    width?: number;
+    /** Fixed height. Defaults to the rendered line count. */
+    height?: number;
+}
+//# sourceMappingURL=help-types.d.ts.map

package/dist/help-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-types.d.ts","sourceRoot":"","sources":["../src/help-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAC;CACpC;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/help-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=help-types.js.map

package/dist/help-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-types.js","sourceRoot":"","sources":["../src/help-types.ts"],"names":[],"mappings":""}

package/dist/help.d.ts

@@ -1,116 +1,10 @@
 /**
- * Auto-generate help views from registered keybindings.
+ * Auto-generated help views for registered key bindings.
  *
- * ```ts
- * const kb = createKeyMap<Msg>()
- *   .bind('q', 'Quit', quitMsg)
- *   .group('Navigation', g => g
- *     .bind('j', 'Down', downMsg)
- *     .bind('k', 'Up', upMsg)
- *   );
- *
- * helpView(kb)          // full grouped help
- * helpShort(kb)         // single-line summary
- * helpFor(kb, 'Nav')    // filter by group prefix
- * ```
- */
-import { type Surface } from '@flyingrobots/bijou';
-import type { BindingInfo } from './keybindings.js';
-/** Anything that can list its bindings (satisfied by KeyMap). */
-export interface BindingSource {
-    /** Return all registered key bindings. */
-    bindings(): readonly BindingInfo[];
-}
-/** Options for rendering help views. */
-export interface HelpOptions {
-    /** Only show enabled bindings (default: true). */
-    enabledOnly?: boolean;
-    /** Filter to bindings in groups matching this prefix. */
-    groupFilter?: string;
-    /** Separator between key and description (default: `"  "`). */
-    separator?: string;
-    /** Title shown at the top (default: none). */
-    title?: string;
-    /** Label used when a binding does not declare a group (default: `General`). */
-    defaultGroupName?: string;
-}
-/** Options for rendering help into a `Surface`. */
-export interface HelpSurfaceOptions extends HelpOptions {
-    /** Optional fixed width. Defaults to the widest visible line. */
-    width?: number;
-    /** Optional fixed height. Defaults to the rendered line count. */
-    height?: number;
-}
-/**
- * Full help view — grouped, multi-line.
- *
- * ```
- * Navigation
- *   j  Down
- *   k  Up
- *
- * General
- *   q  Quit
- *   ?  Toggle help
- * ```
- *
- * @param keymap - Source of key binding information.
- * @param options - Filtering, formatting, and title options.
- * @returns Multi-line help text grouped by binding group.
- */
-export declare function helpView(keymap: BindingSource, options?: HelpOptions): string;
-/**
- * Full grouped help rendered directly into a `Surface`.
- *
- * Use this when help content is being embedded into a rich TUI view and should
- * stay on the `Surface` path instead of being flattened into a multiline
- * string first.
- *
- * @param keymap - Source of key binding information.
- * @param options - Filtering, formatting, title, and optional surface sizing.
- * @returns A `Surface` containing the rendered grouped help text.
- */
-export declare function helpViewSurface(keymap: BindingSource, options?: HelpSurfaceOptions): Surface;
-/**
- * Short, single-line help — keys only, no groups.
- *
- * ```
- * q Quit • j Down • k Up • ? Help
- * ```
- *
- * @param keymap - Source of key binding information.
- * @param options - Optional filtering by enabled state or group prefix.
- * @returns Single-line help string with keys and descriptions separated by bullets.
- */
-export declare function helpShort(keymap: BindingSource, options?: Pick<HelpOptions, 'enabledOnly' | 'groupFilter'>): string;
-/**
- * Single-line help rendered directly into a `Surface`.
- *
- * Use this for shell hints and inline key legends that should remain on the
- * structured surface path. Keep {@link helpShort} for explicit text output or
- * pipe-mode lowering.
- *
- * @param keymap - Source of key binding information.
- * @param options - Optional filtering and fixed surface width.
- * @returns A one-row `Surface` containing the rendered help hint.
- */
-export declare function helpShortSurface(keymap: BindingSource, options?: Pick<HelpSurfaceOptions, 'enabledOnly' | 'groupFilter' | 'width'>): Surface;
-/**
- * Filter help to a specific group (convenience wrapper).
- *
- * @param keymap - Source of key binding information.
- * @param groupPrefix - Group name prefix to filter on (case-insensitive).
- * @param options - Additional formatting options forwarded to `helpView` (excluding `groupFilter`, which is set by `groupPrefix`).
- * @returns Filtered multi-line help text.
- */
-export declare function helpFor(keymap: BindingSource, groupPrefix: string, options?: HelpOptions): string;
-/**
- * Group-filtered help rendered directly into a `Surface`.
- *
- * @param keymap - Source of key binding information.
- * @param groupPrefix - Group name prefix to filter on (case-insensitive).
- * @param options - Additional formatting and surface sizing options.
- * @returns A `Surface` containing the filtered help text.
+ * Text renderers remain available for logs and pipe mode. Surface renderers
+ * preserve structured cells for rich terminal interfaces.
  */
-export declare function helpForSurface(keymap: BindingSource, groupPrefix: string, options?: HelpSurfaceOptions): Surface;
+export { helpFor, helpShort, helpView } from './help-text.js';
+export { helpForSurface, helpShortSurface, helpViewSurface, } from './help-surface.js';
+export type { BindingSource, HelpOptions, HelpSurfaceOptions, } from './help-types.js';
 //# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAA0D,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC3G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAC;CACpC;AAMD,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAqD7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC,GAAG,MAAM,CAenH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC,GAC1E,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAEjG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAET"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/help.js

@@ -1,169 +1,9 @@
 /**
- * Auto-generate help views from registered keybindings.
+ * Auto-generated help views for registered key bindings.
  *
- * ```ts
- * const kb = createKeyMap<Msg>()
- *   .bind('q', 'Quit', quitMsg)
- *   .group('Navigation', g => g
- *     .bind('j', 'Down', downMsg)
- *     .bind('k', 'Up', upMsg)
- *   );
- *
- * helpView(kb)          // full grouped help
- * helpShort(kb)         // single-line summary
- * helpFor(kb, 'Nav')    // filter by group prefix
- * ```
- */
-import { createSurface, parseAnsiToSurface, sanitizePositiveInt } from '@flyingrobots/bijou';
-import { formatKeyCombo } from './keybindings.js';
-import { visibleLength } from './viewport.js';
-// ---------------------------------------------------------------------------
-// Help views
-// ---------------------------------------------------------------------------
-/**
- * Full help view — grouped, multi-line.
- *
- * ```
- * Navigation
- *   j  Down
- *   k  Up
- *
- * General
- *   q  Quit
- *   ?  Toggle help
- * ```
- *
- * @param keymap - Source of key binding information.
- * @param options - Filtering, formatting, and title options.
- * @returns Multi-line help text grouped by binding group.
- */
-export function helpView(keymap, options) {
-    const enabledOnly = options?.enabledOnly ?? true;
-    const sep = options?.separator ?? '  ';
-    const groupFilter = options?.groupFilter;
-    const defaultGroupName = options?.defaultGroupName ?? 'General';
-    let all = keymap.bindings();
-    if (enabledOnly)
-        all = all.filter((b) => b.enabled);
-    if (groupFilter !== undefined) {
-        all = all.filter((b) => b.group.toLowerCase().startsWith(groupFilter.toLowerCase()));
-    }
-    if (all.length === 0)
-        return '';
-    // Group by group name
-    const groups = new Map();
-    for (const b of all) {
-        const group = b.group || defaultGroupName;
-        let list = groups.get(group);
-        if (!list) {
-            list = [];
-            groups.set(group, list);
-        }
-        list.push(b);
-    }
-    // Find max key width for alignment
-    const allFormatted = all.map((b) => formatKeyCombo(b.combo));
-    const maxKeyLen = Math.max(...allFormatted.map((k) => k.length));
-    const lines = [];
-    if (options?.title) {
-        lines.push(options.title);
-        lines.push('');
-    }
-    let first = true;
-    for (const [groupName, bindings] of groups) {
-        if (!first)
-            lines.push('');
-        first = false;
-        lines.push(groupName);
-        for (const b of bindings) {
-            const key = formatKeyCombo(b.combo).padEnd(maxKeyLen);
-            lines.push(`  ${key}${sep}${b.description}`);
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Full grouped help rendered directly into a `Surface`.
- *
- * Use this when help content is being embedded into a rich TUI view and should
- * stay on the `Surface` path instead of being flattened into a multiline
- * string first.
- *
- * @param keymap - Source of key binding information.
- * @param options - Filtering, formatting, title, and optional surface sizing.
- * @returns A `Surface` containing the rendered grouped help text.
- */
-export function helpViewSurface(keymap, options) {
-    return renderHelpSurface(helpView(keymap, options), options);
-}
-/**
- * Short, single-line help — keys only, no groups.
- *
- * ```
- * q Quit • j Down • k Up • ? Help
- * ```
- *
- * @param keymap - Source of key binding information.
- * @param options - Optional filtering by enabled state or group prefix.
- * @returns Single-line help string with keys and descriptions separated by bullets.
- */
-export function helpShort(keymap, options) {
-    const enabledOnly = options?.enabledOnly ?? true;
-    const groupFilter = options?.groupFilter;
-    let all = keymap.bindings();
-    if (enabledOnly)
-        all = all.filter((b) => b.enabled);
-    if (groupFilter !== undefined) {
-        all = all.filter((b) => b.group.toLowerCase().startsWith(groupFilter.toLowerCase()));
-    }
-    return all
-        .map((b) => `${formatKeyCombo(b.combo)} ${b.description}`)
-        .join(' • ');
-}
-/**
- * Single-line help rendered directly into a `Surface`.
- *
- * Use this for shell hints and inline key legends that should remain on the
- * structured surface path. Keep {@link helpShort} for explicit text output or
- * pipe-mode lowering.
- *
- * @param keymap - Source of key binding information.
- * @param options - Optional filtering and fixed surface width.
- * @returns A one-row `Surface` containing the rendered help hint.
- */
-export function helpShortSurface(keymap, options) {
-    return renderHelpSurface(helpShort(keymap, options), options);
-}
-/**
- * Filter help to a specific group (convenience wrapper).
- *
- * @param keymap - Source of key binding information.
- * @param groupPrefix - Group name prefix to filter on (case-insensitive).
- * @param options - Additional formatting options forwarded to `helpView` (excluding `groupFilter`, which is set by `groupPrefix`).
- * @returns Filtered multi-line help text.
- */
-export function helpFor(keymap, groupPrefix, options) {
-    return helpView(keymap, { ...options, groupFilter: groupPrefix });
-}
-/**
- * Group-filtered help rendered directly into a `Surface`.
- *
- * @param keymap - Source of key binding information.
- * @param groupPrefix - Group name prefix to filter on (case-insensitive).
- * @param options - Additional formatting and surface sizing options.
- * @returns A `Surface` containing the filtered help text.
+ * Text renderers remain available for logs and pipe mode. Surface renderers
+ * preserve structured cells for rich terminal interfaces.
  */
-export function helpForSurface(keymap, groupPrefix, options) {
-    return renderHelpSurface(helpFor(keymap, groupPrefix, options), options);
-}
-function renderHelpSurface(text, options) {
-    const lines = text.length === 0 ? [''] : text.split('\n');
-    const contentWidth = Math.max(1, ...lines.map((line) => visibleLength(line)));
-    const width = Math.max(contentWidth, sanitizePositiveInt(options?.width, 1));
-    const height = sanitizePositiveInt(options?.height, lines.length);
-    if (text.length === 0) {
-        return createSurface(width, height);
-    }
-    return parseAnsiToSurface(text, width, height);
-}
+export { helpFor, helpShort, helpView } from './help-text.js';
+export { helpForSurface, helpShortSurface, helpViewSurface, } from './help-surface.js';
 //# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -6,84 +6,12 @@
  *
  * @module
  */
-export type { BijouContext, Cell, Surface } from '@flyingrobots/bijou';
-export type { App, Cmd, KeyMsg, ResizeMsg, MouseMsg, MouseButton, MouseAction, QuitSignal, RunOptions, RuntimeIssue, RuntimeIssueLevel, RuntimeIssueSource, } from './types.js';
-export { QUIT, isKeyMsg, isResizeMsg, isMouseMsg } from './types.js';
-export type { ApplyRuntimeCommandBufferResult, ExecuteRuntimeEffectBufferResult, CreateRuntimeComponentContractOptions, CreateRuntimeComponentNodeOptions, RuntimeBuffers, RuntimeComponentAlignment, RuntimeComponentBlockOverflowPolicy, RuntimeComponentContract, RuntimeComponentInputContext, RuntimeComponentInlineOverflowPolicy, RuntimeComponentInteractionContract, RuntimeComponentKeyBindings, RuntimeComponentLayoutNode, RuntimeComponentLayoutRules, RuntimeComponentOverflowRules, RuntimeComponentPointerBindings, RuntimeComponentSizeMode, RuntimeCommandBuffer, RuntimeEffectBuffer, RetainRuntimeLayoutOptions, RuntimeInputEvent, RuntimeInputHandler, RuntimeInputRouteContext, RuntimeInputRouteOutcome, RuntimeInputRouteResult, RuntimeKeyInputEvent, RuntimeLayoutHit, RuntimeLayoutInvalidationCause, RuntimePointerAction, RuntimePointerButton, RuntimePointerInputEvent, RuntimeStateLike, RuntimeStateMachine, RuntimeRetainedLayout, RuntimeRetainedLayouts, RuntimeViewLayer, RuntimeStackLayer, RuntimeViewStack, PopRuntimeViewResult, } from './runtime-engine.js';
-export { RUNTIME_COMPONENT_ALIGNMENTS, RUNTIME_COMPONENT_BLOCK_OVERFLOW_POLICIES, RUNTIME_COMPONENT_INLINE_OVERFLOW_POLICIES, RUNTIME_COMPONENT_SIZE_MODES, RUNTIME_LAYOUT_INVALIDATION_CAUSES, RUNTIME_POINTER_ACTIONS, RUNTIME_POINTER_BUTTONS, activeRuntimeView, appendRuntimeCommands, appendRuntimeEffects, applyRuntimeCommandBuffer, bufferRuntimeRouteResult, clearRuntimeViewsToRoot, createRuntimeComponentContract, createRuntimeComponentNode, createRuntimeBuffers, createRuntimeCommandBuffer, createRuntimeEffectBuffer, createRuntimeStateMachine, createRuntimeRetainedLayouts, createRuntimeViewStack, dropInactiveRuntimeLayouts, executeRuntimeEffectBuffer, getRuntimeRetainedLayout, getRuntimeComponentContract, handleRuntimeComponentInput, hitTestRuntimeLayout, invalidateRuntimeLayouts, listRuntimeRetainedLayouts, popRuntimeView, pushRuntimeView, resolveRuntimeInteractiveTarget, routeRuntimeInput, retainRuntimeLayout, replaceRuntimeRootView, replaceTopRuntimeView, runtimeComponentAcceptsInput, transitionRuntimeState, } from './runtime-engine.js';
-export type { DispatchRuntimeCommandIntentInput, DispatchRuntimeCommandIntentResult, RuntimeBindingLayerModel, RuntimeCommandIntentEmission, RuntimeCommandIntentEmissionOptions, RuntimeCommandIntentRoute, RuntimeCommandIntentRouteInput, RuntimeViewBindingSource, RuntimeViewBindingSourceInput, } from './runtime-binding.js';
-export { collectRuntimeViewBindings, dispatchRuntimeCommandIntent, isRuntimeCommandIntentEmission, isRuntimeCommandIntentRoute, isRuntimeViewBindingSource, runtimeActiveBindingLayers, runtimeCommandIntentEmission, runtimeCommandIntentRoute, runtimeViewBindingSource, } from './runtime-binding.js';
-export { parseKey, parseMouse } from './keys.js';
-export { enterScreen, exitScreen, clearAndHome, renderFrame, setCursorStyle, resetCursorStyle, type CursorShape, ENTER_ALT_SCREEN, EXIT_ALT_SCREEN, HIDE_CURSOR, SHOW_CURSOR, WRAP_DISABLE, WRAP_ENABLE, CLEAR_SCREEN, CLEAR_TO_END, CLEAR_LINE_TO_END, CLEAR_LINE, HOME, CURSOR_BLOCK, CURSOR_UNDERLINE, CURSOR_BAR, CURSOR_RESET, } from './screen.js';
-export { quit, tick, batch } from './commands.js';
-export { type ShellQuitPolicy, resolveShellQuitPolicy, shouldUseShellQuitConfirm, isShellQuitRequest, isShellQuitConfirmAccept, isShellQuitConfirmDismiss, renderShellQuitOverlay, } from './shell-quit.js';
-export { FRAME_I18N_CATALOG, } from './app-frame-i18n.js';
-export { run } from './runtime.js';
-export { type BusMsg, type CommandBackpressureInfo, type CommandQueueDiagnostics, type EventBus, createEventBus, } from './eventbus.js';
-export type { ViewOutput } from './view-output.js';
-export type { RenderState, RenderMiddleware, RenderStage, RenderPipeline, RenderStageTiming, RenderStageCompleteHandler, RenderStageObserver, CreatePipelineOptions, } from './pipeline/pipeline.js';
-export { createPipeline, getRenderStageTimings, RENDER_STAGE_TIMINGS_KEY } from './pipeline/pipeline.js';
-export { grayscaleFilter } from './pipeline/middleware/grayscale.js';
-export type { SurfaceShader, SurfaceShaderContext, ScanlinesShaderOptions, FlickerShaderOptions, NoiseShaderOptions, VignetteShaderOptions, } from './pipeline/middleware/surface-shaders.js';
-export { surfaceShaderFilter, scanlines, flicker, noise, vignette, } from './pipeline/middleware/surface-shaders.js';
-export type { MountOptions, MountedApp, SubAppAdapterCases } from './subapp/mount.js';
-export { mount, mapCmds, initSubApp, updateSubApp, createSubAppAdapter } from './subapp/mount.js';
-export { motion } from './motion/motion.js';
-export { motionMiddleware } from './pipeline/middleware/motion.js';
-export type { MotionOptions } from './motion/types.js';
-export { vstack, hstack, place } from './layout.js';
-export { contentSurface, vstackSurface, hstackSurface, placeSurface, proseSurface } from './surface-layout.js';
-export type { HAlign, VAlign, PlaceOptions } from './layout.js';
-export type { ProseSurfaceOptions, SurfaceContent } from './surface-layout.js';
-export type { LayoutRect } from './layout-rect.js';
-export type { DebugOverlayAnchor, DebugOverlayOptions } from './debug-overlay.js';
-export { debugOverlay } from './debug-overlay.js';
-export type { LayoutInspectorOptions, LayoutInspectorRect, LayoutInspectorRegion, LayoutInspectorScroll, LayoutInspectorXYRect, } from './layout-inspector.js';
-export { layoutInspectorOverlay, layoutInspectorText, } from './layout-inspector.js';
-export type { InputRoutingInspectorHistory, InputRoutingInspectorHistoryOptions, InputRoutingInspectorRecord, InputRoutingInspectorSurfaceOptions, } from './input-routing-inspector.js';
-export { appendInputRoutingRecord, inputRoutingInspectorSurface, inputRoutingInspectorText, } from './input-routing-inspector.js';
-export type { FocusMapIssue, FocusMapIssueKind, FocusMapNode, FocusMapRect, FocusMapReport, FocusMapSurfaceOptions, FocusMapTextOptions, } from './focus-map.js';
-export { focusMapSurface, focusMapText, inspectFocusMap, } from './focus-map.js';
-export type { SurfaceDiff, SurfaceDiffBounds, SurfaceDiffCell, SurfaceDiffCellKind, SurfaceDiffRenderMode, SurfaceDiffRenderOptions, } from './surface-diff.js';
-export { diffSurfaces, surfaceDiffSurface, surfaceDiffText, } from './surface-diff.js';
-export type { EvaluateSurfaceBudgetOptions, SurfaceBudgetMetric, SurfaceBudgetThresholds, SurfaceBudgetWarning, } from './surface-budget.js';
-export { evaluateSurfaceBudget } from './surface-budget.js';
-export type { RaytraceVector3, RaytraceScreenPoint, RaytraceRay, RaytraceSphere, RaytracePlane, RaytraceShape, RaytraceHit, RaytraceLookAtRayOptions, RaytraceOrbitCameraRayOptions, } from './raytrace.js';
-export { raytraceLookAtRay, raytraceOrbitCameraRay, raytraceNearestHit, raytraceSphereHit, raytracePlaneHit, raytraceReflect, raytraceNormalize, raytraceLength, raytraceDot, raytraceCross, raytraceAdd, raytraceSub, raytraceScale, } from './raytrace.js';
-export type { CellGlyphFitMode, CellGlyphCandidate, CellGlyphFitOptions, } from './cell-glyph-fit.js';
-export { CELL_GLYPH_ASCII_DENSITY_RAMP, CELL_GLYPH_UNICODE_CANDIDATES, fitCellGlyph, } from './cell-glyph-fit.js';
-export { type SplitPaneDirection, type SplitPaneFocus, type SplitPaneState, type SplitPaneLayout, type SplitPaneOptions, type SplitPaneSurfaceOptions, createSplitPaneState, splitPaneSetRatio, splitPaneResizeBy, splitPaneFocusNext, splitPaneFocusPrev, splitPaneLayout, splitPane, splitPaneSurface, } from './split-pane.js';
-export { type GridTrack, type GridOptions, type GridSurfaceOptions, type GridLayoutResult, gridLayout, grid, gridSurface, } from './grid.js';
-export { type FrameCommandItem, type FrameInputArea, type FrameLayerHintSource, type FrameLayerKind, type FrameLayerMetadata, type FrameLayerOwner, type FrameLayerDescriptor, type FramePageLayerKind, type FramePageLayerRegistry, type FrameControlProjection, type FrameRuntimeLayer, type FrameRuntimeViewStack, type DescribeFrameLayerStackOptions, type FrameHeaderStyle, type FrameShellTheme, type FrameShellThemeFamily, type FrameShellThemeMode, type FrameShellThemeSpec, type FrameShellThemeChange, type FramePage, type FramePageMsg, type FramePageUpdateResult, type FrameLayoutNode, type FrameOverlayContext, type FrameRuntimeNotificationOptions, type CreateFramedAppOptions, type PageTransition, type FramePaneScroll, type FrameModel, type FrameAction, type FrameNotificationSpec, type FramedApp, type FramedAppRunOptions, type FramedAppMsg, type FramedAppUpdateResult, type FrameScopedMsg, type PageScopedMsg, type FrameTimingSnapshot, type FramePerfHudTelemetry, type FramePerfHudOverlayOptions, activeFrameLayer, describeFrameLayerStack, describeFrameRuntimeViewStack, createFramedApp, emitFrameAction, notify, projectFrameControls, renderFramePerfHudOverlay, runFramedApp, summarizeFrameTimings, underlyingFrameLayer, } from './app-frame.js';
-export { type PanelVisibilityState, type PanelMaximizeState, createPanelVisibilityState, createPanelMaximizeState, toggleMinimized, minimizePane, restorePane, isMinimized, toggleMaximize, } from './panel-state.js';
-export { type DockDirection, type PanelDockState, createPanelDockState, movePaneInContainer, resolveChildOrder, findPaneContainer, getNodeId, } from './panel-dock.js';
-export { type SerializedPageLayout, type SerializedLayoutState, type LayoutPreset, serializeLayoutState, restoreLayoutState, presetSideBySide, presetStacked, presetFocused, } from './layout-preset.js';
-export { type TransitionCell, type TransitionResult, type TransitionShaderFn, type TransitionOverrideRole, type WipeDirection, type BuiltinTransition, wipeShader, dissolveShader, gridShader, fadeShader, meltShader, matrixShader, scrambleShader, radialShader, diamondShader, spiralShader, blindsShader, curtainShader, pixelateShader, typewriterShader, glitchShader, staticShader, wipe, radial, diamond, spiral, blinds, curtain, pixelate, typewriter, glitch, tvStatic, reverse, chain, overlay, TRANSITION_SHADERS, } from './transition-shaders.js';
-export { statusBar, statusBarSurface } from './status-bar.js';
-export type { StatusBarOptions } from './status-bar.js';
-export { type SpringConfig, type SpringPreset, type SpringState, SPRING_PRESETS, springStep, createSpringState, resolveSpringConfig, type EasingFn, EASINGS, type TweenConfig, type TweenState, tweenStep, createTweenState, resolveTweenConfig, } from './spring.js';
-export { type SpringAnimateOptions, type TweenAnimateOptions, type AnimateOptions, animate, sequence, } from './animate.js';
-export { TUI_SPACING, COMPACT_VIEWPORT_WIDTH, COMPACT_VIEWPORT_HEIGHT, isCompactViewport, resolveOverlayMargin, resolveNotificationGap, } from './design-language.js';
-export { type ViewportContent, type ViewportOptions, type ViewportSurfaceOptions, type ScrollState, viewport, viewportSurface, createScrollState, createScrollStateForContent, scrollBy, scrollTo, scrollToTop, scrollToBottom, pageDown, pageUp, stripAnsi, visibleLength, clipToWidth, sliceAnsi, scrollByX, scrollToX, } from './viewport.js';
-export { type Position, type SpringTrackDef, type TweenTrackDef, type TrackDef, type TimelineState, type TimelineBuilder, type Timeline, timeline, } from './timeline.js';
-export { type FlexOptions, type FlexChild, type SurfaceFlexChild, flex, flexSurface, } from './flex.js';
-export { type KeyCombo, type BindingInfo, type KeyMap, type KeyMapGroup, createKeyMap, parseKeyCombo, formatKeyCombo, } from './keybindings.js';
-export { type InputActionBinding, type InputActionMap, type InputDevice, type InputEvent, type InputFeature, type InputFeatureEvent, type InputFeatureEventPattern, type InputFeatureEventType, type InputGestureRecognizer, type InputGestureRecognizerOptions, type StandardInputFeatureEventType, DEFAULT_DOUBLE_TAP_MS, KEYBOARD_INPUT_DEVICE_ID, createInputActionMap, createInputGestureRecognizer, defineInputDevice, defineInputFeature, inputEventMatches, inputFeatureEvent, keyboardFeature, keyboardModifierFeature, } from './input-map.js';
-export { type BindingSource, type HelpOptions, type HelpSurfaceOptions, helpView, helpViewSurface, helpShort, helpShortSurface, helpFor, helpForSurface, } from './help.js';
-export { type InputHandler, type LayerOptions, type LayerInfo, type InputStack, createInputStack, } from './inputstack.js';
-export { type PagerState, type PagerOptions, type PagerRenderOptions, createPagerState, createPagerStateForSurface, pager, pagerSurface, pagerScrollBy, pagerScrollTo, pagerScrollToTop, pagerScrollToBottom, pagerPageDown, pagerPageUp, pagerSetContent, pagerKeyMap, } from './pager.js';
-export { type PanelDef, type PanelGroupOptions, type PanelGroup, createPanelGroup, } from './panels.js';
-export { type Overlay, type CompositeOptions, type ModalOptions, type ToastVariant, type ToastAnchor, type ToastOptions, type DrawerAnchor, type DrawerOptions, type TooltipDirection, type TooltipOptions, composite, compositeSurface, modal, toast, drawer, tooltip, } from './overlay.js';
-export { type InspectorDrawerOptions, inspectorDrawer, } from './inspector-drawer.js';
-export { type NotificationHistoryFilter, type NotificationVariant, type NotificationTone, type NotificationPlacement, type NotificationAction, type NotificationSpec, type NotificationPhase, type NotificationRecord, type NotificationState, type NotificationMouseTargetKind, type NotificationMouseTarget, type RenderNotificationHistoryOptions, type RenderNotificationStackOptions, countNotificationHistory, createNotificationState, pushNotification, dismissNotification, dismissFocusedNotification, relocateNotifications, cycleNotificationFocus, activateFocusedNotification, trimNotificationsToViewport, tickNotifications, hasNotifications, notificationsNeedTick, hitTestNotificationStack, renderNotificationHistory, renderNotificationHistorySurface, renderNotificationStack, } from './notification.js';
-export { type AccordionState, type InteractiveAccordionOptions, createAccordionState, interactiveAccordion, focusNext, focusPrev, toggleFocused, expandAll, collapseAll, accordionKeyMap, } from './accordion.js';
-export { type NavigableTableState, type NavigableTableInput, type NavigableTableOptions, type NavTableRenderOptions, type NavTableSurfaceOptions, createNavigableTableState, navigableTable, navigableTableSurface, navTableFocusNext, navTableFocusPrev, navTablePageDown, navTablePageUp, navTableKeyMap, } from './navigable-table.js';
-export { type BrowsableListSurfaceOptions, type BrowsableListItem, type BrowsableListState, type BrowsableListOptions, type BrowsableListRenderOptions, createBrowsableListState, browsableList, browsableListSurface, listFocusNext, listFocusPrev, listPageDown, listPageUp, browsableListKeyMap, } from './browsable-list.js';
-export { type FilePickerSurfaceOptions, type FileEntry, type FilePickerState, type FilePickerOptions, type FilePickerRenderOptions, createFilePickerState, filePicker, filePickerSurface, fpFocusNext, fpFocusPrev, fpEnter, fpBack, filePickerKeyMap, } from './file-picker.js';
-export { type ScriptStep, type RunScriptOptions, type RunScriptResult, type TestRuntimeOptions, type TestRuntimeCommandResolution, type TestRuntimeCommandRecord, type TestRuntimeSnapshot, type TestHarness, runScript, testRuntime, } from './driver.js';
-export { type ShaderFn, type CanvasOptions, canvas, } from './canvas.js';
-export { type RasterGlyphCharsetOrder, type RasterGlyphRenderer, type RasterGlyphCharsetRenderer, type RasterGlyphBrailleRenderer, type RasterGlyphQuadRenderer, type RasterGlyphFit, type RasterGlyphColorMode, type RasterGlyphDitherMode, type RasterToGlyphSurfaceOptions, type RgbaFrame, RASTER_GLYPH_CHARSETS, rasterToGlyphSurface, validateRasterGlyphCharset, } from './raster-glyph.js';
-export { type CommandPaletteItem, type CommandPaletteState, type CommandPaletteOptions, type CommandPaletteSurfaceOptions, createCommandPaletteState, cpFilter, cpFocusNext, cpFocusPrev, cpPageDown, cpPageUp, cpSelectedItem, commandPalette, commandPaletteSurface, commandPaletteKeyMap, } from './command-palette.js';
-export { type OverflowX, type FocusAreaState, type FocusAreaOptions, type FocusAreaRenderOptions, createFocusAreaState, createFocusAreaStateForSurface, focusArea, focusAreaSurface, focusAreaScrollBy, focusAreaScrollTo, focusAreaScrollToTop, focusAreaScrollToBottom, focusAreaPageDown, focusAreaPageUp, focusAreaScrollByX, focusAreaScrollToX, focusAreaSetContent, focusAreaKeyMap, } from './focus-area.js';
-export { type DagPaneDagOptions, type DagPaneState, type DagPaneOptions, type DagPaneRenderOptions, createDagPaneState, dagPane, dagPaneSelectChild, dagPaneSelectParent, dagPaneSelectLeft, dagPaneSelectRight, dagPaneSelectNode, dagPaneClearSelection, dagPaneScrollBy, dagPaneScrollToTop, dagPaneScrollToBottom, dagPanePageDown, dagPanePageUp, dagPaneScrollByX, dagPaneSetSource, dagPaneKeyMap, } from './dag-pane.js';
+export * from './index.part01.js';
+export * from './index.part02.js';
+export * from './index.part03.js';
+export * from './index.part04.js';
+export * from './index.part05.js';
+export * from './index.part06.js';
+export * from './index.part07.js';
+export * from './index.part08.js';
 //# sourceMappingURL=index.d.ts.map