@elaraai/e3-ui-cli 1.0.71 → 1.0.73

package/dist/tui/input/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/tui/input/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,gCAAgC;AAChC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBvE;AAkBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CA8CxE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAQpE"}

package/dist/tui/input/completion.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { COMMANDS, RUN_FLAGS, splitWords } from './commands.js';
+/** Candidates shown at most. */
+export const MAX_CANDIDATES = 8;
+/**
+ * Fuzzy match score — higher is better, `null` when `pattern` is not a
+ * subsequence of `text`. Prefix and word-start matches rank first, then
+ * contiguous runs; shorter texts win ties.
+ *
+ * @param pattern - What was typed (case-insensitive)
+ * @param text - The candidate
+ * @returns The score, or null
+ */
+export function fuzzyScore(pattern, text) {
+    const p = pattern.toLowerCase();
+    const t = text.toLowerCase();
+    if (p === '')
+        return 1000 - t.length;
+    // Prefix matches tie so the catalogue's own order decides (stable sort).
+    if (t.startsWith(p))
+        return 5000;
+    let score = 0;
+    let ti = 0;
+    let last = -2;
+    for (let pi = 0; pi < p.length; pi++) {
+        const idx = t.indexOf(p[pi], ti);
+        if (idx === -1)
+            return null;
+        if (idx === 0 || /[^a-z0-9]/.test(t[idx - 1]))
+            score += 30;
+        else if (idx === last + 1)
+            score += 20;
+        else
+            score += 5;
+        last = idx;
+        ti = idx + 1;
+    }
+    return 2000 + score - t.length;
+}
+function rank(pattern, items, text) {
+    return items
+        .map(item => ({ item, score: fuzzyScore(pattern, text(item)) }))
+        .filter((s) => s.score !== null)
+        .sort((a, b) => b.score - a.score)
+        .map(s => s.item);
+}
+function itemCandidate(command, item) {
+    return {
+        kind: item.kind,
+        insert: `/${command} ${item.name}`,
+        cells: [`/${command}`, item.name, item.status, item.type, item.detail],
+    };
+}
+/**
+ * Completes the command box.
+ *
+ * @param text - The text in the box
+ * @param catalogue - The workspace catalogue
+ * @returns At most {@link MAX_CANDIDATES} candidates, best first (empty when nothing applies)
+ */
+export function complete(text, catalogue) {
+    if (text === '')
+        return [];
+    if (!text.startsWith('/'))
+        return jump(text, catalogue);
+    const body = text.slice(1);
+    const words = splitWords(body);
+    const typingName = !/\s/.test(body);
+    if (typingName) {
+        const name = words[0] ?? '';
+        return rank(name, [...COMMANDS], c => c.name)
+            .slice(0, MAX_CANDIDATES)
+            .map(c => ({ kind: 'command', insert: `/${c.name}${c.usage.includes(' ') ? ' ' : ''}`, cells: [`/${c.name}`, c.usage.replace(`/${c.name}`, '').trim(), c.effect] }));
+    }
+    const name = words[0] ?? '';
+    const partial = body.endsWith(' ') ? '' : (words[words.length - 1] ?? '');
+    const byKind = (kinds, command = name) => rank(partial, catalogue.items.filter(i => kinds.includes(i.kind)), i => i.name)
+        .slice(0, MAX_CANDIDATES)
+        .map(i => itemCandidate(command, i));
+    switch (name) {
+        case 'task':
+        case 'logs':
+        case 'runs':
+            return byKind(['task']);
+        case 'input':
+            return byKind(['input']);
+        case 'dataset':
+            return byKind(['dataset']);
+        case 'workspace':
+            return byKind(['workspace']);
+        case 'repo':
+            return byKind(['repo']);
+        case 'run': {
+            const used = new Set(words.slice(1));
+            return rank(partial, RUN_FLAGS.filter(f => !used.has(f.flag.split(' ')[0])), f => f.flag)
+                .filter(() => partial === '' || partial.startsWith('-'))
+                .map(f => ({ kind: 'flag', insert: `/run ${[...words.slice(1, body.endsWith(' ') ? undefined : -1), f.flag.split(' ')[0]].join(' ')} `, cells: ['/run', f.flag, f.hint] }));
+        }
+        case 'tag':
+            return rank(partial, catalogue.tags ?? [], t => t)
+                .slice(0, MAX_CANDIDATES)
+                .map(t => ({ kind: 'tag', insert: `/tag ${t}`, cells: ['/tag', t] }));
+        case 'logs2':
+            return [];
+        default:
+            return [];
+    }
+}
+/**
+ * The fuzzy jump across everything in the catalogue.
+ *
+ * @param text - What was typed (no leading `/`)
+ * @param catalogue - The workspace catalogue
+ * @returns At most {@link MAX_CANDIDATES} candidates
+ */
+export function jump(text, catalogue) {
+    return rank(text, catalogue.items, i => i.name)
+        .slice(0, MAX_CANDIDATES)
+        .map(i => ({
+        kind: i.kind,
+        insert: `/${i.kind} ${i.name}`,
+        cells: [i.kind, i.name, i.workspace ?? '', [i.status, i.type, i.detail].filter(s => s !== '').join(' · ')],
+    }));
+}
+//# sourceMappingURL=completion.js.map

