@flyingrobots/bijou-tui 7.1.0 → 7.2.0

package/dist/viewport.part03.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part03.d.ts","sourceRoot":"","sources":["../src/viewport.part03.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuDjE;AACD,eAAO,MAAM,eAAe,WAAM,CAAC;AACnC,eAAO,MAAM,eAAe,WAAM,CAAC;AACnC,eAAO,MAAM,oBAAoB,EAAE,IAA8C,CAAC;AAClF,eAAO,MAAM,oBAAoB,EAAE,IAA8C,CAAC;AAClF,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,SAAkB,EAC3B,SAAS,SAAkB,GAC1B,MAAM,EAAE,CAmBV;AACD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,OAAO,EACvB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAGR"}

package/dist/viewport.part03.js

@@ -0,0 +1,78 @@
+import { graphemeClusterWidth, segmentGraphemes } from '@flyingrobots/bijou';
+import { stripAnsi } from './viewport.part01.js';
+export function tokenizeAnsi(str, width) {
+    const stripped = stripAnsi(str);
+    const graphemes = segmentGraphemes(stripped);
+    const result = [];
+    let inEscape = false;
+    let escBuf = '';
+    let activeAnsi = '';
+    let gi = 0;
+    let i = 0;
+    let visibleCount = 0;
+    while (i < str.length && visibleCount < width) {
+        const ch = str.charAt(i);
+        if (ch === '\x1b') {
+            inEscape = true;
+            escBuf = ch;
+            i++;
+            continue;
+        }
+        if (inEscape) {
+            escBuf += ch;
+            if (ch === 'm') {
+                inEscape = false;
+                activeAnsi += escBuf;
+                escBuf = '';
+            }
+            i++;
+            continue;
+        }
+        if (gi >= graphemes.length)
+            break;
+        const grapheme = graphemes[gi];
+        if (grapheme === undefined)
+            break;
+        const gWidth = graphemeClusterWidth(grapheme);
+        if (visibleCount + gWidth > width)
+            break;
+        const styledGrapheme = activeAnsi + grapheme + '\x1b[0m';
+        result.push(styledGrapheme);
+        if (gWidth === 2)
+            result.push(''); // placeholder for wide char
+        visibleCount += gWidth;
+        gi++;
+        i += grapheme.length;
+    }
+    while (result.length < width) {
+        result.push(' ');
+    }
+    return result;
+}
+export const SCROLLBAR_TRACK = '│';
+export const SCROLLBAR_THUMB = '█';
+export const SCROLLBAR_TRACK_CELL = { char: SCROLLBAR_TRACK, empty: false };
+export const SCROLLBAR_THUMB_CELL = { char: SCROLLBAR_THUMB, empty: false };
+export function renderScrollbar(viewportHeight, totalLines, scrollY, trackChar = SCROLLBAR_TRACK, thumbChar = SCROLLBAR_THUMB) {
+    if (totalLines <= viewportHeight) {
+        // No scrolling needed — empty gutter
+        return Array.from({ length: viewportHeight }).fill(' ');
+    }
+    // Thumb size: proportional to visible fraction, min 1 row
+    const thumbSize = Math.max(1, Math.round((viewportHeight / totalLines) * viewportHeight));
+    // Thumb position: proportional to scroll offset
+    const maxScroll = totalLines - viewportHeight;
+    const scrollFraction = maxScroll > 0 ? scrollY / maxScroll : 0;
+    const thumbStart = Math.round(scrollFraction * (viewportHeight - thumbSize));
+    const bar = [];
+    for (let i = 0; i < viewportHeight; i++) {
+        bar.push(i >= thumbStart && i < thumbStart + thumbSize ? thumbChar : trackChar);
+    }
+    return bar;
+}
+export function resolveViewportContentWidth(width, needsScrollbar, scrollbarMode) {
+    if (!needsScrollbar)
+        return width;
+    return scrollbarMode === 'overlay' ? width : Math.max(0, width - 1);
+}
+//# sourceMappingURL=viewport.part03.js.map

