restty 0.1.14 → 0.1.15

package/README.md

@@ -5,6 +5,7 @@ Powerful, lightweight browser terminal. Batteries included.
 Live demo: `https://restty.pages.dev/`
 
 Powered by:
+
 - `libghostty-vt` (WASM terminal core)
 - `WebGPU` (with WebGL2 fallback)
 - `text-shaper` (shaping + raster)
@@ -124,17 +125,37 @@ await restty.setFontSources([
 ]);
 ```
 
+### Touch behavior (pan-first by default)
+
+On touch devices, restty defaults to pan-first scrolling with long-press selection.
+
+```ts
+const restty = new Restty({
+  root: document.getElementById("terminal") as HTMLElement,
+  appOptions: {
+    // "long-press" (default) | "drag" | "off"
+    touchSelectionMode: "long-press",
+    // Optional tuning knobs:
+    touchSelectionLongPressMs: 450,
+    touchSelectionMoveThresholdPx: 10,
+  },
+});
+```
+
 ## API Snapshot
 
 Primary class:
+
 - `new Restty({ root, ...options })`
 - `createRestty(options)`
 
 Pane access:
+
 - `panes()` / `pane(id)` / `activePane()` / `focusedPane()` / `forEachPane(visitor)`
 - `splitActivePane("vertical" | "horizontal")` / `splitPane(id, direction)` / `closePane(id)`
 
 Active-pane convenience:
+
 - `connectPty(url)` / `disconnectPty()` / `isPtyConnected()`
 - `setRenderer("auto" | "webgpu" | "webgl2")`
 - `setFontSize(number)` / `setFontSources([...])`
@@ -148,6 +169,7 @@ Active-pane convenience:
 ## Advanced / Internal Modules
 
 Use these only when you need lower-level control:
+
 - `restty/wasm`: low-level WASM ABI wrapper (`loadResttyWasm`, `ResttyWasm`)
 - `restty/input`: key/mouse/input encoding utilities
 - `restty/pty`: PTY transport helpers

package/dist/app/index.d.ts

@@ -2,7 +2,7 @@ import type { ResttyApp, ResttyAppOptions } from "./types";
 export { createResttyAppSession, getDefaultResttyAppSession } from "./session";
 export { createResttyPaneManager, createDefaultResttyPaneContextMenuItems, getResttyShortcutModifierLabel, } from "./panes";
 export { Restty } from "./restty";
-export type { ResttyAppElements, ResttyAppCallbacks, FontSource, ResttyFontSource, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyWasmLogListener, ResttyAppSession, ResttyAppOptions, ResttyApp, } from "./types";
+export type { ResttyAppElements, ResttyAppCallbacks, FontSource, ResttyFontSource, ResttyTouchSelectionMode, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyWasmLogListener, ResttyAppSession, ResttyAppOptions, ResttyApp, } from "./types";
 export type { ResttyPaneSplitDirection, ResttyPaneContextMenuItem, ResttyPaneDefinition, ResttyPaneStyleOptions, ResttyPaneStylesOptions, ResttyPaneShortcutsOptions, ResttyPaneContextMenuOptions, CreateResttyPaneManagerOptions, ResttyPaneManager, ResttyPaneWithApp, CreateDefaultResttyPaneContextMenuItemsOptions, } from "./panes";
 export type { ResttyOptions } from "./restty";
 export declare function createResttyApp(options: ResttyAppOptions): ResttyApp;

package/dist/app/index.js

@@ -50323,6 +50323,17 @@ function createRestty(options) {
 }
 
 // src/app/index.ts
+function normalizeTouchSelectionMode(value) {
+  if (value === "drag" || value === "long-press" || value === "off")
+    return value;
+  return "long-press";
+}
+function clampFiniteNumber(value, fallback, min, max, round = false) {
+  if (!Number.isFinite(value))
+    return fallback;
+  const numeric = round ? Math.round(value) : Number(value);
+  return Math.min(max, Math.max(min, numeric));
+}
 function createResttyApp(options) {
   const { canvas: canvasInput, imeInput: imeInputInput, elements, callbacks } = options;
   const session = options.session ?? getDefaultResttyAppSession();
@@ -50345,6 +50356,9 @@ function createResttyApp(options) {
   const attachCanvasEvents = options.attachCanvasEvents ?? true;
   const autoResize = options.autoResize ?? true;
   const debugExpose = options.debugExpose ?? false;
+  const touchSelectionMode = normalizeTouchSelectionMode(options.touchSelectionMode);
+  const touchSelectionLongPressMs = clampFiniteNumber(options.touchSelectionLongPressMs, 450, 120, 2000, true);
+  const touchSelectionMoveThresholdPx = clampFiniteNumber(options.touchSelectionMoveThresholdPx, 10, 1, 64);
   const nerdIconScale = Number.isFinite(options.nerdIconScale) ? Number(options.nerdIconScale) : 1;
   const alphaBlending = options.alphaBlending ?? "linear-corrected";
   const srgbChannelToLinear = (c3) => c3 <= 0.04045 ? c3 / 12.92 : Math.pow((c3 + 0.055) / 1.055, 2.4);
@@ -50546,6 +50560,14 @@ function createResttyApp(options) {
     anchor: null,
     focus: null
   };
+  const touchSelectionState = {
+    pendingPointerId: null,
+    activePointerId: null,
+    pendingCell: null,
+    pendingStartX: 0,
+    pendingStartY: 0,
+    pendingTimer: 0
+  };
   const linkState = {
     hoverId: 0,
     hoverUri: ""
@@ -50567,6 +50589,27 @@ function createResttyApp(options) {
     }
     canvas.style.cursor = linkState.hoverId ? "pointer" : "default";
   }
+  function isTouchPointer(event) {
+    return event.pointerType === "touch";
+  }
+  function clearPendingTouchSelection() {
+    if (touchSelectionState.pendingTimer) {
+      clearTimeout(touchSelectionState.pendingTimer);
+      touchSelectionState.pendingTimer = 0;
+    }
+    touchSelectionState.pendingPointerId = null;
+    touchSelectionState.pendingCell = null;
+  }
+  function beginSelectionDrag(cell, pointerId) {
+    selectionState.active = true;
+    selectionState.dragging = true;
+    selectionState.anchor = cell;
+    selectionState.focus = cell;
+    touchSelectionState.activePointerId = pointerId;
+    canvas.setPointerCapture?.(pointerId);
+    updateCanvasCursor();
+    needsRender = true;
+  }
   function noteScrollActivity() {
     scrollbarState.lastInputAt = performance.now();
   }
@@ -51167,6 +51210,7 @@ function createResttyApp(options) {
     selectionState.dragging = false;
     selectionState.anchor = null;
     selectionState.focus = null;
+    touchSelectionState.activePointerId = null;
     updateCanvasCursor();
     needsRender = true;
   }
@@ -51380,30 +51424,71 @@ function createResttyApp(options) {
   function bindCanvasEvents() {
     if (!attachCanvasEvents)
       return;
+    canvas.style.touchAction = touchSelectionMode === "drag" ? "none" : "pan-y pinch-zoom";
     const onPointerDown = (event) => {
       if (inputHandler.sendMouseEvent("down", event)) {
         event.preventDefault();
         canvas.setPointerCapture?.(event.pointerId);
         return;
       }
+      if (isTouchPointer(event)) {
+        if (event.button !== 0)
+          return;
+        const cell2 = normalizeSelectionCell(positionToCell(event));
+        touchSelectionState.activePointerId = null;
+        if (touchSelectionMode === "off")
+          return;
+        if (touchSelectionMode === "drag") {
+          event.preventDefault();
+          beginSelectionDrag(cell2, event.pointerId);
+          return;
+        }
+        clearPendingTouchSelection();
+        touchSelectionState.pendingPointerId = event.pointerId;
+        touchSelectionState.pendingCell = cell2;
+        touchSelectionState.pendingStartX = event.clientX;
+        touchSelectionState.pendingStartY = event.clientY;
+        touchSelectionState.pendingTimer = setTimeout(() => {
+          if (touchSelectionState.pendingPointerId !== event.pointerId || !touchSelectionState.pendingCell) {
+            return;
+          }
+          const pendingCell = touchSelectionState.pendingCell;
+          clearPendingTouchSelection();
+          beginSelectionDrag(pendingCell, event.pointerId);
+        }, touchSelectionLongPressMs);
+        return;
+      }
       if (event.button !== 0)
         return;
       event.preventDefault();
       const cell = normalizeSelectionCell(positionToCell(event));
       updateLinkHover(cell);
-      selectionState.active = true;
-      selectionState.dragging = true;
-      selectionState.anchor = cell;
-      selectionState.focus = cell;
-      canvas.setPointerCapture?.(event.pointerId);
-      updateCanvasCursor();
-      needsRender = true;
+      beginSelectionDrag(cell, event.pointerId);
     };
     const onPointerMove = (event) => {
       if (inputHandler.sendMouseEvent("move", event)) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          const dx = event.clientX - touchSelectionState.pendingStartX;
+          const dy = event.clientY - touchSelectionState.pendingStartY;
+          if (dx * dx + dy * dy >= touchSelectionMoveThresholdPx * touchSelectionMoveThresholdPx) {
+            clearPendingTouchSelection();
+          }
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.focus = cell2;
+          updateLinkHover(null);
+          updateCanvasCursor();
+          needsRender = true;
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (!selectionState.dragging) {
         updateLinkHover(cell);
@@ -51420,6 +51505,27 @@ function createResttyApp(options) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+          touchSelectionState.activePointerId = null;
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.dragging = false;
+          selectionState.focus = cell2;
+          touchSelectionState.activePointerId = null;
+          if (selectionState.anchor && selectionState.focus && selectionState.anchor.row === selectionState.focus.row && selectionState.anchor.col === selectionState.focus.col) {
+            clearSelection();
+          } else {
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (selectionState.dragging) {
         event.preventDefault();
@@ -51438,6 +51544,21 @@ function createResttyApp(options) {
         openLink(linkState.hoverUri);
       }
     };
+    const onPointerCancel = (event) => {
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+        }
+        if (touchSelectionState.activePointerId === event.pointerId) {
+          touchSelectionState.activePointerId = null;
+          if (selectionState.dragging) {
+            selectionState.dragging = false;
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+      }
+    };
     const onWheel = (event) => {
       const mouseActive = inputHandler.isMouseActive();
       const altScreen = inputHandler.isAltScreen ? inputHandler.isAltScreen() : false;
@@ -51480,6 +51601,7 @@ function createResttyApp(options) {
     canvas.addEventListener("pointerdown", onPointerDown);
     canvas.addEventListener("pointermove", onPointerMove);
     canvas.addEventListener("pointerup", onPointerUp);
+    canvas.addEventListener("pointercancel", onPointerCancel);
     canvas.addEventListener("pointerleave", onPointerLeave);
     canvas.addEventListener("wheel", onWheel, { passive: false });
     canvas.addEventListener("contextmenu", onContextMenu);
@@ -51487,9 +51609,11 @@ function createResttyApp(options) {
       canvas.removeEventListener("pointerdown", onPointerDown);
       canvas.removeEventListener("pointermove", onPointerMove);
       canvas.removeEventListener("pointerup", onPointerUp);
+      canvas.removeEventListener("pointercancel", onPointerCancel);
       canvas.removeEventListener("pointerleave", onPointerLeave);
       canvas.removeEventListener("wheel", onWheel);
       canvas.removeEventListener("contextmenu", onContextMenu);
+      clearPendingTouchSelection();
     });
     if (imeInput) {
       let suppressNextInput = false;

package/dist/app/types.d.ts

@@ -63,6 +63,7 @@ export type ResttyLocalFontSource = {
 export type ResttyFontSource = ResttyUrlFontSource | ResttyBufferFontSource | ResttyLocalFontSource;
 export type FontSource = ResttyFontSource;
 export type ResttyFontPreset = "default-cdn" | "none";
+export type ResttyTouchSelectionMode = "drag" | "long-press" | "off";
 export type ResttyAppOptions = {
     canvas: HTMLCanvasElement;
     session?: ResttyAppSession;
@@ -83,6 +84,23 @@ export type ResttyAppOptions = {
     autoResize?: boolean;
     attachWindowEvents?: boolean;
     attachCanvasEvents?: boolean;
+    /**
+     * Touch selection behavior on pointerType=touch:
+     * - drag: immediate drag-selection (legacy behavior)
+     * - long-press: selection starts after press timeout (default)
+     * - off: disable touch selection, keep touch scrolling
+     */
+    touchSelectionMode?: ResttyTouchSelectionMode;
+    /**
+     * Long-press timeout in ms for touch selection intent.
+     * Only used when touchSelectionMode is "long-press".
+     */
+    touchSelectionLongPressMs?: number;
+    /**
+     * Pointer move threshold in CSS pixels before long-press selection is
+     * canceled and touch pan-scroll takes priority.
+     */
+    touchSelectionMoveThresholdPx?: number;
     debugExpose?: boolean;
     ptyTransport?: PtyTransport;
 };

package/dist/index.js

@@ -50323,6 +50323,17 @@ function createRestty(options) {
 }
 
 // src/app/index.ts
+function normalizeTouchSelectionMode(value) {
+  if (value === "drag" || value === "long-press" || value === "off")
+    return value;
+  return "long-press";
+}
+function clampFiniteNumber(value, fallback, min, max, round = false) {
+  if (!Number.isFinite(value))
+    return fallback;
+  const numeric = round ? Math.round(value) : Number(value);
+  return Math.min(max, Math.max(min, numeric));
+}
 function createResttyApp(options) {
   const { canvas: canvasInput, imeInput: imeInputInput, elements, callbacks } = options;
   const session = options.session ?? getDefaultResttyAppSession();
@@ -50345,6 +50356,9 @@ function createResttyApp(options) {
   const attachCanvasEvents = options.attachCanvasEvents ?? true;
   const autoResize = options.autoResize ?? true;
   const debugExpose = options.debugExpose ?? false;
+  const touchSelectionMode = normalizeTouchSelectionMode(options.touchSelectionMode);
+  const touchSelectionLongPressMs = clampFiniteNumber(options.touchSelectionLongPressMs, 450, 120, 2000, true);
+  const touchSelectionMoveThresholdPx = clampFiniteNumber(options.touchSelectionMoveThresholdPx, 10, 1, 64);
   const nerdIconScale = Number.isFinite(options.nerdIconScale) ? Number(options.nerdIconScale) : 1;
   const alphaBlending = options.alphaBlending ?? "linear-corrected";
   const srgbChannelToLinear = (c3) => c3 <= 0.04045 ? c3 / 12.92 : Math.pow((c3 + 0.055) / 1.055, 2.4);
@@ -50546,6 +50560,14 @@ function createResttyApp(options) {
     anchor: null,
     focus: null
   };
+  const touchSelectionState = {
+    pendingPointerId: null,
+    activePointerId: null,
+    pendingCell: null,
+    pendingStartX: 0,
+    pendingStartY: 0,
+    pendingTimer: 0
+  };
   const linkState = {
     hoverId: 0,
     hoverUri: ""
@@ -50567,6 +50589,27 @@ function createResttyApp(options) {
     }
     canvas.style.cursor = linkState.hoverId ? "pointer" : "default";
   }
+  function isTouchPointer(event) {
+    return event.pointerType === "touch";
+  }
+  function clearPendingTouchSelection() {
+    if (touchSelectionState.pendingTimer) {
+      clearTimeout(touchSelectionState.pendingTimer);
+      touchSelectionState.pendingTimer = 0;
+    }
+    touchSelectionState.pendingPointerId = null;
+    touchSelectionState.pendingCell = null;
+  }
+  function beginSelectionDrag(cell, pointerId) {
+    selectionState.active = true;
+    selectionState.dragging = true;
+    selectionState.anchor = cell;
+    selectionState.focus = cell;
+    touchSelectionState.activePointerId = pointerId;
+    canvas.setPointerCapture?.(pointerId);
+    updateCanvasCursor();
+    needsRender = true;
+  }
   function noteScrollActivity() {
     scrollbarState.lastInputAt = performance.now();
   }
@@ -51167,6 +51210,7 @@ function createResttyApp(options) {
     selectionState.dragging = false;
     selectionState.anchor = null;
     selectionState.focus = null;
+    touchSelectionState.activePointerId = null;
     updateCanvasCursor();
     needsRender = true;
   }
@@ -51380,30 +51424,71 @@ function createResttyApp(options) {
   function bindCanvasEvents() {
     if (!attachCanvasEvents)
       return;
+    canvas.style.touchAction = touchSelectionMode === "drag" ? "none" : "pan-y pinch-zoom";
     const onPointerDown = (event) => {
       if (inputHandler.sendMouseEvent("down", event)) {
         event.preventDefault();
         canvas.setPointerCapture?.(event.pointerId);
         return;
       }
+      if (isTouchPointer(event)) {
+        if (event.button !== 0)
+          return;
+        const cell2 = normalizeSelectionCell(positionToCell(event));
+        touchSelectionState.activePointerId = null;
+        if (touchSelectionMode === "off")
+          return;
+        if (touchSelectionMode === "drag") {
+          event.preventDefault();
+          beginSelectionDrag(cell2, event.pointerId);
+          return;
+        }
+        clearPendingTouchSelection();
+        touchSelectionState.pendingPointerId = event.pointerId;
+        touchSelectionState.pendingCell = cell2;
+        touchSelectionState.pendingStartX = event.clientX;
+        touchSelectionState.pendingStartY = event.clientY;
+        touchSelectionState.pendingTimer = setTimeout(() => {
+          if (touchSelectionState.pendingPointerId !== event.pointerId || !touchSelectionState.pendingCell) {
+            return;
+          }
+          const pendingCell = touchSelectionState.pendingCell;
+          clearPendingTouchSelection();
+          beginSelectionDrag(pendingCell, event.pointerId);
+        }, touchSelectionLongPressMs);
+        return;
+      }
       if (event.button !== 0)
         return;
       event.preventDefault();
       const cell = normalizeSelectionCell(positionToCell(event));
       updateLinkHover(cell);
-      selectionState.active = true;
-      selectionState.dragging = true;
-      selectionState.anchor = cell;
-      selectionState.focus = cell;
-      canvas.setPointerCapture?.(event.pointerId);
-      updateCanvasCursor();
-      needsRender = true;
+      beginSelectionDrag(cell, event.pointerId);
     };
     const onPointerMove = (event) => {
       if (inputHandler.sendMouseEvent("move", event)) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          const dx = event.clientX - touchSelectionState.pendingStartX;
+          const dy = event.clientY - touchSelectionState.pendingStartY;
+          if (dx * dx + dy * dy >= touchSelectionMoveThresholdPx * touchSelectionMoveThresholdPx) {
+            clearPendingTouchSelection();
+          }
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.focus = cell2;
+          updateLinkHover(null);
+          updateCanvasCursor();
+          needsRender = true;
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (!selectionState.dragging) {
         updateLinkHover(cell);
@@ -51420,6 +51505,27 @@ function createResttyApp(options) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+          touchSelectionState.activePointerId = null;
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.dragging = false;
+          selectionState.focus = cell2;
+          touchSelectionState.activePointerId = null;
+          if (selectionState.anchor && selectionState.focus && selectionState.anchor.row === selectionState.focus.row && selectionState.anchor.col === selectionState.focus.col) {
+            clearSelection();
+          } else {
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (selectionState.dragging) {
         event.preventDefault();
@@ -51438,6 +51544,21 @@ function createResttyApp(options) {
         openLink(linkState.hoverUri);
       }
     };
+    const onPointerCancel = (event) => {
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+        }
+        if (touchSelectionState.activePointerId === event.pointerId) {
+          touchSelectionState.activePointerId = null;
+          if (selectionState.dragging) {
+            selectionState.dragging = false;
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+      }
+    };
     const onWheel = (event) => {
       const mouseActive = inputHandler.isMouseActive();
       const altScreen = inputHandler.isAltScreen ? inputHandler.isAltScreen() : false;
@@ -51480,6 +51601,7 @@ function createResttyApp(options) {
     canvas.addEventListener("pointerdown", onPointerDown);
     canvas.addEventListener("pointermove", onPointerMove);
     canvas.addEventListener("pointerup", onPointerUp);
+    canvas.addEventListener("pointercancel", onPointerCancel);
     canvas.addEventListener("pointerleave", onPointerLeave);
     canvas.addEventListener("wheel", onWheel, { passive: false });
     canvas.addEventListener("contextmenu", onContextMenu);
@@ -51487,9 +51609,11 @@ function createResttyApp(options) {
       canvas.removeEventListener("pointerdown", onPointerDown);
       canvas.removeEventListener("pointermove", onPointerMove);
       canvas.removeEventListener("pointerup", onPointerUp);
+      canvas.removeEventListener("pointercancel", onPointerCancel);
       canvas.removeEventListener("pointerleave", onPointerLeave);
       canvas.removeEventListener("wheel", onWheel);
       canvas.removeEventListener("contextmenu", onContextMenu);
+      clearPendingTouchSelection();
     });
     if (imeInput) {
       let suppressNextInput = false;

package/dist/internal.js

@@ -50323,6 +50323,17 @@ function createRestty(options) {
 }
 
 // src/app/index.ts
+function normalizeTouchSelectionMode(value) {
+  if (value === "drag" || value === "long-press" || value === "off")
+    return value;
+  return "long-press";
+}
+function clampFiniteNumber(value, fallback, min, max, round = false) {
+  if (!Number.isFinite(value))
+    return fallback;
+  const numeric = round ? Math.round(value) : Number(value);
+  return Math.min(max, Math.max(min, numeric));
+}
 function createResttyApp(options) {
   const { canvas: canvasInput, imeInput: imeInputInput, elements, callbacks } = options;
   const session = options.session ?? getDefaultResttyAppSession();
@@ -50345,6 +50356,9 @@ function createResttyApp(options) {
   const attachCanvasEvents = options.attachCanvasEvents ?? true;
   const autoResize = options.autoResize ?? true;
   const debugExpose = options.debugExpose ?? false;
+  const touchSelectionMode = normalizeTouchSelectionMode(options.touchSelectionMode);
+  const touchSelectionLongPressMs = clampFiniteNumber(options.touchSelectionLongPressMs, 450, 120, 2000, true);
+  const touchSelectionMoveThresholdPx = clampFiniteNumber(options.touchSelectionMoveThresholdPx, 10, 1, 64);
   const nerdIconScale = Number.isFinite(options.nerdIconScale) ? Number(options.nerdIconScale) : 1;
   const alphaBlending = options.alphaBlending ?? "linear-corrected";
   const srgbChannelToLinear = (c3) => c3 <= 0.04045 ? c3 / 12.92 : Math.pow((c3 + 0.055) / 1.055, 2.4);
@@ -50546,6 +50560,14 @@ function createResttyApp(options) {
     anchor: null,
     focus: null
   };
+  const touchSelectionState = {
+    pendingPointerId: null,
+    activePointerId: null,
+    pendingCell: null,
+    pendingStartX: 0,
+    pendingStartY: 0,
+    pendingTimer: 0
+  };
   const linkState = {
     hoverId: 0,
     hoverUri: ""
@@ -50567,6 +50589,27 @@ function createResttyApp(options) {
     }
     canvas.style.cursor = linkState.hoverId ? "pointer" : "default";
   }
+  function isTouchPointer(event) {
+    return event.pointerType === "touch";
+  }
+  function clearPendingTouchSelection() {
+    if (touchSelectionState.pendingTimer) {
+      clearTimeout(touchSelectionState.pendingTimer);
+      touchSelectionState.pendingTimer = 0;
+    }
+    touchSelectionState.pendingPointerId = null;
+    touchSelectionState.pendingCell = null;
+  }
+  function beginSelectionDrag(cell, pointerId) {
+    selectionState.active = true;
+    selectionState.dragging = true;
+    selectionState.anchor = cell;
+    selectionState.focus = cell;
+    touchSelectionState.activePointerId = pointerId;
+    canvas.setPointerCapture?.(pointerId);
+    updateCanvasCursor();
+    needsRender = true;
+  }
   function noteScrollActivity() {
     scrollbarState.lastInputAt = performance.now();
   }
@@ -51167,6 +51210,7 @@ function createResttyApp(options) {
     selectionState.dragging = false;
     selectionState.anchor = null;
     selectionState.focus = null;
+    touchSelectionState.activePointerId = null;
     updateCanvasCursor();
     needsRender = true;
   }
@@ -51380,30 +51424,71 @@ function createResttyApp(options) {
   function bindCanvasEvents() {
     if (!attachCanvasEvents)
       return;
+    canvas.style.touchAction = touchSelectionMode === "drag" ? "none" : "pan-y pinch-zoom";
     const onPointerDown = (event) => {
       if (inputHandler.sendMouseEvent("down", event)) {
         event.preventDefault();
         canvas.setPointerCapture?.(event.pointerId);
         return;
       }
+      if (isTouchPointer(event)) {
+        if (event.button !== 0)
+          return;
+        const cell2 = normalizeSelectionCell(positionToCell(event));
+        touchSelectionState.activePointerId = null;
+        if (touchSelectionMode === "off")
+          return;
+        if (touchSelectionMode === "drag") {
+          event.preventDefault();
+          beginSelectionDrag(cell2, event.pointerId);
+          return;
+        }
+        clearPendingTouchSelection();
+        touchSelectionState.pendingPointerId = event.pointerId;
+        touchSelectionState.pendingCell = cell2;
+        touchSelectionState.pendingStartX = event.clientX;
+        touchSelectionState.pendingStartY = event.clientY;
+        touchSelectionState.pendingTimer = setTimeout(() => {
+          if (touchSelectionState.pendingPointerId !== event.pointerId || !touchSelectionState.pendingCell) {
+            return;
+          }
+          const pendingCell = touchSelectionState.pendingCell;
+          clearPendingTouchSelection();
+          beginSelectionDrag(pendingCell, event.pointerId);
+        }, touchSelectionLongPressMs);
+        return;
+      }
       if (event.button !== 0)
         return;
       event.preventDefault();
       const cell = normalizeSelectionCell(positionToCell(event));
       updateLinkHover(cell);
-      selectionState.active = true;
-      selectionState.dragging = true;
-      selectionState.anchor = cell;
-      selectionState.focus = cell;
-      canvas.setPointerCapture?.(event.pointerId);
-      updateCanvasCursor();
-      needsRender = true;
+      beginSelectionDrag(cell, event.pointerId);
     };
     const onPointerMove = (event) => {
       if (inputHandler.sendMouseEvent("move", event)) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          const dx = event.clientX - touchSelectionState.pendingStartX;
+          const dy = event.clientY - touchSelectionState.pendingStartY;
+          if (dx * dx + dy * dy >= touchSelectionMoveThresholdPx * touchSelectionMoveThresholdPx) {
+            clearPendingTouchSelection();
+          }
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.focus = cell2;
+          updateLinkHover(null);
+          updateCanvasCursor();
+          needsRender = true;
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (!selectionState.dragging) {
         updateLinkHover(cell);
@@ -51420,6 +51505,27 @@ function createResttyApp(options) {
         event.preventDefault();
         return;
       }
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+          touchSelectionState.activePointerId = null;
+          return;
+        }
+        if (selectionState.dragging && touchSelectionState.activePointerId === event.pointerId) {
+          const cell2 = normalizeSelectionCell(positionToCell(event));
+          event.preventDefault();
+          selectionState.dragging = false;
+          selectionState.focus = cell2;
+          touchSelectionState.activePointerId = null;
+          if (selectionState.anchor && selectionState.focus && selectionState.anchor.row === selectionState.focus.row && selectionState.anchor.col === selectionState.focus.col) {
+            clearSelection();
+          } else {
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+        return;
+      }
       const cell = normalizeSelectionCell(positionToCell(event));
       if (selectionState.dragging) {
         event.preventDefault();
@@ -51438,6 +51544,21 @@ function createResttyApp(options) {
         openLink(linkState.hoverUri);
       }
     };
+    const onPointerCancel = (event) => {
+      if (isTouchPointer(event)) {
+        if (touchSelectionState.pendingPointerId === event.pointerId) {
+          clearPendingTouchSelection();
+        }
+        if (touchSelectionState.activePointerId === event.pointerId) {
+          touchSelectionState.activePointerId = null;
+          if (selectionState.dragging) {
+            selectionState.dragging = false;
+            updateCanvasCursor();
+            needsRender = true;
+          }
+        }
+      }
+    };
     const onWheel = (event) => {
       const mouseActive = inputHandler.isMouseActive();
       const altScreen = inputHandler.isAltScreen ? inputHandler.isAltScreen() : false;
@@ -51480,6 +51601,7 @@ function createResttyApp(options) {
     canvas.addEventListener("pointerdown", onPointerDown);
     canvas.addEventListener("pointermove", onPointerMove);
     canvas.addEventListener("pointerup", onPointerUp);
+    canvas.addEventListener("pointercancel", onPointerCancel);
     canvas.addEventListener("pointerleave", onPointerLeave);
     canvas.addEventListener("wheel", onWheel, { passive: false });
     canvas.addEventListener("contextmenu", onContextMenu);
@@ -51487,9 +51609,11 @@ function createResttyApp(options) {
       canvas.removeEventListener("pointerdown", onPointerDown);
       canvas.removeEventListener("pointermove", onPointerMove);
       canvas.removeEventListener("pointerup", onPointerUp);
+      canvas.removeEventListener("pointercancel", onPointerCancel);
       canvas.removeEventListener("pointerleave", onPointerLeave);
       canvas.removeEventListener("wheel", onWheel);
       canvas.removeEventListener("contextmenu", onContextMenu);
+      clearPendingTouchSelection();
     });
     if (imeInput) {
       let suppressNextInput = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restty",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Browser terminal rendering library powered by WASM, WebGPU/WebGL2, and TypeScript text shaping.",
   "keywords": [
     "terminal",