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

package/dist/overlay.part06.d.ts

@@ -0,0 +1,46 @@
+import type { BijouContext, TokenValue } from '@flyingrobots/bijou';
+import type { LayoutRect } from './layout-rect.js';
+import type { Overlay, OverlayContent, ToastOptions } from './overlay.part01.js';
+export declare function toast(options: ToastOptions): Overlay;
+export type DrawerAnchor = 'left' | 'right' | 'top' | 'bottom';
+export interface DrawerBaseOptions {
+    /** Content to display inside the drawer. Accepts plain text or a structured surface. */
+    readonly content: OverlayContent;
+    /** Screen width in columns, used for positioning. */
+    readonly screenWidth: number;
+    /** Screen height in rows, used for sizing. */
+    readonly screenHeight: number;
+    /** Optional region rectangle to attach inside, instead of full screen. */
+    readonly region?: LayoutRect;
+    /** Optional title displayed in the top border. */
+    readonly title?: string;
+    /** Design token for the border color. */
+    readonly borderToken?: TokenValue;
+    /** Background fill token for the drawer interior. */
+    readonly bgToken?: TokenValue;
+    /** Bijou context for styled output. */
+    readonly ctx?: BijouContext;
+}
+export interface DrawerDefaultOptions extends DrawerBaseOptions {
+    /** Side of the screen/region to anchor the drawer. Default: 'right'. */
+    readonly anchor?: undefined;
+    /** Total drawer width including borders and padding. */
+    readonly width: number;
+    readonly height?: never;
+}
+export interface DrawerHorizontalOptions extends DrawerBaseOptions {
+    /** Side of the screen/region to anchor the drawer. */
+    readonly anchor: 'left' | 'right';
+    /** Total drawer width including borders and padding. */
+    readonly width: number;
+    readonly height?: never;
+}
+export interface DrawerVerticalOptions extends DrawerBaseOptions {
+    /** Side of the screen/region to anchor the drawer. */
+    readonly anchor: 'top' | 'bottom';
+    /** Total drawer height including borders and padding. */
+    readonly height: number;
+    readonly width?: never;
+}
+export type DrawerOptions = DrawerDefaultOptions | DrawerHorizontalOptions | DrawerVerticalOptions;
+//# sourceMappingURL=overlay.part06.d.ts.map

package/dist/overlay.part06.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.part06.d.ts","sourceRoot":"","sources":["../src/overlay.part06.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOjF,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CA8CpD;AACD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC/D,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B;AACD,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CACzB;AACD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CACzB;AACD,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AACD,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,uBAAuB,GAAG,qBAAqB,CAAC"}

package/dist/overlay.part06.js

@@ -0,0 +1,35 @@
+import { resolveOverlayMargin } from './design-language.js';
+import { backgroundStyleFromToken, overlayContentFromSurface, styleFromToken } from './overlay.part03.js';
+import { lineSurface } from './overlay.part04.js';
+import { TOAST_BORDER, TOAST_ICONS, renderBoxSurface } from './overlay.part05.js';
+export function toast(options) {
+    const { message, variant = 'info', anchor = 'bottom-right', screenWidth, screenHeight, margin, ctx, } = options;
+    const resolvedMargin = resolveOverlayMargin(screenWidth, screenHeight, margin);
+    const icon = TOAST_ICONS[variant];
+    const line = lineSurface(`${icon} ${message}`, styleFromToken(ctx?.semantic(variant), ctx));
+    const surface = renderBoxSurface([line], styleFromToken(ctx?.border(TOAST_BORDER[variant]), ctx), backgroundStyleFromToken(options.bgToken, ctx));
+    let row;
+    let col;
+    switch (anchor) {
+        case 'top-right':
+            row = resolvedMargin;
+            col = screenWidth - surface.width - resolvedMargin;
+            break;
+        case 'bottom-right':
+            row = screenHeight - surface.height - resolvedMargin;
+            col = screenWidth - surface.width - resolvedMargin;
+            break;
+        case 'bottom-left':
+            row = screenHeight - surface.height - resolvedMargin;
+            col = resolvedMargin;
+            break;
+        case 'top-left':
+            row = resolvedMargin;
+            col = resolvedMargin;
+            break;
+    }
+    row = Math.max(0, row);
+    col = Math.max(0, col);
+    return { content: overlayContentFromSurface(surface, ctx), surface, row, col };
+}
+//# sourceMappingURL=overlay.part06.js.map

