@oh-my-pi/pi-wire 18.13.2 → 18.14.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [18.14.0] - 2026-10-29
+
+### Added
+
+- Added the TSP `json` kind for displaying raw JSON values as interactive, expandable trees in the terminal.
+- Added `TspEditorProps.typeahead` support so programs that cannot yet read input can preserve typed text, display it at the caret, and submit it when input becomes available.
+
+## [18.13.3] - 2026-10-28
+
+### Changed
+
+- Updated Bun engine requirement to ≥1.4.4
+
+### Removed
+
+- Removed `TspPalette` definition and `t` verb from the protocol specification
+
 ## [18.12.3] - 2026-10-19
 
 ### Added

package/dist/types/tsp.d.ts

@@ -26,9 +26,9 @@ export declare const TSP_DEFAULT_APC_LIMIT = 65536;
 /** Unacknowledged frames a sender may have in flight unless the hello reply says otherwise. */
 export declare const TSP_DEFAULT_CREDITS = 2;
 /** One-letter message verb. */
-export type TspVerb = "q" | "o" | "f" | "b" | "t" | "x" | "r" | "e";
+export type TspVerb = "q" | "o" | "f" | "b" | "x" | "r" | "e";
 /** Every component kind in the v1 vocabulary. */
-export declare const TSP_KINDS: readonly ["col", "row", "card", "section", "rule", "spacer", "text", "md", "code", "diff", "ansi", "math", "image", "media", "kv", "table", "tree", "badge", "kbd", "icon", "spinner", "shimmer", "elapsed", "progress", "rate", "list", "item", "tabs", "editor", "input", "status", "seg", "overlay", "toast", "rows", "picker", "prefs", "tool", "checklist", "agent", "chart", "meter", "effort"];
+export declare const TSP_KINDS: readonly ["col", "row", "card", "section", "rule", "spacer", "text", "md", "code", "diff", "ansi", "math", "image", "media", "kv", "table", "tree", "json", "badge", "kbd", "icon", "spinner", "shimmer", "elapsed", "progress", "rate", "list", "item", "tabs", "editor", "input", "status", "seg", "overlay", "toast", "rows", "picker", "prefs", "tool", "checklist", "agent", "chart", "meter", "effort"];
 export type TspKind = (typeof TSP_KINDS)[number];
 /** Semantic colour of a node's chrome. */
 export type TspTone = "neutral" | "accent" | "info" | "success" | "warning" | "error" | "pending" | "muted" | "user";
@@ -104,8 +104,10 @@ export interface TspCommonProps {
      * right after another tooltip or card), anchored below it (above without
      * room) and clamped to the window. It stays open while the pointer is over
      * the node or the card, closes on leave (short grace), press, key or scroll,
-     * and replaces the node's `title` tooltip while open. Terminals that don't
-     * know it ignore it and keep showing `title`.
+     * and replaces the node's `title` tooltip while open. A lone `md` card is a
+     * wide read-only preview the pointer passes through (open only over the
+     * node). On an `agent` it opens over the row, not the children. Terminals
+     * that don't know it ignore it and keep showing `title`.
      */
     hovercard?: TspPropNode;
 }
