@promptctl/rich-js 0.3.1 → 0.4.0

package/dist/widgets/terminal-host.js

@@ -0,0 +1,258 @@
+/**
+ * TerminalHost — the capability seam between the interactive runtime and its
+ * I/O environment.
+ *
+ * [LAW:locality-or-seam] The missing seam *was* the missing type. Before this
+ * type existed, Screen and EventRouter reached for ambient `process.stdin`/
+ * `process.stdout`, which crystallised them to node. With a `TerminalHost`
+ * value flowing across one boundary, the same runtime code runs against any
+ * implementation — node's TTY (`NodeTerminalHost`, this file) or a browser
+ * xterm.js terminal (a downstream ticket's adapter).
+ *
+ * [LAW:dataflow-not-control-flow] The runtime never branches on "am I in
+ * node or browser." The host is the value that differs; the code path is
+ * the same. Variability lives in which host is constructed at the program
+ * entry, not in any `if` inside the runtime.
+ *
+ * [LAW:no-shared-mutable-globals] This file is the *single owner* of node
+ * TTY access in the codebase. Every other module receives a `TerminalHost`
+ * from outside. If you find yourself reaching for `process.stdin`,
+ * `process.stdout`, or `setRawMode` anywhere else in the runtime or in a
+ * demo, fix the call site to take a `TerminalHost` parameter instead —
+ * the seam is already here; use it.
+ *
+ * [boundaries: capabilities over context] A `TerminalHost` grants exactly
+ * the I/O capabilities the runtime needs: write bytes, read input, query
+ * size, observe resize, switch raw mode, lifecycle. It is not an
+ * omniscient handle to "the process."
+ */
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+export class NodeTerminalHost {
+    stdin;
+    stdout;
+    dataHandlers = new Set();
+    resizeHandlers = new Set();
+    dataListener;
+    resizeListener;
+    rawModeRequested = false;
+    constructor(options = {}) {
+        // [LAW:no-shared-mutable-globals] The ONLY place in the codebase that
+        // reaches for `process.stdin`/`process.stdout` directly. All other
+        // callers receive a `TerminalHost` and stay environment-agnostic.
+        this.stdin = options.stdin ?? process.stdin;
+        this.stdout = options.stdout ?? process.stdout;
+    }
+    get isTTY() {
+        return !!this.stdin.isTTY && !!this.stdout.isTTY;
+    }
+    write(data) {
+        this.stdout.write(data);
+    }
+    size() {
+        return {
+            cols: this.stdout.columns ?? DEFAULT_COLS,
+            rows: this.stdout.rows ?? DEFAULT_ROWS,
+        };
+    }
+    setRawMode(raw) {
+        this.rawModeRequested = raw;
+        this.applyRawMode(raw);
+    }
+    // [LAW:single-enforcer] One site decides what to do when toggling raw
+    // mode on the underlying transport fails. Both `setRawMode` (call from
+    // outside) and `stop` (cleanup) go through this helper so neither
+    // caller has to branch on capability or exception-handling.
+    //
+    // [LAW:dataflow-not-control-flow] Two shapes of "the transport can't do
+    // this" are absorbed identically: the optional chain handles "method
+    // missing" (non-TTY streams, PassThrough in tests); the try/catch
+    // handles "method exists but threw" (node's `setRawMode` throws on
+    // closed or non-TTY streams). Callers see neither shape — they always
+    // call `setRawMode(bool)`, and the host decides what's possible.
+    //
+    // The catch is silent because the only call sites are lifecycle
+    // transitions: if the stream is already gone, there is nothing
+    // semantically meaningful for the host to do, and surfacing the
+    // exception would only make teardown brittle without giving the caller
+    // a recovery path. The demos this replaces did `try { ... } catch {}`
+    // at every call site for exactly this reason — absorbing it once here
+    // means the pattern stops spreading.
+    applyRawMode(raw) {
+        try {
+            this.stdin.setRawMode?.(raw);
+        }
+        catch {
+            // Underlying stream couldn't honor the request (closed, no longer
+            // a TTY, etc.). Lifecycle continues.
+        }
+    }
+    onData(handler) {
+        this.dataHandlers.add(handler);
+        // [LAW:single-enforcer] One underlying `data` listener fans out to all
+        // subscribers — keeps stdin's flowing/paused state derivable from
+        // "any subscribers?" instead of from per-call ref-counts scattered
+        // through the runtime.
+        if (!this.dataListener) {
+            this.dataListener = (chunk) => {
+                for (const h of this.dataHandlers)
+                    h(chunk);
+            };
+            this.stdin.on("data", this.dataListener);
+            this.stdin.resume?.();
+        }
+        return () => {
+            this.dataHandlers.delete(handler);
+            if (this.dataHandlers.size === 0 && this.dataListener) {
+                this.stdin.off("data", this.dataListener);
+                this.dataListener = undefined;
+                // Returning stdin to paused state mirrors the symmetric "no
+                // subscribers → no flow" invariant. Without this, removing the
+                // last subscriber leaves stdin in flowing mode and the process
+                // hangs forever waiting for an event nobody is listening for.
+                this.stdin.pause?.();
+            }
+        };
+    }
+    onResize(handler) {
+        this.resizeHandlers.add(handler);
+        if (!this.resizeListener) {
+            this.resizeListener = () => {
+                const size = this.size();
+                for (const h of this.resizeHandlers)
+                    h(size);
+            };
+            this.stdout.on("resize", this.resizeListener);
+        }
+        return () => {
+            this.resizeHandlers.delete(handler);
+            if (this.resizeHandlers.size === 0 && this.resizeListener) {
+                this.stdout.off("resize", this.resizeListener);
+                this.resizeListener = undefined;
+            }
+        };
+    }
+    start() {
+        // No-op on node: stdin/stdout are always available. Lifecycle exists
+        // so the browser host (downstream ticket) can attach to the DOM here
+        // without the runtime branching on "do I need to start?"
+    }
+    stop() {
+        // [LAW:one-source-of-truth] Symmetric teardown: drop every subscriber
+        // and detach the underlying stream listeners. After stop(), the host
+        // is in the same shape a freshly-constructed one would be in. Calling
+        // stop() repeatedly is safe — the dataListener/resizeListener guards
+        // make later calls no-ops.
+        if (this.dataListener) {
+            this.stdin.off("data", this.dataListener);
+            this.dataListener = undefined;
+            this.stdin.pause?.();
+        }
+        if (this.resizeListener) {
+            this.stdout.off("resize", this.resizeListener);
+            this.resizeListener = undefined;
+        }
+        this.dataHandlers.clear();
+        this.resizeHandlers.clear();
+        if (this.rawModeRequested) {
+            this.applyRawMode(false);
+            this.rawModeRequested = false;
+        }
+    }
+}
+export class BrowserTerminalHost {
+    terminal;
+    dataHandlers = new Set();
+    resizeHandlers = new Set();
+    dataSubscription;
+    resizeSubscription;
+    constructor(options) {
+        this.terminal = options.terminal;
+    }
+    // [LAW:dataflow-not-control-flow] xterm.js is always an interactive
+    // terminal — there is no "non-TTY" code path in the browser. The
+    // runtime never branches on the value; this is the only sensible
+    // constant for this host.
+    get isTTY() {
+        return true;
+    }
+    write(data) {
+        this.terminal.write(data);
+    }
+    size() {
+        return { cols: this.terminal.cols, rows: this.terminal.rows };
+    }
+    // [LAW:dataflow-not-control-flow] xterm.js delivers keystrokes raw
+    // unconditionally — there is no cooked mode to toggle. The no-op
+    // matches the TerminalHost contract's documented "silently no-op when
+    // the transport has no cooked mode," so callers stay uniform across
+    // hosts. (Mirror: NodeTerminalHost on a non-TTY stream takes the same
+    // no-op path via the optional-chain in `applyRawMode`.)
+    setRawMode(_raw) { }
+    // [LAW:single-enforcer] One underlying `terminal.onData` subscription
+    // fans out to every host-level handler — the same lazy-attach,
+    // last-unsubscribe-detaches shape as NodeTerminalHost.onData. The
+    // runtime never sees the underlying subscription; it sees a single
+    // uniform `(handler) => Unsubscribe` API across hosts.
+    onData(handler) {
+        this.dataHandlers.add(handler);
+        if (!this.dataSubscription) {
+            this.dataSubscription = this.terminal.onData((chunk) => {
+                for (const h of this.dataHandlers)
+                    h(chunk);
+            });
+        }
+        return () => {
+            this.dataHandlers.delete(handler);
+            if (this.dataHandlers.size === 0 && this.dataSubscription) {
+                this.dataSubscription.dispose();
+                this.dataSubscription = undefined;
+            }
+        };
+    }
+    onResize(handler) {
+        this.resizeHandlers.add(handler);
+        if (!this.resizeSubscription) {
+            this.resizeSubscription = this.terminal.onResize((size) => {
+                const snapshot = { cols: size.cols, rows: size.rows };
+                for (const h of this.resizeHandlers)
+                    h(snapshot);
+            });
+        }
+        return () => {
+            this.resizeHandlers.delete(handler);
+            if (this.resizeHandlers.size === 0 && this.resizeSubscription) {
+                this.resizeSubscription.dispose();
+                this.resizeSubscription = undefined;
+            }
+        };
+    }
+    start() {
+        // [LAW:one-source-of-truth] The host does NOT own the terminal's DOM
+        // lifecycle (`terminal.open` / `terminal.dispose`). That is the
+        // caller's responsibility, exactly as NodeTerminalHost does not own
+        // `process.stdin`/`process.stdout`. start() is here so the runtime
+        // can call it uniformly across hosts; for this host there is
+        // nothing to do at this seam.
+    }
+    stop() {
+        // [LAW:one-source-of-truth] Symmetric teardown mirroring
+        // NodeTerminalHost.stop: drop every host-level subscriber and
+        // dispose the underlying terminal subscriptions. The terminal
+        // itself stays alive — re-subscribing via onData/onResize after
+        // stop() works, since the lazy-attach path re-creates the
+        // subscription on next subscribe. Calling stop() repeatedly is
+        // safe — the subscription guards make later calls no-ops.
+        if (this.dataSubscription) {
+            this.dataSubscription.dispose();
+            this.dataSubscription = undefined;
+        }
+        if (this.resizeSubscription) {
+            this.resizeSubscription.dispose();
+            this.resizeSubscription = undefined;
+        }
+        this.dataHandlers.clear();
+        this.resizeHandlers.clear();
+    }
+}
+//# sourceMappingURL=terminal-host.js.map