package/dist/overlay.part06.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.part06.js","sourceRoot":"","sources":["../src/overlay.part06.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1G,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,MAAM,EACJ,OAAO,EACP,OAAO,GAAG,MAAM,EAChB,MAAM,GAAG,cAAc,EACvB,WAAW,EACX,YAAY,EACZ,MAAM,EACN,GAAG,GACJ,GAAG,OAAO,CAAC;IACZ,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAE/E,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,EAAE,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,gBAAgB,CAC9B,CAAC,IAAI,CAAC,EACN,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,EACvD,wBAAwB,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAC/C,CAAC;IAEF,IAAI,GAAW,CAAC;IAChB,IAAI,GAAW,CAAC;IAEhB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW;YACd,GAAG,GAAG,cAAc,CAAC;YACrB,GAAG,GAAG,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;YACnD,MAAM;QACR,KAAK,cAAc;YACjB,GAAG,GAAG,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC;YACrD,GAAG,GAAG,WAAW,GAAG,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC;YACnD,MAAM;QACR,KAAK,aAAa;YAChB,GAAG,GAAG,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC;YACrD,GAAG,GAAG,cAAc,CAAC;YACrB,MAAM;QACR,KAAK,UAAU;YACb,GAAG,GAAG,cAAc,CAAC;YACrB,GAAG,GAAG,cAAc,CAAC;YACrB,MAAM;IACV,CAAC;IAED,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvB,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAEvB,OAAO,EAAE,OAAO,EAAE,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACjF,CAAC"}

package/dist/overlay.part07.d.ts

@@ -0,0 +1,4 @@
+import type { Overlay } from './overlay.part01.js';
+import type { DrawerOptions } from './overlay.part06.js';
+export declare function drawer(options: DrawerOptions): Overlay;
+//# sourceMappingURL=overlay.part07.d.ts.map

package/dist/overlay.part07.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.part07.d.ts","sourceRoot":"","sources":["../src/overlay.part07.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAqEtD"}

package/dist/overlay.part07.js

