@linxiraos/pi-wire 1.1.26 → 1.2.0

package/CHANGELOG.md

@@ -1,7 +1,15 @@
-# Changelog
-
 ## [Unreleased]
 
+## [1.2.0] - 2026-10-12
+
+### Added
+
+- Added `TspToolProps.command` (the command line Copy command copies), `TspToolProps.preview: "children"` (the collapsed body stays whole while its children clamp) and `TspCodeProps.preview`
+
+### Changed
+
+- Updated `TspEditorProps.placeholder` and `TspInputProps.placeholder` to accept `TspText`, enabling styled placeholder text.
+
 ## [1.1.26] - 2026-10-03
 
 - 版本线推进至 1.1.26；本版无独立用户可见变化。
@@ -72,24 +80,6 @@
 
 - 同步 1.1.4 发布线（与 1.1.3 无功能差异）。
 
-## [1.1.3] - 2026-08-25
-
-### Fixed
-
-- Republished as 1.1.3 to reset the latest tag after the broken 1.1.2 (no functional change over 1.1.1).
-
-## [1.1.2] - 2026-08-25
-
-### Fixed
-
-- Republished as 1.1.2 to reset the `latest` tag after the broken 1.1.0 (no functional change over 1.1.1).
-
-## [1.1.1] - 2026-08-25
-
-### Fixed
-
-- Published tarballs now carry real dependency versions instead of Bun's `catalog:` protocol (1.1.0 installs failed with "Unsupported URL Type catalog:").
-
 ## [1.1.0] - 2026-08-25
 
 ### Changed

package/dist/types/skillshare.d.ts

@@ -1,6 +1,6 @@
 /**
  * Wire contract for Skillshare (`skills.omp.sh`): an npm-style registry for
- * omp skills. Shared by the omp CLI (`omp skill …`), the Go server
+ * zetacode skills. Shared by the omp CLI (`zetacode skill …`), the Go server
  * (`stencil/apps/skills`), and its web UI (which mirrors this file).
  *
  * Packages are scoped: `@scope/name`. A scope is a Stencil username claimed on

package/dist/types/stream.d.ts

@@ -1,8 +1,8 @@
 /**
- * Wire types for `omp stream`: Twitch-style live screen sharing at
+ * Wire types for `zetacode stream`: Twitch-style live screen sharing at
  * `live.omp.sh/<username>`.
  *
- * Independent from collab. A publisher (`omp stream`) sends plaintext JSON
+ * Independent from collab. A publisher (`zetacode stream`) sends plaintext JSON
  * screen deltas for one or more panes (one pane per omp session attached in
  * the same working directory); the stream server materializes each pane
  * (viewport + bounded history) so late viewers receive a snapshot without
@@ -182,7 +182,7 @@ export declare const STREAM_AUTH_ENV = "STENCIL_API_KEY";
 /** Longest accepted clip description (runes). Titles share `STREAM_TITLE_MAX`. */
 export declare const CLIP_DESCRIPTION_MAX = 5000;
 /**
- * `POST /api/clips` answer. The body is an `.ompcast` recording (optionally
+ * `POST /api/clips` answer. The body is an `.zetacast` recording (optionally
  * `Content-Encoding: gzip`) whose header may carry `title` and `description`;
  * the bearer identifies the uploading Stencil account.
  */

package/dist/types/tsp.d.ts

