@drawcall/lod 0.0.0-stage → 0.1.2

package/dist/lazy.js

@@ -0,0 +1,187 @@
+import { Frustum, Matrix4, Object3D, Sphere } from "three/webgpu";
+import { ImpostorMesh } from "./impostor/mesh/index.js";
+import { validateImpostor } from "./impostor/impostor.js";
+import { isLazyImpostor, sameClass } from "./three.js";
+/**
+ * An impostor level whose atlas is loaded only when a viewing camera may need it.
+ * Put it after an eager source in Lod or InstancedLod. Until ready, the nearest
+ * ready finer level draws instead. The factory can decode cached data or bake it;
+ * it runs once across clones and concurrent requests. It does not upload textures.
+ */
+export class LazyImpostor extends Object3D {
+    isLazyImpostor = true;
+    options;
+    state;
+    constructor(load, options) {
+        super();
+        if (!(options.maxPixels > 0) || !Number.isFinite(options.maxPixels))
+            throw new Error("LazyImpostor: maxPixels must be finite and > 0");
+        this.options = { maxPixels: options.maxPixels, draw: { ...options.draw } };
+        this.state = {
+            shared: { factory: load, status: "idle", value: undefined, error: undefined, promise: undefined, attempt: 0, reported: -1, users: new Set([this]) },
+            mesh: undefined,
+            owners: 0,
+            disposed: false,
+        };
+    }
+    get maxPixels() {
+        return this.options.maxPixels;
+    }
+    get status() {
+        const state = this.state;
+        return state.disposed ? "disposed" : state.shared.status;
+    }
+    get error() {
+        return this.state.shared.error;
+    }
+    get impostor() {
+        return this.state.shared.value;
+    }
+    /** Prefetch atlas data, or explicitly retry a failed request. Errors reject. */
+    load() {
+        const state = this.state, shared = state.shared;
+        if (state.disposed)
+            return Promise.reject(new Error("LazyImpostor: already disposed"));
+        if (shared.status === "ready" && shared.value)
+            return Promise.resolve(shared.value);
+        if (shared.status === "loading" && shared.promise)
+            return shared.promise;
+        const factory = shared.factory;
+        if (!factory)
+            return Promise.reject(new Error("LazyImpostor: its source has been released"));
+        const attempt = ++shared.attempt;
+        shared.status = "loading";
+        shared.error = undefined;
+        shared.promise = Promise.resolve()
+            .then(factory)
+            .then((value) => {
+            validateImpostor(value);
+            if (shared.attempt !== attempt || shared.users.size === 0)
+                throw new Error("LazyImpostor: disposed before loading completed");
+            shared.value = value;
+            shared.status = "ready";
+            return value;
+        })
+            .catch((error) => {
+            if (shared.attempt === attempt && shared.users.size > 0) {
+                shared.status = "error";
+                shared.error = error;
+                for (const lazy of shared.users)
+                    lazy.dispatchEvent({ type: "error", error });
+            }
+            throw error;
+        });
+        return shared.promise;
+    }
+    copy(source) {
+        const own = this.state, from = source.state;
+        if (own.mesh || own.owners || own.disposed || from.disposed)
+            throw new Error("LazyImpostor.copy: use an unused target and a live source");
+        own.shared.users.delete(this);
+        own.shared = from.shared;
+        own.shared.users.add(this);
+        this.options.maxPixels = source.maxPixels;
+        this.options.draw = { ...source.options.draw };
+        super.copy(source, false);
+        return this;
+    }
+    clone() {
+        const factory = this.state.shared.factory;
+        if (this.state.disposed || !factory)
+            throw new Error("LazyImpostor.clone: already disposed");
+        const clone = new LazyImpostor(factory, this.options).copy(this);
+        if (!sameClass(this, clone))
+            throw new Error("LazyImpostor.clone: a subclass must override clone");
+        return clone;
+    }
+    /** @internal LOD ownership; several crowds can share a template. */
+    retain() {
+        if (this.state.disposed)
+            throw new Error("LazyImpostor: a disposed level cannot be reused");
+        this.state.owners++;
+    }
+    /** @internal Release a LOD's ownership of this template. */
+    release() {
+        if (this.state.owners < 1)
+            throw new Error("LazyImpostor: no owner to release");
+        if (--this.state.owners === 0)
+            this.dispose();
+    }
+    /** @internal The card has been installed, not merely decoded. */
+    get available() {
+        return this.state.mesh !== undefined;
+    }
+    /** @internal Install this descriptor's card before its LOD attaches draw hooks. */
+    materialize() {
+        const state = this.state;
+        if (state.disposed || state.mesh || !state.shared.value)
+            return;
+        const mesh = new ImpostorMesh(state.shared.value, 1, this.options.draw);
+        mesh.castShadow = this.castShadow;
+        mesh.receiveShadow = this.receiveShadow;
+        this.add(mesh);
+        state.mesh = mesh;
+    }
+    /** @internal Demand starts one request, with one visible report on failure. */
+    request() {
+        const { shared, disposed } = this.state;
+        if (disposed || shared.status !== "idle")
+            return;
+        const promise = this.load(), attempt = shared.attempt;
+        void promise.catch((error) => {
+            if (shared.users.size === 0 || shared.reported === attempt)
+                return;
+            shared.reported = attempt;
+            console.error(error);
+        });
+    }
+    /** Stops demand and releases this template's card. Pending work cannot install it. */
+    dispose() {
+        const state = this.state;
+        if (state.disposed)
+            return;
+        state.disposed = true;
+        if (state.mesh) {
+            this.remove(state.mesh);
+            state.mesh.dispose();
+            state.mesh = undefined;
+        }
+        state.shared.users.delete(this);
+        if (state.shared.users.size === 0) {
+            state.shared.attempt++;
+            state.shared.value = undefined;
+            state.shared.promise = undefined;
+            // Factories often retain an authored source or a CPU-only geometry snapshot.
+            state.shared.factory = undefined;
+        }
+    }
+}
+export function available(object) {
+    return !isLazyImpostor(object) || object.available;
+}
+/** Each logical level's nearest available finer level; eager empty levels still cull. */
+export function fallbacks(objects) {
+    let ready = 0;
+    return objects.map((object, index) => (available(object) ? (ready = index) : ready));
+}
+const views = new WeakMap();
+const projectionView = new Matrix4(), worldSphere = new Sphere();
+/** Demand only from the viewing frustum; lazy shadow work uses the ready fallback. */
+export function inView(camera, root, sphere) {
+    if (sphere.isEmpty())
+        return false;
+    let cached = views.get(camera);
+    if (!cached) {
+        cached = { projection: new Matrix4().makeScale(0, 0, 0), world: new Matrix4(), frustum: new Frustum() };
+        views.set(camera, cached);
+    }
+    if (!cached.projection.equals(camera.projectionMatrix) || !cached.world.equals(camera.matrixWorld)) {
+        cached.projection.copy(camera.projectionMatrix);
+        cached.world.copy(camera.matrixWorld);
+        projectionView.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
+        cached.frustum.setFromProjectionMatrix(projectionView, camera.coordinateSystem, camera.reversedDepth);
+    }
+    worldSphere.copy(sphere).applyMatrix4(root);
+    return cached.frustum.intersectsSphere(worldSphere);
+}
+//# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

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

