@minko-ai/minko 0.1.0 → 0.1.1

package/dist/ui/mascotData.js

@@ -0,0 +1,96 @@
+// Generated by scripts/build-mascot.py — do not edit by hand.
+// Pixel mascot: 16x16 pixels, drawn with half blocks.
+export const MASCOT_WIDTH = 16;
+export const MASCOT_HEIGHT = 16;
+export const MASCOT_FRAMES = [
+    [
+        [null, null, null, null, '#9a88dc', '#b9aaf0', '#9a88dc', null, null, null, null, null, null, null, null, null],
+        [null, null, null, '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, '#9a88dc', '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#9a88dc', '#9a88dc', null, null, null, '#cfc4e7', null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null],
+        [null, '#9a88dc', '#9a88dc', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', null, null, null],
+        [null, '#171b34', '#9a88dc', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#fef6e6', null, null, null],
+        [null, null, '#b9aaf0', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#7ff7ba', '#171b34', '#cfc4e7', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', null, null, null],
+        [null, null, '#cfc4e7', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', null],
+        [null, null, null, '#fef6e6', '#fef6e6', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null],
+        [null, null, '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#cfc4e7', null, null],
+        [null, null, '#fef6e6', '#9a88dc', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null, null],
+        [null, null, '#9a88dc', null, '#cfc4e7', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#9a88dc', null, null, null, null],
+        [null, null, null, null, null, '#fef6e6', '#b9aaf0', null, '#9a88dc', '#fef6e6', '#cfc4e7', null, null, null, null, null],
+    ],
+    [
+        [null, null, null, null, '#9a88dc', '#b9aaf0', '#9a88dc', null, null, null, null, null, null, null, null, null],
+        [null, null, null, '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, '#9a88dc', '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#9a88dc', '#9a88dc', null, null, null, '#cfc4e7', null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null],
+        [null, '#9a88dc', '#9a88dc', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', null, null, null],
+        [null, '#171b34', '#9a88dc', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#fef6e6', null, null, null],
+        [null, null, '#b9aaf0', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#fef6e6', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', null, null, null],
+        [null, null, '#cfc4e7', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', null],
+        [null, null, null, '#fef6e6', '#fef6e6', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null],
+        [null, null, '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#cfc4e7', null, null],
+        [null, null, '#fef6e6', '#9a88dc', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null, null],
+        [null, null, '#9a88dc', null, '#cfc4e7', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#9a88dc', null, null, null, null],
+        [null, null, null, null, null, '#fef6e6', '#b9aaf0', null, '#9a88dc', '#fef6e6', '#cfc4e7', null, null, null, null, null],
+    ],
+    [
+        [null, null, null, null, '#9a88dc', '#b9aaf0', '#9a88dc', null, null, null, null, null, null, null, null, null],
+        [null, null, null, '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, '#9a88dc', '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#9a88dc', '#9a88dc', null, null, null, '#cfc4e7', null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null],
+        [null, '#9a88dc', '#9a88dc', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', null, null, null],
+        [null, '#171b34', '#9a88dc', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#fef6e6', null, null, null],
+        [null, null, '#b9aaf0', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#7ff7ba', '#171b34', '#cfc4e7', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', null, null, null],
+        [null, null, '#cfc4e7', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', null],
+        [null, null, null, '#fef6e6', '#fef6e6', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null],
+        [null, null, '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#cfc4e7', null, null],
+        [null, null, '#fef6e6', '#9a88dc', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null, null],
+        [null, null, '#9a88dc', null, '#cfc4e7', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#9a88dc', null, null, null, null],
+        [null, null, null, null, null, '#fef6e6', '#b9aaf0', null, '#9a88dc', '#fef6e6', '#cfc4e7', null, null, null, null, null],
+    ],
+    [
+        [null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, null, null, '#9a88dc', '#b9aaf0', '#9a88dc', null, null, null, null, null, null, null, null, null],
+        [null, null, null, '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, '#9a88dc', '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#9a88dc', '#9a88dc', null, null, null, '#cfc4e7', null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null],
+        [null, '#9a88dc', '#9a88dc', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', null, null, null],
+        [null, '#171b34', '#9a88dc', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#fef6e6', null, null, null],
+        [null, null, '#b9aaf0', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#7ff7ba', '#171b34', '#cfc4e7', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', null, null, null],
+        [null, null, '#cfc4e7', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', null],
+        [null, null, null, '#fef6e6', '#fef6e6', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null],
+        [null, null, '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#cfc4e7', null, null],
+        [null, null, '#fef6e6', '#9a88dc', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null, null],
+        [null, null, '#9a88dc', null, '#cfc4e7', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#9a88dc', null, null, null, null],
+    ],
+    [
+        [null, null, null, null, '#9a88dc', '#b9aaf0', '#9a88dc', null, null, null, null, null, null, null, null, null],
+        [null, null, null, '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, null, '#9a88dc', '#b9aaf0', '#b9aaf0', null, null, null, null, null, null, null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#9a88dc', '#9a88dc', null, null, null, '#cfc4e7', null, null, null, null, null],
+        [null, '#9a88dc', '#b9aaf0', '#b9aaf0', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null],
+        [null, '#9a88dc', '#9a88dc', '#b9aaf0', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', null, null, null],
+        [null, '#171b34', '#9a88dc', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#fef6e6', null, null, null],
+        [null, null, '#b9aaf0', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#7ff7ba', '#171b34', '#cfc4e7', '#9a88dc', null, null],
+        [null, null, '#fef6e6', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#171b34', '#7ff7ba', '#171b34', '#171b34', '#fef6e6', null, null, null],
+        [null, null, '#cfc4e7', '#cfc4e7', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#171b34', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', null],
+        [null, null, null, '#fef6e6', '#fef6e6', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null],
+        [null, null, '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#cfc4e7', null, null],
+        [null, null, '#fef6e6', '#9a88dc', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#fef6e6', '#cfc4e7', null, null, null, null],
+        [null, null, '#9a88dc', null, '#cfc4e7', '#fef6e6', '#fef6e6', '#cfc4e7', '#fef6e6', '#fef6e6', '#fef6e6', '#9a88dc', null, null, null, null],
+        [null, null, null, null, null, '#fef6e6', '#b9aaf0', null, '#9a88dc', '#fef6e6', '#cfc4e7', null, null, null, null, null],
+    ]
+];

package/dist/ui/md.js

@@ -0,0 +1,183 @@
+import { visibleWidth, wrapText } from "./ansi.js";
+/**
+ * Streams model text to the terminal.
+ *
+ * Formatting happens line by line: fenced code gets a violet gutter, everything
+ * else is printed as-is while it streams (never re-rendered, so nothing flickers).
+ */
+export class StreamRenderer {
+    painter;
+    sink;
+    pending = '';
+    midLine = false;
+    inFence = false;
+    fenceLang = '';
+    fenceWidth = 0;
+    width;
+    indent;
+    constructor(painter, sink, options = {}) {
+        this.painter = painter;
+        this.sink = sink;
+        this.width = options.width ?? 0;
+        this.indent = options.indent ?? '  ';
+    }
+    push(chunk) {
+        this.pending += chunk.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+        this.drain(false);
+    }
+    finish() {
+        this.drain(true);
+        if (this.midLine) {
+            this.sink('\n');
+            this.midLine = false;
+        }
+        if (this.inFence) {
+            this.closeFence();
+        }
+    }
+    drain(final) {
+        for (;;) {
+            const index = this.pending.indexOf('\n');
+            if (index >= 0) {
+                const line = this.pending.slice(0, index);
+                this.pending = this.pending.slice(index + 1);
+                this.emitLine(line, true);
+                continue;
+            }
+            if (final && this.pending.length > 0) {
+                const line = this.pending;
+                this.pending = '';
+                this.emitLine(line, true);
+                continue;
+            }
+            // Long single line: show it rather than waiting for a newline.
+            if (this.pending.length > 160) {
+                const parts = this.width > 0 ? wrapText(this.pending, this.width) : [this.pending];
+                this.sink(parts.join('\n' + this.indent));
+                this.pending = '';
+                this.midLine = true;
+            }
+            return;
+        }
+    }
+    emitLine(line, newline) {
+        if (!this.midLine && this.fenceMarker(line)) {
+            if (this.inFence) {
+                this.closeFence();
+            }
+            else {
+                this.openFence(line.trim().slice(3).trim());
+            }
+            this.midLine = false;
+            return;
+        }
+        if (!this.midLine && this.inFence) {
+            this.sink(this.codeLine(line) + (newline ? '\n' : ''));
+            this.midLine = !newline;
+            return;
+        }
+        const parts = this.width > 0 ? wrapText(line, this.width) : [line];
+        const formatted = parts.map((part, index) => index === 0
+            ? this.formatLine(part)
+            : renderInline(this.painter, part));
+        this.sink(formatted.join('\n' + this.indent) + (newline ? '\n' : ''));
+        this.midLine = !newline;
+    }
+    fenceMarker(line) {
+        return line.trimStart().startsWith('```');
+    }
+    /** Headings, bullets and inline markup for a finished line. */
+    formatLine(line) {
+        const heading = /^(#{1,6})\s+(.*)$/.exec(line);
+        if (heading) {
+            return this.painter.bold(this.painter.soft(heading[2]));
+        }
+        const bullet = /^(\s*)[-*+]\s+(.*)$/.exec(line);
+        if (bullet) {
+            return bullet[1] + this.painter.primary('• ') + renderInline(this.painter, bullet[2]);
+        }
+        return renderInline(this.painter, line);
+    }
+    /** Code lines sit on a soft violet band when colour is available. */
+    codeLine(line) {
+        if (!this.painter.enabled || this.width <= 0) {
+            return this.painter.fg('#8f7fb8', '  │ ') + line;
+        }
+        const inner = '  ' + line;
+        const padding = ' '.repeat(Math.max(0, this.width + 2 - visibleWidth(inner)));
+        return this.painter.bg('#241d33', this.painter.fg('#ded7ef', inner + padding));
+    }
+    openFence(lang) {
+        this.inFence = true;
+        this.fenceLang = lang;
+        if (!this.painter.enabled || this.width <= 0) {
+            this.fenceWidth = Math.max(24, Math.min(visibleWidth(lang) + 16, 64));
+            this.sink(this.painter.fg('#8f7fb8', '  ╭─ ' + (lang || '代码')) + '\n');
+            return;
+        }
+        const label = (lang.length > 0 ? ' ' + lang : ' 代码') + ' ';
+        const band = label + ' '.repeat(Math.max(0, this.width + 2 - visibleWidth(label)));
+        this.sink(this.painter.bg('#241d33', this.painter.soft(band)) + '\n');
+    }
+    closeFence() {
+        this.inFence = false;
+        if (!this.painter.enabled || this.width <= 0) {
+            this.sink(this.painter.fg('#8f7fb8', '  ╰' + '─'.repeat(Math.max(2, this.fenceWidth - 2))) + '\n');
+            return;
+        }
+        this.sink(this.painter.bg('#241d33', ' '.repeat(this.width + 2)) + '\n');
+    }
+}
+/** One-off markdown rendering for help text and tool output. */
+export function renderInline(painter, line) {
+    let text = line;
+    text = text.replace(/`([^`]+)`/g, (_all, code) => painter.fg('#d8b4fe', code));
+    text = text.replace(/\*\*([^*]+)\*\*/g, (_all, bold) => painter.bold(bold));
+    text = text.replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, (_all, pre, em) => pre + painter.italic(em));
+    text = text.replace(/\[([^\]]+)\]\((https?:[^)]+)\)/g, (_all, label, url) => painter.primary(label) + painter.dimmed(' ' + url));
+    return text;
+}
+export function renderMarkdown(painter, source) {
+    const out = [];
+    let fence = false;
+    let lang = '';
+    for (const line of source.replace(/\r\n/g, '\n').split('\n')) {
+        if (line.trimStart().startsWith('```')) {
+            if (fence) {
+                out.push(painter.fg('#8f7fb8', '  ╰' + '─'.repeat(40)));
+                fence = false;
+                lang = '';
+            }
+            else {
+                fence = true;
+                lang = line.trim().slice(3).trim();
+                out.push(painter.fg('#8f7fb8', '  ╭─ ' + (lang || '代码') + ' ' + '─'.repeat(30)));
+            }
+            continue;
+        }
+        if (fence) {
+            out.push(painter.fg('#8f7fb8', '  │ ') + line);
+            continue;
+        }
+        const heading = /^(#{1,4})\s+(.*)$/.exec(line);
+        if (heading) {
+            out.push(painter.soft(painter.bold(heading[2])));
+            continue;
+        }
+        if (/^\s*(---|\*\*\*)\s*$/.test(line)) {
+            out.push(painter.dimmed('─'.repeat(40)));
+            continue;
+        }
+        const bullet = /^(\s*)[-*+]\s+(.*)$/.exec(line);
+        if (bullet) {
+            out.push(bullet[1] + painter.primary('• ') + renderInline(painter, bullet[2]));
+            continue;
+        }
+        if (line.startsWith('> ')) {
+            out.push(painter.fg('#8f7fb8', '│ ') + painter.dim(renderInline(painter, line.slice(2))));
+            continue;
+        }
+        out.push(renderInline(painter, line));
+    }
+    return out.join('\n');
+}

package/dist/ui/screen.js

@@ -0,0 +1,49 @@
+/**
+ * Full-screen terminal control: alternate buffer, raw keys, mouse wheel and
+ * absolute-positioned redraws.
+ */
+export class Screen {
+    entered = false;
+    enter() {
+        if (this.entered) {
+            return;
+        }
+        this.entered = true;
+        // 1000: buttons + wheel, 1002: button-motion (required for drag selection),
+        // 1006: SGR coordinates. Without 1002 no drag events ever arrive.
+        process.stdout.write('\x1b[?1049h\x1b[?25l\x1b[?2004h\x1b[?1000h\x1b[?1002h\x1b[?1006h');
+    }
+    leave() {
+        if (!this.entered) {
+            return;
+        }
+        this.entered = false;
+        process.stdout.write('\x1b[?2004l\x1b[?1006l\x1b[?1002l\x1b[?1000l\x1b[?25h\x1b[?1049l');
+    }
+    get rows() {
+        const rows = process.stdout.rows;
+        return typeof rows === 'number' && rows >= 8 ? rows : 30;
+    }
+    get columns() {
+        const columns = process.stdout.columns;
+        return typeof columns === 'number' && columns >= 20 ? columns : 100;
+    }
+    draw(frame, cursorRow, cursorColumn) {
+        if (!this.entered) {
+            return;
+        }
+        const rows = this.rows;
+        let out = '';
+        for (let index = 0; index < rows; index += 1) {
+            out += '\x1b[' + (index + 1) + ';1H\x1b[2K' + (frame[index] ?? '');
+        }
+        out += '\x1b[' + cursorRow + ';' + cursorColumn + 'H\x1b[?25h';
+        process.stdout.write(out);
+    }
+    hideCursor() {
+        process.stdout.write('\x1b[?25l');
+    }
+    showCursor() {
+        process.stdout.write('\x1b[?25h');
+    }
+}

package/dist/ui/spinner.js

@@ -0,0 +1,52 @@
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/** One-line activity indicator. Never writes when stdout is not a TTY. */
+export class Spinner {
+    painter;
+    timer = null;
+    frame = 0;
+    label = '';
+    startedAt = 0;
+    showing = false;
+    constructor(painter) {
+        this.painter = painter;
+    }
+    get active() {
+        return this.timer !== null;
+    }
+    start(label) {
+        this.label = label;
+        if (!process.stdout.isTTY) {
+            return;
+        }
+        if (this.timer === null) {
+            this.startedAt = Date.now();
+        }
+        this.timer = this.timer ?? setInterval(() => this.tick(), 90);
+        this.tick();
+    }
+    update(label) {
+        this.label = label;
+    }
+    stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.clear();
+    }
+    /** Erase the spinner line so streamed text starts on a clean line. */
+    clear() {
+        if (this.showing) {
+            process.stdout.write('\r\x1b[2K');
+            this.showing = false;
+        }
+    }
+    tick() {
+        this.frame = (this.frame + 1) % FRAMES.length;
+        const seconds = ((Date.now() - this.startedAt) / 1000).toFixed(0);
+        const line = this.painter.primary(FRAMES[this.frame]) + ' ' +
+            this.painter.muted(this.label + '  ' + seconds + 's');
+        process.stdout.write('\r\x1b[2K' + line);
+        this.showing = true;
+    }
+}