@linxiraos/pi-wire 1.1.26 → 1.1.27

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [1.1.27] - 2026-10-07
+
+- 版本线推进至 1.1.27；本版无独立用户可见变化。
+
+### Fixed
+
+- Republished as 1.1.2 to reset the `latest` tag after the broken 1.1.0 (no functional change over 1.1.1).
+- Published tarballs now carry real dependency versions instead of Bun's `catalog:` protocol (1.1.0 installs failed with "Unsupported URL Type catalog:").
+- 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.26] - 2026-10-03
 
 - 版本线推进至 1.1.26；本版无独立用户可见变化。
@@ -72,24 +82,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/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;
@@ -328,6 +330,9 @@ export interface TspEditorProps {
     /** 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 +420,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;
@@ -932,6 +937,7 @@ export type TspQuery = {
     v: readonly number[];
     app: string;
     ver?: string;
+    features?: readonly string[];
 } | {
     q: "blobs";
     ids: readonly string[];
@@ -953,6 +959,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 +1036,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.1.27",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Can Boluk",

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. */
@@ -357,6 +359,9 @@ export interface TspEditorProps {
 	/** 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 +438,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;
@@ -902,7 +907,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 +925,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 +955,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