@estebanforge/pi-tui-dialogs 0.1.2 → 0.1.3

package/README.md

@@ -12,6 +12,12 @@ Dialog pattern adapted from
 - `frameDialog` / `dialogHeight` / `DIALOG_OPTIONS` — shared rounded frame:
   title in the top border, body, footer line above the bottom border, padded to
   a stable height so centered overlays do not jump between views.
+- `dialogBlocked(title)` — the pi 1.5.1 overlay `blocked` option payload
+  (`{ kind: "question", message: title }`): pi reports the overlay as waiting
+  on user input (OSC 7501) until `done()`, also while hidden. `dialogMenu`,
+  `dialogInput`, and `dialogChoice` pass it for you; hand-rolled overlays can
+  spread it into their own `ctx.ui.custom` options. Hosts older than pi 1.5.1
+  ignore the field.
 - `DialogMenu` / `dialogMenu` — framed menu with `label │ value` rows, a
   counter line, a muted help panel for the selected row, optional tab groups
   (left/right to switch) and type-to-search within the active tab. Rows with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estebanforge/pi-tui-dialogs",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Framed TUI dialog kit for @estebanforge Pi extensions: bordered settings menus with label/value columns, help panel, tabs, type-to-search, and validated input dialogs. Dialog pattern adapted from pi-subagent-manager (MIT). Plain library, no Pi entrypoint: consumers depend on it and Pi installs it transitively.",
   "keywords": [
     "pi",
@@ -33,7 +33,7 @@
     ".": "./src/index.ts"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^1.0.0",
+    "@earendil-works/pi-coding-agent": "^1.5.1",
     "@earendil-works/pi-tui": "^1.0.0"
   },
   "peerDependenciesMeta": {

package/src/choice.ts

@@ -3,7 +3,7 @@
 // from pi-antigravity-bridge's first-run engine picker.
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { wrapTextWithAnsi, type SelectItem, SelectList } from "@earendil-works/pi-tui";
-import { DIALOG_OPTIONS, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
+import { DIALOG_OPTIONS, dialogBlocked, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
 import type { DialogContext } from "./menu.js";
 
 /** Hard cap on the option list. A closed choice stays scannable; past ten
@@ -148,6 +148,6 @@ export async function dialogChoice(
 	assertChoiceOptions(options.options, options.selected);
 	return ctx.ui.custom<string | undefined>(
 		(host, theme, _keys, done) => new ChoiceView(host, theme, title, options, done),
-		DIALOG_OPTIONS,
+		{ ...DIALOG_OPTIONS, blocked: dialogBlocked(title) },
 	);
 }

package/src/frame.ts

@@ -23,6 +23,14 @@ export const DIALOG_OPTIONS = {
 	},
 } as const;
 
+/** Blocked program status (OSC 7501) for a dialog overlay: pi reports the
+ *  overlay as waiting on user input until done(), also while hidden. Hosts
+ *  older than pi 1.5.1 ignore the field. Pi's own selectors use the same
+ *  convention: kind "question", message = dialog title. */
+export function dialogBlocked(title: string): { kind: "question"; message: string } {
+	return { kind: "question", message: title };
+}
+
 /** Strip ANSI and control characters from untrusted row text. */
 export function dialogText(text: string): string {
 	return stripTerminalSequences(text).replace(/[\x00-\x1f\x7f-\x9f]/g, " ");

package/src/index.ts

@@ -2,6 +2,7 @@
 // adapted from pi-subagent-manager (MIT); see LICENSE for attribution.
 export {
 	DIALOG_OPTIONS,
+	dialogBlocked,
 	dialogHeight,
 	dialogText,
 	frameDialog,

package/src/input.ts

@@ -4,7 +4,7 @@
 // (MIT, Copyright (c) 2026 pi-subagent contributors).
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { Input, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { DIALOG_OPTIONS, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
+import { DIALOG_OPTIONS, dialogBlocked, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
 import type { DialogContext } from "./menu.js";
 
 export interface DialogInputOptions {
@@ -102,6 +102,6 @@ export function dialogInput(
 ): Promise<string | undefined> {
 	return ctx.ui.custom<string | undefined>(
 		(host, theme, _keys, done) => new InputView(host, theme, title, options, done),
-		DIALOG_OPTIONS,
+		{ ...DIALOG_OPTIONS, blocked: dialogBlocked(title) },
 	);
 }

package/src/menu.ts

@@ -5,7 +5,7 @@
 // contributors.
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { getKeybindings, matchesKey, Key, truncateToWidth, visibleWidth, wrapTextWithAnsi, type SettingItem } from "@earendil-works/pi-tui";
-import { DIALOG_OPTIONS, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
+import { DIALOG_OPTIONS, dialogBlocked, dialogHeight, dialogText, frameDialog, type DialogHost } from "./frame.js";
 
 /** A menu row is a pi-tui SettingItem; `onEdit` additionally opens a custom
  *  editor (input dialog, submenu) on Enter and keeps the menu open. Rows with
@@ -250,7 +250,7 @@ export function dialogMenu(
 	return ctx.ui.custom(
 		(host, theme, _keys, done) =>
 			new DialogMenu(host, theme, { title, rows, ...options }, done),
-		DIALOG_OPTIONS,
+		{ ...DIALOG_OPTIONS, blocked: dialogBlocked(title) },
 	);
 }