@forgecart/cli 2.202609301225.0 → 2.202610020334.0

package/dist/src/question/terminal-screen.js

@@ -0,0 +1,68 @@
+import { clearScreenDown, cursorTo, moveCursor } from 'node:readline';
+import { displayWidth } from './util/terminal-text.util.js';
+const HIDE_CURSOR = '\u001B[?25l';
+const SHOW_CURSOR = '\u001B[?25h';
+/** The width drawn for a terminal that reports none. */
+const FALLBACK_COLUMNS = 80;
+/**
+ * The block of terminal rows a prompt owns. Each frame erases the one before it
+ * and is drawn in its place, so a prompt redraws without scrolling; rows are
+ * counted as the terminal wraps them, so a long line still erases whole.
+ */
+export class TerminalScreen {
+    display;
+    /** Rows the drawn block covers. */
+    blockRows = 0;
+    /** The row of the block the cursor rests on — `blockRows` when it rests below it. */
+    cursorRow = 0;
+    constructor(display) {
+        this.display = display;
+    }
+    /** The terminal's width in cells. */
+    get columns() {
+        const { columns } = this.display;
+        if (columns === undefined || columns <= 0)
+            return FALLBACK_COLUMNS;
+        return columns;
+    }
+    /** Replace the drawn block with `frame`. */
+    draw(frame) {
+        const rows = frame.lines.map((line) => this.rowsOf(line));
+        moveCursor(this.display, 0, -this.cursorRow);
+        cursorTo(this.display, 0);
+        clearScreenDown(this.display);
+        this.display.write(frame.lines.map((line) => `${line}\n`).join(''));
+        this.blockRows = rows.reduce((total, count) => total + count, 0);
+        this.rest(frame.cursor, rows);
+    }
+    /** Leave the drawn block on screen; whatever is written next starts on the row below it. */
+    release() {
+        moveCursor(this.display, 0, this.blockRows - this.cursorRow);
+        cursorTo(this.display, 0);
+        this.blockRows = 0;
+        this.cursorRow = 0;
+    }
+    /** Hand the terminal its cursor back. */
+    restoreCursor() {
+        this.display.write(SHOW_CURSOR);
+    }
+    /** Put the cursor where the frame asks, or hide it below the block. */
+    rest(cursor, rows) {
+        if (cursor === undefined) {
+            this.display.write(HIDE_CURSOR);
+            this.cursorRow = this.blockRows;
+            return;
+        }
+        const above = rows.slice(0, cursor.line).reduce((total, count) => total + count, 0);
+        const row = above + Math.floor(cursor.column / this.columns);
+        moveCursor(this.display, 0, row - this.blockRows);
+        cursorTo(this.display, cursor.column % this.columns);
+        this.display.write(SHOW_CURSOR);
+        this.cursorRow = row;
+    }
+    /** The rows one line takes once the terminal wraps it — an empty line still takes one. */
+    rowsOf(line) {
+        return Math.max(1, Math.ceil(displayWidth(line) / this.columns));
+    }
+}
+//# sourceMappingURL=terminal-screen.js.map