@@ -0,0 +1,64 @@
+import { createSurface } from '@flyingrobots/bijou';
+import { BORDER } from './overlay.part01.js';
+import { backgroundStyleFromToken, mergeStyles, overlayContentFromSurface, setStyledCell, styleFromToken, withFallbackBackground } from './overlay.part03.js';
+import { contentLines, lineSurface, lineWithInheritedBackground } from './overlay.part04.js';
+import { clampRegion, resolveDrawerDimensions } from './overlay.part08.js';
+export function drawer(options) {
+    const { content, screenWidth, screenHeight, title, ctx, } = options;
+    const region = clampRegion(options.region, screenWidth, screenHeight);
+    const dims = resolveDrawerDimensions(options, region);
+    const { width, height, row, col } = dims;
+    const innerWidth = Math.max(0, width - 4); // border + padding on each side
+    const fillStyle = backgroundStyleFromToken(options.bgToken, ctx);
+    const borderStyle = withFallbackBackground(styleFromToken(options.borderToken, ctx), fillStyle);
+    const titleStyle = ctx ? { modifiers: ['bold'] } : {};
+    const surface = createSurface(width, height);
+    if (width === 0 || height === 0) {
+        return { content: overlayContentFromSurface(surface, ctx), surface, row, col };
+    }
+    for (let x = 0; x < width; x++) {
+        const topChar = x === 0 ? BORDER.tl : x === width - 1 ? BORDER.tr : BORDER.h;
+        setStyledCell(surface, x, 0, topChar, borderStyle);
+        if (height > 1) {
+            const bottomChar = x === 0 ? BORDER.bl : x === width - 1 ? BORDER.br : BORDER.h;
+            setStyledCell(surface, x, height - 1, bottomChar, borderStyle);
+        }
+    }
+    if (title != null && width > 2) {
+        const titleLine = lineSurface(title, titleStyle);
+        const spanWidth = Math.min(width - 2, titleLine.width + 2);
+        const startX = 1 + Math.max(0, Math.floor(((width - 2) - spanWidth) / 2));
+        setStyledCell(surface, startX, 0, ' ', borderStyle);
+        const mergedTitleStyle = mergeStyles(borderStyle, titleStyle);
+        for (let x = 0; x < Math.min(titleLine.width, Math.max(0, spanWidth - 2)); x++) {
+            setStyledCell(surface, startX + 1 + x, 0, titleLine.get(x, 0).char, mergedTitleStyle);
+        }
+        if (spanWidth >= 2) {
+            setStyledCell(surface, startX + spanWidth - 1, 0, ' ', borderStyle);
+        }
+    }
+    const rows = contentLines(content, innerWidth);
+    const availableHeight = Math.max(0, height - 2);
+    for (let i = 0; i < availableHeight; i++) {
+        const y = i + 1;
+        if (width >= 1)
+            setStyledCell(surface, 0, y, BORDER.v, borderStyle);
+        for (let x = 1; x < Math.max(1, width - 1); x++) {
+            if (x < width - 1)
+                setStyledCell(surface, x, y, ' ', fillStyle);
+        }
+        if (width >= 2)
+            setStyledCell(surface, width - 1, y, BORDER.v, borderStyle);
+        const line = lineWithInheritedBackground(rows[i] ?? createSurface(0, 1), fillStyle);
+        if (line.width > 0 && innerWidth > 0 && width >= 4) {
+            surface.blit(line, 2, y, 0, 0, Math.min(line.width, innerWidth), 1);
+        }
+    }
+    return {
+        content: overlayContentFromSurface(surface, ctx),
+        surface,
+        row,
+        col,
+    };
+}
+//# sourceMappingURL=overlay.part07.js.map

package/dist/overlay.part07.js.map

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

package/dist/overlay.part08.d.ts

@@ -0,0 +1,34 @@
+import type { BijouContext, TokenValue } from '@flyingrobots/bijou';
+import type { LayoutRect } from './layout-rect.js';
+import type { OverlayContent } from './overlay.part01.js';
+import type { DrawerOptions } from './overlay.part06.js';
+export declare function resolveDrawerDimensions(options: DrawerOptions, region: LayoutRect): {
+    width: number;
+    height: number;
+    row: number;
+    col: number;
+};
+export declare function clampRegion(region: LayoutRect | undefined, screenWidth: number, screenHeight: number): LayoutRect;
+export declare function clamp(value: number, min: number, max: number): number;
+export type TooltipDirection = 'top' | 'bottom' | 'left' | 'right';
+export interface TooltipOptions {
+    /** Content to display inside the tooltip. Accepts plain text or a structured surface. */
+    readonly content: OverlayContent;
+    /** Row of the target element (0-based). */
+    readonly row: number;
+    /** Column of the target element (0-based). */
+    readonly col: number;
+    /** Direction to place the tooltip relative to the target. Default: 'top'. */
+    readonly direction?: TooltipDirection;
+    /** Screen width in columns, used for clamping. */
+    readonly screenWidth: number;
+    /** Screen height in rows, used for clamping. */
+    readonly screenHeight: number;
+    /** Design token for the border color. */
+    readonly borderToken?: TokenValue;
+    /** Background fill token for the tooltip interior. */
+    readonly bgToken?: TokenValue;
+    /** Bijou context for styled output. */
+    readonly ctx?: BijouContext;
+}
+//# sourceMappingURL=overlay.part08.d.ts.map