package/dist/levels.d.ts

@@ -0,0 +1,72 @@
+import { Color, type Object3D } from "three/webgpu";
+/**
+ * A fade dithers over the top of a level's range: from maxPixels × (1 - FADE) to
+ * maxPixels. Instances inside it draw twice; a narrower fade pops no more visibly, as
+ * the dither spreads the switch over the frames an approach takes to cross it.
+ */
+export declare const FADE = 0.1;
+/** One entry of `Lod.levels`. */
+export interface LodLevel {
+    readonly object: Object3D;
+    /**
+     * The largest on-screen height, in CSS pixels, at which this level is used
+     * (heights are × `Lod.quality`). Level 0, the source, has Infinity.
+     * Every further level's must be at most 0.9 of the previous one's, so that one fade has
+     * ended before the next begins.
+     *
+     * Unless set, it is where the level is about a pixel off: for a level `simplify` or
+     * `bakeMesh` returned, where its measured error reaches a pixel (a clone you make of
+     * it does not carry the error; a cloned Lod keeps it); for an ImpostorMesh, where two
+     * atlas texels span one pixel; else half the previous level's (512 px for level 1).
+     * Such defaults are raised to twice the next level's where they would leave no room
+     * for the fades.
+     */
+    maxPixels: number;
+}
+export declare class Level implements LodLevel {
+    readonly object: Object3D;
+    readonly index: number;
+    /** A nested LOD switches its own levels and fades by them, not by its parent. */
+    readonly nested: boolean;
+    /** The levels this one is in, which its default depends on. */
+    private readonly ladder;
+    /** Debug tint (see `Lod.debug`), white when off; shared by every draw of the level. */
+    readonly tint: Color;
+    /** maxPixels as set, or null for the default */
+    explicit: number | null;
+    /** The default before raising for the fades: see `resolve`. */
+    base: number;
+    /** maxPixels as resolved; see `resolve` */
+    value: number;
+    constructor(object: Object3D, index: number, 
+    /** A nested LOD switches its own levels and fades by them, not by its parent. */
+    nested: boolean, 
+    /** The levels this one is in, which its default depends on. */
+    ladder: readonly Level[]);
+    get maxPixels(): number;
+    set maxPixels(value: number);
+}
+/** Record that `level` is `error` off its source (see `errors`). */
+export declare const recordError: (level: Object3D, error: number) => void;
+/** The error recorded for `level`, if any. */
+export declare const errorOf: (level: Object3D) => number | undefined;
+/** Clones of `levels`' objects, which keep the errors recorded for them. */
+export declare function cloneLevels(levels: readonly Level[]): Object3D[];
+/** Give `to` the maxPixels set on `from`, level by level. */
+export declare function copyThresholds(from: readonly Level[], to: readonly Level[]): void;
+/**
+ * Give each level its default `base`, for a source of bounding diameter `diameter` in its
+ * own units, and resolve the thresholds (see `LodLevel.maxPixels`).
+ */
+export declare function estimate(levels: readonly Level[], diameter: number): void;
+/** Throws unless each level's fade ends before the next one's begins (see `LodLevel.maxPixels`). */
+export declare function validate(levels: readonly LodLevel[]): void;
+/** The level drawn at `height`: the last one it fits, or `forceLevel`. */
+export declare function levelAt(levels: readonly Level[], height: number, forceLevel: number | null): Level;
+/**
+ * How far `level` has faded in over its finer neighbour at `height`, in [0, 1): 0 when
+ * no fade is under way (the finer level is gone). See fade.ts for how both draw it.
+ */
+export declare function fadeProgress(levels: readonly Level[], level: Level, height: number): number;
+/** Give each level its debug tint, or white. */
+export declare function tintLevels(levels: readonly Level[], debug: boolean): void;

