@north-light/crouter 0.3.318 → 0.3.320

package/dist/clients/inbox/review/frame.js

@@ -1,216 +1 @@
-import stringWidth from 'string-width';
-import { renderMarkdownBlockAware } from '../../../core/termrender/termrender.js';
-import { fenceLanguageFor, isMarkdownFile } from '../../../core/termrender/code-doc.js';
-import { renderInputBuffer } from '../tui/render.js';
-import { BOLD, CYAN, DIM, ESC, RESET, YELLOW, centerHorizontal, clipLine, hline, panLine, sanitize, truncate, visibleWidth } from '../tui/ansi.js';
-import { commentedUnitSet, selectedUnitBounds } from './state.js';
-// ── Rendering (pure) ─────────────────────────────────────────────────────────
-/** Width prose is rendered at for a given terminal width: 2-col left
- *  margin + 2-col gutter before the content, capped for readability. */
-export function renderWidthForCols(cols) {
-    return Math.min(Math.max(20, cols - 6), 120);
-}
-/** The body rectangle a rendered row is painted into: the terminal minus the
- *  4-col gutter prefix. Diagram blocks render at this width (no prose cap),
- *  and every emitted body row is contained within it. */
-export function contentWidthForCols(cols) {
-    return Math.max(20, cols - 4);
-}
-/** Body width left after an optional line-number gutter. */
-export function bodyWidth(cols, gutterW = 0) {
-    return Math.max(1, contentWidthForCols(cols) - (gutterW > 0 ? gutterW + 1 : 0));
-}
-/** The mapped render this surface paints: prose at the readability cap,
- *  diagrams at the full body width. */
-export function renderReviewDoc(content, cols) {
-    return renderMarkdownBlockAware(content, renderWidthForCols(cols), contentWidthForCols(cols));
-}
-/** Body rows as they are actually painted. Vertical-scroll indicators replace
- * their endpoint rows, so content behind one cannot advertise or claim h/l. */
-function paintedBodyRows(doc, scroll, bodyHeight) {
-    const rows = [];
-    for (let i = 0; i < bodyHeight; i++) {
-        const abs = scroll + i;
-        rows.push(abs < doc.lines.length ? { abs, line: doc.lines[abs] } : { abs: null, line: '' });
-    }
-    if (scroll > 0 && rows.length > 0)
-        rows[0] = { abs: null, line: `  ${DIM}↑ ${scroll} more above${RESET}` };
-    const remaining = doc.lines.length - (scroll + bodyHeight);
-    if (remaining > 0 && rows.length > 0)
-        rows[rows.length - 1] = { abs: null, line: `  ${DIM}↓ ${remaining} more below${RESET}` };
-    return rows;
-}
-/** Widest painted row, in display cells, for a body window. */
-export function widestVisibleRow(doc, scroll, bodyHeight) {
-    let widest = 0;
-    for (const row of paintedBodyRows(doc, scroll, bodyHeight))
-        widest = Math.max(widest, visibleWidth(row.line));
-    return widest;
-}
-/** How far the body can pan right, given what is currently on screen. Zero
- *  when nothing visible overflows — which is also what makes h/l contextual:
- *  the keys only pan while an overflowing row is in view. */
-export function maxHScroll(state, doc, cols, rows, gutterW = 0) {
-    const bodyHeight = Math.max(1, rows - reservedRows(state, cols));
-    const maxScroll = Math.max(0, doc.lines.length - bodyHeight);
-    const scroll = Math.max(0, Math.min(state.scroll, maxScroll));
-    return Math.max(0, widestVisibleRow(doc, scroll, bodyHeight) - bodyWidth(cols, gutterW));
-}
-/** Pan the body horizontally, clamped to what is currently reachable. The
- *  stored offset is only ever clamped against the live window, so vertical
- *  scrolling and resize can never leave it pointing past the content. */
-export function panBy(state, delta, doc, cols, rows, gutterW = 0) {
-    const max = maxHScroll(state, doc, cols, rows, gutterW);
-    const next = Math.max(0, Math.min(state.hscroll + delta, max));
-    return next === state.hscroll ? state : { ...state, hscroll: next };
-}
-/** Cells one h/l press pans by — a chunk large enough to cross a diagram in a
- *  few presses, small enough to keep orientation. */
-export const PAN_STEP = 8;
-// Single-hue anchor tint (a dark neutral step below the CYAN gutter bar).
-// termrender's only reset is `\x1b[0m`, so re-arming the background after each
-// reset keeps the tint alive across inner styling. Heading rows carry their
-// own background and won't show the tint — the gutter bar still marks them.
-const TINT_BG = `${ESC}48;5;236m`;
-function tintRow(row, width) {
-    const pad = Math.max(0, width - stringWidth(sanitize(row)));
-    return TINT_BG + row.replaceAll(RESET, RESET + TINT_BG) + ' '.repeat(pad) + RESET;
-}
-/** Reserved (non-body) rows for each mode's fixed header/footer chrome. Kept in
- *  sync with renderReviewFrame so scroll math can clamp before a repaint — the
- *  compose case counts the same hard-wrapped input lines the frame renders. */
-export function reservedRows(state, cols) {
-    const header = 3; // blank, title, divider
-    if (state.mode === 'view')
-        return header + 1;
-    if (state.mode === 'compose') {
-        const c = state.compose;
-        const maxW = Math.min(Math.max(20, cols - 4), 120);
-        const bufLines = c ? renderInputBuffer(c.buffer, c.cursor, Math.max(10, maxW - 2)).length : 1;
-        return header + 3 + bufLines;
-    }
-    if (state.mode === 'list')
-        return header + Math.max(1, state.comments.length) + 2;
-    return header + 9; // help
-}
-export function renderReviewFrame(state, fileLabel, doc, cols, rows, opts) {
-    const maxW = Math.min(Math.max(20, cols - 4), 120);
-    const docW = renderWidthForCols(cols);
-    const header = [
-        '',
-        `  ${BOLD}${CYAN}Review — ${fileLabel}${RESET}  ${DIM}${state.comments.length} comment${state.comments.length === 1 ? '' : 's'}${RESET}`,
-        `  ${DIM}${hline(maxW)}${RESET}`,
-    ];
-    const footer = [];
-    if (state.mode === 'compose' && state.compose) {
-        const c = state.compose;
-        const label = c.anchor.line === c.anchor.endLine ? `L${c.anchor.line}` : `L${c.anchor.line}-${c.anchor.endLine}`;
-        footer.push(`  ${YELLOW}${c.editingId !== null ? 'Edit comment' : 'Comment'} on ${label}:${RESET}`);
-        for (const l of renderInputBuffer(c.buffer, c.cursor, Math.max(10, maxW - 2)))
-            footer.push(`  ${l}`);
-        footer.push('');
-        footer.push(`  ${DIM}enter${RESET} save  ${DIM}^J/⌥⏎${RESET} newline  ${DIM}esc${RESET} cancel`);
-    }
-    else if (state.mode === 'list') {
-        if (state.comments.length === 0) {
-            footer.push(`  ${DIM}(no comments yet — space c to add one)${RESET}`);
-        }
-        else {
-            state.comments.forEach((c, i) => {
-                const loc = c.line === c.endLine ? `L${c.line}` : `L${c.line}-${c.endLine}`;
-                const cursor = i === state.listIndex ? `${CYAN}▸${RESET}` : ' ';
-                const text = truncate(c.comment.replace(/\n/g, ' / '), Math.max(10, maxW - 14));
-                footer.push(`  ${cursor} ${DIM}[${loc}]${RESET} ${text}`);
-            });
-        }
-        footer.push('');
-        footer.push(`  ${DIM}j/k${RESET} move  ${DIM}enter/e${RESET} edit  ${DIM}d${RESET} delete  ${DIM}q/esc${RESET} close`);
-    }
-    else if (state.mode === 'help') {
-        footer.push('  Keys:');
-        footer.push(`  ${DIM}j/k${RESET}         move anchor            ${DIM}shift-j/k${RESET}   extend selection`);
-        footer.push(`  ${DIM}u/d${RESET}         move half a page       ${DIM}h/l${RESET}         pan visible wide diagrams`);
-        footer.push(`  ${DIM}space c${RESET}     compose comment        ${DIM}space l${RESET}     list comments`);
-        footer.push(`  ${DIM}space u${RESET}     undo last comment      ${DIM}space e${RESET}     edit in $EDITOR`);
-        footer.push(`  ${DIM}space s${RESET}     submit review`);
-        footer.push(`  ${DIM}space a${RESET}     open the companion pane`);
-        footer.push(`  ${DIM}space x${RESET}     cancel review`);
-        footer.push(`  ${DIM}?${RESET}           toggle this help       ${DIM}esc${RESET}         close/cancel`);
-    }
-    else {
-        footer.push(`  ${DIM}space c${RESET} · ${DIM}space l${RESET} · ${DIM}space u${RESET} · ${DIM}space e${RESET} · ` +
-            `${DIM}space a${RESET} companion · ${DIM}space s${RESET} submit · ${DIM}space x${RESET} cancel · ` +
-            `${DIM}?${RESET} · ${DIM}esc${RESET}`);
-    }
-    if (opts?.notice !== undefined && footer.length > 0) {
-        footer[footer.length - 1] = `  ${YELLOW}${opts.notice}${RESET}`;
-    }
-    const reserved = header.length + footer.length;
-    const bodyHeight = Math.max(1, rows - reserved);
-    const maxScroll = Math.max(0, doc.lines.length - bodyHeight);
-    const scroll = Math.max(0, Math.min(state.scroll, maxScroll));
-    const gutterW = opts?.lineNumbers === true ? String(doc.lines.length).length : 0;
-    const contentW = bodyWidth(cols, gutterW);
-    // Effective pan: the stored offset, clamped to what this window can reach.
-    // Scrolling into narrow content parks the diagram offset rather than losing
-    // it, so scrolling back restores the same horizontal position.
-    const widest = widestVisibleRow(doc, scroll, bodyHeight);
-    const overflow = Math.max(0, widest - contentW);
-    const hscroll = Math.max(0, Math.min(state.hscroll, overflow));
-    const { lo, hi } = selectedUnitBounds(state);
-    const commented = commentedUnitSet(state);
-    const body = [];
-    for (const source of paintedBodyRows(doc, scroll, bodyHeight)) {
-        if (source.abs === null) {
-            // Indicator/fill rows reserve the same 4-col marker prefix and gutter a
-            // source row does, so the content column never shifts while scrolling.
-            body.push(`  ${' '.repeat(gutterW > 0 ? gutterW + 1 : 0)}${source.line}`);
-            continue;
-        }
-        // Every body row is windowed into the body rectangle: a diagram wider than
-        // the pane pans instead of spilling past the right edge.
-        const row = panLine(source.line, hscroll, contentW);
-        const u = state.rowUnits[source.abs] ?? null;
-        // A row with no span is chrome (the code panel's border), not a source
-        // line — it gets blank gutter width rather than an invented line number.
-        const gutterLine = doc.spans[source.abs]?.[0];
-        const gutter = gutterW > 0
-            ? (gutterLine === undefined ? ' '.repeat(gutterW + 1) : `${DIM}${String(gutterLine).padStart(gutterW)}${RESET} `)
-            : '';
-        // Tint the prose column at minimum, and a wide row across what it occupies.
-        const tintW = Math.min(contentW, Math.max(docW, visibleWidth(row)));
-        if (u !== null && u >= lo && u <= hi)
-            body.push(`  ${CYAN}▌${RESET} ${gutter}${tintRow(row, tintW)}`);
-        else if (u !== null && commented.has(u))
-            body.push(`  ${YELLOW}▎${RESET} ${gutter}${row}`);
-        else
-            body.push(`    ${gutter}${row}`);
-    }
-    while (body.length < bodyHeight)
-        body.push('');
-    // Keep the header, footer, and readable body rows in one stable centered
-    // column. A full-width diagram drops only its own row padding, so it can use
-    // the pane without shifting the surrounding review as it scrolls into view.
-    const readableFrameW = Math.min(cols, Math.max(maxW + 2, docW + 4 + (gutterW > 0 ? gutterW + 1 : 0)));
-    const centeredBody = body.map((line) => {
-        const frameW = visibleWidth(line) > readableFrameW ? cols : readableFrameW;
-        return centerHorizontal([line], cols, frameW)[0] ?? '';
-    });
-    const lines = [
-        ...centerHorizontal(header, cols, readableFrameW),
-        ...centeredBody,
-        ...centerHorizontal(footer, cols, readableFrameW),
-    ];
-    while (lines.length < rows)
-        lines.push('');
-    // The frame is contained by construction: no row may exceed the terminal, or
-    // it wraps and breaks the differ's one-line-per-row model.
-    return lines.slice(0, rows).map((line) => clipLine(line, cols));
-}
-/** How a reviewed file is presented: markdown renders as a document, anything
- * else as a syntax-highlighted source panel. */
-export function docSurface(absFile) {
-    return isMarkdownFile(absFile)
-        ? { doc: 'markdown' }
-        : { doc: 'code', language: fenceLanguageFor(absFile) };
-}
+var q=Object.defineProperty;var $=(e,s)=>q(e,"name",{value:s,configurable:!0});import G from"string-width";import{renderMarkdownBlockAware as J}from"../../../core/termrender/termrender.js";import{fenceLanguageFor as K,isMarkdownFile as V}from"../../../core/termrender/code-doc.js";import{renderInputBuffer as E}from"../tui/render.js";import{BOLD as Q,CYAN as v,DIM as t,ESC as X,RESET as n,YELLOW as W,centerHorizontal as S,clipLine as Z,hline as ee,panLine as ne,sanitize as te,truncate as oe,visibleWidth as R}from"../tui/ansi.js";import{commentedUnitSet as re,selectedUnitBounds as se}from"./state.js";function k(e){return Math.min(Math.max(20,e-6),120)}$(k,"renderWidthForCols");function I(e){return Math.max(20,e-4)}$(I,"contentWidthForCols");function C(e,s=0){return Math.max(1,I(e)-(s>0?s+1:0))}$(C,"bodyWidth");function fe(e,s){return J(e,k(s),I(s))}$(fe,"renderReviewDoc");function F(e,s,i){const o=[];for(let l=0;l<i;l++){const h=s+l;o.push(h<e.lines.length?{abs:h,line:e.lines[h]}:{abs:null,line:""})}s>0&&o.length>0&&(o[0]={abs:null,line:`  ${t}\u2191 ${s} more above${n}`});const a=e.lines.length-(s+i);return a>0&&o.length>0&&(o[o.length-1]={abs:null,line:`  ${t}\u2193 ${a} more below${n}`}),o}$(F,"paintedBodyRows");function T(e,s,i){let o=0;for(const a of F(e,s,i))o=Math.max(o,R(a.line));return o}$(T,"widestVisibleRow");function ce(e,s,i,o,a=0){const l=Math.max(1,o-ae(e,i)),h=Math.max(0,s.lines.length-l),d=Math.max(0,Math.min(e.scroll,h));return Math.max(0,T(s,d,l)-C(i,a))}$(ce,"maxHScroll");function xe(e,s,i,o,a,l=0){const h=ce(e,i,o,a,l),d=Math.max(0,Math.min(e.hscroll+s,h));return d===e.hscroll?e:{...e,hscroll:d}}$(xe,"panBy");const ge=8,A=`${X}48;5;236m`;function ie(e,s){const i=Math.max(0,s-G(te(e)));return A+e.replaceAll(n,n+A)+" ".repeat(i)+n}$(ie,"tintRow");function ae(e,s){if(e.mode==="view")return 4;if(e.mode==="compose"){const o=e.compose,a=Math.min(Math.max(20,s-4),120);return 6+(o?E(o.buffer,o.cursor,Math.max(10,a-2)).length:1)}return e.mode==="list"?3+Math.max(1,e.comments.length)+2:12}$(ae,"reservedRows");function Me(e,s,i,o,a,l){const h=Math.min(Math.max(20,o-4),120),d=k(o),y=["",`  ${Q}${v}Review \u2014 ${s}${n}  ${t}${e.comments.length} comment${e.comments.length===1?"":"s"}${n}`,`  ${t}${ee(h)}${n}`],c=[];if(e.mode==="compose"&&e.compose){const r=e.compose,m=r.anchor.line===r.anchor.endLine?`L${r.anchor.line}`:`L${r.anchor.line}-${r.anchor.endLine}`;c.push(`  ${W}${r.editingId!==null?"Edit comment":"Comment"} on ${m}:${n}`);for(const u of E(r.buffer,r.cursor,Math.max(10,h-2)))c.push(`  ${u}`);c.push(""),c.push(`  ${t}enter${n} save  ${t}^J/\u2325\u23CE${n} newline  ${t}esc${n} cancel`)}else e.mode==="list"?(e.comments.length===0?c.push(`  ${t}(no comments yet \u2014 space c to add one)${n}`):e.comments.forEach((r,m)=>{const u=r.line===r.endLine?`L${r.line}`:`L${r.line}-${r.endLine}`,w=m===e.listIndex?`${v}\u25B8${n}`:" ",x=oe(r.comment.replace(/\n/g," / "),Math.max(10,h-14));c.push(`  ${w} ${t}[${u}]${n} ${x}`)}),c.push(""),c.push(`  ${t}j/k${n} move  ${t}enter/e${n} edit  ${t}d${n} delete  ${t}q/esc${n} close`)):e.mode==="help"?(c.push("  Keys:"),c.push(`  ${t}j/k${n}         move anchor            ${t}shift-j/k${n}   extend selection`),c.push(`  ${t}u/d${n}         move half a page       ${t}h/l${n}         pan visible wide diagrams`),c.push(`  ${t}space c${n}     compose comment        ${t}space l${n}     list comments`),c.push(`  ${t}space u${n}     undo last comment      ${t}space e${n}     edit in $EDITOR`),c.push(`  ${t}space s${n}     submit review`),c.push(`  ${t}space a${n}     open the companion pane`),c.push(`  ${t}space x${n}     cancel review`),c.push(`  ${t}?${n}           toggle this help       ${t}esc${n}         close/cancel`)):c.push(`  ${t}space c${n} \xB7 ${t}space l${n} \xB7 ${t}space u${n} \xB7 ${t}space e${n} \xB7 ${t}space a${n} companion \xB7 ${t}space s${n} submit \xB7 ${t}space x${n} cancel \xB7 ${t}?${n} \xB7 ${t}esc${n}`);l?.notice!==void 0&&c.length>0&&(c[c.length-1]=`  ${W}${l.notice}${n}`);const D=y.length+c.length,g=Math.max(1,a-D),N=Math.max(0,i.lines.length-g),B=Math.max(0,Math.min(e.scroll,N)),p=l?.lineNumbers===!0?String(i.lines.length).length:0,b=C(o,p),j=T(i,B,g),H=Math.max(0,j-b),O=Math.max(0,Math.min(e.hscroll,H)),{lo:U,hi:z}=se(e),P=re(e),f=[];for(const r of F(i,B,g)){if(r.abs===null){f.push(`  ${" ".repeat(p>0?p+1:0)}${r.line}`);continue}const m=ne(r.line,O,b),u=e.rowUnits[r.abs]??null,w=i.spans[r.abs]?.[0],x=p>0?w===void 0?" ".repeat(p+1):`${t}${String(w).padStart(p)}${n} `:"",_=Math.min(b,Math.max(d,R(m)));u!==null&&u>=U&&u<=z?f.push(`  ${v}\u258C${n} ${x}${ie(m,_)}`):u!==null&&P.has(u)?f.push(`  ${W}\u258E${n} ${x}${m}`):f.push(`    ${x}${m}`)}for(;f.length<g;)f.push("");const M=Math.min(o,Math.max(h+2,d+4+(p>0?p+1:0))),Y=f.map(r=>{const m=R(r)>M?o:M;return S([r],o,m)[0]??""}),L=[...S(y,o,M),...Y,...S(c,o,M)];for(;L.length<a;)L.push("");return L.slice(0,a).map(r=>Z(r,o))}$(Me,"renderReviewFrame");function we(e){return V(e)?{doc:"markdown"}:{doc:"code",language:K(e)}}$(we,"docSurface");export{ge as PAN_STEP,C as bodyWidth,I as contentWidthForCols,we as docSurface,ce as maxHScroll,xe as panBy,fe as renderReviewDoc,Me as renderReviewFrame,k as renderWidthForCols,ae as reservedRows,T as widestVisibleRow};

