@oh-my-pi/pi-wire 18.4.8 → 18.4.9

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [18.4.9] - 2026-10-01
+
+### Added
+
+- Added terminal scrolling support through the TSP scroll operation, allowing keyboard scrolling of the terminal scroller when supported.
+- Added a terminal focus event for requesting keyboard focus on editors and inputs, or returning focus to the preferences sheet.
+
 ## [18.4.6] - 2026-10-01
 
 ### Added

package/dist/types/tsp.d.ts

@@ -878,7 +878,13 @@ export declare const TSP_REGION_IDS: {
     readonly dock: "dock";
     readonly layer: "layer";
 };
-export type TspOp = readonly [op: "add", id: string, parent: string, before: string | null, node: TspNode] | readonly [op: "set", id: string, props: Readonly<Record<string, unknown>>] | readonly [op: "text", id: string, mode: "append" | "replace", text: string] | readonly [op: "splice", id: string, at: number, del: number, text: string] | readonly [op: "move", id: string, parent: string, before: string | null] | readonly [op: "del", id: string] | readonly [op: "settle", id: string] | readonly [op: "focus", id: string | null] | readonly [op: "reveal", id: string, where: "start" | "end" | "nearest"] | readonly [op: "suspend"] | readonly [op: "resume"];
+export type TspOp = readonly [op: "add", id: string, parent: string, before: string | null, node: TspNode] | readonly [op: "set", id: string, props: Readonly<Record<string, unknown>>] | readonly [op: "text", id: string, mode: "append" | "replace", text: string] | readonly [op: "splice", id: string, at: number, del: number, text: string] | readonly [op: "move", id: string, parent: string, before: string | null] | readonly [op: "del", id: string] | readonly [op: "settle", id: string] | readonly [op: "focus", id: string | null] | readonly [op: "reveal", id: string, where: "start" | "end" | "nearest"] | readonly [op: "scroll", id: string, by: TspScrollBy] | readonly [op: "suspend"] | readonly [op: "resume"];
+/**
+ * How far a `scroll` op moves the scroller holding a node: a line, a
+ * viewport less a line, or to an end (`end` makes a following `ansi` block
+ * follow again). Sent only when `hello.features` lists `scroll`.
+ */
+export type TspScrollBy = "line-up" | "line-down" | "page-up" | "page-down" | "start" | "end";
 /** Verb `f`: an atomic batch of ops for one surface. */
 export interface TspFrame {
     /** Surface id. */
@@ -1019,6 +1025,16 @@ export type TspEvent = {
     text: string;
     cursor: number;
     len: number;
+}
+/**
+ * The user clicked into node `id` (an `editor`/`input` without the focus, or
+ * a `prefs` sheet while the focus is outside it): the program moves its
+ * keyboard focus there, or ignores it (a modal overlay keeps the keys).
+ */
+ | {
+    ev: "focus";
+    sf: string;
+    id: string;
 } | {
     ev: "error";
     sf?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-wire",
-	"version": "18.4.8",
+	"version": "18.4.9",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://omp.sh",
 	"author": {

package/src/tsp.ts

@@ -847,9 +847,17 @@ export type TspOp =
 	| readonly [op: "settle", id: string]
 	| readonly [op: "focus", id: string | null]
 	| readonly [op: "reveal", id: string, where: "start" | "end" | "nearest"]
+	| readonly [op: "scroll", id: string, by: TspScrollBy]
 	| readonly [op: "suspend"]
 	| readonly [op: "resume"];
 
+/**
+ * How far a `scroll` op moves the scroller holding a node: a line, a
+ * viewport less a line, or to an end (`end` makes a following `ansi` block
+ * follow again). Sent only when `hello.features` lists `scroll`.
+ */
+export type TspScrollBy = "line-up" | "line-down" | "page-up" | "page-down" | "start" | "end";
+
 /** Verb `f`: an atomic batch of ops for one surface. */
 export interface TspFrame {
 	/** Surface id. */
@@ -938,5 +946,11 @@ export type TspEvent =
 	 * text length the terminal saw, a mismatch makes the edit stale).
 	 */
 	| { ev: "edit"; sf: string; id: string; from: number; to: number; text: string; cursor: number; len: number }
+	/**
+	 * The user clicked into node `id` (an `editor`/`input` without the focus, or
+	 * a `prefs` sheet while the focus is outside it): the program moves its
+	 * keyboard focus there, or ignores it (a modal overlay keeps the keys).
+	 */
+	| { ev: "focus"; sf: string; id: string }
 	| { ev: "error"; sf?: string; s?: number; op?: number; msg: string }
 	| { ev: "gone"; sf?: string; ids: readonly string[] };