@0xbigboss/ghostty-web 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Coder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# ghostty-web
+
+[![NPM Version](https://img.shields.io/npm/v/ghostty-web)](https://npmjs.com/package/ghostty-web) [![NPM Downloads](https://img.shields.io/npm/dw/ghostty-web)](https://npmjs.com/package/ghostty-web) [![npm bundle size](https://img.shields.io/bundlephobia/minzip/ghostty-web)](https://npmjs.com/package/ghostty-web) [![license](https://img.shields.io/github/license/coder/ghostty-web)](./LICENSE)
+
+[Ghostty](https://github.com/ghostty-org/ghostty) for the web with [xterm.js](https://github.com/xtermjs/xterm.js) API compatibility — giving you a proper VT100 implementation in the browser.
+
+- Migrate from xterm by changing your import: `@xterm/xterm` → `ghostty-web`
+- WASM-compiled parser from Ghostty—the same code that runs the native app
+- Zero runtime dependencies, ~400KB WASM bundle
+
+Originally created for [Mux](https://github.com/coder/mux) (a desktop app for isolated, parallel agentic development), but designed to be used anywhere.
+
+## Try It
+
+- [Live Demo](https://ghostty.ondis.co) on an ephemeral VM (thank you to Greg from [disco.cloud](https://disco.cloud) for hosting).
+
+- On your computer:
+
+  ```bash
+  npx @ghostty-web/demo@next
+  ```
+
+  This starts a local HTTP server with a real shell on `http://localhost:8080`. Works best on Linux and macOS.
+
+![ghostty](https://github.com/user-attachments/assets/aceee7eb-d57b-4d89-ac3d-ee1885d0187a)
+
+## Comparison with xterm.js
+
+xterm.js is everywhere—VS Code, Hyper, countless web terminals. But it has fundamental issues:
+
+| Issue                                    | xterm.js                                                         | ghostty-web                |
+| ---------------------------------------- | ---------------------------------------------------------------- | -------------------------- |
+| **Complex scripts** (Devanagari, Arabic) | Rendering issues                                                 | ✓ Proper grapheme handling |
+| **XTPUSHSGR/XTPOPSGR**                   | [Not supported](https://github.com/xtermjs/xterm.js/issues/2570) | ✓ Full support             |
+
+xterm.js reimplements terminal emulation in JavaScript. Every escape sequence, every edge case, every Unicode quirk—all hand-coded. Ghostty's emulator is the same battle-tested code that runs the native Ghostty app.
+
+## Installation
+
+```bash
+npm install ghostty-web
+```
+
+## Usage
+
+ghostty-web aims to be API-compatible with the xterm.js API.
+
+```javascript
+import { init, Terminal } from 'ghostty-web';
+
+await init();
+
+const term = new Terminal({
+  fontSize: 14,
+  theme: {
+    background: '#1a1b26',
+    foreground: '#a9b1d6',
+  },
+});
+
+term.open(document.getElementById('terminal'));
+term.onData((data) => websocket.send(data));
+websocket.onmessage = (e) => term.write(e.data);
+```
+
+For a comprehensive client <-> server example, refer to the [demo](./demo/index.html#L141).
+
+## Development
+
+ghostty-web builds from Ghostty's source with a [patch](./patches/ghostty-wasm-api.patch) to expose additional
+functionality.
+
+> Requires Zig and Bun.
+
+```bash
+bun run build
+```
+
+Mitchell Hashimoto (author of Ghostty) has [been working](https://mitchellh.com/writing/libghostty-is-coming) on `libghostty` which makes this all possible. The patches are very minimal thanks to the work the Ghostty team has done, and we expect them to get smaller.
+
+This library will eventually consume a native Ghostty WASM distribution once available, and will continue to provide an xterm.js compatible API.
+
+At Coder we're big fans of Ghostty, so kudos to that team for all the amazing work.
+
+## License
+
+[MIT](./LICENSE)

package/dist/__vite-browser-external-2447137e.js

@@ -0,0 +1,4 @@
+const e = {};
+export {
+  e as default
+};