pi-cc-extensions 0.8.9 → 0.8.11

package/extensions/tool-diff/ATTRIBUTION.md

@@ -0,0 +1,28 @@
+# Attribution
+
+The rich diff renderer in this directory is adapted from
+[MasuRii/pi-tool-display](https://github.com/MasuRii/pi-tool-display) at commit
+`91cef7580078371f8dc49a8607222807ad6a424d`.
+
+Copyright (c) MasuRii and pi-tool-display contributors. Used under the MIT
+License. The upstream license text is reproduced below.
+
+> MIT License
+>
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in all
+> copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+> SOFTWARE.

package/extensions/tool-diff/ansi-utils.ts

@@ -0,0 +1,113 @@
+const ANSI_SGR_PATTERN = /\x1b\[([0-9;]*)m/g;
+const STYLE_RESET_PARAMS = [39, 22, 23, 24, 25, 27, 28, 29, 59] as const;
+
+export { ANSI_SGR_PATTERN, STYLE_RESET_PARAMS };
+
+export function expandSgrReset(param: number): readonly number[] | undefined {
+	return param === 0 ? STYLE_RESET_PARAMS : undefined;
+}
+
+export function toSgrParams(rawParams: string): number[] {
+	if (!rawParams.trim()) {
+		return [0];
+	}
+
+	const parsed = rawParams
+		.split(";")
+		.map((token) => Number.parseInt(token, 10))
+		.filter((value) => Number.isFinite(value));
+
+	return parsed.length > 0 ? parsed : [];
+}
+
+export function isFiniteSgrParam(value: number | undefined): value is number {
+	return typeof value === "number" && Number.isFinite(value);
+}
+
+export function readSgrColorSequence(params: number[], index: number): number[] | undefined {
+	const param = params[index];
+	if (param !== 38 && param !== 48) {
+		return undefined;
+	}
+
+	const colorMode = params[index + 1];
+	if (colorMode === 5) {
+		const colorValue = params[index + 2];
+		return isFiniteSgrParam(colorValue) ? [param, colorMode, colorValue] : undefined;
+	}
+
+	if (colorMode === 2) {
+		const red = params[index + 2];
+		const green = params[index + 3];
+		const blue = params[index + 4];
+		return isFiniteSgrParam(red) && isFiniteSgrParam(green) && isFiniteSgrParam(blue)
+			? [param, colorMode, red, green, blue]
+			: undefined;
+	}
+
+	return undefined;
+}
+
+export function stripBackgroundSgrParams(params: readonly number[]): number[] {
+	const sanitized: number[] = [];
+
+	for (let index = 0; index < params.length; index++) {
+		const param = params[index] ?? 0;
+
+		if (param === 0) {
+			sanitized.push(...expandSgrReset(param)!);
+			continue;
+		}
+
+		if (param === 49 || (param >= 40 && param <= 47) || (param >= 100 && param <= 107)) {
+			continue;
+		}
+
+		if (param === 38 || param === 48) {
+			const sequence = readSgrColorSequence(params as number[], index);
+			if (sequence) {
+				if (param === 38) {
+					sanitized.push(...sequence);
+				}
+				index += sequence.length - 1;
+				continue;
+			}
+			const advance = params[index + 1] === 5 ? 2 : params[index + 1] === 2 ? 4 : 0;
+			if (advance > 0) {
+				index += advance;
+				if (param === 38) {
+					sanitized.push(param);
+				}
+				continue;
+			}
+		}
+
+		sanitized.push(param);
+	}
+
+	return sanitized;
+}
+
+export function filterSgrSequences(text: string, filter: (params: number[]) => number[]): string {
+	if (!text || !text.includes("\x1b[")) {
+		return text;
+	}
+
+	return text.replace(ANSI_SGR_PATTERN, (_sequence, rawParams: string) => {
+		const parsed = toSgrParams(rawParams);
+		if (parsed.length === 0) {
+			return "";
+		}
+
+		const sanitized = filter(parsed);
+		if (sanitized.length === 0) {
+			return "";
+		}
+
+		return `\x1b[${sanitized.join(";")}m`;
+	});
+}
+
+export function sanitizeAnsiForThemedOutput(text: string): string {
+	return filterSgrSequences(text, stripBackgroundSgrParams);
+}

package/extensions/tool-diff/diff-presentation.ts

@@ -0,0 +1,70 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { pluralize } from "./render-utils.ts";
+import type { ToolDisplayConfig } from "./types.ts";
+
+export interface DiffSummaryStats {
+	added: number;
+	removed: number;
+	hunks: number;
+	files: number;
+}
+
+export type DiffPresentationMode = "split" | "unified" | "compact" | "summary";
+
+const MIN_COMPACT_DIFF_WIDTH = 8;
+const MIN_UNIFIED_DIFF_WIDTH = 18;
+
+export function normalizeDiffRenderWidth(width: number): number {
+	if (!Number.isFinite(width)) {
+		return 0;
+	}
+	return Math.max(0, Math.floor(width));
+}
+
+export function resolveDiffPresentationMode(
+	config: Pick<ToolDisplayConfig, "diffViewMode" | "diffSplitMinWidth">,
+	width: number,
+	canRenderSplitLayout: boolean,
+): DiffPresentationMode {
+	const safeWidth = normalizeDiffRenderWidth(width);
+	if (safeWidth < MIN_COMPACT_DIFF_WIDTH) {
+		return "summary";
+	}
+	if (safeWidth < MIN_UNIFIED_DIFF_WIDTH) {
+		return "compact";
+	}
+
+	switch (config.diffViewMode) {
+		case "split":
+			return canRenderSplitLayout ? "split" : "unified";
+		case "unified":
+			return "unified";
+		case "auto":
+		default:
+			return safeWidth >= config.diffSplitMinWidth && canRenderSplitLayout ? "split" : "unified";
+	}
+}
+
+export function buildDiffSummaryText(stats: DiffSummaryStats, width: number): string {
+	const safeWidth = normalizeDiffRenderWidth(width);
+	if (safeWidth === 0) {
+		return "";
+	}
+
+	const summaryCandidates = [
+		`↳ diff +${stats.added} -${stats.removed} • ${stats.hunks} ${pluralize(stats.hunks, "hunk")} • ${stats.files} ${pluralize(stats.files, "file")}`,
+		`↳ diff +${stats.added} -${stats.removed} • ${stats.hunks}h • ${stats.files}f`,
+		`↳ diff +${stats.added} -${stats.removed}`,
+		`+${stats.added} -${stats.removed}`,
+		"diff",
+		"…",
+	];
+
+	for (const candidate of summaryCandidates) {
+		if (visibleWidth(candidate) <= safeWidth) {
+			return candidate;
+		}
+	}
+
+	return truncateToWidth(summaryCandidates[summaryCandidates.length - 1] ?? "", safeWidth, "");
+}