package/dist/tui/input/completion.js.map

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

package/dist/tui/input/keymap.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The keymap — `resolve(input, key, ctx)` turns one Ink key event into a
+ * semantic {@link KeyAction} by scope: the command box while editing, a
+ * leaf editor while editing, then the view's own keys (list / tree / logs /
+ * inputs), then the keys that work everywhere. Vim aliases (`j k h l`,
+ * `gg G`, `^u ^d`) ride along.
+ *
+ * @packageDocumentation
+ */
+import type { Key } from 'ink';
+/** Where the key lands. */
+export type KeyScope = 'list' | 'tree' | 'logs' | 'none';
+/** What the keymap needs to know. */
+export interface KeyContext {
+    /** The command box mode. */
+    commandMode: 'idle' | 'edit' | 'confirm';
+    /** Whether a leaf editor is open. */
+    editingLeaf: boolean;
+    /** The view's primary scope. */
+    scope: KeyScope;
+    /** Whether the view is an editable input. */
+    editable: boolean;
+    /** Whether the view has numbered tabs. */
+    tabs: number;
+    /** A pending multi-key prefix (`g`). */
+    pendingKey: string | null;
+}
+/** A semantic key action. */
+export type KeyAction = {
+    kind: 'move';
+    op: 'up' | 'down' | 'pageUp' | 'pageDown' | 'home' | 'end';
+} | {
+    kind: 'open';
+} | {
+    kind: 'back';
+} | {
+    kind: 'quit';
+} | {
+    kind: 'help';
+} | {
+    kind: 'refresh';
+} | {
+    kind: 'tab';
+    index: number;
+} | {
+    kind: 'tab.cycle';
+    delta: 1 | -1;
+} | {
+    kind: 'prefill';
+    text: string;
+} | {
+    kind: 'type';
+    text: string;
+} | {
+    kind: 'expand';
+} | {
+    kind: 'collapse';
+} | {
+    kind: 'toggle';
+} | {
+    kind: 'collapseDeep';
+} | {
+    kind: 'save';
+} | {
+    kind: 'follow';
+} | {
+    kind: 'next';
+} | {
+    kind: 'prev';
+} | {
+    kind: 'copy';
+} | {
+    kind: 'edit';
+} | {
+    kind: 'add';
+} | {
+    kind: 'remove';
+} | {
+    kind: 'tag';
+} | {
+    kind: 'apply';
+} | {
+    kind: 'discard';
+} | {
+    kind: 'retry';
+} | {
+    kind: 'pending';
+    key: string;
+} | {
+    kind: 'paste';
+    text: string;
+    submit: boolean;
+} | {
+    kind: 'cmd.submit';
+} | {
+    kind: 'cmd.cancel';
+} | {
+    kind: 'cmd.complete';
+} | {
+    kind: 'cmd.up';
+} | {
+    kind: 'cmd.down';
+} | {
+    kind: 'cmd.left';
+} | {
+    kind: 'cmd.right';
+} | {
+    kind: 'cmd.home';
+} | {
+    kind: 'cmd.end';
+} | {
+    kind: 'cmd.backspace';
+} | {
+    kind: 'cmd.delete';
+} | {
+    kind: 'cmd.char';
+    text: string;
+} | {
+    kind: 'leaf.submit';
+} | {
+    kind: 'leaf.cancel';
+} | {
+    kind: 'leaf.left';
+} | {
+    kind: 'leaf.right';
+} | {
+    kind: 'leaf.home';
+} | {
+    kind: 'leaf.end';
+} | {
+    kind: 'leaf.backspace';
+} | {
+    kind: 'leaf.delete';
+} | {
+    kind: 'leaf.char';
+    text: string;
+} | {
+    kind: 'leaf.toggle';
+};
+/**
+ * Resolves one key event.
+ *
+ * @param input - Ink's `input` (the printable text, or `''` for special keys)
+ * @param key - Ink's `key` flags
+ * @param ctx - The context
+ * @returns The action, or null when the key means nothing here
+ */
+export declare function resolve(input: string, key: Key, ctx: KeyContext): KeyAction | null;
+//# sourceMappingURL=keymap.d.ts.map

