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

package/dist/viewport.js

@@ -1,471 +1,7 @@
-/**
- * Scrollable content viewport for TUI apps.
- *
- * Renders a visible window into content that may be larger than the
- * available screen space, with optional scrollbar indicator.
- */
-import { createSurface, graphemeWidth, graphemeClusterWidth, parseAnsiToSurface, segmentGraphemes, clipToWidth as coreClipToWidth, } from '@flyingrobots/bijou';
-import { layoutNodeToSurface } from './layout-node-surface.js';
-// ---------------------------------------------------------------------------
-// ANSI helpers
-// ---------------------------------------------------------------------------
-/** Pattern matching SGR-style ANSI escape sequences. */
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-/**
- * Strip all SGR ANSI escape sequences from a string.
- *
- * @param str - Input string possibly containing ANSI escapes.
- * @returns Plain text with all ANSI color/style sequences removed.
- */
-export function stripAnsi(str) {
-    return str.replace(ANSI_RE, '');
-}
-/**
- * Compute the terminal display width of a string.
- *
- * Grapheme-cluster aware: handles emoji, CJK (2 columns), ZWJ sequences,
- * skin tones, flag pairs, and combining marks correctly.
- *
- * @param str - Input string (may contain ANSI escapes).
- * @returns Display width in terminal columns.
- */
-export function visibleLength(str) {
-    return graphemeWidth(str);
-}
-/**
- * Clip a string to a maximum visible width, preserving ANSI escapes.
- * Grapheme-cluster aware: won't split multi-codepoint sequences.
- * Appends a reset sequence if the string was clipped mid-style.
- *
- * Re-exported from `@flyingrobots/bijou` core for backward compatibility.
- *
- * @param str - Input string (may contain ANSI escapes).
- * @param maxWidth - Maximum visible width in terminal columns.
- * @returns Clipped string, at most `maxWidth` columns wide.
- */
-export const clipToWidth = coreClipToWidth;
-/**
- * Extract a visible-column substring from an ANSI-styled string.
- * Return characters between visible columns [startCol, endCol).
- * Grapheme-cluster aware. Preserve any active ANSI styles seen before startCol.
- *
- * O(n): pre-segment stripped text once, then walk the original string
- * with a grapheme pointer instead of re-segmenting per character.
- *
- * @param str - ANSI-styled input string.
- * @param startCol - Start visible column (inclusive, 0-based).
- * @param endCol - End visible column (exclusive).
- * @returns Substring spanning the requested visible columns with ANSI styles preserved.
- */
-export function sliceAnsi(str, startCol, endCol) {
-    const stripped = stripAnsi(str);
-    const graphemes = segmentGraphemes(stripped);
-    let visible = 0;
-    let inEscape = false;
-    let escBuf = '';
-    let activeAnsi = '';
-    let result = '';
-    let collecting = false;
-    let hasStyle = false;
-    let didBreakAtEnd = false;
-    let gi = 0;
-    let i = 0;
-    while (i < str.length) {
-        const ch = str[i];
-        if (ch === '\x1b') {
-            inEscape = true;
-            escBuf = ch;
-            i++;
-            continue;
-        }
-        if (inEscape) {
-            escBuf += ch;
-            if (ch === 'm') {
-                inEscape = false;
-                if (collecting) {
-                    result += escBuf;
-                    hasStyle = true;
-                }
-                else {
-                    activeAnsi += escBuf;
-                }
-                escBuf = '';
-            }
-            i++;
-            continue;
-        }
-        // Visible character — consume next pre-segmented grapheme
-        if (gi >= graphemes.length)
-            break;
-        const grapheme = graphemes[gi];
-        const gWidth = graphemeClusterWidth(grapheme);
-        if (visible >= endCol) {
-            if (hasStyle)
-                result += '\x1b[0m';
-            didBreakAtEnd = true;
-            break;
-        }
-        if (visible + gWidth > startCol) {
-            if (!collecting) {
-                collecting = true;
-                result = activeAnsi;
-                if (activeAnsi.length > 0)
-                    hasStyle = true;
-            }
-            result += grapheme;
-        }
-        visible += gWidth;
-        gi++;
-        i += grapheme.length;
-    }
-    if (collecting && hasStyle && !didBreakAtEnd)
-        result += '\x1b[0m';
-    return result;
-}
-/**
- * Extract all individual visible character cells from an ANSI-styled string.
- * Each cell is returned as a fully-styled string (including resets).
- *
- * @param str - ANSI-styled input string.
- * @param width - Number of cells to extract (pads with spaces if shorter).
- * @returns Array of exactly `width` strings, each a single-column styled character.
- */
-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[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];
-        const gWidth = graphemeClusterWidth(grapheme);
-        // If adding this grapheme exceeds width, stop
-        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;
-    }
-    // Pad with spaces
-    while (result.length < width) {
-        result.push(' ');
-    }
-    return result;
-}
-// ---------------------------------------------------------------------------
-// Scrollbar rendering
-// ---------------------------------------------------------------------------
-/** Character used for the scrollbar track (unfilled portion). */
-const SCROLLBAR_TRACK = '│';
-/** Character used for the scrollbar thumb (filled portion). */
-const SCROLLBAR_THUMB = '█';
-const SCROLLBAR_TRACK_CELL = { char: SCROLLBAR_TRACK, empty: false };
-const SCROLLBAR_THUMB_CELL = { char: SCROLLBAR_THUMB, empty: false };
-/**
- * Render a vertical scrollbar as an array of single-character strings.
- *
- * Thumb size is proportional to the visible fraction of content.
- * Return an array of spaces when all content fits within the viewport.
- *
- * @param viewportHeight - Height of the viewport in rows.
- * @param totalLines - Total number of content lines.
- * @param scrollY - Current vertical scroll offset.
- * @returns Array of length `viewportHeight`, each element a single scrollbar character.
- */
-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;
-}
-function resolveViewportContentWidth(width, needsScrollbar, scrollbarMode) {
-    if (!needsScrollbar)
-        return width;
-    return scrollbarMode === 'overlay' ? width : Math.max(0, width - 1);
-}
-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;
-}
-// ---------------------------------------------------------------------------
-// Viewport rendering
-// ---------------------------------------------------------------------------
-/**
- * Render a scrollable viewport into content.
- *
- * Return a string with exactly `height` lines, each at most `width`
- * visible columns wide (including optional scrollbar when enabled).
- *
- * @param options - Viewport configuration including dimensions, content, and scroll offsets.
- * @returns Rendered viewport string with lines joined by newlines.
- */
-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');
-}
-/**
- * Render a scrollable viewport directly into a Surface.
- *
- * This is the canonical viewport primitive for rich TUI composition. It acts
- * like a mask over text, an existing `Surface`, or a `LayoutNode` tree and
- * reveals only the visible scroll window. String content still routes through
- * {@link viewport} so the explicit text helper stays consistent.
- *
- * @param options - Viewport configuration including dimensions, content, and scroll offsets.
- * @returns Surface sized exactly to the requested viewport rectangle.
- */
-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 cell = bar[y] === scrollbarThumbChar ? scrollbarThumbCell : scrollbarTrackCell;
-            result.set(scrollbarX, y, { ...cell, char: bar[y], empty: false });
-        }
-    }
-    return result;
-}
-/**
- * Create initial scroll state for any viewport-maskable content.
- *
- * Use this when the viewport is wrapping an existing `Surface` or `LayoutNode`
- * instead of plain text. String content can still use `createScrollState()`,
- * but this helper accepts all viewport content types.
- */
-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,
-    };
-}
-// ---------------------------------------------------------------------------
-// Scroll state management
-// ---------------------------------------------------------------------------
-/**
- * Create initial scroll state for content within a viewport.
- *
- * @param content - Full content string (newline-delimited).
- * @param viewportHeight - Visible height in rows.
- * @param viewportWidth - Visible width in columns (used to compute maxX).
- * @returns Initial scroll state positioned at top-left (y=0, x=0).
- */
-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,
-    };
-}
-function normalizeViewportContent(content) {
-    if (isSurfaceContent(content))
-        return content;
-    return layoutNodeToSurface(content);
-}
-function isSurfaceContent(value) {
-    return typeof value === 'object' && value !== null && 'cells' in value;
-}
-/**
- * Scroll vertically by a relative amount, clamping to valid range.
- *
- * @param state - Current scroll state.
- * @param dy - Relative vertical offset (positive = down, negative = up).
- * @returns New scroll state with updated y position.
- */
-export function scrollBy(state, dy) {
-    const y = Math.max(0, Math.min(state.y + dy, state.maxY));
-    return { ...state, y };
-}
-/**
- * Scroll vertically to an absolute position, clamping to valid range.
- *
- * @param state - Current scroll state.
- * @param y - Absolute vertical offset (0-based line index).
- * @returns New scroll state with updated y position.
- */
-export function scrollTo(state, y) {
-    return { ...state, y: Math.max(0, Math.min(y, state.maxY)) };
-}
-/**
- * Scroll horizontally by a relative amount, clamping to valid range.
- *
- * @param state - Current scroll state.
- * @param dx - Relative horizontal offset (positive = right, negative = left).
- * @returns New scroll state with updated x position.
- */
-export function scrollByX(state, dx) {
-    return { ...state, x: Math.max(0, Math.min(state.x + dx, state.maxX)) };
-}
-/**
- * Scroll horizontally to an absolute position, clamping to valid range.
- *
- * @param state - Current scroll state.
- * @param x - Absolute horizontal offset (0-based column index).
- * @returns New scroll state with updated x position.
- */
-export function scrollToX(state, x) {
-    return { ...state, x: Math.max(0, Math.min(x, state.maxX)) };
-}
-/**
- * Scroll to the top (y = 0).
- *
- * @param state - Current scroll state.
- * @returns New scroll state positioned at the top.
- */
-export function scrollToTop(state) {
-    return { ...state, y: 0 };
-}
-/**
- * Scroll to the bottom (y = maxY).
- *
- * @param state - Current scroll state.
- * @returns New scroll state positioned at the bottom.
- */
-export function scrollToBottom(state) {
-    return { ...state, y: state.maxY };
-}
-/**
- * Page down (scroll by one viewport height).
- *
- * @param state - Current scroll state.
- * @returns New scroll state scrolled down by `visibleLines` rows.
- */
-export function pageDown(state) {
-    return scrollBy(state, state.visibleLines);
-}
-/**
- * Page up (scroll by one viewport height).
- *
- * @param state - Current scroll state.
- * @returns New scroll state scrolled up by `visibleLines` rows.
- */
-export function pageUp(state) {
-    return scrollBy(state, -state.visibleLines);
-}
+export { clipToWidth, stripAnsi, visibleLength } from './viewport.part01.js';
+export { sliceAnsi } from './viewport.part02.js';
+export { tokenizeAnsi } from './viewport.part03.js';
+export { viewport } from './viewport.part04.js';
+export { createScrollStateForContent, viewportSurface } from './viewport.part05.js';
+export { createScrollState, pageDown, pageUp, scrollBy, scrollByX, scrollTo, scrollToBottom, scrollToTop, scrollToX } from './viewport.part06.js';
 //# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/viewport.part01.d.ts