package/dist/levels.js

@@ -0,0 +1,146 @@
+import { Color } from "three/webgpu";
+import { texelPixels } from "./impostor/impostor.js";
+import { isLazyImpostor, isImpostorMesh } from "./three.js";
+// The levels Lod and InstancedLod share: their thresholds, the defaults of those, which
+// level a height picks and how far it has faded in (see fade.ts).
+/**
+ * A fade dithers over the top of a level's range: from maxPixels × (1 - FADE) to
+ * maxPixels. Instances inside it draw twice; a narrower fade pops no more visibly, as
+ * the dither spreads the switch over the frames an approach takes to cross it.
+ */
+export const FADE = 0.1;
+export class Level {
+    object;
+    index;
+    nested;
+    ladder;
+    /** Debug tint (see `Lod.debug`), white when off; shared by every draw of the level. */
+    tint = new Color(1, 1, 1);
+    /** maxPixels as set, or null for the default */
+    explicit = null;
+    /** The default before raising for the fades: see `resolve`. */
+    base = Infinity;
+    /** maxPixels as resolved; see `resolve` */
+    value = Infinity;
+    constructor(object, index, 
+    /** A nested LOD switches its own levels and fades by them, not by its parent. */
+    nested, 
+    /** The levels this one is in, which its default depends on. */
+    ladder) {
+        this.object = object;
+        this.index = index;
+        this.nested = nested;
+        this.ladder = ladder;
+        if (isLazyImpostor(object))
+            this.explicit = object.maxPixels;
+    }
+    get maxPixels() {
+        return this.value;
+    }
+    set maxPixels(value) {
+        if (this.index === 0 && value !== Infinity)
+            throw new Error(`Lod: level 0, the source, is used at any height: its maxPixels is Infinity, not ${value}`);
+        if (this.index === 0)
+            return;
+        if (!(value > 0))
+            throw new Error(`Lod: maxPixels must be > 0, got ${value}`);
+        this.explicit = value;
+        resolve(this.ladder);
+    }
+}
+/** Error a built level reports: how far its surface is from its source's, in the source's units. */
+const errors = new WeakMap();
+/** Record that `level` is `error` off its source (see `errors`). */
+export const recordError = (level, error) => void errors.set(level, error);
+/** The error recorded for `level`, if any. */
+export const errorOf = (level) => errors.get(level);
+/** Clones of `levels`' objects, which keep the errors recorded for them. */
+export function cloneLevels(levels) {
+    return levels.map(({ object }) => {
+        const clone = object.clone();
+        const error = errorOf(object);
+        if (error !== undefined)
+            errors.set(clone, error);
+        return clone;
+    });
+}
+/** Give `to` the maxPixels set on `from`, level by level. */
+export function copyThresholds(from, to) {
+    to.forEach((level, i) => {
+        const explicit = from[i]?.explicit ?? null;
+        if (explicit !== null)
+            level.maxPixels = explicit;
+    });
+}
+/**
+ * Give each level its default `base`, for a source of bounding diameter `diameter` in its
+ * own units, and resolve the thresholds (see `LodLevel.maxPixels`).
+ */
+export function estimate(levels, diameter) {
+    let finer = 1024;
+    for (const level of levels.slice(1)) {
+        const error = errorOf(level.object);
+        if (isLazyImpostor(level.object))
+            level.base = level.object.maxPixels;
+        else if (error !== undefined)
+            level.base = diameter / Math.max(error, diameter * 1e-4);
+        else if (isImpostorMesh(level.object))
+            level.base = texelPixels(level.object.impostor);
+        else
+            level.base = finer / 2;
+        finer = level.base;
+    }
+    resolve(levels);
+}
+/** Each level's maxPixels: as set, else its base raised to twice the next level's, from the cheapest up. */
+function resolve(levels) {
+    let next = 0;
+    for (const level of [...levels].reverse()) {
+        level.value = level.index === 0 ? Infinity : (level.explicit ?? Math.max(level.base, 2 * next));
+        next = level.value;
+    }
+}
+/** Throws unless each level's fade ends before the next one's begins (see `LodLevel.maxPixels`). */
+export function validate(levels) {
+    levels.forEach((level, i) => {
+        const finer = levels[i - 1];
+        if (finer && level.maxPixels > finer.maxPixels * (1 - FADE))
+            throw new Error(`Lod: level ${i} has maxPixels ${level.maxPixels}, but at most ${finer.maxPixels * (1 - FADE)} (${1 - FADE} × level ${i - 1}'s ${finer.maxPixels}) leaves room for the fades`);
+    });
+}
+/** The level drawn at `height`: the last one it fits, or `forceLevel`. */
+export function levelAt(levels, height, forceLevel) {
+    const level = levels[forceLevel ?? lastFitting(levels, height)];
+    if (!level)
+        throw new Error(`Lod: forceLevel ${forceLevel} is not a level`);
+    return level;
+}
+function lastFitting(levels, height) {
+    for (let i = levels.length - 1; i > 0; i--) {
+        const level = levels[i];
+        if (level && height <= level.maxPixels)
+            return i;
+    }
+    return 0;
+}
+/**
+ * How far `level` has faded in over its finer neighbour at `height`, in [0, 1): 0 when
+ * no fade is under way (the finer level is gone). See fade.ts for how both draw it.
+ */
+export function fadeProgress(levels, level, height) {
+    const finer = levels[level.index - 1];
+    if (!finer || level.nested || finer.nested)
+        return 0;
+    const top = level.maxPixels;
+    const t = Math.min(Math.max((height - top * (1 - FADE)) / (top * FADE), 0), 1);
+    // smoothstep, as the GPU's selection computes it
+    return t * t * (3 - 2 * t);
+}
+/** Debug tints by level index, see `Lod.debug`. */
+const TINTS = [0xff6060, 0x60ff60, 0x6080ff, 0xffd040, 0xff60ff, 0x60ffff].map((hex) => new Color(hex));
+/** Give each level its debug tint, or white. */
+export function tintLevels(levels, debug) {
+    for (const level of levels)
+        level.tint.set(debug ? (TINTS[level.index % TINTS.length] ?? 0xffffff) : 0xffffff);
+}
+//# sourceMappingURL=levels.js.map

