@drawcall/glts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Drawcall
+
+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,83 @@
+# @drawcall/glts
+
+**Like glTF, but for procedural Three.js assets.**
+
+`@drawcall/glts` loads trusted TypeScript modules as composable Three.js assets.
+It compiles them in the browser, resolves nested `.glts` and npm imports, and
+keeps a stable `THREE.Group` wrapper around every asset for atomic reloads.
+
+## Install
+
+```sh
+pnpm add @drawcall/glts three
+```
+
+## Load an asset
+
+```ts
+import { GLTSLoader } from "@drawcall/glts"
+
+const loader = new GLTSLoader()
+const tree = await loader.loadAsync("/assets/tree.glts")
+
+scene.add(tree.scene)
+
+await tree.reload()
+await loader.reload("/assets/branch.glts")
+
+tree.dispose()
+loader.dispose()
+```
+
+`load()` is also available with the familiar Three.js callback API.
+
+The default loader fetches the matching esbuild WebAssembly binary from unpkg.
+To bundle it with your application, install `esbuild-wasm@0.28.2` directly and
+pass its URL. For example, Vite supports the following standard asset URL
+import without a GLTS-specific plugin:
+
+```ts
+import esbuildWasmURL from "esbuild-wasm/esbuild.wasm?url"
+import { GLTSLoader } from "@drawcall/glts"
+
+const loader = new GLTSLoader(undefined, { esbuildWasmURL })
+```
+
+## Write an asset
+
+Each `.glts` file default-exports a no-argument class derived from
+`THREE.Object3D`:
+
+```ts
+import * as THREE from "three"
+import Branch from "./branch.glts"
+
+export default class Tree extends THREE.Group {
+  constructor() {
+    super()
+    this.add(new Branch())
+  }
+
+  dispose() {
+    // Release resources owned by this asset.
+  }
+}
+```
+
+Asset modules can import `three`, Three.js addons, nested `.glts` assets, and
+bare npm packages. `import.meta.url` resolves to the original asset URL so
+relative textures and other resources continue to work.
+
+## V1 constraints
+
+Dynamic imports, import attributes, local helper `.ts` modules, cyclic module
+graphs, cross-asset inheritance, and custom-method contracts across a `.glts`
+boundary are intentionally outside V1.
+
+## Security
+
+GLTS is executable code, not a sandbox or serialization format. Only load
+assets you trust; they run with the page's full JavaScript authority.
+
+Three.js `0.160.0` or newer is required as a peer dependency. Licensed under
+MIT.

package/dist/GLTSLoader.d.ts