@@ -0,0 +1,51 @@
+import { clipToWidth as coreClipToWidth } from '@flyingrobots/bijou';
+import type { Cell, LayoutNode, Surface } from '@flyingrobots/bijou';
+export type ScrollbarMode = 'gutter' | 'overlay';
+export interface ViewportOptions {
+    /** Visible width in columns. Content lines longer than this are clipped. */
+    readonly width: number;
+    /** Visible height in rows. */
+    readonly height: number;
+    /** Full content string (may be taller/wider than the viewport). */
+    readonly content: string;
+    /** Vertical scroll offset (0-based line index). Default: 0. */
+    readonly scrollY?: number;
+    /** Horizontal scroll offset (0-based column index). Default: 0. */
+    readonly scrollX?: number;
+    /** 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;
+    /** Character used for the scrollbar track in string rendering. Default: `'│'`. */
+    readonly scrollbarTrackChar?: string;
+    /** Character used for the scrollbar thumb in string rendering. Default: `'█'`. */
+    readonly scrollbarThumbChar?: string;
+}
+export interface ViewportSurfaceOptions extends Omit<ViewportOptions, 'content'> {
+    /** Full content payload, either plain/ANSI text, a pre-rendered surface, or a layout tree. */
+    readonly content: ViewportContent;
+    /** Cell used for the scrollbar track in surface rendering. */
+    readonly scrollbarTrackCell?: Cell;
+    /** Cell used for the scrollbar thumb in surface rendering. */
+    readonly scrollbarThumbCell?: Cell;
+}
+export type ViewportContent = string | Surface | LayoutNode;
+export interface ScrollState {
+    /** Current vertical scroll offset. */
+    readonly y: number;
+    /** Maximum vertical scroll offset. */
+    readonly maxY: number;
+    /** Current horizontal scroll offset. */
+    readonly x: number;
+    /** Maximum horizontal scroll offset. */
+    readonly maxX: number;
+    /** Total number of content lines. */
+    readonly totalLines: number;
+    /** Number of visible lines (viewport height). */
+    readonly visibleLines: number;
+}
+export declare const ANSI_RE: RegExp;
+export declare function stripAnsi(str: string): string;
+export declare function visibleLength(str: string): number;
+export declare const clipToWidth: typeof coreClipToWidth;
+//# sourceMappingURL=viewport.part01.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part01.d.ts","sourceRoot":"","sources":["../src/viewport.part01.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAEpF,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjD,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AACD,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC;IAC9E,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC;CACpC;AACD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAC5D,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AACD,eAAO,MAAM,OAAO,QAA2D,CAAC;AAChF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AACD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AACD,eAAO,MAAM,WAAW,wBAAkB,CAAC"}