package/dist/levels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levels.js","sourceRoot":"","sources":["../src/levels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAiB,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,wFAAwF;AACxF,kEAAkE;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC;AAqBxB,MAAM,OAAO,KAAK;IAWL;IACA;IAEA;IAEQ;IAfnB,uFAAuF;IAC9E,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,gDAAgD;IAChD,QAAQ,GAAkB,IAAI,CAAC;IAC/B,+DAA+D;IAC/D,IAAI,GAAG,QAAQ,CAAC;IAChB,2CAA2C;IAC3C,KAAK,GAAG,QAAQ,CAAC;IAEjB,YACW,MAAgB,EAChB,KAAa;IACtB,iFAAiF;IACxE,MAAe;IACxB,+DAA+D;IAC9C,MAAwB;QALhC,WAAM,GAAN,MAAM,CAAU;QAChB,UAAK,GAAL,KAAK,CAAQ;QAEb,WAAM,GAAN,MAAM,CAAS;QAEP,WAAM,GAAN,MAAM,CAAkB;QAEzC,IAAI,cAAc,CAAC,MAAM,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,SAAS,CAAC,KAAa;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,mFAAmF,KAAK,EAAE,CAAC,CAAC;QACxJ,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;CACF;AAED,oGAAoG;AACpG,MAAM,MAAM,GAAG,IAAI,OAAO,EAAoB,CAAC;AAE/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAE,KAAa,EAAQ,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACnG,8CAA8C;AAC9C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAe,EAAsB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAElF,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,IAAsB,EAAE,EAAoB;IACzE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;QAC3C,IAAI,QAAQ,KAAK,IAAI;YAAE,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAwB,EAAE,QAAgB;IACjE,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;aACjE,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;aAClF,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;;YAClF,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,4GAA4G;AAC5G,SAAS,OAAO,CAAC,MAAwB;IACvC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAChG,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,QAAQ,CAAC,MAA2B;IAClD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,cAAc,CAAC,kBAAkB,KAAK,CAAC,SAAS,iBAAiB,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,SAAS,6BAA6B,CAC9K,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,OAAO,CAAC,MAAwB,EAAE,MAAc,EAAE,UAAyB;IACzF,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,iBAAiB,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,MAAwB,EAAE,MAAc;IAC3D,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAwB,EAAE,KAAY,EAAE,MAAc;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,iDAAiD;IACjD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,mDAAmD;AACnD,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAExG,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,MAAwB,EAAE,KAAc;IACjE,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjH,CAAC"}