@@ -0,0 +1,12 @@
+import { Loader, type LoadingManager } from "three";
+import type { GLTSAsset, GLTSErrorCallback, GLTSLoadCallback, GLTSLoaderOptions, GLTSProgressCallback } from "./types.js";
+export declare class GLTSLoader extends Loader {
+    #private;
+    constructor(manager?: LoadingManager, options?: GLTSLoaderOptions);
+    load(url: string, onLoad: GLTSLoadCallback, onProgress?: GLTSProgressCallback, onError?: GLTSErrorCallback): void;
+    loadAsync(url: string, onProgress?: GLTSProgressCallback): Promise<GLTSAsset>;
+    has(url: string): boolean;
+    reload(url: string): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=GLTSLoader.d.ts.map

package/dist/GLTSLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GLTSLoader.d.ts","sourceRoot":"","sources":["../src/GLTSLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAQf,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EAEjB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA0DpB,qBAAa,UAAW,SAAQ,MAAM;;gBAUlC,OAAO,GAAE,cAAsC,EAC/C,OAAO,GAAE,iBAAsB;IAwBxB,IAAI,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,oBAAoB,EACjC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI;IAWQ,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IA0B5F,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxC,OAAO,IAAI,IAAI;CAwEhB"}

package/dist/GLTSLoader.js

@@ -0,0 +1,182 @@
+import { DefaultLoadingManager, Loader } from "three";
+import * as THREE from "three";
+import { defaultEsbuildWasmURL } from "./compiler.js";
+import { GLTSError } from "./errors.js";
+import { canonicalGLTSURL, ModuleGraph, threeRevision } from "./module-graph.js";
+import { ModuleURLStore } from "./module-url-store.js";
+import { WrapperRuntime } from "./runtime.js";
+function environmentBaseURL() {
+    if (typeof document !== "undefined") {
+        return new URL(document.baseURI);
+    }
+    if (typeof location !== "undefined") {
+        return new URL(location.href);
+    }
+    return new URL("http://localhost/");
+}
+function resolvedOptionURL(value, fallback, base) {
+    return new URL(value ?? fallback, base);
+}
+class GLTSAssetHandle {
+    scene;
+    url;
+    #reloadAsset;
+    #disposeAsset;
+    #disposed = false;
+    constructor(scene, url, reloadAsset, disposeAsset) {
+        this.scene = scene;
+        this.url = url;
+        this.#reloadAsset = reloadAsset;
+        this.#disposeAsset = disposeAsset;
+    }
+    async reload() {
+        if (this.#disposed) {
+            throw new GLTSError("Asset handle has been disposed", {
+                url: this.url,
+                phase: "reload"
+            });
+        }
+        await this.#reloadAsset();
+    }
+    dispose() {
+        if (this.#disposed) {
+            return;
+        }
+        this.#disposed = true;
+        this.#disposeAsset();
+    }
+}
+export class GLTSLoader extends Loader {
+    #baseURL;
+    #baseFetch;
+    #runtime;
+    #graph;
+    #assets = new Set();
+    #reloadQueues = new Map();
+    #disposed = false;
+    constructor(manager = DefaultLoadingManager, options = {}) {
+        super(manager);
+        const environmentBase = environmentBaseURL();
+        this.#baseURL = resolvedOptionURL(options.baseURL, environmentBase.href, environmentBase);
+        this.#baseFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+        const moduleURLs = new ModuleURLStore();
+        this.#runtime = new WrapperRuntime(moduleURLs);
+        this.#graph = new ModuleGraph({
+            cdnURL: resolvedOptionURL(options.cdnURL, "https://esm.sh/", this.#baseURL),
+            esbuildWasmURL: resolvedOptionURL(options.esbuildWasmURL, defaultEsbuildWasmURL(), this.#baseURL).href,
+            fetch: (input, init) => this.#fetch(input, init),
+            moduleURLs,
+            runtime: this.#runtime,
+            threeRevision: threeRevision(THREE)
+        });
+    }
+    load(url, onLoad, onProgress, onError) {
+        void this.loadAsync(url, onProgress).then(onLoad, (error) => {
+            if (onError) {
+                onError(error);
+                return;
+            }
+            console.error(error);
+        });
+    }
+    async loadAsync(url, onProgress) {
+        this.#assertActive(url);
+        void onProgress;
+        const resolvedURL = this.#resolveURL(url);
+        return this.#trackLoading(resolvedURL, async () => {
+            const prepared = await this.#graph.prepareAsset(resolvedURL, { activate: true, force: false });
+            const scene = this.#runtime.createRoot(prepared.url);
+            let handle;
+            handle = new GLTSAssetHandle(scene, prepared.url, () => this.reload(prepared.url), () => {
+                this.#runtime.disposeWrapper(scene);
+                this.#assets.delete(handle);
+            });
+            this.#assets.add(handle);
+            return handle;
+        });
+    }
+    has(url) {
+        return this.#graph.hasAsset(this.#resolveURL(url));
+    }
+    async reload(url) {
+        this.#assertActive(url);
+        const resolvedURL = this.#resolveURL(url);
+        const previous = this.#reloadQueues.get(resolvedURL) ?? Promise.resolve();
+        const next = previous.catch(() => undefined).then(() => this.#trackLoading(resolvedURL, async () => {
+            const prepared = await this.#graph.prepareAsset(resolvedURL, { activate: false, force: true });
+            this.#runtime.replace(resolvedURL, prepared.assetClass);
+            this.#graph.activateAsset(prepared);
+        }));
+        this.#reloadQueues.set(resolvedURL, next);
+        try {
+            await next;
+        }
+        finally {
+            if (this.#reloadQueues.get(resolvedURL) === next) {
+                this.#reloadQueues.delete(resolvedURL);
+            }
+        }
+    }
+    dispose() {
+        if (this.#disposed) {
+            return;
+        }
+        const errors = [];
+        for (const asset of [...this.#assets]) {
+            try {
+                asset.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        try {
+            this.#runtime.dispose();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        this.#disposed = true;
+        if (errors.length > 0) {
+            throw new GLTSError("Loader disposal failed", { url: "glts://loader", phase: "dispose" }, new AggregateError(errors));
+        }
+    }
+    async #trackLoading(url, operation) {
+        this.manager.itemStart(url);
+        try {
+            return await operation();
+        }
+        catch (error) {
+            this.manager.itemError(url);
+            throw error;
+        }
+        finally {
+            this.manager.itemEnd(url);
+        }
+    }
+    #resolveURL(url) {
+        const managedURL = this.manager.resolveURL(`${this.path}${url}`);
+        return canonicalGLTSURL(managedURL, this.#baseURL);
+    }
+    #fetch(input, init) {
+        const headers = new Headers(init?.headers);
+        for (const [name, value] of Object.entries(this.requestHeader)) {
+            headers.set(name, value);
+        }
+        const requestInit = { ...init, headers };
+        if (this.withCredentials) {
+            requestInit.credentials = "include";
+        }
+        return this.#baseFetch(input, requestInit);
+    }
+    #assertActive(url) {
+        if (!this.#disposed) {
+            return;
+        }
+        throw new GLTSError("Loader has been disposed", {
+            url,
+            phase: "resolve"
+        });
+    }
+}
+//# sourceMappingURL=GLTSLoader.js.map

