@glbgpt/cli 0.1.0-test.1

package/dist/src/tui/MultilineInput.js

@@ -0,0 +1,221 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from 'react';
+import { Box, Text, useInput } from 'ink';
+import { visualLines, rowIndexFor, columnInRow, offsetAtColumn } from './visualLines.js';
+/**
+ * Multi-line composer input (replaces the single-line ink-text-input).
+ *
+ * Newline conventions from the references: a trailing `\` + Enter (Claude Code's
+ * documented binding — works in every terminal) or Ctrl+J (Codex/readline). Enter
+ * submits. Pasted chunks containing newlines insert literally instead of submitting
+ * per line. Characters with ctrl/meta modifiers are never inserted (the root fix for
+ * ink-text-input's stray 'v' on Ctrl+V).
+ *
+ * ↑/↓ move the cursor between VISUAL rows (wrapped lines, display-width columns, with
+ * column memory — the Claude Code Cursor.ts / Codex textarea.rs model), and history is
+ * arbitrated INSIDE the editor (CC's upOrHistoryUp): only when the cursor cannot move
+ * any further does ↑/↓ escalate to onHistoryUp/onHistoryDown. The ladder:
+ *   ↑ → move up a row → (top row) jump to start → (at start) recall history
+ *   ↓ → symmetric, ending in onHistoryDown
+ * While `recallActive` (the parent is mid history-browse and the entry is unedited),
+ * boundary ↑/↓ keep browsing instead (Codex should_handle_navigation).
+ */
+export function MultilineInput({ value, onChange, onSubmit, onHistoryUp, onHistoryDown, placeholder = '', focus = true, verticalNav = true, recallActive = false, columns, }) {
+    const [, forceRender] = useState(0);
+    // Refs are the live source of truth: multiple key events can arrive in ONE event-loop
+    // batch (fast typing, pastes, ctrl+j+text), and React state/closures would make each
+    // callback act on stale values, silently dropping edits.
+    const valueRef = useRef(value);
+    const cursorRef = useRef(value.length);
+    const lastEmitted = useRef(value);
+    // Column memory (Codex preferred_col): moving through a short row and back into a long
+    // one keeps the original column. Any non-vertical key resets it.
+    const preferredCol = useRef(null);
+    // Controlled component: when the PARENT replaces the value (history recall, Tab
+    // completion, Ctrl+V insertion, post-submit clear), jump the cursor to the end.
+    if (value !== lastEmitted.current) {
+        lastEmitted.current = value;
+        valueRef.current = value;
+        cursorRef.current = value.length;
+        preferredCol.current = null;
+    }
+    // Code-point boundaries: cursor ops must never split an emoji's surrogate pair — an
+    // unpaired surrogate makes the submitted string invalid JSON at the API layer. (The
+    // reference editor, claude-code-source Cursor.ts, goes further with grapheme segmentation;
+    // code-point level covers the data-corruption class.)
+    const isLow = (s, i) => {
+        const code = s.charCodeAt(i);
+        return code >= 0xdc00 && code <= 0xdfff;
+    };
+    const snapPair = (s, n) => (n > 0 && n < s.length && isLow(s, n) ? n - 1 : n);
+    const prevBoundary = (s, n) => (n <= 0 ? 0 : snapPair(s, n - 1) < n - 1 ? n - 2 : n - 1);
+    const nextBoundary = (s, n) => (n >= s.length ? s.length : n + (isLow(s, n + 1) ? 2 : 1));
+    // The cursor never lands INSIDE an "[Image #N]" placeholder — editing there would break
+    // the token so it can no longer expand to the pasted image (Claude Code Cursor.ts
+    // snapOutOfImageRef, same regex).
+    const snapPlaceholder = (s, n, toward) => {
+        const re = /\[Image #\d+\]/g;
+        let m;
+        while ((m = re.exec(s)) !== null) {
+            if (n > m.index && n < m.index + m[0].length)
+                return toward === 'start' ? m.index : m.index + m[0].length;
+            if (m.index >= n)
+                break;
+        }
+        return n;
+    };
+    const setC = (n, toward = 'start') => {
+        cursorRef.current = snapPlaceholder(valueRef.current, snapPair(valueRef.current, n), toward);
+        forceRender((x) => x + 1);
+    };
+    const emit = (next) => {
+        valueRef.current = next;
+        lastEmitted.current = next;
+        onChange(next);
+    };
+    const insertAt = (text) => {
+        const v = valueRef.current;
+        const c = Math.min(cursorRef.current, v.length);
+        emit(v.slice(0, c) + text + v.slice(c));
+        cursorRef.current = c + text.length;
+    };
+    // Paste-burst guard (Claude Code's usePasteHandler / Codex's paste_burst.rs): a paste can
+    // reach us as MULTIPLE stdin chunks, and a chunk boundary landing on a newline delivers a
+    // lone \r that ink parses as key.return. A return within a short window after a bulk
+    // chunk is part of the paste — insert a newline instead of submitting.
+    const lastBulkAt = useRef(0);
+    const noteBulk = (input) => {
+        // A lone linefeed is the Ctrl+J keystroke, not paste content.
+        if (input.length >= 16 || (input.includes('\n') && input.length > 1))
+            lastBulkAt.current = Date.now();
+    };
+    const inPasteBurst = () => Date.now() - lastBulkAt.current < 150;
+    useInput((input, key) => {
+        const v = valueRef.current;
+        const c = Math.min(cursorRef.current, v.length);
+        // Any editing key means the user is interacting — a paste delivers only text chunks —
+        // so it ends the burst window immediately.
+        if (key.backspace || key.delete || key.leftArrow || key.rightArrow || key.upArrow || key.downArrow || key.ctrl || key.meta || key.escape || key.tab) {
+            lastBulkAt.current = 0;
+        }
+        // Any key other than ↑/↓ drops the remembered column.
+        if (!key.upArrow && !key.downArrow)
+            preferredCol.current = null;
+        if (key.return) {
+            // Mid-paste \r is content, not a submit (see paste-burst guard above).
+            if (inPasteBurst()) {
+                lastBulkAt.current = Date.now(); // consecutive pasted lines extend the burst
+                insertAt('\n');
+                forceRender((x) => x + 1);
+                return;
+            }
+            // Backslash at END of the current line + Enter continues onto a new line (Claude
+            // Code convention). Cursor-relative only is wrong: Enter with the cursor just past
+            // a mid-line backslash ("run C:\\tools\\ now") must still submit.
+            if (c > 0 && v[c - 1] === '\\' && (c === v.length || v[c] === '\n')) {
+                emit(v.slice(0, c - 1) + '\n' + v.slice(c));
+                cursorRef.current = c;
+                return;
+            }
+            onSubmit(v);
+            cursorRef.current = 0;
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (c > 0) {
+                // A placeholder deletes atomically — a half-eaten "[Image #1" can never expand.
+                const ph = /\[Image #\d+\]$/.exec(v.slice(0, c));
+                const from = ph ? c - ph[0].length : prevBoundary(v, c);
+                emit(v.slice(0, from) + v.slice(c));
+                cursorRef.current = from;
+            }
+            return;
+        }
+        if (key.leftArrow) {
+            setC(prevBoundary(v, c), 'start');
+            return;
+        }
+        if (key.rightArrow) {
+            setC(nextBoundary(v, c), 'end');
+            return;
+        }
+        if (key.upArrow || key.downArrow) {
+            if (!verticalNav)
+                return; // a popup owns ↑/↓ right now
+            // Mid history-browse with the entry unedited: boundary ↑/↓ keep browsing
+            // (Codex should_handle_navigation — recall parks the cursor at the end).
+            if (recallActive && (c === 0 || c === v.length)) {
+                preferredCol.current = null;
+                if (key.upArrow)
+                    onHistoryUp?.();
+                else
+                    onHistoryDown?.();
+                return;
+            }
+            const rows = visualLines(v, columns);
+            const idx = rowIndexFor(rows, c);
+            if (key.upArrow) {
+                if (idx === 0) {
+                    // Top row: first jump to the very start; already there → recall history.
+                    preferredCol.current = null;
+                    if (c > 0)
+                        setC(0, 'start');
+                    else
+                        onHistoryUp?.();
+                    return;
+                }
+                const col = preferredCol.current ?? columnInRow(rows[idx], c);
+                preferredCol.current = col;
+                setC(offsetAtColumn(rows[idx - 1], col), 'start');
+                return;
+            }
+            // downArrow
+            if (idx === rows.length - 1) {
+                // Bottom row: first jump to the very end; already there → history down.
+                preferredCol.current = null;
+                if (c < v.length)
+                    setC(v.length, 'end');
+                else
+                    onHistoryDown?.();
+                return;
+            }
+            const col = preferredCol.current ?? columnInRow(rows[idx], c);
+            preferredCol.current = col;
+            setC(offsetAtColumn(rows[idx + 1], col), 'start');
+            return;
+        }
+        if (key.ctrl && input === 'a') {
+            setC(v.lastIndexOf('\n', c - 1) + 1, 'start');
+            return;
+        }
+        if (key.ctrl && input === 'e') {
+            const next = v.indexOf('\n', c);
+            setC(next === -1 ? v.length : next, 'end');
+            return;
+        }
+        if (key.ctrl || key.meta || key.escape || key.tab)
+            return; // never insert modified/control chars
+        if (input) {
+            // A bare linefeed is Ctrl+J (ink reports it as plain input '\n'); pasted chunks
+            // keep their newlines, with CR normalized, instead of submitting per line.
+            noteBulk(input);
+            insertAt(input.replace(/\r\n?/g, '\n'));
+        }
+    }, { isActive: focus });
+    if (!value && placeholder) {
+        return (_jsxs(Text, { children: [_jsx(Text, { inverse: true, children: " " }), _jsx(Text, { color: "gray", dimColor: true, children: placeholder })] }));
+    }
+    // Render the SAME visual rows the navigation model uses (pre-wrapped, so ink never
+    // re-wraps and the cursor cell always sits on the row the ↑/↓ arithmetic predicts).
+    const rows = visualLines(value, columns);
+    const cursor = Math.min(cursorRef.current, value.length);
+    const cursorRow = focus ? rowIndexFor(rows, cursor) : -1;
+    return (_jsx(Box, { flexDirection: "column", children: rows.map((row, i) => {
+            if (i !== cursorRow)
+                return _jsx(Text, { children: row.text || ' ' }, i);
+            const at = Math.max(0, cursor - row.start);
+            const cellEnd = at + (isLow(row.text, at + 1) ? 2 : 1);
+            return (_jsxs(Text, { children: [row.text.slice(0, at), _jsx(Text, { inverse: true, children: row.text.slice(at, cellEnd) || ' ' }), row.text.slice(cellEnd)] }, i));
+        }) }));
+}
+//# sourceMappingURL=MultilineInput.js.map

package/dist/src/tui/MultilineInput.js.map

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

package/dist/src/tui/atPopup.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Candidates for the `@` attachment popup (Claude Code's file-mention popup, scoped to our
+ * needs: keywords + image files/directories browsed from the typed prefix — no repo-wide
+ * index, we only ever attach images).
+ */
+export interface AtCandidate {
+    /** Text that replaces the partial after `@` when chosen. */
+    insert: string;
+    label: string;
+    hint: string;
+    isDir?: boolean;
+}
+export interface AtPopupDeps {
+    readDir?: (dir: string) => Promise<Array<{
+        name: string;
+        isDirectory: boolean;
+    }>>;
+    homeDir?: string;
+}
+/** Compute candidates for the text typed after `@` ('' | 'im' | './fo' | '~/Pic' ...). */
+export declare function atCandidates(partial: string, deps?: AtPopupDeps): Promise<AtCandidate[]>;

package/dist/src/tui/atPopup.js

@@ -0,0 +1,55 @@
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { IMAGE_EXT } from '../util/imageRef.js';
+const KEYWORDS = [
+    { insert: 'image', label: '@image', hint: 'the last generated image' },
+    { insert: 'clipboard', label: '@clipboard', hint: 'image on the clipboard' },
+];
+const MAX = 8;
+// Every keystroke after `@` recomputes candidates; a short TTL keeps typing from hammering
+// the filesystem while still noticing new screenshots between popups.
+const dirCache = new Map();
+const DIR_CACHE_TTL_MS = 2000;
+async function defaultReadDir(dir) {
+    const hit = dirCache.get(dir);
+    if (hit && Date.now() - hit.at < DIR_CACHE_TTL_MS)
+        return hit.entries;
+    const entries = (await fs.readdir(dir, { withFileTypes: true })).map((e) => ({
+        name: e.name,
+        isDirectory: e.isDirectory(),
+    }));
+    dirCache.set(dir, { at: Date.now(), entries });
+    return entries;
+}
+/** Compute candidates for the text typed after `@` ('' | 'im' | './fo' | '~/Pic' ...). */
+export async function atCandidates(partial, deps = {}) {
+    const readDir = deps.readDir ?? defaultReadDir;
+    const home = deps.homeDir ?? os.homedir();
+    const keywords = KEYWORDS.filter((k) => k.insert.startsWith(partial.toLowerCase()));
+    // Path browsing: everything up to the last '/' is the directory, the rest is the prefix.
+    const slash = partial.lastIndexOf('/');
+    const dirPart = slash >= 0 ? partial.slice(0, slash + 1) : '';
+    const prefix = (slash >= 0 ? partial.slice(slash + 1) : partial).toLowerCase();
+    const dirForFs = dirPart === '' ? '.' : dirPart.startsWith('~/') ? path.join(home, dirPart.slice(2)) : dirPart;
+    let files = [];
+    try {
+        const entries = await readDir(dirForFs);
+        files = entries
+            .filter((e) => !e.name.startsWith('.') && (e.isDirectory || IMAGE_EXT.test(e.name)))
+            .filter((e) => e.name.toLowerCase().startsWith(prefix))
+            .sort((a, b) => Number(b.isDirectory) - Number(a.isDirectory) || a.name.localeCompare(b.name))
+            .slice(0, MAX)
+            .map((e) => ({
+            insert: `${dirPart}${e.name}${e.isDirectory ? '/' : ''}`,
+            label: `${dirPart}${e.name}${e.isDirectory ? '/' : ''}`,
+            hint: e.isDirectory ? 'directory' : 'image file',
+            isDir: e.isDirectory,
+        }));
+    }
+    catch {
+        files = []; // unreadable dir → keywords only
+    }
+    return [...keywords, ...files].slice(0, MAX);
+}
+//# sourceMappingURL=atPopup.js.map

package/dist/src/tui/atPopup.js.map

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

package/dist/src/tui/attachments.d.ts

@@ -0,0 +1,24 @@
+import type { ContentPart } from '../core/types.js';
+export interface AttachmentContext {
+    /** Output URL of the most recently completed generation (for `@image`). */
+    lastMediaUrl?: string;
+    /** Injectable file reader (tests). */
+    readFile?: (p: string) => Promise<Buffer>;
+    /** Injectable clipboard-image reader (tests); returns a temp file path or null. */
+    readClipboard?: () => Promise<string | null>;
+}
+export type AttachmentResult = {
+    kind: 'none';
+} | {
+    kind: 'parts';
+    parts: ContentPart[];
+} | {
+    kind: 'error';
+    message: string;
+};
+/**
+ * Parse `@` references out of a message. The full original text (including the `@` tokens)
+ * stays as the text part so the model sees what the user wrote; images are appended as
+ * image_url parts. Returns `none` when there is nothing to attach.
+ */
+export declare function resolveAttachments(input: string, ctx?: AttachmentContext): Promise<AttachmentResult>;

package/dist/src/tui/attachments.js

@@ -0,0 +1,91 @@
+import { resolveImageRef, ImageRefError, IMAGE_EXT } from '../util/imageRef.js';
+import { readClipboardImage } from '../util/clipboardImage.js';
+/**
+ * `@` attachment references in TUI input (contract §6): turn a message like
+ * "how does @image look?" into multimodal content parts so the model can SEE the image.
+ *
+ * Recognized forms — anything else stays plain text (so emails/@handles are untouched):
+ * - `@image` / `@last`: the most recently completed generation (its hosted output URL).
+ * - `@clipboard`: the image currently on the system clipboard (screenshot → ask).
+ * - `@<path>` where the token looks like an image file (starts with ./ ../ / ~ or ends in an
+ *   image extension): the local file, inlined as a data URL (≤ 8MB).
+ */
+const PATHISH = /^(\.{1,2}\/|\/|~\/)/;
+/**
+ * Extract attachment tokens from the input:
+ * - `@image` / `@last` match as keywords even when CJK text follows immediately
+ *   ("看看@image这个图" — users don't add a space before Chinese text);
+ * - path-ish tokens (`@./a.png`, `@/abs/b.jpg`, `@~/c.webp`, `@shot.png`) match up to
+ *   whitespace, requiring a path prefix or an image extension.
+ * Everything else (emails, @handles) stays plain text.
+ */
+function extractTokens(input) {
+    const tokens = [];
+    for (const m of input.matchAll(/@(image|last|clipboard)(?![a-zA-Z0-9_.-])/g))
+        tokens.push(m[1]);
+    // Quoted form for names with spaces (macOS screenshots): @"Screenshot 2026 ….png"
+    let rest = input;
+    for (const m of input.matchAll(/@"([^"\n]+)"/g)) {
+        const token = m[1];
+        if (PATHISH.test(token) || IMAGE_EXT.test(token))
+            tokens.push(token);
+        rest = rest.replace(m[0], ' '); // don't re-match fragments of it below
+    }
+    for (const m of rest.matchAll(/@(\S+)/g)) {
+        const token = m[1];
+        if (token === 'image' || token === 'last')
+            continue; // already handled above
+        if (PATHISH.test(token) || IMAGE_EXT.test(token))
+            tokens.push(token);
+    }
+    return tokens;
+}
+/**
+ * Parse `@` references out of a message. The full original text (including the `@` tokens)
+ * stays as the text part so the model sees what the user wrote; images are appended as
+ * image_url parts. Returns `none` when there is nothing to attach.
+ */
+export async function resolveAttachments(input, ctx = {}) {
+    const tokens = extractTokens(input);
+    if (tokens.length === 0)
+        return { kind: 'none' };
+    const images = [];
+    for (const token of tokens) {
+        if (token === 'image' || token === 'last') {
+            if (!ctx.lastMediaUrl) {
+                return { kind: 'error', message: 'No generated image to reference yet — create one first (/image ...).' };
+            }
+            images.push({ type: 'image_url', image_url: { url: ctx.lastMediaUrl } });
+            continue;
+        }
+        if (token === 'clipboard') {
+            const file = await (ctx.readClipboard ?? readClipboardImage)();
+            if (!file) {
+                return { kind: 'error', message: 'No image on the clipboard (copy a screenshot first).' };
+            }
+            try {
+                const url = await resolveImageRef(file, ctx.readFile);
+                images.push({ type: 'image_url', image_url: { url } });
+            }
+            catch (err) {
+                if (err instanceof ImageRefError)
+                    return { kind: 'error', message: err.message };
+                throw err;
+            }
+            continue;
+        }
+        try {
+            const url = await resolveImageRef(token, ctx.readFile);
+            images.push({ type: 'image_url', image_url: { url } });
+        }
+        catch (err) {
+            if (err instanceof ImageRefError) {
+                // Show the reference the way the user typed it (with the @ prefix).
+                return { kind: 'error', message: err.message.replace(token, `@${token}`) };
+            }
+            throw err;
+        }
+    }
+    return { kind: 'parts', parts: [{ type: 'text', text: input }, ...images] };
+}
+//# sourceMappingURL=attachments.js.map

package/dist/src/tui/attachments.js.map

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

package/dist/src/tui/branding.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GlobalGPT brand block for the TUI welcome area (baseline §2/§3).
+ *
+ * LOGO_FRAMES is a pre-rendered clockwise-sweep reveal of the official logo (10 braille
+ * frames baked by scripts/render-logo.mjs --frames; the last frame is the full mark)
+ * (docs/assets/globalgpt-logo.png → 20×20 → 2×4-dot braille cells, each cell colored by its
+ * dominant brand color: coral 241,91,102 · orange 241,137,31 · purple 237,91,239). Generated
+ * at build time — no runtime image dependency. Terminals without truecolor skip the raster;
+ * the name and info lines never depend on it. Layout mirrors the compact competitor style
+ * (5 rows, logo left / info right).
+ */
+export declare const LOGO_FRAMES: string[][];
+/** The full mark (final reveal frame). */
+export declare const LOGO_LINES: string[];
+export declare const TAGLINE = "Chat, images, and video \u2014 your GlobalGPT account in the terminal.";
+/** Whether the terminal advertises 24-bit color (the raster needs it). */
+export declare function supportsTruecolor(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * The product name with a per-character purple→coral→orange gradient (bold), matching the
+ * logo's arcs. Falls back to plain bold on non-truecolor terminals.
+ */
+export declare function brandTitle(text?: string, env?: NodeJS.ProcessEnv): string;

package/dist/src/tui/branding.js

@@ -0,0 +1,119 @@
+/**
+ * GlobalGPT brand block for the TUI welcome area (baseline §2/§3).
+ *
+ * LOGO_FRAMES is a pre-rendered clockwise-sweep reveal of the official logo (10 braille
+ * frames baked by scripts/render-logo.mjs --frames; the last frame is the full mark)
+ * (docs/assets/globalgpt-logo.png → 20×20 → 2×4-dot braille cells, each cell colored by its
+ * dominant brand color: coral 241,91,102 · orange 241,137,31 · purple 237,91,239). Generated
+ * at build time — no runtime image dependency. Terminals without truecolor skip the raster;
+ * the name and info lines never depend on it. Layout mirrors the compact competitor style
+ * (5 rows, logo left / info right).
+ */
+export const LOGO_FRAMES = [
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⡆\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉\x1b[0m',
+        '     \x1b[38;2;241;91;102m⠁\x1b[0m',
+        '',
+        '',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⠆\x1b[0m',
+        '     \x1b[38;2;241;91;102m⠛\x1b[0m',
+        '',
+        '',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '     \x1b[38;2;241;91;102m⠛⠶⢤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '',
+        '',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '     \x1b[38;2;241;91;102m⢿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '      \x1b[38;2;241;91;102m⠙⢿⣿\x1b[0m',
+        '        \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '     \x1b[38;2;241;91;102m⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '     \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        '     \x1b[38;2;241;137;31m⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '    \x1b[38;2;241;91;102m⢀⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '   \x1b[38;2;241;137;31m⣀\x1b[0m \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        '  \x1b[38;2;241;137;31m⠘⠿⣿⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '    \x1b[38;2;241;91;102m⢤⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '\x1b[38;2;241;137;31m⠐⣦⣄⣀\x1b[0m \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        ' \x1b[38;2;241;137;31m⠈⠛⠿⣿⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        '     \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        '      \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '\x1b[38;2;241;137;31m⡀\x1b[0m\x1b[38;2;241;91;102m⠈⠓⠶⢤⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '\x1b[38;2;241;137;31m⠘⣦⣄⣀\x1b[0m \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        ' \x1b[38;2;241;137;31m⠈⠛⠿⣿⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        ' \x1b[38;2;241;91;102m⢀⡀\x1b[0m  \x1b[38;2;237;91;239m⣿⣶⣦⡀\x1b[0m',
+        ' \x1b[38;2;241;91;102m⣿⣷⣄\x1b[0m  \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '\x1b[38;2;241;137;31m⡀\x1b[0m\x1b[38;2;241;91;102m⠈⠛⠿⢷⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '\x1b[38;2;241;137;31m⠘⣦⣄⣀\x1b[0m \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        ' \x1b[38;2;241;137;31m⠈⠛⠿⣿⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+    [
+        ' \x1b[38;2;241;91;102m⢀⡀\x1b[0m \x1b[38;2;237;91;239m⠸⣿⣶⣦⡀\x1b[0m',
+        ' \x1b[38;2;241;91;102m⣿⣷⣄⡀\x1b[0m \x1b[38;2;237;91;239m⠉⠙⠻⡆\x1b[0m',
+        '\x1b[38;2;241;137;31m⡀\x1b[0m\x1b[38;2;241;91;102m⠈⠛⠿⢿⣿⣶⣤⡀\x1b[0m\x1b[38;2;237;91;239m⠘\x1b[0m',
+        '\x1b[38;2;241;137;31m⠘⣦⣄⣀\x1b[0m \x1b[38;2;241;91;102m⠈⠙⢿⣿\x1b[0m',
+        ' \x1b[38;2;241;137;31m⠈⠛⠿⣿⡦\x1b[0m  \x1b[38;2;241;91;102m⠁\x1b[0m',
+    ],
+];
+/** The full mark (final reveal frame). */
+export const LOGO_LINES = LOGO_FRAMES[LOGO_FRAMES.length - 1];
+export const TAGLINE = 'Chat, images, and video — your GlobalGPT account in the terminal.';
+/** Whether the terminal advertises 24-bit color (the raster needs it). */
+export function supportsTruecolor(env = process.env) {
+    const ct = (env.COLORTERM ?? '').toLowerCase();
+    return ct.includes('truecolor') || ct.includes('24bit');
+}
+/** The three brand colors, in the logo's arc order. */
+const BRAND_STOPS = [
+    [237, 91, 239], // purple
+    [241, 91, 102], // coral
+    [241, 137, 31], // orange
+];
+/**
+ * The product name with a per-character purple→coral→orange gradient (bold), matching the
+ * logo's arcs. Falls back to plain bold on non-truecolor terminals.
+ */
+export function brandTitle(text = 'GlobalGPT CLI', env = process.env) {
+    if (!supportsTruecolor(env))
+        return `\x1b[1m${text}\x1b[0m`;
+    const chars = [...text];
+    const out = ['\x1b[1m'];
+    for (let i = 0; i < chars.length; i++) {
+        const t = chars.length === 1 ? 0 : i / (chars.length - 1);
+        // Two segments: purple→coral for t∈[0,.5), coral→orange for t∈[.5,1].
+        const seg = t < 0.5 ? 0 : 1;
+        const local = t < 0.5 ? t * 2 : (t - 0.5) * 2;
+        const [a, b] = [BRAND_STOPS[seg], BRAND_STOPS[seg + 1]];
+        const mix = (x, y) => Math.round(x + (y - x) * local);
+        out.push(`\x1b[38;2;${mix(a[0], b[0])};${mix(a[1], b[1])};${mix(a[2], b[2])}m${chars[i]}`);
+    }
+    out.push('\x1b[0m');
+    return out.join('');
+}
+//# sourceMappingURL=branding.js.map

package/dist/src/tui/branding.js.map

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