@no-k/hermes 0.1.0 → 0.2.0

package/dist/lib/install.js

@@ -0,0 +1,184 @@
+import { readFileSync, realpathSync } from "node:fs";
+import path from "node:path";
+import { isSourcePath, isUtilityScope } from "./catalog.js";
+import { readDestination, validateFilePlans, writePlannedFile } from "./files.js";
+import { PROJECT_CONFIG_FILENAME, mergeProjectConfig, planProjectConfig, resolveInstallDirectory, } from "./project-config.js";
+import { planInstalledVersions, sourceHash } from "./versions.js";
+function itemNames(names) {
+    const [first, ...rest] = names;
+    if (!first)
+        throw new Error("Specify at least one item.");
+    return [first, ...rest];
+}
+function sourceContent(packageDirectory, relative) {
+    if (!isSourcePath(relative))
+        throw new Error("Invalid source template path: " + relative);
+    const directory = realpathSync(path.join(packageDirectory, "templates"));
+    const file = realpathSync(path.join(directory, relative));
+    const fromRoot = path.relative(directory, file);
+    if (path.isAbsolute(fromRoot) || fromRoot === ".." || fromRoot.startsWith(".." + path.sep)) {
+        throw new Error("Source template escapes its directory: " + relative);
+    }
+    return readFileSync(file, "utf8");
+}
+export function planUtilityFiles(targets, packageDirectory, decisions = []) {
+    if (!targets.length || targets.some((target) => !target.items.length))
+        throw new Error("Specify at least one item.");
+    const choices = new Map();
+    for (const decision of decisions) {
+        const destination = decision.conflict.destination;
+        if (!path.isAbsolute(destination) || choices.has(destination) || !["keep", "replace"].includes(decision.action)) {
+            throw new Error("Invalid or duplicate file decision: " + destination);
+        }
+        choices.set(destination, decision);
+    }
+    const sources = new Map();
+    const outputs = new Map();
+    const items = new Map();
+    const license = readFileSync(path.join(packageDirectory, "LICENSE"), "utf8");
+    for (const target of targets) {
+        if (!path.isAbsolute(target.directory))
+            throw new Error("Expected an absolute destination: " + target.directory);
+        for (const item of target.items) {
+            items.set(item.name, item);
+            for (const file of [...item.files, "LICENSE"]) {
+                let content = sources.get(file);
+                if (content === undefined) {
+                    content = file === "LICENSE" ? license : sourceContent(packageDirectory, file);
+                    sources.set(file, content);
+                }
+                if (file !== "LICENSE") {
+                    const expected = item.modules
+                        .flatMap((module) => Object.entries(module.files))
+                        .find(([source]) => source === file)?.[1];
+                    if (!expected || sourceHash(content) !== expected)
+                        throw new Error("Template does not match module version: " + file);
+                }
+                const destination = path.join(target.directory, file);
+                const previous = outputs.get(destination);
+                if (previous && previous.content !== content)
+                    throw new Error("Selected sources conflict at: " + destination);
+                if (previous)
+                    previous.names.add(item.name);
+                else
+                    outputs.set(destination, { file, content, names: new Set([item.name]) });
+            }
+        }
+    }
+    const conflicts = [];
+    const files = [...outputs]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([destination, source]) => {
+        const existingContent = readDestination(destination);
+        let action = existingContent === null ? "create" : "keep";
+        if (existingContent !== null && existingContent !== source.content) {
+            const conflict = {
+                file: source.file,
+                content: source.content,
+                destination,
+                existingContent,
+                names: itemNames([...source.names]),
+            };
+            conflicts.push(conflict);
+            const decision = choices.get(destination);
+            if (decision?.action === "replace" &&
+                decision.conflict.existingContent === existingContent &&
+                decision.conflict.content === source.content)
+                action = "replace";
+        }
+        return { file: source.file, content: source.content, destination, existingContent, action };
+    });
+    validateFilePlans(files);
+    const selected = [...items.values()];
+    return {
+        files,
+        conflicts,
+        dependencies: [...new Set(selected.flatMap((item) => item.dependencies))].sort(),
+        devDependencies: [...new Set(selected.flatMap((item) => item.devDependencies ?? []))].sort(),
+        runtimeRequirements: selected.flatMap((item) => (item.runtime ? [{ name: item.name, runtime: item.runtime }] : [])),
+    };
+}
+export function createInstallPlan(request, catalog, packageDirectory) {
+    if (!path.isAbsolute(request.config.destination) ||
+        path.basename(request.config.destination) !== PROJECT_CONFIG_FILENAME) {
+        throw new Error("Expected an absolute no-k.config.ts destination.");
+    }
+    const cwd = path.dirname(request.config.destination);
+    const seenScopes = new Set();
+    const seenNames = new Set();
+    const targets = request.targets.map((target) => {
+        if (!isUtilityScope(target.scope) || seenScopes.has(target.scope)) {
+            throw new Error("Invalid or duplicate installation scope: " + target.scope);
+        }
+        seenScopes.add(target.scope);
+        const items = target.names.map((name) => {
+            const item = catalog.items.find((candidate) => candidate.name === name);
+            if (!item || seenNames.has(name))
+                throw new Error("Unknown or duplicate installation item: " + name);
+            if (item.scope !== target.scope) {
+                throw new Error("Installation scope mismatch for " + name + ": expected " + item.scope + ".");
+            }
+            seenNames.add(name);
+            return item;
+        });
+        return { items, directory: resolveInstallDirectory(target.directory, cwd) };
+    });
+    const utilities = planUtilityFiles(targets, packageDirectory, request.fileDecisions);
+    const { config, dependencies, compatibilityErrors, compatibilityGuards } = planInstalledVersions(mergeProjectConfig(request.config, request.targets), targets, utilities.files, catalog, cwd);
+    const configFile = planProjectConfig(request.config, config);
+    validateFilePlans([...utilities.files, configFile]);
+    return {
+        ...request,
+        ...utilities,
+        dependencies,
+        configFile,
+        nextConfig: config,
+        compatibilityErrors,
+        compatibilityGuards,
+    };
+}
+export class InstallExecutionError extends Error {
+    phase;
+    completedFiles;
+    constructor(phase, completedFiles, cause) {
+        super((phase === "config"
+            ? "Utilities were processed, but no-k.config.ts could not be saved: "
+            : "Installation stopped before saving no-k.config.ts: ") +
+            (cause instanceof Error ? cause.message : String(cause)), { cause });
+        this.phase = phase;
+        this.completedFiles = completedFiles;
+        this.name = "InstallExecutionError";
+    }
+}
+export function executeInstallPlan(plan, onFile) {
+    if (plan.compatibilityErrors.length)
+        throw new Error("Incompatible installation; no files were written:\n" + plan.compatibilityErrors.join("\n"));
+    validateFilePlans(plan.compatibilityGuards);
+    validateFilePlans([...plan.files, plan.configFile]);
+    if (plan.dryRun)
+        return { status: "dry-run", files: plan.files, configFile: plan.configFile };
+    const completed = [];
+    try {
+        for (const file of plan.files) {
+            writePlannedFile(file);
+            completed.push(file);
+            onFile?.(file);
+        }
+        // 생성·교체·유지한 파일을 다시 검사한 다음에만 설치 기록을 저장한다.
+        for (const file of plan.files) {
+            const expected = file.action === "keep" ? file.existingContent : file.content;
+            if (readDestination(file.destination) !== expected)
+                throw new Error("Installed file changed: " + file.destination);
+        }
+    }
+    catch (error) {
+        throw new InstallExecutionError("files", completed, error);
+    }
+    try {
+        writePlannedFile(plan.configFile);
+    }
+    catch (error) {
+        throw new InstallExecutionError("config", completed, error);
+    }
+    return { status: "completed", files: completed, configFile: plan.configFile };
+}

