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

package/dist/browsable-list.part01.d.ts

@@ -0,0 +1,86 @@
+import { type BijouContext } from '@flyingrobots/bijou';
+import type { SelectedRowOverflow } from './collection-surface.js';
+/**
+ * A single item in a browsable list.
+ *
+ * @template T - Type of the item's value payload.
+ */
+export interface BrowsableListItem<T = string> {
+    /** Display label shown in the list. */
+    label: string;
+    /** Value payload returned when this item is selected. */
+    value: T;
+    /** Optional description displayed after the label, rendered as `label — description`. */
+    description?: string;
+}
+/**
+ * Readonly state for the browsable list widget.
+ *
+ * @template T - Type of each item's value payload.
+ */
+export interface BrowsableListState<T = string> {
+    /** All items in the list. */
+    readonly items: readonly BrowsableListItem<T>[];
+    /** Index of the currently focused item. */
+    readonly focusIndex: number;
+    /** Vertical scroll offset (first visible item index). */
+    readonly scrollY: number;
+    /** Maximum number of visible items. */
+    readonly height: number;
+}
+/**
+ * Options for creating a new browsable list state.
+ *
+ * @template T - Type of each item's value payload.
+ */
+export interface BrowsableListOptions<T = string> {
+    /** Items to populate the list. */
+    readonly items: readonly BrowsableListItem<T>[];
+    /** Maximum number of visible items (default: 10). */
+    readonly height?: number;
+}
+export interface BrowsableListRenderItemState<T> {
+    readonly item: BrowsableListItem<T>;
+    readonly index: number;
+    readonly focused: boolean;
+    readonly ctx?: BijouContext;
+}
+export type BrowsableListItemRenderer<T> = (state: BrowsableListRenderItemState<T>) => string;
+/** Options for rendering the browsable list view. */
+export interface BrowsableListRenderOptions<T = string> {
+    /** Character(s) shown next to the focused item (default: `"\u25b8"`). */
+    readonly focusIndicator?: string;
+    /** Bijou context for theming and styling. */
+    readonly ctx?: BijouContext;
+    /** Optional row formatter for custom list chrome. */
+    readonly renderItem?: BrowsableListItemRenderer<T>;
+}
+/** Options for rendering the browsable list into a `Surface`. */
+export interface BrowsableListSurfaceOptions<T = string> extends BrowsableListRenderOptions<T> {
+    /** Fixed viewport width. Defaults to the widest rendered row. */
+    readonly width?: number;
+    /** Show a scrollbar track on the right edge. Default: false. */
+    readonly showScrollbar?: boolean;
+    /** Overflow behavior for the focused row. Defaults to `clip`. */
+    readonly focusedRowOverflow?: SelectedRowOverflow;
+}
+/**
+ * Create initial browsable list state from items and optional height.
+ * Focus starts at index 0 with scroll at the top.
+ * @template T - Type of each item's value payload.
+ * @param options - Items and optional viewport height.
+ * @returns Fresh browsable list state with focus at the top.
+ */
+export declare function createBrowsableListState<T = string>(options: BrowsableListOptions<T>): BrowsableListState<T>;
+/**
+ * Clamp scroll position so the focused item stays within the visible window.
+ *
+ * @param focusIndex - Index of the focused item.
+ * @param scrollY - Current scroll offset.
+ * @param height - Viewport height in items.
+ * @param totalItems - Total number of items.
+ * @returns Adjusted scroll offset.
+ */
+declare function adjustScroll(focusIndex: number, scrollY: number, height: number, totalItems: number): number;
+export { adjustScroll };
+//# sourceMappingURL=browsable-list.part01.d.ts.map