@@ -277,6 +279,20 @@ export interface TspTreeNode {
 export interface TspTreeProps {
     nodes: readonly TspTreeNode[];
 }
+/**
+ * A raw JSON value the terminal draws as an interactive tree: small containers
+ * whole on one row, larger ones folded to a preview that expands on click.
+ * Folding is local to the terminal and sends no events.
+ */
+export interface TspJsonProps {
+    /** Any JSON value; absent reads as null. */
+    value: unknown;
+    /**
+     * Levels of containers expanded below the top-level entries (default 0:
+     * the root's entries listed, every container among them folded).
+     */
+    open?: number;
+}
 export interface TspBadgeProps {
     text: string;
 }
@@ -367,6 +383,9 @@ export interface TspEditorProps {
      *  Independent of text editability or keyboard focus; absent or false is not ready. */
     sendable?: boolean;
     maxLines?: number;
+    /** The program cannot read input yet: while the field has the focus, the terminal keeps
+     *  what is typed into it, draws it at the caret, and sends it once this clears. */
+    typeahead?: boolean;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
 export interface TspStatusProps {
@@ -899,6 +918,7 @@ export interface TspPropsByKind {
     kv: TspKvProps;
     table: TspTableProps;
     tree: TspTreeProps;
+    json: TspJsonProps;
     badge: TspBadgeProps;
     kbd: TspKbdProps;
     icon: TspIconProps;
@@ -990,23 +1010,6 @@ export interface TspClose {
     /** Keep `main` in scrollback (true) or remove the surface (false). */
     keep: boolean;
 }
-/**
- * Verb `t`: the program's resolved theme for a surface, sent after `o` and
- * before its first `f`, and again whenever the theme or variant changes.
- * Each variant maps token names to `#rrggbb`; tokens left at the terminal
- * default are omitted. A program with one variant sends only that one.
- */
-export interface TspPalette {
-    /** Surface id. */
-    sf: string;
-    dark?: Readonly<Record<string, string>>;
-    light?: Readonly<Record<string, string>>;
-    /** Theme names behind each variant. */
-    name?: {
-        dark?: string;
-        light?: string;
-    };
-}
 /** Verb `q`. */
 export type TspQuery = {
     q: "hello";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-wire",
-	"version": "18.13.2",
+	"version": "18.14.0",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -36,14 +36,13 @@
 		"@types/bun": "^1.3.14"
 	},
 	"engines": {
-		"bun": ">=1.3.14"
+		"bun": ">=1.4.4"
 	},
 	"files": [
 		"src",
 		"README.md",
 		"CHANGELOG.md",
 		"LICENSE",
-		"THIRD-PARTY-NOTICES.txt",
 		"dist/types"
 	],
 	"exports": {

package/src/tsp.ts

@@ -28,7 +28,7 @@ export const TSP_DEFAULT_APC_LIMIT = 65_536;
 export const TSP_DEFAULT_CREDITS = 2;
 
 /** One-letter message verb. */
-export type TspVerb = "q" | "o" | "f" | "b" | "t" | "x" | "r" | "e";
+export type TspVerb = "q" | "o" | "f" | "b" | "x" | "r" | "e";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Vocabulary
@@ -53,6 +53,7 @@ export const TSP_KINDS = [
 	"kv",
 	"table",
 	"tree",
+	"json",
 	"badge",
 	"kbd",
 	"icon",
@@ -154,8 +155,10 @@ export interface TspCommonProps {
 	 * right after another tooltip or card), anchored below it (above without
 	 * room) and clamped to the window. It stays open while the pointer is over
 	 * the node or the card, closes on leave (short grace), press, key or scroll,
-	 * and replaces the node's `title` tooltip while open. Terminals that don't
-	 * know it ignore it and keep showing `title`.
+	 * and replaces the node's `title` tooltip while open. A lone `md` card is a
+	 * wide read-only preview the pointer passes through (open only over the
+	 * node). On an `agent` it opens over the row, not the children. Terminals
+	 * that don't know it ignore it and keep showing `title`.
 	 */
 	hovercard?: TspPropNode;
 }
@@ -313,6 +316,20 @@ export interface TspTreeNode {
 export interface TspTreeProps {
 	nodes: readonly TspTreeNode[];
 }
+/**
+ * A raw JSON value the terminal draws as an interactive tree: small containers
+ * whole on one row, larger ones folded to a preview that expands on click.
+ * Folding is local to the terminal and sends no events.
+ */
+export interface TspJsonProps {
+	/** Any JSON value; absent reads as null. */
+	value: unknown;
+	/**
+	 * Levels of containers expanded below the top-level entries (default 0:
+	 * the root's entries listed, every container among them folded).
+	 */
+	open?: number;
+}
 export interface TspBadgeProps {
 	text: string;
 }
@@ -394,6 +411,9 @@ export interface TspEditorProps {
 	 *  Independent of text editability or keyboard focus; absent or false is not ready. */
 	sendable?: boolean;
 	maxLines?: number;
+	/** The program cannot read input yet: while the field has the focus, the terminal keeps
+	 *  what is typed into it, draws it at the caret, and sends it once this clears. */
+	typeahead?: boolean;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
 export interface TspStatusProps {
@@ -863,6 +883,7 @@ export interface TspPropsByKind {
 	kv: TspKvProps;
 	table: TspTableProps;
 	tree: TspTreeProps;
+	json: TspJsonProps;
 	badge: TspBadgeProps;
 	kbd: TspKbdProps;
 	icon: TspIconProps;
@@ -969,21 +990,6 @@ export interface TspClose {
 	keep: boolean;
 }
 
-/**
- * Verb `t`: the program's resolved theme for a surface, sent after `o` and
- * before its first `f`, and again whenever the theme or variant changes.
- * Each variant maps token names to `#rrggbb`; tokens left at the terminal
- * default are omitted. A program with one variant sends only that one.
- */
-export interface TspPalette {
-	/** Surface id. */
-	sf: string;
-	dark?: Readonly<Record<string, string>>;
-	light?: Readonly<Record<string, string>>;
-	/** Theme names behind each variant. */
-	name?: { dark?: string; light?: string };
-}
-
 /** Verb `q`. */
 export type TspQuery =
 	| { q: "hello"; v: readonly number[]; app: string; ver?: string; features?: readonly string[] }