@simon_he/vue-tui 0.0.8 → 1.0.0

package/dist/env-Cl8qmNFN.js

@@ -0,0 +1,19 @@
+//#region src/utils/env.ts
+function firstNonEmptyEnv(env, primary, legacy) {
+	const primaryValue = env?.[primary];
+	if (String(primaryValue ?? "").trim() !== "") return primaryValue;
+	if (!legacy) return void 0;
+	const legacyValue = env?.[legacy];
+	if (String(legacyValue ?? "").trim() !== "") return legacyValue;
+	return void 0;
+}
+function envFlag(env, primary, legacy) {
+	const raw = String(firstNonEmptyEnv(env, primary, legacy) ?? "").trim().toLowerCase();
+	return raw === "1" || raw === "true" || raw === "yes" || raw === "on";
+}
+function envString(env, primary, legacy, fallback = "") {
+	return String(firstNonEmptyEnv(env, primary, legacy) ?? fallback).trim() || fallback;
+}
+
+//#endregion
+export { envFlag, envString, firstNonEmptyEnv };

package/dist/events/index.d.ts

@@ -0,0 +1,6 @@
+export type { CliEventManager } from "./manager/cli-event-manager.js";
+export { createCliEventManager } from "./manager/cli-event-manager.js";
+export type { EventManager } from "./manager/event-manager.js";
+export { createEventManager } from "./manager/event-manager.js";
+export type { Rect, TerminalBaseEvent, TerminalDebugNode, TerminalEventHandlerMap, TerminalEventType, TerminalInputEvent, TerminalKeyboardEvent, TerminalNode, TerminalPointerEvent, } from "./manager/types.js";
+export type { TerminalEventRecord } from "./recording.js";

package/dist/events/manager/cli-event-manager.d.ts

@@ -0,0 +1,22 @@
+import type { CellMetrics } from "../../renderer/dom/dom-renderer.js";
+import type { TerminalEventRecord } from "../recording.js";
+import type { TerminalDebugNode, TerminalNode } from "./types.js";
+export interface CliEventManager {
+    register: (node: Omit<TerminalNode, "id"> & {
+        id?: string;
+    }) => TerminalNode;
+    update: (id: string, next: Partial<Omit<TerminalNode, "id">>) => void;
+    unregister: (id: string) => void;
+    setMetrics: (next: CellMetrics) => void;
+    canSelectAt: (cellX: number, cellY: number) => boolean;
+    autoScrollSelectionAt: (originCellX: number, originCellY: number, pointerCellY: number) => number;
+    focus: (id: string | null) => void;
+    getFocused: () => string | null;
+    dispatch: (event: TerminalEventRecord) => boolean;
+    debugNodes: () => TerminalDebugNode[];
+    dispose: () => void;
+}
+export declare function createCliEventManager(options?: Readonly<{
+    record?: (event: TerminalEventRecord) => void;
+    onFocusChange?: (prev: string | null, next: string | null) => void;
+}>): CliEventManager;

package/dist/events/manager/event-manager.d.ts

@@ -0,0 +1,30 @@
+import type { CellMetrics } from "../../renderer/dom/dom-renderer.js";
+import type { TerminalEventRecord } from "../recording.js";
+import type { TerminalDebugNode, TerminalNode } from "./types.js";
+export interface EventManager {
+    register: (node: Omit<TerminalNode, "id"> & {
+        id?: string;
+    }) => TerminalNode;
+    update: (id: string, next: Partial<Omit<TerminalNode, "id">>) => void;
+    unregister: (id: string) => void;
+    setMetrics: (next: CellMetrics) => void;
+    canSelectAt: (cellX: number, cellY: number) => boolean;
+    autoScrollSelectionAt: (originCellX: number, originCellY: number, pointerCellY: number) => number;
+    focus: (id: string | null) => void;
+    getFocused: () => string | null;
+    debugNodes: () => TerminalDebugNode[];
+    attach: () => void;
+    dispose: () => void;
+}
+export declare function createEventManager(container: HTMLElement, metrics: CellMetrics, options?: Readonly<{
+    record?: (event: TerminalEventRecord) => void;
+    textInputTarget?: HTMLElement | null;
+    debugIme?: boolean;
+    onFocusChange?: (prev: string | null, next: string | null) => void;
+    /**
+     * When true, native DOM listeners are not attached until manager.attach()
+     * is called explicitly. Used by TerminalProvider so selection capture
+     * listeners can be registered first.
+     */
+    deferAttach?: boolean;
+}>): EventManager;

package/dist/events/manager/selection-suppression.d.ts

@@ -0,0 +1,3 @@
+export declare const SUPPRESS_TERMINAL_POINTER_UP = "__vueTuiSuppressTerminalPointerUp";
+export declare const SUPPRESS_TERMINAL_POINTER_DOWN = "__vueTuiSuppressTerminalPointerDown";
+export declare const SUPPRESS_TERMINAL_POINTER_MOVE = "__vueTuiSuppressTerminalPointerMove";

package/dist/events/manager/types.d.ts

