@promptctl/rich-js 0.8.0 → 0.10.0

package/dist/widgets/terminal-host.js

@@ -1,127 +0,0 @@
-/**
- * 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`, on the `node/terminal-host`
- * subpath) or a browser xterm.js terminal (`BrowserTerminalHost`, below).
- *
- * [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:one-way-deps] The interface and the browser host live here, in the
- * barrel; the node host lives in `src/node/terminal-host.ts`, behind an
- * explicit subpath, because it reads `process.stdin` / `process.stdout`. The
- * dependency runs one way — the node adapter imports this seam; nothing here
- * imports the adapter — so importing the main barrel in a browser cannot
- * reach the ambient `process` global by any path, rather than merely not
- * reaching it in practice. `test/seam/browser-safe.test.ts` is what holds
- * that direction; who reads the host at all is `HOST_ACCESS` in
- * `test/seam/ambient-process.ts`, and neither list is repeated here.
- *
- * [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."
- */
-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

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