package/dist/tui/input/keymap.d.ts.map

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

package/dist/tui/input/keymap.js

@@ -0,0 +1,206 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Whether an input string is printable text (one or more characters, no controls). */
+function isPrintable(input) {
+    if (input === '')
+        return false;
+    for (const ch of input) {
+        const cp = ch.codePointAt(0) ?? 0;
+        if (cp < 0x20 || (cp >= 0x7f && cp < 0xa0))
+            return false;
+    }
+    return true;
+}
+/**
+ * Resolves one key event.
+ *
+ * @param input - Ink's `input` (the printable text, or `''` for special keys)
+ * @param key - Ink's `key` flags
+ * @param ctx - The context
+ * @returns The action, or null when the key means nothing here
+ */
+export function resolve(input, key, ctx) {
+    // Ctrl-C is always quit (we own Ctrl-C: exitOnCtrlC is off so a dirty
+    // input can confirm first).
+    if (key.ctrl && input === 'c')
+        return { kind: 'quit' };
+    // A paste (or a terminal delivering several keys in one chunk) arrives
+    // as one string: it is typed into the command box, and a trailing
+    // newline submits it.
+    if (input.length > 1 && !key.ctrl && !key.meta && !ctx.editingLeaf && ctx.commandMode !== 'confirm') {
+        const submit = /[\r\n]$/.test(input);
+        const text = input.replace(/[\r\n]+$/, '');
+        if (text !== '' && isPrintable(text))
+            return { kind: 'paste', text, submit };
+    }
+    if (ctx.commandMode === 'confirm') {
+        if (key.return)
+            return { kind: 'cmd.submit' };
+        if (key.escape)
+            return { kind: 'cmd.cancel' };
+        if (input === 'y' || input === 'Y')
+            return { kind: 'cmd.submit' };
+        if (input === 'n' || input === 'N')
+            return { kind: 'cmd.cancel' };
+        return null;
+    }
+    if (ctx.commandMode === 'edit') {
+        if (key.return)
+            return { kind: 'cmd.submit' };
+        if (key.escape)
+            return { kind: 'cmd.cancel' };
+        if (key.tab)
+            return { kind: 'cmd.complete' };
+        if (key.upArrow || (key.ctrl && input === 'p'))
+            return { kind: 'cmd.up' };
+        if (key.downArrow || (key.ctrl && input === 'n'))
+            return { kind: 'cmd.down' };
+        if (key.leftArrow)
+            return { kind: 'cmd.left' };
+        if (key.rightArrow)
+            return { kind: 'cmd.right' };
+        if (key.home || (key.ctrl && input === 'a'))
+            return { kind: 'cmd.home' };
+        if (key.end || (key.ctrl && input === 'e'))
+            return { kind: 'cmd.end' };
+        if (key.backspace)
+            return { kind: 'cmd.backspace' };
+        if (key.delete)
+            return { kind: 'cmd.delete' };
+        if (key.ctrl && input === 'u')
+            return { kind: 'cmd.cancel' };
+        if (!key.ctrl && !key.meta && isPrintable(input))
+            return { kind: 'cmd.char', text: input };
+        return null;
+    }
+    if (ctx.editingLeaf) {
+        if (key.return)
+            return { kind: 'leaf.submit' };
+        if (key.escape)
+            return { kind: 'leaf.cancel' };
+        if (key.leftArrow)
+            return { kind: 'leaf.left' };
+        if (key.rightArrow)
+            return { kind: 'leaf.right' };
+        if (key.home || (key.ctrl && input === 'a'))
+            return { kind: 'leaf.home' };
+        if (key.end || (key.ctrl && input === 'e'))
+            return { kind: 'leaf.end' };
+        if (key.backspace)
+            return { kind: 'leaf.backspace' };
+        if (key.delete)
+            return { kind: 'leaf.delete' };
+        if (input === ' ')
+            return { kind: 'leaf.toggle' };
+        if (!key.ctrl && !key.meta && isPrintable(input))
+            return { kind: 'leaf.char', text: input };
+        return null;
+    }
+    // -- everywhere ---------------------------------------------------------
+    if (key.escape || key.backspace)
+        return { kind: 'back' };
+    if (input === '?')
+        return { kind: 'help' };
+    if (input === 'q')
+        return { kind: 'quit' };
+    if (input === 'R')
+        return { kind: 'refresh' };
+    if (input === '/')
+        return { kind: 'type', text: '/' };
+    if (ctx.tabs > 0) {
+        if (/^[1-9]$/.test(input) && Number(input) <= ctx.tabs)
+            return { kind: 'tab', index: Number(input) - 1 };
+        // `tab` / `⇧tab` cycle the tabs everywhere; `←` / `→` only where no content claims the
+        // arrows (the help view, a log stream) — a tree expands / collapses, a list opens on `→`.
+        if (key.tab)
+            return { kind: 'tab.cycle', delta: key.shift ? -1 : 1 };
+        if (ctx.scope === 'none' || ctx.scope === 'logs') {
+            if (key.rightArrow)
+                return { kind: 'tab.cycle', delta: 1 };
+            if (key.leftArrow)
+                return { kind: 'tab.cycle', delta: -1 };
+        }
+    }
+    // -- pending prefixes (`gg`) --------------------------------------------
+    if (ctx.pendingKey === 'g') {
+        if (input === 'g')
+            return { kind: 'move', op: 'home' };
+        return null;
+    }
+    // -- lists / trees / logs -----------------------------------------------
+    if (ctx.scope !== 'none') {
+        if (key.upArrow || input === 'k')
+            return { kind: 'move', op: 'up' };
+        if (key.downArrow || input === 'j')
+            return { kind: 'move', op: 'down' };
+        if (key.pageUp || (key.ctrl && input === 'u'))
+            return { kind: 'move', op: 'pageUp' };
+        if (key.pageDown || (key.ctrl && input === 'd'))
+            return { kind: 'move', op: 'pageDown' };
+        if (key.home)
+            return { kind: 'move', op: 'home' };
+        if (key.end || input === 'G')
+            return { kind: 'move', op: 'end' };
+        if (input === 'g')
+            return { kind: 'pending', key: 'g' };
+    }
+    if (ctx.scope === 'tree') {
+        if (key.leftArrow && key.shift)
+            return { kind: 'collapseDeep' };
+        if (key.rightArrow || input === 'l')
+            return { kind: 'expand' };
+        if (key.leftArrow || input === 'h')
+            return { kind: 'collapse' };
+        if (key.return || input === ' ')
+            return ctx.editable ? { kind: 'apply' } : { kind: 'toggle' };
+        if (input === 's')
+            return { kind: 'save' };
+        if (input === 'n')
+            return { kind: 'next' };
+        if (input === 'N')
+            return { kind: 'prev' };
+        if (ctx.editable) {
+            if (input === 'e')
+                return { kind: 'edit' };
+            if (input === 'a')
+                return { kind: 'add' };
+            if (input === 'x')
+                return { kind: 'remove' };
+            if (input === 't')
+                return { kind: 'tag' };
+        }
+    }
+    if (ctx.scope === 'logs') {
+        if (input === 'F')
+            return { kind: 'follow' };
+        if (input === 's')
+            return { kind: 'save' };
+        if (input === 'c')
+            return { kind: 'copy' };
+        if (input === 'n')
+            return { kind: 'next' };
+        if (input === 'N')
+            return { kind: 'prev' };
+    }
+    if (ctx.scope === 'list') {
+        if (key.return)
+            return { kind: 'open' };
+        if (key.rightArrow || input === 'l')
+            return { kind: 'open' };
+        if (input === 'r' && !ctx.editable)
+            return { kind: 'prefill', text: '/run ' };
+        if (input === 'x' && !ctx.editable)
+            return { kind: 'prefill', text: '/stop' };
+        if (input === 'w')
+            return { kind: 'prefill', text: '/workspaces' };
+    }
+    if (input === 'r' && ctx.scope === 'none')
+        return { kind: 'retry' };
+    // -- anything else printable starts a fuzzy jump ------------------------
+    if (!key.ctrl && !key.meta && isPrintable(input) && input !== ' ')
+        return { kind: 'type', text: input };
+    return null;
+}
+//# sourceMappingURL=keymap.js.map