package/dist/overlay.part08.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.part08.d.ts","sourceRoot":"","sources":["../src/overlay.part08.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,UAAU,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA4B7D;AACD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,CAwBjH;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AACD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACnE,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B"}

package/dist/overlay.part08.js

@@ -0,0 +1,54 @@
+export function resolveDrawerDimensions(options, region) {
+    if (options.anchor === 'top' || options.anchor === 'bottom') {
+        const anchor = options.anchor;
+        const heightRaw = options.height;
+        if (!Number.isFinite(heightRaw)) {
+            throw new Error(`drawer(): "height" is required for anchor "${anchor}"`);
+        }
+        const height = clamp(Math.floor(heightRaw), 0, region.height);
+        const width = region.width;
+        const col = region.col;
+        const row = anchor === 'top'
+            ? region.row
+            : region.row + region.height - height;
+        return { width, height, row: Math.max(region.row, row), col };
+    }
+    const anchor = options.anchor ?? 'right';
+    const widthRaw = options.width;
+    if (typeof widthRaw !== 'number' || !Number.isFinite(widthRaw)) {
+        throw new Error(`drawer(): "width" is required for anchor "${anchor}"`);
+    }
+    const width = clamp(Math.floor(widthRaw), 0, region.width);
+    const height = region.height;
+    const row = region.row;
+    const col = anchor === 'left'
+        ? region.col
+        : region.col + region.width - width;
+    return { width, height, row, col: Math.max(region.col, col) };
+}
+export function clampRegion(region, screenWidth, screenHeight) {
+    const sw = Math.floor(screenWidth);
+    const sh = Math.floor(screenHeight);
+    if (region == null) {
+        return {
+            row: 0,
+            col: 0,
+            width: Math.floor(Math.max(0, sw)),
+            height: Math.floor(Math.max(0, sh)),
+        };
+    }
+    const row = Math.floor(clamp(region.row, 0, Math.max(0, sh)));
+    const col = Math.floor(clamp(region.col, 0, Math.max(0, sw)));
+    const maxWidth = Math.max(0, sw - col);
+    const maxHeight = Math.max(0, sh - row);
+    return {
+        row,
+        col,
+        width: Math.floor(clamp(region.width, 0, maxWidth)),
+        height: Math.floor(clamp(region.height, 0, maxHeight)),
+    };
+}
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=overlay.part08.js.map

package/dist/overlay.part08.js.map

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

package/dist/overlay.part09.d.ts

@@ -0,0 +1,6 @@
+import type { Surface } from '@flyingrobots/bijou';
+import type { Overlay } from './overlay.part01.js';
+import type { TooltipOptions } from './overlay.part08.js';
+export declare function tooltip(options: TooltipOptions): Overlay;
+export declare function surfaceFromContent(content: string): Surface;
+//# sourceMappingURL=overlay.part09.d.ts.map

package/dist/overlay.part09.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.part09.d.ts","sourceRoot":"","sources":["../src/overlay.part09.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAgDxD;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK3D"}

package/dist/overlay.part09.js

