@drawcall/lod 0.2.0 → 0.3.0

package/dist/levels/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../src/levels/screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,cAAc,CAAC;AAW/E,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,MAAc,EAAE,MAAc,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;IACnH,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IACpD,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACjC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAa,EAAE,MAAc;IACxE,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC1D,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7C,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACtH,CAAC"}

package/dist/levels/wait.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Whether an InstancedLod's chunks wait to be shown taken in on the GPU: from a change until, a few renders later, a
+ * read of their status shows each taken in, so that its manager holds its item until a host sees them drawn.
+ */
+export declare class ChunkWait {
+    /** Whether the GPU shows every chunk taken in, read back; it throws if a chunk lacks room. */
+    private readonly read;
+    /** Called once a read shows every chunk taken in. */
+    private readonly taken;
+    /** Called with what a read throws. */
+    private readonly failed;
+    /** While chunks wait, the renders left before their status is read, and whether a read is under way. */
+    private rest;
+    constructor(
+    /** Whether the GPU shows every chunk taken in, read back; it throws if a chunk lacks room. */
+    read: () => Promise<boolean>, 
+    /** Called once a read shows every chunk taken in. */
+    taken: () => void, 
+    /** Called with what a read throws. */
+    failed: (error: unknown) => void);
+    /** Whether chunks wait to be shown taken in. */
+    get waiting(): boolean;
+    /** The chunks were added or removed: wait for them again. */
+    changed(): void;
+    /** A render updated the InstancedLod: read the chunks' status once their change has rested. */
+    render(): void;
+}

package/dist/levels/wait.js

@@ -0,0 +1,61 @@
+/**
+ * Renders a change of an InstancedLod's chunks rests for before their status is read back (see `ChunkWait`): chunks
+ * change for many frames while an app loads them in, and every read is a submission of its own.
+ */
+const CHUNK_REST = 4;
+/**
+ * Whether an InstancedLod's chunks wait to be shown taken in on the GPU: from a change until, a few renders later, a
+ * read of their status shows each taken in, so that its manager holds its item until a host sees them drawn.
+ */
+export class ChunkWait {
+    read;
+    taken;
+    failed;
+    /** While chunks wait, the renders left before their status is read, and whether a read is under way. */
+    rest = null;
+    constructor(
+    /** Whether the GPU shows every chunk taken in, read back; it throws if a chunk lacks room. */
+    read, 
+    /** Called once a read shows every chunk taken in. */
+    taken, 
+    /** Called with what a read throws. */
+    failed) {
+        this.read = read;
+        this.taken = taken;
+        this.failed = failed;
+    }
+    /** Whether chunks wait to be shown taken in. */
+    get waiting() {
+        return this.rest !== null;
+    }
+    /** The chunks were added or removed: wait for them again. */
+    changed() {
+        if (this.rest)
+            this.rest.renders = CHUNK_REST;
+        else
+            this.rest = { renders: CHUNK_REST, reading: false };
+    }
+    /** A render updated the InstancedLod: read the chunks' status once their change has rested. */
+    render() {
+        const { rest } = this;
+        if (!rest || rest.reading)
+            return;
+        if (rest.renders > 0) {
+            rest.renders--;
+            return;
+        }
+        rest.reading = true;
+        this.read().then((taken) => {
+            rest.reading = false;
+            if (this.rest !== rest)
+                return;
+            if (!taken || rest.renders > 0) {
+                rest.renders = CHUNK_REST;
+                return;
+            }
+            this.rest = null;
+            this.taken();
+        }, (error) => this.failed(error));
+    }
+}
+//# sourceMappingURL=wait.js.map

