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

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":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG1D,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAI,KAA4B;IAC3D,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IAC/D,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AACtH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAI,KAA4B;IAC3D,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACpF,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AACtH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAI,KAA4B;IAC1D,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrF,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AACtH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAI,KAA4B;IACxD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;AACtH,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAA4B,EAC5B,SAAiB,EACjB,GAAkB,EAClB,UAAyC;IAEzC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;gBAChB,IAAI;gBACJ,KAAK;gBACL,OAAO,EAAE,KAAK,KAAK,KAAK,CAAC,UAAU;gBACnC,GAAG;aACJ,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG;gBACH,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE;gBAC7E,CAAC,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA4B,EAC5B,OAAuC;IAEvC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,SAAS,GAAG,OAAO,EAAE,cAAc,IAAI,QAAQ,CAAC;IACtD,OAAO,wBAAwB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC;SACjF,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;SAClD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

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,62 +1,3 @@
-/**
- * Rich shader-based canvas primitive for procedural character art.
- *
- * Supports high-resolution plotting via Braille and Quad characters,
- * with normalized UV mapping and full color/styling support.
- */
-import { type Surface, type Cell } from '@flyingrobots/bijou';
-import { type CellGlyphFitOptions } from './cell-glyph-fit.js';
-/**
- * Parameters passed to the shader function.
- */
-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, any>;
-}
-export interface ShaderCell extends Cell {
-    /** Optional normalized coverage used by glyph-fit resolution. */
-    readonly coverage?: number;
-}
-/**
- * Shader function called per "pixel" (cell or sub-pixel).
- *
- * Returns a Cell defining the character and style.
- * In high-res modes (Braille/Quad), the character is treated as a boolean
- * (non-space = on) and available foreground/background colors are averaged
- * across sampled sub-pixels.
- */
-export type ShaderFn = (params: ShaderParams) => ShaderCell | string;
-/**
- * Resolution modes for the canvas.
- */
-export type CanvasResolution = 'cell' | 'quad' | 'braille' | 'glyph';
-/**
- * Options for the {@link canvas} renderer.
- */
-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, any>;
-    /** Glyph fitting options used when resolution is 'glyph'. */
-    glyphFit?: CellGlyphFitOptions;
-}
-/**
- * Render procedural art using a fragment shader.
- *
- * @param cols - Grid width in columns.
- * @param rows - Grid height in rows.
- * @param shader - Function called for every pixel/sub-pixel.
- * @param options - Canvas configuration.
- * @returns A Surface containing the rendered art.
- */
-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;;;;;GAKG;AAEH,OAAO,EAAkC,KAAK,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAElH,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA6F7E;;GAEG;AACH,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,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,UAAU,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,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,GAAG,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,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"}

package/dist/canvas.js