package/dist/loader/cache.d.ts

@@ -0,0 +1,15 @@
+import type { GLTSSource } from "@drawcall/glts";
+import type { Object3D } from "three/webgpu";
+import type { Dependencies } from "vitecache";
+import { type BakeImpostorOptions } from "../impostor/bake/index.js";
+import { type ImpostorCacheOptions } from "../impostor/cache.js";
+import type { Impostor } from "../impostor/impostor.js";
+/** Cache location and additional inputs that GLTS does not track, such as generator packages. */
+export interface LodCacheOptions extends ImpostorCacheOptions {
+    /** Extra vitecache dependencies. Names beginning with glts: or lod: are reserved. */
+    dependencies?: Dependencies;
+}
+/** Loaded GLTS scenes expose their run's source even outside an active script. */
+export declare function originOf(object: Object3D): GLTSSource | undefined;
+/** Capture dependencies when the bake starts, including files loaded since its request. */
+export declare function impostor(source: Object3D, options: BakeImpostorOptions, origin?: GLTSSource, excluded?: readonly Object3D[], cacheOptions?: LodCacheOptions): Promise<Impostor>;

package/dist/loader/cache.js

@@ -0,0 +1,37 @@
+import { bake, bakeImpostor } from "../impostor/bake/index.js";
+import { cached } from "../impostor/cache.js";
+/** Loaded GLTS scenes expose their run's source even outside an active script. */
+export function originOf(object) {
+    const source = Reflect.get(object, "source");
+    if (source === undefined)
+        return undefined;
+    if (!isSource(source))
+        throw new Error("LodLoader: invalid GLTS source metadata");
+    return source;
+}
+function isSource(source) {
+    if (typeof source !== "object" || source === null)
+        return false;
+    const url = Reflect.get(source, "url");
+    const dependencies = Reflect.get(source, "dependencyUrls");
+    return typeof url === "string" && Array.isArray(dependencies) && dependencies.every((url) => typeof url === "string");
+}
+/** Capture dependencies when the bake starts, including files loaded since its request. */
+export async function impostor(source, options, origin, excluded = [], cacheOptions) {
+    const make = (settings) => (excluded.length > 0 ? bake(source, settings, excluded) : bakeImpostor(source, settings));
+    if (!origin)
+        return make(options);
+    const urls = origin.dependencyUrls;
+    const { dependencies = {}, ...location } = cacheOptions ?? {};
+    if (Object.keys(dependencies).some((name) => name.startsWith("glts:")))
+        throw new Error("LodLoader: dependency names beginning with glts: are reserved");
+    return cached(options, {
+        ...dependencies,
+        "glts:source": { url: origin.url },
+        // URL resolution tracks the file; retain its query parameters as inputs too.
+        "glts:query": { value: new URL(origin.url).search },
+        ...Object.fromEntries(urls.map((url, index) => [`glts:dependency:${index}`, { url }])),
+        "glts:dependencyQueries": { value: urls.map((url) => new URL(url).search) },
+    }, make, location);
+}
+//# sourceMappingURL=cache.js.map