package/dist/browsable-list.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browsable-list.part01.d.ts","sourceRoot":"","sources":["../src/browsable-list.part01.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAMnE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM;IAC3C,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,CAAC,CAAC;IACT,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM;IAC5C,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,MAAM;IAC9C,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;AAE9F,qDAAqD;AACrD,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,MAAM;IACpD,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,iEAAiE;AACjE,MAAM,WAAW,2BAA2B,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,0BAA0B,CAAC,CAAC,CAAC;IAC5F,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CACnD;AAMD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,GAAG,MAAM,EACjD,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,kBAAkB,CAAC,CAAC,CAAC,CAQvB;AAMD;;;;;;;;GAQG;AACH,iBAAS,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CASrG;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/browsable-list.part01.js

@@ -0,0 +1,45 @@
+import { sanitizePositiveInt } from '@flyingrobots/bijou';
+// ---------------------------------------------------------------------------
+// State creation
+// ---------------------------------------------------------------------------
+/**
+ * Create initial browsable list state from items and optional height.
+ * Focus starts at index 0 with scroll at the top.
+ * @template T - Type of each item's value payload.
+ * @param options - Items and optional viewport height.
+ * @returns Fresh browsable list state with focus at the top.
+ */
+export function createBrowsableListState(options) {
+    const height = sanitizePositiveInt(options.height, 10);
+    return {
+        items: [...options.items],
+        focusIndex: 0,
+        scrollY: 0,
+        height,
+    };
+}
+// ---------------------------------------------------------------------------
+// Scroll helper
+// ---------------------------------------------------------------------------
+/**
+ * Clamp scroll position so the focused item stays within the visible window.
+ *
+ * @param focusIndex - Index of the focused item.
+ * @param scrollY - Current scroll offset.
+ * @param height - Viewport height in items.
+ * @param totalItems - Total number of items.
+ * @returns Adjusted scroll offset.
+ */
+function adjustScroll(focusIndex, scrollY, height, totalItems) {
+    let newScrollY = scrollY;
+    if (focusIndex < newScrollY) {
+        newScrollY = focusIndex;
+    }
+    else if (focusIndex >= newScrollY + height) {
+        newScrollY = focusIndex - height + 1;
+    }
+    const maxScroll = Math.max(0, totalItems - height);
+    return Math.min(newScrollY, maxScroll);
+}
+export { adjustScroll };
+//# sourceMappingURL=browsable-list.part01.js.map

package/dist/browsable-list.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browsable-list.part01.js","sourceRoot":"","sources":["../src/browsable-list.part01.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,qBAAqB,CAAC;AA8E7E,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAgC;IAEhC,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACzB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,MAAM;KACP,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,SAAS,YAAY,CAAC,UAAkB,EAAE,OAAe,EAAE,MAAc,EAAE,UAAkB;IAC3F,IAAI,UAAU,GAAG,OAAO,CAAC;IACzB,IAAI,UAAU,GAAG,UAAU,EAAE,CAAC;QAC5B,UAAU,GAAG,UAAU,CAAC;IAC1B,CAAC;SAAM,IAAI,UAAU,IAAI,UAAU,GAAG,MAAM,EAAE,CAAC;QAC7C,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/browsable-list.part02.d.ts

@@ -0,0 +1,49 @@
+import type { BijouContext } from '@flyingrobots/bijou';
+import type { BrowsableListItemRenderer, BrowsableListRenderOptions, BrowsableListState } from './browsable-list.part01.js';
+/**
+ * Move focus to the next item (wraps around).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus on the next item.
+ */
+export declare function listFocusNext<T>(state: BrowsableListState<T>): BrowsableListState<T>;
+/**
+ * Move focus to the previous item (wraps around).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus on the previous item.
+ */
+export declare function listFocusPrev<T>(state: BrowsableListState<T>): BrowsableListState<T>;
+/**
+ * Move focus down by one page (clamps to last item).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus advanced by one page.
+ */
+export declare function listPageDown<T>(state: BrowsableListState<T>): BrowsableListState<T>;
+/**
+ * Move focus up by one page (clamps to first item).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus moved back by one page.
+ */
+export declare function listPageUp<T>(state: BrowsableListState<T>): BrowsableListState<T>;
+declare function renderBrowsableListLines<T>(state: BrowsableListState<T>, indicator: string, ctx?: BijouContext, renderItem?: BrowsableListItemRenderer<T>): string[];
+/**
+ * Render the browsable list — visible items within the viewport with a
+ * focus indicator on the currently focused item.
+ *
+ * Items with a `description` field render as `label — description`.
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @param options - Rendering options (focus indicator, context).
+ * @returns Rendered list string with focus indicator on the active item.
+ */
+export declare function browsableList<T>(state: BrowsableListState<T>, options?: BrowsableListRenderOptions<T>): string;
+export { renderBrowsableListLines };
+//# sourceMappingURL=browsable-list.part02.d.ts.map

