@fanchaozz/provider-manager 0.2.3 → 1.0.1

package/components.ts

@@ -35,6 +35,77 @@ export function matchesKey(data: string, key: string): boolean {
 	return false;
 }
 
+// ============================================================================
+// Bracketed-paste 助手
+// =========================================================================
+//
+// pi 框架的 Ctrl+V / Alt+V / 右键粘贴都走 readClipboardText()，拿到的文本
+// 用 ESC[200~ ... ESC[201~ 包后调 formEditor.handleInput。我们之前的
+// handleInput 只认 “单字节 + charCode 32-126”，遇到这个多字节序列会
+// 静默丢，与 “pwsh 下能选中文/多行 key 但 ctrl+v 无反应” 症状一致。
+//
+// Feed 每次输入 chunk；返回 true = 本 chunk 被粘贴状态完全消费（调用方退出）。
+// 返回 false = 不是粘贴；调用方走常规路径。
+// 跨多次 feed() 累积；遇到结束标记时调一次 onPaste(干净文本) 并清状态。
+// 当本 chunk 结束后还有剩余字符（同一 chunk 里在结束标记后还有正常输入），
+// 存到 `lastRest`，调用方可用 `consumeRest()` 拿到并重调。
+export class PasteBuffer {
+	private isInPaste = false;
+	private buf = "";
+	private lastRest = "";
+	/** Called once when a complete bracketed paste arrives. */
+	onPaste: (cleanText: string) => void = () => {};
+
+	feed(data: string): boolean {
+		// 粘贴中：累积到 buf 等结束标记
+		if (this.isInPaste) {
+			this.buf += data;
+			const end = this.buf.indexOf("\x1b[201~");
+			if (end >= 0) {
+				const text = this.buf.substring(0, end);
+				const rest = this.buf.substring(end + 6);
+				this.isInPaste = false;
+				this.buf = "";
+				this.onPaste(sanitizePasteText(text));
+				if (rest) this.lastRest = rest;
+			}
+			return true;
+		}
+		// 未粘贴：检测开始标记
+		if (data.includes("\x1b[200~")) {
+			this.isInPaste = true;
+			this.buf = "";
+			const after = data.replace("\x1b[200~", "");
+			// 同一 chunk 里也可能有结束标记
+			const end = after.indexOf("\x1b[201~");
+			if (end >= 0) {
+				const text = after.substring(0, end);
+				const rest = after.substring(end + 6);
+				this.isInPaste = false;
+				this.onPaste(sanitizePasteText(text));
+				if (rest) this.lastRest = rest;
+				return true;
+			}
+			this.buf = after;
+			return true;
+		}
+		return false;  // 非粘贴，调用方走常规路径
+	}
+
+	/** 取走上次 paste 之后的剩余字符（如果有）。调用后清空。 */
+	consumeRest(): string {
+		const r = this.lastRest;
+		this.lastRest = "";
+		return r;
+	}
+}
+
+/** 清理粘贴文本：去 \r\n / \r / \n；\t → 4 空格。
+ *  对齐 pi-tui Input.handlePaste 的行为。单行字段不需要换行。 */
+function sanitizePasteText(s: string): string {
+	return s.replace(/\r\n/g, "").replace(/\r/g, "").replace(/\n/g, "").replace(/\t/g, "    ");
+}
+
 // ============================================================================
 // ModelChecklist — 多选 checklist（sync 用）
 // ============================================================================
@@ -45,28 +116,44 @@ export type ChecklistItem = {
 	disabled?: boolean;  // true = 显示但不让选
 };
 
