@zenbu-labs/pixel 0.0.20 → 0.0.22

package/dist/bin.js

@@ -27,12 +27,12 @@ function resolveEntry(given) {
         }
         const entry = node_path_1.default.join(target, main);
         if (!node_fs_1.default.existsSync(entry)) {
-            fail(`[placeholder copy: ${entry} does not exist. Build your app or point "main" in package.json at the built entry.]`);
+            fail(`${entry} does not exist. Build your app or point "main" in package.json at the built entry.`);
         }
         return entry;
     }
     if (!node_fs_1.default.existsSync(target))
-        fail(`[placeholder copy: no such file ${target}]`);
+        fail(`no such file ${target}`);
     return target;
 }
 function appName(dir) {
@@ -55,7 +55,7 @@ function appDir(entry) {
 function electronBinary() {
     const dist = node_path_1.default.resolve(__dirname, "..", "electron", "dist");
     if (!node_fs_1.default.existsSync(node_path_1.default.join(dist, ".zenbu-electron-sha256"))) {
-        fail("[placeholder copy: the patched electron build is not installed. Run `node node_modules/@zenbu-labs/pixel/scripts/postinstall.mjs` (npm normally runs it for you on install).]");
+        fail("the patched electron build is not installed. Run `node node_modules/@zenbu-labs/pixel/scripts/postinstall.mjs` (npm normally runs it for you on install).");
     }
     return process.platform === "darwin"
         ? node_path_1.default.join(dist, "Electron.app", "Contents", "MacOS", "pixel")
@@ -74,7 +74,7 @@ function ownTty() {
             return out;
     }
     catch { }
-    return fail("[placeholder copy: could not work out which tty this shell is on]");
+    return fail("could not work out which tty this shell is on");
 }
 async function main() {
     const args = process.argv.slice(2);
@@ -82,22 +82,22 @@ async function main() {
     const own = passthrough < 0 ? args : args.slice(0, passthrough);
     const appArgs = passthrough < 0 ? [] : args.slice(passthrough + 1);
     if (own.includes("--help") || own.includes("-h")) {
-        process.stdout.write("[placeholder copy: usage: pixel [entry|dir] [-- app args]\n  Runs an app's main file inside the pixel runtime, in this terminal pane.]\n");
+        process.stdout.write("usage: pixel [entry|dir] [-- app args]\n  Runs an app's main file inside the pixel runtime, in this terminal pane.\n");
         return 0;
     }
     const stray = own.slice(1).find((arg) => arg.startsWith("-")) ?? own.find((arg) => arg.startsWith("-"));
     if (stray) {
-        fail(`[placeholder copy: unknown option ${stray}. pixel takes an entry and nothing else; put your app's arguments after --]`);
+        fail(`unknown option ${stray}. pixel takes an entry and nothing else; put your app's arguments after --`);
     }
     if (own.length > 1)
-        fail(`[placeholder copy: unexpected ${own[1]}; put your app's arguments after --]`);
+        fail(`unexpected ${own[1]}; put your app's arguments after --`);
     const entry = resolveEntry(own[0] ?? ".");
     const tty = process.env.PIXEL_TTY ?? ownTty();
     const owner = (0, instances_1.findOwner)(tty);
     const announced = owner ? (0, instances_1.announceGuest)(owner, appName(appDir(entry))) : null;
     if (!owner && !process.env.PIXEL_EMBED) {
         if (!process.stdin.isTTY || !process.stdout.isTTY) {
-            fail("[placeholder copy: pixel draws into the terminal, so it needs to run on a tty]");
+            fail("tty required");
         }
         const check = await (0, terminal_1.checkTerminal)((0, terminal_1.detect)());
         if (check.graphics === "unsupported") {

package/dist/devtools.d.ts

@@ -18,16 +18,11 @@ export declare function DevtoolsDockPane({ rect, dock, rem, theme, surface, divi
     onDividerHover(hovering: boolean): void;
 }): import("react").JSX.Element;
 export interface DevToolsProps {
-    /** [placeholder copy: The WebView to inspect, as the ref you gave it or the handle itself.] */
     target: RefObject<WebViewHandle | null> | WebViewHandle;
     style?: Style;
     dock?: DevtoolsDock;
-    /** [placeholder copy: Devtools panel to show once open, for example "console" or "elements".] */
     panel?: string;
-    /** [placeholder copy: The devtools toolbar asked to close or to dock elsewhere. Unmount or change dock in response.] */
     onAction?(action: "close" | "dock-bottom" | "dock-right"): void;
-    /** [placeholder copy: Keep showing the last frame, stretched, while the pane changes size instead of clearing until devtools repaint. Defaults to true.] */
     keepFrame?: boolean;
 }
-/** [placeholder copy: Renders a WebView's devtools wherever this sits in the tree. Mounting opens them, unmounting closes them.] */
 export declare function DevTools({ target, style, dock, panel, onAction, keepFrame }: DevToolsProps): import("react").JSX.Element;

package/dist/devtools.js

@@ -45,11 +45,10 @@ function resolveEntry(target) {
     const handle = "current" in target ? target.current : target;
     return handle ? registry_1.handleEntries.get(handle) ?? null : null;
 }
-/** [placeholder copy: Renders a WebView's devtools wherever this sits in the tree. Mounting opens them, unmounting closes them.] */
 function DevTools({ target, style, dock = "right", panel, onAction, keepFrame = true }) {
     const registry = (0, react_1.useContext)(registry_1.RootContext);
     if (!registry) {
-        throw new Error("[placeholder copy: <DevTools> has to be rendered by a root from pixel's createRoot()]");
+        throw new Error("<DevTools> has to be rendered by a root from createRoot()");
     }
     const boxRef = (0, react_1.useRef)(null);
     const rect = (0, layout_1.useNodeRect)(boxRef, registry);

package/dist/preload/index.d.ts

@@ -1,5 +1,4 @@
 /// <reference path="../../electron/electron.d.ts" preserve="true" />
-/** [placeholder copy: The terminal's colours as rgb triples. `ansi` has 16 slots and is null where the terminal did not report a colour.] */
 export interface TerminalTheme {
     background: number[];
     foreground: number[];

package/dist/react/native.d.ts

@@ -51,7 +51,6 @@ export interface HostOptions {
     socket: string;
     pane: string;
     name: string;
-    /** [placeholder copy: Set when the host is not pixel: frames are drawn into this terminal as kitty virtual placements the host positions.] */
     tty?: string;
 }
 export interface HighlightSpan {

package/dist/react/reconciler-config.d.ts

@@ -65,7 +65,6 @@ export interface ContainerSelection {
 export interface BoxProps {
     style?: Style;
     id?: string;
-    /** [placeholder copy: Lays the box out as nothing and paints none of it, keeping its children mounted.] */
     hidden?: boolean;
     onClick?: (event: ClickEvent) => void;
     onClickOutside?: (event: ClickEvent) => void;

package/dist/root.js

@@ -62,7 +62,7 @@ function waitForSocket(socket) {
 }
 function createRoot(options = {}) {
     if (!electron_1.app.isReady()) {
-        throw new Error("[placeholder copy: createRoot() needs electron to be ready. Run your entry with `pixel .`, which waits for app.whenReady() before loading it.]");
+        throw new Error("createRoot() needs electron to be ready. Run your entry with `pixel .`, which waits for app.whenReady() before loading it.");
     }
     const env = options.sessionEnv ?? process.env;
     const terminal = (0, terminal_1.detect)(env);
@@ -310,7 +310,7 @@ function createRoot(options = {}) {
             root.render((0, jsx_runtime_1.jsx)(webview_1.WebView, { ref: pageRef, src: url, style: { width: "100%", height: "100%" }, ...options }));
         });
         if (!pageRef.current)
-            throw new Error("[placeholder copy: the page did not mount]");
+            throw new Error("the page did not mount");
         return pageRef.current;
     };
     const root = {

package/dist/sandbox.js

@@ -11,7 +11,8 @@ const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = __importDefault(require("node:crypto"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-const REFUSAL = `[placeholder copy: the codex sandbox blocks commands pixel needs to run to determine the terminal pane it is running in.]
+// probably need app name injection support here
+const REFUSAL = `the codex sandbox blocks commands that are needed to determine the terminal pane the command is ran from.]
 Re-run this command with escalated permissions.`;
 function inCodex() {
     return Boolean(process.env.CODEX_THREAD_ID ?? process.env.CODEX_PERMISSION_PROFILE);

package/dist/ssh/index.d.ts

@@ -10,7 +10,6 @@ export interface RemoteBundle {
 }
 export type StatusLine = (line: string) => void;
 export interface SshOptions {
-    /** [placeholder copy: Whether ssh may use this process's terminal for password and host key prompts. Off when called from inside a running app, where the terminal is already taken; ssh then fails instead of prompting.] */
     terminal?: boolean;
 }
 export declare function parseSshTarget(target: string): {
@@ -26,20 +25,15 @@ export declare function resolveSshTarget(target: string): ResolvedTarget;
 export declare function validateSshTarget(target: string): void;
 export declare function openSshTunnel(target: string, status: StatusLine, options?: SshOptions): Promise<SshTunnel>;
 export interface SshSessionOptions extends SshOptions {
-    /** [placeholder copy: Where to connect, as you would type it after ssh: user@host, host:port, a full ssh command with flags, or a shell alias.] */
     target: string;
-    /** [placeholder copy: A directory to install and start on the host. It must hold an executable start that prints READY <url>; setup and stop are optional.] */
     bundle?: string | null;
-    /** [placeholder copy: Directory on the host that bundles are installed under.] */
     remoteBase?: string | null;
     status?: StatusLine;
 }
 export interface SshSession {
     destination: string;
     socksPort: number;
-    /** [placeholder copy: The url the bundle's start script announced, when a bundle was given.] */
     url: string | undefined;
-    /** [placeholder copy: Props for the WebView that should browse through this host: spread them onto it.] */
     view: {
         proxy: string;
         partition: string;

package/dist/ssh/index.js

@@ -21,7 +21,7 @@ const node_path_1 = __importDefault(require("node:path"));
 function parseSshTarget(target) {
     const match = /^([A-Za-z0-9._-]+@)?([A-Za-z0-9._-]+)(:(\d+))?$/.exec(target);
     if (!match) {
-        throw new Error(`[placeholder copy: invalid ssh target ${target} (user@host, host, user@host:port, or a shell alias for ssh)]`);
+        throw new Error(`invalid ssh target ${target} (user@host, host, user@host:port, or a shell alias for ssh)`);
     }
     return { destination: `${match[1] ?? ""}${match[2]}`, sshPort: match[4] ?? null };
 }
@@ -62,12 +62,12 @@ function parseSshWords(words, target) {
             continue;
         }
         if (found) {
-            throw new Error(`[placeholder copy: invalid ssh target ${target} (both ${found} and ${token} look like destinations)]`);
+            throw new Error(`invalid ssh target ${target} (both ${found} and ${token} look like destinations)`);
         }
         found = token;
     }
     if (!found)
-        throw new Error(`[placeholder copy: invalid ssh target ${target} (no destination)]`);
+        throw new Error(`invalid ssh target ${target} (no destination)`);
     const { destination, sshPort } = parseSshTarget(found);
     return { destination, hostArgs: [...hostArgs, ...(sshPort ? ["-p", sshPort] : [])] };
 }
@@ -151,7 +151,7 @@ async function openSshTunnel(target, status, options = {}) {
     });
     if (code !== 0) {
         const detail = stderr.filter(Boolean).join("\n");
-        throw new Error(`[placeholder copy: ssh to ${destination} failed${detail ? `: ${detail}` : ""}]`);
+        throw new Error(`ssh to ${destination} failed${detail ? `: ${detail}` : ""}`);
     }
     await waitForSocks(socksPort, destination);
     status(`connected ${destination}`);
@@ -170,9 +170,6 @@ async function openSshTunnel(target, status, options = {}) {
         },
     };
 }
-// The whole ssh mode in one step: tunnel, then bundle, then the props a page
-// needs to browse through the host. Stopping runs in reverse and also happens
-// when the process exits.
 async function connectSsh(options) {
     const status = options.status ?? (() => { });
     const terminal = options.terminal ?? true;
@@ -222,19 +219,19 @@ function validateBundleDir(dir) {
         stat = node_fs_1.default.statSync(dir);
     }
     catch {
-        throw new Error(`[placeholder copy: bundle ${dir} does not exist]`);
+        throw new Error(`bundle ${dir} does not exist`);
     }
     if (!stat.isDirectory())
-        throw new Error(`[placeholder copy: bundle ${dir} is not a directory]`);
+        throw new Error(`bundle ${dir} is not a directory`);
     let start;
     try {
         start = node_fs_1.default.statSync(node_path_1.default.join(dir, "start"));
     }
     catch {
-        throw new Error(`[placeholder copy: bundle ${dir} has no start script]`);
+        throw new Error(`bundle ${dir} has no start script`);
     }
     if (!start.isFile() || !(start.mode & 0o111)) {
-        throw new Error(`[placeholder copy: bundle ${dir}/start is not executable]`);
+        throw new Error(`bundle ${dir}/start is not executable`);
     }
 }
 const READY_TIMEOUT_MS = 120_000;
@@ -303,12 +300,12 @@ function upload(tunnel, dir, remoteDir) {
         maxBuffer: 256 * 1024 * 1024,
     });
     if (tar.status !== 0 || !tar.stdout)
-        throw new Error(`[placeholder copy: could not pack ${dir}]`);
+        throw new Error(`could not pack ${dir}`);
     const result = run(tunnel, `mkdir -p "${remoteDir}" && tar -xz -C "${remoteDir}"`, {
         input: tar.stdout,
     });
     if (result.status !== 0) {
-        throw new Error(`[placeholder copy: could not upload the bundle to ${tunnel.destination}]`);
+        throw new Error(`could not upload the bundle to ${tunnel.destination}`);
     }
 }
 function setup(tunnel, remoteDir, terminal, status) {
@@ -319,7 +316,7 @@ function setup(tunnel, remoteDir, terminal, status) {
                 status(line);
     }
     if (result.status !== 0) {
-        throw new Error(`[placeholder copy: the bundle's setup script failed on ${tunnel.destination}]`);
+        throw new Error(`the bundle's setup script failed on ${tunnel.destination}`);
     }
 }
 function launch(tunnel, name, remoteDir, status) {
@@ -358,7 +355,7 @@ function launch(tunnel, name, remoteDir, status) {
             }
         };
         const timer = setTimeout(() => {
-            finish(new Error(`[placeholder copy: ${name} never printed READY <url>]\n${tail.join("\n")}`));
+            finish(new Error(`${name} never printed READY <url>\n${tail.join("\n")}`));
         }, READY_TIMEOUT_MS);
         const sawLine = (line) => {
             tail.push(line);
@@ -369,7 +366,7 @@ function launch(tunnel, name, remoteDir, status) {
                 return;
             const url = pageUrl(ready[1]);
             if (!url) {
-                finish(new Error(`[placeholder copy: ${name} printed READY ${ready[1]}, which is not an http(s) url]`));
+                finish(new Error(`${name} printed READY ${ready[1]}, which is not an http(s) url`));
                 return;
             }
             status(`${name} is up at ${url}`);
@@ -390,7 +387,7 @@ function launch(tunnel, name, remoteDir, status) {
         child.once("close", (code) => {
             if (buffer.trim())
                 sawLine(buffer.trim());
-            finish(new Error(`[placeholder copy: ${name} exited with code ${code} before printing READY <url>]\n${tail.join("\n")}`));
+            finish(new Error(`${name} exited with code ${code} before printing READY <url>\n${tail.join("\n")}`));
         });
     });
 }
@@ -430,7 +427,7 @@ function waitForSocks(port, destination) {
         const socket = node_net_1.default.connect(port, "127.0.0.1");
         const timer = setTimeout(() => {
             socket.destroy();
-            reject(new Error(`[placeholder copy: the ssh proxy for ${destination} never started listening]`));
+            reject(new Error(`the ssh proxy for ${destination} never started listening`));
         }, 5000);
         socket.once("connect", () => {
             clearTimeout(timer);

package/dist/terminal/terminals/ghostty-script.js

@@ -61,13 +61,13 @@ function send(pid, eventClass, eventId, params) {
   const failure = Ref();
   const reply = event.sendEventWithOptionsTimeoutError(WAIT_FOR_REPLY, 10, failure);
   if (reply.isNil()) {
-    throw new Error("[placeholder copy: Ghostty (pid " + pid + ") did not answer: " + ObjC.unwrap(failure[0].localizedDescription) + "]");
+    throw new Error("Ghostty (pid " + pid + ") did not answer: " + ObjC.unwrap(failure[0].localizedDescription) );
   }
   const number = reply.paramDescriptorForKeyword(code("errn"));
   if (!number.isNil()) {
     const message = reply.paramDescriptorForKeyword(code("errs"));
     const detail = message.isNil() ? "" : ": " + ObjC.unwrap(message.stringValue);
-    const error = new Error("[placeholder copy: Ghostty (pid " + pid + ") refused the request (" + number.int32Value + ")" + detail + "]");
+    const error = new Error("Ghostty (pid " + pid + ") refused the request (" + number.int32Value + ")" + detail );
     error.code = number.int32Value;
     throw error;
   }

package/dist/terminal/terminals/ghostty.js

@@ -107,9 +107,9 @@ const ghostty = (env, run) => {
         if (running.length === 1)
             return running[0];
         if (running.length === 0) {
-            throw new Error("[placeholder copy: Ghostty is not running, so there is no window to script]");
+            throw new Error("Ghostty is not running, so there is no window to script");
         }
-        throw new Error(`[placeholder copy: ${running.length} Ghostty processes are running (pids ${running.join(", ")}) and this shell is not inside any of them, so we cannot tell which one to script]`);
+        throw new Error(`${running.length} Ghostty processes are running (pids ${running.join(", ")}) and this shell is not inside any of them, so we cannot tell which one to script`);
     }
     async function ghosttyCommand(command, args, tty = null) {
         return osascript(ghostty_script_1.GHOSTTY_SCRIPT, [String(await ownerPid(tty)), command, ...args]);

package/dist/webview.js

@@ -361,7 +361,7 @@ exports.WebView = (0, react_1.forwardRef)(function WebView(props, ref) {
         const host = () => {
             const current = hostRef.current;
             if (!current) {
-                throw new Error("[placeholder copy: this WebView has already been unmounted]");
+                throw new Error("this WebView has already been unmounted]");
             }
             return current;
         };
@@ -430,7 +430,7 @@ exports.WebView = (0, react_1.forwardRef)(function WebView(props, ref) {
                     width: page.width,
                     height: page.height,
                     cornerRadius: props.style?.cornerRadius,
-                    background: theme.bg,
+                    background: props.browserWindowOptions?.transparent ? undefined : theme.bg,
                     opaque: !props.browserWindowOptions?.transparent,
                 }, onPointer: (event) => {
                     if (menuRef.current) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@zenbu-labs/pixel",
-  "version": "0.0.20",
-  "description": "[placeholder copy: Electron apps that render into your terminal pane]",
+  "version": "0.0.22",
+  "description": "Build graphical applications in the terminal",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/zenbu-labs/pixel.git",
-    "directory": "packages/pixel"
+    "url": "git+https://github.com/zenbu-labs/terminal-browser.git",
+    "directory": "pixel/packages/pixel"
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -58,10 +58,10 @@
     "react": "^18.3.1"
   },
   "optionalDependencies": {
-    "@zenbu-labs/pixel-native-darwin-arm64": "0.0.20",
-    "@zenbu-labs/pixel-native-darwin-x64": "0.0.20",
-    "@zenbu-labs/pixel-native-linux-arm64": "0.0.20",
-    "@zenbu-labs/pixel-native-linux-x64": "0.0.20"
+    "@zenbu-labs/pixel-native-darwin-arm64": "0.0.22",
+    "@zenbu-labs/pixel-native-darwin-x64": "0.0.22",
+    "@zenbu-labs/pixel-native-linux-arm64": "0.0.22",
+    "@zenbu-labs/pixel-native-linux-x64": "0.0.22"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/scripts/postinstall.mjs

@@ -25,9 +25,15 @@ if (!platform) {
   process.exit(1);
 }
 
-const mirror =
-  process.env.PIXEL_ELECTRON_MIRROR ??
-  `https://github.com/zenbu-labs/pixel/releases/download/electron-v${version}`;
+// Patched electron builds are published as electron-v<version> releases. Newer ones live on
+// the terminal-browser repo, where pixel now lives; older ones stayed on the archived pixel repo.
+const mirrors = process.env.PIXEL_ELECTRON_MIRROR
+  ? [process.env.PIXEL_ELECTRON_MIRROR]
+  : [
+      `https://github.com/zenbu-labs/terminal-browser/releases/download/electron-v${version}`,
+      `https://github.com/zenbu-labs/pixel/releases/download/electron-v${version}`,
+    ];
+let mirror = mirrors[0];
 const zipName = `electron-v${version}-${platform}.zip`;
 
 async function fetchBytes(url) {
@@ -59,13 +65,22 @@ function readMarker(file) {
 fs.mkdirSync(electronDir, { recursive: true });
 
 let shasums;
-try {
-  shasums = (await fetchBytes(`${mirror}/SHASUMS256.txt`)).toString("utf8");
-} catch (error) {
+let lastError;
+for (const candidate of mirrors) {
+  try {
+    shasums = (await fetchBytes(`${candidate}/SHASUMS256.txt`)).toString("utf8");
+    mirror = candidate;
+    break;
+  } catch (error) {
+    lastError = error;
+  }
+}
+if (!shasums) {
+  const error = lastError;
   if (skipBinary && fs.existsSync(typesFile)) process.exit(0);
   process.stderr.write(
-    `pixel: [placeholder copy: no patched electron v${version} is published (${error.message}). ` +
-      `This release of pixel is built against electron ${version}; a newer pixel may be needed.]\n`,
+    `pixel: no patched electron v${version} is published (${error.message}). ` +
+      `This release of pixel is built against electron ${version}; a newer pixel may be needed.\n`,
   );
   process.exit(1);
 }