package/dist/browsable-list.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browsable-list.part02.d.ts","sourceRoot":"","sources":["../src/browsable-list.part02.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAM5H;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAIpF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAIpF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAInF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAIjF;AAED,iBAAS,wBAAwB,CAAC,CAAC,EACjC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACxC,MAAM,EAAE,CAmBV;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACtC,MAAM,CAOR;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/browsable-list.part02.js

@@ -0,0 +1,100 @@
+import { adjustScroll } from './browsable-list.part01.js';
+// ---------------------------------------------------------------------------
+// State transformers
+// ---------------------------------------------------------------------------
+/**
+ * Move focus to the next item (wraps around).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus on the next item.
+ */
+export function listFocusNext(state) {
+    if (state.items.length === 0)
+        return state;
+    const focusIndex = (state.focusIndex + 1) % state.items.length;
+    return { ...state, focusIndex, scrollY: adjustScroll(focusIndex, state.scrollY, state.height, state.items.length) };
+}
+/**
+ * Move focus to the previous item (wraps around).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus on the previous item.
+ */
+export function listFocusPrev(state) {
+    if (state.items.length === 0)
+        return state;
+    const focusIndex = (state.focusIndex - 1 + state.items.length) % state.items.length;
+    return { ...state, focusIndex, scrollY: adjustScroll(focusIndex, state.scrollY, state.height, state.items.length) };
+}
+/**
+ * Move focus down by one page (clamps to last item).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus advanced by one page.
+ */
+export function listPageDown(state) {
+    if (state.items.length === 0)
+        return state;
+    const focusIndex = Math.min(state.focusIndex + state.height, state.items.length - 1);
+    return { ...state, focusIndex, scrollY: adjustScroll(focusIndex, state.scrollY, state.height, state.items.length) };
+}
+/**
+ * Move focus up by one page (clamps to first item).
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @returns Updated list state with focus moved back by one page.
+ */
+export function listPageUp(state) {
+    if (state.items.length === 0)
+        return state;
+    const focusIndex = Math.max(state.focusIndex - state.height, 0);
+    return { ...state, focusIndex, scrollY: adjustScroll(focusIndex, state.scrollY, state.height, state.items.length) };
+}
+function renderBrowsableListLines(state, indicator, ctx, renderItem) {
+    const pad = ' '.repeat(indicator.length);
+    return state.items.map((item, index) => {
+        if (renderItem) {
+            return renderItem({
+                item,
+                index,
+                focused: index === state.focusIndex,
+                ctx,
+            });
+        }
+        const prefix = index === state.focusIndex ? indicator : pad;
+        const desc = item.description == null
+            ? ''
+            : ctx
+                ? ` ${ctx.style.styled(ctx.semantic('muted'), `\u2014 ${item.description}`)}`
+                : ` \u2014 ${item.description}`;
+        return `${prefix} ${item.label}${desc}`;
+    });
+}
+// ---------------------------------------------------------------------------
+// Render
+// ---------------------------------------------------------------------------
+/**
+ * Render the browsable list — visible items within the viewport with a
+ * focus indicator on the currently focused item.
+ *
+ * Items with a `description` field render as `label — description`.
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @param options - Rendering options (focus indicator, context).
+ * @returns Rendered list string with focus indicator on the active item.
+ */
+export function browsableList(state, options) {
+    if (state.items.length === 0)
+        return '';
+    const indicator = options?.focusIndicator ?? '\u25b8';
+    return renderBrowsableListLines(state, indicator, options?.ctx, options?.renderItem)
+        .slice(state.scrollY, state.scrollY + state.height)
+        .join('\n');
+}
+export { renderBrowsableListLines };
+//# sourceMappingURL=browsable-list.part02.js.map