package/dist/clients/inbox/review/keys.js

@@ -1,123 +1 @@
-import { Key, decodeKittyPrintable, matchesKey, parseKey } from '@earendil-works/pi-tui';
-import { normalizeShiftedMeta } from '../../../core/keybindings/index.js';
-/** Return text that compose mode inserts. Semantic textual commands deliberately
- * retain their payload so compose can preserve the old branch order. */
-export function reviewKeyText(key) {
-    switch (key.type) {
-        case 'moveUnit':
-        case 'extendUnit':
-        case 'leader':
-        case 'help':
-        case 'listEdit':
-        case 'printable':
-        case 'paste':
-            return key.text;
-        case 'scrollPage':
-        case 'pan':
-        case 'cancel':
-            return key.text;
-        default:
-            return undefined;
-    }
-}
-/** Match one complete pi-tui input chunk. pi-tui owns ESC/meta disambiguation;
- * this function has neither terminal state nor a fallback raw-sequence parser. */
-export function matchReviewKey(data) {
-    const normalized = normalizeShiftedMeta(data);
-    // Compose-only chords precede their unmodified forms. The surface applies
-    // these only while composing, preserving the terminal-review mode ladder.
-    if (matchesKey(normalized, Key.ctrl('j')) || matchesKey(normalized, Key.alt('enter')))
-        return { type: 'composeNewline' };
-    if (matchesKey(normalized, Key.alt('backspace')) || matchesKey(normalized, Key.ctrl('w')))
-        return { type: 'composeWordBackspace' };
-    if (matchesKey(normalized, Key.backspace))
-        return { type: 'composeBackspace' };
-    if (matchesKey(normalized, Key.delete))
-        return { type: 'composeDelete' };
-    if (matchesKey(normalized, Key.alt('left')) || matchesKey(normalized, Key.ctrl('left')) || matchesKey(normalized, Key.super('left')) || matchesKey(normalized, Key.alt('b'))) {
-        return { type: 'composeMove', direction: 'wordLeft' };
-    }
-    if (matchesKey(normalized, Key.alt('right')) || matchesKey(normalized, Key.ctrl('right')) || matchesKey(normalized, Key.super('right')) || matchesKey(normalized, Key.alt('f'))) {
-        return { type: 'composeMove', direction: 'wordRight' };
-    }
-    if (matchesKey(normalized, Key.home) || matchesKey(normalized, Key.ctrl('a')))
-        return { type: 'composeHome' };
-    if (matchesKey(normalized, Key.end) || matchesKey(normalized, Key.ctrl('e')))
-        return { type: 'composeEnd' };
-    if (matchesKey(normalized, Key.shift('tab')))
-        return { type: 'tab', reverse: true };
-    if (matchesKey(normalized, Key.tab))
-        return { type: 'tab', reverse: false };
-    if (matchesKey(normalized, Key.enter))
-        return { type: 'confirm' };
-    if (matchesKey(normalized, Key.escape))
-        return { type: 'cancel' };
-    // Arrow keys remain distinct because each mode gives them its own meaning.
-    if (matchesKey(normalized, Key.up))
-        return { type: 'arrow', direction: 'up' };
-    if (matchesKey(normalized, Key.down))
-        return { type: 'arrow', direction: 'down' };
-    if (matchesKey(normalized, Key.left))
-        return { type: 'arrow', direction: 'left' };
-    if (matchesKey(normalized, Key.right))
-        return { type: 'arrow', direction: 'right' };
-    if (matchesKey(normalized, Key.pageUp))
-        return { type: 'scrollPage', delta: -1 };
-    if (matchesKey(normalized, Key.pageDown))
-        return { type: 'scrollPage', delta: 1 };
-    if (matchesKey(normalized, Key.shift('j')))
-        return { type: 'extendUnit', delta: 1, text: 'J' };
-    if (matchesKey(normalized, Key.shift('k')))
-        return { type: 'extendUnit', delta: -1, text: 'K' };
-    if (matchesKey(normalized, 'j'))
-        return { type: 'moveUnit', delta: 1, text: 'j' };
-    if (matchesKey(normalized, 'k'))
-        return { type: 'moveUnit', delta: -1, text: 'k' };
-    if (matchesKey(normalized, 'u'))
-        return { type: 'scrollPage', delta: -1, text: 'u' };
-    if (matchesKey(normalized, 'd'))
-        return { type: 'scrollPage', delta: 1, text: 'd' };
-    if (matchesKey(normalized, 'h'))
-        return { type: 'pan', delta: -1, text: 'h' };
-    if (matchesKey(normalized, 'l'))
-        return { type: 'pan', delta: 1, text: 'l' };
-    if (matchesKey(normalized, Key.space))
-        return { type: 'leader', text: ' ' };
-    if (matchesKey(normalized, Key.question))
-        return { type: 'help', text: '?' };
-    if (matchesKey(normalized, 'e'))
-        return { type: 'listEdit', text: 'e' };
-    if (matchesKey(normalized, 'q'))
-        return { type: 'cancel', text: 'q' };
-    const parsed = parseKey(normalized);
-    const text = printableText(data, parsed);
-    // Kitty reports question mark as Shift+Slash, so the unmodified-key matcher
-    // above cannot recognize it. Keep its text for compose through reviewKeyText.
-    if (text === '?')
-        return { type: 'help', text };
-    if (text !== undefined)
-        return { type: 'printable', text };
-    // A recognized but unhandled modified key (notably Alt+I) is not text or a
-    // paste. Its viewer-level owner may already have consumed it.
-    if (parsed !== undefined)
-        return null;
-    if ([...data].length > 1)
-        return { type: 'paste', text: data };
-    return null;
-}
-function printableText(data, parsed) {
-    const kitty = decodeKittyPrintable(data);
-    if (kitty !== undefined && isPrintable(kitty))
-        return kitty;
-    if (parsed !== undefined) {
-        const shifted = parsed.startsWith('shift+');
-        const candidate = shifted ? parsed.slice('shift+'.length) : parsed;
-        if ([...candidate].length === 1 && isPrintable(candidate)) {
-            return shifted && /^[a-z]$/.test(candidate) ? candidate.toUpperCase() : candidate;
-        }
-    }
-    return [...data].length === 1 && isPrintable(data) ? data : undefined;
-}
-function isPrintable(text) {
-    return !/\p{C}/u.test(text);
-}
+var f=Object.defineProperty;var c=(n,e)=>f(n,"name",{value:e,configurable:!0});import{Key as r,decodeKittyPrintable as o,matchesKey as t,parseKey as u}from"@earendil-works/pi-tui";import{normalizeShiftedMeta as s}from"../../../core/keybindings/index.js";function m(n){switch(n.type){case"moveUnit":case"extendUnit":case"leader":case"help":case"listEdit":case"printable":case"paste":return n.text;case"scrollPage":case"pan":case"cancel":return n.text;default:return}}c(m,"reviewKeyText");function g(n){const e=s(n);if(t(e,r.ctrl("j"))||t(e,r.alt("enter")))return{type:"composeNewline"};if(t(e,r.alt("backspace"))||t(e,r.ctrl("w")))return{type:"composeWordBackspace"};if(t(e,r.backspace))return{type:"composeBackspace"};if(t(e,r.delete))return{type:"composeDelete"};if(t(e,r.alt("left"))||t(e,r.ctrl("left"))||t(e,r.super("left"))||t(e,r.alt("b")))return{type:"composeMove",direction:"wordLeft"};if(t(e,r.alt("right"))||t(e,r.ctrl("right"))||t(e,r.super("right"))||t(e,r.alt("f")))return{type:"composeMove",direction:"wordRight"};if(t(e,r.home)||t(e,r.ctrl("a")))return{type:"composeHome"};if(t(e,r.end)||t(e,r.ctrl("e")))return{type:"composeEnd"};if(t(e,r.shift("tab")))return{type:"tab",reverse:!0};if(t(e,r.tab))return{type:"tab",reverse:!1};if(t(e,r.enter))return{type:"confirm"};if(t(e,r.escape))return{type:"cancel"};if(t(e,r.up))return{type:"arrow",direction:"up"};if(t(e,r.down))return{type:"arrow",direction:"down"};if(t(e,r.left))return{type:"arrow",direction:"left"};if(t(e,r.right))return{type:"arrow",direction:"right"};if(t(e,r.pageUp))return{type:"scrollPage",delta:-1};if(t(e,r.pageDown))return{type:"scrollPage",delta:1};if(t(e,r.shift("j")))return{type:"extendUnit",delta:1,text:"J"};if(t(e,r.shift("k")))return{type:"extendUnit",delta:-1,text:"K"};if(t(e,"j"))return{type:"moveUnit",delta:1,text:"j"};if(t(e,"k"))return{type:"moveUnit",delta:-1,text:"k"};if(t(e,"u"))return{type:"scrollPage",delta:-1,text:"u"};if(t(e,"d"))return{type:"scrollPage",delta:1,text:"d"};if(t(e,"h"))return{type:"pan",delta:-1,text:"h"};if(t(e,"l"))return{type:"pan",delta:1,text:"l"};if(t(e,r.space))return{type:"leader",text:" "};if(t(e,r.question))return{type:"help",text:"?"};if(t(e,"e"))return{type:"listEdit",text:"e"};if(t(e,"q"))return{type:"cancel",text:"q"};const p=u(e),i=d(n,p);return i==="?"?{type:"help",text:i}:i!==void 0?{type:"printable",text:i}:p!==void 0?null:[...n].length>1?{type:"paste",text:n}:null}c(g,"matchReviewKey");function d(n,e){const p=o(n);if(p!==void 0&&a(p))return p;if(e!==void 0){const i=e.startsWith("shift+"),l=i?e.slice(6):e;if([...l].length===1&&a(l))return i&&/^[a-z]$/.test(l)?l.toUpperCase():l}return[...n].length===1&&a(n)?n:void 0}c(d,"printableText");function a(n){return!new RegExp("\\p{C}","u").test(n)}c(a,"isPrintable");export{g as matchReviewKey,m as reviewKeyText};