@@ -11,9 +11,11 @@
  * `q` query, `o` open, `f` frame, `b` blob, `t` palette, `x` close. Terminal →
  * program: `r` reply, `e` event (on the pty's input side).
  *
- * The normative spec is `crates/tern/SURFACE_PROTOCOL.md` in the Stencil
- * repository; these types mirror it. Unknown fields and verbs are ignored in
- * both directions, so every addition here is optional.
+ * The normative spec is the Tern SDK's Surface Protocol and Elements reference
+ * (`docs/sdk/src/protocol` and `docs/sdk/src/elements` in the Stencil
+ * repository, https://docs.stencil.so/tern/protocol/); these types mirror it.
+ * Unknown fields and verbs are ignored in both directions, so every addition
+ * here is optional.
  */
 /** Protocol version this build speaks. */
 export declare const TSP_VERSION = 1;
@@ -168,6 +170,8 @@ export interface TspCodeProps {
         tone: TspTone;
     }[];
     wrap?: boolean;
+    /** Clamp to the first `lines` drawn lines under a "N more lines" button; gives way inside an open disclosure. */
+    preview?: TspPreview;
 }
 export interface TspDiffHunk {
     oldStart: number;
@@ -321,13 +325,17 @@ export interface TspEditorProps {
     decor?: readonly TspEditorDecoration[];
     /** Inline completion suffix drawn after the caret. */
     ghost?: string;
-    placeholder?: string;
+    /** Dim text while `text` is empty; spans style it (`em` for italics). */
+    placeholder?: TspText;
     prompt?: TspText;
     /** Mode label (vim). */
     mode?: string;
     /** The text is code in this language (`python`, `bash`): highlighted, in the mono face. */
     lang?: string;
     readonly?: boolean;
+    /** Ready to accept an atomic `send` when advertised in `hello.features`.
+     *  Independent of text editability or keyboard focus; absent or false is not ready. */
+    sendable?: boolean;
     maxLines?: number;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
@@ -415,7 +423,7 @@ export interface TspPickerItem {
 export interface TspPickerColumn {
     id: string;
     head?: string;
-    /** `elapsed`: the value is an age in ms at send; Tern clocks it (spec §9). */
+    /** `elapsed`: the value is an age in ms at send; Tern clocks it. */
     format?: "text" | "num" | "price" | "bar" | "time" | "elapsed" | "dim";
     /** Lower priorities hide first when narrow. */
     priority?: number;
@@ -641,6 +649,8 @@ export interface TspToolProps {
     targetKind?: "command" | "path" | "pattern" | "query" | "text";
     /** Language for `command` highlighting (`bash`, `python`, `js`). */
     lang?: string;
+    /** The raw command line the head's Copy command button copies; a `command` target sets it implicitly. */
+    command?: string;
     /** `file://` link for path targets (⌘-click opens). */
     href?: string;
     /** Short facts after the target: `+8 −1`, `5 matches · 2 files`, `22 lines`. */
@@ -665,12 +675,15 @@ export interface TspToolProps {
     frame?: "card" | "inline";
     collapsible?: boolean;
     collapsed?: boolean;
-    /** Body clamp while collapsed: `{lines}` shows the head of the body, `{tail}` the end (bash output). */
+    /**
+     * Body clamp while collapsed: `{lines}` shows the head of the body, `{tail}` the end (bash output).
+     * `children`: the collapsed body stays whole and the children's own previews (`ansi`, `code`) clamp instead.
+     */
     preview?: {
         lines: number;
     } | {
         tail: number;
-    } | "none";
+    } | "none" | "children";
     /** Actions offered in the head on hover (`copy`, `rerun`, `open`). */
     tools?: readonly TspPickerAction[];
 }
@@ -932,6 +945,7 @@ export type TspQuery = {
     v: readonly number[];
     app: string;
     ver?: string;
+    features?: readonly string[];
 } | {
     q: "blobs";
     ids: readonly string[];
@@ -953,6 +967,8 @@ export type TspReply = {
     };
     dark?: boolean;
     reduceMotion?: boolean;
+    /** The user's system reads a 12-hour clock (`false`: 24-hour); absent from older terminals. */
+    hour12?: boolean;
 } | {
     r: "blobs";
     have: readonly string[];
@@ -1028,6 +1044,31 @@ export type TspEvent = {
     cursor: number;
     len: number;
 }
+/**
+ * Undo the last change to the text of `editor`/`input` node `id` through the
+ * program's own undo history (an applied `edit` is one unit, as typing is); a
+ * no-op when there is nothing to undo. Sent only when `hello` lists `"undo"`.
+ */
+ | {
+    ev: "undo";
+    sf: string;
+    id: string;
+}
+/**
+ * Submit `text` as one prompt through the addressed composer's ordinary
+ * submission path, without paste or keyboard simulation. Sent only when
+ * the program's `hello.features` includes `"send"` and `sf`/`id` identify
+ * a live editable composer whose `sendable` is exactly true. Writable text
+ * or keyboard focus alone does not imply submission readiness. Blank text is
+ * a no-op; an existing draft is retained for local recall, not appended to
+ * the supplied prompt.
+ */
+ | {
+    ev: "send";
+    sf: string;
+    id: string;
+    text: string;
+}
 /**
  * The user clicked into node `id` (an `editor`/`input` without the focus, or
  * a `prefs` sheet while the focus is outside it): the program moves its

package/package.json

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

package/src/skillshare.ts

@@ -1,6 +1,6 @@
 /**
  * Wire contract for Skillshare (`skills.omp.sh`): an npm-style registry for
- * omp skills. Shared by the omp CLI (`omp skill …`), the Go server
+ * zetacode skills. Shared by the omp CLI (`zetacode skill …`), the Go server
  * (`stencil/apps/skills`), and its web UI (which mirrors this file).
  *
  * Packages are scoped: `@scope/name`. A scope is a Stencil username claimed on

package/src/stream.ts

@@ -1,8 +1,8 @@
 /**
- * Wire types for `omp stream`: Twitch-style live screen sharing at
+ * Wire types for `zetacode stream`: Twitch-style live screen sharing at
  * `live.omp.sh/<username>`.
  *
- * Independent from collab. A publisher (`omp stream`) sends plaintext JSON
+ * Independent from collab. A publisher (`zetacode stream`) sends plaintext JSON
  * screen deltas for one or more panes (one pane per omp session attached in
  * the same working directory); the stream server materializes each pane
  * (viewport + bounded history) so late viewers receive a snapshot without
@@ -145,7 +145,7 @@ export const STREAM_AUTH_ENV = "STENCIL_API_KEY";
 export const CLIP_DESCRIPTION_MAX = 5000;
 
 /**
- * `POST /api/clips` answer. The body is an `.ompcast` recording (optionally
+ * `POST /api/clips` answer. The body is an `.zetacast` recording (optionally
  * `Content-Encoding: gzip`) whose header may carry `title` and `description`;
  * the bearer identifies the uploading Stencil account.
  */

package/src/tsp.ts

@@ -11,9 +11,11 @@
  * `q` query, `o` open, `f` frame, `b` blob, `t` palette, `x` close. Terminal →
  * program: `r` reply, `e` event (on the pty's input side).
  *
- * The normative spec is `crates/tern/SURFACE_PROTOCOL.md` in the Stencil
- * repository; these types mirror it. Unknown fields and verbs are ignored in
- * both directions, so every addition here is optional.
+ * The normative spec is the Tern SDK's Surface Protocol and Elements reference
+ * (`docs/sdk/src/protocol` and `docs/sdk/src/elements` in the Stencil
+ * repository, https://docs.stencil.so/tern/protocol/); these types mirror it.
+ * Unknown fields and verbs are ignored in both directions, so every addition
+ * here is optional.
  */
 
 /** Protocol version this build speaks. */
@@ -215,6 +217,8 @@ export interface TspCodeProps {
 	numbers?: boolean;
 	marks?: readonly { line: number; tone: TspTone }[];
 	wrap?: boolean;
+	/** Clamp to the first `lines` drawn lines under a "N more lines" button; gives way inside an open disclosure. */
+	preview?: TspPreview;
 }
 export interface TspDiffHunk {
 	oldStart: number;
@@ -350,13 +354,17 @@ export interface TspEditorProps {
 	decor?: readonly TspEditorDecoration[];
 	/** Inline completion suffix drawn after the caret. */
 	ghost?: string;
-	placeholder?: string;
+	/** Dim text while `text` is empty; spans style it (`em` for italics). */
+	placeholder?: TspText;
 	prompt?: TspText;
 	/** Mode label (vim). */
 	mode?: string;
 	/** The text is code in this language (`python`, `bash`): highlighted, in the mono face. */
 	lang?: string;
 	readonly?: boolean;
+	/** Ready to accept an atomic `send` when advertised in `hello.features`.
+	 *  Independent of text editability or keyboard focus; absent or false is not ready. */
+	sendable?: boolean;
 	maxLines?: number;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
@@ -433,7 +441,7 @@ export interface TspPickerItem {
 export interface TspPickerColumn {
 	id: string;
 	head?: string;
-	/** `elapsed`: the value is an age in ms at send; Tern clocks it (spec §9). */
+	/** `elapsed`: the value is an age in ms at send; Tern clocks it. */
 	format?: "text" | "num" | "price" | "bar" | "time" | "elapsed" | "dim";
 	/** Lower priorities hide first when narrow. */
 	priority?: number;
@@ -630,6 +638,8 @@ export interface TspToolProps {
 	targetKind?: "command" | "path" | "pattern" | "query" | "text";
 	/** Language for `command` highlighting (`bash`, `python`, `js`). */
 	lang?: string;
+	/** The raw command line the head's Copy command button copies; a `command` target sets it implicitly. */
+	command?: string;
 	/** `file://` link for path targets (⌘-click opens). */
 	href?: string;
 	/** Short facts after the target: `+8 −1`, `5 matches · 2 files`, `22 lines`. */
@@ -650,8 +660,11 @@ export interface TspToolProps {
 	frame?: "card" | "inline";
 	collapsible?: boolean;
 	collapsed?: boolean;
-	/** Body clamp while collapsed: `{lines}` shows the head of the body, `{tail}` the end (bash output). */
-	preview?: { lines: number } | { tail: number } | "none";
+	/**
+	 * Body clamp while collapsed: `{lines}` shows the head of the body, `{tail}` the end (bash output).
+	 * `children`: the collapsed body stays whole and the children's own previews (`ansi`, `code`) clamp instead.
+	 */
+	preview?: { lines: number } | { tail: number } | "none" | "children";
 	/** Actions offered in the head on hover (`copy`, `rerun`, `open`). */
 	tools?: readonly TspPickerAction[];
 }
@@ -902,7 +915,7 @@ export interface TspPalette {
 
 /** Verb `q`. */
 export type TspQuery =
-	| { q: "hello"; v: readonly number[]; app: string; ver?: string }
+	| { q: "hello"; v: readonly number[]; app: string; ver?: string; features?: readonly string[] }
 	| { q: "blobs"; ids: readonly string[] };
 
 /** Verb `r`. */
@@ -920,6 +933,8 @@ export type TspReply =
 			cell?: { w: number; h: number };
 			dark?: boolean;
 			reduceMotion?: boolean;
+			/** The user's system reads a 12-hour clock (`false`: 24-hour); absent from older terminals. */
+			hour12?: boolean;
 	  }
 	| { r: "blobs"; have: readonly string[] };
 
@@ -948,6 +963,22 @@ export type TspEvent =
 	 * 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 }
+	/**
+	 * Undo the last change to the text of `editor`/`input` node `id` through the
+	 * program's own undo history (an applied `edit` is one unit, as typing is); a
+	 * no-op when there is nothing to undo. Sent only when `hello` lists `"undo"`.
+	 */
+	| { ev: "undo"; sf: string; id: string }
+	/**
+	 * Submit `text` as one prompt through the addressed composer's ordinary
+	 * submission path, without paste or keyboard simulation. Sent only when
+	 * the program's `hello.features` includes `"send"` and `sf`/`id` identify
+	 * a live editable composer whose `sendable` is exactly true. Writable text
+	 * or keyboard focus alone does not imply submission readiness. Blank text is
+	 * a no-op; an existing draft is retained for local recall, not appended to
+	 * the supplied prompt.
+	 */
+	| { ev: "send"; sf: string; id: string; text: string }
 	/**
 	 * The user clicked into node `id` (an `editor`/`input` without the focus, or
 	 * a `prefs` sheet while the focus is outside it): the program moves its