@next_term/web 0.1.0-next.0

package/dist/addons/web-links.js

@@ -0,0 +1,170 @@
+// ---------------------------------------------------------------------------
+// URL detection
+// ---------------------------------------------------------------------------
+/**
+ * Regex pattern for detecting URLs in terminal text.
+ * Matches http:// and https:// URLs.
+ */
+const URL_REGEX = /https?:\/\/[^\s<>"{}|\\^`[\]]+/g;
+/**
+ * Extract the text content of a single row from a CellGrid.
+ */
+function extractRowText(grid, row) {
+    let line = "";
+    for (let col = 0; col < grid.cols; col++) {
+        const cp = grid.getCodepoint(row, col);
+        line += cp > 0x20 ? String.fromCodePoint(cp) : " ";
+    }
+    return line;
+}
+/**
+ * Find all URLs in the visible rows of a grid.
+ */
+export function findLinks(grid) {
+    const links = [];
+    for (let row = 0; row < grid.rows; row++) {
+        const text = extractRowText(grid, row);
+        URL_REGEX.lastIndex = 0;
+        let m;
+        while (true) {
+            m = URL_REGEX.exec(text);
+            if (m === null)
+                break;
+            // Trim trailing punctuation that is likely not part of the URL
+            let url = m[0];
+            while (url.length > 0 && /[.,;:!?)']$/.test(url)) {
+                url = url.slice(0, -1);
+            }
+            if (url.length === 0)
+                continue;
+            links.push({
+                row,
+                startCol: m.index,
+                endCol: m.index + url.length - 1,
+                url,
+            });
+        }
+    }
+    return links;
+}
+// ---------------------------------------------------------------------------
+// WebLinksAddon
+// ---------------------------------------------------------------------------
+export class WebLinksAddon {
+    terminal = null;
+    handler;
+    links = [];
+    currentHoverLink = null;
+    mouseMoveHandler = null;
+    clickHandler = null;
+    constructor(handler) {
+        this.handler =
+            handler ??
+                ((url) => {
+                    if (typeof window !== "undefined") {
+                        if (!url.startsWith("http://") && !url.startsWith("https://"))
+                            return;
+                        window.open(url, "_blank", "noopener,noreferrer");
+                    }
+                });
+    }
+    activate(terminal) {
+        this.terminal = terminal;
+        // Listen for mouse events on the terminal's container
+        const container = terminal.element;
+        if (!container)
+            return;
+        this.mouseMoveHandler = (e) => this.onMouseMove(e);
+        this.clickHandler = (e) => this.onClick(e);
+        container.addEventListener("mousemove", this.mouseMoveHandler);
+        container.addEventListener("click", this.clickHandler);
+    }
+    dispose() {
+        if (this.terminal) {
+            const container = this.terminal.element;
+            if (container) {
+                if (this.mouseMoveHandler) {
+                    container.removeEventListener("mousemove", this.mouseMoveHandler);
+                }
+                if (this.clickHandler) {
+                    container.removeEventListener("click", this.clickHandler);
+                }
+                container.style.cursor = "";
+            }
+        }
+        this.terminal = null;
+        this.links = [];
+        this.currentHoverLink = null;
+        this.mouseMoveHandler = null;
+        this.clickHandler = null;
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    refreshLinks() {
+        if (!this.terminal)
+            return;
+        const grid = this.terminal.activeGrid;
+        this.links = findLinks(grid);
+    }
+    getCellPosition(e) {
+        if (!this.terminal)
+            return null;
+        const container = this.terminal.element;
+        if (!container)
+            return null;
+        const rect = container.getBoundingClientRect();
+        const { width, height } = this.terminal.getCellSize();
+        if (width <= 0 || height <= 0)
+            return null;
+        const x = e.clientX - rect.left;
+        const y = e.clientY - rect.top;
+        const col = Math.floor(x / width);
+        const row = Math.floor(y / height);
+        return { row, col };
+    }
+    findLinkAt(row, col) {
+        for (const link of this.links) {
+            if (link.row === row && col >= link.startCol && col <= link.endCol) {
+                return link;
+            }
+        }
+        return null;
+    }
+    onMouseMove(e) {
+        if (!this.terminal)
+            return;
+        // Refresh links on each mousemove for simplicity
+        // (could be optimized to only refresh when rows change)
+        this.refreshLinks();
+        const pos = this.getCellPosition(e);
+        if (!pos)
+            return;
+        const link = this.findLinkAt(pos.row, pos.col);
+        const container = this.terminal.element;
+        if (link) {
+            if (container)
+                container.style.cursor = "pointer";
+            this.currentHoverLink = link;
+        }
+        else {
+            if (container)
+                container.style.cursor = "";
+            this.currentHoverLink = null;
+        }
+    }
+    onClick(e) {
+        if (!this.terminal)
+            return;
+        this.refreshLinks();
+        const pos = this.getCellPosition(e);
+        if (!pos)
+            return;
+        const link = this.findLinkAt(pos.row, pos.col);
+        if (link) {
+            e.preventDefault();
+            this.handler(link.url);
+        }
+    }
+}
+//# sourceMappingURL=web-links.js.map

package/dist/addons/web-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-links.js","sourceRoot":"","sources":["../../src/addons/web-links.ts"],"names":[],"mappings":"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"}

package/dist/fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.d.ts","sourceRoot":"","sources":["../src/fit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAYhC"}

package/dist/fit.js

@@ -0,0 +1,14 @@
+/**
+ * Calculate how many terminal columns/rows fit in a container element.
+ */
+export function calculateFit(container, cellWidth, cellHeight) {
+    const { width, height } = container.getBoundingClientRect();
+    const cols = Math.max(2, Math.floor(width / cellWidth));
+    const rows = Math.max(1, Math.floor(height / cellHeight));
+    // Guard against Infinity/NaN — critical gotcha from xterm.js
+    if (!Number.isFinite(cols) || !Number.isFinite(rows)) {
+        return { cols: 80, rows: 24 };
+    }
+    return { cols, rows };
+}
+//# sourceMappingURL=fit.js.map

package/dist/fit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit.js","sourceRoot":"","sources":["../src/fit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAsB,EACtB,SAAiB,EACjB,UAAkB;IAElB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC;IAE5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAE1D,6DAA6D;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export type { CursorState, SelectionRange, TerminalOptions, Theme } from "@next_term/core";
+export { CELL_SIZE, CellGrid, DEFAULT_THEME, extractText, normalizeSelection, } from "@next_term/core";
+export { AccessibilityManager, extractRowText } from "./accessibility.js";
+export type { ITerminalAddon } from "./addon.js";
+export { FitAddon } from "./addons/fit.js";
+export type { SearchMatch, SearchOptions } from "./addons/search.js";
+export { SearchAddon } from "./addons/search.js";
+export type { LinkMatch } from "./addons/web-links.js";
+export { WebLinksAddon } from "./addons/web-links.js";
+export { calculateFit } from "./fit.js";
+export type { InputHandlerOptions, SelectionState } from "./input-handler.js";
+export { InputHandler } from "./input-handler.js";
+export type { RenderBridgeOptions } from "./render-bridge.js";
+export { canUseOffscreenCanvas, RenderBridge } from "./render-bridge.js";
+export type { HighlightRange, IRenderer, RendererOptions } from "./renderer.js";
+export { build256Palette, Canvas2DRenderer } from "./renderer.js";
+export type { TerminalEntry } from "./shared-context.js";
+export { SharedWebGLContext } from "./shared-context.js";
+export type { WebTerminalOptions } from "./web-terminal.js";
+export { WebTerminal } from "./web-terminal.js";
+export type { GlyphInfo } from "./webgl-renderer.js";
+export { createRenderer, GlyphAtlas, hexToFloat4, WebGLRenderer } from "./webgl-renderer.js";
+export { WorkerBridge } from "./worker-bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { CELL_SIZE, CellGrid, DEFAULT_THEME, extractText, normalizeSelection, } from "@next_term/core";
+export { AccessibilityManager, extractRowText } from "./accessibility.js";
+export { FitAddon } from "./addons/fit.js";
+export { SearchAddon } from "./addons/search.js";
+export { WebLinksAddon } from "./addons/web-links.js";
+export { calculateFit } from "./fit.js";
+export { InputHandler } from "./input-handler.js";
+export { canUseOffscreenCanvas, RenderBridge } from "./render-bridge.js";
+export { build256Palette, Canvas2DRenderer } from "./renderer.js";
+export { SharedWebGLContext } from "./shared-context.js";
+export { WebTerminal } from "./web-terminal.js";
+export { createRenderer, GlyphAtlas, hexToFloat4, WebGLRenderer } from "./webgl-renderer.js";
+export { WorkerBridge } from "./worker-bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,QAAQ,EACR,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/input-handler.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Keyboard, mouse, and touch input handling for the web terminal.
+ *
+ * Uses a hidden <textarea> to capture keyboard input. This is essential
+ * for mobile browsers (iOS Safari, Android Chrome) where a plain div with
+ * tabindex="0" does NOT trigger the virtual keyboard. The textarea is
+ * positioned behind the terminal canvas so it's invisible but focusable.
+ *
+ * Touch gestures are delegated to the shared GestureHandler from
+ * @next_term/core, providing the same behavior on web and native:
+ * tap to focus, pan to scroll, long-press to select, pinch to zoom.
+ */
+import type { CellGrid, MouseEncoding, MouseProtocol } from "@next_term/core";
+export interface InputHandlerOptions {
+    /** Called when the user types data that should be sent to the PTY. */
+    onData: (data: Uint8Array) => void;
+    /** Called when the selection state changes. */
+    onSelectionChange?: (selection: SelectionState | null) => void;
+    /** Called when the user scrolls (deltaRows: positive = scroll down / toward newer). */
+    onScroll?: (deltaRows: number) => void;
+    /** Called when pinch-to-zoom changes font size. Receives the new fontSize. */
+    onFontSizeChange?: (fontSize: number) => void;
+    /** Whether the terminal is in application cursor-key mode (\x1bOA vs \x1b[A). */
+    applicationCursorKeys?: boolean;
+}
+export interface SelectionState {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+export declare class InputHandler {
+    private container;
+    private textarea;
+    private onData;
+    private onSelectionChange;
+    private onScroll;
+    private onFontSizeChange;
+    private applicationCursorKeys;
+    private bracketedPasteMode;
+    private mouseProtocol;
+    private mouseEncoding;
+    private sendFocusEvents;
+    private kittyFlags;
+    private cellWidth;
+    private cellHeight;
+    private currentFontSize;
+    private grid;
+    private selecting;
+    private selection;
+    private gestureHandler;
+    private touchStartX;
+    private touchStartY;
+    private touchLastX;
+    private touchLastY;
+    private longPressTimer;
+    private pinchStartDistance;
+    private pinchStartFontSize;
+    private isPinching;
+    private swipeDirection;
+    private hSwipeRemainder;
+    private composing;
+    private copyTooltip;
+    /** Text currently staged for copy. */
+    private pendingCopyText;
+    private boundKeyDown;
+    private boundKeyUp;
+    private boundInput;
+    private boundCompositionStart;
+    private boundCompositionEnd;
+    private boundPaste;
+    private boundMouseDown;
+    private boundMouseMove;
+    private boundMouseUp;
+    private boundFocus;
+    private boundBlur;
+    private boundWheel;
+    private boundTouchStart;
+    private boundTouchMove;
+    private boundTouchEnd;
+    private boundTouchCancel;
+    constructor(options: InputHandlerOptions);
+    attach(container: HTMLElement, cellWidth: number, cellHeight: number): void;
+    focus(): void;
+    blur(): void;
+    setApplicationCursorKeys(enabled: boolean): void;
+    setBracketedPasteMode(enabled: boolean): void;
+    setMouseProtocol(protocol: MouseProtocol): void;
+    setMouseEncoding(encoding: MouseEncoding): void;
+    setSendFocusEvents(enabled: boolean): void;
+    setKittyFlags(flags: number): void;
+    updateCellSize(cellWidth: number, cellHeight: number): void;
+    setFontSize(fontSize: number): void;
+    setGrid(grid: CellGrid): void;
+    getSelection(): SelectionState | null;
+    clearSelection(): void;
+    dispose(): void;
+    private handleKeyDown;
+    private handleKeyUp;
+    /**
+     * Handle input events from the hidden textarea.
+     * On mobile browsers, the virtual keyboard fires `input` events rather
+     * than `keydown` for printable characters. We read the textarea value
+     * and send any new characters to the PTY.
+     */
+    private handleInput;
+    private handleCompositionStart;
+    private handleCompositionEnd;
+    private handlePaste;
+    /** Send pasted text, wrapping in bracketed paste sequences if enabled. */
+    private sendPastedText;
+    /**
+     * Convert a KeyboardEvent into the VT sequence string to send to the PTY,
+     * or null if the event should not be handled.
+     */
+    keyToSequence(e: KeyboardEvent): string | null;
+    /**
+     * Produce the key-release sequence for a keyup event.
+     * Only meaningful when kittyFlags & 2 (report event types) is active.
+     * Returns null if event types are not enabled or the key has no kitty-encoded release.
+     */
+    keyUpToSequence(e: KeyboardEvent): string | null;
+    /**
+     * Kitty keyboard protocol key encoding (disambiguate mode, flag 1).
+     *
+     * Modifier bitmask (add 1 for the wire value):
+     *   shift=1, alt=2, ctrl=4
+     *
+     * Encoding rules:
+     * - Escape                → CSI 27 u  (CSI 27;1:type u when flag 2)
+     * - Modifier + letter     → CSI codepoint[:alt] ; modifier+1 u
+     * - Shift+Tab             → CSI 9 ; 2 u
+     * - Modified cursor keys  → CSI 1 ; modifier+1 <ABCDHF>
+     * - Modified tilde keys   → CSI n ; modifier+1 ~
+     * - Modified ESC-O F1-F4  → CSI 1 ; modifier+1 <PQRS>
+     * - Unmodified keys       → fall back to legacy encoding (no event type suffix)
+     *
+     * When kittyFlags & 2 (report event types), `:eventType` is appended to the
+     * modifier parameter of all enhanced sequences (not legacy fallbacks).
+     * When kittyFlags & 4 (report alternate keys), the key codepoint gains
+     * `:shifted[:base]` sub-parameters for single printable characters.
+     */
+    private _keyToSequenceKitty;
+    /**
+     * Alternate key sub-parameters for flag 4 (report alternate keys).
+     *
+     * Returns the sub-parameter string to append to the Unicode codepoint in
+     * CSI u sequences: `:shifted`, `::base`, `:shifted:base`, or `""`.
+     * - shifted: codepoint when Shift is held on the same physical key
+     * - base: codepoint of the physical key without modifiers (US QWERTY)
+     * Sub-parameters equal to the main codepoint are omitted.
+     */
+    private _kittyAltParam;
+    private handleFocus;
+    private handleBlur;
+    private getMouseCellPos;
+    /**
+     * Encode a mouse event as a VT sequence.
+     * button: 0=left, 1=middle, 2=right, 3=release, 64=scrollUp, 65=scrollDown
+     */
+    private encodeMouseEvent;
+    private handleMouseDown;
+    private handleMouseMove;
+    private handleMouseUp;
+    private handleWheel;
+    private cancelLongPress;
+    private getPinchDistance;
+    /** Convert a touch point to local pixel coordinates relative to container. */
+    private touchToLocal;
+    private handleTouchStart;
+    private handleTouchMove;
+    private handleTouchEnd;
+    private handleTouchCancel;
+    /**
+     * Show a floating "Copy" button near the selection so the user can tap
+     * to copy. iOS Safari doesn't show its native callout for programmatic
+     * selections, so we provide our own.
+     */
+    private showCopyTooltip;
+    /** Copy pending text to clipboard and dismiss the tooltip. */
+    private doCopy;
+    /** Hide the copy tooltip. */
+    private hideCopyTooltip;
+}
+//# sourceMappingURL=input-handler.d.ts.map

package/dist/input-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-handler.d.ts","sourceRoot":"","sources":["../src/input-handler.ts"],"names":[],"mappings":"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"}