chore: configure package for npm publishing as @coder/ghostty-web (#17)

* Configure package for npm publishing as @coder/ghostty-web

- Update package.json with @coder/ghostty-web name and npm metadata
- Add proper exports field for ES module, UMD, and TypeScript declarations
- Configure vite-plugin-dts for automatic TypeScript declaration generation
- Update vite.config.js to build ghostty-web.js/umd.cjs outputs
- Create .npmignore to exclude dev files from npm package
- Add INSTALL.md with complete installation and usage guide
- Update README.md with npm installation instructions
- Add build scripts for clean builds with WASM copying

Package is now ready for publishing to npm registry.
Files included: dist/, ghostty-vt.wasm, README.md, INSTALL.md
Build outputs: ghostty-web.js (ES), ghostty-web.umd.cjs (UMD), index.d.ts (types)

Author: sreya

.npmignore

@@ -0,0 +1,14 @@
+# Exclude development files from npm package
+demo/
+docs/
+scripts/
+lib/**/*.test.ts
+.git*
+*.log
+node_modules/
+bun.lock
+roadmap.md
+AGENTS.md
+run-demo.sh
+vite.config.js
+tsconfig.json

INSTALL.md

@@ -0,0 +1,159 @@
+# Installation & Usage
+
+## Installation
+
+```bash
+npm install @coder/ghostty-web
+# or
+bun add @coder/ghostty-web
+# or
+yarn add @coder/ghostty-web
+```
+
+## Basic Usage
+
+```typescript
+import { Terminal } from '@coder/ghostty-web';
+
+const term = new Terminal({
+  cols: 80,
+  rows: 24,
+  cursorBlink: true,
+  theme: {
+    background: '#1e1e1e',
+    foreground: '#d4d4d4',
+  },
+});
+
+// Mount to DOM
+await term.open(document.getElementById('terminal'));
+
+// Write output
+term.write('Hello, World!\r\n');
+term.write('\x1b[1;32mGreen text\x1b[0m\r\n');
+
+// Handle user input
+term.onData((data) => {
+  console.log('User typed:', data);
+  // Send to backend, echo, etc.
+});
+```
+
+## With FitAddon (Responsive Sizing)
+
+```typescript
+import { Terminal, FitAddon } from '@coder/ghostty-web';
+
+const term = new Terminal();
+const fitAddon = new FitAddon();
+term.loadAddon(fitAddon);
+
+await term.open(document.getElementById('terminal'));
+fitAddon.fit(); // Resize to container
+
+// Resize on window resize
+window.addEventListener('resize', () => fitAddon.fit());
+```
+
+## WebSocket Integration
+
+```typescript
+import { Terminal } from '@coder/ghostty-web';
+
+const term = new Terminal();
+await term.open(document.getElementById('terminal'));
+
+const ws = new WebSocket('ws://localhost:3001/ws');
+
+// Send user input to backend
+term.onData((data) => {
+  ws.send(JSON.stringify({ type: 'input', data }));
+});
+
+// Display backend output
+ws.onmessage = (event) => {
+  const msg = JSON.parse(event.data);
+  term.write(msg.data);
+};
+```
+
+## WASM File Handling
+
+The library requires the `ghostty-vt.wasm` file at runtime. Most bundlers handle this automatically.
+
+### Vite (Recommended)
+
+Vite handles WASM automatically. No extra config needed:
+
+```javascript
+// vite.config.js
+export default {
+  // WASM works out of the box
+};
+```
+
+### Webpack
+
+Configure WASM as an asset:
+
+```javascript
+// webpack.config.js
+module.exports = {
+  module: {
+    rules: [
+      {
+        test: /\.wasm$/,
+        type: 'asset/resource',
+      },
+    ],
+  },
+};
+```
+
+### Manual Import (Advanced)
+
+```typescript
+import wasmUrl from '@coder/ghostty-web/ghostty-vt.wasm?url';
+import { Ghostty } from '@coder/ghostty-web';
+
+const ghostty = await Ghostty.load(wasmUrl);
+```
+
+## TypeScript Support
+
+Full TypeScript definitions are included:
+
+```typescript
+import { Terminal, ITerminalOptions, ITheme } from '@coder/ghostty-web';
+
+const options: ITerminalOptions = {
+  cols: 80,
+  rows: 24,
+  cursorBlink: true,
+};
+
+const theme: ITheme = {
+  background: '#1e1e1e',
+  foreground: '#d4d4d4',
+  cursor: '#ffffff',
+};
+```
+
+## API Documentation
+
+See [API.md](https://github.com/coder/ghostty-web/blob/main/packaging/docs/API.md) for complete API reference.
+
+## Migration from xterm.js
+
+This library follows xterm.js conventions:
+
+```typescript
+// Before (xterm.js)
+import { Terminal } from 'xterm';
+import { FitAddon } from 'xterm-addon-fit';
+
+// After (@coder/ghostty-web)
+import { Terminal, FitAddon } from '@coder/ghostty-web';
+```
+
+Most xterm.js code works with minimal changes. See [API.md](https://github.com/coder/ghostty-web/blob/main/packaging/docs/API.md) for differences.

README.md

@@ -1,28 +1,41 @@
-# Ghostty WASM Terminal
+# Ghostty Web
 
-A terminal emulator that integrates [Ghostty's](https://github.com/ghostty-org/ghostty) VT100 parser via WebAssembly.
+A web-based terminal emulator that integrates [Ghostty's](https://github.com/ghostty-org/ghostty) VT100 parser via WebAssembly.
 
-## What This Is
+## Installation
 
-This repository provides a **foundation for building web-based terminals** using Ghostty's production-tested VT100 parser compiled to WebAssembly.
+```bash
+npm install @coder/ghostty-web
+```
 
-**What's implemented:**
+## Quick Start
 
-- ✅ Full terminal emulator with screen buffer, VT parser, canvas renderer
-- ✅ TypeScript wrapper for libghostty-vt WASM API
-- ✅ SGR parser (ANSI colors, 256-color, RGB true color)
-- ✅ Key encoder (keyboard events → escape sequences)
-- ✅ FitAddon for responsive terminal sizing
-- ✅ Interactive demos (file browser, color showcase)
-- ✅ xterm.js-compatible API
+```typescript
+import { Terminal } from '@coder/ghostty-web';
 
-**MVP Complete!** See demos below.
+const term = new Terminal({ cols: 80, rows: 24 });
+await term.open(document.getElementById('terminal'));
+term.write('Hello, World!\r\n');
+```
 
-## Quick Start
+See [INSTALL.md](./INSTALL.md) for complete usage guide.
+
+## Features
+
+- ✅ Full xterm.js-compatible API
+- ✅ Production-tested VT100 parser (via Ghostty)
+- ✅ ANSI colors (16, 256, RGB true color)
+- ✅ Canvas rendering at 60 FPS
+- ✅ Scrollback buffer
+- ✅ Text selection & clipboard
+- ✅ FitAddon for responsive sizing
+- ✅ TypeScript declarations included
+
+## Development & Demos
 
-### Run the Terminal
+### Shell Terminal Demo
 
-**Shell Terminal** (requires server)
+**Requires server**
 
 ```bash
 # Terminal 1: Start PTY shell server