@drawcall/lod 0.2.0 → 0.4.0

package/dist/levels/manager.d.ts

@@ -0,0 +1,158 @@
+import type { Camera, Object3D, Object3DEventMap, Renderer } from "three/webgpu";
+import type { d } from "typegpu";
+import { type DrawLevels } from "./draw.js";
+import type { LodLevel } from "./index.js";
+import { LoadingItem } from "./item.js";
+/** How long an arriving level fades in for, over what drew in its place. */
+export declare const ARRIVAL_MS = 200;
+export interface LodEventMap extends Object3DEventMap {
+    /** A compiled level has joined the loaded levels. */
+    levelschange: {};
+    /** Fetch, decode, or GPU preparation failed; the loaded levels still draw. */
+    levelserror: {
+        error: Error;
+    };
+}
+/** What a Lod makes of a level's loaded object: `object` compiles, then joins the loaded levels or is discarded. */
+export interface PreparedLevel {
+    object: Object3D;
+    /** The level joins the loaded levels: it draws from now on. */
+    join(): void;
+    /** The compile failed, or the Lod was disposed meanwhile: free what preparing made. */
+    discard(): void;
+}
+/**
+ * Loads a Lod's levels as its cameras request them, never blocking a render. The coarsest level that
+ * draws something loads first, as nothing draws before it has (see levelsToDraw); the other levels a camera wants
+ * start loading once it has loaded. Each level's load runs once; once the render that asked for it has ended, the Lod
+ * prepares it (`prepare`), it compiles for the render context of every camera rendering the Lod and joins the loaded
+ * levels. Levels join only between arrivals, each of which fades in for ARRIVAL_MS from the levels loaded `before` it.
+ * Each render context seen for the first time compiles in the background every loaded level that draws something,
+ * given ones included, that no camera rendering the Lod wants: three skips a draw whose pipeline a compileAsync is
+ * still building, in any context that shares it, so a level a camera may draw now builds as it first draws instead.
+ * Nothing is evicted: a level stays loaded until the Lod is disposed.
+ *
+ * A Lod draws with the first renderer that draws one of its meshes (see `see`), whose renders it learns its cameras
+ * from. Once one has, it holds an item on its LoadingManager while anything a camera wants is missing, compiling or
+ * arriving.
+ */
+export declare class LodLevelLoadManager {
+    private readonly lod;
+    /** The LoadingManager item's name, which errors name too: the kind of Lod and its uuid. */
+    private readonly name;
+    /** The levels as the Lod was given them: it holds them (see `LodLevel.hold`) until it is disposed. */
+    private readonly levels;
+    private readonly prepare;
+    /** What draws a loaded level, compiled for each render context it is wanted in. */
+    private readonly drawnBy;
+    /** The bits of the levels that draw: given ones from the start, deferred ones once loaded and compiled. */
+    loaded: number;
+    /** The bits loaded before the latest arrival (see `progress`). */
+    before: number;
+    /** The first failure; it stops further loading. */
+    error: Error | undefined;
+    /** Whether a renderer has drawn the Lod: its shaders are being or have been built. */
+    started: boolean;
+    /** Whether a camera has asked for levels since the Lod was bound: until then it is pending. */
+    private requested;
+    /** Its item on a LoadingManager. */
+    readonly item: LoadingItem;
+    /**
+     * The bits of the levels that draw nothing, the coarsest level that draws something, and the order levels load in: it
+     * first, then coarse to fine.
+     */
+    private readonly empty;
+    private readonly coarsest;
+    private readonly order;
+    /** When the latest arrival began. */
+    private arrival;
+    /** Compiled levels waiting for the arrival under way to end. */
+    private readonly ready;
+    /** Levels being prepared and compiled to join the loaded ones. */
+    private readonly arriving;
+    /** The background compiles of loaded levels, per render context. */
+    private readonly compiles;
+    /** Per level, its load once started. */
+    private readonly loads;
+    /** What renders told of the cameras that drew the Lod. */
+    private readonly seen;
+    private disposed;
+    /** What `LodLevel.hold` answered, each called once the Lod is disposed. */
+    private readonly releases;
+    /** The renderer drawing the Lod and what the cameras rendering it there asked for, once one drew it (see `see`). */
+    private bound;
+    constructor(lod: Object3D<LodEventMap>, 
+    /** The LoadingManager item's name, which errors name too: the kind of Lod and its uuid. */
+    name: string, 
+    /** The levels as the Lod was given them: it holds them (see `LodLevel.hold`) until it is disposed. */
+    levels: readonly LodLevel[], 
+    /** The levels as levelsToDraw reads them, for the ones that draw nothing and the coarsest that draws something. */
+    { empty, coarsest }: d.Infer<typeof DrawLevels>, prepare: (level: number, loaded: Object3D) => PreparedLevel, 
+    /** What draws a loaded level, compiled for each render context it is wanted in. */
+    drawnBy: (level: number) => readonly Object3D[]);
+    /** How far the latest arrival has faded in, in [0, 1]: 1 once it has. */
+    get progress(): number;
+    /** The renderer drawing the Lod: the first that drew one of its meshes; null before. */
+    get renderer(): Renderer | null;
+    /**
+     * `renderer` draws one of the Lod's meshes, as three tells a mesh but not a LOD's `update`: the first binds the Lod
+     * to it, once checked to draw it; another throws.
+     */
+    see(renderer: Renderer): void;
+    /** Whether `camera` still renders the Lod (see `CameraRequests.rendering`). */
+    rendering(camera: Camera): boolean;
+    get pending(): boolean;
+    /**
+     * `camera`, a shadow map's when `shadow`, wants the levels of the bits `wanted` (see levelsToLoad) in an update once
+     * the Lod is bound to a renderer (see `see`): load what is missing, and answer the bits of the levels loaded now. Outside a
+     * Scene a missing level is an error, as no render of it would load it.
+     */
+    request(camera: Camera, wanted: number, shadow: boolean): number;
+    /**
+     * The height `camera`, a shadow map's when `shadow`, draws at with `renderer` (see CameraRenders.heightOf), which
+     * levels are chosen at.
+     */
+    heightOf(camera: Camera, renderer: Renderer, shadow: boolean): number;
+    /** The renderer drawing the Lod and its cameras' requests: known once it drew the Lod, before anything loads. */
+    private boundOrThrow;
+    /** What compiles for `cameras` are for: the shadow maps they drew, and the targets disposed. */
+    private compileFor;
+    /**
+     * Load what the cameras still rendering the Lod want, in `order`, compile for `camera`'s render context every loaded
+     * level that draws something, none of them wants and is not yet compiled for it, and prepare the levels that have
+     * loaded. `shadow` is whether a shadow map renders it, in the renderer's `frame`.
+     */
+    private load;
+    /** Run level `level`'s `load`, holding the object it makes. */
+    private start;
+    private levelAt;
+    /** Compile the loaded levels of `bits` for `context`: a background compile (see ContextCompiles). */
+    private compileLevels;
+    /**
+     * Prepare `level` once the render that asked for it has ended, if a camera still wants it then, and compile it for
+     * the render context of every camera still rendering the Lod, `context` among them, to join the loaded levels: a
+     * slow level never holds another's, and no camera draws it uncompiled.
+     */
+    private arrive;
+    /** Let compiled levels join the loaded ones, between arrivals: what draws never changes halfway through a fade. */
+    private join;
+    /**
+     * Hold the item while levels a camera wants are missing, compiling or arriving, and end it once they are done, so a host waiting for its LoadingManager renders its cameras complete. Called at
+     * the end of each request.
+     */
+    private sync;
+    /**
+     * The one failure rule, for a level that fails and for anything that throws while three renders, where a throw would
+     * leave its internal target bound: note the error, log it, report it on the LoadingManager the item is held on and
+     * end the item, and dispatch `levelserror`. Only the first is reported; it stops further loading.
+     */
+    report(error: unknown): void;
+    /** Run `action`, part of an update or a draw callback, reporting what it throws instead. */
+    guard(action: () => void): void;
+    /**
+     * Stop loading, then `release` what the Lod made of its levels and let go of what it holds of them (see
+     * `LodLevel.hold`), once nothing preparing, compiling or loading still uses them. What the levels gave or loaded is
+     * not freed: it is whoever made it's.
+     */
+    dispose(release: () => void): void;
+}

