@strantalis/workset-ghostty-web 0.3.1-workset.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,90 @@
+# @strantalis/workset-ghostty-web
+
+[![NPM Version](https://img.shields.io/npm/v/%40strantalis%2Fworkset-ghostty-web)](https://npmjs.com/package/@strantalis/workset-ghostty-web) [![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40strantalis%2Fworkset-ghostty-web)](https://npmjs.com/package/@strantalis/workset-ghostty-web) [![license](https://img.shields.io/github/license/strantalis/ghostty-web)](./LICENSE)
+
+> [!WARNING]
+> This is a temporary, unsupported Workset fork of `ghostty-web`.
+> It exists only to carry fixes until they merge back upstream.
+> If you are not working on Workset, use upstream `ghostty-web` instead.
+
+[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` → `@strantalis/workset-ghostty-web`
+- WASM-compiled parser from Ghostty—the same code that runs the native app
+- Zero runtime dependencies, ~400KB WASM bundle
+
+This fork tracks upstream work on `main` and publishes Workset-specific builds from `workset-release`.
+
+## Try It
+
+![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 @strantalis/workset-ghostty-web
+```
+
+## Usage
+
+`@strantalis/workset-ghostty-web` aims to stay API-compatible with the xterm.js API while Workset carries temporary fork-only fixes.
+
+```javascript
+import { init, Terminal } from '@strantalis/workset-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));
+term.onResponse((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.
+
+Ghostty itself remains the real source of truth here, so kudos to that team for all the amazing work.
+
+## Support Status
+
+- `main` is reserved for upstream sync work in this fork.
+- `workset-release` is the protected Workset integration and publish branch.
+- Publish from this fork only when Workset needs a packaged fix that has not landed upstream yet.
+- Once upstream ships the required fixes, Workset should move back to the upstream package.
+
+## License
+
+[MIT](./LICENSE)

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

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