@oh-my-pi/pi-wire 18.10.0 → 18.10.2

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [18.10.2] - 2026-10-12
+
+### Added
+
+- Added `TspPickerMark.icon`: an icon a picker mark draws instead of its initials when the terminal has it (`provider:<id>` names a model provider's logo)
+
 ## [18.8.8] - 2026-10-10
 
 ### Added

package/THIRD-PARTY-NOTICES.txt

@@ -79,9 +79,9 @@ uutils coreutils (https://github.com/uutils/coreutils), MIT
 --------------------------------------------------------------------------------
 Covers: base32, base64, basename, cat, cksum (shared checksum machinery),
 b2sum, md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, comm, cp,
-cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nproc, paste,
-printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee, touch, tr,
-truncate, uname, uniq, wc, whoami, yes.
+cut, date, dirname, head, hostname, ln, ls, mkdir, mktemp, mv, nl, nproc,
+paste, printenv, readlink, realpath, rm, seq, sort, stat, tac, tail, tee,
+touch, tr, truncate, uname, uniq, wc, whoami, yes.
 
   Copyright (c) uutils developers
 

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" | "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", "effort"];
+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 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";
@@ -114,7 +114,7 @@ export interface TspColProps {
 }
 export interface TspRowProps {
     gap?: TspSpace;
-    align?: "start" | "center" | "baseline" | "end";
+    align?: "start" | "center" | "baseline" | "end" | "stretch";
     justify?: "start" | "between" | "end";
     wrap?: boolean;
 }
@@ -214,6 +214,23 @@ export interface TspImageProps {
         h?: TspExtent;
     };
 }
+/**
+ * A file the terminal loads by path and shows in its media viewer (pictures, SVG, 3D models,
+ * PDF/video/audio, else a card). Programs check `cx.supports("media")` first.
+ */
+export interface TspMediaProps {
+    /** The file: absolute, or relative to the pane's working directory. */
+    path: string;
+    /** Git revision to read instead of the disk file: a commit-ish (`HEAD`, a sha) or `:0` for the index. */
+    rev?: string;
+    /** `media` nodes of one surface sharing this name pan and zoom together (before/after compare). */
+    link?: string;
+    /** Size cap; the node otherwise fills its container. */
+    max?: {
+        w?: TspExtent;
+        h?: TspExtent;
+    };
+}
 export interface TspKvProps {
     items: readonly {
         k: TspText;
@@ -385,10 +402,7 @@ export interface TspPickerItem {
     detail?: TspText;
     /** Leading visual: a named icon, a provider/avatar mark, or a status dot. */
     icon?: string;
-    mark?: {
-        text: string;
-        seed?: string;
-    };
+    mark?: TspPickerMark;
     dot?: TspTone;
     /** Label is a machine string (model id, path): mono, dim prefix and strong tail by the `/`. */
     mono?: boolean;
@@ -419,6 +433,16 @@ export interface TspPickerItem {
     role?: string;
     title?: string;
 }
+/**
+ * A picker avatar: the `icon` when the terminal has it (`provider:<id>` names a
+ * model provider's logo by its id), else up to two initials of `text` on a
+ * gradient picked by `seed` (default `text`).
+ */
+export interface TspPickerMark {
+    text: string;
+    seed?: string;
+    icon?: string;
+}
 /** A right-aligned fact column in a picker. */
 export interface TspPickerColumn {
     id: string;
@@ -435,10 +459,7 @@ export interface TspPickerScope {
     id: string;
     label: TspText;
     icon?: string;
-    mark?: {
-        text: string;
-        seed?: string;
-    };
+    mark?: TspPickerMark;
     count?: number;
     /** Group heading this scope sits under (consecutive scopes with the same group share a head). */
     group?: string;
@@ -844,6 +865,7 @@ export interface TspPropsByKind {
     ansi: TspAnsiProps;
     math: TspMathProps;
     image: TspImageProps;
+    media: TspMediaProps;
     kv: TspKvProps;
     table: TspTableProps;
     tree: TspTreeProps;

package/package.json

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

package/src/tsp.ts

@@ -49,6 +49,7 @@ export const TSP_KINDS = [
 	"ansi",
 	"math",
 	"image",
+	"media",
 	"kv",
 	"table",
 	"tree",
@@ -164,7 +165,7 @@ export interface TspColProps {
 }
 export interface TspRowProps {
 	gap?: TspSpace;
-	align?: "start" | "center" | "baseline" | "end";
+	align?: "start" | "center" | "baseline" | "end" | "stretch";
 	justify?: "start" | "between" | "end";
 	wrap?: boolean;
 }
@@ -258,6 +259,20 @@ export interface TspImageProps {
 	h?: number;
 	max?: { w?: TspExtent; h?: TspExtent };
 }
+/**
+ * A file the terminal loads by path and shows in its media viewer (pictures, SVG, 3D models,
+ * PDF/video/audio, else a card). Programs check `cx.supports("media")` first.
+ */
+export interface TspMediaProps {
+	/** The file: absolute, or relative to the pane's working directory. */
+	path: string;
+	/** Git revision to read instead of the disk file: a commit-ish (`HEAD`, a sha) or `:0` for the index. */
+	rev?: string;
+	/** `media` nodes of one surface sharing this name pan and zoom together (before/after compare). */
+	link?: string;
+	/** Size cap; the node otherwise fills its container. */
+	max?: { w?: TspExtent; h?: TspExtent };
+}
 export interface TspKvProps {
 	items: readonly { k: TspText; v: TspText }[];
 	layout?: "grid" | "inline";
@@ -414,7 +429,7 @@ export interface TspPickerItem {
 	detail?: TspText;
 	/** Leading visual: a named icon, a provider/avatar mark, or a status dot. */
 	icon?: string;
-	mark?: { text: string; seed?: string };
+	mark?: TspPickerMark;
 	dot?: TspTone;
 	/** Label is a machine string (model id, path): mono, dim prefix and strong tail by the `/`. */
 	mono?: boolean;
@@ -437,6 +452,17 @@ export interface TspPickerItem {
 	title?: string;
 }
 
+/**
+ * A picker avatar: the `icon` when the terminal has it (`provider:<id>` names a
+ * model provider's logo by its id), else up to two initials of `text` on a
+ * gradient picked by `seed` (default `text`).
+ */
+export interface TspPickerMark {
+	text: string;
+	seed?: string;
+	icon?: string;
+}
+
 /** A right-aligned fact column in a picker. */
 export interface TspPickerColumn {
 	id: string;
@@ -454,7 +480,7 @@ export interface TspPickerScope {
 	id: string;
 	label: TspText;
 	icon?: string;
-	mark?: { text: string; seed?: string };
+	mark?: TspPickerMark;
 	count?: number;
 	/** Group heading this scope sits under (consecutive scopes with the same group share a head). */
 	group?: string;
@@ -803,6 +829,7 @@ export interface TspPropsByKind {
 	ansi: TspAnsiProps;
 	math: TspMathProps;
 	image: TspImageProps;
+	media: TspMediaProps;
 	kv: TspKvProps;
 	table: TspTableProps;
 	tree: TspTreeProps;