wgsl-analyzer-web 0.12.0-next.0

package/dist/fs.js

@@ -0,0 +1,21 @@
+/**
+ * Seeding the emscripten in-memory filesystem.
+ *
+ * This runs once the module factory has resolved, and before `callMain`,
+ * so the workspace is already on disk by the time the server's VFS scans it.
+ */
+/** Writes one file, creating its parent directories first. */
+export function writeFile(fs, path, contents) {
+    const slash = path.lastIndexOf("/");
+    if (slash > 0)
+        fs.mkdirTree(path.slice(0, slash));
+    fs.writeFile(path, contents);
+}
+/** Populates `root` with `files`, whose keys are paths relative to it. */
+export function seedWorkspace(fs, root, files) {
+    fs.mkdirTree(root);
+    for (const [relative, contents] of Object.entries(files)) {
+        writeFile(fs, `${root}/${relative.replace(/^\/+/, "")}`, contents);
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,EAAgB,EAAE,IAAY,EAAE,QAA6B;IACtF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAC5B,EAAgB,EAChB,IAAY,EACZ,KAA0C;IAE1C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnB,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;AACF,CAAC"}

package/dist/host.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hosts the emscripten module: boots it, seeds the workspace, and carries the
+ * message stream.
+ */
+import type { ModuleFactory } from "./emscripten.js";
+import type { WorkspaceFiles } from "./protocol.js";
+export interface HostOptions {
+    /** Absolute path of the workspace inside the in-memory filesystem. */
+    readonly root: string;
+    /** Files to seed, keyed by path relative to {@link HostOptions.root}. */
+    readonly files: WorkspaceFiles;
+    /** argv for `main()`. Empty selects the default `lsp-server` subcommand. */
+    readonly args: readonly string[];
+    /** Receives each parsed JSON-RPC message from the server. */
+    readonly onMessage: (message: unknown) => void;
+    /** Receives the server's stderr, line by line. */
+    readonly onStderr: (line: string) => void;
+    /** Called if `main()` returns. */
+    readonly onExit: (code: number) => void;
+}
+/** A running server. Once it has exited, every method does nothing. */
+export interface Host {
+    /** Sends one JSON-RPC message to the server. */
+    send(message: unknown): void;
+    /** Creates or replaces a workspace file, given its path relative to the root. */
+    writeFile(relativePath: string, contents: string | Uint8Array): void;
+    /** Removes a workspace file, if present. */
+    deleteFile(relativePath: string): void;
+}
+/** Boots the server and resolves once `main()` has been started. */
+export declare function startHost(factory: ModuleFactory, options: HostOptions): Promise<Host>;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,uEAAuE;AACvE,MAAM,WAAW,IAAI;IACpB,gDAAgD;IAChD,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,iFAAiF;IACjF,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACrE,4CAA4C;IAC5C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,oEAAoE;AACpE,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C3F"}

package/dist/host.js

@@ -0,0 +1,53 @@
+/**
+ * Hosts the emscripten module: boots it, seeds the workspace, and carries the
+ * message stream.
+ */
+import { seedWorkspace, writeFile } from "./fs.js";
+/** Boots the server and resolves once `main()` has been started. */
+export async function startHost(factory, options) {
+    const { root } = options;
+    const resolve = (relativePath) => `${root}/${relativePath.replace(/^\/+/, "")}`;
+    // Messages for the server, which pulls them one at a time. It never closes.
+    const inbox = new TransformStream();
+    const reader = inbox.readable.getReader();
+    const writer = inbox.writable.getWriter();
+    // With `-sEXIT_RUNTIME`, calling into the module after `main()` returns is an
+    // error, and the page can still send messages after that.
+    let exited = false;
+    const module = await factory({
+        noInitialRun: true,
+        printErr: options.onStderr,
+        onExit: (code) => {
+            exited = true;
+            // Messages are delivered from microtasks too, so those sent before exiting come first.
+            queueMicrotask(() => options.onExit(code));
+        },
+        lspNextMessage: () => reader.read().then(({ value }) => value),
+        lspOnMessage: (body) => options.onMessage(JSON.parse(body)),
+    });
+    // Needs to run after WasmFS was iniialized.
+    seedWorkspace(module.FS, root, options.files);
+    module.FS.chdir(root);
+    // WasmFS's `chdir` does not go through `FS.handleError`, so a failure is
+    // otherwise silent.
+    if (module.FS.cwd() !== root)
+        throw new Error(`cannot change directory to ${root}`);
+    // Returns immediately: -sPROXY_TO_PTHREAD runs main() on a pthread.
+    module.callMain(options.args);
+    return {
+        send: (message) => {
+            if (!exited)
+                void writer.write(JSON.stringify(message));
+        },
+        writeFile: (relativePath, contents) => {
+            if (!exited)
+                writeFile(module.FS, resolve(relativePath), contents);
+        },
+        deleteFile: (relativePath) => {
+            const path = resolve(relativePath);
+            if (!exited && module.FS.analyzePath(path).exists)
+                module.FS.unlink(path);
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AA4BnD,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB,EAAE,OAAoB;IAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,MAAM,OAAO,GAAG,CAAC,YAAoB,EAAU,EAAE,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;IAEhG,4EAA4E;IAC5E,MAAM,KAAK,GAAG,IAAI,eAAe,EAAkB,CAAC;IACpD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IAE1C,8EAA8E;IAC9E,0DAA0D;IAC1D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC5B,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,GAAG,IAAI,CAAC;YACd,uFAAuF;YACvF,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAe,CAAC;QACxE,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KAC3D,CAAC,CAAC;IAEH,4CAA4C;IAC5C,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,yEAAyE;IACzE,oBAAoB;IACpB,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAEpF,oEAAoE;IACpE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,IAAI,CAAC,MAAM;gBAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,SAAS,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM;gBAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;QACD,UAAU,EAAE,CAAC,YAAY,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM;gBAAE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * wgsl-analyzer as a language server in a Web Worker.
+ *
+ * The server is the `wgsl-analyzer` binary compiled to
+ * `wasm32-unknown-emscripten`, running its ordinary `main_loop` over a transport.
+ * This module hosts it and exposes the message stream.
+ *
+ * The page must be cross-origin isolated. The build uses shared memory, so
+ * without `Cross-Origin-Opener-Policy: same-origin` and
+ * `Cross-Origin-Embedder-Policy: require-corp` nothing will start.
+ */
+import type { WorkspaceFiles } from "./protocol.js";
+export type { WorkspaceFiles } from "./protocol.js";
+export interface StartOptions {
+    /**
+     * Directory serving `worker.js`, `wgsl_analyzer.js` and `wgsl_analyzer.wasm`.
+     * They must sit side by side. Defaults to `"/wgsl-analyzer/"`.
+     */
+    readonly baseUrl?: string | URL;
+    /** Absolute path of the workspace in the in-memory filesystem. Defaults to `"/workspace"`. */
+    readonly root?: string;
+    /** Files to seed, keyed by path relative to {@link StartOptions.root}. */
+    readonly files: WorkspaceFiles;
+    /** argv for `main()`. Empty selects the default `lsp-server` subcommand. */
+    readonly args?: readonly string[];
+    /** Receives the server's stderr, line by line. */
+    readonly onStderr?: (line: string) => void;
+    /** Called if `main()` returns. */
+    readonly onExit?: (code: number) => void;
+}
+export interface Disposable {
+    dispose(): void;
+}
+/** A running wgsl-analyzer language server. */
+export declare class WgslAnalyzerServer {
+    #private;
+    private constructor();
+    /** The workspace root as a URI, suitable for `initialize`. */
+    get rootUri(): string;
+    /** Builds the URI of a workspace file, given its path relative to the root. */
+    uriOf(relativePath: string): string;
+    /** Boots the server and resolves once it is ready to accept messages. */
+    static start(options: StartOptions): Promise<WgslAnalyzerServer>;
+    /** Sends one JSON-RPC message to the server. */
+    sendMessage(message: unknown): void;
+    /** Subscribes to messages coming back from the server. */
+    onMessage(listener: (message: unknown) => void): Disposable;
+    /**
+     * Creates or replaces a file in the in-memory filesystem.
+     *
+     * The server does not watch the filesystem, so follow this with a
+     * `workspace/didChangeWatchedFiles` notification for the file. Edits to an
+     * open document go through `textDocument/didChange` instead.
+     */
+    writeFile(relativePath: string, contents: string | Uint8Array): void;
+    /** Removes a file from the in-memory filesystem. See {@link WgslAnalyzerServer.writeFile}. */
+    deleteFile(relativePath: string): void;
+    /** Stops the server and tears down the worker. */
+    dispose(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAA8B,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhF,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,+CAA+C;AAC/C,qBAAa,kBAAkB;;IAM9B,OAAO,eAGN;IAED,8DAA8D;IAC9D,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,+EAA+E;IAC/E,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElC;IAED,yEAAyE;IACzE,OAAa,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuDrE;IAED,gDAAgD;IAChD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIlC;IAED,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,UAAU,CAO1D;IAED;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAGnE;IAED,8FAA8F;IAC9F,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAGrC;IAED,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAUd;CACD"}

package/dist/index.js

@@ -0,0 +1,125 @@
+/**
+ * wgsl-analyzer as a language server in a Web Worker.
+ *
+ * The server is the `wgsl-analyzer` binary compiled to
+ * `wasm32-unknown-emscripten`, running its ordinary `main_loop` over a transport.
+ * This module hosts it and exposes the message stream.
+ *
+ * The page must be cross-origin isolated. The build uses shared memory, so
+ * without `Cross-Origin-Opener-Policy: same-origin` and
+ * `Cross-Origin-Embedder-Policy: require-corp` nothing will start.
+ */
+/** A running wgsl-analyzer language server. */
+export class WgslAnalyzerServer {
+    #worker;
+    #listeners = new Set();
+    #root;
+    #disposed = false;
+    constructor(worker, root) {
+        this.#worker = worker;
+        this.#root = root;
+    }
+    /** The workspace root as a URI, suitable for `initialize`. */
+    get rootUri() {
+        return `file://${this.#root}`;
+    }
+    /** Builds the URI of a workspace file, given its path relative to the root. */
+    uriOf(relativePath) {
+        return `file://${this.#root}/${relativePath.replace(/^\/+/, "")}`;
+    }
+    /** Boots the server and resolves once it is ready to accept messages. */
+    static async start(options) {
+        const base = new URL(String(options.baseUrl ?? "/wgsl-analyzer/"), globalThis.location.href);
+        const root = options.root ?? "/workspace";
+        const worker = new Worker(new URL("worker.js", base), { type: "module" });
+        const server = new WgslAnalyzerServer(worker, root);
+        await new Promise((resolve, reject) => {
+            const onFirstMessage = (event) => {
+                const message = event.data;
+                if (message.type === "ready") {
+                    worker.removeEventListener("message", onFirstMessage);
+                    resolve();
+                }
+                else if (message.type === "error") {
+                    worker.removeEventListener("message", onFirstMessage);
+                    reject(new Error(`${message.message}\n${message.stack ?? ""}`));
+                }
+            };
+            worker.addEventListener("message", onFirstMessage);
+            worker.addEventListener("error", (event) => reject(new Error(`worker failed to load: ${event.message}`)), { once: true });
+            const boot = {
+                type: "boot",
+                root,
+                files: options.files,
+                args: options.args ?? [],
+            };
+            worker.postMessage(boot);
+        });
+        worker.addEventListener("message", (event) => {
+            const message = event.data;
+            switch (message.type) {
+                case "lsp":
+                    for (const listener of server.#listeners)
+                        listener(message.message);
+                    break;
+                case "stderr":
+                    options.onStderr?.(message.line);
+                    break;
+                case "exit":
+                    options.onExit?.(message.code);
+                    break;
+                case "error":
+                    options.onStderr?.(`[worker] ${message.message}`);
+                    break;
+                default:
+                    break;
+            }
+        });
+        return server;
+    }
+    /** Sends one JSON-RPC message to the server. */
+    sendMessage(message) {
+        if (this.#disposed)
+            throw new Error("server has been disposed");
+        const envelope = { type: "lsp", message };
+        this.#worker.postMessage(envelope);
+    }
+    /** Subscribes to messages coming back from the server. */
+    onMessage(listener) {
+        this.#listeners.add(listener);
+        return {
+            dispose: () => {
+                this.#listeners.delete(listener);
+            },
+        };
+    }
+    /**
+     * Creates or replaces a file in the in-memory filesystem.
+     *
+     * The server does not watch the filesystem, so follow this with a
+     * `workspace/didChangeWatchedFiles` notification for the file. Edits to an
+     * open document go through `textDocument/didChange` instead.
+     */
+    writeFile(relativePath, contents) {
+        const message = { type: "writeFile", path: relativePath, contents };
+        this.#worker.postMessage(message);
+    }
+    /** Removes a file from the in-memory filesystem. See {@link WgslAnalyzerServer.writeFile}. */
+    deleteFile(relativePath) {
+        const message = { type: "deleteFile", path: relativePath };
+        this.#worker.postMessage(message);
+    }
+    /** Stops the server and tears down the worker. */
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#listeners.clear();
+        // `exit` ends the server's main loop, if the server reads it before the
+        // worker is terminated on the next macrotask.
+        const exit = { type: "lsp", message: { jsonrpc: "2.0", method: "exit" } };
+        this.#worker.postMessage(exit);
+        setTimeout(() => this.#worker.terminate(), 0);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Control messages exchanged between the page and the worker hosting the
+ * emscripten module.
+ */
+/** Contents of a workspace, keyed by path relative to its root in the in-memory filesystem. */
+export type WorkspaceFiles = Record<string, string | Uint8Array>;
+/** Page to worker. */
+export type HostMessage = {
+    readonly type: "boot";
+    readonly root: string;
+    readonly files: WorkspaceFiles;
+    readonly args: readonly string[];
+} | {
+    readonly type: "lsp";
+    readonly message: unknown;
+} | {
+    readonly type: "writeFile";
+    readonly path: string;
+    readonly contents: string | Uint8Array;
+} | {
+    readonly type: "deleteFile";
+    readonly path: string;
+};
+/** Worker to page. */
+export type WorkerMessage = {
+    readonly type: "ready";
+} | {
+    readonly type: "lsp";
+    readonly message: unknown;
+} | {
+    readonly type: "stderr";
+    readonly line: string;
+} | {
+    readonly type: "exit";
+    readonly code: number;
+} | {
+    readonly type: "error";
+    readonly message: string;
+    readonly stack?: string | undefined;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+FAA+F;AAC/F,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAEjE,sBAAsB;AACtB,MAAM,MAAM,WAAW,GACpB;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,sBAAsB;AACtB,MAAM,MAAM,aAAa,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,6 @@
+/**
+ * Control messages exchanged between the page and the worker hosting the
+ * emscripten module.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/worker.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Worker entry point: relays between the page and the {@link Host}.
+ *
+ * This file is bundled to `dist/worker.js` and must be served next to
+ * `wgsl_analyzer.js`. The dynamic import below resolves relative to it, and the
+ * glue spawns its pthread pool with
+ * `new Worker(new URL("wgsl_analyzer.js", import.meta.url))`.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/worker.js

@@ -0,0 +1,53 @@
+/**
+ * Worker entry point: relays between the page and the {@link Host}.
+ *
+ * This file is bundled to `dist/worker.js` and must be served next to
+ * `wgsl_analyzer.js`. The dynamic import below resolves relative to it, and the
+ * glue spawns its pthread pool with
+ * `new Worker(new URL("wgsl_analyzer.js", import.meta.url))`.
+ */
+import { startHost } from "./host.js";
+const post = (message) => {
+    self.postMessage(message);
+};
+let host = null;
+self.onmessage = (event) => {
+    const message = event.data;
+    switch (message.type) {
+        case "boot":
+            boot(message).catch((error) => {
+                post({
+                    type: "error",
+                    message: String(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+            });
+            break;
+        case "lsp":
+            host?.send(message.message);
+            break;
+        case "writeFile":
+            host?.writeFile(message.path, message.contents);
+            break;
+        case "deleteFile":
+            host?.deleteFile(message.path);
+            break;
+        default:
+            break;
+    }
+};
+async function boot(message) {
+    // Left external by the bundler so it resolves next to dist/worker.js at
+    // runtime rather than being inlined.
+    const { default: createWgslAnalyzer } = await import("./wgsl_analyzer.js");
+    host = await startHost(createWgslAnalyzer, {
+        root: message.root,
+        files: message.files,
+        args: message.args,
+        onMessage: (lsp) => post({ type: "lsp", message: lsp }),
+        onStderr: (line) => post({ type: "stderr", line }),
+        onExit: (code) => post({ type: "exit", code }),
+    });
+    post({ type: "ready" });
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAa,SAAS,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,IAAI,GAAG,CAAC,OAAsB,EAAQ,EAAE;IAC7C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,IAAI,IAAI,GAAgB,IAAI,CAAC;AAE7B,IAAI,CAAC,SAAS,GAAG,CAAC,KAAgC,EAAQ,EAAE;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,MAAM;YACV,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtC,IAAI,CAAC;oBACJ,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;oBACtB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBACvD,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,MAAM;QACP,KAAK,KAAK;YACT,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM;QACP,KAAK,WAAW;YACf,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM;QACP,KAAK,YAAY;YAChB,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM;QACP;YACC,MAAM;IACR,CAAC;AACF,CAAC,CAAC;AAEF,KAAK,UAAU,IAAI,CAAC,OAA+C;IAClE,wEAAwE;IACxE,qCAAqC;IACrC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE3E,IAAI,GAAG,MAAM,SAAS,CAAC,kBAAkB,EAAE;QAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QACvD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC9C,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "wgsl-analyzer-web",
+  "version": "0.12.0-next.0",
+  "description": "Run the wgsl-analyzer language server in a Web Worker",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wgsl-analyzer/wgsl-analyzer"
+  },
+  "keywords": [
+    "wgsl",
+    "wesl",
+    "language-server",
+    "lsp",
+    "wasm",
+    "web-worker"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./assets/*": "./dist/assets/*"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE-APACHE",
+    "LICENSE-MIT"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.8",
+    "@tsconfig/strictest": "^2.0.8",
+    "@types/node": "^26.4.1",
+    "esbuild": "^0.28.2",
+    "typescript": "^7.0.2",
+    "vscode-jsonrpc": "^9.0.2"
+  },
+  "scripts": {
+    "build": "pnpm run build:lib && pnpm run build:worker",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build:lib": "pnpm run clean && tsc",
+    "build:worker": "esbuild src/worker.ts --bundle --format=esm --target=es2024 --external:./wgsl_analyzer.js --outfile=dist/assets/worker.js",
+    "check": "pnpm exec biome check",
+    "ci": "pnpm exec biome ci && pnpm run typecheck",
+    "fix": "pnpm exec biome check --write",
+    "format": "pnpm exec biome format --write",
+    "lint": "pnpm exec biome lint",
+    "test": "node --test \"tests/unit/*.test.ts\"",
+    "test:smoke": "node --test --test-force-exit --test-concurrency=1 \"tests/smoke/*.test.ts\"",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.node.json"
+  }
+}

package/src/emscripten.ts

@@ -0,0 +1,28 @@
+/**
+ * The emscripten module surface this package drives.
+ */
+
+import type { EmscriptenFs } from "./fs.js";
+
+/** The emscripten module members this package touches. */
+export interface EmscriptenModule {
+	FS: EmscriptenFs;
+	// Functions provided by emscripten, see https://emscripten.org/docs/api_reference/index.html.
+	callMain(args: readonly string[]): void;
+}
+
+export interface ModuleOptions {
+	noInitialRun: boolean;
+	printErr: (line: string) => void;
+	onExit: (code: number) => void;
+	// The transport, called by emscripten/library.js.
+	/**
+	 * Resolves to the next message for the server. It may run inside another call into the
+	 * module, so it must not call into the module itself, and it must never reject.
+	 */
+	lspNextMessage: () => Promise<string>;
+	/** Receives one message from the server, from a microtask. */
+	lspOnMessage: (body: string) => void;
+}
+
+export type ModuleFactory = (options: ModuleOptions) => Promise<EmscriptenModule>;

package/src/fs.ts

@@ -0,0 +1,39 @@
+/**
+ * Seeding the emscripten in-memory filesystem.
+ *
+ * This runs once the module factory has resolved, and before `callMain`,
+ * so the workspace is already on disk by the time the server's VFS scans it.
+ */
+
+/**
+ * The subset of emscripten's `FS` module this package relies on.
+ *
+ * https://emscripten.org/docs/api_reference/Filesystem-API.html#new-file-system-wasmfs
+ */
+export interface EmscriptenFs {
+	mkdirTree(path: string): void;
+	writeFile(path: string, data: string | Uint8Array): void;
+	unlink(path: string): void;
+	chdir(path: string): void;
+	cwd(): string;
+	analyzePath(path: string): { exists: boolean };
+}
+
+/** Writes one file, creating its parent directories first. */
+export function writeFile(fs: EmscriptenFs, path: string, contents: string | Uint8Array): void {
+	const slash = path.lastIndexOf("/");
+	if (slash > 0) fs.mkdirTree(path.slice(0, slash));
+	fs.writeFile(path, contents);
+}
+
+/** Populates `root` with `files`, whose keys are paths relative to it. */
+export function seedWorkspace(
+	fs: EmscriptenFs,
+	root: string,
+	files: Record<string, string | Uint8Array>,
+): void {
+	fs.mkdirTree(root);
+	for (const [relative, contents] of Object.entries(files)) {
+		writeFile(fs, `${root}/${relative.replace(/^\/+/, "")}`, contents);
+	}
+}