@agi-fans/dsh-tui 0.1.0

package/lib/human-interaction.js

@@ -0,0 +1,8 @@
+/** Harness approval/question adapter mounted independently from the runner. */
+import { bindHumanInteraction } from "./interaction-adapter.js";
+export const name = 'omdsh-human-interaction';
+export const inject = ['tui', 'omdshSession'];
+export function apply(ctx) {
+    ctx.effect(() => bindHumanInteraction(ctx, ctx.tui, () => ctx.omdshSession.agent), 'omdsh human interaction');
+}
+//# sourceMappingURL=human-interaction.js.map

package/lib/human-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-interaction.js","sourceRoot":"","sources":["../src/human-interaction.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAM/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAE/D,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAA;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;AAE7C,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,yBAAyB,CAAC,CAAA;AAC/G,CAAC"}

package/lib/image-paste.d.ts

@@ -0,0 +1,21 @@
+/** Clipboard and path image ingestion owned by the local terminal provider. */
+import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
+import type { TuiInputImage } from './definition.ts';
+/** Parse a paste made entirely of supported local image paths. */
+export declare function imagePathCandidates(text: string): string[];
+/** Read intrinsic dimensions without decoding the complete image. */
+export declare function probeImageDimensions(data: Uint8Array, mediaType: ImageMediaType): {
+    width: number;
+    height: number;
+} | undefined;
+/** Compact, stable composer placeholder matching OMP's image draft label. */
+export declare function imageMarker(index: number, image: TuiInputImage): string;
+/** Load a supported local image without exposing its path beyond the TUI boundary. */
+export declare function readImageFile(path: string, cwd?: string): Promise<TuiInputImage | null>;
+/** Read Finder's file-url pasteboard flavor, which `pbpaste` cannot expose. */
+export declare function readMacClipboardFiles(): Promise<string[]>;
+/** Best-effort native clipboard image reader; null lets text paste take over. */
+export declare function readImageFromClipboard(): Promise<TuiInputImage | null>;
+export type ClipboardImageReader = () => Promise<TuiInputImage | null>;
+export type ClipboardFileReader = () => Promise<string[]>;
+export type ImagePathReader = (path: string) => Promise<TuiInputImage | null>;

package/lib/image-paste.js

