@sagmans/dsh-tui 0.6.0 → 0.7.0

package/lib/gates.d.ts

@@ -70,6 +70,7 @@ export interface GateCustomRow {
     /** Whether a custom answer is being formed or already holds text. */
     readonly selected: boolean;
 }
+export declare function lines(value: string): string[];
 /**
  * One pending approval.
  *
@@ -110,119 +111,6 @@ export interface GateAnswer {
     readonly selected: readonly string[];
     readonly custom?: string;
 }
-/**
- * Read the seam's request into the gate's own vocabulary.
- *
- * A question without options is answered by typing, which is why it becomes an
- * option-less gate rather than a rejected request: the model asked for text.
- */
-export declare function toGateQuestions(request: unknown): GateQuestion[];
 /** The number the free-text row answers for. It sits below the window, so drawn numbering runs 1..n then 0. */
 export declare const CUSTOM_ROW_NUMBER = 0;
-/**
- * A pending batch of questions.
- *
- * Answers are collected per question and returned in the seam's shape. An
- * escape skips the current question with an empty selection rather than
- * aborting the batch, so a human who cannot answer one question still returns
- * everything else they decided.
- */
-export declare class QuestionGate {
-    private readonly questions;
-    /** The editor every typed answer is written in, whichever row asks for it. */
-    private readonly input;
-    /** The keys in force, read per press so a settings edit lands on the next key. */
-    private readonly keys;
-    private index;
-    private cursor;
-    private typed;
-    /** Whether the cursor is on the free-text row. */
-    private atCustom;
-    /**
-     * The row an escape from the free-text row returns to.
-     *
-     * It is the row the reader last acted on — walked to, picked by its number, or
-     * toggled — because that is the option they were looking at when they decided
-     * to answer freely, and it is not always the row the cursor still stands on: a
-     * digit picks by number without walking anywhere.
-     */
-    private customFrom;
-    private readonly chosen;
-    private readonly custom;
-    private finished;
-    constructor(questions: readonly GateQuestion[], 
-    /** The editor every typed answer is written in, whichever row asks for it. */
-    input: GateInput, 
-    /** The keys in force, read per press so a settings edit lands on the next key. */
-    keys: () => Keymap);
-    /**
-     * Empty the editor for the question now under the cursor.
-     *
-     * The editor belongs to the surface and outlives one question, so an answer
-     * must never cross from the last question into the next — or from a gate that
-     * was abandoned into the one that follows it. Its mode follows the question
-     * for the same reason: a credential must not be shown because the last
-     * question was not one.
-     */
-    private resetInput;
-    get resolved(): boolean;
-    /**
-     * Stop a question whose caller is gone.
-     *
-     * WHY: an aborted call has no reader for the answer, and a live gate would
-     * otherwise keep the keyboard — and the borrowed editor — until someone
-     * typed into a call that had already ended.
-     */
-    cancel(): void;
-    private get current();
-    /**
-     * Options the typed filter leaves, in the order they were listed.
-     *
-     * The order is not the score order a picker uses: a digit answers by
-     * position, and re-ranking rows would move the number the reader just read.
-     */
-    private matched;
-    /**
-     * The rows the keys and the card agree on: the filter, then a window around
-     * the cursor, because a list as long as a provider catalog would otherwise
-     * push the editor off the screen.
-     */
-    private windowed;
-    /** The row under the cursor, as the filter leaves it. */
-    private currentRow;
-    /** Take or drop one source option, by single-select replacement or multi-select toggle. */
-    private pick;
-    /**
-     * Whether a keystroke is answer text rather than a filter.
-     *
-     * A question without options has no list to filter, and the free-text row is
-     * where a question with options collects an answer the model did not list.
-     */
-    private typingAnswer;
-    /** Add text to the filter, or to the answer the current row collects. */
-    private absorb;
-    /** Apply one key press; returns the batch answer the first time it completes. */
-    handleKey(data: string): GateAnswer[] | undefined;
-    /**
-     * One key press while the free-text row holds the cursor.
-     *
-     * Walking back to the list keeps whatever was typed, so a reader who changes
-     * their mind about answering freely has not lost the text yet. An escape
-     * leaves the row the same way, because a question skipped by accident is a
-     * question the reader has to answer again: from the list, where every other
-     * question is skipped, an escape skips this one too.
-     */
-    private handleCustomKey;
-    /** Take the answer the reader confirmed, then leave the question. */
-    private confirm;
-    /**
-     * Leave the current question for the next one.
-     *
-     * Typed text belongs to the question being left, so it never crosses into the
-     * next one — which is why a skipped question reports no typed answer at all.
-     */
-    private advance;
-    private result;
-    card(): GateCard;
-}
 //# sourceMappingURL=gates.d.ts.map