package/dist/browsable-list.part02.js.map

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

package/dist/browsable-list.part03.d.ts

@@ -0,0 +1,43 @@
+import { type Surface } from '@flyingrobots/bijou';
+import { type KeyMap } from './keybindings.js';
+import type { BrowsableListState, BrowsableListSurfaceOptions } from './browsable-list.part01.js';
+/**
+ * Render the browsable list directly into a viewport-backed `Surface`.
+ *
+ * This keeps scroll ownership on the shared `viewportSurface()` masking
+ * primitive instead of each list carrying bespoke slice logic.
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @param options - Rendering options plus optional fixed width.
+ * @returns Surface-sized list viewport using the list height as the visible window.
+ */
+export declare function browsableListSurface<T>(state: BrowsableListState<T>, options?: BrowsableListSurfaceOptions<T>): Surface;
+/**
+ * Create a preconfigured KeyMap for browsable list navigation.
+ *
+ * The caller provides their own message types for each action:
+ * ```ts
+ * const keys = browsableListKeyMap({
+ *   focusNext: { type: 'next' },
+ *   focusPrev: { type: 'prev' },
+ *   pageDown: { type: 'page-down' },
+ *   pageUp: { type: 'page-up' },
+ *   select: { type: 'select' },
+ *   quit: { type: 'quit' },
+ * });
+ * ```
+ *
+ * @template Msg - Application message type dispatched by key bindings.
+ * @param actions - Map of navigation actions to message values.
+ * @returns Preconfigured key map with vim-style list bindings.
+ */
+export declare function browsableListKeyMap<Msg>(actions: {
+    focusNext: Msg;
+    focusPrev: Msg;
+    pageDown: Msg;
+    pageUp: Msg;
+    select: Msg;
+    quit: Msg;
+}): KeyMap<Msg>;
+//# sourceMappingURL=browsable-list.part03.d.ts.map

package/dist/browsable-list.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browsable-list.part03.d.ts","sourceRoot":"","sources":["../src/browsable-list.part03.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAGlG;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACvC,OAAO,CA8BT;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE;IAChD,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;CACX,GAAG,MAAM,CAAC,GAAG,CAAC,CAed"}

package/dist/browsable-list.part03.js