@@ -0,0 +1,42 @@
+import { parseAnsiToSurface } from '@flyingrobots/bijou';
+import { visibleLength } from './viewport.js';
+import { backgroundStyleFromToken, overlayContentFromSurface, styleFromToken } from './overlay.part03.js';
+import { contentLines } from './overlay.part04.js';
+import { renderBoxSurface } from './overlay.part05.js';
+export function tooltip(options) {
+    const { content, row: targetRow, col: targetCol, direction = 'top', screenWidth, screenHeight, borderToken, bgToken, ctx, } = options;
+    const maxContentWidth = Math.max(0, screenWidth - 4);
+    const lines = contentLines(content, maxContentWidth);
+    const surface = renderBoxSurface(lines, styleFromToken(borderToken, ctx), backgroundStyleFromToken(bgToken, ctx));
+    let tipRow;
+    let tipCol;
+    switch (direction) {
+        case 'top':
+            tipRow = targetRow - surface.height;
+            tipCol = targetCol - Math.floor(surface.width / 2);
+            break;
+        case 'bottom':
+            tipRow = targetRow + 1;
+            tipCol = targetCol - Math.floor(surface.width / 2);
+            break;
+        case 'left':
+            tipRow = targetRow - Math.floor(surface.height / 2);
+            tipCol = targetCol - surface.width;
+            break;
+        case 'right':
+            tipRow = targetRow - Math.floor(surface.height / 2);
+            tipCol = targetCol + 1;
+            break;
+    }
+    // Clamp to screen bounds
+    tipRow = Math.max(0, Math.min(tipRow, screenHeight - surface.height));
+    tipCol = Math.max(0, Math.min(tipCol, screenWidth - surface.width));
+    return { content: overlayContentFromSurface(surface, ctx), surface, row: tipRow, col: tipCol };
+}
+export function surfaceFromContent(content) {
+    const lines = content.split('\n');
+    const width = Math.max(1, ...lines.map((line) => visibleLength(line)));
+    const height = Math.max(1, lines.length);
+    return parseAnsiToSurface(content, width, height);
+}
+//# sourceMappingURL=overlay.part09.js.map

package/dist/overlay.part09.js.map

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

package/dist/pager.d.ts

