@oh-my-pi/pi-wire 18.4.5 → 18.4.6

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [18.4.6] - 2026-10-01
+
+### Added
+
+- Added the `TspMeterMark` component for marking a position on a meter track with a custom icon and a total value that defines the full span of the track.
+
 ## [18.4.4] - 2026-09-29
 
 ### Added

package/dist/types/tsp.d.ts

@@ -26,7 +26,7 @@ export declare const TSP_DEFAULT_CREDITS = 2;
 /** One-letter message verb. */
 export type TspVerb = "q" | "o" | "f" | "b" | "t" | "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", "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"];
+export declare const TSP_KINDS: readonly ["col", "row", "card", "section", "rule", "spacer", "text", "md", "code", "diff", "ansi", "math", "image", "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 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";
@@ -43,7 +43,9 @@ export type TspEffect = "shimmer" | "pulse" | "none";
  * One styled run of text. `s` holds space-separated semantic tokens
  * (`muted`, `dim`, `strong`, `em`, `accent`, `success`, `warning`, `error`,
  * `info`, `code`, `mono`, `path`, `key`, `link`, `num`, `ins`, `del`, `mark`,
- * `icon`, `hide`) or omp theme token names (`thinkingText`, `toolTitle`, …).
+ * `typo`, `icon`, `hide`) or omp theme token names (`thinkingText`,
+ * `toolTitle`, …). `mark` highlights (a match, the selected row); `typo` is a
+ * misspelled word, which the terminal underlines as its own spell checker does.
  * `icon` marks a run of icon glyphs (Nerd Font / Private Use Area codepoints):
  * the terminal draws it in its icon face and spaces it from neighbouring text
  * itself, so senders omit padding spaces around icons. `hide` takes the run
@@ -57,8 +59,11 @@ export interface TspSpan {
 }
 /** Text given either as one plain string or as styled spans. */
 export type TspText = string | readonly TspSpan[];