package/dist/loader/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/loader/cache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,YAAY,EAA4B,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,MAAM,EAA6B,MAAM,sBAAsB,CAAC;AASzE,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,MAAgB;IACvC,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,MAAe;IAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,GAAG,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,YAAY,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACpE,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC;AACjI,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAgB,EAChB,OAA4B,EAC5B,MAAmB,EACnB,WAAgC,EAAE,EAClC,YAA8B;IAE9B,MAAM,IAAI,GAAG,CAAC,QAA6B,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1I,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC;IACnC,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,YAAY,IAAI,EAAE,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACzJ,OAAO,MAAM,CACX,OAAO,EACP;QACE,GAAG,YAAY;QACf,aAAa,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;QAClC,6EAA6E;QAC7E,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE;QACnD,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACtF,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE;KAC5E,EACD,IAAI,EACJ,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/loader/dispose.d.ts

@@ -0,0 +1,3 @@
+import type { Object3D } from "three/webgpu";
+/** Failed simplifications own new geometry, but borrow source materials and untouched geometry. */
+export declare function disposeSimplified(copy: Object3D, source: Object3D): void;

package/dist/loader/dispose.js

@@ -0,0 +1,25 @@
+import { isImpostorMesh, isInstancedMesh, isLazyImpostor, isMesh } from "../three.js";
+/** Failed simplifications own new geometry, but borrow source materials and untouched geometry. */
+export function disposeSimplified(copy, source) {
+    const kept = new Set();
+    source.traverse((node) => {
+        if (isMesh(node))
+            kept.add(node.geometry);
+    });
+    copy.traverse((node) => {
+        // These clones retain their own references; their disposal releases only those.
+        if (isImpostorMesh(node) || isLazyImpostor(node)) {
+            node.dispose();
+            return;
+        }
+        if (!isMesh(node))
+            return;
+        if (!kept.has(node.geometry)) {
+            node.geometry.dispose();
+            kept.add(node.geometry);
+        }
+        if (isInstancedMesh(node))
+            node.dispose();
+    });
+}
+//# sourceMappingURL=dispose.js.map