package/dist/tui/input/keymap.js.map

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

package/dist/tui/input/mouse.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * SGR mouse reporting — the sequences (`ESC [ < b ; x ; y M|m`) Ink hands
+ * `useInput` intact (with the leading ESC stripped) once
+ * `?1000;1002;1006h` is on: presses, releases, drags, wheel ticks and the
+ * modifiers. `--no-mouse`, `TERM=dumb` and a non-TTY stdout keep the
+ * enable sequence unwritten; every exit path writes the disable one.
+ *
+ * @packageDocumentation
+ */
+/** One mouse event, 0-based cells. */
+export interface MouseEvent {
+    kind: 'press' | 'release' | 'drag' | 'move' | 'wheelUp' | 'wheelDown';
+    button: 'left' | 'middle' | 'right' | 'none';
+    x: number;
+    y: number;
+    shift: boolean;
+    alt: boolean;
+    ctrl: boolean;
+}
+/** Turns SGR reporting on (buttons, drags, SGR encoding). */
+export declare const MOUSE_ON = "\u001B[?1000h\u001B[?1002h\u001B[?1006h";
+/** Turns SGR reporting off (the reverse order). */
+export declare const MOUSE_OFF = "\u001B[?1006l\u001B[?1002l\u001B[?1000l";
+/**
+ * Whether an input chunk is one or more SGR mouse reports.
+ *
+ * @param input - Ink's `input`
+ * @returns `true` for mouse reports only
+ */
+export declare function isMouseInput(input: string): boolean;
+/**
+ * Parses the SGR mouse reports in an input chunk.
+ *
+ * @param input - Ink's `input` (one or more reports, ESC optional)
+ * @returns The events, in order
+ */
+export declare function parseSgr(input: string): MouseEvent[];
+/**
+ * Whether mouse reporting can be turned on for this terminal.
+ *
+ * @param env - The environment (`TERM`)
+ * @param stdout - The output stream
+ * @returns `true` for a TTY that is not `dumb`
+ */
+export declare function mouseSupported(env: NodeJS.ProcessEnv, stdout: {
+    isTTY?: boolean | undefined;
+}): boolean;
+//# sourceMappingURL=mouse.d.ts.map