package/lib/gates.d.ts.map

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

package/lib/gates.js

@@ -1,8 +1,5 @@
-import { matchesKey } from '@earendil-works/pi-tui';
 import { actionLabel, keyName, keysFor, matchesAction } from "./input/actions.js";
-import { pastedText } from "./input.js";
-import { matchScore } from "./input/match.js";
-function lines(value) {
+export function lines(value) {
     return value.split('\n').filter(line => line.trim() !== '');
 }
 /**
@@ -59,486 +56,6 @@ export class ApprovalGate {
         };
     }
 }
-function asRecord(value) {
-    return typeof value === 'object' && value !== null ? value : undefined;
-}
-/**
- * Read the seam's request into the gate's own vocabulary.
- *
- * A question without options is answered by typing, which is why it becomes an
- * option-less gate rather than a rejected request: the model asked for text.
- */
-export function toGateQuestions(request) {
-    const record = asRecord(request);
-    const raw = Array.isArray(record?.questions) ? record.questions : [];
-    const questions = [];
-    for (const item of raw) {
-        const entry = asRecord(item);
-        if (entry === undefined || typeof entry.id !== 'string')
-            continue;
-        const options = (Array.isArray(entry.options) ? entry.options : []).flatMap(option => {
-            const candidate = asRecord(option);
-            if (candidate === undefined || typeof candidate.label !== 'string')
-                return [];
-            return [{
-                    label: candidate.label,
-                    description: typeof candidate.description === 'string' ? candidate.description : undefined,
-                }];
-        });
-        questions.push({
-            id: entry.id,
-            question: typeof entry.question === 'string' ? entry.question : 'question',
-            header: typeof entry.header === 'string' ? entry.header : undefined,
-            detail: typeof entry.detail === 'string' ? entry.detail : undefined,
-            options,
-            multiSelect: entry.multiSelect === true,
-        });
-    }
-    return questions;
-}
-/** How many option rows a question shows at once, so a catalog-sized list leaves the editor in view. */
-const QUESTION_WINDOW = 12;
 /** The number the free-text row answers for. It sits below the window, so drawn numbering runs 1..n then 0. */
 export const CUSTOM_ROW_NUMBER = 0;
-/** The label a question earns for an answer the model did not list. */
-const CUSTOM_ROW_LABEL = 'other';
-/** What the free-text row does, said where the reader decides. */
-const CUSTOM_ROW_DESCRIPTION = 'type your own answer';
-/** How the list hint names that row, which the row itself already labels. */
-const CUSTOM_ROW_SHORTHAND = `${CUSTOM_ROW_NUMBER} answer freely`;
-/**
- * How a hint names the keys of one action.
- *
- * A hint is prose about what a key does here, so the word comes from the card
- * rather than from the catalog row, which has to read well out of context too.
- */
-function namedKeys(map, id, verb) {
-    // One verb for the action, however many keys reach it: a hint that repeated
-    // the word would read as two actions rather than two ways to do one.
-    return `${keysFor(map, id).map(keyName).join('/')} ${verb}`;
-}
-/**
- * How the free-text row spells the keys that leave it.
- *
- * A text field keeps its own exits: the arrows and escape are the field's, not
- * the question's, so a reader who moved question.up or question.skip somewhere
- * else still leaves with these. The question's own movement keys leave it as
- * well, which is how the navigation aliases reach a reader who is typing rather
- * than filtering. The arrows stay one token because they are pinned together
- * rather than listed one direction at a time.
- */
-function customRowExits(map) {
-    const names = ['↑↓'];
-    for (const id of ['question.up', 'question.down']) {
-        for (const key of keysFor(map, id)) {
-            const name = keyName(key);
-            if (name !== 'up' && name !== 'down' && !names.includes(name))
-                names.push(name);
-        }
-    }
-    return names.join('/');
-}
-/**
- * Whether a press leaves the free-text row for the option list.
- *
- * The arrows are the field's own, so they leave whatever the map says, which
- * keeps a reader who moved the question keys from being stranded in the field;
- * the question's own keys follow the map so a rebound alias still works here.
- */
-function leavesCustomRow(map, data) {
-    return matchesKey(data, 'up') || matchesKey(data, 'down')
-        || matchesAction(map, 'question.up', data) || matchesAction(map, 'question.down', data);
-}
-/** The keys that answer the free-text row, where typing is the answer rather than a filter. */
-function customHint(map) {
-    return `type or paste an answer · ${namedKeys(map, 'question.confirm', 'confirm')} · ${namedKeys(map, 'question.cancel', 'abandon')} · ${customRowExits(map)} or esc to options`;
-}
-/**
- * The question-id suffix that declares a typed answer a credential. The seam
- * has no field for it, so a caller marks its own id and the gate reads that
- * declaration rather than the wording: ids are caller-owned, and a question
- * that merely mentions a key must still show the answer its author meant read.
- */
-const SECRET_ID_SUFFIX = ':secret';
-/** The free-text row's label when the answer is a credential, so the reader sees what they hand over. */
-const SECRET_ROW_LABEL = 'API KEY';
-/** Whether a question declares its typed answer a credential through its id. */
-function declaresSecret(id) {
-    return id.endsWith(SECRET_ID_SUFFIX);
-}
-/**
- * A pending batch of questions.
- *
- * Answers are collected per question and returned in the seam's shape. An
- * escape skips the current question with an empty selection rather than
- * aborting the batch, so a human who cannot answer one question still returns
- * everything else they decided.
- */
-export class QuestionGate {
-    questions;
-    input;
-    keys;
-    index = 0;
-    cursor = 0;
-    typed = '';
-    /** Whether the cursor is on the free-text row. */
-    atCustom = false;
-    /**
-     * The row an escape from the free-text row returns to.
-     *
-     * It is the row the reader last acted on — walked to, picked by its number, or
-     * toggled — because that is the option they were looking at when they decided
-     * to answer freely, and it is not always the row the cursor still stands on: a
-     * digit picks by number without walking anywhere.
-     */
-    customFrom = 0;
-    chosen = [];
-    custom = [];
-    finished = false;
-    constructor(questions, 
-    /** The editor every typed answer is written in, whichever row asks for it. */
-    input, 
-    /** The keys in force, read per press so a settings edit lands on the next key. */
-    keys) {
-        this.questions = questions;
-        this.input = input;
-        this.keys = keys;
-        for (const _ of questions) {
-            this.chosen.push([]);
-            this.custom.push(undefined);
-        }
-        this.resetInput();
-    }
-    /**
-     * Empty the editor for the question now under the cursor.
-     *
-     * The editor belongs to the surface and outlives one question, so an answer
-     * must never cross from the last question into the next — or from a gate that
-     * was abandoned into the one that follows it. Its mode follows the question
-     * for the same reason: a credential must not be shown because the last
-     * question was not one.
-     */
-    resetInput() {
-        this.input.setText('');
-        this.input.setMode?.(this.current !== undefined && declaresSecret(this.current.id) ? 'secret' : 'answer');
-    }
-    get resolved() {
-        return this.finished;
-    }
-    /**
-     * Stop a question whose caller is gone.
-     *
-     * WHY: an aborted call has no reader for the answer, and a live gate would
-     * otherwise keep the keyboard — and the borrowed editor — until someone
-     * typed into a call that had already ended.
-     */
-    cancel() {
-        this.finished = true;
-    }
-    get current() {
-        return this.questions[this.index];
-    }
-    /**
-     * Options the typed filter leaves, in the order they were listed.
-     *
-     * The order is not the score order a picker uses: a digit answers by
-     * position, and re-ranking rows would move the number the reader just read.
-     */
-    matched(question) {
-        const needle = this.typed.trim();
-        return question.options
-            .map((option, position) => ({ option, position }))
-            .filter(({ option }) => matchScore(needle, `${option.label} ${option.description ?? ''}`) !== undefined);
-    }
-    /**
-     * The rows the keys and the card agree on: the filter, then a window around
-     * the cursor, because a list as long as a provider catalog would otherwise
-     * push the editor off the screen.
-     */
-    windowed(question) {
-        const matched = this.matched(question);
-        const cursor = Math.min(this.cursor, Math.max(0, matched.length - 1));
-        const start = Math.max(0, Math.min(cursor - Math.floor(QUESTION_WINDOW / 2), matched.length - QUESTION_WINDOW));
-        return { rows: matched.slice(start, start + QUESTION_WINDOW), start, cursor };
-    }
-    /** The row under the cursor, as the filter leaves it. */
-    currentRow(question) {
-        const matched = this.matched(question);
-        return matched[Math.min(this.cursor, Math.max(0, matched.length - 1))];
-    }
-    /** Take or drop one source option, by single-select replacement or multi-select toggle. */
-    pick(position) {
-        const question = this.current;
-        const option = question?.options[position];
-        if (question === undefined || option === undefined)
-            return;
-        const chosen = this.chosen[this.index] ?? [];
-        this.chosen[this.index] = chosen.includes(option.label)
-            ? chosen.filter(label => label !== option.label)
-            : question.multiSelect === true ? [...chosen, option.label] : [option.label];
-    }
-    /**
-     * Whether a keystroke is answer text rather than a filter.
-     *
-     * A question without options has no list to filter, and the free-text row is
-     * where a question with options collects an answer the model did not list.
-     */
-    typingAnswer(question) {
-        return question.options.length === 0 || this.atCustom;
-    }
-    /** Add text to the filter, or to the answer the current row collects. */
-    absorb(text) {
-        const question = this.current;
-        if (question === undefined || text === '')
-            return;
-        if (this.typingAnswer(question)) {
-            // The editor decides what an insertion is: a paste arrives as one edit,
-            // and a multi-character chunk is one undo step rather than many.
-            this.input.handleInput(text);
-            return;
-        }
-        this.typed += text;
-        this.cursor = 0;
-        this.customFrom = 0;
-    }
-    /** Apply one key press; returns the batch answer the first time it completes. */
-    handleKey(data) {
-        const question = this.current;
-        if (this.finished || question === undefined)
-            return undefined;
-        const paste = pastedText(data);
-        if (paste !== undefined) {
-            // An answer takes the paste sequence itself, because the editor reads it;
-            // a filter takes the text inside it, because nothing else would.
-            this.absorb(this.typingAnswer(question) ? data : paste);
-            return undefined;
-        }
-        // Abandoning the batch is the one decision that belongs to no row: the
-        // reader asked to be out of the questions, and the row the cursor happens
-        // to sit on is not an answer to that. It settles the way an aborted call
-        // does, with no answers at all, so a partial batch is never handed over as
-        // if the reader had walked through it.
-        if (matchesAction(this.keys(), 'question.cancel', data)) {
-            this.cancel();
-            return [];
-        }
-        // The free-text row is a text field, so the keys that walk or pick a list
-        // would otherwise take the very characters an answer is made of.
-        if (this.atCustom)
-            return this.handleCustomKey(data);
-        const matched = this.matched(question);
-        const keys = this.keys();
-        if (matchesAction(keys, 'question.up', data)) {
-            this.cursor = Math.max(0, this.cursor - 1);
-            this.customFrom = this.cursor;
-            return undefined;
-        }
-        if (matchesAction(keys, 'question.down', data)) {
-            // Below the last option sits the free-text row, which is the second way
-            // to reach it; a list with nothing left to show steps straight onto it.
-            if (this.cursor >= matched.length - 1) {
-                this.atCustom = true;
-            }
-            else {
-                this.cursor += 1;
-                this.customFrom = this.cursor;
-            }
-            return undefined;
-        }
-        if (question.options.length > 0 && matchesAction(keys, 'question.toggle', data)) {
-            const row = this.currentRow(question);
-            if (row !== undefined)
-                this.pick(row.position);
-            this.customFrom = this.cursor;
-            return undefined;
-        }
-        if (matchesAction(keys, 'question.skip', data)) {
-            this.advance();
-            return this.result();
-        }
-        if (matchesAction(keys, 'question.confirm', data)) {
-            const chosen = this.chosen[this.index] ?? [];
-            if (question.options.length > 0 && chosen.length === 0) {
-                // A reader who typed enough to narrow the list is naming the row it
-                // left under the cursor; one who typed an id the list does not hold is
-                // naming that instead, which is why the typed text becomes the answer.
-                const row = this.currentRow(question);
-                if (row !== undefined)
-                    this.pick(row.position);
-                else if (this.typed.trim() !== '')
-                    this.custom[this.index] = this.typed.trim();
-            }
-            this.confirm();
-            return this.result();
-        }
-        if (matchesKey(data, 'backspace')) {
-            // The same routing typing follows: a question without options has no
-            // filter to erase, and the delete belongs to the answer it collected.
-            if (this.typingAnswer(question)) {
-                this.input.handleInput(data);
-                return undefined;
-            }
-            this.typed = this.typed.slice(0, -1);
-            this.cursor = 0;
-            return undefined;
-        }
-        if (matchesKey(data, 'space')) {
-            this.absorb(' ');
-            return undefined;
-        }
-        if (question.options.length > 0 && /^[0-9]$/u.test(data)) {
-            const digit = Number.parseInt(data, 10);
-            if (digit === CUSTOM_ROW_NUMBER) {
-                this.atCustom = true;
-                return undefined;
-            }
-            const row = matched[digit - 1];
-            if (row !== undefined) {
-                this.pick(row.position);
-                this.customFrom = digit - 1;
-            }
-            return undefined;
-        }
-        if (data.length === 1 && data >= ' ')
-            this.absorb(data);
-        return undefined;
-    }
-    /**
-     * One key press while the free-text row holds the cursor.
-     *
-     * Walking back to the list keeps whatever was typed, so a reader who changes
-     * their mind about answering freely has not lost the text yet. An escape
-     * leaves the row the same way, because a question skipped by accident is a
-     * question the reader has to answer again: from the list, where every other
-     * question is skipped, an escape skips this one too.
-     */
-    handleCustomKey(data) {
-        if (matchesAction(this.keys(), 'question.confirm', data)) {
-            this.confirm();
-            return this.result();
-        }
-        // The keys that leave a text field are the field's own, not the question's:
-        // a skip the reader moved elsewhere must not quietly mean "walk back". The
-        // rows the question does own still work here, and the hint names both
-        // (customRowExits).
-        if (leavesCustomRow(this.keys(), data)) {
-            this.atCustom = false;
-            return undefined;
-        }
-        if (matchesKey(data, 'escape')) {
-            const question = this.current;
-            const rows = question === undefined ? 0 : this.matched(question).length;
-            this.atCustom = false;
-            this.cursor = Math.min(this.customFrom, Math.max(0, rows - 1));
-            return undefined;
-        }
-        // Anything else is the editor's: movement, deletion, undo, and the keys
-        // that insert a character this gate has no business knowing about.
-        this.input.handleInput(data);
-        return undefined;
-    }
-    /** Take the answer the reader confirmed, then leave the question. */
-    confirm() {
-        const question = this.current;
-        if (question === undefined)
-            return;
-        const text = this.input.getExpandedText().trim();
-        if (text !== '') {
-            this.custom[this.index] = text;
-            // The seam reads a single-select custom as the answer itself, so a label
-            // picked before it would be a second answer the caller has to reconcile.
-            if (question.multiSelect !== true)
-                this.chosen[this.index] = [];
-        }
-        this.advance();
-    }
-    /**
-     * Leave the current question for the next one.
-     *
-     * Typed text belongs to the question being left, so it never crosses into the
-     * next one — which is why a skipped question reports no typed answer at all.
-     */
-    advance() {
-        this.typed = '';
-        this.atCustom = false;
-        this.customFrom = 0;
-        this.cursor = 0;
-        this.index += 1;
-        if (this.index >= this.questions.length)
-            this.finished = true;
-        this.resetInput();
-    }
-    result() {
-        if (!this.finished)
-            return undefined;
-        return this.questions.map((question, position) => {
-            const custom = this.custom[position];
-            return {
-                id: question.id,
-                selected: this.chosen[position] ?? [],
-                ...(custom === undefined ? {} : { custom }),
-            };
-        });
-    }
-    card() {
-        const question = this.current;
-        if (question === undefined) {
-            return { kind: 'question', title: 'question', detail: [], optionOffset: 0, options: [], custom: undefined, answerInput: undefined, hint: 'finishing' };
-        }
-        const chosen = this.chosen[this.index] ?? [];
-        const detail = question.detail === undefined ? [] : lines(question.detail);
-        const heading = question.header === undefined ? '' : question.header + ' · ';
-        const title = `${heading}${question.question}${this.questions.length > 1 ? `  (${this.index + 1}/${this.questions.length})` : ''}`;
-        if (question.options.length === 0) {
-            return {
-                kind: 'question',
-                title,
-                detail,
-                optionOffset: 0,
-                options: [],
-                custom: undefined,
-                // The editor is the only place the text lands, so it is drawn even while
-                // empty: a question answered by typing needs somewhere to paste a key.
-                answerInput: this.input,
-                hint: `type or paste an answer · ${namedKeys(this.keys(), 'question.confirm', 'confirm')} · ${namedKeys(this.keys(), 'question.skip', 'skip')} · ${namedKeys(this.keys(), 'question.cancel', 'abandon')}`,
-            };
-        }
-        if (this.typed !== '')
-            detail.push(`filter: ${this.typed}`);
-        // The editor holds the answer, so whether one has been written is its own
-        // answer to give; the card only decides where to draw it.
-        const written = this.input.getExpandedText() !== '';
-        const secret = declaresSecret(question.id);
-        const matched = this.matched(question);
-        const { rows, start, cursor } = this.windowed(question);
-        if (rows.length < matched.length)
-            detail.push(`showing ${start + 1}–${start + rows.length} of ${matched.length}`);
-        return {
-            kind: 'question',
-            title,
-            detail,
-            optionOffset: start,
-            options: rows.map(({ option }, position) => ({
-                label: option.label,
-                description: option.description,
-                // The free-text row wears the cursor when it holds it: a mark on a row
-                // the reader is not pointing at is a mark that lies.
-                current: !this.atCustom && start + position === cursor,
-                selected: chosen.includes(option.label),
-            })),
-            custom: {
-                label: secret ? SECRET_ROW_LABEL : CUSTOM_ROW_LABEL,
-                description: CUSTOM_ROW_DESCRIPTION,
-                current: this.atCustom,
-                selected: this.atCustom || written,
-            },
-            // A written answer stays in view whether or not the cursor is on the row,
-            // because it is what an enter is about to send.
-            answerInput: this.atCustom || written ? this.input : undefined,
-            hint: this.atCustom
-                ? customHint(this.keys())
-                : `${namedKeys(this.keys(), 'question.toggle', question.multiSelect ? 'toggle' : 'select')} · digits pick · ${CUSTOM_ROW_SHORTHAND} · type to filter · ${namedKeys(this.keys(), 'question.confirm', 'confirm')} · ${namedKeys(this.keys(), 'question.skip', 'skip')} · ${namedKeys(this.keys(), 'question.cancel', 'abandon')}`,
-        };
-    }
-}
 //# sourceMappingURL=gates.js.map