package/dist/loader/dispose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.js","sourceRoot":"","sources":["../../src/loader/dispose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEtF,mGAAmG;AACnG,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,MAAgB;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACvB,IAAI,MAAM,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,gFAAgF;QAChF,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,eAAe,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,99 @@
+import { Loader, type LoadingManager, type Object3D } from "three/webgpu";
+import type { BakeImpostorOptions } from "./impostor/bake/index.js";
+import { InstancedLod } from "./instanced/index.js";
+import { Lod } from "./lod.js";
+import { type LodCacheOptions } from "./loader/cache.js";
+export type { LodCacheOptions } from "./loader/cache.js";
+import { type SimplifyOptions } from "./simplify.js";
+/** A level the loader builds from the source, cheapest last; `maxPixels` overrides its default (see `LodLevel.maxPixels`). */
+export type LevelRequest = ({
+    type: "simplified";
+    maxPixels?: number;
+} & SimplifyOptions) | ({
+    type: "baked";
+    maxPixels?: number;
+    textureSize?: number;
+    /**
+     * URL of the rooms to show through the model's glass (see `BakeMeshOptions.interior`),
+     * loaded like the model and relative to it. It is added to the model after every
+     * level is built, so up close the real rooms show through the real glass. Only one
+     * baked level of a model may have one.
+     */
+    interior?: string;
+} & ({
+    /**
+     * URL of the mesh to bake onto (.glts, .glb or .gltf), loaded like the model. A
+     * relative URL is relative to the model's: a model and its low mesh live together.
+     */
+    low: string;
+    ratio?: never;
+} | {
+    low?: never;
+    ratio?: number;
+})) | ({
+    type: "impostor";
+    /** Build only when needed; requires an explicit positive maxPixels. Default false. */
+    lazy?: boolean;
+} & BakeImpostorOptions);
+/**
+ * A model URL (.glb, .gltf or .glts), or the complete asset passed from its active GLTS
+ * script. The whole GLTS asset is the cache unit, not individual parts of its scene.
+ * GLTS impostors persist through vitecache; its Vite plugin tracks the script and its
+ * dependency files. Pass an object only after its dependency loads have finished;
+ * deferred impostors read retained dependencies when loading begins.
+ */
+export type LodRequest = string | Object3D | {
+    url: string;
+    levels?: readonly LevelRequest[];
+} | {
+    source: Object3D;
+    levels?: readonly LevelRequest[];
+};
+/**
+ * Loads a model and builds a `Lod` of it: the model as level 0, then the requested
+ * levels (default: an impostor). Unless explicitly lazy, building runs at load time; impostors bake on a
+ * renderer this package keeps for that. Each level's maxPixels is its default (see
+ * `LodLevel.maxPixels`) unless the request sets it; a failed load frees what it built.
+ *
+ * Models load through the manager's handler for the URL if one is registered: a
+ * GLTFLoader with Draco or meshopt decoders, or for .glts a GLTSLoader from
+ * @drawcall/glts (inside a .glts script, the contextual `gltsLoader`, registered on the
+ * contextual `loadingManager`). Without one, .glb/.gltf load with a plain GLTFLoader and
+ * .glts fails. URLs resolve against `path` as GLTFLoader's do; a baked level's `low` and
+ * `interior` URLs load the same way, relative to the model's URL.
+ */
+export declare class LodLoader extends Loader<Lod, LodRequest> {
+    private readonly cacheOptions?;
+    private gltf;
+    constructor(manager?: LoadingManager, cacheOptions?: LodCacheOptions | undefined);
+    load(request: LodRequest, onLoad: (lod: Lod) => void, _onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
+    loadAsync(request: LodRequest): Promise<Lod>;
+    /** Load `request` as `count` instances: an `InstancedLod`. */
+    loadInstancesAsync(request: LodRequest, count: number): Promise<InstancedLod>;
+    /** Build a `Lod` of the complete `object` inside GLTS. Relative low/interior URLs use the script's directory. */
+    parseAsync(object: Object3D, levels?: readonly LevelRequest[]): Promise<Lod>;
+    /** Build an `InstancedLod` of the complete `object` inside GLTS. */
+    parseInstancesAsync(object: Object3D, count: number, levels?: readonly LevelRequest[]): Promise<InstancedLod>;
+    /**
+     * `make` of `object` and its requested levels, with the maxPixels requested; `low` and
+     * `interior` URLs resolve against `base`. On failure, the levels built and interiors
+     * loaded are freed and `object` is left out of any Lod.
+     */
+    private build;
+    /** The level `request` asks for, and the interior a baked level loaded for the source. */
+    private buildLevel;
+    /**
+     * Bake `source` as `request` asks, loading its low mesh and interior relative to `base`.
+     * The low mesh is freed after: only the bake keeps it. The interior is returned for the
+     * source, or freed if the bake fails.
+     */
+    private bake;
+    /**
+     * Load `request`'s model and `build` it, reporting to the manager as one item; `build`
+     * gets the model's directory. On failure, the model is freed.
+     */
+    private loading;
+    private loadSource;
+    /** `loader` with this loader's request settings. */
+    private configure;
+}