@herbertgao/pi-extensions 2026.8.1 → 2026.8.3

package/node_modules/@herbertgao/pi-cc-extensions/extensions/{feature → renderer}/markdown-enhance.ts

@@ -102,14 +102,11 @@ function trimUrl(url: string): string {
 function linkifyUrls(markdown: string): string {
 	const lines = markdown.split("\n");
 	const out: string[] = [];
-	let inFence = false;
+	let fence: MarkdownFence | undefined;
 	for (const line of lines) {
-		if (/^```/.test(line)) {
-			inFence = !inFence;
-			out.push(line);
-			continue;
-		}
-		if (inFence) {
+		const scanned = scanMarkdownFence(line, fence);
+		fence = scanned.fence;
+		if (scanned.protected) {
 			out.push(line);
 			continue;
 		}
@@ -129,6 +126,129 @@ function linkifyUrls(markdown: string): string {
 	return out.join("\n");
 }
 
+// ============================================================================
+// 圈数字 → 半角括号
+// ============================================================================
+
+// Nerd Font 补丁字形（U+2460-U+2473）ink 超界，DirectWrite 下渲染会压住相邻字符；
+// 转成 ASCII "(n)" 后任何字体下宽度一致。U+2460-U+2473 连续，差值即序号。
+const CIRCLED_RE = /[①-⑳]/g;
+const BLOCKQUOTE_PREFIX = /^ {0,3}>[ \t]?/;
+const CODE_FENCE_OPEN = /^ {0,3}(`{3,}|~{3,})/;
+const CODE_FENCE_CLOSE = /^ {0,3}(`+|~+)[ \t]*$/;
+
+type FenceLine = { blockquoteDepth: number; content: string };
+type MarkdownFence = { marker: string; blockquoteDepth: number };
+
+function parseFenceLine(line: string): FenceLine {
+	let content = line;
+	let blockquoteDepth = 0;
+	while (BLOCKQUOTE_PREFIX.test(content)) {
+		content = content.replace(BLOCKQUOTE_PREFIX, "");
+		blockquoteDepth++;
+	}
+	return { blockquoteDepth, content };
+}
+
+function scanMarkdownFence(
+	line: string,
+	fence: MarkdownFence | undefined,
+): { protected: boolean; fence: MarkdownFence | undefined } {
+	const parsed = parseFenceLine(line);
+	if (fence && parsed.blockquoteDepth >= fence.blockquoteDepth) {
+		const close = parsed.content.match(CODE_FENCE_CLOSE)?.[1];
+		const closed =
+			parsed.blockquoteDepth === fence.blockquoteDepth &&
+			close?.[0] === fence.marker[0] &&
+			close.length >= fence.marker.length;
+		return { protected: true, fence: closed ? undefined : fence };
+	}
+	const marker = parsed.content.match(CODE_FENCE_OPEN)?.[1];
+	return {
+		protected: Boolean(marker),
+		fence: marker ? { marker, blockquoteDepth: parsed.blockquoteDepth } : undefined,
+	};
+}
+
+function replaceCircled(text: string): string {
+	return text.replace(CIRCLED_RE, (ch) => `(${ch.codePointAt(0)! - 0x2460 + 1})`);
+}
+
+function backtickRunAt(
+	text: string,
+	start: number,
+	skipEscaped: boolean,
+): { start: number; end: number } | null {
+	let index = text.indexOf("`", start);
+	while (index >= 0) {
+		let backslashes = 0;
+		for (let cursor = index - 1; cursor >= 0 && text[cursor] === "\\"; cursor--) backslashes++;
+		if (!skipEscaped || backslashes % 2 === 0) {
+			let end = index + 1;
+			while (text[end] === "`") end++;
+			return { start: index, end };
+		}
+		index = text.indexOf("`", index + 1);
+	}
+	return null;
+}
+
+/** 转换连续 prose（可跨行），但保留有效 inline code spans。 */
+function deCircledProse(prose: string): string {
+	let cursor = 0;
+	let transformed = "";
+	while (cursor < prose.length) {
+		const opening = backtickRunAt(prose, cursor, true);
+		if (!opening) {
+			transformed += replaceCircled(prose.slice(cursor));
+			break;
+		}
+		let closing = backtickRunAt(prose, opening.end, false);
+		while (closing && closing.end - closing.start !== opening.end - opening.start) {
+			closing = backtickRunAt(prose, closing.end, false);
+		}
+		if (!closing) {
+			transformed += replaceCircled(prose.slice(cursor, opening.end));
+			cursor = opening.end;
+			continue;
+		}
+		transformed += replaceCircled(prose.slice(cursor, opening.start));
+		transformed += prose.slice(opening.start, closing.end);
+		cursor = closing.end;
+	}
+	return transformed;
+}
+
+/** 转换普通 Markdown 文本，但保留匹配 container 的 fenced blocks 与 inline code spans。 */
+function deCircled(markdown: string): string {
+	const output: string[] = [];
+	let prose: string[] = [];
+	let fence: MarkdownFence | undefined;
+	const flushProse = () => {
+		if (prose.length === 0) return;
+		output.push(deCircledProse(prose.join("\n")));
+		prose = [];
+	};
+
+	for (const line of markdown.split("\n")) {
+		const scanned = scanMarkdownFence(line, fence);
+		fence = scanned.fence;
+		if (scanned.protected) {
+			flushProse();
+			output.push(line);
+			continue;
+		}
+		if (parseFenceLine(line).content.trim() === "") {
+			flushProse();
+			output.push(line);
+			continue;
+		}
+		prose.push(line);
+	}
+	flushProse();
+	return output.join("\n");
+}
+
 // ============================================================================
 // 注册
 // ============================================================================
@@ -140,6 +260,8 @@ export default function (pi: ExtensionAPI): void {
 		const { messageType, isStreaming = false } = context ?? {};
 		// 与官方推荐一致：thinking 块与流式中间态不转换
 		if (messageType === "assistant-thinking" || isStreaming) return markdown;
+		// 0. 圈数字转半角括号（Nerd Font 补丁字形缺陷规避）
+		markdown = deCircled(markdown);
 		// 1. Mermaid 方言渲染
 		markdown = renderDiagrams(markdown, context);
 		// 2. GitHub 风格提示框
@@ -212,17 +334,18 @@ function renderDiagrams(
 function renderAdmonitions(markdown: string): string {
 	const lines = markdown.split("\n");
 	const out: string[] = [];
-	let inFence = false;
+	let fence: MarkdownFence | undefined;
 	let i = 0;
 	while (i < lines.length) {
 		const line = lines[i];
-		if (/^```/.test(line)) {
-			inFence = !inFence;
+		const scanned = scanMarkdownFence(line, fence);
+		fence = scanned.fence;
+		if (scanned.protected) {
 			out.push(line);
 			i++;
 			continue;
 		}
-		if (!inFence && /^>\s*\[\s*!/i.test(line)) {
+		if (/^>\s*\[\s*!/i.test(line)) {
 			const result = renderAdmonition(lines, i);
 			if (result) {
 				out.push(...result.output);

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/mouse/hover.ts

@@ -0,0 +1,130 @@
+import { setHoveredCompactAssistant } from "../compact-mode.ts";
+import {
+	isExpandedToolIoView,
+	invalidateIoView,
+	type ExpandedToolIoView,
+	type ToolIoSection,
+} from "../tool/result.ts";
+import type { ToolGroupComponent } from "../tool/grouping.ts";
+import { componentAtLocalRow, type ComponentRowHit } from "./layout.ts";
+import { setScrollButtonHovered } from "./scroll.ts";
+
+const TOOL_HOVER_STATE_KEY = Symbol.for("pi.ccstyle.tool-hover-state");
+
+type SharedToolHoverState = { toolCallId: string | null };
+
+/**
+ * hover 状态宿主（Symbol.for + globalThis）：模块 reload 后新旧实例共享，
+ * 测试依赖该跨实例语义。
+ */
+export function sharedToolHoverState(): SharedToolHoverState {
+	const host = globalThis as any;
+	return (host[TOOL_HOVER_STATE_KEY] ??= { toolCallId: null });
+}
+
+export let hoveredToolCallId: string | null = sharedToolHoverState().toolCallId;
+
+export function setHoveredToolCallId(toolCallId: string | null): void {
+	hoveredToolCallId = toolCallId;
+	sharedToolHoverState().toolCallId = toolCallId;
+}
+
+export function isToolCallHovered(toolCallId: string | null | undefined): boolean {
+	return Boolean(toolCallId && sharedToolHoverState().toolCallId === toolCallId);
+}
+
+let hoveredToolGroup: ToolGroupComponent | null = null;
+
+export function setHoveredToolGroup(group: ToolGroupComponent | null): boolean {
+	if (group === hoveredToolGroup) return false;
+	hoveredToolGroup?.setHintHovered(false);
+	hoveredToolGroup = group;
+	group?.setHintHovered(true);
+	return true;
+}
+
+let hoveredToolIoView: ExpandedToolIoView | null = null;
+let hoveredToolIoSection: ToolIoSection | null = null;
+
+export function setHoveredToolIo(
+	view: ExpandedToolIoView | null,
+	section: ToolIoSection | null,
+): boolean {
+	// resultRendererComponent 可能是 Text/第三方 renderer；reload 后也可能残留旧实例。
+	const nextView = isExpandedToolIoView(view) ? view : null;
+	const nextSection = nextView ? section : null;
+	if (nextView === hoveredToolIoView && nextSection === hoveredToolIoSection) return false;
+	if (isExpandedToolIoView(hoveredToolIoView)) {
+		hoveredToolIoView.setHoveredSection(null);
+		invalidateIoView(hoveredToolIoView);
+	}
+	hoveredToolIoView = nextView;
+	hoveredToolIoSection = nextSection;
+	if (nextView) {
+		nextView.setHoveredSection(nextSection);
+		invalidateIoView(nextView);
+	}
+	return true;
+}
+
+/** hover 与点击共用组件定位；同一布局下按容器/宽度/行缓存，避免 motion 重复渲染。 */
+let fullscreenHoverCacheLayout: unknown = null;
+let fullscreenHoverComponentCache = new WeakMap<object, Map<string, ComponentRowHit | null>>();
+
+export function cachedFullscreenComponentAtRow(
+	layout: any,
+	container: any,
+	row: number,
+	width: number,
+): ComponentRowHit | null {
+	if (!container || typeof container !== "object") return null;
+	if (fullscreenHoverCacheLayout !== layout) {
+		fullscreenHoverCacheLayout = layout;
+		fullscreenHoverComponentCache = new WeakMap();
+	}
+	let rows = fullscreenHoverComponentCache.get(container);
+	if (!rows) {
+		rows = new Map();
+		fullscreenHoverComponentCache.set(container, rows);
+	}
+	const key = `${width}:${row}`;
+	if (rows.has(key)) return rows.get(key) ?? null;
+	const hit = componentAtLocalRow(container, row, width);
+	rows.set(key, hit);
+	return hit;
+}
+
+/** fullscreen 鼠标悬停目标。 */
+export type FullscreenHoverTarget =
+	| { kind: "button" }
+	| { kind: "group"; component: ToolGroupComponent }
+	| { kind: "assistant"; component: any }
+	| {
+			kind: "tool";
+			component: any;
+			view: ExpandedToolIoView | null;
+			section: ToolIoSection | null;
+	  };
+
+/** 悬停状态变化才触发渲染（motion 事件密集，状态不变跳过）。 */
+export function applyFullscreenHover(tui: any, target: FullscreenHoverTarget | null): void {
+	let changed = false;
+	const nextCallId =
+		target?.kind === "tool" && !target.component.expanded
+			? (target.component.toolCallId ?? null)
+			: null;
+	if (nextCallId !== sharedToolHoverState().toolCallId) {
+		setHoveredToolCallId(nextCallId);
+		changed = true;
+	}
+	const nextGroup = target?.kind === "group" ? target.component : null;
+	if (setHoveredToolGroup(nextGroup)) changed = true;
+	const nextAssistant = target?.kind === "assistant" ? target.component : null;
+	if (setHoveredCompactAssistant(nextAssistant)) changed = true;
+	const nextView = target?.kind === "tool" ? target.view : null;
+	const nextSection = target?.kind === "tool" ? target.section : null;
+	if (setHoveredToolIo(nextView, nextSection)) changed = true;
+	const nextButton = target?.kind === "button";
+	if (setScrollButtonHovered(nextButton)) changed = true;
+	if (changed) tui.requestRender?.();
+}