@mrclrchtr/supi-ask-user 0.1.0 → 1.1.2

package/ui-fallback.ts

@@ -1,274 +0,0 @@
-// Dialog/input fallback for environments where ctx.ui.custom() is unavailable.
-// This path intentionally preserves the redesigned answer semantics while
-// flattening preview-heavy affordances into plain dialog lists.
-
-import { QuestionnaireFlow } from "./flow.ts";
-import { DISCUSS_LABEL, decorateOption, formatReviewLine, OTHER_LABEL } from "./format.ts";
-import type {
-  Answer,
-  NormalizedQuestion,
-  NormalizedStructuredQuestion,
-  QuestionnaireOutcome,
-} from "./types.ts";
-
-export interface FallbackDialogOptions {
-  signal?: AbortSignal;
-}
-
-export interface FallbackUi {
-  select(
-    title: string,
-    options: string[],
-    opts?: FallbackDialogOptions,
-  ): Promise<string | undefined>;
-  input(
-    title: string,
-    placeholder?: string,
-    opts?: FallbackDialogOptions,
-  ): Promise<string | undefined>;
-}
-
-interface RunOptions {
-  ui: FallbackUi;
-  signal?: AbortSignal;
-}
-
-type StepOutcome = "answered" | "cancelled" | "aborted";
-type CollectOutcome = Exclude<StepOutcome, "answered">;
-
-const REVIEW_SUBMIT = "Submit answers";
-const REVIEW_CANCEL = "Cancel questionnaire";
-const MULTI_SUBMIT = "Submit selections";
-
-export async function runFallbackQuestionnaire(
-  questions: NormalizedQuestion[],
-  options: RunOptions,
-): Promise<QuestionnaireOutcome> {
-  const flow = new QuestionnaireFlow(questions);
-  while (!flow.isTerminal()) {
-    if (options.signal?.aborted) {
-      flow.abort();
-      break;
-    }
-    const question = flow.currentQuestion;
-    if (!question) break;
-    const step = await askAndStore(question, flow, options);
-    if (step === "aborted") flow.abort();
-    else if (step === "cancelled") flow.cancel();
-    else await applyAdvance(flow, options);
-  }
-  return flow.outcome();
-}
-
-async function applyAdvance(flow: QuestionnaireFlow, opts: RunOptions): Promise<void> {
-  flow.advance();
-  if (flow.currentMode !== "reviewing" || !flow.allAnswered()) return;
-  const review = await runReviewStep(flow, opts);
-  if (review === "aborted") flow.abort();
-  else if (review === "cancelled") flow.cancel();
-  else flow.submit();
-}
-
-async function runReviewStep(
-  flow: QuestionnaireFlow,
-  opts: RunOptions,
-): Promise<"submit" | "cancelled" | "aborted"> {
-  const summary = flow.questions
-    .map(
-      (question) =>
-        `${question.header}: ${formatReviewLine(question, flow.getAnswer(question.id))}`,
-    )
-    .join("  |  ");
-  const choice = await opts.ui.select(
-    `Review answers — ${summary}`,
-    [REVIEW_SUBMIT, REVIEW_CANCEL],
-    {
-      signal: opts.signal,
-    },
-  );
-  if (opts.signal?.aborted) return "aborted";
-  if (choice === undefined || choice === REVIEW_CANCEL) return "cancelled";
-  return "submit";
-}
-
-async function askAndStore(
-  question: NormalizedQuestion,
-  flow: QuestionnaireFlow,
-  opts: RunOptions,
-): Promise<StepOutcome> {
-  const answer = await collectAnswer(question, opts);
-  if (answer === "aborted" || answer === "cancelled") return answer;
-  flow.setAnswer(answer);
-  return "answered";
-}
-
-function collectAnswer(
-  question: NormalizedQuestion,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  if (question.type === "text") return collectText(question, opts);
-  if (question.type === "multichoice") return collectMultichoice(question, opts);
-  return collectStructured(question, opts, question.type === "yesno" ? "yesno" : "option");
-}
-
-async function collectText(
-  question: Extract<NormalizedQuestion, { type: "text" }>,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  while (true) {
-    const value = await opts.ui.input(question.prompt, undefined, { signal: opts.signal });
-    if (opts.signal?.aborted) return "aborted";
-    if (value === undefined) return "cancelled";
-    const trimmed = value.trim();
-    if (trimmed.length > 0) return { questionId: question.id, source: "text", value: trimmed };
-  }
-}
-
-async function collectStructured(
-  question: NormalizedStructuredQuestion,
-  opts: RunOptions,
-  source: "option" | "yesno",
-): Promise<Answer | CollectOutcome> {
-  const labels = structuredChoiceLabels(question);
-  const choice = await opts.ui.select(question.prompt, labels, { signal: opts.signal });
-  if (opts.signal?.aborted) return "aborted";
-  if (choice === undefined) return "cancelled";
-  const index = labels.indexOf(choice);
-  if (index < 0) return "cancelled";
-  if (index < question.options.length) {
-    const option = question.options[index];
-    return source === "yesno"
-      ? {
-          questionId: question.id,
-          source: "yesno",
-          value: option.value as "yes" | "no",
-          optionIndex: index as 0 | 1,
-        }
-      : { questionId: question.id, source: "option", value: option.value, optionIndex: index };
-  }
-  return collectStructuredAction(question, index - question.options.length, opts);
-}
-
-function structuredChoiceLabels(question: NormalizedStructuredQuestion): string[] {
-  const labels = question.options.map((option, index) =>
-    numberedLabel(
-      index,
-      appendDescription(
-        decorateOption(option.label, question.recommendedIndexes.includes(index)),
-        option.description,
-      ),
-    ),
-  );
-  let offset = question.options.length;
-  if (question.allowOther) {
-    labels.push(numberedLabel(offset, OTHER_LABEL));
-    offset += 1;
-  }
-  if (question.allowDiscuss) labels.push(numberedLabel(offset, DISCUSS_LABEL));
-  return labels;
-}
-
-async function collectStructuredAction(
-  question: NormalizedStructuredQuestion,
-  actionIndex: number,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  if (question.allowOther && actionIndex === 0) return collectOther(question, opts);
-  return collectDiscuss(question, opts);
-}
-
-async function collectOther(
-  question: NormalizedStructuredQuestion,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  while (true) {
-    const value = await opts.ui.input(`${question.prompt} (${OTHER_LABEL})`, undefined, {
-      signal: opts.signal,
-    });
-    if (opts.signal?.aborted) return "aborted";
-    if (value === undefined) return "cancelled";
-    const trimmed = value.trim();
-    if (trimmed.length > 0) return { questionId: question.id, source: "other", value: trimmed };
-  }
-}
-
-async function collectDiscuss(
-  question: NormalizedStructuredQuestion,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  const value = await opts.ui.input(`${question.prompt} (${DISCUSS_LABEL})`, "Optional context", {
-    signal: opts.signal,
-  });
-  if (opts.signal?.aborted) return "aborted";
-  if (value === undefined) return "cancelled";
-  const trimmed = value.trim();
-  return trimmed.length > 0
-    ? { questionId: question.id, source: "discuss", value: trimmed }
-    : { questionId: question.id, source: "discuss" };
-}
-
-// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: fallback multiselect loop is intentionally linear
-async function collectMultichoice(
-  question: Extract<NormalizedQuestion, { type: "multichoice" }>,
-  opts: RunOptions,
-): Promise<Answer | CollectOutcome> {
-  const selected = new Set<number>();
-  while (true) {
-    const labels = multichoiceLabels(question, selected);
-    const choice = await opts.ui.select(question.prompt, labels, { signal: opts.signal });
-    if (opts.signal?.aborted) return "aborted";
-    if (choice === undefined) return "cancelled";
-    const index = labels.indexOf(choice);
-    if (index < 0) return "cancelled";
-    if (index < question.options.length) {
-      if (selected.has(index)) selected.delete(index);
-      else selected.add(index);
-      continue;
-    }
-    const submitIndex = question.options.length;
-    if (index === submitIndex) {
-      if (selected.size === 0) continue;
-      const optionIndexes = [...selected].sort((a, b) => a - b);
-      const selections = optionIndexes.map((optionIndex) => ({
-        optionIndex,
-        value: question.options[optionIndex].value,
-      }));
-      return {
-        questionId: question.id,
-        source: "options",
-        values: selections.map((selection) => selection.value),
-        optionIndexes,
-        selections,
-      };
-    }
-    return collectDiscuss(question, opts);
-  }
-}
-
-function multichoiceLabels(
-  question: Extract<NormalizedQuestion, { type: "multichoice" }>,
-  selected: Set<number>,
-): string[] {
-  const labels = question.options.map((option, index) => {
-    const checked = selected.has(index) ? "[x]" : "[ ]";
-    const recommended = question.recommendedIndexes.includes(index);
-    return numberedLabel(
-      index,
-      appendDescription(
-        `${checked} ${decorateOption(option.label, recommended)}`,
-        option.description,
-      ),
-    );
-  });
-  labels.push(numberedLabel(question.options.length, MULTI_SUBMIT));
-  if (question.allowDiscuss) labels.push(numberedLabel(question.options.length + 1, DISCUSS_LABEL));
-  return labels;
-}
-
-function numberedLabel(index: number, label: string): string {
-  return `${index + 1}. ${label}`;
-}
-
-function appendDescription(label: string, description: string | undefined): string {
-  return description ? `${label} — ${description}` : label;
-}