+/** 视口默认行数（不含 header / summary / search / footer / scroll indicator）。8 和 pi 的 /models 一致。
+ *  在 provider-manager.json#syncViewportSize 可调（5-200）。 */
+export const CHECKLIST_DEFAULT_MAX_ROWS = 8;
+/** syncViewportSize 越界后由这个补齐 */
+export const CHECKLIST_MIN_MAX_ROWS = 5;
+export const CHECKLIST_MAX_MAX_ROWS = 200;
+
 export class ModelChecklist {
 	private items: ChecklistItem[];
 	private selected: Set<string>;
 	private cursor = 0;
+	private top = 0;
 	private title: string;
 	private theme: any;
+	private maxRows: number;
 	private onConfirm: (selected: string[]) => void;
 	private onCancel: () => void;
 	private cachedWidth = -1;
 	private cachedLines: string[] = [];
+	/** 括包粘贴缓冲：pi 框架的 Ctrl+V / Alt+V / 右键粘贴会用 ESC[200~..ESC[201~ 包后 call handleInput。 */
+	private pasteBuf = new PasteBuffer();
+	/** search 输入框的当前内容。同步起作用、可被全打印字符 / Backspace 修改。 */
+	private query = "";
 
 	constructor(opts: {
 		title: string;
 		items: ChecklistItem[];
 		theme: any;
 		preSelect?: (item: ChecklistItem) => boolean;  // 默认全选时筛掉不想要的
+		maxRows?: number;
 		onConfirm: (selected: string[]) => void;
 		onCancel: () => void;
 	}) {
 		this.title = opts.title;
 		this.items = opts.items;
 		this.theme = opts.theme;
+		const m = opts.maxRows ?? CHECKLIST_DEFAULT_MAX_ROWS;
+		this.maxRows = Math.max(CHECKLIST_MIN_MAX_ROWS, Math.min(CHECKLIST_MAX_MAX_ROWS, m));
 		this.onConfirm = opts.onConfirm;
 		this.onCancel = opts.onCancel;
 		this.selected = new Set();
@@ -75,9 +162,44 @@ export class ModelChecklist {
 			if (opts.preSelect && !opts.preSelect(it)) continue;
 			this.selected.add(it.id);
 		}
+		// 粘贴多字符进 search 输入框（如粘贴 apiKey / model id 过滤）
+		this.pasteBuf.onPaste = (text) => {
+			if (!text) return;
+			this.query += text;
+			const v = this.visibleItems();
+			if (this.cursor >= v.length) this.cursor = Math.max(0, v.length - 1);
+			this.top = 0;
+			this.invalidate();
+		};
+	}
+
+	/** query 作用后的可见项列表。空 query ＝全量；disabled 始终隐藏。 */
+	private visibleItems(): ChecklistItem[] {
+		if (!this.query) return this.items;
+		const q = this.query.toLowerCase();
+		return this.items.filter((it) => {
+			if (it.disabled) return false;
+			const id = (it.id ?? "").toLowerCase();
+			const lbl = (it.label ?? "").toLowerCase();
+			return id.includes(q) || lbl.includes(q);
+		});
+	}
+
+	/** 调 top 使 cursor 在视口内。视口高度不含 (top) 钉住额外占的那几行。 */
+	private adjustTop(viewportH: number): void {
+		if (viewportH <= 0) return;
+		if (this.cursor < this.top) this.top = this.cursor;
+		if (this.cursor >= this.top + viewportH) this.top = this.cursor - viewportH + 1;
+		if (this.top < 0) this.top = 0;
 	}
 
 	handleInput(data: string): void {
+		// 括包粘贴：Ctrl+V / Alt+V / 右键粘走 PasteBuffer
+		if (this.pasteBuf.feed(data)) {
+			const rest = this.pasteBuf.consumeRest();
+			if (rest) this.processRest(rest);
+			return;
+		}
 		if (matchesKey(data, "escape") || data === "q") {
 			this.onCancel();
 			return;
@@ -86,8 +208,28 @@ export class ModelChecklist {
 			this.onConfirm([...this.selected]);
 			return;
 		}
+		const visible = this.visibleItems();
+		if (visible.length === 0) {
+			// 空 list 下只认 search / 退出键
+			if (matchesKey(data, "backspace")) {
+				if (this.query.length > 0) {
+					this.query = this.query.slice(0, -1);
+					this.cursor = 0;
+					this.top = 0;
+					this.invalidate();
+				}
+				return;
+			}
+			if (data.length === 1 && data.charCodeAt(0) >= 32 && data.charCodeAt(0) < 127) {
+				this.query += data;
+				this.cursor = 0;
+				this.top = 0;
+				this.invalidate();
+			}
+			return;
+		}
 		if (data === " ") {
-			const it = this.items[this.cursor];
+			const it = visible[this.cursor];
 			if (it && !it.disabled) {
 				if (this.selected.has(it.id)) this.selected.delete(it.id);
 				else this.selected.add(it.id);
@@ -95,32 +237,76 @@ export class ModelChecklist {
 			}
 			return;
 		}
+		// wrap-around：顶部 ↑ 跳到末项、底部 ↓ 跳回首项（和 pi 的 /models 一致）
 		if (matchesKey(data, "down") || data === "j") {
-			this.cursor = Math.min(this.cursor + 1, this.items.length - 1);
+			this.cursor = (this.cursor + 1) % visible.length;
 			this.invalidate();
-		} else if (matchesKey(data, "up") || data === "k") {
-			this.cursor = Math.max(this.cursor - 1, 0);
+			return;
+		}
+		if (matchesKey(data, "up") || data === "k") {
+			this.cursor = (this.cursor - 1 + visible.length) % visible.length;
 			this.invalidate();
-		} else if (data === "a") {
-			// toggle all (only non-disabled)
-			const allIds = this.items.filter((it) => !it.disabled).map((it) => it.id);
-			if (this.selected.size === allIds.length) this.selected.clear();
-			else this.selected = new Set(allIds);
+			return;
+		}
+		if (matchesKey(data, "backspace")) {
+			// 优先删 search 字；query 空时退化为 no-op（不动 cursor）
+			if (this.query.length > 0) {
+				this.query = this.query.slice(0, -1);
+				// query 变了，重新算 visible 与 cursor
+				const v2 = this.visibleItems();
+				if (this.cursor >= v2.length) this.cursor = Math.max(0, v2.length - 1);
+				this.top = 0;
+				this.invalidate();
+			}
+			return;
+		}
+		// 其他可打印字符：进 search（不设 a/g/i 等快捷键了 — search-first 约定）
+		if (data.length === 1 && data.charCodeAt(0) >= 32 && data.charCodeAt(0) < 127) {
+			this.query += data;
+			// query 变了重算
+			const v2 = this.visibleItems();
+			if (this.cursor >= v2.length) this.cursor = Math.max(0, v2.length - 1);
+			this.top = 0;
 			this.invalidate();
-		} else if (data === "g") {
-			// jump to top
-			this.cursor = 0; this.invalidate();
-		} else if (data === "G") {
-			// jump to bottom
-			this.cursor = this.items.length - 1; this.invalidate();
-		} else if (data === "i") {
-			// invert selection
-			const next = new Set<string>();
-			for (const it of this.items) {
-				if (it.disabled) continue;
-				if (!this.selected.has(it.id)) next.add(it.id);
-			}
-			this.selected = next;
+		}
+	}
+
+	/** 处理括包粘贴后剩余的字符串：按字符逐个调 handleInput（不走 PasteBuffer 路径）。 */
+	private processRest(rest: string): void {
+		for (const ch of rest) {
+			// 直接走常规路径。上面 handleInput 的 pasteBuf.feed 在这个深度返回 false（同一实例状态不嵌套）
+			this.dispatchChar(ch);
+		}
+	}
+
+	/** 单个字符的常规处理（从 handleInput 拆出，给 processRest 复用）。
+	 *  只处理 “单可打印字符” / Space / Backspace；其他键（多字节转义序列、Enter 等）不响应。 */
+	private dispatchChar(ch: string): void {
+		if (matchesKey(ch, "backspace")) {
+			if (this.query.length > 0) {
+				this.query = this.query.slice(0, -1);
+				const v2 = this.visibleItems();
+				if (this.cursor >= v2.length) this.cursor = Math.max(0, v2.length - 1);
+				this.top = 0;
+				this.invalidate();
+			}
+			return;
+		}
+		if (ch === " ") {
+			const visible = this.visibleItems();
+			const it = visible[this.cursor];
+			if (it && !it.disabled) {
+				if (this.selected.has(it.id)) this.selected.delete(it.id);
+				else this.selected.add(it.id);
+				this.invalidate();
+			}
+			return;
+		}
+		if (ch.length === 1 && ch.charCodeAt(0) >= 32 && ch.charCodeAt(0) < 127) {
+			this.query += ch;
+			const v2 = this.visibleItems();
+			if (this.cursor >= v2.length) this.cursor = Math.max(0, v2.length - 1);
+			this.top = 0;
 			this.invalidate();
 		}
 	}
@@ -132,53 +318,147 @@ export class ModelChecklist {
 		const th = this.theme;
 		const lines: string[] = [];
 
-		// Header
-		const head = th.fg("accent", th.bold(` ${this.title} `)) + th.fg("borderMuted", "─".repeat(Math.max(0, width - this.title.length - 4)));
-		lines.push(head);
 		const total = this.items.length;
 		const sel = this.selected.size;
 		const disabled = this.items.filter((it) => it.disabled).length;
+		const visible = this.visibleItems();
+		const visCount = visible.length;
+
+		// Header：title + 上划线
+		const head = th.fg("accent", th.bold(` ${this.title} `)) + th.fg("borderMuted", "─".repeat(Math.max(0, width - this.title.length - 4)));
+		lines.push(head);
+		// 顶部 selected / total 状态
 		const summary = ` ${sel}/${total} selected${disabled ? ` (${disabled} existing, skipped)` : ""} `;
 		lines.push(th.fg("dim", summary));
+		// search 输入框（始终显示）
+		const queryW = Math.max(0, width - 4);
+		const queryShown = this.query.length > queryW ? this.query.slice(0, queryW) : this.query;
+		// pi 的 /models 风格："> " 作为 prompt，"|" 是 cursor。query 末尾加 "▏" 作为 placeholder 提示。
+		const queryLine = th.fg("accent", " > ") + (this.query ? th.fg("text", queryShown) : th.fg("muted", "▏"));
+		lines.push(truncateForRender(queryLine, width));
 		lines.push("");
 
-		// List
-		if (total === 0) {
-			lines.push(th.fg("dim", "  (no models to choose from)"));
+		// 列表区
+		// 布局：visible.length > maxRows 时顶部钉住首项 + (top)，多占 2 行。
+		// 这样 mid-list 滚动也能看到 “列表起点是谁” 。
+		const itemLines: string[] = [];
+		let moreBelow: string | null = null;
+		if (visCount === 0) {
+			itemLines.push(th.fg("dim", this.query
+				? `  (no models match "${this.query}")`
+				: "  (no models to choose from)"));
 		} else {
-			for (let i = 0; i < this.items.length; i++) {
-				const it = this.items[i];
+			const needPinOutside = this.cursor >= this.maxRows;
+			// 钉住首项占 1 行。有效视口 = maxRows - 1（未钉住时 = maxRows）
+			const effectiveViewport = Math.max(1, this.maxRows - (needPinOutside ? 1 : 0));
+			this.adjustTop(effectiveViewport);
+			const viewStart = this.top;
+			const viewEnd = Math.min(visCount, viewStart + effectiveViewport);
+
+			if (needPinOutside) {
+				const first = visible[0];
+				const box = first.disabled ? th.fg("dim", "[skip]")
+					: this.selected.has(first.id) ? th.fg("success", "[√]")
+					: th.fg("dim", "[ ]");
+				itemLines.push(truncateForRender(`  ${box} ${first.id}  ${th.fg("dim", "(top)")}`, width));
+				// hidden 计数：剩下未在钉住首项 / viewport 中展示的项
+				// = total - (1 pinned + viewport) = total - maxRows
+				const hiddenTotal = visCount - 1 - (viewEnd - viewStart);
+				if (hiddenTotal > 0) {
+					itemLines.push(th.fg("dim", `  ⋮ ${hiddenTotal} hidden`));
+				}
+			}
+			for (let i = viewStart; i < viewEnd; i++) {
+				const it = visible[i];
 				const isCursor = i === this.cursor;
-				const arrow = isCursor ? th.fg("accent", "▸ ") : "  ";
-				let box: string;
-				if (it.disabled) box = th.fg("dim", "[skip]");
-				else if (this.selected.has(it.id)) box = th.fg("success", "[√]");
-				else box = th.fg("dim", "[ ]");
+				const arrow = isCursor ? th.fg("accent", "▶ ") : "  ";
+				const box = it.disabled ? th.fg("dim", "[skip]")
+					: this.selected.has(it.id) ? th.fg("success", "[√]")
+					: th.fg("dim", "[ ]");
 				const id = isCursor ? th.bold(it.id) : it.id;
+				const topLabel = (i === 0 && !needPinOutside) ? th.fg("dim", "  (top)") : "";
 				const sub = it.label ? "  " + th.fg("muted", it.label) : "";
-				lines.push(truncateForRender(`${arrow}${box} ${id}${sub}`, width));
+				itemLines.push(truncateForRender(`${arrow}${box} ${id}${topLabel}${sub}`, width));
 			}
+			if (viewEnd < visCount) {
+				const nextId = visible[viewEnd]?.id ?? "";
+				moreBelow = `  ⋮ ${visCount - viewEnd} more below (${nextId} …)`;
+			}
+		}
+
+		// items 先
+		for (const l of itemLines) lines.push(l);
+		if (moreBelow) lines.push(moreBelow);
+
+		// 位置指示：i / visCount，与 pi 的 /models 一致
+		// 注意：query 为空时 visCount = total，仍能告知总长度；query 非空时为过滤后位置
+		if (visCount > 0) {
+			lines.push(th.fg("muted", `  (${this.cursor + 1}/${visCount})`));
 		}
 
+		// chrome 置底
 		lines.push("");
 		lines.push(th.fg("borderMuted", "─".repeat(width)));
-		lines.push(th.fg("dim", " Space  toggle · ↑↓/jk  nav · g/G  top/bot · a  all · i  invert · Enter  apply · Esc  cancel"));
+		// 底部提示词：search 始终是首选，所以 a/i/g/G 不再是快捷键。
+		lines.push(th.fg("dim", " type to filter · Space toggle · ↑↓/jk nav (wrap) · Backspace del · Enter apply · Esc cancel"));
+
 		this.cachedWidth = width;
 		this.cachedLines = lines;
 		return lines;
 	}
 }
 
-/** 给 render 用的截断（不剥主题，简化版；与 ui.ts 的 truncateToWidth 行为一致） */
+/** 给 render 用的截断。计算宽度时跳过 ANSI 转义序列 + 已知主题标签，避免裁到一半丢颜色。 */
 function truncateForRender(s: string, width: number): string {
 	if (width <= 0) return "";
+	const KNOWN_THEME_TAGS = new Set<string>([
+		"accent", "warning", "dim", "success", "error", "muted", "text",
+		"borderMuted", "border", "borderAccent",
+		"background", "primary", "secondary",
+		"toolTitle", "toolOutput", "toolBg",
+		"customMessageBg", "userMessageBg", "thinking",
+		"bold", "italic", "underline", "inverse",
+		"selection", "comment", "keyword", "string", "number", "function",
+		"variable", "type", "operator", "punctuation", "property",
+	]);
 	let w = 0;
 	let out = "";
-	for (const ch of s) {
+	let i = 0;
+	while (i < s.length) {
+		// ANSI 转义序列：\x1b[ ... m（零宽）
+		if (s[i] === "\x1b" && i + 1 < s.length && s[i + 1] === "[") {
+			const close = s.indexOf("m", i + 2);
+			if (close !== -1) {
+				out += s.slice(i, close + 1);
+				i = close + 1;
+				continue;
+			}
+			// 其他 CSI 序列：结尾是某个字母
+			const tail = s.slice(i + 2).search(/[A-Za-z]/);
+			if (tail !== -1) {
+				out += s.slice(i, i + 2 + tail + 1);
+				i = i + 2 + tail + 1;
+				continue;
+			}
+		}
+		// 旧主题标签 [tag] / [/tag]：仅白名单内的零宽
+		if (s[i] === "[") {
+			const close = s.indexOf("]", i + 1);
+			if (close !== -1) {
+				const inner = s.slice(i + 1, close);
+				if (KNOWN_THEME_TAGS.has(inner) || (inner.startsWith("/") && KNOWN_THEME_TAGS.has(inner.slice(1)))) {
+					out += s.slice(i, close + 1);
+					i = close + 1;
+					continue;
+				}
+			}
+		}
+		const ch = s[i]!;
 		const cw = isWideChar(ch) ? 2 : 1;
 		if (w + cw > width) return out + (w + 1 <= width ? "…" : "");
 		out += ch;
 		w += cw;
+		i++;
 	}
 	return out;
 }
@@ -232,6 +512,8 @@ export class FormEditor<T extends Record<string, unknown>> {
 	private onCancel: () => void;
 	private cachedWidth = -1;
 	private cachedLines: string[] = [];
+	/** 括包粘贴缓冲：pi 框架的 Ctrl+V / Alt+V / 右键粘贴会用 ESC[200~..ESC[201~ 包后 call handleInput。 */
+	private pasteBuf = new PasteBuffer();
 
 	constructor(opts: {
 		title: string;
@@ -250,6 +532,29 @@ export class FormEditor<T extends Record<string, unknown>> {
 		this.onCancel = opts.onCancel;
 		this.draft = this.currentValueAsString();
 		this.draftIsOriginal = true;
+		// 粘贴：view 模式自动进 edit（避免被 view 模式接货的选中不动）；仅 typeable 字段响应
+		this.pasteBuf.onPaste = (text) => {
+			if (!text) return;
+			const f0 = this.fields[this.cursor];
+			const isTypeable = f0 && (f0.type === "text" || f0.type === "secret" || f0.type === "number" || f0.type === "json");
+			if (!isTypeable) return;
+			if (!this.editing) {
+				// secret：跟 Enter 走同路径——草稿重置为原值，未修改标记
+				if (f0.type === "secret") {
+					const orig = (this.values as any)[f0.key];
+					this.draft = (orig === undefined || orig === null) ? "" : String(orig);
+					this.draftIsOriginal = true;
+				}
+				this.editing = true;
+			}
+			// number：过滤非数字，避免误粘 "123abc"；secret / text / json 原样拼
+			const chunk = f0.type === "number" ? text.replace(/[^0-9]/g, "") : text;
+			if (!chunk) return;
+			if (f0.type === "number" && this.draftIsOriginal) this.draft = chunk;  // 首次输入覆盖
+			else this.draft += chunk;
+			this.draftIsOriginal = false;
+			this.invalidate();
+		};
 	}
 
 	private currentValueAsString(): string {
@@ -367,6 +672,12 @@ export class FormEditor<T extends Record<string, unknown>> {
 	}
 
 	handleInput(data: string): void {
+		// 括包粘贴：Ctrl+V / Alt+V / 右键粘走 PasteBuffer（onPaste 检查 editing + typeable）
+		if (this.pasteBuf.feed(data)) {
+			const rest = this.pasteBuf.consumeRest();
+			if (rest) this.processRest(rest);
+			return;
+		}
 		const f0 = this.fields[this.cursor];
 		const isNonInput = f0?.type === "select" || f0?.type === "levelmap" || f0?.type === "multiselect";
 		const isTypeable = f0 && (f0.type === "text" || f0.type === "secret" || f0.type === "number" || f0.type === "json");
@@ -541,6 +852,34 @@ export class FormEditor<T extends Record<string, unknown>> {
 		}
 	}
 
+	/** 处理括包粘贴后剩余的字符串：按字符逐个调 handleInput（不走 PasteBuffer 路径）。 */
+	private processRest(rest: string): void {
+		for (const ch of rest) this.dispatchChar(ch);
+	}
+
+	/** 单个字符的常规处理（仅 typeable 字符 / Backspace）。其他键不响应。 */
+	private dispatchChar(ch: string): void {
+		const f0 = this.fields[this.cursor];
+		const isTypeable = f0 && (f0.type === "text" || f0.type === "secret" || f0.type === "number" || f0.type === "json");
+		if (matchesKey(ch, "backspace")) {
+			if (!this.editing || !isTypeable) return;
+			if (this.draft.length > 0) this.draft = this.draft.slice(0, -1);
+			this.draftIsOriginal = false;
+			this.invalidate();
+			return;
+		}
+		if (!this.editing || !isTypeable) return;
+		if (ch.length === 1 && ch.charCodeAt(0) >= 32 && ch.charCodeAt(0) < 127) {
+			if (f0?.type === "number" && /^\d$/.test(ch) && this.draftIsOriginal) {
+				this.draft = ch;
+			} else {
+				this.draft += ch;
+			}
+			this.draftIsOriginal = false;
+			this.invalidate();
+		}
+	}
+
 	invalidate(): void { this.cachedWidth = -1; this.cachedLines = []; }
 
 	private formatValue(f: FormField, v: unknown): string {