@@ -0,0 +1,108 @@
+export type Rect = Readonly<{
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+export type TerminalEventType = "click" | "dblclick" | "contextmenu" | "pointerdown" | "pointerup" | "pointermove" | "pointerenter" | "pointerleave" | "wheel" | "keydown" | "keyup" | "beforeinput" | "input" | "compositionstart" | "compositionupdate" | "compositionend" | "paste" | "focus" | "blur";
+export interface TerminalBaseEvent {
+    type: TerminalEventType;
+    target: TerminalNode | null;
+    currentTarget: TerminalNode | null;
+    eventPhase: 1 | 2 | 3;
+    bubbles: boolean;
+    cancelable: boolean;
+    defaultPrevented: boolean;
+    timeStamp: number;
+    stopPropagation: () => void;
+    preventDefault: () => void;
+    composedPath: () => TerminalNode[];
+    nativeEvent?: Event;
+}
+export type TerminalPointerEvent = TerminalBaseEvent & {
+    clientX: number;
+    clientY: number;
+    cellX: number;
+    cellY: number;
+    button?: number;
+    buttons?: number;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    deltaY?: number;
+    deltaMode?: number;
+};
+export type TerminalKeyboardEvent = TerminalBaseEvent & {
+    key: string;
+    code: string;
+    combo: string;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    repeat?: boolean;
+};
+export type TerminalInputEvent = TerminalBaseEvent & {
+    inputType?: string;
+    data?: string;
+    isComposing?: boolean;
+    text?: string;
+};
+export type TerminalEventHandlerMap = Partial<{
+    clickCapture: (e: TerminalPointerEvent) => void;
+    click: (e: TerminalPointerEvent) => void;
+    dblclickCapture: (e: TerminalPointerEvent) => void;
+    dblclick: (e: TerminalPointerEvent) => void;
+    contextmenuCapture: (e: TerminalPointerEvent) => void;
+    contextmenu: (e: TerminalPointerEvent) => void;
+    pointerdownCapture: (e: TerminalPointerEvent) => void;
+    pointerdown: (e: TerminalPointerEvent) => void;
+    pointerupCapture: (e: TerminalPointerEvent) => void;
+    pointerup: (e: TerminalPointerEvent) => void;
+    pointermoveCapture: (e: TerminalPointerEvent) => void;
+    pointermove: (e: TerminalPointerEvent) => void;
+    pointerenterCapture: (e: TerminalPointerEvent) => void;
+    pointerenter: (e: TerminalPointerEvent) => void;
+    pointerleaveCapture: (e: TerminalPointerEvent) => void;
+    pointerleave: (e: TerminalPointerEvent) => void;
+    wheelCapture: (e: TerminalPointerEvent) => void;
+    wheel: (e: TerminalPointerEvent) => void;
+    keydownCapture: (e: TerminalKeyboardEvent) => void;
+    keydown: (e: TerminalKeyboardEvent) => void;
+    keyupCapture: (e: TerminalKeyboardEvent) => void;
+    keyup: (e: TerminalKeyboardEvent) => void;
+    beforeinputCapture: (e: TerminalInputEvent) => void;
+    beforeinput: (e: TerminalInputEvent) => void;
+    inputCapture: (e: TerminalInputEvent) => void;
+    input: (e: TerminalInputEvent) => void;
+    compositionstartCapture: (e: TerminalInputEvent) => void;
+    compositionstart: (e: TerminalInputEvent) => void;
+    compositionupdateCapture: (e: TerminalInputEvent) => void;
+    compositionupdate: (e: TerminalInputEvent) => void;
+    compositionendCapture: (e: TerminalInputEvent) => void;
+    compositionend: (e: TerminalInputEvent) => void;
+    pasteCapture: (e: TerminalInputEvent) => void;
+    paste: (e: TerminalInputEvent) => void;
+    focusCapture: (e: TerminalBaseEvent) => void;
+    focus: (e: TerminalBaseEvent) => void;
+    blurCapture: (e: TerminalBaseEvent) => void;
+    blur: (e: TerminalBaseEvent) => void;
+}>;
+export interface TerminalNode {
+    id: string;
+    rect: Rect;
+    zIndex: number;
+    visible?: boolean;
+    focusable?: boolean;
+    selectable?: boolean;
+    selectionScrollBy?: (deltaRows: number) => boolean | void;
+    handlers: TerminalEventHandlerMap;
+}
+export type TerminalDebugNode = Readonly<{
+    id: string;
+    rect: Rect;
+    zIndex: number;
+    visible: boolean;
+    focusable: boolean;
+}>;

package/dist/events/recording.d.ts

@@ -0,0 +1,44 @@
+export type TerminalEventRecord = Readonly<{
+    type: "keydown" | "keyup";
+    key: string;
+    code?: string;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    repeat?: boolean;
+    time?: number;
+}> | Readonly<{
+    type: "pointerdown" | "pointerup" | "pointermove" | "click" | "dblclick" | "contextmenu";
+    cellX: number;
+    cellY: number;
+    clientX?: number;
+    clientY?: number;
+    button?: number;
+    buttons?: number;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    time?: number;
+}> | Readonly<{
+    type: "wheel";
+    cellX: number;
+    cellY: number;
+    clientX?: number;
+    clientY?: number;
+    deltaY: number;
+    deltaMode?: number;
+    ctrlKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    metaKey?: boolean;
+    time?: number;
+}> | Readonly<{
+    type: "beforeinput" | "input" | "compositionstart" | "compositionupdate" | "compositionend" | "paste";
+    data?: string;
+    inputType?: string;
+    isComposing?: boolean;
+    text?: string;
+    time?: number;
+}>;