package/dist/viewport.part01.js

@@ -0,0 +1,10 @@
+import { clipToWidth as coreClipToWidth, graphemeWidth } from '@flyingrobots/bijou';
+export const ANSI_RE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, 'g');
+export function stripAnsi(str) {
+    return str.replace(ANSI_RE, '');
+}
+export function visibleLength(str) {
+    return graphemeWidth(str);
+}
+export const clipToWidth = coreClipToWidth;
+//# sourceMappingURL=viewport.part01.js.map

package/dist/viewport.part01.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part01.js","sourceRoot":"","sources":["../src/viewport.part01.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA+CpF,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AAChF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AACD,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC"}

package/dist/viewport.part02.d.ts

@@ -0,0 +1,2 @@
+export declare function sliceAnsi(str: string, startCol: number, endCol: number): string;
+//# sourceMappingURL=viewport.part02.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part02.d.ts","sourceRoot":"","sources":["../src/viewport.part02.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsE/E"}

package/dist/viewport.part02.js

@@ -0,0 +1,69 @@
+import { graphemeClusterWidth, segmentGraphemes } from '@flyingrobots/bijou';
+import { stripAnsi } from './viewport.part01.js';
+export function sliceAnsi(str, startCol, endCol) {
+    const stripped = stripAnsi(str);
+    const graphemes = segmentGraphemes(stripped);
+    let visible = 0;
+    let inEscape = false;
+    let escBuf = '';
+    let activeAnsi = '';
+    let result = '';
+    let collecting = false;
+    let hasStyle = false;
+    let didBreakAtEnd = false;
+    let gi = 0;
+    let i = 0;
+    while (i < str.length) {
+        const ch = str.charAt(i);
+        if (ch === '\x1b') {
+            inEscape = true;
+            escBuf = ch;
+            i++;
+            continue;
+        }
+        if (inEscape) {
+            escBuf += ch;
+            if (ch === 'm') {
+                inEscape = false;
+                if (collecting) {
+                    result += escBuf;
+                    hasStyle = true;
+                }
+                else {
+                    activeAnsi += escBuf;
+                }
+                escBuf = '';
+            }
+            i++;
+            continue;
+        }
+        if (gi >= graphemes.length)
+            break;
+        const grapheme = graphemes[gi];
+        if (grapheme === undefined)
+            break;
+        const gWidth = graphemeClusterWidth(grapheme);
+        if (visible >= endCol) {
+            if (hasStyle)
+                result += '\x1b[0m';
+            didBreakAtEnd = true;
+            break;
+        }
+        if (visible + gWidth > startCol) {
+            if (!collecting) {
+                collecting = true;
+                result = activeAnsi;
+                if (activeAnsi.length > 0)
+                    hasStyle = true;
+            }
+            result += grapheme;
+        }
+        visible += gWidth;
+        gi++;
+        i += grapheme.length;
+    }
+    if (collecting && hasStyle && !didBreakAtEnd)
+        result += '\x1b[0m';
+    return result;
+}
+//# sourceMappingURL=viewport.part02.js.map

