restty 0.1.23 → 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-mkkhfg0z.js → chunk-68qdtczc.js}

@@ -8576,6 +8576,7 @@ class OutputFilter {
   clipboardWrite;
   clipboardRead;
   getDefaultColors;
+  desktopNotificationHandler;
   semanticPromptSeen = false;
   promptClickEvents = false;
   promptInputActive = false;
@@ -8589,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;
@@ -8696,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(";");
@@ -8904,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,
@@ -51508,7 +51544,8 @@ function createResttyApp(options) {
     },
     onWindowOp: (op) => {
       appendLog(`[term] window op ${op.type} ${op.params.join(";")}`);
-    }
+    },
+    onDesktopNotification: callbacks?.onDesktopNotification
   });
   inputHandler.setMouseMode("auto");
   function clearSelection() {
@@ -56858,6 +56895,7 @@ class Restty {
       createInitialPane = true,
       appOptions,
       fontSources,
+      onDesktopNotification,
       onPaneCreated,
       onPaneClosed,
       onPaneSplit,
@@ -56870,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 { CellPosition, 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,7 @@ export declare class OutputFilter {
     private clipboardWrite?;
     private clipboardRead?;
     private getDefaultColors?;
+    private desktopNotificationHandler?;
     private semanticPromptSeen;
     private promptClickEvents;
     private promptInputActive;

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).
      */

package/dist/internal.js

@@ -89,7 +89,7 @@ import {
   updateComposition,
   updateGridState,
   updateImePosition
-} from "./chunk-mkkhfg0z.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-mkkhfg0z.js";
+} from "./chunk-68qdtczc.js";
 export {
   parseGhosttyTheme,
   listBuiltinThemeNames,

package/dist/xterm.js

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

package/package.json

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