package/dist/levels/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/levels/wait.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;GAGG;AACH,MAAM,OAAO,SAAS;IAMD;IAEA;IAEA;IATnB,wGAAwG;IAChG,IAAI,GAAiD,IAAI,CAAC;IAElE;IACE,8FAA8F;IAC7E,IAA4B;IAC7C,qDAAqD;IACpC,KAAiB;IAClC,sCAAsC;IACrB,MAAgC;QAJhC,SAAI,GAAJ,IAAI,CAAwB;QAE5B,UAAK,GAAL,KAAK,CAAY;QAEjB,WAAM,GAAN,MAAM,CAA0B;IAChD,CAAC;IAEJ,gDAAgD;IAChD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;IAC5B,CAAC;IAED,6DAA6D;IAC7D,OAAO;QACL,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;;YACzC,IAAI,CAAC,IAAI,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,+FAA+F;IAC/F,MAAM;QACJ,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAClC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CACd,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO;YAC/B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,EACD,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CACvC,CAAC;IACJ,CAAC;CACF"}

package/dist/loader/build.d.ts

@@ -0,0 +1,10 @@
+import type { Object3D, Renderer } from "three/webgpu";
+import type { Derived } from "./level.js";
+/**
+ * Build the level `request` asks for from `source`, with the baked level's `low` shell and `interior` rooms if it names
+ * them. `renderer` answers the renderer to bake with, asked for only by a bake that draws.
+ */
+export declare function buildLevel(source: Object3D, request: Derived, { low, interior }: {
+    low: Object3D | undefined;
+    interior: Object3D | undefined;
+}, renderer: () => Promise<Renderer>): Promise<Object3D>;

package/dist/loader/build.js