package/dist/lib/installation-status.js

@@ -0,0 +1,80 @@
+import path from "node:path";
+import { readDestination } from "./files.js";
+import { sourceHash } from "./versions.js";
+const labels = {
+    present: "이미 설치됨",
+    modified: "설치됨 · 로컬 수정",
+    unverified: "설치됨 · 버전 기록 없음",
+    partial: "설치 기록 있음 · 일부 파일 없음",
+    missing: "설치 기록만 있음 · 파일 없음",
+    unreadable: "설치 위치 확인 불가",
+};
+export function describeInstallation(value) {
+    return `${labels[value.status]}${value.version ? " @" + value.version : ""} — ${value.directory}`;
+}
+// 설치 기록과 실제 파일을 대조한다. UI 표시용이며 설치 시점의 검증을 대체하지 않는다.
+export function inspectInstallations(catalog, config) {
+    const result = new Map();
+    if (config.status === "missing")
+        return new Map();
+    const cwd = path.dirname(config.destination);
+    const known = new Map(catalog.items.map((item) => [item.name, item]));
+    for (const record of config.value.installed) {
+        const directory = path.resolve(cwd, record.directory);
+        const item = known.get(record.name);
+        const candidates = record.source?.modules.map((module) => ({ name: module.name, version: module.version, files: module.files })) ??
+            [];
+        if (item) {
+            candidates.push({
+                name: item.name,
+                version: record.source?.modules.find((module) => module.name === item.name)?.version ?? "",
+                files: record.source
+                    ? Object.fromEntries(record.source.modules.flatMap((module) => Object.entries(module.files)))
+                    : Object.fromEntries(item.files.map((file) => [file, ""])),
+            });
+        }
+        for (const candidate of candidates) {
+            if (known.has(candidate.name)) {
+                const locations = result.get(candidate.name) ?? new Map();
+                const previous = locations.get(directory);
+                if (!previous || previous.via !== candidate.name || record.name === candidate.name) {
+                    let count = 0;
+                    let changed = false;
+                    let unreadable = false;
+                    for (const [file, hash] of Object.entries(candidate.files)) {
+                        try {
+                            const content = readDestination(path.join(directory, file));
+                            if (content !== null) {
+                                count++;
+                                if (hash && sourceHash(content) !== hash)
+                                    changed = true;
+                            }
+                        }
+                        catch {
+                            unreadable = true;
+                        }
+                    }
+                    const status = unreadable
+                        ? "unreadable"
+                        : !count
+                            ? "missing"
+                            : count < Object.keys(candidate.files).length
+                                ? "partial"
+                                : changed
+                                    ? "modified"
+                                    : candidate.version
+                                        ? "present"
+                                        : "unverified";
+                    locations.set(directory, {
+                        directory,
+                        status,
+                        ...(candidate.version ? { version: candidate.version } : {}),
+                        via: record.name,
+                    });
+                    result.set(candidate.name, locations);
+                }
+            }
+        }
+    }
+    return new Map([...result].map(([name, locations]) => [name, [...locations.values()]]));
+}