package/dist/GLTSLoader.js.map

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

package/dist/compiler.d.ts

@@ -0,0 +1,3 @@
+export declare function defaultEsbuildWasmURL(): string;
+export declare function compileTypeScript(source: string, sourceURL: string, wasmURL: string): Promise<string>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAyBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/compiler.js

@@ -0,0 +1,38 @@
+const ESBUILD_VERSION = "0.28.2";
+let compiler;
+let initialization;
+let initializedWasmURL;
+export function defaultEsbuildWasmURL() {
+    return `https://unpkg.com/esbuild-wasm@${ESBUILD_VERSION}/esbuild.wasm`;
+}
+async function loadCompiler() {
+    compiler ??= import("esbuild-wasm");
+    return compiler;
+}
+async function initializeCompiler(wasmURL) {
+    const esbuild = await loadCompiler();
+    if (initialization && initializedWasmURL !== wasmURL) {
+        throw new Error(`esbuild-wasm is already initialized with ${initializedWasmURL}; cannot switch to ${wasmURL}`);
+    }
+    if (!initialization) {
+        initializedWasmURL = wasmURL;
+        initialization = esbuild.initialize({ wasmURL, worker: true });
+    }
+    await initialization;
+    return esbuild;
+}
+export async function compileTypeScript(source, sourceURL, wasmURL) {
+    const esbuild = await initializeCompiler(wasmURL);
+    const result = await esbuild.transform(source, {
+        format: "esm",
+        legalComments: "inline",
+        loader: "ts",
+        minify: false,
+        sourcefile: sourceURL,
+        sourcemap: "inline",
+        sourcesContent: true,
+        target: "es2022"
+    });
+    return result.code;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,QAAQ,CAAC;AACjC,IAAI,QAAsC,CAAC;AAC3C,IAAI,cAAyC,CAAC;AAC9C,IAAI,kBAAsC,CAAC;AAE3C,MAAM,UAAU,qBAAqB;IACnC,OAAO,kCAAkC,eAAe,eAAe,CAAC;AAC1E,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,QAAQ,KAAK,MAAM,CAAC,cAAc,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAAe;IAC/C,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IAErC,IAAI,cAAc,IAAI,kBAAkB,KAAK,OAAO,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,4CAA4C,kBAAkB,sBAAsB,OAAO,EAAE,CAC9F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,kBAAkB,GAAG,OAAO,CAAC;QAC7B,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,cAAc,CAAC;IACrB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,SAAiB,EACjB,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE;QAC7C,MAAM,EAAE,KAAK;QACb,aAAa,EAAE,QAAQ;QACvB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,QAAQ;QACnB,cAAc,EAAE,IAAI;QACpB,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+export type GLTSPhase = "resolve" | "fetch" | "transform" | "evaluate" | "construct" | "reload" | "dispose";
+export interface GLTSErrorContext {
+    readonly url: string;
+    readonly phase: GLTSPhase;
+    readonly importChain?: readonly string[];
+}
+export declare class GLTSError extends Error {
+    readonly url: string;
+    readonly phase: GLTSPhase;
+    readonly importChain: readonly string[];
+    constructor(message: string, context: GLTSErrorContext, cause?: unknown);
+}
+export declare function toGLTSError(error: unknown, message: string, context: GLTSErrorContext): GLTSError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,OAAO,GACP,WAAW,GACX,UAAU,GACV,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,OAAO;CAaxE;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAMX"}

package/dist/errors.js

@@ -0,0 +1,23 @@
+export class GLTSError extends Error {
+    url;
+    phase;
+    importChain;
+    constructor(message, context, cause) {
+        const chain = context.importChain ?? [];
+        const chainMessage = chain.length > 1 ? `\nImport chain: ${chain.join(" -> ")}` : "";
+        super(`[GLTS:${context.phase}] ${message}\nURL: ${context.url}${chainMessage}`, {
+            cause
+        });
+        this.name = "GLTSError";
+        this.url = context.url;
+        this.phase = context.phase;
+        this.importChain = chain;
+    }
+}
+export function toGLTSError(error, message, context) {
+    if (error instanceof GLTSError) {
+        return error;
+    }
+    return new GLTSError(message, context, error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,GAAG,CAAS;IACZ,KAAK,CAAY;IACjB,WAAW,CAAoB;IAExC,YAAY,OAAe,EAAE,OAAyB,EAAE,KAAe;QACrE,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErF,KAAK,CAAC,SAAS,OAAO,CAAC,KAAK,KAAK,OAAO,UAAU,OAAO,CAAC,GAAG,GAAG,YAAY,EAAE,EAAE;YAC9E,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAAe,EACf,OAAyB;IAEzB,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { GLTSError, type GLTSPhase } from "./errors.js";
+export { GLTSLoader } from "./GLTSLoader.js";
+export type { GLTSAsset, GLTSErrorCallback, GLTSFetch, GLTSLoadCallback, GLTSLoaderOptions, GLTSProgressCallback } from "./types.js";
+//# 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,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { GLTSError } from "./errors.js";
+export { GLTSLoader } from "./GLTSLoader.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/module-graph.d.ts

@@ -0,0 +1,32 @@
+import type * as THREE from "three";
+import { ModuleURLStore } from "./module-url-store.js";
+import type { WrapperRuntime } from "./runtime.js";
+import type { GLTSAssetClass, GLTSFetch } from "./types.js";
+interface PreparedAsset {
+    readonly assetClass: GLTSAssetClass;
+    readonly moduleURL: string;
+    readonly source: string;
+    readonly url: string;
+}
+interface ModuleGraphOptions {
+    readonly cdnURL: URL;
+    readonly esbuildWasmURL: string;
+    readonly fetch: GLTSFetch;
+    readonly moduleURLs: ModuleURLStore;
+    readonly runtime: WrapperRuntime;
+    readonly threeRevision: string;
+}
+export declare class ModuleGraph {
+    #private;
+    constructor(options: ModuleGraphOptions);
+    hasAsset(url: string): boolean;
+    prepareAsset(url: string, options: {
+        readonly activate: boolean;
+        readonly force: boolean;
+    }, importChain?: readonly string[]): Promise<PreparedAsset>;
+    activateAsset(prepared: PreparedAsset): void;
+}
+export declare function canonicalGLTSURL(input: string | URL, baseURL: URL): string;
+export declare function threeRevision(three: typeof THREE): string;
+export {};
+//# sourceMappingURL=module-graph.d.ts.map

package/dist/module-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-graph.d.ts","sourceRoot":"","sources":["../src/module-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,UAAU,aAAa;IACrB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAOD,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAqDD,qBAAa,WAAW;;gBAaV,OAAO,EAAE,kBAAkB;IASvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAChE,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,OAAO,CAAC,aAAa,CAAC;IAiCzB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;CAuR7C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,MAAM,CAE1E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,KAAK,GAAG,MAAM,CAEzD"}