package/dist/viewport.part03.js.map

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

package/dist/viewport.part04.d.ts

@@ -0,0 +1,4 @@
+import type { ViewportOptions } from './viewport.part01.js';
+export declare function overlayScrollbarChar(line: string, width: number, railChar: string): string;
+export declare function viewport(options: ViewportOptions): string;
+//# sourceMappingURL=viewport.part04.d.ts.map

package/dist/viewport.part04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part04.d.ts","sourceRoot":"","sources":["../src/viewport.part04.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK5D,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AACD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAmDzD"}

package/dist/viewport.part04.js

@@ -0,0 +1,50 @@
+import { clipToWidth, visibleLength } from './viewport.part01.js';
+import { sliceAnsi } from './viewport.part02.js';
+import { SCROLLBAR_THUMB, SCROLLBAR_TRACK, renderScrollbar, resolveViewportContentWidth } from './viewport.part03.js';
+export function overlayScrollbarChar(line, width, railChar) {
+    if (width <= 0)
+        return '';
+    if (width === 1)
+        return railChar;
+    const prefixWidth = width - 1;
+    const prefix = sliceAnsi(line, 0, prefixWidth);
+    const prefixVisible = visibleLength(prefix);
+    return prefix + ' '.repeat(Math.max(0, prefixWidth - prefixVisible)) + railChar;
+}
+export function viewport(options) {
+    const { width, height, content, scrollY = 0, scrollX = 0, showScrollbar = true, scrollbarMode = 'gutter', scrollbarTrackChar = SCROLLBAR_TRACK, scrollbarThumbChar = SCROLLBAR_THUMB, } = options;
+    const allLines = content.split('\n');
+    const totalLines = allLines.length;
+    const maxScroll = Math.max(0, totalLines - height);
+    const clampedY = Math.max(0, Math.min(scrollY, maxScroll));
+    const needsScrollbar = showScrollbar && totalLines > height;
+    const contentWidth = resolveViewportContentWidth(width, needsScrollbar, scrollbarMode);
+    // Slice visible window
+    const visibleSlice = allLines.slice(clampedY, clampedY + height);
+    // Pad to fill viewport height if content is shorter
+    while (visibleSlice.length < height) {
+        visibleSlice.push('');
+    }
+    // Clip/pad each line to content width
+    const rendered = visibleSlice.map((line) => {
+        let sliced;
+        if (scrollX > 0) {
+            sliced = sliceAnsi(line, scrollX, scrollX + contentWidth);
+        }
+        else {
+            const vis = visibleLength(line);
+            sliced = vis > contentWidth ? clipToWidth(line, contentWidth) : line;
+        }
+        const slicedVis = visibleLength(sliced);
+        return slicedVis < contentWidth ? sliced + ' '.repeat(contentWidth - slicedVis) : sliced;
+    });
+    // Append scrollbar
+    if (needsScrollbar) {
+        const bar = renderScrollbar(height, totalLines, clampedY, scrollbarTrackChar, scrollbarThumbChar);
+        return rendered.map((line, i) => (scrollbarMode === 'overlay'
+            ? overlayScrollbarChar(line, width, bar[i] ?? ' ')
+            : line + (bar[i] ?? ' '))).join('\n');
+    }
+    return rendered.join('\n');
+}
+//# sourceMappingURL=viewport.part04.js.map

package/dist/viewport.part04.js.map

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

package/dist/viewport.part05.d.ts

@@ -0,0 +1,5 @@
+import type { Surface } from '@flyingrobots/bijou';
+import type { ScrollState, ViewportContent, ViewportSurfaceOptions } from './viewport.part01.js';
+export declare function viewportSurface(options: ViewportSurfaceOptions): Surface;
+export declare function createScrollStateForContent(content: ViewportContent, viewportHeight: number, viewportWidth?: number): ScrollState;
+//# sourceMappingURL=viewport.part05.d.ts.map

