@zhushanwen/pi-ask-user 0.1.0 → 0.2.0

package/src/answer-format.ts

@@ -0,0 +1,51 @@
+// src/answer-format.ts
+// 答案文本格式的唯一权威模块。
+// TUI 路径（submit-view.ts:getAnswerText）和 RPC 路径（index.ts:protoAnswersToResult）
+// 都调 formatAnswer 产出 "label1, label2 — comment" 格式，确保两条路径一致。
+// renderExpandedOptions（index.ts）调 parseAnswerParts 精确反解析选中项。
+import { ANSWER_COMMENT_SEPARATOR } from "./types";
+
+/**
+ * 把答案各部分拼装为最终文本格式："part1, part2 — comment"。
+ * - parts 为空 → 返回 null（未答）
+ * - comment 有值 → 追加 ANSWER_COMMENT_SEPARATOR + comment
+ */
+export function formatAnswer(parts: string[], comment?: string | null): string | null {
+	if (parts.length === 0) return null;
+	const base = parts.join(", ");
+	return comment ? `${base}${ANSWER_COMMENT_SEPARATOR}${comment}` : base;
+}
+
+/**
+ * 从最终答案文本中精确解析出选中的 labels（不依赖子串匹配）。
+ * 用于 renderExpandedOptions 反向判定哪些选项被选中。
+ *
+ * @param answer 最终答案文本（formatAnswer 产出）
+ * @param labels 候选 label 列表（q.options 的 label），精确匹配
+ * @returns selected=命中的 labels（按 answer 中出现顺序），comment=评论文本（如有）
+ */
+export function parseAnswerParts(
+	answer: string,
+	labels: string[],
+): { selected: string[]; comment?: string } {
+	// 先提取 comment（ANSWER_COMMENT_SEPARATOR 之后的部分）
+	let body = answer;
+	let comment: string | undefined;
+	const sepIdx = answer.indexOf(ANSWER_COMMENT_SEPARATOR);
+	if (sepIdx >= 0) {
+		body = answer.slice(0, sepIdx);
+		comment = answer.slice(sepIdx + ANSWER_COMMENT_SEPARATOR.length).trim();
+	}
+
+	// body 形如 "label1, label2" → 精确匹配候选 label
+	const labelSet = new Set(labels);
+	const tokens = body.split(/[,，]/).map((t) => t.trim()).filter(Boolean);
+	const selected: string[] = [];
+	// 剩余 tokens 不匹配任何 label → 是 Other 自由文本（不返回，调用方自行处理）
+	for (const token of tokens) {
+		if (labelSet.has(token)) {
+			selected.push(token);
+		}
+	}
+	return { selected, comment };
+}

package/src/component.ts

@@ -1,16 +1,23 @@
 // src/component.ts
 import { type Component, matchesKey, parseKey, truncateToWidth } from "@mariozechner/pi-tui";
 
+import {
+	deleteCharBeforeCursor,
+	handleEditorPaste,
+	insertAtCursor,
+	moveCursorEnd,
+	moveCursorHome,
+	moveCursorLeft,
+	moveCursorRight,
+} from "./editor-ops";
 import { allOptions, renderQuestionView } from "./question-view";
 import { buildResult, renderButtonBar, renderSubmitView } from "./submit-view";
 import {
 	createQuestionState,
 	HEADER_MAX_CHARS,
-	isHighSurrogate,
 	type Question,
 	type QuestionState,
 	type Result,
-	SURROGATE_PAIR_LEN,
 	type ThemeLike,
 } from "./types";
 
@@ -76,6 +83,13 @@ export class AskUserComponent implements Component {
 		this.cachedLines = undefined;
 	}
 