package/ui-rich-render.ts

@@ -1,370 +0,0 @@
-// Pure rendering helpers for the rich overlay. Kept separate from
-// ui-rich.ts to stay within Biome's per-file line limit and so the input
-// dispatch logic can be read without scrolling past a wall of theme strings.
-
-import type { Theme } from "@mariozechner/pi-coding-agent";
-import { type Editor, truncateToWidth, wrapTextWithAnsi } from "@mariozechner/pi-tui";
-import type { QuestionnaireFlow } from "./flow.ts";
-import { decorateOption, formatReviewLines, NOTE_MARKER } from "./format.ts";
-import type { NormalizedStructuredQuestion } from "./types.ts";
-import { inlineStructuredRowLines, structuredRowLabel } from "./ui-rich-inline.ts";
-import {
-  editorCaption,
-  padRight,
-  renderEditorBlock,
-  renderEditorPane,
-  usesSeparateEditorPane,
-} from "./ui-rich-render-editor.ts";
-import {
-  currentNote,
-  currentRowSupportsNotes,
-  renderNoteStatus,
-  visibleNoteMarker,
-} from "./ui-rich-render-notes.ts";
-import { hasPreview, type InteractiveRow, interactiveRows } from "./ui-rich-state.ts";
-
-export type SubMode = "select" | "other-input" | "text-input" | "discuss-input" | "note-input";
-
-export interface OverlayRenderState {
-  selectedIndex: number;
-  subMode: SubMode;
-  stagedSelections: Map<string, number[]>;
-  stagedSingleNotes: Map<string, string>;
-  stagedMultiNotes: Map<string, Map<number, string>>;
-}
-
-export function isEditorMode(mode: SubMode): boolean {
-  return (
-    mode === "text-input" ||
-    mode === "other-input" ||
-    mode === "discuss-input" ||
-    mode === "note-input"
-  );
-}
-
-export function selectedIndexesForQuestion(
-  flow: Pick<QuestionnaireFlow, "getAnswer">,
-  state: Pick<OverlayRenderState, "stagedSelections">,
-  question: NormalizedStructuredQuestion,
-): number[] {
-  const staged = state.stagedSelections.get(question.id);
-  if (staged) return [...staged];
-  const answer = flow.getAnswer(question.id);
-  if (!answer) return [];
-  if (answer.source === "option" || answer.source === "yesno") return [answer.optionIndex];
-  if (answer.source === "options") return [...answer.optionIndexes];
-  return [];
-}
-
-// biome-ignore lint/complexity/useMaxParams: render entry needs full overlay context
-export function renderOverlay(
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-): string[] {
-  const lines: string[] = [];
-  const add = (text: string) => lines.push(truncateToWidth(text, width));
-  add(theme.fg("accent", "─".repeat(width)));
-  if (flow.isMultiQuestion) renderTabBar(add, theme, flow);
-  if (flow.currentMode === "reviewing") {
-    renderReview(add, theme, flow);
-  } else {
-    renderQuestion(add, lines, width, theme, flow, state, editor);
-  }
-  add(theme.fg("dim", ` ${footerHelp(flow, state)}`));
-  add(theme.fg("accent", "─".repeat(width)));
-  return lines;
-}
-
-function renderTabBar(add: (text: string) => void, theme: Theme, flow: QuestionnaireFlow): void {
-  // Active segment uses the selected-bg highlight (matches pi's reference
-  // questionnaire and Claude's UI). Inactive segments stay foreground-only:
-  // success when answered, muted when pending.
-  const segments: string[] = [theme.fg("dim", "← ")];
-  for (const [index, question] of flow.questions.entries()) {
-    const answered = flow.hasAnswer(question.id);
-    const active = flow.currentMode === "answering" && flow.currentIndex === index;
-    const marker = answered ? "■" : "□";
-    const text = ` ${marker} ${question.header} `;
-    segments.push(
-      active
-        ? theme.bg("selectedBg", theme.fg("text", text))
-        : theme.fg(answered ? "success" : "muted", text),
-    );
-    segments.push(" ");
-  }
-  const reviewText = " ✓ Review ";
-  segments.push(
-    flow.currentMode === "reviewing"
-      ? theme.bg("selectedBg", theme.fg("text", reviewText))
-      : theme.fg("dim", reviewText),
-  );
-  segments.push(theme.fg("dim", " →"));
-  add(` ${segments.join("")}`);
-  add("");
-}
-
-// biome-ignore lint/complexity/useMaxParams: question render needs full context
-function renderQuestion(
-  add: (text: string) => void,
-  lines: string[],
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-): void {
-  const question = flow.currentQuestion;
-  if (!question) return;
-  for (const line of wrapTextWithAnsi(` ${question.prompt}`, width)) {
-    add(theme.fg("text", line));
-  }
-  lines.push("");
-  if (question.type === "text") {
-    renderTextQuestion(add, lines, theme, editor, width);
-    return;
-  }
-  renderStructuredQuestion(add, lines, width, theme, flow, state, editor, question);
-}
-
-// biome-ignore lint/complexity/useMaxParams: split view layout needs full context
-function renderSplitView(
-  lines: string[],
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-  question: NormalizedStructuredQuestion,
-  rows: InteractiveRow[],
-): void {
-  const leftWidth = Math.max(34, Math.floor(width * 0.42));
-  const rightWidth = Math.max(24, width - leftWidth - 3);
-  const leftLines = renderPaneRows(leftWidth, theme, flow, state, editor, question, rows);
-  const rightLines = usesSeparateEditorPane(state)
-    ? renderEditorPane(rightWidth, theme, editor, editorCaption(state))
-    : renderPreviewPane(
-        rightWidth,
-        theme,
-        previewForSelection(question, rows[state.selectedIndex]),
-      );
-  const total = Math.max(leftLines.length, rightLines.length);
-  for (let index = 0; index < total; index += 1) {
-    const left = padRight(leftLines[index] ?? "", leftWidth);
-    const right = padRight(rightLines[index] ?? "", rightWidth);
-    lines.push(`${left} ${theme.fg("accent", "│")} ${right}`);
-  }
-}
-
-// biome-ignore lint/complexity/useMaxParams: thin adapter for text question rendering
-function renderTextQuestion(
-  add: (text: string) => void,
-  lines: string[],
-  theme: Theme,
-  editor: Editor,
-  width: number,
-): void {
-  renderEditorBlock(add, lines, theme, editor, width, "Answer");
-}
-
-// biome-ignore lint/complexity/useMaxParams: structured render needs full context
-function renderStructuredQuestion(
-  add: (text: string) => void,
-  lines: string[],
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-  question: NormalizedStructuredQuestion,
-): void {
-  const rows = interactiveRows(question);
-  if (hasPreview(question) && width >= 100) {
-    renderSplitView(lines, width, theme, flow, state, editor, question, rows);
-  } else {
-    renderStandardStructuredQuestion(add, lines, width, theme, flow, state, editor, question, rows);
-  }
-  const note = currentNote(flow, state, question);
-  if (note) renderNoteStatus(add, theme, note);
-}
-
-// biome-ignore lint/complexity/useMaxParams: standard layout needs full context
-function renderStandardStructuredQuestion(
-  add: (text: string) => void,
-  lines: string[],
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-  question: NormalizedStructuredQuestion,
-  rows: InteractiveRow[],
-): void {
-  renderRows(add, width, theme, flow, state, editor, question, rows);
-  if (usesSeparateEditorPane(state)) {
-    renderEditorBlock(add, lines, theme, editor, width, editorCaption(state));
-    return;
-  }
-  const preview = previewForSelection(question, rows[state.selectedIndex]);
-  if (preview) renderPreviewBlock(add, lines, theme, width, preview);
-}
-
-// biome-ignore lint/complexity/useMaxParams: helper mirrors render context
-function renderPaneRows(
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-  question: NormalizedStructuredQuestion,
-  rows: InteractiveRow[],
-): string[] {
-  const out: string[] = [];
-  const push = (text = "") => out.push(truncateToWidth(text, width));
-  renderRows(push, width, theme, flow, state, editor, question, rows);
-  return out;
-}
-
-// biome-ignore lint/complexity/useMaxParams: helper mirrors render context
-function renderRows(
-  add: (text: string) => void,
-  width: number,
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  editor: Editor,
-  question: NormalizedStructuredQuestion,
-  rows: InteractiveRow[],
-): void {
-  const selected = selectedIndexesForQuestion(flow, state, question);
-  for (const [index, row] of rows.entries()) {
-    const active = state.selectedIndex === index;
-    const prefix = active ? theme.fg("accent", "> ") : "  ";
-    const inlineEditorLines = inlineStructuredRowLines({
-      width,
-      theme,
-      state,
-      editor,
-      row,
-      prefix,
-    });
-    if (inlineEditorLines) {
-      for (const [lineIndex, line] of inlineEditorLines.entries()) {
-        add(`${lineIndex === 0 ? prefix : "   "}${line}`);
-      }
-      continue;
-    }
-    add(prefix + rowLabel(theme, flow, state, question, row, active, selected));
-    const description = rowDescription(question, row);
-    if (description) add(`     ${theme.fg("muted", description)}`);
-  }
-}
-
-// biome-ignore lint/complexity/useMaxParams: helper mirrors render context
-function rowLabel(
-  theme: Theme,
-  flow: QuestionnaireFlow,
-  state: OverlayRenderState,
-  question: NormalizedStructuredQuestion,
-  row: InteractiveRow,
-  active: boolean,
-  selected: number[],
-): string {
-  if (row.kind === "option") {
-    const option = question.options[row.optionIndex];
-    const recommended = question.recommendedIndexes.includes(row.optionIndex);
-    const noteMarker = visibleNoteMarker({ flow, state, question, row, active });
-    const baseLabel = `${decorateOption(option.label, recommended)}${noteMarker ? ` ${NOTE_MARKER}` : ""}`;
-    if (question.type === "multichoice") {
-      const checked = selected.includes(row.optionIndex) ? "[x]" : "[ ]";
-      return theme.fg("text", `${checked} ${baseLabel}`);
-    }
-    return theme.fg("text", `${row.optionIndex + 1}. ${baseLabel}`);
-  }
-  if (row.kind === "other") return theme.fg("text", structuredRowLabel(flow, question, row));
-  return theme.fg("text", structuredRowLabel(flow, question, row));
-}
-
-function rowDescription(
-  question: NormalizedStructuredQuestion,
-  row: InteractiveRow,
-): string | undefined {
-  if (row.kind === "option") return question.options[row.optionIndex].description;
-  return undefined;
-}
-
-function renderPreviewPane(width: number, theme: Theme, preview: string | undefined): string[] {
-  const out: string[] = [];
-  const push = (text = "") => out.push(truncateToWidth(text, width));
-  push(theme.fg("accent", " Preview"));
-  push("");
-  if (!preview) {
-    push(theme.fg("muted", " No preview for the current selection."));
-    return out;
-  }
-  for (const line of preview.split("\n")) push(theme.fg("text", ` ${line}`));
-  return out;
-}
-
-// biome-ignore lint/complexity/useMaxParams: helper mirrors render context
-function renderPreviewBlock(
-  add: (text: string) => void,
-  lines: string[],
-  theme: Theme,
-  width: number,
-  preview: string,
-): void {
-  add("");
-  add(theme.fg("accent", " Preview:"));
-  for (const line of preview.split("\n")) {
-    lines.push(truncateToWidth(` ${line}`, width));
-  }
-}
-
-function previewForSelection(
-  question: NormalizedStructuredQuestion,
-  row: InteractiveRow | undefined,
-): string | undefined {
-  return row?.kind === "option" ? question.options[row.optionIndex].preview : undefined;
-}
-
-function renderReview(add: (text: string) => void, theme: Theme, flow: QuestionnaireFlow): void {
-  add(theme.fg("accent", " Review answers:"));
-  add("");
-  for (const question of flow.questions) {
-    const answer = flow.getAnswer(question.id);
-    const lines = answer ? formatReviewLines(question, answer) : ["(no answer)"];
-    add(theme.fg("muted", ` ${question.header}:`));
-    for (const line of lines) add(`   ${theme.fg("text", line)}`);
-  }
-  add("");
-  add(theme.fg(flow.allAnswered() ? "success" : "warning", " Press Enter to submit"));
-}
-
-function footerHelp(flow: QuestionnaireFlow, state: OverlayRenderState): string {
-  if (state.subMode === "text-input") return "Enter to submit • Esc to cancel";
-  if (isEditorMode(state.subMode)) return "Enter to submit • Esc to go back";
-  if (flow.currentMode === "reviewing") {
-    return "Enter to submit • ←/Shift-Tab to revise • Esc to cancel";
-  }
-  const question = flow.currentQuestion;
-  if (!question || question.type === "text") return "Esc cancel";
-  const canGoBack = flow.currentIndex > 0;
-  const canReview = flow.allAnswered();
-  const parts = ["↑↓ navigate"];
-  if (question.type === "multichoice") {
-    parts.push("Space toggle");
-    if (selectedIndexesForQuestion(flow, state, question).length > 0) parts.push("Enter submit");
-  } else {
-    parts.push("Enter confirm/select");
-  }
-  if (currentRowSupportsNotes(question, state)) {
-    parts.push(currentNote(flow, state, question) ? "n edit note" : "n add note");
-  }
-  if (canGoBack) parts.push("←/Shift-Tab back");
-  if (canReview) parts.push("→/Tab review");
-  parts.push("Esc cancel");
-  return parts.join(" • ");
-}