Add wmux/preset/tui: one-call TUI preset with web URL and awaitStop

New export `@playfast/wmux/preset/tui` that starts the wmux server,
prints the web URL, opens the TUI client, and returns a handle with
`url`, `stop()`, and `done` promise. Server auto-stops when TUI closes.

Uses dynamic import for @playfast/wmux-client-terminal (devDependency
for types only) — no circular deps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: shmuel hizmi

bun.lock

@@ -1,7 +1,6 @@
-import { wmux } from "@playfast/wmux";
-import { renderWmuxTUI } from "@playfast/wmux-client-terminal";
+import { wmuxTUI } from "@playfast/wmux/preset/tui";
 
-const handle = await wmux({
+const { done } = await wmuxTUI({
   title: "echoform",
   description: "local",
   sidebarItems: [
@@ -37,16 +36,7 @@ const handle = await wmux({
   ],
   port: 4220,
   token: "test-token",
-  open: false,
 });
 
-const tui = await renderWmuxTUI({
-  token: handle.token,
-  wsUrl: handle.wsUrl,
-  webUrl: handle.url,
-});
-
-// Wait for user to quit the TUI (Ctrl+B q), then stop the server
-await tui.done;
-handle.stop();
+await done;
 process.exit(0);

demo/dev-server/server/tui.tsx

@@ -13,6 +13,11 @@
       "types": "./src/views.ts",
       "import": "./src/views.ts",
       "default": "./src/views.ts"
+    },
+    "./preset/tui": {
+      "types": "./src/preset/tui.ts",
+      "import": "./src/preset/tui.ts",
+      "default": "./src/preset/tui.ts"
     }
   },
   "files": [
@@ -31,6 +36,7 @@
     "react": ">=19.0.0"
   },
   "devDependencies": {
+    "@playfast/wmux-client-terminal": "workspace:*",
     "@types/bun": "latest",
     "@types/react": "^19.0.0"
   },

packages/wmux/package.json

@@ -0,0 +1,39 @@
+import { wmux } from "../wmux";
+import type { WmuxConfig } from "../types";
+import type { WmuxTUIHandle } from "@playfast/wmux-client-terminal";
+
+export interface WmuxTUIPresetConfig extends Omit<WmuxConfig, "open"> {}
+
+export interface WmuxTUIPresetHandle {
+  /** Full web client URL (with token and ws params) */
+  readonly url: string;
+  /** Stop the wmux server and all processes */
+  readonly stop: () => void;
+  /** Resolves when the TUI is closed (user quit or programmatic stop) */
+  readonly done: Promise<void>;
+}
+
+export async function wmuxTUI(config: WmuxTUIPresetConfig): Promise<WmuxTUIPresetHandle> {
+  const handle = await wmux({ ...config, open: false });
+
+  // Print web URL before TUI takes over the screen
+  console.log(`\x1b[1m\x1b[34mweb\x1b[0m  → \x1b[4m${handle.url}\x1b[0m`);
+
+  const { renderWmuxTUI } = await import("@playfast/wmux-client-terminal");
+
+  const tui: WmuxTUIHandle = await renderWmuxTUI({
+    token: handle.token,
+    wsUrl: handle.wsUrl,
+    webUrl: handle.url,
+  });
+
+  const done = tui.done.then(() => {
+    handle.stop();
+  });
+
+  const stop = (): void => {
+    tui.destroy();
+  };
+
+  return { url: handle.url, stop, done };
+}