package/dist/clients/inbox/review/launch.js

@@ -1,151 +1 @@
-import { basename } from 'node:path';
-import { getPaneOption, openNodeWindow, paneLocation, selectWindow, shellQuote, viewerSplitEnv, } from '../../../core/runtime/placement-tmux.js';
-import { ReviewDocumentSurface } from './document-surface.js';
-import { openLiveSource } from './live-source.js';
-import { createReviewClient, ReviewTerminalError, terminalRefusalNotice, } from './review-client.js';
-const ATTACH_REVIEW_ENV = 'CRTR_ATTACH_REVIEW_ID';
-/** Open a dedicated viewer window for a review without replacing the caller's
- *  conversation window. The fresh viewer consumes the review id at startup. */
-export function openReviewWindow(host, review) {
-    if (host.capabilities.remote) {
-        host.notice('The review is unavailable in a remote attach — the file and companion live on the host.');
-        return false;
-    }
-    const callerPane = host.capabilities.selfPane;
-    if (callerPane === undefined || callerPane === '') {
-        host.notice('Opening a review needs a local viewer in tmux.');
-        return false;
-    }
-    const location = paneLocation(callerPane);
-    const nodeId = getPaneOption(callerPane, '@crtr_node');
-    if (location === null || nodeId === undefined || nodeId === '') {
-        host.notice('Could not resolve the current viewer for this review.');
-        return false;
-    }
-    const opened = openNodeWindow({
-        session: location.session,
-        name: `review:${basename(review.file)}`,
-        cwd: review.cwd,
-        env: { ...viewerSplitEnv(), [ATTACH_REVIEW_ENV]: review.reviewId },
-        command: `crtr surface attach to ${shellQuote(nodeId)}`,
-    });
-    if (opened === null) {
-        host.notice('tmux could not open the review window.');
-        return false;
-    }
-    selectWindow(location.session, opened.window);
-    return true;
-}
-/** Consume the review id handed to a dedicated attach viewer. */
-export function takeStartupReviewId() {
-    const reviewId = process.env[ATTACH_REVIEW_ENV];
-    delete process.env[ATTACH_REVIEW_ENV];
-    return reviewId === undefined || reviewId === '' ? undefined : reviewId;
-}
-/** Resolve and mount the review seeded into a dedicated viewer window. */
-export async function openReviewSurfaceById(host, reviewId) {
-    try {
-        const review = await createReviewClient().byId(reviewId);
-        await openReviewSurface(host, { review });
-    }
-    catch (error) {
-        host.notice(error instanceof ReviewTerminalError
-            ? terminalRefusalNotice(error)
-            : `couldn't open review: ${describeError(error)}`);
-    }
-}
-/** Mount the review document inside its dedicated viewer window. */
-export async function openReviewSurface(host, opts) {
-    const review = opts.review;
-    let source;
-    try {
-        source = openLiveSource(review.file);
-    }
-    catch (error) {
-        host.notice(`couldn't open ${review.file}: ${describeError(error)}`);
-        return;
-    }
-    let terminalConflict = false;
-    const reviewClient = createReviewClient({
-        onTerminalConflict: (notice) => {
-            terminalConflict = true;
-            finish(notice);
-        },
-    });
-    const comments = reviewClient.comments(review.reviewId);
-    let handle;
-    let submitting = false;
-    let canceling = false;
-    const surface = new ReviewDocumentSurface({
-        review,
-        source,
-        comments,
-        callerPane: host.capabilities.selfPane,
-        services: {
-            notice: (text, opts) => host.notice(text, opts),
-            suspendForChild: () => host.suspendForChild(),
-            requestClose: () => handle?.close(),
-            submit: () => { void submit(); },
-            cancel: () => { void cancel(); },
-        },
-    });
-    await surface.open();
-    handle = host.mount(surface);
-    surface.setHandle(handle);
-    // The conversation is opened only once the document is standing, so a tmux
-    // refusal costs the person a notice rather than the review. The tmux calls
-    // are blocking subprocesses, so they are deferred past the render tick the
-    // mount just scheduled — a macrotask lands after it, a microtask would not.
-    setImmediate(() => { surface.openCompanion(); });
-    async function submit() {
-        if (submitting)
-            return;
-        submitting = true;
-        try {
-            const disposition = await reviewClient.submit(review.reviewId);
-            if (disposition.outcome === 'approved') {
-                finish(approvalNotice(disposition));
-                return;
-            }
-            // The companion is mid-edit. The review is off the human's hands either
-            // way: the daemon approves the document as it reads once the companion
-            // stops, and the origin has already been told the approval is coming.
-            // Sticky, because the wait outlives a three-second notice — the review's
-            // cockpit row below the editor carries it from there.
-            finish('Review submitted before the companion finished — the agent resumes when the review completes.', { sticky: true });
-        }
-        catch (error) {
-            if (terminalConflict)
-                return;
-            submitting = false;
-            host.notice(`couldn't submit review: ${describeError(error)}`);
-        }
-    }
-    function finish(notice, opts) {
-        surface.teardown(notice, opts);
-    }
-    async function cancel() {
-        if (canceling)
-            return;
-        canceling = true;
-        try {
-            await reviewClient.cancel(review.reviewId, 'canceled from the review surface');
-            finish('Review canceled.');
-        }
-        catch (error) {
-            if (terminalConflict)
-                return;
-            // Nothing moved: the review is still open and both panes stand.
-            canceling = false;
-            host.notice(`couldn't cancel review: ${describeError(error)}`);
-        }
-    }
-}
-function approvalNotice(result) {
-    return result.changed
-        ? `Approved — the document changed during review. Result: ${result.resultPath}`
-        : `Approved — the document was not modified. Result: ${result.resultPath}`;
-}
-function describeError(error) {
-    return error instanceof Error ? error.message : String(error);
-}
+var I=Object.defineProperty;var t=(e,r)=>I(e,"name",{value:r,configurable:!0});import{basename as C}from"node:path";import{getPaneOption as y,openNodeWindow as g,paneLocation as E,selectWindow as $,shellQuote as T,viewerSplitEnv as P}from"../../../core/runtime/placement-tmux.js";import{ReviewDocumentSurface as S}from"./document-surface.js";import{openLiveSource as x}from"./live-source.js";import{createReviewClient as v,ReviewTerminalError as A,terminalRefusalNotice as _}from"./review-client.js";const p="CRTR_ATTACH_REVIEW_ID";function O(e,r){if(e.capabilities.remote)return e.notice("The review is unavailable in a remote attach \u2014 the file and companion live on the host."),!1;const n=e.capabilities.selfPane;if(n===void 0||n==="")return e.notice("Opening a review needs a local viewer in tmux."),!1;const c=E(n),o=y(n,"@crtr_node");if(c===null||o===void 0||o==="")return e.notice("Could not resolve the current viewer for this review."),!1;const a=g({session:c.session,name:`review:${C(r.file)}`,cwd:r.cwd,env:{...P(),[p]:r.reviewId},command:`crtr surface attach to ${T(o)}`});return a===null?(e.notice("tmux could not open the review window."),!1):($(c.session,a.window),!0)}t(O,"openReviewWindow");function q(){const e=process.env[p];return delete process.env[p],e===void 0||e===""?void 0:e}t(q,"takeStartupReviewId");async function B(e,r){try{const n=await v().byId(r);await W(e,{review:n})}catch(n){e.notice(n instanceof A?_(n):`couldn't open review: ${u(n)}`)}}t(B,"openReviewSurfaceById");async function W(e,r){const n=r.review;let c;try{c=x(n.file)}catch(i){e.notice(`couldn't open ${n.file}: ${u(i)}`);return}let o=!1;const a=v({onTerminalConflict:t(i=>{o=!0,l(i)},"onTerminalConflict")}),h=a.comments(n.reviewId);let d,f=!1,w=!1;const s=new S({review:n,source:c,comments:h,callerPane:e.capabilities.selfPane,services:{notice:t((i,m)=>e.notice(i,m),"notice"),suspendForChild:t(()=>e.suspendForChild(),"suspendForChild"),requestClose:t(()=>d?.close(),"requestClose"),submit:t(()=>{R()},"submit"),cancel:t(()=>{b()},"cancel")}});await s.open(),d=e.mount(s),s.setHandle(d),setImmediate(()=>{s.openCompanion()});async function R(){if(!f){f=!0;try{const i=await a.submit(n.reviewId);if(i.outcome==="approved"){l(N(i));return}l("Review submitted before the companion finished \u2014 the agent resumes when the review completes.",{sticky:!0})}catch(i){if(o)return;f=!1,e.notice(`couldn't submit review: ${u(i)}`)}}}t(R,"submit");function l(i,m){s.teardown(i,m)}t(l,"finish");async function b(){if(!w){w=!0;try{await a.cancel(n.reviewId,"canceled from the review surface"),l("Review canceled.")}catch(i){if(o)return;w=!1,e.notice(`couldn't cancel review: ${u(i)}`)}}}t(b,"cancel")}t(W,"openReviewSurface");function N(e){return e.changed?`Approved \u2014 the document changed during review. Result: ${e.resultPath}`:`Approved \u2014 the document was not modified. Result: ${e.resultPath}`}t(N,"approvalNotice");function u(e){return e instanceof Error?e.message:String(e)}t(u,"describeError");export{W as openReviewSurface,B as openReviewSurfaceById,O as openReviewWindow,q as takeStartupReviewId};