@@ -1,281 +1,2 @@
-/**
- * Rich shader-based canvas primitive for procedural character art.
- *
- * Supports high-resolution plotting via Braille and Quad characters,
- * with normalized UV mapping and full color/styling support.
- */
-import { createSurface, isPackedSurface } from '@flyingrobots/bijou';
-import { parseHex, encodeModifiers } from '@flyingrobots/bijou/perf';
-import { fitCellGlyph } from './cell-glyph-fit.js';
-function resolvedColorRgb(ref) {
-    return typeof ref === 'object'
-        && ref !== null
-        && 'kind' in ref
-        && ref.kind === 'resolved-color'
-        && 'rgb' in ref
-        ? ref.rgb
-        : undefined;
-}
-function resolvedColorHex(ref) {
-    if (typeof ref === 'string')
-        return ref;
-    return typeof ref === 'object'
-        && ref !== null
-        && 'kind' in ref
-        && ref.kind === 'resolved-color'
-        && 'hex' in ref
-        ? ref.hex
-        : undefined;
-}
-function resolveCellColor(rgb, ref) {
-    if (rgb !== undefined)
-        return rgb;
-    const resolvedRgb = resolvedColorRgb(ref);
-    if (resolvedRgb !== undefined)
-        return resolvedRgb;
-    const hex = resolvedColorHex(ref);
-    return hex === undefined ? undefined : parseHex(hex);
-}
-function createColorAccumulator() {
-    return { r: 0, g: 0, b: 0, count: 0 };
-}
-function createStyleAccumulator() {
-    return {
-        fg: createColorAccumulator(),
-        bg: createColorAccumulator()
-    };
-}
-function accumulateColor(accumulator, rgb) {
-    accumulator.r += rgb[0];
-    accumulator.g += rgb[1];
-    accumulator.b += rgb[2];
-    accumulator.count++;
-}
-function accumulateResolvedColor(accumulator, rgb, ref) {
-    const resolved = resolveCellColor(rgb, ref);
-    if (resolved !== undefined)
-        accumulateColor(accumulator, resolved);
-}
-function accumulateCellStyle(accumulator, cell) {
-    accumulateResolvedColor(accumulator.fg, cell.fgRGB, cell.fg);
-    accumulateResolvedColor(accumulator.bg, cell.bgRGB, cell.bg);
-}
-function averagedColor(accumulator) {
-    if (accumulator.count === 0)
-        return undefined;
-    return [
-        Math.round(accumulator.r / accumulator.count),
-        Math.round(accumulator.g / accumulator.count),
-        Math.round(accumulator.b / accumulator.count)
-    ];
-}
-function averagedCellStyle(accumulator) {
-    const style = {};
-    const fgRGB = averagedColor(accumulator.fg);
-    const bgRGB = averagedColor(accumulator.bg);
-    if (fgRGB !== undefined)
-        style.fgRGB = fgRGB;
-    if (bgRGB !== undefined)
-        style.bgRGB = bgRGB;
-    return style;
-}
-/**
- * Render procedural art using a fragment shader.
- *
- * @param cols - Grid width in columns.
- * @param rows - Grid height in rows.
- * @param shader - Function called for every pixel/sub-pixel.
- * @param options - Canvas configuration.
- * @returns A Surface containing the rendered art.
- */
-export function canvas(cols, rows, shader, options = {}) {
-    const { resolution = 'cell', time = 0, uniforms = {}, glyphFit } = options;
-    const surface = createSurface(cols, rows);
-    if (cols <= 0 || rows <= 0)
-        return surface;
-    switch (resolution) {
-        case 'cell':
-            renderCellResolution(surface, shader, time, uniforms);
-            break;
-        case 'quad':
-            renderQuadResolution(surface, shader, time, uniforms);
-            break;
-        case 'braille':
-            renderBrailleResolution(surface, shader, time, uniforms);
-            break;
-        case 'glyph':
-            renderGlyphResolution(surface, shader, time, uniforms, glyphFit);
-            break;
-    }
-    return surface;
-}
-function setCellFast(surface, packed, x, y, cell) {
-    if (packed && (cell.fgRGB != null || cell.fg != null || cell.bgRGB != null || cell.bg != null)) {
-        let fR = -1, fG = 0, fB = 0;
-        const fg = resolveCellColor(cell.fgRGB, cell.fg);
-        if (fg) {
-            [fR, fG, fB] = fg;
-        }
-        let bR = -1, bG = 0, bB = 0;
-        const bg = resolveCellColor(cell.bgRGB, cell.bg);
-        if (bg) {
-            [bR, bG, bB] = bg;
-        }
-        if (fg || bg) {
-            surface.setRGB(x, y, cell.char, fR, fG, fB, bR, bG, bB, encodeModifiers(cell.modifiers));
-            return;
-        }
-    }
-    surface.set(x, y, cell);
-}
-function renderCellResolution(surface, shader, time, uniforms) {
-    const { width, height } = surface;
-    const packed = isPackedSurface(surface);
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            const result = shader({
-                u: x / (width - 1 || 1),
-                v: y / (height - 1 || 1),
-                time,
-                uniforms
-            });
-            const cell = typeof result === 'string' ? { char: result } : result;
-            setCellFast(surface, packed, x, y, cell);
-        }
-    }
-}
-function renderQuadResolution(surface, shader, time, uniforms) {
-    const { width, height } = surface;
-    const packed = isPackedSurface(surface);
-    const subW = width * 2;
-    const subH = height * 2;
-    const QUAD_CHARS = {
-        0: ' ', 1: '▘', 2: '▝', 3: '▀',
-        4: '▖', 5: '▌', 6: '▞', 7: '▛',
-        8: '▗', 9: '▚', 10: '▐', 11: '▜',
-        12: '▄', 13: '▙', 14: '▟', 15: '█'
-    };
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            let mask = 0;
-            let firstStyledCell = null;
-            const styleAccumulator = createStyleAccumulator();
-            for (let sy = 0; sy < 2; sy++) {
-                for (let sx = 0; sx < 2; sx++) {
-                    const px = x * 2 + sx;
-                    const py = y * 2 + sy;
-                    const result = shader({
-                        u: px / (subW - 1 || 1),
-                        v: py / (subH - 1 || 1),
-                        time,
-                        uniforms
-                    });
-                    const cell = typeof result === 'string' ? { char: result } : result;
-                    accumulateCellStyle(styleAccumulator, cell);
-                    if (cell.char !== ' ') {
-                        mask |= (1 << (sy * 2 + sx));
-                        if (!firstStyledCell)
-                            firstStyledCell = cell;
-                    }
-                }
-            }
-            setCellFast(surface, packed, x, y, {
-                ...(firstStyledCell || { char: ' ' }),
-                ...averagedCellStyle(styleAccumulator),
-                char: QUAD_CHARS[mask] || ' '
-            });
-        }
-    }
-}
-function renderBrailleResolution(surface, shader, time, uniforms) {
-    const { width, height } = surface;
-    const packed = isPackedSurface(surface);
-    const subW = width * 2;
-    const subH = height * 4;
-    const DOT_MAP = [
-        [0x01, 0x08],
-        [0x02, 0x10],
-        [0x04, 0x20],
-        [0x40, 0x80]
-    ];
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            let code = 0;
-            let firstStyledCell = null;
-            const styleAccumulator = createStyleAccumulator();
-            for (let sy = 0; sy < 4; sy++) {
-                for (let sx = 0; sx < 2; sx++) {
-                    const px = x * 2 + sx;
-                    const py = y * 4 + sy;
-                    const result = shader({
-                        u: px / (subW - 1 || 1),
-                        v: py / (subH - 1 || 1),
-                        time,
-                        uniforms
-                    });
-                    const cell = typeof result === 'string' ? { char: result } : result;
-                    accumulateCellStyle(styleAccumulator, cell);
-                    if (cell.char !== ' ') {
-                        code |= DOT_MAP[sy][sx];
-                        if (!firstStyledCell)
-                            firstStyledCell = cell;
-                    }
-                }
-            }
-            setCellFast(surface, packed, x, y, {
-                ...(firstStyledCell || { char: ' ' }),
-                ...averagedCellStyle(styleAccumulator),
-                char: String.fromCharCode(0x2800 + code)
-            });
-        }
-    }
-}
-function renderGlyphResolution(surface, shader, time, uniforms, glyphFit) {
-    const { width, height } = surface;
-    const packed = isPackedSurface(surface);
-    const subW = width * 2;
-    const subH = height * 4;
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            let firstStyledCell = null;
-            const coverage = [];
-            const styleAccumulator = createStyleAccumulator();
-            for (let sy = 0; sy < 4; sy++) {
-                for (let sx = 0; sx < 2; sx++) {
-                    const px = x * 2 + sx;
-                    const py = y * 4 + sy;
-                    const result = shader({
-                        u: px / (subW - 1 || 1),
-                        v: py / (subH - 1 || 1),
-                        time,
-                        uniforms
-                    });
-                    const cell = typeof result === 'string' ? { char: result } : result;
-                    coverage.push(cellCoverage(cell));
-                    accumulateCellStyle(styleAccumulator, cell);
-                    if (cell.char !== ' ' && !firstStyledCell) {
-                        firstStyledCell = cell;
-                    }
-                }
-            }
-            setCellFast(surface, packed, x, y, {
-                ...(firstStyledCell || { char: ' ' }),
-                ...averagedCellStyle(styleAccumulator),
-                char: fitCellGlyph(coverage, glyphFit)
-            });
-        }
-    }
-}
-function cellCoverage(cell) {
-    if (cell.coverage !== undefined)
-        return clampCoverage(cell.coverage);
-    return cell.char === ' ' ? 0 : 1;
-}
-function clampCoverage(value) {
-    if (!Number.isFinite(value) || value <= 0)
-        return 0;
-    if (value >= 1)
-        return 1;
-    return value;
-}
+export { canvas } from './canvas.part03.js';
 //# sourceMappingURL=canvas.js.map