package/dist/src/question/terminal-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-screen.js","sourceRoot":"","sources":["../../../src/question/terminal-screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAOtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAMI;IAL7B,mCAAmC;IAC3B,SAAS,GAAG,CAAC,CAAC;IACtB,qFAAqF;IAC7E,SAAS,GAAG,CAAC,CAAC;IAEtB,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,qCAAqC;IACrC,IAAI,OAAO;QACT,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,gBAAgB,CAAC;QACnE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,KAAkB;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,4FAA4F;IAC5F,OAAO;QACL,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,aAAa;QACX,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,uEAAuE;IAC/D,IAAI,CAAC,MAA+B,EAAE,IAAuB;QACnE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,0FAA0F;IAClF,MAAM,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/src/question/type/question-prompt.input.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The three flags a questioning `forgecart` command carries (#2771), as
+ * commander parses them. Between them they answer every question a run cannot
+ * ask on a terminal.
+ */
+export interface QuestionPromptInput {
+    /**
+     * `--answer <question>=<answer>`, once per question: the question's id or its
+     * stable key, then an option id, comma-separated option ids for a
+     * multi-select, or the text verbatim. The last one given for a question wins.
+     */
+    answer?: string[];
+    /**
+     * `--answers-file <path>`: a JSON object of question id or stable key to an
+     * option id, a multi-select's option ids, or the text.
+     */
+    answersFile?: string;
+    /** `--yes`: every question that declares a default takes it, `defaulted: true`. */
+    yes?: boolean;
+}

package/dist/src/question/type/question-prompt.input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=question-prompt.input.js.map

package/dist/src/question/type/question-prompt.input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-prompt.input.js","sourceRoot":"","sources":["../../../../src/question/type/question-prompt.input.ts"],"names":[],"mappings":""}

package/dist/src/question/type/question-prompt.types.d.ts

@@ -0,0 +1,104 @@
+import type { Readable, Writable } from 'node:stream';
+import type { PromptArm } from '../prompt-arm.js';
+/** One option of a {@link CliQuestion} — launch#61's `AskUserOption`. */
+export interface CliQuestionOption {
+    id: string;
+    label: string;
+    /** The consequence of choosing it, printed under its label. */
+    hint?: string;
+}
+/**
+ * What a question takes — launch#61's `AskUserInput['kind']`: one of its
+ * options, free text, or `both` — the options plus "Other…" for free text.
+ */
+export type CliQuestionKind = 'choice' | 'text' | 'both';
+/**
+ * A question a `forgecart` command asks (#2771): launch#61's `AskUser` input —
+ * so that epic's `AgentQuestion` maps onto the same adapter — plus the two
+ * names an answer reaches it by.
+ */
+export interface CliQuestion {
+    /**
+     * This asking's id: printed in every prompt and named by every refusal. A
+     * fresh run mints a fresh one.
+     */
+    id: string;
+    /** The question's stable name (`ui-library`): it answers the question on every run. */
+    key: string;
+    question: string;
+    kind: CliQuestionKind;
+    /** The choices — empty for a `text` question. */
+    options: readonly CliQuestionOption[];
+    allowMultiple: boolean;
+    /** An example answer, printed once above the free-text buffer. */
+    placeholder?: string;
+    defaultOptionId?: string;
+}
+/**
+ * An answer: the payload launch#61's answer mutation writes, plus the question
+ * it answers.
+ */
+export interface QuestionPromptAnswer {
+    questionId: string;
+    optionIds?: string[];
+    text?: string;
+    /** Set by Esc and by `--yes`, never by a choice — so a default reads as one. */
+    defaulted?: boolean;
+}
+/**
+ * The `--answers-file` document: a question's id or stable key to an option id
+ * or the text, or to a multi-select's option ids. The id answers exactly one
+ * asking; the key answers the same question on every run.
+ */
+export type QuestionAnswersFile = Record<string, string | string[]>;
+/** One `--answer` value, split at its first `=`. */
+export interface AnswerFlag {
+    /** The question's id or stable key. */
+    question: string;
+    /** An option id, comma-separated option ids, or the text. */
+    answer: string;
+}
+/** The keyboard a prompt reads — stdin, or a stream standing in for a terminal's. */
+export type TerminalKeyboard = Readable & {
+    isTTY?: boolean;
+    setRawMode?: (mode: boolean) => unknown;
+};
+/** The screen a prompt draws on — stdout, or a stream standing in for a terminal's. */
+export type TerminalDisplay = Writable & {
+    isTTY?: boolean;
+    columns?: number;
+};
+/** The terminal questions are asked on: `process.stdin` and `process.stdout` unless given. */
+export interface QuestionPromptIo {
+    input: TerminalKeyboard;
+    output: TerminalDisplay;
+}
+/** Asks a set of questions and resolves their answers, in question order. */
+export interface QuestionPrompt {
+    ask(questions: readonly CliQuestion[]): Promise<QuestionPromptAnswer[]>;
+}
+/** Where the terminal cursor rests in a frame: a line of it, and a cell of that line. */
+export interface FrameCursor {
+    line: number;
+    column: number;
+}
+/** One frame of a prompt: its lines, and the cursor — hidden when the frame has none. */
+export interface PromptFrame {
+    lines: readonly string[];
+    cursor?: FrameCursor;
+}
+/** Where one keypress takes a prompt arm. */
+export type ArmStep = {
+    kind: 'ignore';
+} | {
+    kind: 'redraw';
+} | {
+    kind: 'refuse';
+    reason: string;
+} | {
+    kind: 'open';
+    arm: PromptArm;
+} | {
+    kind: 'answer';
+    answer: QuestionPromptAnswer;
+};

package/dist/src/question/type/question-prompt.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=question-prompt.types.js.map

package/dist/src/question/type/question-prompt.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-prompt.types.js","sourceRoot":"","sources":["../../../../src/question/type/question-prompt.types.ts"],"names":[],"mappings":""}

package/dist/src/question/util/answer-flag.util.d.ts

@@ -0,0 +1,12 @@
+import type { AnswerFlag } from '../type/question-prompt.types.js';
+/**
+ * Split one `--answer` value at its first `=`: the question's id or stable key
+ * before it, the answer after it — which may be empty (a multi-select's empty
+ * set) and may itself hold `=`.
+ */
+export declare function parseAnswerFlag(raw: string): AnswerFlag;
+/**
+ * Commander's accumulator for the repeatable `--answer`: every value is
+ * checked for its shape as the command line is parsed, before any action runs.
+ */
+export declare function collectAnswerFlag(raw: string, previous: readonly string[] | undefined): string[];

package/dist/src/question/util/answer-flag.util.js

@@ -0,0 +1,22 @@
+import { InvalidArgumentError } from 'commander';
+/**
+ * Split one `--answer` value at its first `=`: the question's id or stable key
+ * before it, the answer after it — which may be empty (a multi-select's empty
+ * set) and may itself hold `=`.
+ */
+export function parseAnswerFlag(raw) {
+    const separator = raw.indexOf('=');
+    if (separator <= 0) {
+        throw new InvalidArgumentError(`--answer "${raw}" is not <question>=<answer>: the question's id or key, then its option id(s) or text.`);
+    }
+    return { question: raw.slice(0, separator), answer: raw.slice(separator + 1) };
+}
+/**
+ * Commander's accumulator for the repeatable `--answer`: every value is
+ * checked for its shape as the command line is parsed, before any action runs.
+ */
+export function collectAnswerFlag(raw, previous) {
+    parseAnswerFlag(raw);
+    return [...(previous ?? []), raw];
+}
+//# sourceMappingURL=answer-flag.util.js.map

package/dist/src/question/util/answer-flag.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-flag.util.js","sourceRoot":"","sources":["../../../../src/question/util/answer-flag.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAIjD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,oBAAoB,CAC5B,aAAa,GAAG,wFAAwF,CACzG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,QAAuC;IACpF,eAAe,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/question/util/question-frame.util.d.ts

@@ -0,0 +1,22 @@
+import type { CliQuestion, QuestionPromptAnswer } from '../type/question-prompt.types.js';
+/** The gutter a free-text buffer is drawn behind (record `prompt?case=multiline`). */
+export declare const GUTTER = "\u2502";
+/**
+ * A question's opening line, `? <question>   (<id>)`, or — when that does not
+ * fit the terminal — the id on a line of its own beneath it. Every prompt
+ * prints the id: it is the name `--answer` takes.
+ */
+export declare function questionHeader(question: CliQuestion, columns: number): string[];
+/** One buffer line behind the gutter; an empty line is the bare gutter. */
+export declare function gutterLine(text: string): string;
+/**
+ * The answer Esc and `--yes` give: the declared default, `defaulted: true` —
+ * none for a question that declares no default.
+ */
+export declare function defaultAnswer(question: CliQuestion): QuestionPromptAnswer | undefined;
+/**
+ * The lines an answered prompt collapses to: its header, the options chosen and
+ * the text typed — so the screen keeps the answer that was sent, not the last
+ * position of a cursor.
+ */
+export declare function answeredLines(question: CliQuestion, answer: QuestionPromptAnswer, columns: number): string[];

package/dist/src/question/util/question-frame.util.js

@@ -0,0 +1,49 @@
+import { displayWidth } from './terminal-text.util.js';
+/** The gutter a free-text buffer is drawn behind (record `prompt?case=multiline`). */
+export const GUTTER = '│';
+/**
+ * A question's opening line, `? <question>   (<id>)`, or — when that does not
+ * fit the terminal — the id on a line of its own beneath it. Every prompt
+ * prints the id: it is the name `--answer` takes.
+ */
+export function questionHeader(question, columns) {
+    const line = `? ${question.question}   (${question.id})`;
+    if (displayWidth(line) <= columns)
+        return [line];
+    return [`? ${question.question}`, `  (${question.id})`];
+}
+/** One buffer line behind the gutter; an empty line is the bare gutter. */
+export function gutterLine(text) {
+    return text === '' ? GUTTER : `${GUTTER} ${text}`;
+}
+/**
+ * The answer Esc and `--yes` give: the declared default, `defaulted: true` —
+ * none for a question that declares no default.
+ */
+export function defaultAnswer(question) {
+    const { defaultOptionId } = question;
+    if (defaultOptionId === undefined)
+        return;
+    return { questionId: question.id, optionIds: [defaultOptionId], defaulted: true };
+}
+/**
+ * The lines an answered prompt collapses to: its header, the options chosen and
+ * the text typed — so the screen keeps the answer that was sent, not the last
+ * position of a cursor.
+ */
+export function answeredLines(question, answer, columns) {
+    const text = answer.text?.split('\n').map(gutterLine) ?? [];
+    return [...questionHeader(question, columns), ...chosenLines(question, answer), ...text];
+}
+function chosenLines(question, answer) {
+    const { optionIds } = answer;
+    if (optionIds === undefined)
+        return [];
+    if (optionIds.length === 0 && answer.text !== undefined)
+        return [];
+    const labels = optionIds.map((id) => question.options.find((option) => option.id === id)?.label ?? id);
+    const chosen = labels.length > 0 ? labels.join(', ') : '(none)';
+    const defaulted = answer.defaulted === true ? ' (default)' : '';
+    return [`  ${chosen}${defaulted}`];
+}
+//# sourceMappingURL=question-frame.util.js.map

package/dist/src/question/util/question-frame.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-frame.util.js","sourceRoot":"","sources":["../../../../src/question/util/question-frame.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,sFAAsF;AACtF,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAqB,EAAE,OAAe;IACnE,MAAM,IAAI,GAAG,KAAK,QAAQ,CAAC,QAAQ,OAAO,QAAQ,CAAC,EAAE,GAAG,CAAC;IACzD,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAqB;IACjD,MAAM,EAAE,eAAe,EAAE,GAAG,QAAQ,CAAC;IACrC,IAAI,eAAe,KAAK,SAAS;QAAE,OAAO;IAC1C,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAqB,EACrB,MAA4B,EAC5B,OAAe;IAEf,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,QAAqB,EAAE,MAA4B;IACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7B,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAC1B,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CACzE,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO,CAAC,KAAK,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/src/question/util/terminal-text.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The cells `text` takes on a terminal, counted one per grapheme — so an
+ * accent or an emoji sequence typed as several code points still counts once.
+ */
+export declare function displayWidth(text: string): number;
+/** `text` without its last grapheme — what Backspace leaves of a line. */
+export declare function withoutLastGrapheme(text: string): string;

package/dist/src/question/util/terminal-text.util.js

@@ -0,0 +1,15 @@
+/** Splits text the way a reader sees it: one segment per user-perceived character. */
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+/**
+ * The cells `text` takes on a terminal, counted one per grapheme — so an
+ * accent or an emoji sequence typed as several code points still counts once.
+ */
+export function displayWidth(text) {
+    return [...GRAPHEMES.segment(text)].length;
+}
+/** `text` without its last grapheme — what Backspace leaves of a line. */
+export function withoutLastGrapheme(text) {
+    const last = [...GRAPHEMES.segment(text)].at(-1);
+    return last === undefined ? text : text.slice(0, last.index);
+}
+//# sourceMappingURL=terminal-text.util.js.map

package/dist/src/question/util/terminal-text.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-text.util.js","sourceRoot":"","sources":["../../../../src/question/util/terminal-text.util.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgecart/cli",
-  "version": "2.202609301225.0",
+  "version": "2.202610020334.0",
   "type": "module",
   "description": "CLI for scaffolding and operating ForgeCart channel storefronts",
   "bin": {