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

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [18.14.2] - 2026-10-31
+
+### Added
+
+- Added `nums` to `code` props (`TspCodeProps`): each line's number, so one block can show non-contiguous lines with `…` gap rows where the numbers jump.
+- Added the TSP `button` kind (`TspButtonProps`: label, icon, keycaps, `default`/`primary`/`quiet`/`danger` variants, `sm`/`md` sizes, pressed, disabled with a reason, busy) and `tabs` `variant: "segmented"`.
+
 ## [18.14.0] - 2026-10-29
 
 ### Added

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", "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 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", "button", "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";
@@ -176,7 +176,15 @@ export interface TspCodeProps {
     lang?: string;
     /** The file the text comes from: the terminal picks the grammar from it (and heads a block outside a tool card with it). */
     path?: string;
+    /** The first line's number; later lines count up from it. */
     start?: number;
+    /**
+     * Each line's number (one per line of `text`, strictly ascending), for non-contiguous lines: replaces counting from
+     * `start`, and a `…` gap row is drawn before every line whose number is not the previous one's + 1. Marks' `line` and
+     * folds' `from`/`to` are in this numbering. Ignored (numbers count from `start`) when its length differs from the
+     * text's line count or it is not strictly ascending.
+     */
+    nums?: readonly number[];
     numbers?: boolean;
     marks?: readonly {
         line: number;
@@ -355,6 +363,29 @@ export interface TspTabsProps {
         label: TspText;
     }[];
     active?: string;
+    /** `underline` (default): an accent underline under the active tab; `segmented`: a well with a raised thumb. */
+    variant?: "underline" | "segmented";
+}
+/**
+ * A push button. A click sends an `action` event with `actions.click` (else
+ * `click`); a disabled or busy button sends nothing. It never takes focus.
+ */
+export interface TspButtonProps {
+    /** Label; empty with an `icon` draws an icon-only button (give it a `title` or `aria`). */
+    text?: string;
+    /** Leading icon name. */
+    icon?: string;
+    /** Keycaps drawn after the label (the key names of `kbd`); display only. */
+    keys?: readonly string[];
+    variant?: "default" | "primary" | "quiet" | "danger";
+    /** `md` 28px (bars, heads, forms), `sm` 22px (inline, rows). */
+    size?: "sm" | "md";
+    /** A pressed toggle. */
+    on?: boolean;
+    /** Dimmed and inert; a string is the reason, shown as the tooltip. */
+    disabled?: boolean | string;
+    /** A spinner in the icon's place; inert. */
+    busy?: boolean;
 }
 export interface TspEditorDecoration {
     from: number;
@@ -932,6 +963,7 @@ export interface TspPropsByKind {
     tabs: TspTabsProps;
     editor: TspEditorProps;
     input: TspInputProps;
+    button: TspButtonProps;
     status: TspStatusProps;
     seg: TspSegProps;
     overlay: TspOverlayProps;

package/package.json

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

package/src/tsp.ts

@@ -67,6 +67,7 @@ export const TSP_KINDS = [
 	"tabs",
 	"editor",
 	"input",
+	"button",
 	"status",
 	"seg",
 	"overlay",
@@ -228,7 +229,15 @@ export interface TspCodeProps {
 	lang?: string;
 	/** The file the text comes from: the terminal picks the grammar from it (and heads a block outside a tool card with it). */
 	path?: string;
+	/** The first line's number; later lines count up from it. */
 	start?: number;
+	/**
+	 * Each line's number (one per line of `text`, strictly ascending), for non-contiguous lines: replaces counting from
+	 * `start`, and a `…` gap row is drawn before every line whose number is not the previous one's + 1. Marks' `line` and
+	 * folds' `from`/`to` are in this numbering. Ignored (numbers count from `start`) when its length differs from the
+	 * text's line count or it is not strictly ascending.
+	 */
+	nums?: readonly number[];
 	numbers?: boolean;
 	marks?: readonly { line: number; tone: TspTone }[];
 	wrap?: boolean;
@@ -383,6 +392,29 @@ export interface TspItemProps {
 export interface TspTabsProps {
 	items: readonly { id: string; label: TspText }[];
 	active?: string;
+	/** `underline` (default): an accent underline under the active tab; `segmented`: a well with a raised thumb. */
+	variant?: "underline" | "segmented";
+}
+/**
+ * A push button. A click sends an `action` event with `actions.click` (else
+ * `click`); a disabled or busy button sends nothing. It never takes focus.
+ */
+export interface TspButtonProps {
+	/** Label; empty with an `icon` draws an icon-only button (give it a `title` or `aria`). */
+	text?: string;
+	/** Leading icon name. */
+	icon?: string;
+	/** Keycaps drawn after the label (the key names of `kbd`); display only. */
+	keys?: readonly string[];
+	variant?: "default" | "primary" | "quiet" | "danger";
+	/** `md` 28px (bars, heads, forms), `sm` 22px (inline, rows). */
+	size?: "sm" | "md";
+	/** A pressed toggle. */
+	on?: boolean;
+	/** Dimmed and inert; a string is the reason, shown as the tooltip. */
+	disabled?: boolean | string;
+	/** A spinner in the icon's place; inert. */
+	busy?: boolean;
 }
 export interface TspEditorDecoration {
 	from: number;
@@ -897,6 +929,7 @@ export interface TspPropsByKind {
 	tabs: TspTabsProps;
 	editor: TspEditorProps;
 	input: TspInputProps;
+	button: TspButtonProps;
 	status: TspStatusProps;
 	seg: TspSegProps;
 	overlay: TspOverlayProps;