restty 0.1.22 → 0.1.24

package/dist/app/restty.d.ts

@@ -1,4 +1,4 @@
-import type { InputHandler, MouseMode } from "../input";
+import type { DesktopNotification, InputHandler, MouseMode } from "../input";
 import type { GhosttyTheme } from "../theme";
 import { type CreateResttyAppPaneManagerOptions, type ResttyManagedAppPane, type ResttyManagedPaneStyleOptions, type ResttyPaneAppOptionsInput } from "./pane-app-manager";
 import type { ResttyPaneManager, ResttyPaneSplitDirection } from "./panes";
@@ -11,6 +11,10 @@ export type ResttyOptions = Omit<CreateResttyAppPaneManagerOptions, "appOptions"
     appOptions?: CreateResttyAppPaneManagerOptions["appOptions"];
     /** Font sources applied to every pane. */
     fontSources?: ResttyPaneAppOptionsInput["fontSources"];
+    /** Global handler for desktop notifications emitted by any pane. */
+    onDesktopNotification?: (notification: DesktopNotification & {
+        paneId: number;
+    }) => void;
     /** Whether to create the first pane automatically (default true). */
     createInitialPane?: boolean | {
         focus?: boolean;

package/dist/app/types.d.ts

@@ -1,4 +1,4 @@
-import type { InputHandler, MouseMode } from "../input";
+import type { DesktopNotification, InputHandler, MouseMode } from "../input";
 import type { PtyTransport } from "../pty";
 import type { WebGPUCoreState } from "../renderer";
 import type { GhosttyTheme } from "../theme";
@@ -85,6 +85,8 @@ export type ResttyAppCallbacks = {
     onPtyStatus?: (status: string) => void;
     /** Mouse mode/status changed. */
     onMouseStatus?: (status: string) => void;
+    /** Terminal requested a desktop notification via OSC 9 / OSC 777. */
+    onDesktopNotification?: (notification: DesktopNotification) => void;
 };
 /** Raw font data as an ArrayBuffer or typed-array view. */
 export type ResttyFontBufferData = ArrayBuffer | ArrayBufferView;

package/dist/{chunk-d3xkkgrb.js → chunk-68qdtczc.js}

@@ -8576,6 +8576,11 @@ class OutputFilter {
   clipboardWrite;
   clipboardRead;
   getDefaultColors;
+  desktopNotificationHandler;
+  semanticPromptSeen = false;
+  promptClickEvents = false;
+  promptInputActive = false;
+  commandRunning = false;
   constructor(options) {
     this.getCursorPosition = options.getCursorPosition;
     this.sendReply = options.sendReply;
@@ -8585,6 +8590,7 @@ class OutputFilter {
     this.clipboardRead = options.onClipboardRead;
     this.windowOpHandler = options.onWindowOp;
     this.getWindowMetrics = options.getWindowMetrics;
+    this.desktopNotificationHandler = options.onDesktopNotification;
   }
   setCursorProvider(fn) {
     this.getCursorPosition = fn;
@@ -8607,6 +8613,80 @@ class OutputFilter {
   isSynchronizedOutput() {
     return this.synchronizedOutput;
   }
+  isPromptClickEventsEnabled() {
+    return this.semanticPromptSeen && this.promptClickEvents && this.promptInputActive && !this.commandRunning && !this.altScreen;
+  }
+  encodePromptClickEvent(cell) {
+    if (!this.isPromptClickEventsEnabled())
+      return "";
+    const row = Math.max(1, Math.floor(cell.row) + 1);
+    const col = Math.max(1, Math.floor(cell.col) + 1);
+    return `\x1B[<0;${col};${row}M`;
+  }
+  readOsc133BoolOption(options, key) {
+    if (!options)
+      return null;
+    const prefix = `${key}=`;
+    const fields = options.split(";");
+    for (let i = 0;i < fields.length; i += 1) {
+      const field = fields[i];
+      if (!field.startsWith(prefix))
+        continue;
+      const value = field.slice(prefix.length);
+      if (value === "1")
+        return true;
+      if (value === "0")
+        return false;
+      return null;
+    }
+    return null;
+  }
+  observeSemanticPromptOsc(action, options) {
+    const clickEvents = this.readOsc133BoolOption(options, "click_events");
+    if (clickEvents !== null)
+      this.promptClickEvents = clickEvents;
+    switch (action) {
+      case "A":
+      case "B":
+      case "I":
+        this.semanticPromptSeen = true;
+        this.promptInputActive = true;
+        this.commandRunning = false;
+        break;
+      case "C":
+        this.semanticPromptSeen = true;
+        this.promptInputActive = false;
+        this.commandRunning = true;
+        break;
+      case "D":
+        this.semanticPromptSeen = true;
+        this.promptInputActive = false;
+        this.commandRunning = false;
+        break;
+      case "P":
+        this.semanticPromptSeen = true;
+        break;
+      default:
+        break;
+    }
+  }
+  observeOsc(seq) {
+    const content = seq.slice(2);
+    const sep = content.indexOf(";");
+    if (sep < 0)
+      return;
+    const code = content.slice(0, sep);
+    if (code !== "133")
+      return;
+    const rest = content.slice(sep + 1);
+    if (!rest)
+      return;
+    const action = rest[0] ?? "";
+    if (!action)
+      return;
+    const options = rest.length > 2 && rest[1] === ";" ? rest.slice(2) : "";
+    this.observeSemanticPromptOsc(action, options);
+  }
   replyOscColor(code, rgb) {
     const toHex4 = (value) => Math.round(Math.max(0, Math.min(255, value)) * 257).toString(16).padStart(4, "0");
     const r = toHex4(rgb[0]);
@@ -8618,6 +8698,39 @@ class OutputFilter {
     const content = seq.slice(2);
     const parts = content.split(";");
     const code = parts[0] ?? "";
+    if (code === "9") {
+      const firstSep = content.indexOf(";");
+      const body = firstSep >= 0 ? content.slice(firstSep + 1) : "";
+      if (/^(?:[2-9]|1[0-2]?)(?:;|$)/.test(body)) {
+        return true;
+      }
+      this.desktopNotificationHandler?.({
+        title: "",
+        body,
+        source: "osc9",
+        raw: seq
+      });
+      return true;
+    }
+    if (code === "777") {
+      const firstSep = content.indexOf(";");
+      const rest = firstSep >= 0 ? content.slice(firstSep + 1) : "";
+      if (!rest.startsWith("notify;")) {
+        return true;
+      }
+      const payload = rest.slice("notify;".length);
+      const titleSep = payload.indexOf(";");
+      if (titleSep < 0) {
+        return true;
+      }
+      this.desktopNotificationHandler?.({
+        title: payload.slice(0, titleSep),
+        body: payload.slice(titleSep + 1),
+        source: "osc777",
+        raw: seq
+      });
+      return true;
+    }
     if (code === "52") {
       const target = parts[1] ?? "c";
       const payload = parts.slice(2).join(";");
@@ -8749,6 +8862,7 @@ class OutputFilter {
           break;
         }
         const seq2 = data.slice(i, j2);
+        this.observeOsc(seq2);
         if (!this.handleOsc(seq2)) {
           result += data.slice(i, j2 + terminatorLen);
         }
@@ -8825,7 +8939,8 @@ function createInputHandler(options = {}) {
     onClipboardRead: options.onClipboardRead,
     onClipboardWrite: options.onClipboardWrite,
     onWindowOp: options.onWindowOp,
-    getWindowMetrics: options.getWindowMetrics
+    getWindowMetrics: options.getWindowMetrics,
+    onDesktopNotification: options.onDesktopNotification
   });
   return {
     sequences,
@@ -8858,6 +8973,8 @@ function createInputHandler(options = {}) {
     isFocusReporting: () => filter.isFocusReporting(),
     isAltScreen: () => filter.isAltScreen(),
     isSynchronizedOutput: () => filter.isSynchronizedOutput(),
+    isPromptClickEventsEnabled: () => filter.isPromptClickEventsEnabled(),
+    encodePromptClickEvent: (cell) => filter.encodePromptClickEvent(cell),
     sendMouseEvent: (kind, event) => mouse.sendMouseEvent(kind, event)
   };
 }
@@ -50571,6 +50688,11 @@ function createResttyApp(options) {
     panLastY: 0,
     pendingTimer: 0
   };
+  const desktopSelectionState = {
+    pendingPointerId: null,
+    pendingCell: null,
+    startedWithActiveSelection: false
+  };
   const linkState = {
     hoverId: 0,
     hoverUri: ""
@@ -50590,11 +50712,7 @@ function createResttyApp(options) {
   function updateCanvasCursor() {
     if (!canvas)
       return;
-    if (selectionState.dragging || selectionState.active) {
-      canvas.style.cursor = "text";
-      return;
-    }
-    canvas.style.cursor = linkState.hoverId ? "pointer" : "default";
+    canvas.style.cursor = "text";
   }
   function isTouchPointer(event) {
     return event.pointerType === "touch";
@@ -50608,6 +50726,11 @@ function createResttyApp(options) {
     touchSelectionState.pendingCell = null;
     touchSelectionState.pendingStartedAt = 0;
   }
+  function clearPendingDesktopSelection() {
+    desktopSelectionState.pendingPointerId = null;
+    desktopSelectionState.pendingCell = null;
+    desktopSelectionState.startedWithActiveSelection = false;
+  }
   function tryActivatePendingTouchSelection(pointerId) {
     if (touchSelectionMode !== "long-press")
       return false;
@@ -50623,6 +50746,7 @@ function createResttyApp(options) {
     return true;
   }
   function beginSelectionDrag(cell, pointerId) {
+    clearPendingDesktopSelection();
     selectionState.active = true;
     selectionState.dragging = true;
     selectionState.anchor = cell;
@@ -51420,10 +51544,12 @@ function createResttyApp(options) {
     },
     onWindowOp: (op) => {
       appendLog(`[term] window op ${op.type} ${op.params.join(";")}`);
-    }
+    },
+    onDesktopNotification: callbacks?.onDesktopNotification
   });
   inputHandler.setMouseMode("auto");
   function clearSelection() {
+    clearPendingDesktopSelection();
     selectionState.active = false;
     selectionState.dragging = false;
     selectionState.anchor = null;
@@ -51683,6 +51809,7 @@ function createResttyApp(options) {
         }
       }
       if (shouldRoutePointerToAppMouse(event.shiftKey) && !shouldPreferLocalPrimarySelection(event) && inputHandler.sendMouseEvent("down", event)) {
+        clearPendingDesktopSelection();
         event.preventDefault();
         canvas.setPointerCapture?.(event.pointerId);
         return;
@@ -51718,7 +51845,9 @@ function createResttyApp(options) {
       event.preventDefault();
       const cell = normalizeSelectionCell(positionToCell(event));
       updateLinkHover(cell);
-      beginSelectionDrag(cell, event.pointerId);
+      desktopSelectionState.pendingPointerId = event.pointerId;
+      desktopSelectionState.pendingCell = cell;
+      desktopSelectionState.startedWithActiveSelection = selectionState.active;
     };
     const onPointerMove = (event) => {
       if (scrollbarDragState.pointerId === event.pointerId) {
@@ -51770,6 +51899,19 @@ function createResttyApp(options) {
         return;
       }
       const cell = normalizeSelectionCell(positionToCell(event));
+      if (desktopSelectionState.pendingPointerId === event.pointerId && desktopSelectionState.pendingCell) {
+        const anchor = desktopSelectionState.pendingCell;
+        if (anchor.row !== cell.row || anchor.col !== cell.col) {
+          beginSelectionDrag(anchor, event.pointerId);
+          selectionState.focus = cell;
+          updateLinkHover(null);
+          updateCanvasCursor();
+          needsRender = true;
+          return;
+        }
+        updateLinkHover(cell);
+        return;
+      }
       if (selectionState.dragging) {
         event.preventDefault();
         selectionState.focus = cell;
@@ -51817,6 +51959,12 @@ function createResttyApp(options) {
         return;
       }
       const cell = normalizeSelectionCell(positionToCell(event));
+      const clearSelectionFromClick = desktopSelectionState.pendingPointerId === event.pointerId && desktopSelectionState.startedWithActiveSelection && !selectionState.dragging;
+      if (desktopSelectionState.pendingPointerId === event.pointerId) {
+        clearPendingDesktopSelection();
+      }
+      if (clearSelectionFromClick)
+        clearSelection();
       if (selectionState.dragging) {
         event.preventDefault();
         selectionState.dragging = false;
@@ -51834,6 +51982,14 @@ function createResttyApp(options) {
         }
         updateLinkHover(cell);
       }
+      if (!selectionState.active && event.button === 0 && !event.shiftKey && !event.altKey && !event.ctrlKey && !event.metaKey && inputHandler.isPromptClickEventsEnabled()) {
+        const seq = inputHandler.encodePromptClickEvent(cell);
+        if (seq) {
+          event.preventDefault();
+          sendKeyInput(seq);
+          return;
+        }
+      }
       if (!selectionState.active && event.button === 0 && linkState.hoverUri) {
         openLink(linkState.hoverUri);
       }
@@ -51842,6 +51998,9 @@ function createResttyApp(options) {
       if (scrollbarDragState.pointerId === event.pointerId) {
         scrollbarDragState.pointerId = null;
       }
+      if (desktopSelectionState.pendingPointerId === event.pointerId) {
+        clearPendingDesktopSelection();
+      }
       if (isTouchPointer(event)) {
         if (touchSelectionState.pendingPointerId === event.pointerId) {
           clearPendingTouchSelection();
@@ -56736,6 +56895,7 @@ class Restty {
       createInitialPane = true,
       appOptions,
       fontSources,
+      onDesktopNotification,
       onPaneCreated,
       onPaneClosed,
       onPaneSplit,
@@ -56748,9 +56908,17 @@ class Restty {
       const resolved = typeof appOptions === "function" ? appOptions(context) : appOptions ?? {};
       const resolvedBeforeInput = resolved.beforeInput;
       const resolvedBeforeRenderOutput = resolved.beforeRenderOutput;
+      const resolvedCallbacks = resolved.callbacks;
       return {
         ...resolved,
         ...this.fontSources ? { fontSources: this.fontSources } : {},
+        callbacks: onDesktopNotification || resolvedCallbacks?.onDesktopNotification ? {
+          ...resolvedCallbacks,
+          onDesktopNotification: (notification) => {
+            resolvedCallbacks?.onDesktopNotification?.(notification);
+            onDesktopNotification?.({ ...notification, paneId: context.id });
+          }
+        } : resolvedCallbacks,
         beforeInput: ({ text, source }) => {
           const maybeUserText = resolvedBeforeInput?.({ text, source });
           if (maybeUserText === null)

package/dist/input/index.d.ts

@@ -3,4 +3,4 @@ import type { InputHandler, InputHandlerOptions } from "./types";
  * Create a terminal input handler with key, IME, PTY, and mouse support.
  */
 export declare function createInputHandler(options?: InputHandlerOptions): InputHandler;
-export type { CellPosition, CursorPosition, InputHandler, InputHandlerConfig, InputHandlerOptions, MouseMode, MouseStatus, } from "./types";
+export type { CellPosition, CursorPosition, InputHandler, InputHandlerConfig, InputHandlerOptions, MouseMode, MouseStatus, DesktopNotification, } from "./types";

package/dist/input/output.d.ts

@@ -1,4 +1,4 @@
-import type { CursorPosition, WindowOp } from "./types";
+import type { CellPosition, CursorPosition, DesktopNotification, WindowOp } from "./types";
 import type { MouseController } from "./mouse";
 /**
  * Construction options for OutputFilter.
@@ -31,6 +31,8 @@ export type OutputFilterOptions = {
         cellWidthPx: number;
         cellHeightPx: number;
     };
+    /** Handler for desktop notifications (OSC 9 / OSC 777). */
+    onDesktopNotification?: (notification: DesktopNotification) => void;
 };
 /**
  * Parses output for control queries (CPR/DA) and mouse mode toggles,
@@ -50,6 +52,11 @@ export declare class OutputFilter {
     private clipboardWrite?;
     private clipboardRead?;
     private getDefaultColors?;
+    private desktopNotificationHandler?;
+    private semanticPromptSeen;
+    private promptClickEvents;
+    private promptInputActive;
+    private commandRunning;
     constructor(options: OutputFilterOptions);
     setCursorProvider(fn: () => CursorPosition): void;
     setReplySink(fn: (data: string) => void): void;
@@ -58,6 +65,11 @@ export declare class OutputFilter {
     isBracketedPaste(): boolean;
     isFocusReporting(): boolean;
     isSynchronizedOutput(): boolean;
+    isPromptClickEventsEnabled(): boolean;
+    encodePromptClickEvent(cell: CellPosition): string;
+    private readOsc133BoolOption;
+    private observeSemanticPromptOsc;
+    private observeOsc;
     private replyOscColor;
     private handleOsc;
     private handleModeSeq;

package/dist/input/types.d.ts

@@ -59,6 +59,15 @@ export type WindowOp = {
     params: number[];
     raw: string;
 };
+/**
+ * Desktop notification payload parsed from terminal OSC sequences.
+ */
+export type DesktopNotification = {
+    title: string;
+    body: string;
+    source: "osc9" | "osc777";
+    raw: string;
+};
 /**
  * Input handler construction options.
  */
@@ -103,6 +112,10 @@ export type InputHandlerOptions = {
      */
     onClipboardWrite?: (text: string) => void | Promise<void>;
     onClipboardRead?: () => string | null | Promise<string | null>;
+    /**
+     * Optional handler for desktop notifications (OSC 9 / OSC 777).
+     */
+    onDesktopNotification?: (notification: DesktopNotification) => void;
     /**
      * Return active Kitty keyboard protocol flags (CSI ? u query result).
      */
@@ -160,6 +173,8 @@ export type InputHandler = {
     isFocusReporting: () => boolean;
     isAltScreen: () => boolean;
     isSynchronizedOutput: () => boolean;
+    isPromptClickEventsEnabled: () => boolean;
+    encodePromptClickEvent: (cell: CellPosition) => string;
     /**
      * Encode pointer input as terminal mouse events (SGR).
      */

package/dist/internal.js

@@ -89,7 +89,7 @@ import {
   updateComposition,
   updateGridState,
   updateImePosition
-} from "./chunk-d3xkkgrb.js";
+} from "./chunk-68qdtczc.js";
 // src/selection/selection.ts
 function createSelectionState() {
   return {

package/dist/restty.js

@@ -8,7 +8,7 @@ import {
   isBuiltinThemeName,
   listBuiltinThemeNames,
   parseGhosttyTheme
-} from "./chunk-d3xkkgrb.js";
+} from "./chunk-68qdtczc.js";
 export {
   parseGhosttyTheme,
   listBuiltinThemeNames,

package/dist/xterm.js

@@ -1,6 +1,6 @@
 import {
   createRestty
-} from "./chunk-d3xkkgrb.js";
+} from "./chunk-68qdtczc.js";
 
 // src/xterm.ts
 class Terminal {

package/package.json

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