@simon_he/vue-tui 0.0.8 → 1.0.0

package/dist/core.d.cts

@@ -0,0 +1,14 @@
+export { ansiStyles } from "./ansi-styles.js";
+export { ANSI8_COLORS, ANSI16_COLORS, ANSI256_COLORS, ansiColors, rgbToAnsi256, SGR_RESET, type TerminalColorLevel, type TerminalColorMode, truecolorBgOpen, truecolorFgOpen, } from "./ansi-styles.js";
+export { detectTerminalColorCapability, type TerminalColorCapability, } from "./core/ansi/capability.js";
+export type { ThemePalette } from "./core/ansi-palette.js";
+export { parseAnsiSgr } from "./core/ansi/sgr.js";
+export { charCellWidth } from "./core/buffer/width.js";
+export type { BuiltinWidthProvider, CellWidth, WidthProvider } from "./core/buffer/width.js";
+export { isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref, type SanitizeDomHrefOptions, type SanitizeTerminalHrefOptions, } from "./core/hyperlink.js";
+export { TERMINAL_RENDER_PLANES, type TerminalRenderPlane, type TerminalRenderPlanes, } from "./core/render-plane.js";
+export type { AnsiColorName, BufferSnapshot, Cell, Style, Terminal, TerminalCommitEvent, TerminalEventMap, TerminalOptions, TerminalResizeEvent, TerminalScrollOperation, ThemeModeId, } from "./core/index.js";
+export { createTerminal } from "./core/index.js";
+export type { FsDirEntry, FsEntryKind, FsStat, PathPickerProvider, } from "./core/path-provider-types.js";
+export { type PathPickMode, type PathSuggestion, parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths, type SuggestPathsResult, } from "./core/path-suggest.js";
+export { normalizeNewlines } from "./utils/newlines.js";

package/dist/core.d.ts

@@ -0,0 +1,14 @@
+export { ansiStyles } from "./ansi-styles.js";
+export { ANSI8_COLORS, ANSI16_COLORS, ANSI256_COLORS, ansiColors, rgbToAnsi256, SGR_RESET, type TerminalColorLevel, type TerminalColorMode, truecolorBgOpen, truecolorFgOpen, } from "./ansi-styles.js";
+export { detectTerminalColorCapability, type TerminalColorCapability, } from "./core/ansi/capability.js";
+export type { ThemePalette } from "./core/ansi-palette.js";
+export { parseAnsiSgr } from "./core/ansi/sgr.js";
+export { charCellWidth } from "./core/buffer/width.js";
+export type { BuiltinWidthProvider, CellWidth, WidthProvider } from "./core/buffer/width.js";
+export { isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref, type SanitizeDomHrefOptions, type SanitizeTerminalHrefOptions, } from "./core/hyperlink.js";
+export { TERMINAL_RENDER_PLANES, type TerminalRenderPlane, type TerminalRenderPlanes, } from "./core/render-plane.js";
+export type { AnsiColorName, BufferSnapshot, Cell, Style, Terminal, TerminalCommitEvent, TerminalEventMap, TerminalOptions, TerminalResizeEvent, TerminalScrollOperation, ThemeModeId, } from "./core/index.js";
+export { createTerminal } from "./core/index.js";
+export type { FsDirEntry, FsEntryKind, FsStat, PathPickerProvider, } from "./core/path-provider-types.js";
+export { type PathPickMode, type PathSuggestion, parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths, type SuggestPathsResult, } from "./core/path-suggest.js";
+export { normalizeNewlines } from "./utils/newlines.js";

package/dist/core.js