package/dist/levels/manager.js

@@ -0,0 +1,352 @@
+import { nextTask } from "../task.js";
+import { isObject3D, isScene, rootOf } from "../three.js";
+import { compilerOf } from "./compile/index.js";
+import { CameraRenders } from "./cameras.js";
+import { has } from "./draw.js";
+import { LoadingItem } from "./item.js";
+import { CameraRequests } from "./requests.js";
+import { ContextCompiles } from "./compiles.js";
+import { checkRenderer } from "./renderer.js";
+/** How long an arriving level fades in for, over what drew in its place. */
+export const ARRIVAL_MS = 200;
+/**
+ * Loads a Lod's levels as its cameras request them, never blocking a render. The coarsest level that
+ * draws something loads first, as nothing draws before it has (see levelsToDraw); the other levels a camera wants
+ * start loading once it has loaded. Each level's load runs once; once the render that asked for it has ended, the Lod
+ * prepares it (`prepare`), it compiles for the render context of every camera rendering the Lod and joins the loaded
+ * levels. Levels join only between arrivals, each of which fades in for ARRIVAL_MS from the levels loaded `before` it.
+ * Each render context seen for the first time compiles in the background every loaded level that draws something,
+ * given ones included, that no camera rendering the Lod wants: three skips a draw whose pipeline a compileAsync is
+ * still building, in any context that shares it, so a level a camera may draw now builds as it first draws instead.
+ * Nothing is evicted: a level stays loaded until the Lod is disposed.
+ *
+ * A Lod draws with the first renderer that draws one of its meshes (see `see`), whose renders it learns its cameras
+ * from. Once one has, it holds an item on its LoadingManager while anything a camera wants is missing, compiling or
+ * arriving.
+ */
+export class LodLevelLoadManager {
+    lod;
+    name;
+    levels;
+    prepare;
+    drawnBy;
+    /** The bits of the levels that draw: given ones from the start, deferred ones once loaded and compiled. */
+    loaded = 0;
+    /** The bits loaded before the latest arrival (see `progress`). */
+    before = 0;
+    /** The first failure; it stops further loading. */
+    error;
+    /** Whether a renderer has drawn the Lod: its shaders are being or have been built. */
+    started = false;
+    /** Whether a camera has asked for levels since the Lod was bound: until then it is pending. */
+    requested = false;
+    /** Its item on a LoadingManager. */
+    item;
+    /**
+     * The bits of the levels that draw nothing, the coarsest level that draws something, and the order levels load in: it
+     * first, then coarse to fine.
+     */
+    empty;
+    coarsest;
+    order;
+    /** When the latest arrival began. */
+    arrival;
+    /** Compiled levels waiting for the arrival under way to end. */
+    ready = new Map();
+    /** Levels being prepared and compiled to join the loaded ones. */
+    arriving = new Map();
+    /** The background compiles of loaded levels, per render context. */
+    compiles;
+    /** Per level, its load once started. */
+    loads = new Map();
+    /** What renders told of the cameras that drew the Lod. */
+    seen = new CameraRenders();
+    disposed = false;
+    /** What `LodLevel.hold` answered, each called once the Lod is disposed. */
+    releases;
+    /** The renderer drawing the Lod and what the cameras rendering it there asked for, once one drew it (see `see`). */
+    bound = null;
+    constructor(lod, 
+    /** The LoadingManager item's name, which errors name too: the kind of Lod and its uuid. */
+    name, 
+    /** The levels as the Lod was given them: it holds them (see `LodLevel.hold`) until it is disposed. */
+    levels, 
+    /** The levels as levelsToDraw reads them, for the ones that draw nothing and the coarsest that draws something. */
+    { empty, coarsest }, prepare, 
+    /** What draws a loaded level, compiled for each render context it is wanted in. */
+    drawnBy) {
+        this.lod = lod;
+        this.name = name;
+        this.levels = levels;
+        this.prepare = prepare;
+        this.drawnBy = drawnBy;
+        this.loaded = this.before = levels.reduce((bits, level, i) => (level.object ? bits | (1 << i) : bits), 0);
+        this.empty = empty;
+        this.coarsest = coarsest;
+        this.order = levels.length === 0 ? [] : [coarsest, ...[...levels.keys()].reverse().filter((level) => level !== coarsest)];
+        this.releases = [...new Set(levels.flatMap(({ hold }) => (hold ? [hold] : [])))].map((hold) => hold());
+        this.compiles = new ContextCompiles((context, bits) => this.compileLevels(context, bits), (error) => this.report(error));
+        this.item = new LoadingItem(name);
+    }
+    /** How far the latest arrival has faded in, in [0, 1]: 1 once it has. */
+    get progress() {
+        if (this.arrival === undefined)
+            return 1;
+        return Math.min((performance.now() - this.arrival) / ARRIVAL_MS, 1);
+    }
+    /** The renderer drawing the Lod: the first that drew one of its meshes; null before. */
+    get renderer() {
+        return this.bound?.renderer ?? null;
+    }
+    /**
+     * `renderer` draws one of the Lod's meshes, as three tells a mesh but not a LOD's `update`: the first binds the Lod
+     * to it, once checked to draw it; another throws.
+     */
+    see(renderer) {
+        if (this.bound) {
+            if (renderer !== this.bound.renderer)
+                throw new Error(`${this.name}: another renderer than the first that drew it drew it`);
+            return;
+        }
+        checkRenderer(renderer, this.name);
+        this.bound = { renderer, requests: new CameraRequests(renderer, this.seen) };
+        this.started = true;
+        // Its first frame drew nothing of it: it holds its item until the next asks for what its cameras need.
+        this.sync();
+    }
+    /** Whether `camera` still renders the Lod (see `CameraRequests.rendering`). */
+    rendering(camera) {
+        return this.bound?.requests.rendering(camera) ?? false;
+    }
+    get pending() {
+        if (this.disposed || this.error || !this.bound)
+            return false;
+        if (!this.requested)
+            return true;
+        const { requests } = this.bound;
+        if (this.arriving.size > 0 || this.ready.size > 0 || (requests.needed() & ~this.loaded) !== 0)
+            return true;
+        return this.compiles.running(requests);
+    }
+    /**
+     * `camera`, a shadow map's when `shadow`, wants the levels of the bits `wanted` (see levelsToLoad) in an update once
+     * the Lod is bound to a renderer (see `see`): load what is missing, and answer the bits of the levels loaded now. Outside a
+     * Scene a missing level is an error, as no render of it would load it.
+     */
+    request(camera, wanted, shadow) {
+        const scene = rootOf(this.lod);
+        if (this.disposed || this.error)
+            return this.loaded;
+        if (!isScene(scene)) {
+            if ((wanted & ~this.loaded) !== 0)
+                throw new Error(`${this.name}: render a Scene that holds it to load the levels it needs`);
+            return this.loaded;
+        }
+        this.item.touch();
+        const { requests } = this.boundOrThrow();
+        this.requested = true;
+        const frame = requests.set(scene, camera, wanted, shadow);
+        this.load(requests, camera, shadow, frame);
+        this.sync();
+        return this.loaded;
+    }
+    /**
+     * The height `camera`, a shadow map's when `shadow`, draws at with `renderer` (see CameraRenders.heightOf), which
+     * levels are chosen at.
+     */
+    heightOf(camera, renderer, shadow) {
+        return this.seen.heightOf(camera, renderer, shadow);
+    }
+    /** The renderer drawing the Lod and its cameras' requests: known once it drew the Lod, before anything loads. */
+    boundOrThrow() {
+        if (!this.bound)
+            throw new Error(`${this.name}: no renderer has updated it`);
+        return this.bound;
+    }
+    /** What compiles for `cameras` are for: the shadow maps they drew, and the targets disposed. */
+    compileFor(cameras) {
+        return { shadows: this.seen.shadowsOf(cameras), isDisposed: (target) => this.seen.isDisposed(target) };
+    }
+    /**
+     * Load what the cameras still rendering the Lod want, in `order`, compile for `camera`'s render context every loaded
+     * level that draws something, none of them wants and is not yet compiled for it, and prepare the levels that have
+     * loaded. `shadow` is whether a shadow map renders it, in the renderer's `frame`.
+     */
+    load(requests, camera, shadow, frame) {
+        const needed = requests.needed();
+        const coarsestLoaded = !this.levelAt(this.coarsest).load || this.loads.get(this.coarsest)?.object !== undefined;
+        for (const level of this.order) {
+            const { load } = this.levelAt(level);
+            if (!load || !has(needed, level) || this.loads.has(level) || (!coarsestLoaded && level !== this.coarsest))
+                continue;
+            this.start(level, load);
+        }
+        // What draws never changes halfway through a frame: once a camera updated the Lod in it, its indirect draws among
+        // them, a shadow map rendered later joins nothing. The camera's next update does; a Lod only shadow
+        // maps update joins in theirs.
+        if (!shadow || requests.cameraFrame !== frame)
+            this.join();
+        const context = this.seen.contextOf(camera);
+        if (!context)
+            return;
+        this.compiles.compile(context, this.compiles.claim(context, this.loaded & ~this.empty & ~needed));
+        const missing = needed & ~this.loaded;
+        for (const level of this.order) {
+            if (!has(missing, level) || !this.loads.get(level)?.object || this.arriving.has(level) || this.ready.has(level))
+                continue;
+            this.arrive(level, context);
+        }
+    }
+    /** Run level `level`'s `load`, holding the object it makes. */
+    start(level, load) {
+        const entry = {
+            promise: Promise.resolve()
+                .then(load)
+                .then((object) => {
+                if (!isObject3D(object))
+                    throw new Error(`${this.name}: level ${level}'s load must return an Object3D`);
+                entry.object = object;
+                return object;
+            })
+                .catch((error) => {
+                entry.error = error instanceof Error ? error : new Error(`${this.name}: level ${level} failed to load`, { cause: error });
+                throw entry.error;
+            }),
+        };
+        this.loads.set(level, entry);
+        void entry.promise.catch((error) => this.report(error));
+    }
+    levelAt(level) {
+        const found = this.levels[level];
+        if (!found)
+            throw new Error(`${this.name}: no level ${level}`);
+        return found;
+    }
+    /** Compile the loaded levels of `bits` for `context`: a background compile (see ContextCompiles). */
+    async compileLevels(context, bits) {
+        // A context whose target was disposed meanwhile is dropped: compiling would revive the target.
+        if (this.disposed || !this.seen.holds(context))
+            return;
+        const objects = this.order.filter((level) => has(bits, level)).flatMap((level) => this.drawnBy(level));
+        const { renderer, requests } = this.boundOrThrow();
+        const compileFor = this.compileFor(requests.cameras());
+        await Promise.all(objects.map((object) => compilerOf(renderer).compileAsync(object, context, compileFor)));
+    }
+    /**
+     * Prepare `level` once the render that asked for it has ended, if a camera still wants it then, and compile it for
+     * the render context of every camera still rendering the Lod, `context` among them, to join the loaded levels: a
+     * slow level never holds another's, and no camera draws it uncompiled.
+     */
+    arrive(level, context) {
+        // A render runs within one task: the next starts after it has ended.
+        const done = nextTask()
+            .then(async () => {
+            const object = this.loads.get(level)?.object;
+            const { renderer, requests } = this.boundOrThrow();
+            if (this.disposed || !object || !has(requests.needed(), level))
+                return;
+            const cameras = requests.cameras();
+            // Contexts whose targets were disposed meanwhile are dropped. A camera that starts rendering the Lod while it
+            // arrives draws it with pipelines built in that frame.
+            const seen = [context, ...cameras.flatMap((camera) => this.seen.contextOf(camera) ?? [])];
+            const contexts = new Set(seen.filter((other) => this.seen.holds(other)));
+            for (const other of contexts)
+                this.compiles.claim(other, 1 << level);
+            const prepared = this.prepare(level, object);
+            try {
+                const compileFor = this.compileFor(cameras);
+                await Promise.all([...contexts].map((other) => compilerOf(renderer).compileAsync(prepared.object, other, compileFor)));
+            }
+            catch (error) {
+                prepared.discard();
+                throw error;
+            }
+            if (this.disposed)
+                return prepared.discard();
+            this.ready.set(level, prepared);
+        })
+            .catch((error) => this.report(error))
+            .finally(() => {
+            this.arriving.delete(level);
+            this.join();
+        });
+        this.arriving.set(level, done);
+    }
+    /** Let compiled levels join the loaded ones, between arrivals: what draws never changes halfway through a fade. */
+    join() {
+        if (this.disposed || this.ready.size === 0 || this.progress < 1)
+            return;
+        this.before = this.loaded;
+        for (const [level, prepared] of this.ready) {
+            prepared.join();
+            this.loaded |= 1 << level;
+        }
+        this.ready.clear();
+        this.arrival = performance.now();
+        queueMicrotask(() => {
+            if (!this.disposed)
+                this.lod.dispatchEvent({ type: "levelschange" });
+        });
+    }
+    /**
+     * Hold the item while levels a camera wants are missing, compiling or arriving, and end it once they are done, so a host waiting for its LoadingManager renders its cameras complete. Called at
+     * the end of each request.
+     */
+    sync() {
+        this.item.sync(this.renderer, !this.disposed && !this.error && (this.pending || this.progress < 1));
+    }
+    /**
+     * The one failure rule, for a level that fails and for anything that throws while three renders, where a throw would
+     * leave its internal target bound: note the error, log it, report it on the LoadingManager the item is held on and
+     * end the item, and dispatch `levelserror`. Only the first is reported; it stops further loading.
+     */
+    report(error) {
+        if (this.disposed || this.error)
+            return;
+        const failure = (this.error = error instanceof Error ? error : new Error("Lod: level failed", { cause: error }));
+        console.error(failure);
+        this.item.fail();
+        this.lod.dispatchEvent({ type: "levelserror", error: failure });
+    }
+    /** Run `action`, part of an update or a draw callback, reporting what it throws instead. */
+    guard(action) {
+        try {
+            action();
+        }
+        catch (error) {
+            this.report(error);
+        }
+    }
+    /**
+     * Stop loading, then `release` what the Lod made of its levels and let go of what it holds of them (see
+     * `LodLevel.hold`), once nothing preparing, compiling or loading still uses them. What the levels gave or loaded is
+     * not freed: it is whoever made it's.
+     */
+    dispose(release) {
+        this.disposed = true;
+        this.item.sync(this.renderer, false);
+        this.seen.dispose();
+        for (const prepared of this.ready.values())
+            prepared.discard();
+        this.ready.clear();
+        const free = () => {
+            release();
+            for (const letGo of this.releases)
+                letGo();
+        };
+        const finish = () => {
+            const unsettled = [...this.loads.values()].flatMap((entry) => (!entry.object && !entry.error ? [entry.promise] : []));
+            // A mesh decode can begin its source-material dependency after disposal starts.
+            if (unsettled.length)
+                void Promise.allSettled(unsettled).then(free);
+            else
+                free();
+        };
+        const tasks = [...this.arriving.values(), ...this.compiles.tasks()];
+        if (tasks.length > 0)
+            void Promise.all(tasks).then(finish);
+        else
+            finish();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/levels/manager.js.map

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

package/dist/{material.d.ts → levels/material.d.ts}

@@ -1,7 +1,7 @@
 import type { Material, NodeMaterial } from "three/webgpu";
 /**
- * The copy of `material` (or of the material it copies) a level of a Lod or
- * InstancedLod draws with: it keeps only the pixels of its draw (see fade.ts), tints by
+ * The copy of `material` (or of the material it copies) a level of a Lod draws
+ * with: it keeps only the pixels of its draw (see fade.ts), tints by
  * its level, casts nothing into shadow maps too coarse for it and, `swaying`, sways in
  * the wind of whatever object draws it (see Wind). Made once per original and kind, and
  * shared by every level drawing it: what differs per object is read while it renders.

package/dist/{material.js → levels/material.js}

@@ -1,8 +1,9 @@
 import { Fn, output, positionLocal, vec4 } from "three/tsl";
 import { castPosition, keepsPixel, placeInstances, tint } from "./fade.js";
-import { toNodeMaterial } from "./three.js";
-import { isNodeOf } from "./tsl.js";
-import { sway } from "./wind/sway.js";
+import { toNodeMaterial } from "../three.js";
+import { isNodeOf } from "../tsl.js";
+import { sway } from "../wind/sway.js";
+// Side tables, as three's Material has no typed place for a package's state (userData is the app's).
 /** Copy → the material it copies. */
 const originals = new WeakMap();
 /** Original → its copies, still and swaying. */
@@ -14,8 +15,8 @@ function slot(node, type, builder) {
     return node;
 }
 /**
- * The copy of `material` (or of the material it copies) a level of a Lod or
- * InstancedLod draws with: it keeps only the pixels of its draw (see fade.ts), tints by
+ * The copy of `material` (or of the material it copies) a level of a Lod draws
+ * with: it keeps only the pixels of its draw (see fade.ts), tints by
  * its level, casts nothing into shadow maps too coarse for it and, `swaying`, sways in
  * the wind of whatever object draws it (see Wind). Made once per original and kind, and
  * shared by every level drawing it: what differs per object is read while it renders.

package/dist/levels/material.js.map

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

package/dist/levels/renderer.d.ts

@@ -0,0 +1,32 @@
+import type { Object3D, Renderer } from "three/webgpu";
+/**
+ * How deep in renders `renderer` is: -1 outside them, 0 in a render of its own, 1 in one it draws inside another, as it
+ * draws shadow maps and post-processing. Read from r186's `_callDepth`: three keeps a draw's built shader per depth,
+ * and no public API tells which.
+ */
+export declare function callDepth(renderer: Renderer): number;
+/**
+ * Whether `renderer` is rendering or compiling now, as it is while it updates what it draws; not while an app calls
+ * `update` itself or another renderer draws. A compile is told by r186's `_compilationPromises`, which no public API
+ * shows.
+ */
+export declare const busy: (renderer: Renderer) => boolean;
+/**
+ * Throws unless `renderer` can draw a Lod, `who`: three's WebGPU backend, whose device has indirect-first-instance, as
+ * each level's draws start at its list (see update.ts).
+ */
+export declare function checkRenderer(renderer: Renderer, who: string): void;
+/** The largest storage binding `renderer`'s device takes: r186's WebGPU backend's `device`, which three's types omit. */
+export declare function maxStorageBinding(renderer: Renderer): number;
+/**
+ * Whether the scene `node` is in is being drawn into a shadow map: three's shadow map render
+ * draws it with its own override material, and calls `update` on every LOD with the
+ * light's camera, which must not switch the levels the scene's camera chose.
+ */
+export declare function inShadowMap(node: Object3D): boolean;
+/**
+ * Whether `target` is the framebuffer target r186 draws the canvas (or output target) through when tone mapping or
+ * the output colour space needs a final pass. A draw meant for the output sees it as the active target; a compile for
+ * the output leaves the target unset and lets three resolve it.
+ */
+export declare const isOutputPass: (target: unknown) => boolean;