+	/** 状态变更后的标准后续：失效缓存 + 请求重绘。
+	 *  消除散弹式修改——每个 mutation 方法末尾不再需要手写 invalidate + requestRender 两行。 */
+	private rerender(): void {
+		this.invalidate();
+		this.tui.requestRender();
+	}
+
 	// ── 渲染 ──
 	render(width: number): string[] {
 		if (this.cachedWidth === width && this.cachedLines) {
@@ -108,7 +122,7 @@ export class AskUserComponent implements Component {
 		} else {
 			const q = this.questions[this.activeTab]!;
 			const state = this.states[this.activeTab]!;
-			for (const line of renderQuestionView(q, state, t, innerWidth, this.isSingle, state.draftText)) {
+			for (const line of renderQuestionView({ question: q, state, theme: t, width: innerWidth, isSingle: this.isSingle })) {
 				add(line);
 			}
 		}
@@ -173,8 +187,7 @@ export class AskUserComponent implements Component {
 				this.cancel();
 			} else {
 				this.pendingCancel = false;
-				this.invalidate();
-				this.tui.requestRender();
+				this.rerender();
 			}
 			return;
 		}
@@ -221,15 +234,13 @@ export class AskUserComponent implements Component {
 
 		if (matchesKey(data, "up")) {
 			state.cursorIndex = Math.max(0, state.cursorIndex - 1);
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		if (matchesKey(data, "down")) {
 			const max = allOptions(q).length - 1;
 			state.cursorIndex = Math.min(max, state.cursorIndex + 1);
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 
@@ -242,8 +253,7 @@ export class AskUserComponent implements Component {
 			state.mode = "freeform";
 			state.draftText = state.freeTextValue ?? state.freeDraft ?? "";
 			state.cursorIndex = state.draftText.length;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 
@@ -288,15 +298,13 @@ export class AskUserComponent implements Component {
 		// Esc → 回退到最后一个问题
 		if (matchesKey(data, "escape")) {
 			this.activeTab = this.questions.length - 1;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		// Tab → Submit ↔ Cancel 循环切焦点（单键双向）
 		if (matchesKey(data, "tab")) {
 			this.submitTabFocus = this.submitTabFocus === "submit" ? "cancel" : "submit";
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		// Enter → 触发当前 focus
@@ -318,7 +326,7 @@ export class AskUserComponent implements Component {
 			this.handleEditorKey(data, keyId, state, q);
 			return;
 		}
-		this.handleEditorPaste(data, state);
+		if (handleEditorPaste(state, data)) this.rerender();
 	}
 
 	/** parseKey 命中的键：escape/enter/backspace/光标移动/space/printable 各有语义，
@@ -333,18 +341,24 @@ export class AskUserComponent implements Component {
 			return;
 		}
 		if (matchesKey(data, "backspace")) {
-			this.deleteCharBeforeCursor(state);
+			if (deleteCharBeforeCursor(state)) this.rerender();
 			return;
 		}
-		if (this.moveCursor(data, state)) return;
+		// 光标移动（4 方向 + home/end）
+		if (matchesKey(data, "left")) { moveCursorLeft(state); this.rerender(); return; }
+		if (matchesKey(data, "right")) { moveCursorRight(state); this.rerender(); return; }
+		if (matchesKey(data, "home")) { moveCursorHome(state); this.rerender(); return; }
+		if (matchesKey(data, "end")) { moveCursorEnd(state); this.rerender(); return; }
 		// 空格特判：parseKey(" ") 返回 "space"（非单字符），需显式插入
 		if (matchesKey(data, "space")) {
-			this.insertAtCursor(state, " ");
+			insertAtCursor(state, " ");
+			this.rerender();
 			return;
 		}
 		// 单字符 printable：parseKey("a") 返回 "a"（code 32-126），在光标处插入
 		if (keyId.length === 1 && keyId >= " " && keyId <= "~") {
-			this.insertAtCursor(state, keyId);
+			insertAtCursor(state, keyId);
+			this.rerender();
 			return;
 		}
 		// 其他 special key（功能键/modifier 组合）→ no-op（不泄漏）
@@ -366,8 +380,7 @@ export class AskUserComponent implements Component {
 		state.mode = "options";
 		state.draftText = "";
 		state.cursorIndex = state.savedOptionsCursorIndex;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** Enter：freeform 有文本→提交，空文本→回退；comment→保存评论并 advance。 */
@@ -389,8 +402,7 @@ export class AskUserComponent implements Component {
 				if (q.multiSelect ? state.selectedIndices.size === 0 : state.selectedIndex === null) {
 					state.confirmed = false;
 				}
-				this.invalidate();
-				this.tui.requestRender();
+				this.rerender();
 			}
 			return;
 		}
@@ -401,79 +413,13 @@ export class AskUserComponent implements Component {
 		this.advance();
 	}
 
-	/** 在光标处插入文本，光标前移 text.length。 */
-	private insertAtCursor(state: QuestionState, text: string): void {
-		state.draftText = state.draftText.slice(0, state.cursorIndex) + text + state.draftText.slice(state.cursorIndex);
-		state.cursorIndex += text.length;
-		this.invalidate();
-		this.tui.requestRender();
-	}
-
-	/** 删除光标前一个 code point（surrogate pair 时删整个 code point）。 */
-	private deleteCharBeforeCursor(state: QuestionState): void {
-		if (state.cursorIndex <= 0) return;
-		const deleteCount = state.cursorIndex >= SURROGATE_PAIR_LEN && isHighSurrogate(state.draftText, state.cursorIndex - SURROGATE_PAIR_LEN) ? SURROGATE_PAIR_LEN : 1;
-		state.draftText = state.draftText.slice(0, state.cursorIndex - deleteCount) + state.draftText.slice(state.cursorIndex);
-		state.cursorIndex -= deleteCount;
-		this.invalidate();
-		this.tui.requestRender();
-	}
-
-	/** 光标移动（left/right/home/end），surrogate pair 安全跳过代理中间位。
-	 *  返回 true 表示命中了移动键；false 表示非移动键，交由上层处理。 */
-	private moveCursor(data: string, state: QuestionState): boolean {
-		if (matchesKey(data, "left")) {
-			const newLeft = state.cursorIndex - 1;
-			state.cursorIndex = newLeft > 0 && isHighSurrogate(state.draftText, newLeft - 1)
-				? newLeft - 1
-				: Math.max(0, newLeft);
-		} else if (matchesKey(data, "right")) {
-			state.cursorIndex = isHighSurrogate(state.draftText, state.cursorIndex)
-				? Math.min(state.draftText.length, state.cursorIndex + SURROGATE_PAIR_LEN)
-				: Math.min(state.draftText.length, state.cursorIndex + 1);
-		} else if (matchesKey(data, "home")) {
-			state.cursorIndex = 0;
-		} else if (matchesKey(data, "end")) {
-			state.cursorIndex = state.draftText.length;
-		} else {
-			return false;
-		}
-		this.invalidate();
-		this.tui.requestRender();
-		return true;
-	}
-
-	/** 多字符粘贴 chunk → printable 提取（BC-1/BC-2/BC-3 保持）。
-	 *  未识别控制序列（OSC/DA/DCS/APC/unknown CSI）整体丢弃，不提取可见残渣。
-	 *  排除 bracketed paste 标记防 C-PASTE 退化。依赖 StdinBuffer 序列拆分保证 data 整体性。 */
-	private handleEditorPaste(data: string, state: QuestionState): void {
-		if (data.startsWith("\x1b") && !data.includes("\x1b[200~") && !data.includes("\x1b[201~")) {
-			return;
-		}
-		const cleaned = data.replace(/\x1b\[200~|\x1b\[201~/g, "");
-		let changed = false;
-		// 用 Array.from 正确拆分 emoji/surrogate pairs
-		for (const c of Array.from(cleaned)) {
-			if (c >= " ") {
-				state.draftText = state.draftText.slice(0, state.cursorIndex) + c + state.draftText.slice(state.cursorIndex);
-				state.cursorIndex += c.length;
-				changed = true;
-			}
-		}
-		if (changed) {
-			this.invalidate();
-			this.tui.requestRender();
-		}
-	}
-
 	private toggleIndex(state: QuestionState, index: number): void {
 		if (state.selectedIndices.has(index)) state.selectedIndices.delete(index);
 		else state.selectedIndices.add(index);
 		if (state.selectedIndices.size === 0 && state.freeTextValue === null) {
 			state.confirmed = false;
 		}
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	private autoConfirmIfAnswered(): void {
@@ -490,21 +436,18 @@ export class AskUserComponent implements Component {
 	private gotoTab(target: number): void {
 		this.autoConfirmIfAnswered();
 		this.activeTab = target;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** Esc 语义：有上一个 tab 则回退；已在首个（或单问题）则进入确认取消覆盖层。 */
 	private escBackOrConfirm(): void {
 		if (this.activeTab > 0) {
 			this.activeTab--;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		this.pendingCancel = true;
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	/** 选中确认后的处理：若 allowComment，进入评论模式（可重入编辑/清除已有评论）；否则前进。 */
@@ -515,8 +458,7 @@ export class AskUserComponent implements Component {
 			state.mode = "comment";
 			state.draftText = state.commentValue ?? "";
 			state.cursorIndex = state.draftText.length;
-			this.invalidate();
-			this.tui.requestRender();
+			this.rerender();
 			return;
 		}
 		this.advance();
@@ -532,8 +474,7 @@ export class AskUserComponent implements Component {
 		} else {
 			this.activeTab = this.questions.length;
 		}
-		this.invalidate();
-		this.tui.requestRender();
+		this.rerender();
 	}
 
 	private submit(): void {

package/src/editor-ops.ts

@@ -0,0 +1,75 @@
+// src/editor-ops.ts
+// 文本编辑器的纯操作函数——操作 QuestionState.draftText/cursorIndex。
+// 从 AskUserComponent 提取，使 component 聚焦于问卷交互（tab 导航/状态转换/渲染编排），
+// 不再理解终端转义序列解析和 surrogate pair 细节。
+//
+// 所有函数直接修改传入的 state（mutation 风格，与调用方 component 的命令式风格一致）。
+// 是否产生了变更由返回值表达，调用方据此决定是否 rerender。
+
+import { isHighSurrogate, SURROGATE_PAIR_LEN, type QuestionState } from "./types";
+
+// ── 编辑器纯操作 ──
+
+// ── 编辑器纯操作 ──
+
+/** 在光标处插入文本，光标前移 text.length。 */
+export function insertAtCursor(state: QuestionState, text: string): void {
+	state.draftText = state.draftText.slice(0, state.cursorIndex) + text + state.draftText.slice(state.cursorIndex);
+	state.cursorIndex += text.length;
+}
+
+/** 删除光标前一个 code point（surrogate pair 时删整个 code point）。
+ *  返回 true 表示有删除发生（调用方据此决定是否 invalidate）。 */
+export function deleteCharBeforeCursor(state: QuestionState): boolean {
+	if (state.cursorIndex <= 0) return false;
+	const deleteCount = state.cursorIndex >= SURROGATE_PAIR_LEN && isHighSurrogate(state.draftText, state.cursorIndex - SURROGATE_PAIR_LEN) ? SURROGATE_PAIR_LEN : 1;
+	state.draftText = state.draftText.slice(0, state.cursorIndex - deleteCount) + state.draftText.slice(state.cursorIndex);
+	state.cursorIndex -= deleteCount;
+	return true;
+}
+
+/** 光标左移一个 code point（surrogate pair 安全）。不超出 0。 */
+export function moveCursorLeft(state: QuestionState): void {
+	const newLeft = state.cursorIndex - 1;
+	state.cursorIndex = newLeft > 0 && isHighSurrogate(state.draftText, newLeft - 1)
+		? newLeft - 1
+		: Math.max(0, newLeft);
+}
+
+/** 光标右移一个 code point（surrogate pair 安全）。不超出 draftText.length。 */
+export function moveCursorRight(state: QuestionState): void {
+	state.cursorIndex = isHighSurrogate(state.draftText, state.cursorIndex)
+		? Math.min(state.draftText.length, state.cursorIndex + SURROGATE_PAIR_LEN)
+		: Math.min(state.draftText.length, state.cursorIndex + 1);
+}
+
+/** 光标移到行首。 */
+export function moveCursorHome(state: QuestionState): void {
+	state.cursorIndex = 0;
+}
+
+/** 光标移到行尾。 */
+export function moveCursorEnd(state: QuestionState): void {
+	state.cursorIndex = state.draftText.length;
+}
+
+/** 多字符粘贴 chunk → printable 提取。
+ *  排除 bracketed paste 标记，过滤未识别控制序列（OSC/DA/DCS/APC/unknown CSI）。
+ *  返回 true 表示有文本插入。
+ *  data 整体性由 StdinBuffer 序列拆分保证。 */
+export function handleEditorPaste(state: QuestionState, data: string): boolean {
+	if (data.startsWith("\x1b") && !data.includes("\x1b[200~") && !data.includes("\x1b[201~")) {
+		return false;
+	}
+	const cleaned = data.replace(/\x1b\[200~|\x1b\[201~/g, "");
+	let changed = false;
+	// 用 Array.from 正确拆分 emoji/surrogate pairs
+	for (const c of Array.from(cleaned)) {
+		if (c >= " ") {
+			state.draftText = state.draftText.slice(0, state.cursorIndex) + c + state.draftText.slice(state.cursorIndex);
+			state.cursorIndex += c.length;
+			changed = true;
+		}
+	}
+	return changed;
+}