package/dist/viewport.part02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.part02.js","sourceRoot":"","sources":["../src/viewport.part02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAc;IACrE,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YAClB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,GAAG,EAAE,CAAC;YACZ,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,EAAE,CAAC;YACb,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,QAAQ,GAAG,KAAK,CAAC;gBACjB,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,IAAI,MAAM,CAAC;oBACjB,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,UAAU,IAAI,MAAM,CAAC;gBACvB,CAAC;gBACD,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;YACD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,EAAE,IAAI,SAAS,CAAC,MAAM;YAAE,MAAM;QAElC,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM;QAClC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,IAAI,QAAQ;gBAAE,MAAM,IAAI,SAAS,CAAC;YAClC,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM;QACR,CAAC;QAED,IAAI,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,UAAU,GAAG,IAAI,CAAC;gBAClB,MAAM,GAAG,UAAU,CAAC;gBACpB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;oBAAE,QAAQ,GAAG,IAAI,CAAC;YAC7C,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,MAAM,CAAC;QAClB,EAAE,EAAE,CAAC;QACL,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,UAAU,IAAI,QAAQ,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,SAAS,CAAC;IAElE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/viewport.part03.d.ts

@@ -0,0 +1,10 @@
+import type { Cell } from '@flyingrobots/bijou';
+import type { ScrollbarMode } from './viewport.part01.js';
+export declare function tokenizeAnsi(str: string, width: number): string[];
+export declare const SCROLLBAR_TRACK = "\u2502";
+export declare const SCROLLBAR_THUMB = "\u2588";
+export declare const SCROLLBAR_TRACK_CELL: Cell;
+export declare const SCROLLBAR_THUMB_CELL: Cell;
+export declare function renderScrollbar(viewportHeight: number, totalLines: number, scrollY: number, trackChar?: string, thumbChar?: string): string[];
+export declare function resolveViewportContentWidth(width: number, needsScrollbar: boolean, scrollbarMode: ScrollbarMode): number;
+//# sourceMappingURL=viewport.part03.d.ts.map