@simon_he/vue-tui 1.0.2 → 1.1.0

package/dist/core.js

@@ -1,10 +1,9 @@
-import { TERMINAL_RENDER_PLANES, createTerminal } from "./create-terminal-DBFNYr8f.js";
-import { charCellWidth, isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-Bn02UXJb.js";
-import { parseAnsiSgr } from "./sgr-BmzxEjAO.js";
-import { ansiColorRgb } from "./ansi-palette-CNXqFciC.js";
+import { TERMINAL_RENDER_PLANES, createTerminal, isSafeRelativeHref, parseAnsiSgr, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-_1FAj7Wq.js";
+import { charCellWidth } from "./width-GqllnV8C.js";
+import { ansiColorRgb } from "./ansi-palette-CH6jc2Z7.js";
 import { firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
 import { normalizeNewlines } from "./path-mnSgEpCm.js";
-import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-BNqcuE3-.js";
+import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-Dndu4dTi.js";
 
 //#region src/core/ansi/colors.ts
 const ANSI8_COLOR_NAMES = Object.freeze([

package/dist/create-terminal-app.d.ts

@@ -5,15 +5,38 @@ import type { Style, Terminal } from "./core/types.js";
 import type { CliEventManager } from "./events/index.js";
 import type { ClipboardApi } from "./runtime/index.js";
 import type { TerminalLinkOpenerLike } from "./vue/components/link/host.js";
-import type { TerminalSelectionConfig, TerminalSelectionCopyPayload } from "./selection/terminal-selection.js";
+import type { SelectionTextProvider, TerminalSelectionConfig, TerminalSelectionCopyPayload, TerminalSelectionRefreshOptions } from "./selection/terminal-selection.js";
 import type { TInputPlugin } from "./vue/components/input/plugins/types.js";
 import type { ImeAnchor, TerminalScheduler } from "./vue/context.js";
+export type TerminalSelectionContext = Readonly<{
+    registerTextProvider(provider: SelectionTextProvider): () => void;
+    onCopy(handler: (payload: TerminalSelectionCopyPayload) => void): () => void;
+    refresh(options?: TerminalSelectionRefreshOptions): void;
+    clear(): void;
+    /**
+     * Update the selection copy strategy at runtime. Only `autoCopy`,
+     * `copyOnMouseUp`, and `style` take effect dynamically — `enabled` is
+     * resolved at app creation time (it gates overlay node registration and
+     * the pointer-event selection path) and cannot be toggled afterwards.
+     * Triggers a refresh so the new options apply immediately.
+     *
+     * This does NOT toggle mouse capture — that is owned by the stdin driver
+     * layer. To let the terminal perform native selection, disable mouse
+     * capture at stdin-driver startup time, or rely on the terminal's
+     * Shift+drag escape hatch.
+     */
+    setConfig(config: TerminalSelectionConfig): void;
+}>;
 export type TerminalApp = Readonly<{
     app: App;
     terminal: Terminal;
     events: CliEventManager;
     scheduler: TerminalScheduler;
     defaultStyle: Ref<Style>;
+    /** The active clipboard instance used by selection copy and exposed for upper-layer copy actions. */
+    clipboard: ClipboardApi;
+    /** Selection controller surface: register text providers, observe copy events, refresh/clear. */
+    selection: TerminalSelectionContext;
     /** Returns the current IME anchor position (cursor position in cell coordinates), or null if no input is focused */
     getImeAnchor: () => ImeAnchor | null;
     mount: () => void;

package/dist/debug-logger-CmsGI4of.js

@@ -0,0 +1,74 @@
+import { envFlag, envString } from "./env-Cl8qmNFN.js";
+
+//#region src/core/debug-logger.ts
+const DEFAULT_LOG_FILE = "vue-tui-debug.log";
+let debugFileWriter = null;
+let debugLogDefaultPath = DEFAULT_LOG_FILE;
+const initializedDebugLogPaths = new Set();
+function getFileWriter() {
+	const writer = globalThis.__VT_DEBUG_FILE_WRITER__;
+	if (writer && typeof writer === "object") return writer;
+	return debugFileWriter;
+}
+function resolveDebugLogPath(env, fallback = DEFAULT_LOG_FILE) {
+	return envString(env, "VUE_TUI_DEBUG_LOG_PATH", "DIMCODE_DEBUG_LOG_PATH", fallback);
+}
+function debugLogPath() {
+	const env = globalThis.process?.env;
+	return resolveDebugLogPath(env, debugLogDefaultPath);
+}
+function safeJson(value) {
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return "[unserializable]";
+	}
+}
+function createDebugLogger(enable = false) {
+	const enabled = enable;
+	const ensureHeader = () => {
+		if (!enabled) return;
+		const writer = getFileWriter();
+		if (!writer?.writeFileSync) return;
+		const path = debugLogPath();
+		if (initializedDebugLogPaths.has(path)) return;
+		try {
+			const data = `=== Vue TUI Debug Log Started at ${new Date().toISOString()} ===\n\n`;
+			writer.writeFileSync(path, data);
+			initializedDebugLogPaths.add(path);
+		} catch {}
+	};
+	const write = (data) => {
+		if (!enabled) return;
+		ensureHeader();
+		try {
+			getFileWriter()?.appendFileSync?.(debugLogPath(), data);
+		} catch {}
+	};
+	const log = (category, message) => {
+		if (!enabled) return;
+		const timestamp = new Date().toISOString().split("T")[1].slice(0, -1);
+		write(`[${timestamp}] ${category} ${message}\n`);
+	};
+	ensureHeader();
+	return {
+		render: (message) => log("[RENDER]", message),
+		stream: (message) => log("[STREAM]", message),
+		error: (message, ...args) => {
+			if (!enabled) return;
+			const timestamp = new Date().toISOString().split("T")[1].slice(0, -1);
+			const fullMessage = `[${timestamp}] [ERROR] ${message}${args.length ? ` ${safeJson(args)}` : ""}`;
+			write(`${fullMessage}\n`);
+		}
+	};
+}
+/**
+* Check if debug logging is enabled via environment variable
+*/
+function isDebugEnabled() {
+	const env = globalThis.process?.env;
+	return envFlag(env, "VUE_TUI_DEBUG", "DIMCODE_DEBUG") || env?.DEBUG === "1";
+}
+
+//#endregion
+export { createDebugLogger, isDebugEnabled };

package/dist/{dom-renderer-BniJSQyX.js → dom-renderer-DXx8fWzD.js}

@@ -1,6 +1,5 @@
-import { TERMINAL_RENDER_PLANES, getPlaneTerminal } from "./create-terminal-DBFNYr8f.js";
-import { sanitizeDomHref } from "./hyperlink-Bn02UXJb.js";
-import { ansiColorHex, ansiCssVar, installAnsiPaletteCssVars, isAnsiColorName } from "./ansi-palette-CNXqFciC.js";
+import { TERMINAL_RENDER_PLANES, getPlaneTerminal, sanitizeDomHref } from "./hyperlink-_1FAj7Wq.js";
+import { ansiColorHex, ansiCssVar, installAnsiPaletteCssVars, isAnsiColorName } from "./ansi-palette-CH6jc2Z7.js";
 
 //#region src/renderer/capabilities.ts
 const DOM_RENDERER_CAPABILITIES = Object.freeze({

package/dist/experimental/3d/bun/contributor-avatar-atlas.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fixed, offline 32px avatar atlas for the top 100 human Vue core contributors.
+ * Ordered by the GitHub contributors API response after filtering bot accounts.
+ * Source: https://github.com/vuejs/core/graphs/contributors
+ * Avatars: https://avatars.githubusercontent.com (retrieved 2026-07-24).
+ */
+export declare const contributorAvatarLogins: readonly ["yyx990803", "edison1105", "sxzz", "HcySunYang", "pikax", "underfin", "Alfred-Skyblue", "jh-leong", "cexbrayat", "LinusBorg", "skirtles-code", "baiwusanyu-c", "dsseng", "haoqunjiang", "KazariEX", "linzhe141", "posva", "yangmingshan", "btea", "yangxiuxiu1115", "Akryum", "webfansplz", "zhangenming", "zhangzhonghe", "johnsoncodehk", "antfu", "a631807682", "jiangying000", "liulinboyi", "Doctor-wu", "ygj6", "unbyte", "himself65", "shengxinjing", "fisker", "danielroe", "CyberAP", "loiacon", "HerringtonDarkholme", "znck", "caozhong1996", "OnlyWick", "Picknight", "hareku", "zh-lx", "CodinCat", "godxiaoji", "lidlanca", "meteorlxy", "rudyxu1102", "wsypower", "basvanmeurs", "liuseen-l", "alex-snezhko", "fnlctrl", "CodeDaraW", "rzzf", "ztplz", "zqran", "Bigfish8", "Mini-ghost", "zzzzzhowie", "Amour1688", "zhiyuanzmj", "ysj16", "TerenceZ", "shadowings-zy", "inottn", "Rudeus3Greyrat", "KaelWD", "theniceangel", "JayFate", "xanf", "Justineo", "zhmushan", "susiwen8", "jods4", "ifer47", "chenfan0", "Zardddddd60", "jo0ger", "dsonet", "69hunter", "DV8FromTheWorld", "AjaiKN", "nandi95", "PengBoUESTC", "Notryag", "wonderful-panda", "wxsms", "yyyanghj", "javastation", "dlxqlig", "leaon4", "LongTengDao", "iiio2", "serkodev", "cuixiaorui", "sudongyuer", "hyfdev"];
+export declare const contributorAvatarAtlas: {
+    readonly width: 512;
+    readonly height: 224;
+    readonly rgba: Uint8Array<ArrayBufferLike>;
+};

package/dist/experimental/3d/bun/png.d.ts

@@ -0,0 +1 @@
+export declare function encodeRgbaPng(rgba: Uint8Array, width: number, height: number): Uint8Array;

package/dist/experimental/3d/bun/terminal-badge-scene.d.ts

@@ -0,0 +1,11 @@
+import type { T3DHitResult, T3DHitTestContext } from "../../../vue/components/T3DViewport.js";
+export declare const TERMINAL_BADGE_CONTRIBUTOR_COUNT = 100;
+export declare const terminalBadgeContributorRadiusScales: readonly number[];
+export type TerminalBadgeContributorSphere = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+    radius: number;
+}>;
+export declare const terminalBadgeContributorSpheres: readonly TerminalBadgeContributorSphere[];
+export declare function pickTerminalBadgeContributor(context: T3DHitTestContext): T3DHitResult | null;

package/dist/experimental/3d/bun/terminal-badge.wgsl.d.ts

@@ -0,0 +1 @@
+export declare const terminalBadge3DWgsl: string;

package/dist/experimental/3d/bun/webgpu-renderer.d.ts

@@ -0,0 +1,26 @@
+import type { T3DRenderer } from "../../../vue/components/T3DViewport.js";
+export type BunWebGPUTextureData = Readonly<{
+    /** Texture width in pixels. */
+    width: number;
+    /** Texture height in pixels. */
+    height: number;
+    /** Tightly packed RGBA8 pixels, ordered from top-left to bottom-right. */
+    rgba: Uint8Array;
+}>;
+export type BunWebGPU3DRendererOptions = Readonly<{
+    /** Compute shader with the T3D uniform block at binding 0 and RGBA8 storage output at binding 1. */
+    shader: string;
+    /** Optional RGBA8 sampled texture exposed to the shader at binding 2. */
+    texture?: BunWebGPUTextureData;
+    /** Label included in WebGPU resources and error messages. */
+    label?: string;
+}>;
+export type TerminalBadge3DRendererOptions = Readonly<{
+    /** Label included in WebGPU resources and error messages. */
+    label?: string;
+}>;
+export declare function rgbaToGray8(rgba: Uint8Array): Uint8Array;
+/** Creates a Bun-only Pull renderer backed by a raw WGSL compute shader. */
+export declare function createBunWebGPU3DRenderer(options: BunWebGPU3DRendererOptions): T3DRenderer;
+/** Creates the direction-E vue-tui terminal badge renderer. */
+export declare function createTerminalBadge3DRenderer(options?: TerminalBadge3DRendererOptions): T3DRenderer;