wongtty 0.0.0-stage → 0.0.2

package/dist/xterm.d.ts

@@ -0,0 +1,6 @@
+export * from './xterm_web.js';
+
+type WasmSource = URL | string | ArrayBuffer | ArrayBufferView | WebAssembly.Module | Response;
+
+/** Loads the engine (`wongtty.wasm`) and the front end (`xterm_web_bg.wasm`) once; call before `new Terminal()`. */
+export function init(engine?: WasmSource, frontEnd?: WasmSource): Promise<void>;

package/dist/xterm.js

@@ -0,0 +1,32 @@
+// wongtty/xterm: the Rust front end (xterm_web.js, generated by wasm-bindgen from crates/wongtty-web) over the wongtty
+// engine (index.js). `init()` loads both WebAssembly modules; everything else is the generated binding.
+import { init as initEngine } from './index.js';
+import initFrontEnd, { Terminal as FrontEndTerminal } from './xterm_web.js';
+
+export * from './xterm_web.js';
+
+let ready = false;
+
+/** The generated `Terminal`, with a clear error before `init()` has finished (the glue fails with a TypeError). */
+export class Terminal extends FrontEndTerminal {
+  constructor(options) {
+    if (!ready) throw new Error('wongtty/xterm: await init() before new Terminal()');
+    super(options);
+  }
+}
+
+/** Loads the engine and the front end once. Sources default to the files next to this module. */
+export async function init(engine, frontEnd) {
+  await Promise.all([initEngine(engine), initFrontEnd({ module_or_path: frontEnd ?? (await defaultFrontEnd()) })]);
+  ready = true;
+}
+
+// Node cannot fetch file: URLs; read the file there, like index.js does for the engine.
+async function defaultFrontEnd() {
+  const url = new URL('./xterm_web_bg.wasm', import.meta.url);
+  if (url.protocol !== 'file:') return url;
+  // Keep the name in a variable so browser bundlers do not follow the node: module.
+  const fsModule = 'node:fs/promises';
+  const { readFile } = await import(/* @vite-ignore */ /* webpackIgnore: true */ fsModule);
+  return readFile(url);
+}