@flyingrobots/bijou-tui 7.0.0 → 7.2.0

package/dist/focus-area.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-area.d.ts","sourceRoot":"","sources":["../src/focus-area.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"focus-area.d.ts","sourceRoot":"","sources":["../src/focus-area.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClH,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9P,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/focus-area.js

@@ -1,426 +1,6 @@
-/**
- * Focus area building block — a scrollable pane with a colored left gutter.
- *
- * Wraps `viewport()` and prepends a styled gutter character (`▎`) to each
- * line indicating focus state: shell focus chrome when focused, muted when
- * unfocused.
- *
- * Follows the building block pattern: immutable state + pure transformers +
- * pure render + convenience keymap factory.
- *
- * ```ts
- * // In TEA init:
- * const fa = createFocusAreaState({ content, width: 60, height: 20 });
- *
- * // In TEA view:
- * const output = focusArea(fa, { focused: true, ctx });
- *
- * // In TEA update:
- * case 'scroll-down':
- *   return [{ ...model, fa: focusAreaScrollBy(model.fa, 1) }, []];
- * ```
- */
-import { createSurface, parseAnsiToSurface, renderByMode } from '@flyingrobots/bijou';
-import { resolveBCSSTextToken } from './css/text-style.js';
-import { viewport, createScrollState, scrollBy, scrollTo, scrollToTop, scrollToBottom, pageDown, pageUp, scrollByX, scrollToX, } from './viewport.js';
-import { createKeyMap } from './keybindings.js';
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Gutter character: left one quarter block (U+258E). */
-const GUTTER_CHAR = '▎';
-const EMPTY_CELL = { char: ' ', empty: false };
-const SCROLLBAR_TRACK_CELL = { char: '│', empty: false };
-const SCROLLBAR_THUMB_CELL = { char: '█', empty: false };
-const gutterCellCache = new Map();
-const scrollbarCellCache = new Map();
-// ---------------------------------------------------------------------------
-// State creation
-// ---------------------------------------------------------------------------
-/**
- * Create initial focus area state for the given content and dimensions.
- *
- * The viewport width is `width - 1` to account for the gutter column.
- * When `overflowX` is `'scroll'`, horizontal scroll bounds are computed
- * from the widest content line.
- *
- * @param options - Content, width, height, and overflow for the focus area.
- * @returns Fresh focus area state with scroll at the top-left.
- */
-export function createFocusAreaState(options) {
-    const { content, overflowX = 'hidden', scrollbarMode = 'gutter' } = options;
-    // Clamp dimensions to at least 1
-    const width = Math.max(1, options.width);
-    const height = Math.max(1, options.height);
-    return {
-        content,
-        scroll: createScrollState(content, height, resolveFocusAreaViewportWidth(content.split('\n').length, width, height, overflowX, scrollbarMode)),
-        width,
-        height,
-        overflowX,
-        scrollbarMode,
-    };
-}
-/**
- * Create focus area state for already-rendered surface content.
- *
- * Uses the surface dimensions directly to compute scroll bounds so callers can
- * keep pane rendering surface-native without string round-tripping.
- */
-export function createFocusAreaStateForSurface(surface, options) {
-    const { overflowX = 'hidden', scrollbarMode = 'gutter' } = options;
-    const width = Math.max(1, options.width);
-    const height = Math.max(1, options.height);
-    const viewportWidth = resolveFocusAreaViewportWidth(surface.height, width, height, overflowX, scrollbarMode);
-    const maxX = viewportWidth === undefined ? 0 : Math.max(0, surface.width - viewportWidth);
-    return {
-        content: '',
-        scroll: {
-            y: 0,
-            maxY: Math.max(0, surface.height - height),
-            x: 0,
-            maxX,
-            totalLines: surface.height,
-            visibleLines: height,
-        },
-        width,
-        height,
-        overflowX,
-        scrollbarMode,
-    };
-}
-// ---------------------------------------------------------------------------
-// State transformers
-// ---------------------------------------------------------------------------
-/**
- * Scroll vertically by a relative amount.
- *
- * @param state - Current focus area state.
- * @param dy - Relative vertical offset (positive = down).
- * @returns Updated state with new scroll position.
- */
-export function focusAreaScrollBy(state, dy) {
-    return { ...state, scroll: scrollBy(state.scroll, dy) };
-}
-/**
- * Scroll vertically to an absolute position.
- *
- * @param state - Current focus area state.
- * @param y - Absolute vertical offset (0-based).
- * @returns Updated state with new scroll position.
- */
-export function focusAreaScrollTo(state, y) {
-    return { ...state, scroll: scrollTo(state.scroll, y) };
-}
-/**
- * Scroll to the first line.
- *
- * @param state - Current focus area state.
- * @returns Updated state scrolled to the top.
- */
-export function focusAreaScrollToTop(state) {
-    return { ...state, scroll: scrollToTop(state.scroll) };
-}
-/**
- * Scroll to the last line.
- *
- * @param state - Current focus area state.
- * @returns Updated state scrolled to the bottom.
- */
-export function focusAreaScrollToBottom(state) {
-    return { ...state, scroll: scrollToBottom(state.scroll) };
-}
-/**
- * Page down (one viewport height).
- *
- * @param state - Current focus area state.
- * @returns Updated state advanced by one page.
- */
-export function focusAreaPageDown(state) {
-    return { ...state, scroll: pageDown(state.scroll) };
-}
-/**
- * Page up (one viewport height).
- *
- * @param state - Current focus area state.
- * @returns Updated state moved back by one page.
- */
-export function focusAreaPageUp(state) {
-    return { ...state, scroll: pageUp(state.scroll) };
-}
-/**
- * Scroll horizontally by a relative amount.
- * No-op when `overflowX` is `'hidden'`.
- *
- * @param state - Current focus area state.
- * @param dx - Relative horizontal offset (positive = right).
- * @returns Updated state with new horizontal scroll position.
- */
-export function focusAreaScrollByX(state, dx) {
-    if (state.overflowX === 'hidden')
-        return state;
-    return { ...state, scroll: scrollByX(state.scroll, dx) };
-}
-/**
- * Scroll horizontally to an absolute position.
- * No-op when `overflowX` is `'hidden'`.
- *
- * @param state - Current focus area state.
- * @param x - Absolute horizontal offset (0-based).
- * @returns Updated state with new horizontal scroll position.
- */
-export function focusAreaScrollToX(state, x) {
-    if (state.overflowX === 'hidden')
-        return state;
-    return { ...state, scroll: scrollToX(state.scroll, x) };
-}
-/**
- * Update content while preserving scroll position (clamped).
- *
- * @param state - Current focus area state.
- * @param content - New text content to display.
- * @returns Updated state with new content and clamped scroll position.
- */
-export function focusAreaSetContent(state, content) {
-    const totalLines = content.split('\n').length;
-    const viewportWidth = resolveFocusAreaViewportWidth(totalLines, state.width, state.height, state.overflowX, state.scrollbarMode);
-    const newScroll = createScrollState(content, state.height, viewportWidth);
-    const clampedY = Math.min(state.scroll.y, newScroll.maxY);
-    const clampedX = Math.min(state.scroll.x, newScroll.maxX);
-    return {
-        ...state,
-        content,
-        scroll: { ...newScroll, y: clampedY, x: clampedX },
-    };
-}
-// ---------------------------------------------------------------------------
-// Render
-// ---------------------------------------------------------------------------
-/**
- * Render the focus area — viewport content with a colored left gutter.
- *
- * The gutter character (`▎`) is styled based on focus state:
- * - Focused: `focusedGutterToken` (default: `theme.ui.focusGutter`)
- * - Unfocused: `unfocusedGutterToken` (default: `theme.semantic.muted`)
- * - Static mode: unstyled gutter
- * - Pipe / accessible mode: no gutter (full width to content)
- *
- * @param state - Current focus area state.
- * @param options - Rendering options (focus, tokens, scrollbar, ctx).
- * @returns Rendered focus area string.
- */
-export function focusArea(state, options) {
-    const focused = options?.focused ?? true;
-    const showScrollbar = options?.showScrollbar ?? true;
-    const ctx = options?.ctx;
-    const mode = ctx?.mode ?? 'interactive';
-    // Pipe and accessible modes: no gutter, full width to content
-    const hasGutter = mode !== 'pipe' && mode !== 'accessible';
-    const contentWidth = hasGutter ? Math.max(1, state.width - 1) : state.width;
-    // Clamp scrollX to render-time content width (may differ from state-time
-    // width when pipe/accessible mode removes the gutter)
-    let scrollX;
-    if (state.overflowX === 'scroll') {
-        const maxRenderX = Math.max(0, state.scroll.maxX + (contentWidth < state.width ? 0 : 1));
-        scrollX = Math.min(state.scroll.x, maxRenderX);
-    }
-    const body = viewport({
-        width: contentWidth,
-        height: state.height,
-        content: state.content,
-        scrollY: state.scroll.y,
-        scrollX,
-        showScrollbar,
-        scrollbarMode: state.scrollbarMode,
-    });
-    if (!hasGutter)
-        return body;
-    // Determine gutter string
-    const gutter = resolveGutter(focused, ctx, options);
-    // Prepend gutter to each line
-    const lines = body.split('\n');
-    return lines.map((line) => gutter + line).join('\n');
-}
-/**
- * Render the focus area into a surface without converting the pane body back
- * into a string first.
- */
-export function focusAreaSurface(content, state, options) {
-    const surface = createSurface(state.width, state.height, EMPTY_CELL);
-    return focusAreaSurfaceInto(content, state, surface, options);
-}
-/**
- * Paint the focus area into an existing target surface.
- *
- * The caller owns clearing the destination region beforehand when reusing the
- * same target across frames.
- */
-export function focusAreaSurfaceInto(content, state, target, options, offsetX = 0, offsetY = 0) {
-    const focused = options?.focused ?? true;
-    const showScrollbar = options?.showScrollbar ?? true;
-    const ctx = options?.ctx;
-    const mode = ctx?.mode ?? 'interactive';
-    const hasGutter = mode !== 'pipe' && mode !== 'accessible' && state.width > 1;
-    const gutterWidth = hasGutter ? 1 : 0;
-    const bodyWidth = Math.max(0, state.width - gutterWidth);
-    const needsScrollbar = showScrollbar && content.height > state.height && bodyWidth > 0;
-    const contentWidth = needsScrollbar && state.scrollbarMode === 'gutter'
-        ? Math.max(0, bodyWidth - 1)
-        : bodyWidth;
-    const scrollY = Math.max(0, Math.min(state.scroll.y, Math.max(0, content.height - state.height)));
-    const scrollX = state.overflowX === 'scroll'
-        ? Math.max(0, Math.min(state.scroll.x, Math.max(0, content.width - contentWidth)))
-        : 0;
-    if (contentWidth > 0 && state.height > 0) {
-        target.blit(content, offsetX + gutterWidth, offsetY, scrollX, scrollY, contentWidth, state.height);
-    }
-    if (needsScrollbar) {
-        const scrollbarX = offsetX + gutterWidth + bodyWidth - 1;
-        const scrollbarCells = resolveScrollbarCells(ctx, options);
-        paintScrollbarInto(target, scrollbarX, offsetY, state.height, content.height, scrollY, scrollbarCells.track, scrollbarCells.thumb);
-    }
-    if (hasGutter) {
-        const gutterCell = resolveGutterCell(focused, ctx, options);
-        for (let y = 0; y < state.height; y++) {
-            paintCellPreservingBackground(target, offsetX, offsetY + y, gutterCell);
-        }
-    }
-    return target;
-}
-function paintCellPreservingBackground(target, x, y, cell) {
-    const existing = target.get(x, y);
-    const hasExplicitBackground = cell.bg != null || cell.bgRGB != null;
-    target.set(x, y, {
-        char: cell.char,
-        fg: cell.fg,
-        bg: hasExplicitBackground ? cell.bg : existing.bg,
-        fgRGB: cell.fgRGB,
-        bgRGB: hasExplicitBackground ? cell.bgRGB : existing.bgRGB,
-        modifiers: cell.modifiers,
-        opacity: hasExplicitBackground ? cell.opacity : (cell.opacity ?? existing.opacity),
-        empty: false,
-    });
-}
-/**
- * Resolve the styled gutter string based on focus state and context.
- */
-function resolveGutter(focused, ctx, options) {
-    if (!ctx)
-        return GUTTER_CHAR;
-    return renderByMode(ctx.mode, {
-        static: () => GUTTER_CHAR,
-        interactive: () => {
-            const baseToken = focused
-                ? (options?.focusedGutterToken ?? ctx.ui('focusGutter'))
-                : (options?.unfocusedGutterToken ?? ctx.semantic('muted'));
-            const token = resolveBCSSTextToken(ctx, {
-                type: 'FocusArea',
-                id: options?.id,
-                classes: [...(options?.classes ?? []), focused ? 'focused' : 'unfocused'],
-            }, {
-                hex: baseToken.hex,
-                bg: baseToken.bg,
-                modifiers: baseToken.modifiers,
-            });
-            return ctx.style.styled(token, GUTTER_CHAR);
-        },
-    }, options);
-}
-function resolveGutterCell(focused, ctx, options) {
-    const key = resolveGutter(focused, ctx, options);
-    const cached = gutterCellCache.get(key);
-    if (cached != null)
-        return cached;
-    const parsed = parseAnsiToSurface(key, 1, 1).get(0, 0);
-    gutterCellCache.set(key, parsed);
-    return parsed;
-}
-function resolveScrollbarCells(ctx, options) {
-    return {
-        track: resolveScrollbarCell('track', ctx, options),
-        thumb: resolveScrollbarCell('thumb', ctx, options),
-    };
-}
-function resolveScrollbarCell(kind, ctx, options) {
-    if (!ctx) {
-        return kind === 'thumb' ? SCROLLBAR_THUMB_CELL : SCROLLBAR_TRACK_CELL;
-    }
-    const baseToken = kind === 'thumb'
-        ? (options?.scrollbarThumbToken ?? ctx.ui('scrollThumb'))
-        : (options?.scrollbarTrackToken ?? ctx.ui('scrollTrack'));
-    const baseChar = kind === 'thumb' ? SCROLLBAR_THUMB_CELL.char : SCROLLBAR_TRACK_CELL.char;
-    const key = `${kind}:${baseChar}:${JSON.stringify(baseToken)}:${options?.id ?? ''}:${(options?.classes ?? []).join(',')}`;
-    const cached = scrollbarCellCache.get(key);
-    if (cached != null)
-        return cached;
-    const token = resolveBCSSTextToken(ctx, {
-        type: kind === 'thumb' ? 'FocusAreaScrollbarThumb' : 'FocusAreaScrollbarTrack',
-        id: options?.id,
-        classes: [...(options?.classes ?? []), 'scrollbar', `scrollbar-${kind}`],
-    }, {
-        hex: baseToken.hex,
-        bg: baseToken.bg,
-        modifiers: baseToken.modifiers,
-    });
-    const parsed = parseAnsiToSurface(ctx.style.styled(token, baseChar), 1, 1).get(0, 0);
-    scrollbarCellCache.set(key, parsed);
-    return parsed;
-}
-function paintScrollbarInto(target, column, row, viewportHeight, totalLines, scrollY, trackCell, thumbCell) {
-    if (totalLines <= viewportHeight) {
-        for (let y = 0; y < viewportHeight; y++) {
-            paintCellPreservingBackground(target, column, row + y, EMPTY_CELL);
-        }
-        return;
-    }
-    const thumbSize = Math.max(1, Math.round((viewportHeight / totalLines) * viewportHeight));
-    const maxScroll = totalLines - viewportHeight;
-    const scrollFraction = maxScroll > 0 ? scrollY / maxScroll : 0;
-    const thumbStart = Math.round(scrollFraction * (viewportHeight - thumbSize));
-    for (let index = 0; index < viewportHeight; index++) {
-        const isThumb = index >= thumbStart && index < thumbStart + thumbSize;
-        paintCellPreservingBackground(target, column, row + index, isThumb ? thumbCell : trackCell);
-    }
-}
-function resolveFocusAreaViewportWidth(totalLines, width, height, overflowX, scrollbarMode) {
-    const gutterWidth = width > 1 ? 1 : 0;
-    const contentWidth = Math.max(1, width - gutterWidth);
-    const hasScrollbar = totalLines > height && contentWidth > 1;
-    const scrollableWidth = hasScrollbar && scrollbarMode === 'gutter'
-        ? Math.max(1, contentWidth - 1)
-        : contentWidth;
-    return overflowX === 'scroll' ? scrollableWidth : undefined;
-}
-// ---------------------------------------------------------------------------
-// Convenience keymap
-// ---------------------------------------------------------------------------
-/**
- * Create a preconfigured KeyMap for focus area navigation.
- *
- * Arrow keys are intentionally excluded — reserved for content-specific
- * navigation (e.g., DAG node selection).
- *
- * @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 scroll bindings.
- */
-export function focusAreaKeyMap(actions) {
-    const km = createKeyMap()
-        .group('Scroll', (g) => {
-        g.bind('j', 'Down', actions.scrollDown)
-            .bind('k', 'Up', actions.scrollUp)
-            .bind('d', 'Page down', actions.pageDown)
-            .bind('u', 'Page up', actions.pageUp)
-            .bind('g', 'Top', actions.top)
-            .bind('shift+g', 'Bottom', actions.bottom);
-        if (actions.scrollLeft !== undefined) {
-            g.bind('h', 'Scroll left', actions.scrollLeft);
-        }
-        if (actions.scrollRight !== undefined) {
-            g.bind('l', 'Scroll right', actions.scrollRight);
-        }
-        return g;
-    });
-    return km;
-}
+export { createFocusAreaState } from './focus-area.part01.js';
+export { createFocusAreaStateForSurface, focusAreaPageDown, focusAreaPageUp, focusAreaScrollBy, focusAreaScrollByX, focusAreaScrollTo, focusAreaScrollToBottom, focusAreaScrollToTop, focusAreaScrollToX, focusAreaSetContent } from './focus-area.part02.js';
+export { focusArea, focusAreaSurface } from './focus-area.part03.js';
+export { focusAreaSurfaceInto } from './focus-area.part04.js';
+export { focusAreaKeyMap } from './focus-area.part06.js';
 //# sourceMappingURL=focus-area.js.map

package/dist/focus-area.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-area.js","sourceRoot":"","sources":["../src/focus-area.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"focus-area.js","sourceRoot":"","sources":["../src/focus-area.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC9P,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/focus-area.part01.d.ts

@@ -0,0 +1,57 @@
+import type { BijouContext, Cell, TokenValue } from '@flyingrobots/bijou';
+import type { ScrollState, ScrollbarMode } from './viewport.js';
+export type OverflowX = 'scroll' | 'hidden';
+export interface FocusAreaState {
+    /** Full text content displayed in the focus area. */
+    readonly content: string;
+    /** Underlying scroll position state. */
+    readonly scroll: ScrollState;
+    /** Total width in columns (including gutter). */
+    readonly width: number;
+    /** Total height in rows. */
+    readonly height: number;
+    /** Horizontal overflow behavior. */
+    readonly overflowX: OverflowX;
+    /** Scrollbar ownership model for the pane edge. */
+    readonly scrollbarMode: ScrollbarMode;
+}
+export interface FocusAreaOptions {
+    /** Full text content to display. */
+    readonly content: string;
+    /** Total width in columns (including gutter). */
+    readonly width: number;
+    /** Total height in rows. */
+    readonly height: number;
+    /** Horizontal overflow behavior. Default: `'hidden'`. */
+    readonly overflowX?: OverflowX;
+    /** Reserve a gutter column or overlay the rightmost content cell. Default: `'gutter'`. */
+    readonly scrollbarMode?: ScrollbarMode;
+}
+export interface FocusAreaRenderOptions {
+    /** Whether the pane is currently focused. Default: `true`. */
+    readonly focused?: boolean;
+    /** Token for the focused gutter. Default: `theme.ui.focusGutter`. */
+    readonly focusedGutterToken?: TokenValue;
+    /** Token for the unfocused gutter. Default: `theme.semantic.muted`. */
+    readonly unfocusedGutterToken?: TokenValue;
+    /** Show a scrollbar track on the right edge. Default: `true`. */
+    readonly showScrollbar?: boolean;
+    /** Token for the scrollbar track. Default: `theme.ui.scrollTrack`. */
+    readonly scrollbarTrackToken?: TokenValue;
+    /** Token for the scrollbar thumb. Default: `theme.ui.scrollThumb`. */
+    readonly scrollbarThumbToken?: TokenValue;
+    /** Optional BCSS id for the focus area. */
+    readonly id?: string;
+    /** Optional BCSS classes for the focus area. */
+    readonly classes?: readonly string[];
+    /** Bijou context for styling and mode detection. */
+    readonly ctx?: BijouContext;
+}
+export declare const GUTTER_CHAR = "\u258E";
+export declare const EMPTY_CELL: Cell;
+export declare const SCROLLBAR_TRACK_CELL: Cell;
+export declare const SCROLLBAR_THUMB_CELL: Cell;
+export declare const gutterCellCache: Map<string, Cell>;
+export declare const scrollbarCellCache: Map<string, Cell>;
+export declare function createFocusAreaState(options: FocusAreaOptions): FocusAreaState;
+//# sourceMappingURL=focus-area.part01.d.ts.map

package/dist/focus-area.part01.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-area.part01.d.ts","sourceRoot":"","sources":["../src/focus-area.part01.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI1E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGhE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC5C,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AACD,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AACD,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,UAAU,CAAC;IAC3C,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC;IAC1C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B;AACD,eAAO,MAAM,WAAW,WAAM,CAAC;AAC/B,eAAO,MAAM,UAAU,EAAE,IAAkC,CAAC;AAC5D,eAAO,MAAM,oBAAoB,EAAE,IAAkC,CAAC;AACtE,eAAO,MAAM,oBAAoB,EAAE,IAAkC,CAAC;AACtE,eAAO,MAAM,eAAe,mBAA0B,CAAC;AACvD,eAAO,MAAM,kBAAkB,mBAA0B,CAAC;AAC1D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAiB9E"}

package/dist/focus-area.part01.js

@@ -0,0 +1,23 @@
+import { createScrollState } from './viewport.js';
+import { resolveFocusAreaViewportWidth } from './focus-area.part06.js';
+export const GUTTER_CHAR = '▎';
+export const EMPTY_CELL = { char: ' ', empty: false };
+export const SCROLLBAR_TRACK_CELL = { char: '│', empty: false };
+export const SCROLLBAR_THUMB_CELL = { char: '█', empty: false };
+export const gutterCellCache = new Map();
+export const scrollbarCellCache = new Map();
+export function createFocusAreaState(options) {
+    const { content, overflowX = 'hidden', scrollbarMode = 'gutter' } = options;
+    // Clamp dimensions to at least 1
+    const width = Math.max(1, options.width);
+    const height = Math.max(1, options.height);
+    return {
+        content,
+        scroll: createScrollState(content, height, resolveFocusAreaViewportWidth(content.split('\n').length, width, height, overflowX, scrollbarMode)),
+        width,
+        height,
+        overflowX,
+        scrollbarMode,
+    };
+}
+//# sourceMappingURL=focus-area.part01.js.map

package/dist/focus-area.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-area.part01.js","sourceRoot":"","sources":["../src/focus-area.part01.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIlD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAgDvE,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAgB,CAAC;AAC1D,MAAM,UAAU,oBAAoB,CAAC,OAAyB;IAC5D,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,QAAQ,EAAE,aAAa,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC5E,iCAAiC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO;QACP,MAAM,EAAE,iBAAiB,CACvB,OAAO,EACP,MAAM,EACN,6BAA6B,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CACnG;QACD,KAAK;QACL,MAAM;QACN,SAAS;QACT,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/focus-area.part02.d.ts

@@ -0,0 +1,13 @@
+import type { Surface } from '@flyingrobots/bijou';
+import type { FocusAreaOptions, FocusAreaState } from './focus-area.part01.js';
+export declare function createFocusAreaStateForSurface(surface: Surface, options: Omit<FocusAreaOptions, 'content'>): FocusAreaState;
+export declare function focusAreaScrollBy(state: FocusAreaState, dy: number): FocusAreaState;
+export declare function focusAreaScrollTo(state: FocusAreaState, y: number): FocusAreaState;
+export declare function focusAreaScrollToTop(state: FocusAreaState): FocusAreaState;
+export declare function focusAreaScrollToBottom(state: FocusAreaState): FocusAreaState;
+export declare function focusAreaPageDown(state: FocusAreaState): FocusAreaState;
+export declare function focusAreaPageUp(state: FocusAreaState): FocusAreaState;
+export declare function focusAreaScrollByX(state: FocusAreaState, dx: number): FocusAreaState;
+export declare function focusAreaScrollToX(state: FocusAreaState, x: number): FocusAreaState;
+export declare function focusAreaSetContent(state: FocusAreaState, content: string): FocusAreaState;
+//# sourceMappingURL=focus-area.part02.d.ts.map

package/dist/focus-area.part02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-area.part02.d.ts","sourceRoot":"","sources":["../src/focus-area.part02.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG/E,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACzC,cAAc,CAqBhB;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAEnF;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,GAAG,cAAc,CAElF;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAE1E;AACD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAE7E;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAEvE;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAErE;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAGpF;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,GAAG,cAAc,CAGnF;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAiB1F"}

package/dist/focus-area.part02.js

@@ -0,0 +1,65 @@
+import { createScrollState, pageDown, pageUp, scrollBy, scrollByX, scrollTo, scrollToBottom, scrollToTop, scrollToX } from './viewport.js';
+import { resolveFocusAreaViewportWidth } from './focus-area.part06.js';
+export function createFocusAreaStateForSurface(surface, options) {
+    const { overflowX = 'hidden', scrollbarMode = 'gutter' } = options;
+    const width = Math.max(1, options.width);
+    const height = Math.max(1, options.height);
+    const viewportWidth = resolveFocusAreaViewportWidth(surface.height, width, height, overflowX, scrollbarMode);
+    const maxX = viewportWidth === undefined ? 0 : Math.max(0, surface.width - viewportWidth);
+    return {
+        content: '',
+        scroll: {
+            y: 0,
+            maxY: Math.max(0, surface.height - height),
+            x: 0,
+            maxX,
+            totalLines: surface.height,
+            visibleLines: height,
+        },
+        width,
+        height,
+        overflowX,
+        scrollbarMode,
+    };
+}
+export function focusAreaScrollBy(state, dy) {
+    return { ...state, scroll: scrollBy(state.scroll, dy) };
+}
+export function focusAreaScrollTo(state, y) {
+    return { ...state, scroll: scrollTo(state.scroll, y) };
+}
+export function focusAreaScrollToTop(state) {
+    return { ...state, scroll: scrollToTop(state.scroll) };
+}
+export function focusAreaScrollToBottom(state) {
+    return { ...state, scroll: scrollToBottom(state.scroll) };
+}
+export function focusAreaPageDown(state) {
+    return { ...state, scroll: pageDown(state.scroll) };
+}
+export function focusAreaPageUp(state) {
+    return { ...state, scroll: pageUp(state.scroll) };
+}
+export function focusAreaScrollByX(state, dx) {
+    if (state.overflowX === 'hidden')
+        return state;
+    return { ...state, scroll: scrollByX(state.scroll, dx) };
+}
+export function focusAreaScrollToX(state, x) {
+    if (state.overflowX === 'hidden')
+        return state;
+    return { ...state, scroll: scrollToX(state.scroll, x) };
+}
+export function focusAreaSetContent(state, content) {
+    const totalLines = content.split('\n').length;
+    const viewportWidth = resolveFocusAreaViewportWidth(totalLines, state.width, state.height, state.overflowX, state.scrollbarMode);
+    const newScroll = createScrollState(content, state.height, viewportWidth);
+    const clampedY = Math.min(state.scroll.y, newScroll.maxY);
+    const clampedX = Math.min(state.scroll.x, newScroll.maxX);
+    return {
+        ...state,
+        content,
+        scroll: { ...newScroll, y: clampedY, x: clampedX },
+    };
+}
+//# sourceMappingURL=focus-area.part02.js.map

package/dist/focus-area.part02.js.map

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