package/dist/viewport.part05.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part05.d.ts","sourceRoot":"","sources":["../src/viewport.part05.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAOjG,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CA6DxE;AACD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,WAAW,CAiBb"}

package/dist/viewport.part05.js

@@ -0,0 +1,59 @@
+import { createSurface, parseAnsiToSurface } from '@flyingrobots/bijou';
+import { SCROLLBAR_THUMB, SCROLLBAR_THUMB_CELL, SCROLLBAR_TRACK, SCROLLBAR_TRACK_CELL, renderScrollbar, resolveViewportContentWidth } from './viewport.part03.js';
+import { viewport } from './viewport.part04.js';
+import { createScrollState, normalizeViewportContent } from './viewport.part06.js';
+export function viewportSurface(options) {
+    const { width, height, content, scrollY = 0, scrollX = 0, showScrollbar = true, scrollbarMode = 'gutter', scrollbarTrackChar = SCROLLBAR_TRACK, scrollbarThumbChar = SCROLLBAR_THUMB, scrollbarTrackCell = SCROLLBAR_TRACK_CELL, scrollbarThumbCell = SCROLLBAR_THUMB_CELL, } = options;
+    const safeWidth = Math.max(0, Math.floor(width));
+    const safeHeight = Math.max(0, Math.floor(height));
+    if (typeof content === 'string') {
+        return parseAnsiToSurface(viewport({
+            width: safeWidth,
+            height: safeHeight,
+            content,
+            scrollY,
+            scrollX,
+            showScrollbar,
+            scrollbarMode,
+            scrollbarTrackChar,
+            scrollbarThumbChar,
+        }), safeWidth, safeHeight);
+    }
+    const normalizedContent = normalizeViewportContent(content);
+    const result = createSurface(safeWidth, safeHeight, { char: ' ', empty: false });
+    const totalLines = normalizedContent.height;
+    const maxScroll = Math.max(0, totalLines - safeHeight);
+    const clampedY = Math.max(0, Math.min(scrollY, maxScroll));
+    const needsScrollbar = showScrollbar && totalLines > safeHeight;
+    const contentWidth = resolveViewportContentWidth(safeWidth, needsScrollbar, scrollbarMode);
+    if (contentWidth > 0 && safeHeight > 0) {
+        result.blit(normalizedContent, 0, 0, Math.max(0, scrollX), clampedY, contentWidth, safeHeight);
+    }
+    if (needsScrollbar && safeWidth > 0) {
+        const bar = renderScrollbar(safeHeight, totalLines, clampedY, scrollbarTrackChar, scrollbarThumbChar);
+        const scrollbarX = safeWidth - 1;
+        for (let y = 0; y < safeHeight; y++) {
+            const rail = bar[y] ?? ' ';
+            const cell = rail === scrollbarThumbChar ? scrollbarThumbCell : scrollbarTrackCell;
+            result.set(scrollbarX, y, { ...cell, char: rail, empty: false });
+        }
+    }
+    return result;
+}
+export function createScrollStateForContent(content, viewportHeight, viewportWidth) {
+    if (typeof content === 'string') {
+        return createScrollState(content, viewportHeight, viewportWidth);
+    }
+    const normalized = normalizeViewportContent(content);
+    const visibleLines = Math.max(0, Math.floor(viewportHeight));
+    const safeWidth = viewportWidth == null ? undefined : Math.max(0, Math.floor(viewportWidth));
+    return {
+        y: 0,
+        maxY: Math.max(0, normalized.height - visibleLines),
+        x: 0,
+        maxX: safeWidth == null ? 0 : Math.max(0, normalized.width - safeWidth),
+        totalLines: normalized.height,
+        visibleLines,
+    };
+}
+//# sourceMappingURL=viewport.part05.js.map

package/dist/viewport.part05.js.map

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