package/dist/lib/json.js

@@ -0,0 +1,19 @@
+import { readFileSync } from "node:fs";
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function readJson(file) {
+    return JSON.parse(readFileSync(file, "utf8"));
+}
+export function readJsonObject(file) {
+    const value = readJson(file);
+    if (!isRecord(value))
+        throw new Error("Expected a JSON object: " + file);
+    return value;
+}
+export function readPackageVersion(file) {
+    const manifest = readJsonObject(file);
+    if (typeof manifest.version !== "string")
+        throw new Error("Invalid package version: " + file);
+    return manifest.version;
+}

package/dist/lib/picker-view.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text, useWindowSize } from "ink";
+import { useTerminalInput } from "./terminal-input.js";
+import { Line, theme } from "./terminal-style.js";
+import { fitTerminalLine, terminalText, wrapTerminalLines } from "./terminal-text.js";
+export function PickerApp({ picker, onKey, onPaste, }) {
+    useTerminalInput(onKey, onPaste);
+    const { columns, rows } = useWindowSize();
+    return _jsx(PickerView, { picker: picker, columns: columns || 80, rows: rows || 24 });
+}
+function detailColor(line) {
+    if (line.startsWith("+") && !line.startsWith("+++"))
+        return theme.accent;
+    if (line.startsWith("-") && !line.startsWith("---"))
+        return "#ff8b9d";
+    if (/^(함께 생성|실행 환경|npm 의존성|peer 호환|@@)/u.test(line))
+        return theme.purple;
+    return undefined;
+}
+export function PickerView({ picker, columns, rows }) {
+    const width = Math.max(1, columns - 1);
+    const height = Math.max(1, rows - 1);
+    const usable = width >= 20 && height >= 7;
+    const compact = width < 64 || height < 20;
+    const headerRows = compact ? 3 : 9;
+    const footerRows = compact ? 2 : 3;
+    const bodyRows = Math.max(1, height - headerRows - footerRows);
+    const listRows = compact ? bodyRows : bodyRows - 2;
+    const rowHeight = compact ? 1 : 2;
+    const pageSize = Math.max(1, Math.floor(listRows / rowHeight));
+    picker.viewport(pageSize, usable);
+    if (!usable)
+        return (_jsxs(Box, { width: width, height: height, flexDirection: "column", children: [_jsx(Text, { color: theme.warning, children: "\uD130\uBBF8\uB110\uC744 \uB113\uD600 \uC8FC\uC138\uC694." }), _jsx(Text, { children: "\uCD5C\uC18C 21\uC5F4 \u00D7 8\uD589" }), _jsx(Text, { dimColor: true, children: "q \uCDE8\uC18C \u00B7 Ctrl+C \uC911\uB2E8" })] }));
+    const { choices, index, choice } = picker.focus();
+    const selected = picker.values();
+    const hidden = selected.filter((id) => !choices.some((entry) => entry.id === id)).length;
+    const start = Math.max(0, Math.min(index - Math.floor(pageSize / 2), choices.length - pageSize));
+    const split = !compact && width >= 100 && !picker.detail;
+    const leftWidth = split ? Math.floor(width * 0.55) : width;
+    const contentWidth = leftWidth - (compact ? 0 : 4);
+    const stage = picker.request.stage ?? "utility";
+    const stageIndex = ["scope", "category", "utility"].indexOf(stage);
+    const heading = picker.request.title.replace(" · 대분류 선택", "");
+    const summary = picker.notice || picker.request.summary(selected);
+    const search = picker.searching
+        ? ` / ${picker.state.query}▏`
+        : picker.state.query
+            ? ` / ${picker.state.query}`
+            : " / 이름이나 설명으로 검색";
+    const detail = picker.detail ? picker.detailLines(width - (compact ? 0 : 4), Math.max(1, listRows)) : undefined;
+    const shortcuts = picker.detail
+        ? [
+            ["↑↓", "스크롤"],
+            ["Enter", "닫기"],
+            ["Esc", "목록"],
+        ]
+        : picker.searching
+            ? [
+                ["Enter", "검색 완료"],
+                ["Esc", "초기화"],
+                ["Ctrl+C", "취소"],
+            ]
+            : [
+                ["↑↓", "이동"],
+                ["Space", "선택"],
+                ["Enter", "다음"],
+            ];
+    return (_jsxs(Box, { width: width, height: height, flexDirection: "column", children: [compact ? (_jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, color: theme.accent, children: ["\u25C8 HERMES ", _jsxs(Text, { color: theme.muted, children: ["\u00B7 ", picker.detail ? "상세" : "선택"] })] }), _jsx(Line, { text: heading, width: width, bold: true }), _jsx(Line, { text: picker.searching || picker.state.query ? search : summary, width: width, color: picker.notice ? theme.warning : theme.muted })] })) : (_jsxs(_Fragment, { children: [_jsxs(Box, { height: 2, justifyContent: "space-between", children: [_jsxs(Text, { color: theme.accent, bold: true, children: [" ", "\u25C8 H E R M E S ", _jsx(Text, { color: theme.purple, children: " / " }), _jsx(Text, { color: theme.muted, children: "CATALOG" })] }), _jsxs(Text, { color: theme.accent, children: [selected.length.toString().padStart(2, "0"), " CHECKED "] })] }), _jsx(Box, { height: 2, gap: 2, children: stage === "conflict" ? (_jsxs(Text, { color: theme.warning, children: ["\u25C6 \uD30C\uC77C \uAC80\uD1A0 ", _jsx(Text, { dimColor: true, children: "\uCCB4\uD06C\uD55C \uD30C\uC77C\uB9CC \uAD50\uCCB4\uD569\uB2C8\uB2E4" })] })) : (["대분류", "하위 분류", "유틸 선택"].map((label, step) => (_jsxs(Text, { color: step === stageIndex ? theme.accent : theme.muted, bold: step === stageIndex, children: [step < stageIndex ? "✓" : `0${step + 1}`, " ", label, step < 2 ? "  ──" : ""] }, label)))) }), _jsx(Line, { text: heading, width: width, bold: true }), _jsx(Line, { text: picker.request.breadcrumb?.join("  /  ") || "필요한 도구를 골라 내 프로젝트에 추가하세요.", width: width, color: theme.muted }), _jsx(Box, { height: 3, width: width, borderStyle: "round", borderColor: picker.searching ? theme.accent : theme.border, paddingX: 1, children: _jsx(Line, { text: search, width: width - 4, color: picker.searching ? theme.accent : theme.muted }) })] })), _jsxs(Box, { height: bodyRows, flexDirection: "row", gap: split ? 1 : 0, children: [_jsx(Box, { width: leftWidth, height: bodyRows, flexDirection: "column", borderStyle: compact ? undefined : "round", borderColor: picker.detail ? theme.purple : theme.border, paddingX: compact ? 0 : 1, overflow: "hidden", children: detail ? (detail.lines.map((line, i) => (_jsx(Line, { text: line, width: contentWidth, color: detailColor(line) }, detail.offset + i)))) : choices.length ? (choices.slice(start, start + pageSize).map((entry) => {
+                            const focused = entry.id === choice?.id;
+                            const checked = picker.selected.has(entry.id);
+                            return (_jsxs(Box, { height: rowHeight, flexDirection: "column", flexShrink: 0, backgroundColor: focused ? theme.focus : undefined, children: [_jsx(Text, { color: focused ? theme.bright : checked ? theme.accent : undefined, bold: focused, wrap: "truncate-end", children: fitTerminalLine(`${focused ? "❯" : " "} ${checked ? "◉" : "○"} ${entry.label}`, contentWidth) }), !compact && (_jsx(Line, { text: "    " + entry.summary, width: contentWidth, color: focused ? theme.bright : theme.muted }))] }, entry.id));
+                        })) : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.warning, children: "\uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC5B4\uC694." }), _jsx(Text, { dimColor: true, children: "/ \uAC80\uC0C9 \uC218\uC815 \u00B7 Ctrl+L \uCD08\uAE30\uD654" })] })) }), split && (_jsxs(Box, { width: width - leftWidth - 1, height: bodyRows, borderStyle: "round", borderColor: theme.purple, paddingX: 1, flexDirection: "column", overflow: "hidden", children: [_jsxs(Text, { bold: true, color: theme.purple, children: ["INSPECT ", _jsx(Text, { dimColor: true, children: "\u00B7 Tab \uC804\uCCB4 \uBCF4\uAE30" })] }), _jsx(Box, { height: 1 }), wrapTerminalLines(choice?.details() ?? ["항목을 고르면 정보가 표시됩니다."], width - leftWidth - 5)
+                                .slice(0, bodyRows - 4)
+                                .map((line, i) => (_jsx(Line, { text: line, width: width - leftWidth - 5, color: detailColor(line) }, i)))] }))] }), _jsxs(Box, { height: footerRows, flexDirection: "column", children: [_jsx(Line, { text: detail
+                            ? `상세 ${detail.offset + 1}–${Math.min(detail.total, detail.offset + detail.lines.length)}/${detail.total} · ↑↓ 스크롤 · Esc 닫기`
+                            : `${summary} · ${choices.length ? index + 1 : 0}/${choices.length}${hidden ? ` · 검색 밖 ${hidden}개` : ""}`, width: width, color: picker.notice ? theme.warning : theme.accent }), _jsx(Text, { wrap: "truncate-end", children: shortcuts.map(([key, description], index) => (_jsxs(Text, { children: [_jsx(Text, { color: index === 2 ? theme.accent : theme.purple, bold: true, children: key }), _jsx(Text, { dimColor: true, children: ` ${description}${index < 2 ? "  " : ""}` })] }, key))) }), !compact && (_jsx(Text, { dimColor: true, children: terminalText(picker.detail
+                            ? "PgUp/PgDn 페이지 · Home/End 처음/끝 · Esc 목록 · q 취소"
+                            : picker.searching
+                                ? "입력 중에는 Space도 검색어입니다. · Ctrl+L 검색 초기화"
+                                : "/ 검색 · a 검색 결과 전체 선택 · Tab 상세 · Esc 이전 · q 취소 · j/k 이동") }))] })] }));
+}