@@ -0,0 +1,28 @@
+import { bakeMesh } from "../baked/index.js";
+import { bakeImpostor } from "../impostor/bake/index.js";
+import { ImpostorMesh } from "../impostor/mesh/index.js";
+import { simplify } from "../simplify/index.js";
+import { placeLike } from "../three.js";
+/**
+ * Build the level `request` asks for from `source`, with the baked level's `low` shell and `interior` rooms if it names
+ * them. `renderer` answers the renderer to bake with, asked for only by a bake that draws.
+ */
+export async function buildLevel(source, request, { low, interior }, renderer) {
+    switch (request.type) {
+        case "simplify":
+            return simplify(source, { ratio: request.ratio });
+        case "impostor": {
+            const { type: _, draw: __, ...options } = request;
+            const object = new ImpostorMesh(await bakeImpostor(source, await renderer(), options));
+            object.name = `${source.name || "object"} impostor`;
+            placeLike(object, source);
+            return object;
+        }
+        case "baked": {
+            const shell = low ? { low } : { ratio: request.ratio };
+            const rooms = interior ? { interior, renderer: await renderer() } : {};
+            return bakeMesh(source, { textureSize: request.textureSize, ...shell, ...rooms });
+        }
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/loader/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/loader/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAgB,EAChB,OAAgB,EAChB,EAAE,GAAG,EAAE,QAAQ,EAAiE,EAChF,QAAiC;IAEjC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;YAClD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,YAAY,CAAC,MAAM,EAAE,MAAM,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;YACvF,MAAM,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,WAAW,CAAC;YACpD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/loader/cache.d.ts

@@ -1,15 +1,12 @@
 import { CacheEntry, type CacheEntryOptions, type Dependencies } from "vitecache";
-import type { LevelRequest } from "../loader.js";
+import type { Derived } from "./level.js";
 /** Persistent cache location. Generator packages are discovered from GLTS source provenance. */
 export type LodCacheOptions = Pick<CacheEntryOptions, "basePath" | "root">;
 /**
- * The index of a ladder: keyed by the requested URLs, levels and bundled modules, and saved with what loading the sources
- * revealed, so vitecache rechecks those without loading the sources.
+ * One derived level, or the source's shape: keyed by the URLs it is built from, its request and their bundled modules,
+ * and saved with what loading them revealed, so vitecache rechecks those without loading the sources. Each level has
+ * its own entry, so a level is built and saved only when it is first needed; the shape's describes the ladder before
+ * any level is.
  */
-export declare function indexEntry(inputs: Dependencies, levels: readonly LevelRequest[], modules: Readonly<Record<string, string>>, options?: LodCacheOptions): CacheEntry;
-/**
- * A level payload saved apart from its index, addressed by the index's content: a valid index vouches for its payloads,
- * and rebuilds write new ones rather than replacing those a live ladder or another build still reads.
- */
-export declare function payloadEntry(index: string, level: number, options?: LodCacheOptions): CacheEntry;
+export declare function ladderEntry(inputs: Dependencies, of: Derived | "shape", modules: Readonly<Record<string, string>>, options?: LodCacheOptions): CacheEntry;
 export declare function sha256(bytes: Uint8Array): Promise<string>;

package/dist/loader/cache.js

@@ -1,12 +1,19 @@
 import { CacheEntry } from "vitecache";
 import { urlQuery } from "./url.js";
-const version = "lod-levels@18";
 /**
- * The index of a ladder: keyed by the requested URLs, levels and bundled modules, and saved with what loading the sources
- * revealed, so vitecache rechecks those without loading the sources.
+ * What builds and lays out a cached level, and so what identifies it beside its inputs: bump it with any change to
+ * the bytes a level or shape entry holds. Not this package's files, which change with every rebuild, whether a level
+ * would or not.
  */
-export function indexEntry(inputs, levels, modules, options) {
-    // vitecache resolves URLs to file paths; keep generation parameters in the key.
+const version = "lod-level@23";
+/**
+ * One derived level, or the source's shape: keyed by the URLs it is built from, its request and their bundled modules,
+ * and saved with what loading them revealed, so vitecache rechecks those without loading the sources. Each level has
+ * its own entry, so a level is built and saved only when it is first needed; the shape's describes the ladder before
+ * any level is.
+ */
+export function ladderEntry(inputs, of, modules, options) {
+    // vitecache resolves URLs to file paths; generation parameters go in the key.
     const queries = {};
     for (const [name, dependency] of Object.entries(inputs)) {
         const query = dependency.url === undefined ? "" : urlQuery(dependency.url);
@@ -19,38 +26,24 @@ export function indexEntry(inputs, levels, modules, options) {
         version,
         dependencies: {
             ...inputs,
-            "lod:levels": { value: levels.map(parameters) },
+            "lod:level": { value: of === "shape" ? { type: of } : parameters(of) },
             "lod:modules": { value: modules },
             "lod:queries": { value: queries },
-            // Only packages the app installs resolve from its root; this package's own dependencies are covered by its version and `version` above.
-            "lod:package": { package: "@drawcall/lod" },
+            // Only packages the app installs resolve from its root; this package's own dependencies are covered by `version` above.
             "lod:three": { package: "three" },
         },
     });
 }
-/**
- * A level payload saved apart from its index, addressed by the index's content: a valid index vouches for its payloads,
- * and rebuilds write new ones rather than replacing those a live ladder or another build still reads.
- */
-export function payloadEntry(index, level, options) {
-    return new CacheEntry({
-        basePath: options?.basePath,
-        root: options?.root,
-        version,
-        dependencies: { "lod:index": { value: index }, "lod:level": { value: level } },
-    });
-}
 export async function sha256(bytes) {
     const hash = await crypto.subtle.digest("SHA-256", new Uint8Array(bytes));
     return Array.from(new Uint8Array(hash), (byte) => byte.toString(16).padStart(2, "0")).join("");
 }
-/** What derives each level's content. Switch thresholds and impostor draw options apply at decode, so changing one reuses the cache. */
+/** What derives a level's content. Switch thresholds and impostor draw options apply at decode, so changing one reuses the cache. */
 function parameters(level) {
     switch (level.type) {
-        case "empty":
-            return { type: level.type };
         case "simplify":
-            return { type: level.type, ratio: level.ratio ?? null };
+            // Alpha-tested cards are thinned whole since lod-level@23; keyed here so other kinds' levels stay cached.
+            return { type: level.type, ratio: level.ratio ?? null, cards: "thin" };
         case "baked":
             return {
                 type: level.type,

package/dist/loader/cache.js.map

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

package/dist/loader/context.d.ts

@@ -0,0 +1,46 @@
+import type { Object3D } from "three/webgpu";
+import { type DisposeOptions } from "../dispose.js";
+import type { AssetDependencies } from "./dependencies.js";
+/**
+ * What one ladder's loads share: the source loaded to measure or build the ladder with, handed to the first level load
+ * (the source level draws it, a build uses it, a cached level disposes it; onLevel has not changed it), the levels built
+ * with the ladder, each handed to its first load, and every level object loaded. Those are freed if describing the
+ * ladder fails, else when the last Lod holding the levels is disposed (see `hold`), which spends them.
+ */
+export declare class LodLoadContext {
+    private readonly load;
+    private readonly onLevel;
+    /** Level bytes built while describing the ladder, by index: a cached level is read again when it loads. */
+    private readonly built;
+    private spare;
+    /** Every level object loaded, and what freeing it frees: a simplified level draws with its source's materials. */
+    private readonly loaded;
+    /** How many Lods hold the levels, and whether the last has let go, which freed them. */
+    private holders;
+    private spent;
+    constructor(load: () => Promise<Loaded>, onLevel: ((object: Object3D, index: number) => void | Promise<void>) | undefined);
+    /** The spare source, loaded once. */
+    source(): Promise<Loaded>;
+    /** The spare source, for the first level load to take. */
+    take(): Loaded | undefined;
+    /** Hold the bytes of level `index`, built while describing the ladder, for its first load to take. */
+    setBuilt(index: number, bytes: Uint8Array): void;
+    /** The bytes of level `index` built while describing the ladder, once: undefined if none were, or once taken. */
+    takeBuilt(index: number): Uint8Array | undefined;
+    /** Apply onLevel to a level's arriving object, freeing it as `options` say if that fails. */
+    arrive(object: Object3D, index: number, options: DisposeOptions): Promise<Object3D>;
+    /** Describing the ladder failed: free what it loaded. */
+    fail(): void;
+    /**
+     * A Lod made from the levels holds them; the release it answers lets go, and the last frees what was loaded. Levels
+     * no Lod ever held are never freed. Freed levels are spent: a Lod made from them later throws.
+     */
+    readonly hold: () => (() => void);
+    /** Free the spare source and every level object loaded with `dispose`. */
+    private free;
+}
+/** A loaded source and what loading it read. */
+export interface Loaded {
+    source: Object3D;
+    dependencies: AssetDependencies;
+}

package/dist/loader/context.js

@@ -0,0 +1,91 @@
+import { disposeRejected, disposeTree } from "../dispose.js";
+/**
+ * What one ladder's loads share: the source loaded to measure or build the ladder with, handed to the first level load
+ * (the source level draws it, a build uses it, a cached level disposes it; onLevel has not changed it), the levels built
+ * with the ladder, each handed to its first load, and every level object loaded. Those are freed if describing the
+ * ladder fails, else when the last Lod holding the levels is disposed (see `hold`), which spends them.
+ */
+export class LodLoadContext {
+    load;
+    onLevel;
+    /** Level bytes built while describing the ladder, by index: a cached level is read again when it loads. */
+    built = new Map();
+    spare;
+    /** Every level object loaded, and what freeing it frees: a simplified level draws with its source's materials. */
+    loaded = new Map();
+    /** How many Lods hold the levels, and whether the last has let go, which freed them. */
+    holders = 0;
+    spent = false;
+    constructor(load, onLevel) {
+        this.load = load;
+        this.onLevel = onLevel;
+    }
+    /** The spare source, loaded once. */
+    async source() {
+        this.spare ??= await this.load();
+        return this.spare;
+    }
+    /** The spare source, for the first level load to take. */
+    take() {
+        const taken = this.spare;
+        this.spare = undefined;
+        return taken;
+    }
+    /** Hold the bytes of level `index`, built while describing the ladder, for its first load to take. */
+    setBuilt(index, bytes) {
+        this.built.set(index, bytes);
+    }
+    /** The bytes of level `index` built while describing the ladder, once: undefined if none were, or once taken. */
+    takeBuilt(index) {
+        const bytes = this.built.get(index);
+        this.built.delete(index);
+        return bytes;
+    }
+    /** Apply onLevel to a level's arriving object, freeing it as `options` say if that fails. */
+    async arrive(object, index, options) {
+        try {
+            this.loaded.set(object, options);
+            await this.onLevel?.(object, index);
+            return object;
+        }
+        catch (error) {
+            this.loaded.delete(object);
+            disposeRejected(object, options);
+            throw error;
+        }
+    }
+    /** Describing the ladder failed: free what it loaded. */
+    fail() {
+        this.free(disposeRejected);
+    }
+    /**
+     * A Lod made from the levels holds them; the release it answers lets go, and the last frees what was loaded. Levels
+     * no Lod ever held are never freed. Freed levels are spent: a Lod made from them later throws.
+     */
+    hold = () => {
+        if (this.spent)
+            throw new Error("LodLoader: these levels were freed with the last Lod that held them; call loadAsync again");
+        this.holders++;
+        let held = true;
+        return () => {
+            if (!held)
+                return;
+            held = false;
+            if (--this.holders > 0)
+                return;
+            this.spent = true;
+            this.free(disposeTree);
+        };
+    };
+    /** Free the spare source and every level object loaded with `dispose`. */
+    free(dispose) {
+        const taken = this.take();
+        if (taken)
+            dispose(taken.source, { materials: true });
+        for (const [object, options] of this.loaded)
+            dispose(object, options);
+        this.loaded.clear();
+        this.built.clear();
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/loader/context.js.map

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

package/dist/loader/{provenance.d.ts → dependencies.d.ts}

@@ -1,14 +1,16 @@
 import type { LoadingManager, Object3D } from "three/webgpu";
 import type { Dependencies, SavedDependencies } from "vitecache";
 /** The requested assets, and the files and packages loading them revealed, for saving with the index built from them. */
-export declare class Provenance {
+export declare class AssetDependencies {
     private readonly manager;
     readonly inputs: Dependencies;
     private readonly resources;
-    /** Kept whole: a GLTS source reports what it has observed so far, so it is read when saving. */
+    /** Whole: a GLTS source reports what it has observed so far, so it is read when saving. */
     private readonly scripts;
     constructor(urls: Readonly<Record<string, string>>, manager: LoadingManager);
     capture(url: string, object: Object3D, result: unknown): void;
+    /** Also hold what `other`'s loads read. */
+    include(other: AssetDependencies): this;
     /** The requested URLs, resolved as `inputs` holds them. */
     get requested(): string[];
     /**
@@ -16,7 +18,7 @@ export declare class Provenance {
      * a CDN module fetched at runtime, which bundled moduleSources cannot vouch for, or a cross-origin resource, which
      * vitecache cannot hash.
      */
-    dependencies(): {
+    saved(): {
         dependencies: SavedDependencies;
     } | {
         reason: string;

package/dist/loader/{provenance.js → dependencies.js}

@@ -2,11 +2,11 @@ import { isGLTSLoader, isGLTSScene } from "../three.js";
 import { sha256 } from "./cache.js";
 import { assetPath, isLocal, localURL, sourceRelativeURL, urlPath } from "./url.js";
 /** The requested assets, and the files and packages loading them revealed, for saving with the index built from them. */
-export class Provenance {
+export class AssetDependencies {
     manager;
     inputs;
     resources = new Set();
-    /** Kept whole: a GLTS source reports what it has observed so far, so it is read when saving. */
+    /** Whole: a GLTS source reports what it has observed so far, so it is read when saving. */
     scripts = [];
     constructor(urls, manager) {
         this.manager = manager;
@@ -22,6 +22,13 @@ export class Provenance {
             throw new Error(`LodLoader: "${url}" did not load as a GLTS scene`);
         this.scripts.push(object.source);
     }
+    /** Also hold what `other`'s loads read. */
+    include(other) {
+        for (const resource of other.resources)
+            this.resources.add(resource);
+        this.scripts.push(...other.scripts);
+        return this;
+    }
     /** The requested URLs, resolved as `inputs` holds them. */
     get requested() {
         return Object.values(this.inputs).flatMap(({ url }) => (url === undefined ? [] : [url]));
@@ -31,7 +38,7 @@ export class Provenance {
      * a CDN module fetched at runtime, which bundled moduleSources cannot vouch for, or a cross-origin resource, which
      * vitecache cannot hash.
      */
-    dependencies() {
+    saved() {
         if (this.scripts.some((source) => source.runtimeModules.length))
             return { reason: "it imports CDN modules at runtime" };
         const found = new Set(this.resources);
@@ -54,6 +61,7 @@ export class Provenance {
         };
     }
 }
+/** Each GLTS loader's moduleSources digest, hashed once: a side table keyed by the loaders' moduleSources, which the app owns. */
 const digests = new WeakMap();
 /**
  * Digests of the bundled modules each input script's GLTS loader links, by input name. They are known before a source runs,
@@ -102,4 +110,4 @@ function gltfUrls(result, url) {
         });
     });
 }
-//# sourceMappingURL=provenance.js.map
+//# sourceMappingURL=dependencies.js.map

package/dist/loader/dependencies.js.map

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

package/dist/loader/index.d.ts

@@ -0,0 +1,62 @@
+import { Loader, LoadingManager } from "three/webgpu";
+import { type LodLevel } from "../levels/index.js";
+import type { LodCacheOptions } from "./cache.js";
+import { type LodRequest } from "./request.js";
+/**
+ * Loads asset URLs through manager handlers, else with a GLTFLoader of its own, which decodes meshopt only: register
+ * a GLTFLoader configured with Draco or KTX2 decoders for models compressed with them, and a GLTSLoader for .glts
+ * sources.
+ *
+ * Impostor and interior bakes draw with a renderer of the loader's own, made at its first bake: `dispose` frees it.
+ */
+export declare class LodLoader extends Loader<LodLevel[], LodRequest> {
+    private readonly cacheOptions?;
+    private gltf;
+    /**
+     * The renderer this loader bakes with, made at its first bake. Its own, not the app's: a canvas the size of a bake
+     * frame would draw that frame over the whole target (see `bakeImpostor`).
+     */
+    private renderer;
+    /** URLs whose builds this loader serves without saving, once it has warned why. */
+    private readonly uncached;
+    constructor(manager?: LoadingManager, cacheOptions?: LodCacheOptions | undefined);
+    load(request: LodRequest, onLoad: (levels: LodLevel[]) => void, _onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
+    /**
+     * Describes the ladder from the cache, else from its source, which the first level loaded then takes. Empty levels
+     * load with it, as does the source when it is the only drawable; other levels load when a camera needs them,
+     * including a coarse stand-in while its first detail arrives, and each derived level is cached on its own and built
+     * when first loaded. A level whose default threshold is measured from it is built with the ladder, as is every level
+     * in a `vite build` warmup.
+     *
+     * What the levels load is freed when the last Lod holding them is disposed (see `LodLevel.hold`), which spends them:
+     * a Lod made from them later throws, so call loadAsync again. Levels no Lod ever holds are never freed: they are
+     * yours until a Lod holds them.
+     */
+    loadAsync(request: LodRequest): Promise<LodLevel[]>;
+    /** The source's shape from its entry, else measured from the source and saved. */
+    private shape;
+    /**
+     * A deferred level's bytes from its entry, else built from `spare`, the ladder's source, or from a source of its own:
+     * the source level's carries onLevel effects. Disposes `spare` either way.
+     */
+    private levelBytes;
+    /**
+     * Build level `index` from `loaded`, and save it to `entry`, read before, when what it was built from can be validated
+     * later: what loading the source read, and what this build loads besides.
+     */
+    private persist;
+    /** The renderer this loader bakes with, made at its first bake. */
+    private bakeRenderer;
+    /**
+     * Free the renderer this loader made for its bakes; a bake under way fails. Levels it loaded stay as they are, and a
+     * later bake makes a new renderer.
+     */
+    dispose(): void;
+    /** Save `bytes` to `entry`, read before, when what they were built from can be validated later; warn once otherwise. */
+    private save;
+    /** Builds of `url` are served without saving from now on, after one warning naming why; a build warmup fails instead. */
+    private warnUncached;
+    /** The ladder's source, with what loading it read. */
+    private loadSource;
+    private loadAsset;
+}