@@ -0,0 +1,277 @@
+/** Clipboard and path image ingestion owned by the local terminal provider. */
+import { execFile } from 'node:child_process';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { homedir, platform, tmpdir } from 'node:os';
+import { basename, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const MEDIA_TYPES = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+};
+const CLIPBOARD_LIMIT = 64 * 1024 * 1024;
+const EXPLICIT_PATH_PREFIX = /^(?:\/|~\/|\.{1,2}\/|file:\/\/|[A-Za-z]:[\\/]|\\\\)/u;
+const INTERIOR_PATH_ANCHOR = /\s(?:\/|~\/|\.{1,2}\/|file:\/\/|[A-Za-z]:[\\/]|\\\\)/u;
+function unquote(value) {
+    const first = value.at(0);
+    const last = value.at(-1);
+    if (value.length >= 2 && (first === '"' || first === "'") && last === first)
+        return value.slice(1, -1);
+    return value;
+}
+/** Parse a paste made entirely of supported local image paths. */
+export function imagePathCandidates(text) {
+    const lines = text.replaceAll('\r\n', '\n').replaceAll('\r', '\n')
+        .split('\n')
+        .map(line => line.trim())
+        .filter(Boolean);
+    if (lines.length === 0)
+        return [];
+    const paths = [];
+    for (const line of lines) {
+        const quoted = (line.startsWith('"') && line.endsWith('"')) || (line.startsWith("'") && line.endsWith("'"));
+        if (!quoted && /(^|[^\\])\s/u.test(line)
+            && (!EXPLICIT_PATH_PREFIX.test(line) || INTERIOR_PATH_ANCHOR.test(line.slice(1))))
+            return [];
+        let candidate = unquote(line);
+        try {
+            if (candidate.startsWith('file://'))
+                candidate = fileURLToPath(candidate);
+            else
+                candidate = candidate.replace(/\\([\\ ])/gu, '$1');
+        }
+        catch {
+            return [];
+        }
+        if (MEDIA_TYPES[extname(candidate).toLowerCase()] === undefined)
+            return [];
+        paths.push(candidate);
+    }
+    return paths;
+}
+function uint24le(data, offset) {
+    return (data[offset] ?? 0) | ((data[offset + 1] ?? 0) << 8) | ((data[offset + 2] ?? 0) << 16);
+}
+function jpegDimensions(data) {
+    if (data[0] !== 0xff || data[1] !== 0xd8)
+        return undefined;
+    let offset = 2;
+    while (offset + 8 < data.length) {
+        if (data[offset] !== 0xff) {
+            offset += 1;
+            continue;
+        }
+        const marker = data[offset + 1];
+        offset += 2;
+        if (marker === undefined || marker === 0xd8 || marker === 0xd9)
+            continue;
+        if (marker === 0xda)
+            break;
+        const length = ((data[offset] ?? 0) << 8) | (data[offset + 1] ?? 0);
+        if (length < 2 || offset + length > data.length)
+            break;
+        const isStartOfFrame = marker >= 0xc0 && marker <= 0xcf
+            && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc;
+        if (isStartOfFrame && length >= 7) {
+            const height = ((data[offset + 3] ?? 0) << 8) | (data[offset + 4] ?? 0);
+            const width = ((data[offset + 5] ?? 0) << 8) | (data[offset + 6] ?? 0);
+            if (width > 0 && height > 0)
+                return { width, height };
+        }
+        offset += length;
+    }
+    return undefined;
+}
+/** Read intrinsic dimensions without decoding the complete image. */
+export function probeImageDimensions(data, mediaType) {
+    if (mediaType === 'image/png' && data.length >= 24
+        && data[0] === 0x89 && data[1] === 0x50 && data[2] === 0x4e && data[3] === 0x47) {
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        return { width: view.getUint32(16), height: view.getUint32(20) };
+    }
+    if (mediaType === 'image/gif' && data.length >= 10) {
+        const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        return { width: view.getUint16(6, true), height: view.getUint16(8, true) };
+    }
+    if (mediaType === 'image/jpeg')
+        return jpegDimensions(data);
+    if (mediaType === 'image/webp' && data.length >= 30
+        && String.fromCharCode(...data.slice(0, 4)) === 'RIFF'
+        && String.fromCharCode(...data.slice(8, 12)) === 'WEBP') {
+        const kind = String.fromCharCode(...data.slice(12, 16));
+        if (kind === 'VP8X') {
+            return { width: uint24le(data, 24) + 1, height: uint24le(data, 27) + 1 };
+        }
+        if (kind === 'VP8 ' && data.length >= 30 && data[23] === 0x9d && data[24] === 0x01 && data[25] === 0x2a) {
+            return {
+                width: ((data[26] ?? 0) | ((data[27] ?? 0) << 8)) & 0x3fff,
+                height: ((data[28] ?? 0) | ((data[29] ?? 0) << 8)) & 0x3fff,
+            };
+        }
+        if (kind === 'VP8L' && data.length >= 25 && data[20] === 0x2f) {
+            const bits = (data[21] ?? 0) | ((data[22] ?? 0) << 8) | ((data[23] ?? 0) << 16) | ((data[24] ?? 0) << 24);
+            return { width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
+        }
+    }
+    return undefined;
+}
+/** Compact, stable composer placeholder matching OMP's image draft label. */
+export function imageMarker(index, image) {
+    const dimensions = image.width === undefined || image.height === undefined
+        ? ''
+        : `, ${image.width}x${image.height}`;
+    return `[Image #${index + 1}${dimensions}]`;
+}
+/** Load a supported local image without exposing its path beyond the TUI boundary. */
+export async function readImageFile(path, cwd = process.cwd()) {
+    const expanded = path.startsWith('~/') ? homedir() + path.slice(1) : path;
+    const absolute = resolve(cwd, expanded);
+    const mediaType = MEDIA_TYPES[extname(absolute).toLowerCase()];
+    if (mediaType === undefined)
+        return null;
+    try {
+        return { data: new Uint8Array(await readFile(absolute)), mediaType, name: basename(absolute) };
+    }
+    catch {
+        return null;
+    }
+}
+function execBytes(command, args) {
+    return new Promise((resolvePromise, reject) => {
+        execFile(command, [...args], { encoding: 'buffer', maxBuffer: CLIPBOARD_LIMIT, timeout: 5000 }, (error, stdout) => {
+            if (error !== null)
+                reject(error);
+            else
+                resolvePromise(new Uint8Array(stdout));
+        });
+    });
+}
+function execText(command, args) {
+    return new Promise((resolvePromise, reject) => {
+        execFile(command, [...args], { encoding: 'utf8', maxBuffer: CLIPBOARD_LIMIT, timeout: 5000 }, (error, stdout) => {
+            if (error !== null)
+                reject(error);
+            else
+                resolvePromise(stdout);
+        });
+    });
+}
+async function readMacClipboardImage() {
+    const dir = await mkdtemp(resolve(tmpdir(), 'omdsh-clipboard-'));
+    const tiff = resolve(dir, 'clipboard.tiff');
+    const png = resolve(dir, 'clipboard.png');
+    const script = [
+        'set imageData to the clipboard as «class TIFF»',
+        `set outputFile to open for access POSIX file ${JSON.stringify(tiff)} with write permission`,
+        'try',
+        'set eof outputFile to 0',
+        'write imageData to outputFile',
+        'on error messageText number messageNumber',
+        'close access outputFile',
+        'error messageText number messageNumber',
+        'end try',
+        'close access outputFile',
+    ].join('\n');
+    try {
+        await execText('osascript', ['-e', script]);
+        await execText('sips', ['-s', 'format', 'png', tiff, '--out', png]);
+        return { data: new Uint8Array(await readFile(png)), mediaType: 'image/png', name: 'clipboard.png' };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+/** Read Finder's file-url pasteboard flavor, which `pbpaste` cannot expose. */
+export async function readMacClipboardFiles() {
+    if (platform() !== 'darwin')
+        return [];
+    const script = [
+        'set output to ""',
+        'try',
+        'if (clipboard info for «class furl») is {} then return output',
+        'set clipboardFiles to the clipboard as «class furl»',
+        'if class of clipboardFiles is list then',
+        'repeat with clipboardFile in clipboardFiles',
+        'try',
+        'set output to output & POSIX path of clipboardFile & linefeed',
+        'end try',
+        'end repeat',
+        'else',
+        'set output to POSIX path of clipboardFiles & linefeed',
+        'end if',
+        'end try',
+        'return output',
+    ].join('\n');
+    try {
+        return (await execText('osascript', ['-e', script])).split(/\r?\n/u).map(line => line.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+async function readLinuxClipboardImage() {
+    try {
+        const types = await execText('wl-paste', ['--list-types']);
+        const mediaType = ['image/png', 'image/jpeg', 'image/webp', 'image/gif']
+            .find(type => types.split(/\s+/u).includes(type));
+        if (mediaType === undefined)
+            return null;
+        return { data: await execBytes('wl-paste', ['--no-newline', '--type', mediaType]), mediaType, name: 'clipboard' + extensionFor(mediaType) };
+    }
+    catch {
+        for (const mediaType of ['image/png', 'image/jpeg', 'image/webp', 'image/gif']) {
+            try {
+                const data = await execBytes('xclip', ['-selection', 'clipboard', '-t', mediaType, '-o']);
+                if (data.byteLength > 0)
+                    return { data, mediaType, name: 'clipboard' + extensionFor(mediaType) };
+            }
+            catch { /* try the next available target */ }
+        }
+        return null;
+    }
+}
+function extensionFor(mediaType) {
+    if (mediaType === 'image/jpeg')
+        return '.jpg';
+    return '.' + mediaType.slice('image/'.length);
+}
+async function readWindowsClipboardImage() {
+    const script = [
+        'Add-Type -AssemblyName System.Windows.Forms',
+        'Add-Type -AssemblyName System.Drawing',
+        '$image = [System.Windows.Forms.Clipboard]::GetImage()',
+        'if ($null -eq $image) { exit 2 }',
+        '$stream = New-Object System.IO.MemoryStream',
+        '$image.Save($stream, [System.Drawing.Imaging.ImageFormat]::Png)',
+        '[Convert]::ToBase64String($stream.ToArray())',
+    ].join('; ');
+    try {
+        const encoded = (await execText('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script])).trim();
+        return encoded === '' ? null : { data: new Uint8Array(Buffer.from(encoded, 'base64')), mediaType: 'image/png', name: 'clipboard.png' };
+    }
+    catch {
+        return null;
+    }
+}
+/** Best-effort native clipboard image reader; null lets text paste take over. */
+export async function readImageFromClipboard() {
+    if (platform() === 'darwin')
+        return readMacClipboardImage();
+    if (platform() === 'win32')
+        return readWindowsClipboardImage();
+    if (platform() === 'linux') {
+        if (process.env.WSL_DISTRO_NAME !== undefined || process.env.WSL_INTEROP !== undefined) {
+            const windows = await readWindowsClipboardImage();
+            if (windows !== null)
+                return windows;
+        }
+        return readLinuxClipboardImage();
+    }
+    return null;
+}
+//# sourceMappingURL=image-paste.js.map

package/lib/image-paste.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @agi-fans/dsh-tui — the omdsh TUI capability seam.
+
+ * Package root is the local terminal provider plugin (apply/Config). Other
+ * runtime capabilities live on explicit plugin subpaths; rendering internals
+ * remain private implementation modules.
+ * @module @agi-fans/dsh-tui
+ */
+export * from './definition.ts';
+export { apply, name, type Config } from './provider-local.ts';

package/lib/index.js

@@ -0,0 +1,11 @@
+/**
+ * @agi-fans/dsh-tui — the omdsh TUI capability seam.
+
+ * Package root is the local terminal provider plugin (apply/Config). Other
+ * runtime capabilities live on explicit plugin subpaths; rendering internals
+ * remain private implementation modules.
+ * @module @agi-fans/dsh-tui
+ */
+export * from "./definition.js";
+export { apply, name } from "./provider-local.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAe,MAAM,qBAAqB,CAAA"}

package/lib/interaction-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Harness human-interaction adapters for the terminal presentation seam.
+ *
+ * Domain services keep ownership of audit, cancellation, and validation;
+ * this module only translates their fixed vocabularies to one Tui prompt.
+ * @module @agi-fans/dsh-tui/interaction-adapter
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { AskUserQuestionItem } from '@deepseek-ai/dsh-user-questions';
+import type { TuiService } from './definition.ts';
+/** Resolve a label/number list while preserving unmatched input as custom text. */
+export declare function parsePromptAnswer(input: string, question: Pick<AskUserQuestionItem, 'options' | 'multiSelect'>): {
+    selected: string[];
+    custom?: string;
+};
+/** Bind the global question provider and route approvals to the active root agent only. */
+export declare function bindHumanInteraction(ctx: Context, tui: TuiService, activeAgent: () => Agent | undefined): () => void;

package/lib/interaction-adapter.js

@@ -0,0 +1,93 @@
+/**
+ * Harness human-interaction adapters for the terminal presentation seam.
+ *
+ * Domain services keep ownership of audit, cancellation, and validation;
+ * this module only translates their fixed vocabularies to one Tui prompt.
+ * @module @agi-fans/dsh-tui/interaction-adapter
+ */
+/** Resolve a label/number list while preserving unmatched input as custom text. */
+export function parsePromptAnswer(input, question) {
+    const options = question.options ?? [];
+    const tokens = question.multiSelect === true ? input.split(',').map(token => token.trim()) : [input.trim()];
+    const selected = [];
+    const custom = [];
+    for (const token of tokens.filter(Boolean)) {
+        const numeric = /^\d+$/u.test(token) ? Number(token) - 1 : -1;
+        const match = numeric >= 0
+            ? options[numeric]
+            : options.find(option => option.label.toLowerCase() === token.toLowerCase());
+        if (match === undefined)
+            custom.push(token);
+        else if (!selected.includes(match.label))
+            selected.push(match.label);
+    }
+    return {
+        selected,
+        ...(custom.length === 0 ? {} : { custom: custom.join(question.multiSelect === true ? ', ' : '') }),
+    };
+}
+async function askQuestions(tui, request) {
+    const answers = [];
+    for (const question of request.questions) {
+        const raw = await tui.prompt({
+            title: question.intent?.kind === 'plan-review' ? 'Plan review' : (question.header ?? 'Question'),
+            question: question.question,
+            ...(question.detail === undefined ? {} : { detail: question.detail }),
+            ...(question.options === undefined ? {} : { options: question.options }),
+            ...(question.multiSelect === undefined ? {} : { multiSelect: question.multiSelect }),
+            ...(question.intent?.kind === 'plan-review'
+                ? { presentation: 'plan-review', approveValue: question.intent.approve }
+                : {}),
+            allowCustom: true,
+            ...(request.signal === undefined ? {} : { signal: request.signal }),
+        });
+        if (raw === null) {
+            answers.push({ id: question.id, selected: [] });
+            continue;
+        }
+        const parsed = parsePromptAnswer(raw, question);
+        answers.push({ id: question.id, ...parsed });
+    }
+    return { answers };
+}
+async function askApproval(tui, request) {
+    const raw = await tui.prompt({
+        title: 'Approval required',
+        question: `Allow ${request.toolName} once?`,
+        ...(request.reason === undefined ? {} : { detail: request.reason }),
+        options: [
+            { label: 'Allow once', description: 'Run only this requested action.' },
+            { label: 'Reject', description: 'Deny this action.' },
+        ],
+        ...(request.signal === undefined ? {} : { signal: request.signal }),
+    });
+    if (raw === null)
+        return 'cancelled';
+    const normalized = raw.trim().toLowerCase();
+    return normalized === '1' || normalized === 'allow' || normalized === 'allow once'
+        || normalized === 'y' || normalized === 'yes'
+        ? 'allowed-once'
+        : 'rejected';
+}
+/** Bind the global question provider and route approvals to the active root agent only. */
+export function bindHumanInteraction(ctx, tui, activeAgent) {
+    const disposers = [];
+    const questions = ctx.get('userQuestions');
+    if (questions !== undefined) {
+        disposers.push(questions.registerProvider({
+            ask: request => askQuestions(tui, request),
+        }));
+    }
+    if (ctx.get('approval') !== undefined) {
+        disposers.push(ctx.on('approval/request', async (request, next) => {
+            if (request.agent !== activeAgent())
+                return next();
+            return askApproval(tui, request);
+        }));
+    }
+    return () => {
+        for (const dispose of disposers.reverse())
+            dispose();
+    };
+}
+//# sourceMappingURL=interaction-adapter.js.map

package/lib/interaction-adapter.js.map

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

package/lib/keybindings-config.d.ts

@@ -0,0 +1,5 @@
+/** User-overridable application keybindings loaded from one JSON document. */
+export type TuiAction = 'external-editor' | 'retry' | 'paste-clipboard' | 'copy-prompt' | 'copy-line';
+export declare const DEFAULT_KEYBINDINGS: Readonly<Record<string, TuiAction>>;
+/** Load `{ "key-id": "action" }`; invalid rows are ignored independently. */
+export declare function loadKeybindings(path: string | undefined): Record<string, TuiAction>;

package/lib/keybindings-config.js

@@ -0,0 +1,28 @@
+/** User-overridable application keybindings loaded from one JSON document. */
+import { readFileSync } from 'node:fs';
+export const DEFAULT_KEYBINDINGS = Object.freeze({
+    'ctrl+x': 'external-editor',
+    'alt+r': 'retry',
+    'ctrl+v': 'paste-clipboard',
+    'alt+c': 'copy-prompt',
+    'ctrl+alt+c': 'copy-line',
+});
+const ACTIONS = ['external-editor', 'retry', 'paste-clipboard', 'copy-prompt', 'copy-line'];
+/** Load `{ "key-id": "action" }`; invalid rows are ignored independently. */
+export function loadKeybindings(path) {
+    const result = { ...DEFAULT_KEYBINDINGS };
+    if (path === undefined)
+        return result;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return result;
+        for (const [key, action] of Object.entries(parsed)) {
+            if (typeof action === 'string' && ACTIONS.includes(action))
+                result[key.toLowerCase()] = action;
+        }
+    }
+    catch { /* missing/malformed user config falls back to shipped bindings */ }
+    return result;
+}
+//# sourceMappingURL=keybindings-config.js.map

package/lib/keybindings-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings-config.js","sourceRoot":"","sources":["../src/keybindings-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAItC,MAAM,CAAC,MAAM,mBAAmB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACpF,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,aAAa;IACtB,YAAY,EAAE,WAAW;CAC1B,CAAC,CAAA;AAEF,MAAM,OAAO,GAAyB,CAAC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,CAAC,CAAA;AAEjH,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,MAAM,MAAM,GAA8B,EAAE,GAAG,mBAAmB,EAAE,CAAA;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAA;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAmB,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,MAAmB,CAAA;QAC1H,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAA;AACf,CAAC"}

package/lib/keys.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Terminal key decoder. Turns raw stdin (legacy CSI, SS3, Kitty CSI-u,
+ * modifyOtherKeys) into the same key-id vocabulary oh-my-pi uses:
+ * `enter`, `ctrl+a`, `alt+left`, `shift+enter`, …
+ * @module @agi-fans/dsh-tui
+ */
+/** One decoded SGR mouse report (`\x1b[<button;col;rowM`). */
+export interface MouseEvent {
+    type: 'mouse';
+    /** Raw button code (bit 32 = motion, bit 64 = wheel). */
+    button: number;
+    /** 0-based column. */
+    col: number;
+    /** 0-based row. */
+    row: number;
+    /** True for a release report (`m` suffix). */
+    release: boolean;
+    /** Wheel direction: -1 up, 1 down, null when not a wheel event. */
+    wheel: -1 | 1 | null;
+    /** Pointer moved (hover or drag). */
+    motion: boolean;
+    /** Left-button press (not motion, release, or wheel). */
+    leftClick: boolean;
+}
+/** One decoded input event. */
+export type KeyEvent = {
+    type: 'key';
+    id: string;
+} | {
+    type: 'text';
+    value: string;
+} | {
+    type: 'paste-start';
+} | {
+    type: 'paste-end';
+} | MouseEvent;
+/** Enable SGR button tracking (wheel + clicks; no motion flood). */
+export declare const MOUSE_TRACKING_ON = "\u001B[?1000h\u001B[?1006h";
+/** Disable the modes enabled by {@link MOUSE_TRACKING_ON}. */
+export declare const MOUSE_TRACKING_OFF = "\u001B[?1006l\u001B[?1000l";
+/** Build `ctrl+shift+alt+name` from a CSI modifier parameter (1 = none). */
+export declare function withMods(name: string, modifier: number): string;
+/**
+ * Decode one SGR mouse report. `data` is the full CSI including ESC
+ * (`\x1b[<64;10;5M`); returns null when the string is not a complete report.
+ */
+export declare function parseSgrMouse(data: string): MouseEvent | null;
+/**
+ * Decode a stdin string into events, leaving an incomplete escape in `rest`.
+ */
+export declare function parseKeys(input: string): {
+    events: KeyEvent[];
+    rest: string;
+};
+/**
+ * Turn a leftover incomplete sequence into events when the ESC timeout fires.
+ * A lone ESC becomes `escape`; anything else is dropped.
+ */
+export declare function flushPending(rest: string): KeyEvent[];