package/dist/widgets/terminal-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-host.js","sourceRoot":"","sources":["../../src/widgets/terminal-host.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptctl/rich-js",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Rich text and beautiful formatting in the terminal — a TypeScript port of Python's Rich",
   "type": "module",
   "main": "dist/index.js",
@@ -21,6 +21,14 @@
     "./template-bindings": {
       "types": "./dist/template-bindings/index.d.ts",
       "import": "./dist/template-bindings/index.js"
+    },
+    "./node/save": {
+      "types": "./dist/node/save.d.ts",
+      "import": "./dist/node/save.js"
+    },
+    "./node/prompt": {
+      "types": "./dist/node/prompt.d.ts",
+      "import": "./dist/node/prompt.js"
     }
   },
   "files": [
@@ -30,10 +38,10 @@
     "build": "tsc",
     "test": "vitest run",
     "test:watch": "vitest",
-    "lint": "tsc --noEmit",
+    "lint": "tsc --noEmit && tsc -p tsconfig.scripts.json",
     "clean": "rm -rf dist",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
+    "docs:dev": "npm run demos:build && vitepress dev docs",
+    "docs:build": "npm run demos:build && vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "demo": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-explore/index.js",
     "demo:build": "tsc -p tsconfig.demo.json",
@@ -44,7 +52,11 @@
     "demo:dropdown": "tsc -p tsconfig.demo.json && node dist-demo/examples/dropdown-demo/index.js",
     "dash": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-dash/index.js",
     "template-bindings": "tsc -p tsconfig.demo.json && node dist-demo/examples/rich-template-bindings/index.js",
-    "themes-and-color-studio": "tsc -p tsconfig.demo.json && node dist-demo/examples/themes-and-color-studio/index.js"
+    "themes-and-color-studio": "tsc -p tsconfig.demo.json && node dist-demo/examples/themes-and-color-studio/index.js",
+    "harness:browser-host": "tsc -p tsconfig.demo.json && echo 'Serving harness at http://localhost:8080/examples/browser-terminal-host-harness/' && npx --yes http-server@14.1.1 -p 8080 -c-1 -s .",
+    "demos:build": "tsc -p tsconfig.demo.json && vite build --config vite.config.demos.ts",
+    "demos:preview": "vite preview --config vite.config.demos.ts",
+    "test:demos": "playwright test"
   },
   "keywords": [
     "terminal",
@@ -61,11 +73,13 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=20"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.60.0",
     "@types/node": "^25.5.0",
     "typescript": "^5.7.0",
+    "vite": "^7.3.3",
     "vitepress": "^1.6.4",
     "vitest": "^3.0.0"
   },