@@ -0,0 +1,424 @@
+import { TERMINAL_RENDER_PLANES, createTerminal } from "./create-terminal-C2oiWFJU.js";
+import { charCellWidth, isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-Bn02UXJb.js";
+import { parseAnsiSgr } from "./sgr-BmzxEjAO.js";
+import { ansiColorRgb } from "./ansi-palette-CNXqFciC.js";
+import { firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
+import { normalizeNewlines } from "./path-mnSgEpCm.js";
+import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-BNqcuE3-.js";
+
+//#region src/core/ansi/colors.ts
+const ANSI8_COLOR_NAMES = Object.freeze([
+	"black",
+	"red",
+	"green",
+	"yellow",
+	"blue",
+	"magenta",
+	"cyan",
+	"white"
+]);
+const ANSI16_COLOR_NAMES = Object.freeze([
+	"black",
+	"red",
+	"green",
+	"yellow",
+	"blue",
+	"magenta",
+	"cyan",
+	"white",
+	"blackBright",
+	"redBright",
+	"greenBright",
+	"yellowBright",
+	"blueBright",
+	"magentaBright",
+	"cyanBright",
+	"whiteBright"
+]);
+const ESC$1 = "\x1B[";
+const SGR_RESET = `${ESC$1}0m`;
+const SGR_BOLD = `${ESC$1}1m`;
+const SGR_DIM = `${ESC$1}2m`;
+const SGR_ITALIC = `${ESC$1}3m`;
+const SGR_UNDERLINE = `${ESC$1}4m`;
+const SGR_INVERSE = `${ESC$1}7m`;
+function toAnsi8ColorName(name) {
+	switch (name) {
+		case "black":
+		case "red":
+		case "green":
+		case "yellow":
+		case "blue":
+		case "magenta":
+		case "cyan":
+		case "white": return name;
+		case "blackBright": return "black";
+		case "redBright": return "red";
+		case "greenBright": return "green";
+		case "yellowBright": return "yellow";
+		case "blueBright": return "blue";
+		case "magentaBright": return "magenta";
+		case "cyanBright": return "cyan";
+		case "whiteBright": return "white";
+	}
+}
+const ANSI16_FG_CODE = Object.freeze({
+	black: 30,
+	red: 31,
+	green: 32,
+	yellow: 33,
+	blue: 34,
+	magenta: 35,
+	cyan: 36,
+	white: 37,
+	blackBright: 90,
+	redBright: 91,
+	greenBright: 92,
+	yellowBright: 93,
+	blueBright: 94,
+	magentaBright: 95,
+	cyanBright: 96,
+	whiteBright: 97
+});
+const ANSI16_BG_CODE = Object.freeze({
+	black: 40,
+	red: 41,
+	green: 42,
+	yellow: 43,
+	blue: 44,
+	magenta: 45,
+	cyan: 46,
+	white: 47,
+	blackBright: 100,
+	redBright: 101,
+	greenBright: 102,
+	yellowBright: 103,
+	blueBright: 104,
+	magentaBright: 105,
+	cyanBright: 106,
+	whiteBright: 107
+});
+function ansi8FgOpen(name) {
+	const base = toAnsi8ColorName(name);
+	const idx = ANSI8_COLOR_NAMES.indexOf(base);
+	return `${ESC$1}${30 + (idx < 0 ? 7 : idx)}m`;
+}
+function ansi8BgOpen(name) {
+	const base = toAnsi8ColorName(name);
+	const idx = ANSI8_COLOR_NAMES.indexOf(base);
+	return `${ESC$1}${40 + (idx < 0 ? 0 : idx)}m`;
+}
+function ansi16FgOpen(name) {
+	return `${ESC$1}${ANSI16_FG_CODE[name]}m`;
+}
+function ansi16BgOpen(name) {
+	return `${ESC$1}${ANSI16_BG_CODE[name]}m`;
+}
+function ansi256FgOpen(index) {
+	const n = clampAnsiIndex(index);
+	return `${ESC$1}38;5;${n}m`;
+}
+function ansi256BgOpen(index) {
+	const n = clampAnsiIndex(index);
+	return `${ESC$1}48;5;${n}m`;
+}
+function truecolorFgOpen(rgb) {
+	return `${ESC$1}38;2;${clampByte(rgb.r)};${clampByte(rgb.g)};${clampByte(rgb.b)}m`;
+}
+function truecolorBgOpen(rgb) {
+	return `${ESC$1}48;2;${clampByte(rgb.r)};${clampByte(rgb.g)};${clampByte(rgb.b)}m`;
+}
+function ansi256ToRgb(index) {
+	const n = clampAnsiIndex(index);
+	if (n < 16) {
+		const name = ANSI16_COLOR_NAMES[n] ?? "white";
+		return ansiColorRgb(name) ?? {
+			r: 255,
+			g: 255,
+			b: 255
+		};
+	}
+	if (n >= 232) {
+		const c = 8 + (n - 232) * 10;
+		return {
+			r: c,
+			g: c,
+			b: c
+		};
+	}
+	const i = n - 16;
+	const rr = Math.floor(i / 36);
+	const gg = Math.floor(i % 36 / 6);
+	const bb = i % 6;
+	const levels = [
+		0,
+		95,
+		135,
+		175,
+		215,
+		255
+	];
+	return {
+		r: levels[rr],
+		g: levels[gg],
+		b: levels[bb]
+	};
+}
+function rgbToAnsi256(rgb) {
+	const r = clampByte(rgb.r);
+	const g = clampByte(rgb.g);
+	const b = clampByte(rgb.b);
+	const levels = [
+		0,
+		95,
+		135,
+		175,
+		215,
+		255
+	];
+	const nearestLevelIndex = (v) => {
+		let best = 0;
+		let bestDist = Number.POSITIVE_INFINITY;
+		for (let i = 0; i < levels.length; i++) {
+			const d = (v - levels[i]) ** 2;
+			if (d < bestDist) {
+				bestDist = d;
+				best = i;
+			}
+		}
+		return best;
+	};
+	const ri = nearestLevelIndex(r);
+	const gi = nearestLevelIndex(g);
+	const bi = nearestLevelIndex(b);
+	const cubeIndex = 16 + 36 * ri + 6 * gi + bi;
+	const cube = ansi256ToRgb(cubeIndex);
+	const cubeDist = (r - cube.r) ** 2 + (g - cube.g) ** 2 + (b - cube.b) ** 2;
+	const gray = Math.round((r + g + b) / 3);
+	const grayIndex = gray < 8 ? 16 : gray > 248 ? 231 : 232 + Math.round((gray - 8) / 10);
+	const grayRgb = ansi256ToRgb(grayIndex);
+	const grayDist = (r - grayRgb.r) ** 2 + (g - grayRgb.g) ** 2 + (b - grayRgb.b) ** 2;
+	return grayDist < cubeDist ? grayIndex : cubeIndex;
+}
+function ansi8Palette() {
+	return ANSI8_COLOR_NAMES.map((name, index) => {
+		const rgb = ansiColorRgb(name) ?? {
+			r: 255,
+			g: 255,
+			b: 255
+		};
+		return Object.freeze({
+			level: 8,
+			index,
+			name,
+			rgb,
+			fgOpen: ansi8FgOpen(name),
+			bgOpen: ansi8BgOpen(name)
+		});
+	});
+}
+function ansi16Palette() {
+	return ANSI16_COLOR_NAMES.map((name, index) => {
+		const rgb = ansiColorRgb(name) ?? {
+			r: 255,
+			g: 255,
+			b: 255
+		};
+		return Object.freeze({
+			level: 16,
+			index,
+			name,
+			rgb,
+			fgOpen: ansi16FgOpen(name),
+			bgOpen: ansi16BgOpen(name)
+		});
+	});
+}
+function ansi256Palette() {
+	const out = [];
+	for (let index = 0; index < 256; index++) out.push(Object.freeze({
+		level: 256,
+		index,
+		rgb: ansi256ToRgb(index),
+		fgOpen: ansi256FgOpen(index),
+		bgOpen: ansi256BgOpen(index)
+	}));
+	return Object.freeze(out);
+}
+function clampAnsiIndex(n) {
+	if (!Number.isFinite(n)) return 0;
+	return Math.max(0, Math.min(255, Math.trunc(n)));
+}
+function clampByte(n) {
+	if (!Number.isFinite(n)) return 0;
+	return Math.max(0, Math.min(255, Math.round(n)));
+}
+
+//#endregion
+//#region src/ansi-styles.ts
+const ESC = "\x1B[";
+function createStyle(open, close) {
+	return Object.freeze({
+		open,
+		close
+	});
+}
+const ansiStyles = Object.freeze({
+	reset: createStyle(SGR_RESET, SGR_RESET),
+	bold: createStyle(SGR_BOLD, `${ESC}22m`),
+	dim: createStyle(SGR_DIM, `${ESC}22m`),
+	italic: createStyle(SGR_ITALIC, `${ESC}23m`),
+	underline: createStyle(SGR_UNDERLINE, `${ESC}24m`),
+	inverse: createStyle(SGR_INVERSE, `${ESC}27m`),
+	black: createStyle(ansi16FgOpen("black"), `${ESC}39m`),
+	red: createStyle(ansi16FgOpen("red"), `${ESC}39m`),
+	green: createStyle(ansi16FgOpen("green"), `${ESC}39m`),
+	yellow: createStyle(ansi16FgOpen("yellow"), `${ESC}39m`),
+	blue: createStyle(ansi16FgOpen("blue"), `${ESC}39m`),
+	magenta: createStyle(ansi16FgOpen("magenta"), `${ESC}39m`),
+	cyan: createStyle(ansi16FgOpen("cyan"), `${ESC}39m`),
+	white: createStyle(ansi16FgOpen("white"), `${ESC}39m`),
+	blackBright: createStyle(ansi16FgOpen("blackBright"), `${ESC}39m`),
+	redBright: createStyle(ansi16FgOpen("redBright"), `${ESC}39m`),
+	greenBright: createStyle(ansi16FgOpen("greenBright"), `${ESC}39m`),
+	yellowBright: createStyle(ansi16FgOpen("yellowBright"), `${ESC}39m`),
+	blueBright: createStyle(ansi16FgOpen("blueBright"), `${ESC}39m`),
+	magentaBright: createStyle(ansi16FgOpen("magentaBright"), `${ESC}39m`),
+	cyanBright: createStyle(ansi16FgOpen("cyanBright"), `${ESC}39m`),
+	whiteBright: createStyle(ansi16FgOpen("whiteBright"), `${ESC}39m`),
+	bgBlack: createStyle(ansi16BgOpen("black"), `${ESC}49m`),
+	bgRed: createStyle(ansi16BgOpen("red"), `${ESC}49m`),
+	bgGreen: createStyle(ansi16BgOpen("green"), `${ESC}49m`),
+	bgYellow: createStyle(ansi16BgOpen("yellow"), `${ESC}49m`),
+	bgBlue: createStyle(ansi16BgOpen("blue"), `${ESC}49m`),
+	bgMagenta: createStyle(ansi16BgOpen("magenta"), `${ESC}49m`),
+	bgCyan: createStyle(ansi16BgOpen("cyan"), `${ESC}49m`),
+	bgWhite: createStyle(ansi16BgOpen("white"), `${ESC}49m`),
+	bgBlackBright: createStyle(ansi16BgOpen("blackBright"), `${ESC}49m`),
+	bgRedBright: createStyle(ansi16BgOpen("redBright"), `${ESC}49m`),
+	bgGreenBright: createStyle(ansi16BgOpen("greenBright"), `${ESC}49m`),
+	bgYellowBright: createStyle(ansi16BgOpen("yellowBright"), `${ESC}49m`),
+	bgBlueBright: createStyle(ansi16BgOpen("blueBright"), `${ESC}49m`),
+	bgMagentaBright: createStyle(ansi16BgOpen("magentaBright"), `${ESC}49m`),
+	bgCyanBright: createStyle(ansi16BgOpen("cyanBright"), `${ESC}49m`),
+	bgWhiteBright: createStyle(ansi16BgOpen("whiteBright"), `${ESC}49m`),
+	color: Object.freeze({
+		ansi256: (idx) => ansi256FgOpen(idx),
+		ansi16m: (r, g, b) => truecolorFgOpen({
+			r,
+			g,
+			b
+		})
+	}),
+	bgColor: Object.freeze({
+		ansi256: (idx) => ansi256BgOpen(idx),
+		ansi16m: (r, g, b) => truecolorBgOpen({
+			r,
+			g,
+			b
+		})
+	})
+});
+/**
+* Cached palettes for convenience.
+* Note: ANSI 0..15 are terminal-theme-dependent in many terminals; treat `rgb` as an approximation.
+*/
+const ANSI8_COLORS = ansi8Palette();
+const ANSI16_COLORS = ansi16Palette();
+const ANSI256_COLORS = ansi256Palette();
+function ansiColors(level) {
+	if (level === 8) return ANSI8_COLORS;
+	if (level === 16) return ANSI16_COLORS;
+	return ANSI256_COLORS;
+}
+
+//#endregion
+//#region src/core/ansi/capability.ts
+function parseColorMode(raw) {
+	const v = String(raw ?? "").trim().toLowerCase();
+	if (!v) return null;
+	if (v === "truecolor" || v === "24bit" || v === "rgb") return "truecolor";
+	if (v === "ansi256" || v === "256" || v === "xterm256" || v === "xterm-256color") return "ansi256";
+	if (v === "ansi16" || v === "16") return "ansi16";
+	if (v === "ansi8" || v === "8") return "ansi8";
+	return null;
+}
+function levelForMode(mode) {
+	if (mode === "ansi8") return 8;
+	if (mode === "ansi16") return 16;
+	return 256;
+}
+/**
+* Detect terminal output color capability.
+*
+* - `mode` is the best-effort actual output mode.
+* - `level` is the CLI theme tier (256/16/8). `truecolor` folds into `256`.
+* - Pass `platform` (e.g. `process.platform`) to improve Windows detection.
+*
+* Env overrides:
+* - `VUE_TUI_COLOR_MODE` / legacy `DIMCODE_COLOR_MODE`
+*/
+function detectTerminalColorCapability(opts) {
+	const env = opts?.env ?? {};
+	const isTTY = opts?.isTTY ?? false;
+	const platform = String(opts?.platform ?? "").trim().toLowerCase();
+	const isWindows = platform === "win32" || String(env.OS ?? "").trim().toLowerCase() === "windows_nt";
+	const forced = parseColorMode(firstNonEmptyEnv(env, "VUE_TUI_COLOR_MODE", "DIMCODE_COLOR_MODE"));
+	if (forced) return {
+		mode: forced,
+		level: levelForMode(forced)
+	};
+	if (!isTTY) return {
+		mode: "truecolor",
+		level: 256
+	};
+	const termProgram = String(env.TERM_PROGRAM ?? "").toLowerCase();
+	const isAppleTerminal = termProgram.includes("apple_terminal");
+	const colorterm = String(env.COLORTERM ?? "").toLowerCase();
+	if (!isAppleTerminal && (colorterm.includes("truecolor") || colorterm.includes("24bit"))) return {
+		mode: "truecolor",
+		level: 256
+	};
+	if (termProgram.includes("vscode")) return {
+		mode: "truecolor",
+		level: 256
+	};
+	if (termProgram.includes("wezterm") || termProgram.includes("alacritty") || termProgram.includes("ghostty") || termProgram.includes("kitty") || termProgram.includes("iterm") || termProgram.includes("windows terminal") || termProgram.includes("windowsterminal") || termProgram.includes("tabby") || termProgram.includes("hyper") || termProgram.includes("rio") || termProgram.includes("contour")) return {
+		mode: "truecolor",
+		level: 256
+	};
+	const term = String(env.TERM ?? "").toLowerCase();
+	if (isWindows) {
+		const hasWindowsTerminal = "WT_SESSION" in env || "WT_PROFILE_ID" in env || "WT_ID" in env;
+		const hasWezterm = "WEZTERM_EXECUTABLE" in env || "WEZTERM_PANE" in env;
+		const hasAlacritty = "ALACRITTY_LOG" in env || "ALACRITTY_WINDOW_ID" in env;
+		const hasTabby = "TABBY_CONFIG_DIRECTORY" in env;
+		if (hasWindowsTerminal || hasWezterm || hasAlacritty || hasTabby) return {
+			mode: "truecolor",
+			level: 256
+		};
+		if (term.includes("xterm") && term.includes("256color")) return {
+			mode: "truecolor",
+			level: 256
+		};
+	}
+	if (term.includes("256color")) return {
+		mode: "ansi256",
+		level: 256
+	};
+	if (term.includes("color")) return {
+		mode: "ansi16",
+		level: 16
+	};
+	if (term.includes("dumb")) return {
+		mode: "ansi8",
+		level: 8
+	};
+	return {
+		mode: "ansi16",
+		level: 16
+	};
+}
+
+//#endregion
+export { ANSI16_COLORS, ANSI256_COLORS, ANSI8_COLORS, SGR_RESET, TERMINAL_RENDER_PLANES, ansiColors, ansiStyles, charCellWidth, createTerminal, detectTerminalColorCapability, isSafeRelativeHref, normalizeNewlines, parseAnsiSgr, parsePathQuery, resolveUserPath, rgbToAnsi256, sanitizeDomHref, sanitizeTerminalHref, suggestParentHint, suggestPaths, truecolorBgOpen, truecolorFgOpen };