package/dist/viewport.part06.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutNode, Surface } from '@flyingrobots/bijou';
+import type { ScrollState } from './viewport.part01.js';
+export declare function createScrollState(content: string, viewportHeight: number, viewportWidth?: number): ScrollState;
+export declare function normalizeViewportContent(content: Surface | LayoutNode): Surface;
+export declare function isSurfaceContent(value: Surface | LayoutNode): value is Surface;
+export declare function scrollBy(state: ScrollState, dy: number): ScrollState;
+export declare function scrollTo(state: ScrollState, y: number): ScrollState;
+export declare function scrollByX(state: ScrollState, dx: number): ScrollState;
+export declare function scrollToX(state: ScrollState, x: number): ScrollState;
+export declare function scrollToTop(state: ScrollState): ScrollState;
+export declare function scrollToBottom(state: ScrollState): ScrollState;
+export declare function pageDown(state: ScrollState): ScrollState;
+export declare function pageUp(state: ScrollState): ScrollState;
+//# sourceMappingURL=viewport.part06.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part06.d.ts","sourceRoot":"","sources":["../src/viewport.part06.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAM/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,WAAW,CAsBb;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAG/E;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,IAAI,OAAO,CAE9E;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAGpE;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAEnE;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAErE;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAEpE;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAE3D;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAE9D;AACD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAExD;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEtD"}

package/dist/viewport.part06.js

@@ -0,0 +1,58 @@
+import { layoutNodeToSurface } from './layout-node-surface.js';
+import { visibleLength } from './viewport.part01.js';
+export function createScrollState(content, viewportHeight, viewportWidth) {
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+    let maxX = 0;
+    if (viewportWidth !== undefined) {
+        let widest = 0;
+        for (const line of lines) {
+            const w = visibleLength(line);
+            if (w > widest)
+                widest = w;
+        }
+        maxX = Math.max(0, widest - viewportWidth);
+    }
+    return {
+        y: 0,
+        maxY: Math.max(0, totalLines - viewportHeight),
+        x: 0,
+        maxX,
+        totalLines,
+        visibleLines: viewportHeight,
+    };
+}
+export function normalizeViewportContent(content) {
+    if (isSurfaceContent(content))
+        return content;
+    return layoutNodeToSurface(content);
+}
+export function isSurfaceContent(value) {
+    return 'cells' in value;
+}
+export function scrollBy(state, dy) {
+    const y = Math.max(0, Math.min(state.y + dy, state.maxY));
+    return { ...state, y };
+}
+export function scrollTo(state, y) {
+    return { ...state, y: Math.max(0, Math.min(y, state.maxY)) };
+}
+export function scrollByX(state, dx) {
+    return { ...state, x: Math.max(0, Math.min(state.x + dx, state.maxX)) };
+}
+export function scrollToX(state, x) {
+    return { ...state, x: Math.max(0, Math.min(x, state.maxX)) };
+}
+export function scrollToTop(state) {
+    return { ...state, y: 0 };
+}
+export function scrollToBottom(state) {
+    return { ...state, y: state.maxY };
+}
+export function pageDown(state) {
+    return scrollBy(state, state.visibleLines);
+}
+export function pageUp(state) {
+    return scrollBy(state, -state.visibleLines);
+}
+//# sourceMappingURL=viewport.part06.js.map

package/dist/viewport.part06.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyingrobots/bijou-tui",
-  "version": "7.1.0",
+  "version": "7.2.0",
   "description": "TEA runtime for terminal UIs — model/update/view with keyboard input, alt screen, and layout helpers.",
   "type": "module",
   "sideEffects": false,
@@ -24,10 +24,10 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@flyingrobots/bijou-i18n": "7.1.0"
+    "@flyingrobots/bijou-i18n": "7.2.0"
   },
   "peerDependencies": {
-    "@flyingrobots/bijou": "7.1.0"
+    "@flyingrobots/bijou": "7.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",