@north-light/crouter 0.3.318 → 0.3.319

package/dist/clients/inbox/tui/ansi.js

@@ -1,321 +1,3 @@
-import stringWidth from 'string-width';
-import { visibleWidth as piVisibleWidth } from '@earendil-works/pi-tui';
-// ── ANSI escape constants ─────────────────────────────────────────────────────
-// The single home for these — both the page renderer (render.ts) and the inbox
-// picker (inbox/tui.ts) import from here rather than keeping their own copies.
-export const ESC = '\x1b[';
-export const RESET = `${ESC}0m`;
-export const BOLD = `${ESC}1m`;
-export const DIM = `${ESC}2m`;
-export const ITALIC = `${ESC}3m`;
-export const RED = `${ESC}31m`;
-export const GREEN = `${ESC}32m`;
-export const YELLOW = `${ESC}33m`;
-export const CYAN = `${ESC}36m`;
-export const GRAY = `${ESC}90m`;
-export const REVERSE = `${ESC}7m`;
-// ── Text helpers ──────────────────────────────────────────────────────────────
-const CONTROL_CHARS_RE = /\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-_]|[\x00-\x08\x0B\x0E-\x1F\x7F-\x9F]/g;
-export function sanitize(text) {
-    if (typeof text !== 'string')
-        return '';
-    return text.replace(CONTROL_CHARS_RE, '');
-}
-export function singleLine(text) {
-    return sanitize(text).replace(/\s+/g, ' ').trim();
-}
-export function hline(width, char = '─') {
-    if (width < 1)
-        return '';
-    return char.repeat(width);
-}
-export function padRight(text, width) {
-    const w = stringWidth(text);
-    if (w >= width)
-        return text;
-    return text + ' '.repeat(width - w);
-}
-/** Char-based width truncation with a trailing ellipsis. The canonical page
- *  renderer variant. */
-export function truncate(text, maxWidth) {
-    if (maxWidth < 1)
-        return '';
-    if (stringWidth(text) <= maxWidth)
-        return text;
-    const chars = [...text];
-    let w = 0;
-    let out = '';
-    for (const ch of chars) {
-        const cw = stringWidth(ch);
-        if (w + cw + 1 > maxWidth)
-            break;
-        out += ch;
-        w += cw;
-    }
-    return out + '…';
-}
-/** Word-aware truncation that also flattens newlines and strips decorative
- *  emoji — tuned for dense inbox rows (ported from sisyphus format.ts). Kept
- *  distinct from `truncate` because those two surfaces want different behavior. */
-export function truncateRow(text, max) {
-    const clean = text.replace(/\n/g, ' ').replace(/✅/g, '✓').replace(/❌/g, '✗').replace(/\p{Emoji_Presentation}/gu, '');
-    if (max < 4)
-        return clean.slice(0, max);
-    const w = stringWidth(clean);
-    if (w <= max)
-        return clean;
-    let result = clean;
-    while (stringWidth(result) > max - 1 && result.length > 0) {
-        const cut = result.lastIndexOf(' ', result.length - 2);
-        if (cut > max * 0.4) {
-            result = result.slice(0, cut);
-        }
-        else {
-            result = result.slice(0, result.length - 1);
-        }
-    }
-    return result + '…';
-}
-function sliceByWidth(s, maxWidth) {
-    let w = 0;
-    let out = '';
-    for (const ch of s) {
-        const cw = stringWidth(ch);
-        if (w + cw > maxWidth)
-            break;
-        out += ch;
-        w += cw;
-    }
-    if (out === '' && s.length > 0)
-        out = [...s][0];
-    return out;
-}
-/** Word-wrap on whitespace; splits on `\n` into separate paragraphs. */
-export function wrap(text, maxWidth) {
-    if (maxWidth < 1)
-        return [text];
-    const out = [];
-    const paragraphs = text.split('\n');
-    for (let p = 0; p < paragraphs.length; p++) {
-        const para = paragraphs[p];
-        if (para === '') {
-            out.push('');
-            continue;
-        }
-        const words = para.split(/[ \t]+/).filter(Boolean);
-        let current = '';
-        for (let word of words) {
-            while (stringWidth(word) > maxWidth) {
-                if (current) {
-                    out.push(current);
-                    current = '';
-                }
-                const piece = sliceByWidth(word, maxWidth);
-                out.push(piece);
-                word = word.slice(piece.length);
-            }
-            const candidate = current ? `${current} ${word}` : word;
-            if (stringWidth(candidate) <= maxWidth) {
-                current = candidate;
-            }
-            else {
-                if (current)
-                    out.push(current);
-                current = word;
-            }
-        }
-        if (current)
-            out.push(current);
-    }
-    return out.length > 0 ? out : [''];
-}
-/** Hard character wrap that ignores word boundaries; splits on `\n`. Used for
- *  free-form input buffers where every character (including runs without
- *  spaces) must stay on screen. */
-export function hardWrap(text, maxWidth) {
-    if (maxWidth < 1)
-        return [text];
-    const segments = text.split('\n');
-    const out = [];
-    for (const seg of segments) {
-        if (seg.length === 0) {
-            out.push('');
-            continue;
-        }
-        let current = '';
-        let currentW = 0;
-        for (const ch of [...seg]) {
-            const cw = stringWidth(ch);
-            if (currentW + cw > maxWidth) {
-                out.push(current);
-                current = ch;
-                currentW = cw;
-            }
-            else {
-                current += ch;
-                currentW += cw;
-            }
-        }
-        out.push(current);
-    }
-    return out;
-}
-/**
- * Pad each non-empty line with leading spaces to horizontally center the
- * `contentWidth`-wide block within `cols`. Wide terminals get breathing room;
- * narrow panes skip centering. Empty lines stay empty so frame diffing keeps
- * them as cheap no-ops.
- */
-export function centerHorizontal(lines, cols, contentWidth) {
-    const extraPad = Math.max(0, Math.floor((cols - contentWidth) / 2));
-    if (extraPad === 0)
-        return lines;
-    const pad = ' '.repeat(extraPad);
-    return lines.map((line) => (line === '' ? '' : pad + line));
-}
-/** Visible width of a line in display cells. pi-tui's helper is the one
- *  terminal-cell contract: it accounts for graphemes and wide cells while
- *  ignoring SGR, OSC, and APC sequences. */
-export function visibleWidth(line) {
-    return piVisibleWidth(line);
-}
-const ANSI_TOKEN = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b_[^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-^]/g;
-const OSC8_TOKEN = /\x1b\]8;[^;\x07\x1b]*;([^\x07\x1b]*)(\x07|\x1b\\)/g;
-const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
-/** ANSI escapes are tokens of their own; all printable text is segmented into
- * extended grapheme clusters before widths or slice boundaries are calculated.
- * `visibleWidth` assigns display width to the complete cluster (not its
- * constituent code points), which keeps ZWJ emoji, flags, skin tones and
- * combining sequences indivisible while panning, and counts a tab as the same
- * cells the rest of the rectangle measures it at. */
-function displayTokens(line) {
-    const tokens = [];
-    let at = 0;
-    ANSI_TOKEN.lastIndex = 0;
-    for (let match = ANSI_TOKEN.exec(line); match !== null; match = ANSI_TOKEN.exec(line)) {
-        for (const segment of GRAPHEMES.segment(line.slice(at, match.index))) {
-            tokens.push({ ansi: false, text: segment.segment, width: visibleWidth(segment.segment) });
-        }
-        tokens.push({ ansi: true, text: match[0] });
-        at = match.index + match[0].length;
-    }
-    for (const segment of GRAPHEMES.segment(line.slice(at))) {
-        tokens.push({ ansi: false, text: segment.segment, width: visibleWidth(segment.segment) });
-    }
-    return tokens;
-}
-/**
- * The one display-cell containment primitive: the visible cells
- * `[start, start + width)` of `line`, with escape sequences preserved.
- *
- * Every line rendered into a rectangle must fit within its assigned width, so
- * each logical line occupies one physical row. Overflow wraps into the next
- * row and violates the frame contract. Styling seen before
- * the window is replayed at its head so a slice keeps the colors it had in
- * place, and a double-width glyph straddling either edge becomes spaces so
- * the slice occupies exactly the cells it claims.
- */
-export function sliceCells(line, start, width) {
-    if (width < 1)
-        return '';
-    const from = Math.max(0, start);
-    const end = from + width;
-    let carried = ''; // styling established before the window
-    let out = '';
-    let emitted = false; // any escape inside the window
-    let cell = 0;
-    for (const token of displayTokens(line)) {
-        if (token.ansi) {
-            if (cell < from)
-                carried += token.text;
-            else {
-                out += token.text;
-                emitted = true;
-            }
-            continue;
-        }
-        if (cell >= end)
-            break;
-        const cw = token.width;
-        // A standalone combining mark has no cells but is still a complete
-        // grapheme cluster; retain it whenever its zero-width position is inside
-        // the window rather than dropping it through the usual boundary check.
-        if (cw === 0) {
-            if (cell >= from)
-                out += token.text;
-            continue;
-        }
-        if (cell + cw <= from) {
-            cell += cw;
-            continue;
-        }
-        if (cell < from) { // whole grapheme straddles the left edge
-            out += ' '.repeat(cell + cw - from);
-            cell += cw;
-            continue;
-        }
-        if (cell + cw > end) { // whole grapheme straddles the right edge
-            out += ' '.repeat(end - cell);
-            cell = end;
-            break;
-        }
-        out += token.text;
-        cell += cw;
-    }
-    if (out === '')
-        return '';
-    if (carried !== '') {
-        out = carried + out;
-        emitted = true;
-    }
-    const hyperlinkClose = closeActiveOsc8(out);
-    return emitted ? out + hyperlinkClose + RESET : out;
-}
-/** Close an OSC-8 hyperlink that starts inside a clipped row so it cannot
- * remain active through padding or the next terminal row. */
-function closeActiveOsc8(line) {
-    let close = '';
-    OSC8_TOKEN.lastIndex = 0;
-    for (let match = OSC8_TOKEN.exec(line); match !== null; match = OSC8_TOKEN.exec(line)) {
-        close = match[1] === '' ? '' : `\x1b]8;;${match[2]}`;
-    }
-    return close;
-}
-/**
- * ANSI-aware clip: truncate a line's visible width to `maxWidth`. Thin
- * wrapper over `sliceCells` so containment has a single implementation.
- */
-export function clipLine(line, maxWidth) {
-    if (maxWidth < 1)
-        return '';
-    if (visibleWidth(line) <= maxWidth)
-        return line; // visibleWidth ignores ANSI
-    return sliceCells(line, 0, maxWidth);
-}
-/**
- * Horizontal window onto a row that may be wider than its rectangle (a
- * Mermaid diagram rendered at the pane's full width). A row that fits is
- * returned untouched — panning only ever moves content that overflows, so
- * prose stays put while a diagram slides. Hidden content on either side is
- * marked with a dim ‹/› in the edge cell, so the row always states whether
- * more of the diagram exists left or right, and the marker disappears once
- * that edge is reached (nothing is unreachable).
- */
-export function panLine(line, offset, width) {
-    if (width < 1)
-        return '';
-    const w = visibleWidth(line);
-    if (w <= width)
-        return line;
-    const max = w - width;
-    const off = Math.max(0, Math.min(offset, max));
-    const left = off > 0;
-    const right = off < max;
-    const innerWidth = width - (left ? 1 : 0) - (right ? 1 : 0);
-    const body = innerWidth > 0 ? sliceCells(line, off + (left ? 1 : 0), innerWidth) : '';
-    return `${left ? `${DIM}‹${RESET}` : ''}${body}${right ? `${DIM}›${RESET}` : ''}`;
-}
-/** Cells of `line` that fall outside a `width`-wide rectangle. */
-export function rowOverflow(line, width) {
-    return Math.max(0, visibleWidth(line) - width);
-}
+var R=Object.defineProperty;var u=(t,e)=>R(t,"name",{value:e,configurable:!0});import a from"string-width";import{visibleWidth as O}from"@earendil-works/pi-tui";const l="\x1B[",m=`${l}0m`,y=`${l}1m`,E=`${l}2m`,N=`${l}3m`,T=`${l}31m`,v=`${l}32m`,z=`${l}33m`,B=`${l}36m`,D=`${l}90m`,F=`${l}7m`,A=/\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-_]|[\x00-\x08\x0B\x0E-\x1F\x7F-\x9F]/g;function k(t){return typeof t!="string"?"":t.replace(A,"")}u(k,"sanitize");function G(t){return k(t).replace(/\s+/g," ").trim()}u(G,"singleLine");function H(t,e="\u2500"){return t<1?"":e.repeat(t)}u(H,"hline");function P(t,e){const n=a(t);return n>=e?t:t+" ".repeat(e-n)}u(P,"padRight");function Y(t,e){if(e<1)return"";if(a(t)<=e)return t;const n=[...t];let r=0,o="";for(const c of n){const i=a(c);if(r+i+1>e)break;o+=c,r+=i}return o+"\u2026"}u(Y,"truncate");function K(t,e){const n=t.replace(/\n/g," ").replace(/✅/g,"\u2713").replace(/❌/g,"\u2717").replace(new RegExp("\\p{Emoji_Presentation}","gu"),"");if(e<4)return n.slice(0,e);if(a(n)<=e)return n;let o=n;for(;a(o)>e-1&&o.length>0;){const c=o.lastIndexOf(" ",o.length-2);c>e*.4?o=o.slice(0,c):o=o.slice(0,o.length-1)}return o+"\u2026"}u(K,"truncateRow");function C(t,e){let n=0,r="";for(const o of t){const c=a(o);if(n+c>e)break;r+=o,n+=c}return r===""&&t.length>0&&(r=[...t][0]),r}u(C,"sliceByWidth");function V(t,e){if(e<1)return[t];const n=[],r=t.split(`
+`);for(let o=0;o<r.length;o++){const c=r[o];if(c===""){n.push("");continue}const i=c.split(/[ \t]+/).filter(Boolean);let f="";for(let s of i){for(;a(s)>e;){f&&(n.push(f),f="");const p=C(s,e);n.push(p),s=s.slice(p.length)}const g=f?`${f} ${s}`:s;a(g)<=e?f=g:(f&&n.push(f),f=s)}f&&n.push(f)}return n.length>0?n:[""]}u(V,"wrap");function Z(t,e){if(e<1)return[t];const n=t.split(`
+`),r=[];for(const o of n){if(o.length===0){r.push("");continue}let c="",i=0;for(const f of[...o]){const s=a(f);i+s>e?(r.push(c),c=f,i=s):(c+=f,i+=s)}r.push(c)}return r}u(Z,"hardWrap");function j(t,e,n){const r=Math.max(0,Math.floor((e-n)/2));if(r===0)return t;const o=" ".repeat(r);return t.map(c=>c===""?"":o+c)}u(j,"centerHorizontal");function h(t){return O(t)}u(h,"visibleWidth");const b=/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b_[^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-^]/g,$=/\x1b\]8;[^;\x07\x1b]*;([^\x07\x1b]*)(\x07|\x1b\\)/g,w=new Intl.Segmenter(void 0,{granularity:"grapheme"});function I(t){const e=[];let n=0;b.lastIndex=0;for(let r=b.exec(t);r!==null;r=b.exec(t)){for(const o of w.segment(t.slice(n,r.index)))e.push({ansi:!1,text:o.segment,width:h(o.segment)});e.push({ansi:!0,text:r[0]}),n=r.index+r[0].length}for(const r of w.segment(t.slice(n)))e.push({ansi:!1,text:r.segment,width:h(r.segment)});return e}u(I,"displayTokens");function d(t,e,n){if(n<1)return"";const r=Math.max(0,e),o=r+n;let c="",i="",f=!1,s=0;for(const p of I(t)){if(p.ansi){s<r?c+=p.text:(i+=p.text,f=!0);continue}if(s>=o)break;const x=p.width;if(x===0){s>=r&&(i+=p.text);continue}if(s+x<=r){s+=x;continue}if(s<r){i+=" ".repeat(s+x-r),s+=x;continue}if(s+x>o){i+=" ".repeat(o-s),s=o;break}i+=p.text,s+=x}if(i==="")return"";c!==""&&(i=c+i,f=!0);const g=L(i);return f?i+g+m:i}u(d,"sliceCells");function L(t){let e="";$.lastIndex=0;for(let n=$.exec(t);n!==null;n=$.exec(t))e=n[1]===""?"":`\x1B]8;;${n[2]}`;return e}u(L,"closeActiveOsc8");function W(t,e){return e<1?"":h(t)<=e?t:d(t,0,e)}u(W,"clipLine");function q(t,e,n){if(n<1)return"";const r=h(t);if(r<=n)return t;const o=r-n,c=Math.max(0,Math.min(e,o)),i=c>0,f=c<o,s=n-(i?1:0)-(f?1:0),g=s>0?d(t,c+(i?1:0),s):"";return`${i?`${E}\u2039${m}`:""}${g}${f?`${E}\u203A${m}`:""}`}u(q,"panLine");function J(t,e){return Math.max(0,h(t)-e)}u(J,"rowOverflow");export{y as BOLD,B as CYAN,E as DIM,l as ESC,D as GRAY,v as GREEN,N as ITALIC,T as RED,m as RESET,F as REVERSE,z as YELLOW,j as centerHorizontal,W as clipLine,Z as hardWrap,H as hline,P as padRight,q as panLine,J as rowOverflow,k as sanitize,G as singleLine,d as sliceCells,Y as truncate,K as truncateRow,h as visibleWidth,V as wrap};