package/dist/tui/input/mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../../src/tui/input/mouse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AAEH,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACtE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,4CAAsC,CAAC;AAC5D,mDAAmD;AACnD,eAAO,MAAM,SAAS,4CAAsC,CAAC;AAK7D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAkBpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GAAG,OAAO,CAEvG"}

package/dist/tui/input/mouse.js

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** Turns SGR reporting on (buttons, drags, SGR encoding). */
+export const MOUSE_ON = '\x1b[?1000h\x1b[?1002h\x1b[?1006h';
+/** Turns SGR reporting off (the reverse order). */
+export const MOUSE_OFF = '\x1b[?1006l\x1b[?1002l\x1b[?1000l';
+const ONE = /\x1b?\[<(\d+);(\d+);(\d+)([mM])/g;
+const ALL = /^(?:\x1b?\[<\d+;\d+;\d+[mM])+$/;
+/**
+ * Whether an input chunk is one or more SGR mouse reports.
+ *
+ * @param input - Ink's `input`
+ * @returns `true` for mouse reports only
+ */
+export function isMouseInput(input) {
+    return ALL.test(input);
+}
+/**
+ * Parses the SGR mouse reports in an input chunk.
+ *
+ * @param input - Ink's `input` (one or more reports, ESC optional)
+ * @returns The events, in order
+ */
+export function parseSgr(input) {
+    const out = [];
+    for (const m of input.matchAll(ONE)) {
+        const code = Number(m[1]);
+        const x = Number(m[2]) - 1;
+        const y = Number(m[3]) - 1;
+        const release = m[4] === 'm';
+        const wheel = (code & 64) !== 0;
+        const motion = (code & 32) !== 0;
+        const low = code & 3;
+        const button = wheel ? 'none' : low === 0 ? 'left' : low === 1 ? 'middle' : low === 2 ? 'right' : 'none';
+        const kind = wheel ? (low === 0 ? 'wheelUp' : 'wheelDown')
+            : release ? 'release'
+                : motion ? (button === 'none' ? 'move' : 'drag')
+                    : 'press';
+        out.push({ kind, button, x: Math.max(0, x), y: Math.max(0, y), shift: (code & 4) !== 0, alt: (code & 8) !== 0, ctrl: (code & 16) !== 0 });
+    }
+    return out;
+}
+/**
+ * Whether mouse reporting can be turned on for this terminal.
+ *
+ * @param env - The environment (`TERM`)
+ * @param stdout - The output stream
+ * @returns `true` for a TTY that is not `dumb`
+ */
+export function mouseSupported(env, stdout) {
+    return stdout.isTTY === true && env['TERM'] !== 'dumb';
+}
+//# sourceMappingURL=mouse.js.map

package/dist/tui/input/mouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouse.js","sourceRoot":"","sources":["../../../src/tui/input/mouse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAC5D,mDAAmD;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,mCAAmC,CAAC;AAE7D,MAAM,GAAG,GAAG,kCAAkC,CAAC;AAC/C,MAAM,GAAG,GAAG,gCAAgC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACtC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IAClC,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;QAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC;QACrB,MAAM,MAAM,GAAyB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/H,MAAM,IAAI,GAAuB,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;YAC1E,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACrB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBAChD,CAAC,CAAC,OAAO,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9I,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAsB,EAAE,MAAuC;IAC1F,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AAC3D,CAAC"}