@oh-my-pi/pi-wire 18.13.3 → 18.14.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [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

package/dist/types/tsp.d.ts

@@ -28,7 +28,7 @@ export declare const TSP_DEFAULT_CREDITS = 2;
 /** One-letter message verb. */
 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;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-wire",
-	"version": "18.13.3",
+	"version": "18.14.1",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://omp.sh",
 	"author": {
@@ -43,7 +43,6 @@
 		"README.md",
 		"CHANGELOG.md",
 		"LICENSE",
-		"THIRD-PARTY-NOTICES.txt",
 		"dist/types"
 	],
 	"exports": {

package/src/tsp.ts

@@ -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;