@@ -1,165 +1,5 @@
-/**
- * Pager building block — a scrollable text viewer with status line.
- *
- * Wraps `viewport()` with a "Line N/M" status indicator and provides
- * a convenience keymap for vim-style scroll navigation.
- *
- * ```ts
- * // In TEA init:
- * const pagerState = createPagerState({ content, width: 80, height: 20 });
- *
- * // In TEA view:
- * const output = pager(model.pagerState);
- *
- * // In TEA update:
- * case 'scroll-down':
- *   return [{ ...model, pagerState: pagerScrollBy(model.pagerState, 1) }, []];
- * ```
- */
-import { type Surface } from '@flyingrobots/bijou';
-import { type ScrollbarMode, type ScrollState } from './viewport.js';
-import { type KeyMap } from './keybindings.js';
-/** Immutable state for the pager widget. */
-export interface PagerState {
-    /** Underlying scroll position state. */
-    readonly scroll: ScrollState;
-    /** Full text content displayed in the pager. */
-    readonly content: string;
-    /** Available width in columns. */
-    readonly width: number;
-    /** Total available height in rows (including status line). */
-    readonly height: number;
-}
-/** Options for creating a new pager state. */
-export interface PagerOptions {
-    /** Full text content to display. */
-    readonly content: string;
-    /** Available width in columns. */
-    readonly width: number;
-    /** Total available height in rows (one row reserved for status). */
-    readonly height: number;
-}
-/** Options for rendering the pager view. */
-export interface PagerRenderOptions {
-    /** Show a scrollbar track on the right edge. Default: true. */
-    readonly showScrollbar?: boolean;
-    /** Reserve a gutter column or overlay the rightmost content cell. Default: `'gutter'`. */
-    readonly scrollbarMode?: ScrollbarMode;
-    /** Show a "Line N/M" status line below the viewport. Default: true. */
-    readonly showStatus?: boolean;
-}
-/**
- * Create initial pager state for the given content and dimensions.
- *
- * The viewport height is `height - 1` when status is shown (the default),
- * reserving one line for the status indicator.
- *
- * @param options - Content, width, and height for the pager.
- * @returns Fresh pager state with scroll at the top.
- */
-export declare function createPagerState(options: PagerOptions): PagerState;
-/**
- * Create pager state for already-rendered surface content.
- *
- * Uses the surface height directly for scroll bounds so callers can keep
- * pager composition on the `Surface` path without flattening content first.
- */
-export declare function createPagerStateForSurface(content: Surface, options: Omit<PagerOptions, 'content'>): PagerState;
-/**
- * Scroll by a relative number of lines.
- *
- * @param state - Current pager state.
- * @param dy - Number of lines to scroll (positive = down, negative = up).
- * @returns Updated pager state with new scroll position.
- */
-export declare function pagerScrollBy(state: PagerState, dy: number): PagerState;
-/**
- * Scroll to an absolute line.
- *
- * @param state - Current pager state.
- * @param y - Target line number (zero-based).
- * @returns Updated pager state with new scroll position.
- */
-export declare function pagerScrollTo(state: PagerState, y: number): PagerState;
-/**
- * Scroll to the first line.
- *
- * @param state - Current pager state.
- * @returns Updated pager state scrolled to the top.
- */
-export declare function pagerScrollToTop(state: PagerState): PagerState;
-/**
- * Scroll to the last line.
- *
- * @param state - Current pager state.
- * @returns Updated pager state scrolled to the bottom.
- */
-export declare function pagerScrollToBottom(state: PagerState): PagerState;
-/**
- * Page down (one viewport height).
- *
- * @param state - Current pager state.
- * @returns Updated pager state advanced by one page.
- */
-export declare function pagerPageDown(state: PagerState): PagerState;
-/**
- * Page up (one viewport height).
- *
- * @param state - Current pager state.
- * @returns Updated pager state moved back by one page.
- */
-export declare function pagerPageUp(state: PagerState): PagerState;
-/**
- * Update content while preserving scroll position (clamped).
- *
- * @param state - Current pager state.
- * @param content - New text content to display.
- * @returns Updated pager state with new content and clamped scroll position.
- */
-export declare function pagerSetContent(state: PagerState, content: string): PagerState;
-/**
- * Render the pager — viewport content plus optional status line.
- *
- * @param state - Current pager state.
- * @param options - Rendering options (scrollbar, status line).
- * @returns Rendered pager string with viewport and optional status.
- */
-export declare function pager(state: PagerState, options?: PagerRenderOptions): string;
-/**
- * Render the pager directly into a surface.
- *
- * Pairs with {@link createPagerStateForSurface} so already-rendered pane
- * content can stay on the structured surface path instead of dropping back
- * through the string viewport helper.
- */
-export declare function pagerSurface(content: Surface, state: PagerState, options?: PagerRenderOptions): Surface;
-/**
- * Create a preconfigured KeyMap for pager navigation.
- *
- * The caller provides their own message types for each action:
- * ```ts
- * const keys = pagerKeyMap({
- *   scrollUp: { type: 'scroll', dy: -1 },
- *   scrollDown: { type: 'scroll', dy: 1 },
- *   pageUp: { type: 'page-up' },
- *   pageDown: { type: 'page-down' },
- *   top: { type: 'top' },
- *   bottom: { type: 'bottom' },
- *   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 pager bindings.
- */
-export declare function pagerKeyMap<Msg>(actions: {
-    scrollUp: Msg;
-    scrollDown: Msg;
-    pageUp: Msg;
-    pageDown: Msg;
-    top: Msg;
-    bottom: Msg;
-    quit: Msg;
-}): KeyMap<Msg>;
+export type { PagerState, PagerOptions, PagerRenderOptions, } from './pager.part01.js';
+export { createPagerState, createPagerStateForSurface, pagerScrollBy, } from './pager.part01.js';
+export { pagerScrollTo, pagerScrollToTop, pagerScrollToBottom, pagerPageDown, pagerPageUp, pagerSetContent, pager, } from './pager.part02.js';
+export { pagerSurface, pagerKeyMap } from './pager.part03.js';
 //# sourceMappingURL=pager.d.ts.map

package/dist/pager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pager.d.ts","sourceRoot":"","sources":["../src/pager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pager.d.ts","sourceRoot":"","sources":["../src/pager.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,eAAe,EACf,KAAK,GACN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}