@flowtty/core 1.0.0-alpha.13 → 1.0.0-alpha.14

package/dist/{backend-DPFtzaxG.d.ts → backend-BV7OrooZ.d.ts}

@@ -81,6 +81,26 @@ interface Backend {
    * and degrade gracefully when absent.
    */
   printStatic?(lines: string[]): void;
+  /**
+   * Ring the terminal bell (BEL). The one attention-getter every terminal has:
+   * a sound, a flash, a marked tab — whatever the person configured. Backends
+   * that can write to a terminal implement it and rate-limit it (flowtty's TTY
+   * backends: at most one per second); headless ones omit it.
+   *
+   * Never called from inside `draw()`, and the bytes go out as one write, so a
+   * bell between two frames leaves a frame-diffing backend's baseline valid.
+   */
+  bell?(): void;
+  /**
+   * Post a desktop notification through the terminal — what an app reaches for
+   * when the person is looking at another window. `title` is the line the
+   * notification leads with; `body` the optional rest.
+   *
+   * Which escape sequence carries it is the backend's business (see
+   * docs/terminal.md), as is sanitizing the text: an embedded ESC or BEL would
+   * end the sequence early. Backends with no terminal to write to omit this.
+   */
+  notify?(title: string, body?: string): void;
   /**
    * Whether this backend owns the entire render area — i.e. components can
    * use the full `size()` for layout and overlay larger panels (Menu cascade,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { C as BorderStyle, E as GridChars, S as BorderChars, T as GRID_CHARS, a as ScrollMetrics, s as TextRun, t as BoxProps, w as DEFAULT_BORDER_STYLE } from "./host-DnKJiaQh.js";
 import { a as NAMED_COLORS, i as Color, n as Cell, o as NamedColor, r as Style, t as Buffer } from "./cells-C-GthybI.js";
-import { a as NamedKey, i as NAMED_KEYS, n as Key, r as KeyName, t as Backend } from "./backend-DPFtzaxG.js";
+import { a as NamedKey, i as NAMED_KEYS, n as Key, r as KeyName, t as Backend } from "./backend-BV7OrooZ.js";
 //#region src/warnings.d.ts
 /** Warnings noted since the last call; clears the list. */
 export declare function takeWarnings(): string[];

package/dist/testing/index.d.ts

@@ -1,10 +1,17 @@
 import { t as Buffer } from "../cells-C-GthybI.js";
-import { n as Key, t as Backend } from "../backend-DPFtzaxG.js";
+import { n as Key, t as Backend } from "../backend-BV7OrooZ.js";
 //#region src/testing/test-backend.d.ts
 export declare class TestBackend implements Backend {
   private readonly cols;
   private readonly rows;
   frames: string[];
+  /** How many times the app rang the bell. Nothing is written anywhere. */
+  bells: number;
+  /** Every notification the app posted, in order — `body` absent when it was. */
+  notifications: {
+    title: string;
+    body?: string;
+  }[];
   private buffers;
   private readonly subscribers;
   constructor(cols?: number, rows?: number);
@@ -28,6 +35,12 @@ export declare class TestBackend implements Backend {
   type(text: string): void;
   /** Deliver `text` as ONE 'paste' key — what a TTY backend emits for a bracketed paste. */
   paste(text: string): void;
+  /** Count a bell instead of writing one. */
+  bell(): void;
+  /** Record a notification instead of posting one. The text is kept exactly as
+   *  the app passed it — sanitizing is a TTY backend's job, and a test wants to
+   *  see what the app asked for. */
+  notify(title: string, body?: string): void;
   /** Deliver one mouse-wheel step at cell (x, y) — what a TTY backend with `mouse` on emits. */
   wheel(direction: "up" | "down", x?: number, y?: number): void;
   dispose(): void;

package/dist/testing/index.js

@@ -21,6 +21,10 @@ var TestBackend = class {
 	cols;
 	rows;
 	frames = [];
+	/** How many times the app rang the bell. Nothing is written anywhere. */
+	bells = 0;
+	/** Every notification the app posted, in order — `body` absent when it was. */
+	notifications = [];
 	buffers = [];
 	subscribers = /* @__PURE__ */ new Set();
 	constructor(cols = 40, rows = 10) {
@@ -82,6 +86,19 @@ var TestBackend = class {
 			text: text.replace(/\r\n?/g, "\n")
 		});
 	}
+	/** Count a bell instead of writing one. */
+	bell() {
+		this.bells += 1;
+	}
+	/** Record a notification instead of posting one. The text is kept exactly as
+	*  the app passed it — sanitizing is a TTY backend's job, and a test wants to
+	*  see what the app asked for. */
+	notify(title, body) {
+		this.notifications.push(body === void 0 ? { title } : {
+			title,
+			body
+		});
+	}
 	/** Deliver one mouse-wheel step at cell (x, y) — what a TTY backend with `mouse` on emits. */
 	wheel(direction, x = 0, y = 0) {
 		this.press({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowtty/core",
-  "version": "1.0.0-alpha.13",
+  "version": "1.0.0-alpha.14",
   "type": "module",
   "license": "MIT",
   "repository": {