package/dist/lib/picker.js

@@ -0,0 +1,135 @@
+import { removeLastGrapheme, wrapTerminalLines } from "./terminal-text.js";
+export class Picker {
+    request;
+    selected;
+    state;
+    searching = false;
+    detail = false;
+    notice;
+    detailOffset = 0;
+    detailLength = 0;
+    pageSize = 1;
+    tooSmall = false;
+    constructor(request) {
+        this.request = request;
+        this.selected = new Set(request.selected.filter((id) => request.choices.some((choice) => choice.id === id)));
+        this.state = { query: "", ...request.state };
+        this.notice = request.notice ?? "";
+    }
+    values() {
+        return this.request.choices.filter((choice) => this.selected.has(choice.id)).map((choice) => choice.id);
+    }
+    visible() {
+        return this.request.choices.filter((choice) => !this.state.query.trim() || choice.matches(this.state.query));
+    }
+    focus() {
+        const choices = this.visible();
+        const index = Math.max(0, choices.findIndex((choice) => choice.id === this.state.focusedId));
+        const choice = choices[index];
+        this.state.focusedId = choice?.id;
+        return { choices, index, ...(choice ? { choice } : {}) };
+    }
+    viewport(pageSize, usable) {
+        this.pageSize = Math.max(1, pageSize);
+        this.tooSmall = !usable;
+    }
+    detailLines(columns, rows) {
+        const choice = this.focus().choice;
+        const lines = wrapTerminalLines(choice?.details() ?? [], columns);
+        this.detailLength = lines.length;
+        this.pageSize = Math.max(1, rows);
+        this.detailOffset = Math.min(this.detailOffset, Math.max(0, lines.length - this.pageSize));
+        return {
+            lines: lines.slice(this.detailOffset, this.detailOffset + this.pageSize),
+            offset: this.detailOffset,
+            total: lines.length,
+        };
+    }
+    key(text, key) {
+        if (key.ctrl && key.name === "c")
+            return { status: "cancelled", reason: "interrupt" };
+        if (key.ctrl && key.name === "d")
+            return { status: "cancelled", reason: "eof" };
+        if (this.tooSmall)
+            return text === "q" ? { status: "cancelled", reason: "cancel" } : undefined;
+        const { choices, index, choice } = this.focus();
+        const movement = key.name === "up" || (!this.searching && text === "k") || (key.ctrl && key.name === "p")
+            ? -1
+            : key.name === "down" || (!this.searching && text === "j") || (key.ctrl && key.name === "n")
+                ? 1
+                : key.name === "pageup"
+                    ? -this.pageSize
+                    : key.name === "pagedown"
+                        ? this.pageSize
+                        : 0;
+        if (this.detail) {
+            if (key.name === "escape" || key.name === "return" || key.name === "tab" || text === "?")
+                this.detail = false;
+            else if (text === "q")
+                return { status: "cancelled", reason: "cancel" };
+            else {
+                const offset = key.name === "home" ? 0 : key.name === "end" ? this.detailLength : this.detailOffset + movement;
+                this.detailOffset = Math.max(0, Math.min(Math.max(0, this.detailLength - this.pageSize), offset));
+            }
+            return;
+        }
+        if (movement || key.name === "home" || key.name === "end") {
+            const next = key.name === "home" ? 0 : key.name === "end" ? choices.length - 1 : index + movement;
+            this.state.focusedId = choices[Math.max(0, Math.min(choices.length - 1, next))]?.id;
+            return;
+        }
+        if (key.ctrl && key.name === "l") {
+            this.state.query = "";
+            return;
+        }
+        if (this.searching) {
+            if (key.name === "return")
+                this.searching = false;
+            else if (key.name === "escape") {
+                this.state.query = "";
+                this.searching = false;
+            }
+            else if (key.name === "backspace")
+                this.state.query = removeLastGrapheme(this.state.query);
+            else if (key.ctrl && key.name === "u")
+                this.state.query = "";
+            else if (!key.ctrl && !key.meta && text && !/[\p{Cc}\p{Cs}]/u.test(text))
+                this.state.query += text;
+            this.notice = "";
+            return;
+        }
+        if (text === "/")
+            this.searching = true;
+        else if (text === "q")
+            return { status: "cancelled", reason: "cancel" };
+        else if (key.name === "escape")
+            return { status: "back", selected: this.values(), state: { ...this.state } };
+        else if ((key.name === "tab" || text === "?") && choice) {
+            this.detail = true;
+            this.detailOffset = 0;
+        }
+        else if (key.name === "space" && choice) {
+            if (this.selected.has(choice.id))
+                this.selected.delete(choice.id);
+            else
+                this.selected.add(choice.id);
+            this.notice = "";
+        }
+        else if (text === "a") {
+            const clear = choices.every((entry) => this.selected.has(entry.id));
+            for (const entry of choices) {
+                if (clear)
+                    this.selected.delete(entry.id);
+                else
+                    this.selected.add(entry.id);
+            }
+            this.notice = "";
+        }
+        else if (key.name === "return") {
+            const selected = this.values();
+            this.notice = this.request.validate?.(selected) ?? "";
+            if (!this.notice)
+                return { status: "next", selected, state: { ...this.state } };
+        }
+    }
+}