@linxiraos/pi-wire 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [1.4.1] - 2026-10-23
+
+- Version alignment with the 1.4.1 release line (no behavioral changes).
+
 ## [1.4.0] - 2026-10-21
 
 - Version line moves to 1.4.0 with the rest of the suite; no user-visible change in this package.

package/dist/types/tsp.d.ts

@@ -99,6 +99,15 @@ export interface TspCommonProps {
      * run), `drop` dims what the choice discards.
      */
     mark?: TspMark;
+    /**
+     * A floating card shown when the pointer rests on the node (~350 ms; ~200 ms
+     * 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`.
+     */
+    hovercard?: TspPropNode;
 }
 /** A {@link TspCommonProps.mark}. */
 export type TspMark = "pick" | "drop";
@@ -828,6 +837,14 @@ export interface TspMeterProps {
     total?: TspText;
     size?: "sm" | "md" | "lg";
 }
+/** A horizontal reference line across a bars/spark chart (a target, a baseline). */
+export interface TspChartMark {
+    /** Position in the series' value units. */
+    value: number;
+    tone?: TspTone;
+    /** Tooltip of the line (`target 200 tok/s`). */
+    title?: string;
+}
 /** Series data drawn natively: the usage heatmap, app dashboards (§9.2). */
 export interface TspChartProps {
     kind: "heatmap" | "bars" | "spark";
@@ -842,12 +859,21 @@ export interface TspChartProps {
     rows?: readonly string[];
     /** Per-cell tooltips, same shape as `cells` (omit for none). */
     tips?: readonly (readonly (string | null)[])[];
-    /** bars/spark: one series. */
+    /** bars/spark: one series; `tone` fills that one column instead of `token`. */
     series?: readonly {
         label?: string;
         value: number;
         title?: string;
+        tone?: TspTone;
     }[];
+    /**
+     * bars/spark: fixed value domain. Without them the low end is 0 and the
+     * high end the largest series or mark value.
+     */
+    min?: number;
+    max?: number;
+    /** bars/spark: dashed horizontal reference lines, in value units. */
+    marks?: readonly TspChartMark[];
     /** Colour token of the fill (`accent`, `statusLineCost`). */
     token?: string;
     summary?: TspText;
@@ -900,8 +926,24 @@ export interface TspPropsByKind {
     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;
+/**
+ * Props of a node of kind `K`: its kind-specific props plus the common ones.
+ * A chart's numeric `min`/`max` (its value domain) take the place of the
+ * common layout `min`/`max` extents.
+ */
+export type TspProps<K extends TspKind = TspKind> = [K] extends ["chart"] ? TspChartProps & Omit<TspCommonProps, "min" | "max"> : TspPropsByKind[K] & TspCommonProps;
+/**
+ * A node tree carried inside a prop (a {@link TspCommonProps.hovercard}): a
+ * wire node without ids, mounted by the terminal on demand. `key` is ignored.
+ */
+export type TspPropNode = {
+    [K in TspKind]: {
+        k: K;
+        p?: TspProps<K>;
+        c?: readonly TspPropNode[];
+        key?: string;
+    };
+}[TspKind];
 /** Kinds whose primary text the `text` and `splice` ops address (the `text` prop). */
 export declare const TSP_TEXT_KINDS: readonly ["text", "md", "code", "ansi", "math", "editor", "input", "shimmer"];
 /** A node on the wire. */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-wire",
-	"version": "1.4.0",
+	"version": "1.4.1",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Can Boluk",

package/src/tsp.ts

@@ -149,6 +149,15 @@ export interface TspCommonProps {
 	 * run), `drop` dims what the choice discards.
 	 */
 	mark?: TspMark;
+	/**
+	 * A floating card shown when the pointer rests on the node (~350 ms; ~200 ms
+	 * 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`.
+	 */
+	hovercard?: TspPropNode;
 }
 
 /** A {@link TspCommonProps.mark}. */
@@ -798,6 +807,15 @@ export interface TspMeterProps {
 	total?: TspText;
 	size?: "sm" | "md" | "lg";
 }
+/** A horizontal reference line across a bars/spark chart (a target, a baseline). */
+export interface TspChartMark {
+	/** Position in the series' value units. */
+	value: number;
+	tone?: TspTone;
+	/** Tooltip of the line (`target 200 tok/s`). */
+	title?: string;
+}
+
 /** Series data drawn natively: the usage heatmap, app dashboards (§9.2). */
 export interface TspChartProps {
 	kind: "heatmap" | "bars" | "spark";
@@ -809,8 +827,16 @@ export interface TspChartProps {
 	rows?: readonly string[];
 	/** Per-cell tooltips, same shape as `cells` (omit for none). */
 	tips?: readonly (readonly (string | null)[])[];
-	/** bars/spark: one series. */
-	series?: readonly { label?: string; value: number; title?: string }[];
+	/** bars/spark: one series; `tone` fills that one column instead of `token`. */
+	series?: readonly { label?: string; value: number; title?: string; tone?: TspTone }[];
+	/**
+	 * bars/spark: fixed value domain. Without them the low end is 0 and the
+	 * high end the largest series or mark value.
+	 */
+	min?: number;
+	max?: number;
+	/** bars/spark: dashed horizontal reference lines, in value units. */
+	marks?: readonly TspChartMark[];
 	/** Colour token of the fill (`accent`, `statusLineCost`). */
 	token?: string;
 	summary?: TspText;
@@ -865,8 +891,22 @@ export interface TspPropsByKind {
 	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;
+/**
+ * Props of a node of kind `K`: its kind-specific props plus the common ones.
+ * A chart's numeric `min`/`max` (its value domain) take the place of the
+ * common layout `min`/`max` extents.
+ */
+export type TspProps<K extends TspKind = TspKind> = [K] extends ["chart"]
+	? TspChartProps & Omit<TspCommonProps, "min" | "max">
+	: TspPropsByKind[K] & TspCommonProps;
+
+/**
+ * A node tree carried inside a prop (a {@link TspCommonProps.hovercard}): a
+ * wire node without ids, mounted by the terminal on demand. `key` is ignored.
+ */
+export type TspPropNode = {
+	[K in TspKind]: { k: K; p?: TspProps<K>; c?: readonly TspPropNode[]; key?: string };
+}[TspKind];
 
 /** Kinds whose primary text the `text` and `splice` ops address (the `text` prop). */
 export const TSP_TEXT_KINDS = ["text", "md", "code", "ansi", "math", "editor", "input", "shimmer"] as const;