@@ -0,0 +1,77 @@
+import { createSurface, sanitizePositiveInt } from '@flyingrobots/bijou';
+import { createKeyMap } from './keybindings.js';
+import { viewportSurface, visibleLength } from './viewport.js';
+import { collectionRowsSurface } from './collection-surface.js';
+import { renderBrowsableListLines } from './browsable-list.part02.js';
+/**
+ * Render the browsable list directly into a viewport-backed `Surface`.
+ *
+ * This keeps scroll ownership on the shared `viewportSurface()` masking
+ * primitive instead of each list carrying bespoke slice logic.
+ *
+ * @template T - Type of each item's value payload.
+ * @param state - Current list state.
+ * @param options - Rendering options plus optional fixed width.
+ * @returns Surface-sized list viewport using the list height as the visible window.
+ */
+export function browsableListSurface(state, options) {
+    const indicator = options?.focusIndicator ?? '\u25b8';
+    const lines = renderBrowsableListLines(state, indicator, options?.ctx, options?.renderItem);
+    const width = options?.width != null
+        ? Math.max(1, sanitizePositiveInt(options.width, 1))
+        : Math.max(1, ...lines.map((line) => visibleLength(line)));
+    if (lines.length === 0) {
+        return createSurface(width, Math.max(1, state.height));
+    }
+    const content = collectionRowsSurface(lines, {
+        width,
+        selectedRowIndex: state.focusIndex,
+        selectedRowOverflow: options?.focusedRowOverflow,
+        ctx: options?.ctx,
+    });
+    return viewportSurface({
+        width,
+        height: Math.max(1, state.height),
+        content,
+        scrollY: state.scrollY,
+        showScrollbar: options?.showScrollbar ?? false,
+    });
+}
+// ---------------------------------------------------------------------------
+// Convenience keymap
+// ---------------------------------------------------------------------------
+/**
+ * Create a preconfigured KeyMap for browsable list navigation.
+ *
+ * The caller provides their own message types for each action:
+ * ```ts
+ * const keys = browsableListKeyMap({
+ *   focusNext: { type: 'next' },
+ *   focusPrev: { type: 'prev' },
+ *   pageDown: { type: 'page-down' },
+ *   pageUp: { type: 'page-up' },
+ *   select: { type: 'select' },
+ *   quit: { type: 'quit' },
+ * });
+ * ```
+ *
+ * @template Msg - Application message type dispatched by key bindings.
+ * @param actions - Map of navigation actions to message values.
+ * @returns Preconfigured key map with vim-style list bindings.
+ */
+export function browsableListKeyMap(actions) {
+    return createKeyMap()
+        .group('Navigation', (g) => g
+        .bind('j', 'Next item', actions.focusNext)
+        .bind('down', 'Next item', actions.focusNext)
+        .bind('k', 'Previous item', actions.focusPrev)
+        .bind('up', 'Previous item', actions.focusPrev)
+        .bind('d', 'Page down', actions.pageDown)
+        .bind('pagedown', 'Page down', actions.pageDown)
+        .bind('u', 'Page up', actions.pageUp)
+        .bind('pageup', 'Page up', actions.pageUp))
+        .bind('enter', 'Select', actions.select)
+        .bind('q', 'Quit', actions.quit)
+        .bind('ctrl+c', 'Quit', actions.quit);
+}
+//# sourceMappingURL=browsable-list.part03.js.map

package/dist/browsable-list.part03.js.map

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

package/dist/canvas.d.ts

@@ -1,30 +1,3 @@
-import { type Surface, type Cell } from '@flyingrobots/bijou';
-import { type CellGlyphFitOptions } from './cell-glyph-fit.js';
-export interface ShaderParams {
-    /** Normalized horizontal coordinate (0.0 to 1.0). */
-    u: number;
-    /** Normalized vertical coordinate (0.0 to 1.0). */
-    v: number;
-    /** Animation time value in seconds. */
-    time: number;
-    /** Custom data bag passed to the shader. */
-    uniforms: Record<string, unknown>;
-}
-export interface ShaderCell extends Cell {
-    /** Optional normalized coverage used by glyph-fit resolution. */
-    readonly coverage?: number;
-}
-export type ShaderFn = (params: ShaderParams) => ShaderCell | string;
-export type CanvasResolution = 'cell' | 'quad' | 'braille' | 'glyph';
-export interface CanvasOptions {
-    /** Animation time value passed to the shader. Default: 0. */
-    time?: number;
-    /** Plotting resolution. Default: 'cell'. */
-    resolution?: CanvasResolution;
-    /** Custom data passed to the shader. */
-    uniforms?: Record<string, unknown>;
-    /** Glyph fitting options used when resolution is 'glyph'. */
-    glyphFit?: CellGlyphFitOptions;
-}
-export declare function canvas(cols: number, rows: number, shader: ShaderFn, options?: CanvasOptions): Surface;
+export type { CanvasOptions, CanvasResolution, ShaderCell, ShaderFn, ShaderParams } from './canvas.part01.js';
+export { canvas } from './canvas.part03.js';
 //# sourceMappingURL=canvas.d.ts.map

package/dist/canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../src/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAElH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAoG7E,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,CAAC,EAAE,MAAM,CAAC;IACV,mDAAmD;IACnD,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,UAAU,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAsBT"}
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../src/canvas.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}