-/** What a pointer gesture on a node does. */
-export type TspAction = "toggle" | "copy" | "open" | "select" | "activate" | (string & {});
+/**
+ * What a pointer gesture on a node does. `zoom` shows an `image` (and the images
+ * beside it) large in the terminal's viewer; it is an image's click by default.
+ */
+export type TspAction = "toggle" | "copy" | "open" | "zoom" | "select" | "activate" | (string & {});
 /** Props every node accepts. */
 export interface TspCommonProps {
     role?: string;
@@ -86,7 +91,15 @@ export interface TspCommonProps {
     aria?: string;
     /** Target of an `open` action on this node (a URL or `file://` path). */
     href?: string;
+    /**
+     * Transient selection state drawn over the node without restyling it (the
+     * rewind page): `pick` marks the chosen point (adjacent picks read as one
+     * run), `drop` dims what the choice discards.
+     */
+    mark?: TspMark;
 }
+/** A {@link TspCommonProps.mark}. */
+export type TspMark = "pick" | "drop";
 export type TspWrap = "word" | "char" | "none";
 export type TspTruncate = "end" | "start" | "middle";
 export type TspCardStatus = "pending" | "running" | "done" | "error" | "cancelled";
@@ -182,9 +195,13 @@ export interface TspMathProps {
     text?: string;
     display?: boolean;
 }
+/** Images the terminal ships (`image.p.builtin`): `omp` is omp's gradient mark. */
+export type TspBuiltinImage = "omp";
 export interface TspImageProps {
     /** Content address (sha256 hex) of a blob sent with verb `b`. */
-    blob: string;
+    blob?: string;
+    /** An image the terminal ships, drawn instead of any blob. */
+    builtin?: TspBuiltinImage;
     alt?: string;
     w?: number;
     h?: number;
@@ -447,8 +464,11 @@ export interface TspPickerGroup {
  * selected item's preview. A picker under `layer` is itself the modal sheet.
  */
 export interface TspPickerProps {
-    /** What is being picked, e.g. "Models" (plain: it is also the common `title` prop, which a picker does not use as a tooltip). */
-    title: string;
+    /**
+     * What is being picked, e.g. "Models" (plain: it is also the common `title` prop, which a picker does not use as a
+     * tooltip). Absent: the head is the icon and the search, and the placeholder names the sheet.
+     */
+    title?: string;
     subtitle?: TspText;
     icon?: string;
     /** Plural noun for counts and empty copy ("models", "sessions"). */
@@ -723,12 +743,31 @@ export interface TspAgentProps {
     collapsible?: boolean;
     collapsed?: boolean;
 }
+/**
+ * A thinking-effort glyph: a small ring that fills rung by rung with the level and
+ * turns into a flickering fireball at `max`. Leaf; the terminal draws everything.
+ */
+export interface TspEffortProps {
+    /** `off`, `minimal`, `low`, `medium`, `high`, `xhigh` or `max`; anything else (e.g. `auto`) draws an empty dashed ring. */
+    level: string;
+}
+/**
+ * A tick on a meter's track (compaction threshold, speculation point). A bar mark's `icon`
+ * (a symbol name, e.g. `context.compaction`) sits on the track, which breaks for it.
+ */
+export interface TspMeterMark {
+    /** Position, 0–1. */
+    at: number;
+    tone?: TspTone;
+    title?: string;
+    icon?: string;
+}
 /** A value drawn as a bar, ring or block grid (§8.2): context %, usage windows, agent context. */
 export interface TspMeterProps {
     /** 0–1, or null for unknown. */
     value: number | null;
     style?: "bar" | "ring" | "blocks";
-    /** `blocks` only: exactly this many cells in one row, `round(value × steps)` of them filled (effort meter). */
+    /** `blocks` only: exactly this many cells in one row, `round(value × steps)` of them filled (e.g. the effort chip's fallback meter). */
     steps?: number;
     /** Stacked parts instead of one fill (context breakdown); values sum to ≤ 1. */
     parts?: readonly {
@@ -737,18 +776,16 @@ export interface TspMeterProps {
         label?: string;
         hatch?: boolean;
     }[];
-    /** Tick marks on the track (compaction threshold, speculation point). */
-    marks?: readonly {
-        at: number;
-        tone?: TspTone;
-        title?: string;
-    }[];
+    marks?: readonly TspMeterMark[];
     /** Tone switches: at or above `warn` → warning, `bad` → error. */
     thresholds?: {
         warn?: number;
         bad?: number;
     };
+    /** The value as text (`74%`). */
     label?: TspText;
+    /** The whole the track spans as text (a context window's `200K`). */
+    total?: TspText;
     size?: "sm" | "md" | "lg";
 }
 /** Series data drawn natively: the usage heatmap, app dashboards (§9.2). */
@@ -820,6 +857,7 @@ export interface TspPropsByKind {
     agent: TspAgentProps;
     chart: TspChartProps;
     meter: TspMeterProps;
+    effort: TspEffortProps;
 }
 /** Props of a node of kind `K`: its kind-specific props plus the common ones. */
 export type TspProps<K extends TspKind = TspKind> = TspPropsByKind[K] & TspCommonProps;
@@ -966,6 +1004,21 @@ export type TspEvent = {
     id: string;
     item: string;
     value: boolean | number | string | readonly string[] | null;
+}
+/**
+ * An edit over the terminal's selection in an `editor`/`input` node: replace
+ * `[from, to)` with `text`, caret to `cursor` (UTF-16 offsets; `len` is the
+ * 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;
 } | {
     ev: "error";
     sf?: string;

package/package.json

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

package/src/tsp.ts

@@ -75,6 +75,7 @@ export const TSP_KINDS = [
 	"agent",
 	"chart",
 	"meter",
+	"effort",
 ] as const;
 
 export type TspKind = (typeof TSP_KINDS)[number];
@@ -98,7 +99,9 @@ export type TspEffect = "shimmer" | "pulse" | "none";
  * One styled run of text. `s` holds space-separated semantic tokens
  * (`muted`, `dim`, `strong`, `em`, `accent`, `success`, `warning`, `error`,
  * `info`, `code`, `mono`, `path`, `key`, `link`, `num`, `ins`, `del`, `mark`,
- * `icon`, `hide`) or omp theme token names (`thinkingText`, `toolTitle`, …).
+ * `typo`, `icon`, `hide`) or omp theme token names (`thinkingText`,
+ * `toolTitle`, …). `mark` highlights (a match, the selected row); `typo` is a
+ * misspelled word, which the terminal underlines as its own spell checker does.
  * `icon` marks a run of icon glyphs (Nerd Font / Private Use Area codepoints):
  * the terminal draws it in its icon face and spaces it from neighbouring text
  * itself, so senders omit padding spaces around icons. `hide` takes the run
@@ -114,8 +117,11 @@ export interface TspSpan {
 /** Text given either as one plain string or as styled spans. */
 export type TspText = string | readonly TspSpan[];
 
-/** What a pointer gesture on a node does. */
-export type TspAction = "toggle" | "copy" | "open" | "select" | "activate" | (string & {});
+/**
+ * What a pointer gesture on a node does. `zoom` shows an `image` (and the images
+ * beside it) large in the terminal's viewer; it is an image's click by default.
+ */
+export type TspAction = "toggle" | "copy" | "open" | "zoom" | "select" | "activate" | (string & {});
 
 /** Props every node accepts. */
 export interface TspCommonProps {
@@ -134,8 +140,17 @@ export interface TspCommonProps {
 	aria?: string;
 	/** Target of an `open` action on this node (a URL or `file://` path). */
 	href?: string;
+	/**
+	 * Transient selection state drawn over the node without restyling it (the
+	 * rewind page): `pick` marks the chosen point (adjacent picks read as one
+	 * run), `drop` dims what the choice discards.
+	 */
+	mark?: TspMark;
 }
 
+/** A {@link TspCommonProps.mark}. */
+export type TspMark = "pick" | "drop";
+
 export type TspWrap = "word" | "char" | "none";
 export type TspTruncate = "end" | "start" | "middle";
 export type TspCardStatus = "pending" | "running" | "done" | "error" | "cancelled";
@@ -227,9 +242,13 @@ export interface TspMathProps {
 	text?: string;
 	display?: boolean;
 }
+/** Images the terminal ships (`image.p.builtin`): `omp` is omp's gradient mark. */
+export type TspBuiltinImage = "omp";
 export interface TspImageProps {
 	/** Content address (sha256 hex) of a blob sent with verb `b`. */
-	blob: string;
+	blob?: string;
+	/** An image the terminal ships, drawn instead of any blob. */
+	builtin?: TspBuiltinImage;
 	alt?: string;
 	w?: number;
 	h?: number;
@@ -464,8 +483,11 @@ export interface TspPickerGroup {
  * selected item's preview. A picker under `layer` is itself the modal sheet.
  */
 export interface TspPickerProps {
-	/** What is being picked, e.g. "Models" (plain: it is also the common `title` prop, which a picker does not use as a tooltip). */
-	title: string;
+	/**
+	 * What is being picked, e.g. "Models" (plain: it is also the common `title` prop, which a picker does not use as a
+	 * tooltip). Absent: the head is the icon and the search, and the placeholder names the sheet.
+	 */
+	title?: string;
 	subtitle?: TspText;
 	icon?: string;
 	/** Plural noun for counts and empty copy ("models", "sessions"). */
@@ -692,20 +714,43 @@ export interface TspAgentProps {
 	collapsed?: boolean;
 }
 
+/**
+ * A thinking-effort glyph: a small ring that fills rung by rung with the level and
+ * turns into a flickering fireball at `max`. Leaf; the terminal draws everything.
+ */
+export interface TspEffortProps {
+	/** `off`, `minimal`, `low`, `medium`, `high`, `xhigh` or `max`; anything else (e.g. `auto`) draws an empty dashed ring. */
+	level: string;
+}
+
+/**
+ * A tick on a meter's track (compaction threshold, speculation point). A bar mark's `icon`
+ * (a symbol name, e.g. `context.compaction`) sits on the track, which breaks for it.
+ */
+export interface TspMeterMark {
+	/** Position, 0–1. */
+	at: number;
+	tone?: TspTone;
+	title?: string;
+	icon?: string;
+}
+
 /** A value drawn as a bar, ring or block grid (§8.2): context %, usage windows, agent context. */
 export interface TspMeterProps {
 	/** 0–1, or null for unknown. */
 	value: number | null;
 	style?: "bar" | "ring" | "blocks";
-	/** `blocks` only: exactly this many cells in one row, `round(value × steps)` of them filled (effort meter). */
+	/** `blocks` only: exactly this many cells in one row, `round(value × steps)` of them filled (e.g. the effort chip's fallback meter). */
 	steps?: number;
 	/** Stacked parts instead of one fill (context breakdown); values sum to ≤ 1. */
 	parts?: readonly { value: number; token?: string; label?: string; hatch?: boolean }[];
-	/** Tick marks on the track (compaction threshold, speculation point). */
-	marks?: readonly { at: number; tone?: TspTone; title?: string }[];
+	marks?: readonly TspMeterMark[];
 	/** Tone switches: at or above `warn` → warning, `bad` → error. */
 	thresholds?: { warn?: number; bad?: number };
+	/** The value as text (`74%`). */
 	label?: TspText;
+	/** The whole the track spans as text (a context window's `200K`). */
+	total?: TspText;
 	size?: "sm" | "md" | "lg";
 }
 /** Series data drawn natively: the usage heatmap, app dashboards (§9.2). */
@@ -771,6 +816,7 @@ export interface TspPropsByKind {
 	agent: TspAgentProps;
 	chart: TspChartProps;
 	meter: TspMeterProps;
+	effort: TspEffortProps;
 }
 
 /** Props of a node of kind `K`: its kind-specific props plus the common ones. */
@@ -886,5 +932,11 @@ export type TspEvent =
 			item: string;
 			value: boolean | number | string | readonly string[] | null;
 	  }
+	/**
+	 * An edit over the terminal's selection in an `editor`/`input` node: replace
+	 * `[from, to)` with `text`, caret to `cursor` (UTF-16 offsets; `len` is the
+	 * 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 }
 	| { ev: "error"; sf?: string; s?: number; op?: number; msg: string }
 	| { ev: "gone"; sf?: string; ids: readonly string[] };