package/dist/canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../src/canvas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../src/canvas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/canvas.part01.d.ts

@@ -0,0 +1,45 @@
+import type { Cell } from '@flyingrobots/bijou';
+import type { CellGlyphFitOptions } from './cell-glyph-fit.js';
+type RGB = readonly [number, number, number];
+interface ColorAccumulator {
+    r: number;
+    g: number;
+    b: number;
+    count: number;
+}
+interface StyleAccumulator {
+    fg: ColorAccumulator;
+    bg: ColorAccumulator;
+}
+declare function resolveCellColor(rgb: RGB | undefined, ref: Cell['fg']): RGB | undefined;
+declare function createStyleAccumulator(): StyleAccumulator;
+declare function accumulateCellStyle(accumulator: StyleAccumulator, cell: Cell): void;
+declare function averagedCellStyle(accumulator: StyleAccumulator): Pick<Cell, 'fgRGB' | 'bgRGB'>;
+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 { accumulateCellStyle, averagedCellStyle, createStyleAccumulator, resolveCellColor };
+//# sourceMappingURL=canvas.part01.d.ts.map

package/dist/canvas.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.part01.d.ts","sourceRoot":"","sources":["../src/canvas.part01.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,KAAK,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C,UAAU,gBAAgB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,gBAAgB,CAAC;IACrB,EAAE,EAAE,gBAAgB,CAAC;CACtB;AA8BD,iBAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAK,GAAG,GAAG,SAAS,CAQlF;AAMD,iBAAS,sBAAsB,IAAI,gBAAgB,CAKlD;AAcD,iBAAS,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAG5E;AAWD,iBAAS,iBAAiB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAOvF;AAED,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,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAC"}