@drawcall/lod 0.0.0-stage → 0.1.0

package/dist/source/texels.js

@@ -0,0 +1,191 @@
+import { ClampToEdgeWrapping, MirroredRepeatWrapping, RGBAFormat, SRGBColorSpace, UnsignedByteType } from "three/webgpu";
+/**
+ * A texture's texels on the CPU, with a box-filtered mip chain like the GPU's, sampled
+ * trilinearly in its UV space (its matrix, wrapping and flipY applied). An sRGB texture is
+ * filtered and returned in linear values, as the GPU decodes before filtering. Every
+ * texture is read through the `uv` attribute: `texture.channel` is ignored. The pixels
+ * are read at the first sample: a texture nothing samples is never read.
+ */
+export class Texels {
+    texture;
+    /** |det| of the texture matrix: how much it scales UV area */
+    uvScale;
+    /** 8-bit value to 0..1, per channel: colour channels decode sRGB if the texture is sRGB */
+    decode;
+    /** the texture's UV transform (Matrix3 elements, column-major) */
+    matrix;
+    wrapS;
+    wrapT;
+    lower = new Float32Array(4);
+    upper = new Float32Array(4);
+    read = null;
+    constructor(texture) {
+        this.texture = texture;
+        this.decode = decoders(texture.colorSpace === SRGBColorSpace);
+        if (texture.matrixAutoUpdate)
+            texture.updateMatrix();
+        this.matrix = texture.matrix.elements.slice();
+        const [a = 1, b = 0, , c = 0, d = 1] = this.matrix;
+        this.uvScale = Math.abs(a * d - b * c);
+        this.wrapS = texture.wrapS;
+        this.wrapT = texture.wrapT;
+    }
+    get width() {
+        return this.base().width;
+    }
+    get height() {
+        return this.base().height;
+    }
+    base() {
+        return this.pixels().mips[0] ?? missing();
+    }
+    pixels() {
+        if (this.read)
+            return this.read;
+        const { texture } = this;
+        const { data, width, height, rowsUp } = pixels(texture);
+        // Row 0 of the pixels is v = 1 when they were uploaded flipped.
+        this.read = { mips: mipmaps({ data, width, height }, texture.colorSpace === SRGBColorSpace), flipY: texture.flipY && !rowsUp };
+        return this.read;
+    }
+    /** The texel at (u, v) from mip `mip` (fractional: trilinear) into `out`, channels 0..1. */
+    sample(u, v, mip, out) {
+        const [m0 = 1, m1 = 0, , m3 = 0, m4 = 1, , m6 = 0, m7 = 0] = this.matrix;
+        const su = wrap(m0 * u + m3 * v + m6, this.wrapS);
+        const tv = wrap(m1 * u + m4 * v + m7, this.wrapT);
+        const { mips, flipY } = this.pixels();
+        const sv = flipY ? 1 - tv : tv;
+        const top = mips.length - 1;
+        const l = Math.min(Math.max(mip, 0), top);
+        const l0 = Math.floor(l);
+        const f = l - l0;
+        this.bilinear(l0, su, sv, f > 0 ? this.lower : out);
+        if (f === 0)
+            return;
+        this.bilinear(Math.min(l0 + 1, top), su, sv, this.upper);
+        for (let k = 0; k < 4; k++)
+            out[k] = (this.lower[k] ?? 0) * (1 - f) + (this.upper[k] ?? 0) * f;
+    }
+    bilinear(mip, su, sv, out) {
+        const { data, width, height } = this.pixels().mips[mip] ?? missing();
+        const x = su * width - 0.5;
+        const y = sv * height - 0.5;
+        const x0 = Math.floor(x);
+        const y0 = Math.floor(y);
+        const fx = x - x0;
+        const fy = y - y0;
+        const cx = (i) => (this.wrapS === ClampToEdgeWrapping ? Math.min(Math.max(i, 0), width - 1) : ((i % width) + width) % width);
+        const cy = (i) => (this.wrapT === ClampToEdgeWrapping ? Math.min(Math.max(i, 0), height - 1) : ((i % height) + height) % height);
+        const a = (cy(y0) * width + cx(x0)) * 4;
+        const b = (cy(y0) * width + cx(x0 + 1)) * 4;
+        const c = (cy(y0 + 1) * width + cx(x0)) * 4;
+        const d = (cy(y0 + 1) * width + cx(x0 + 1)) * 4;
+        for (let k = 0; k < 4; k++) {
+            const decode = this.decode[k] ?? missing();
+            const top = (decode[data[a + k] ?? 0] ?? 0) * (1 - fx) + (decode[data[b + k] ?? 0] ?? 0) * fx;
+            const bottom = (decode[data[c + k] ?? 0] ?? 0) * (1 - fx) + (decode[data[d + k] ?? 0] ?? 0) * fx;
+            out[k] = top * (1 - fy) + bottom * fy;
+        }
+    }
+}
+const missing = () => {
+    throw new Error("Texels: lookup out of range");
+};
+export const srgbToLinear = (c) => (c <= 0.04045 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4));
+export const linearToSrgb = (c) => (c <= 0.0031308 ? c * 12.92 : 1.055 * Math.pow(Math.min(c, 1), 1 / 2.4) - 0.055);
+function wrap(x, mode) {
+    if (mode === ClampToEdgeWrapping)
+        return Math.min(Math.max(x, 0), 1);
+    if (mode === MirroredRepeatWrapping) {
+        const f = ((x % 2) + 2) % 2;
+        return f > 1 ? 2 - f : f;
+    }
+    return x - Math.floor(x);
+}
+/** Whether `pixels` can read `texture` on the CPU. */
+export function readable(texture) {
+    if ("isCompressedTexture" in texture)
+        return false;
+    const image = texture.image;
+    if (isData(image))
+        return texture.format === RGBAFormat && texture.type === UnsignedByteType;
+    return drawable(image) !== null;
+}
+/** The texture's 8-bit RGBA pixels; `rowsUp` when row 0 is v = 0 whatever flipY says. */
+function pixels(texture) {
+    const image = texture.image;
+    if ("isCompressedTexture" in texture)
+        throw new Error(`cannot read compressed texture "${texture.name}" on the CPU`);
+    if (isData(image)) {
+        if (texture.format !== RGBAFormat || texture.type !== UnsignedByteType)
+            throw new Error(`cannot read data texture "${texture.name}" on the CPU: it is not 8-bit RGBA`);
+        const data = new Uint8ClampedArray(image.data.buffer, image.data.byteOffset, image.width * image.height * 4);
+        // Data textures are uploaded as they are.
+        return { data, width: image.width, height: image.height, rowsUp: true };
+    }
+    const source = drawable(image);
+    if (!source)
+        throw new Error(`cannot read the image of texture "${texture.name}" on the CPU`);
+    const { width, height } = source;
+    const context = new OffscreenCanvas(width, height).getContext("2d", { willReadFrequently: true });
+    if (!context)
+        throw new Error("no 2D canvas to read textures with");
+    context.drawImage(source, 0, 0);
+    const { data } = context.getImageData(0, 0, width, height, { colorSpace: "srgb" });
+    // ImageBitmaps ignore flipY on upload.
+    return { data, width, height, rowsUp: typeof ImageBitmap !== "undefined" && source instanceof ImageBitmap };
+}
+function isData(image) {
+    if (typeof image !== "object" || image === null || !("data" in image))
+        return false;
+    return image.data instanceof Uint8Array || image.data instanceof Uint8ClampedArray;
+}
+/** `image` as something a 2D canvas draws, if it is one. */
+function drawable(image) {
+    const kinds = [globalThis.ImageBitmap, globalThis.HTMLImageElement, globalThis.HTMLCanvasElement, globalThis.OffscreenCanvas];
+    for (const kind of kinds)
+        if (kind && image instanceof kind)
+            return image;
+    return null;
+}
+/** Per channel, 8-bit value to 0..1: the colour channels of an sRGB image decode to linear. */
+function decoders(srgb) {
+    const linear = Float32Array.from({ length: 256 }, (_, i) => i / 255);
+    const color = srgb ? linear.map(srgbToLinear) : linear;
+    return [color, color, color, linear];
+}
+/**
+ * `base` and its box-filtered halvings down to 1×1, as generateMipmap makes them: an sRGB
+ * image is averaged in linear values.
+ */
+export function mipmaps(base, srgb) {
+    const decode = decoders(srgb);
+    const encode = (value, channel) => (srgb && channel < 3 ? linearToSrgb(value) : value);
+    const mips = [base];
+    let mip = base;
+    while (mip.width > 1 || mip.height > 1) {
+        const { data: from, width: w, height: h } = mip;
+        const width = Math.max(1, w >> 1);
+        const height = Math.max(1, h >> 1);
+        const data = new Uint8ClampedArray(width * height * 4);
+        for (let k = 0; k < 4; k++) {
+            const d = decode[k] ?? missing();
+            for (let y = 0; y < height; y++) {
+                const row0 = Math.min(y * 2, h - 1) * w;
+                const row1 = Math.min(y * 2 + 1, h - 1) * w;
+                for (let x = 0; x < width; x++) {
+                    const x0 = Math.min(x * 2, w - 1);
+                    const x1 = Math.min(x * 2 + 1, w - 1);
+                    const sum = (d[from[(row0 + x0) * 4 + k] ?? 0] ?? 0) +
+                        (d[from[(row0 + x1) * 4 + k] ?? 0] ?? 0) +
+                        (d[from[(row1 + x0) * 4 + k] ?? 0] ?? 0) +
+                        (d[from[(row1 + x1) * 4 + k] ?? 0] ?? 0);
+                    data[(y * width + x) * 4 + k] = encode(sum / 4, k) * 255;
+                }
+            }
+        }
+        mips.push((mip = { data, width, height }));
+    }
+    return mips;
+}
+//# sourceMappingURL=texels.js.map

package/dist/source/texels.js.map

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

package/dist/source/trace.d.ts

@@ -0,0 +1,42 @@
+import type { Vector3 } from "three/webgpu";
+import type { Hit, Shading } from "./shading.js";
+import type { Source } from "./source.js";
+/**
+ * Casts rays at the source and finds the nearest hit the material keeps: the back of a
+ * single-sided surface and cut-out points are passed through, as three draws neither.
+ * One walk through the BVH, boxes nearest first and skipped once they start beyond the
+ * best hit so far, triangles tested inline (Möller–Trumbore); nothing is allocated per ray.
+ */
+export declare class Tracer {
+    private readonly source;
+    private readonly shading;
+    /** after `cast`, the triangle hit (in the source's index) and the hit's weights for its second and third corners */
+    triangle: number;
+    w1: number;
+    w2: number;
+    private ox;
+    private oy;
+    private oz;
+    private dx;
+    private dy;
+    private dz;
+    /** 1 / direction, per axis */
+    private ix;
+    private iy;
+    private iz;
+    private best;
+    private cutout;
+    private facing;
+    private readonly callbacks;
+    constructor(source: Source, shading: Shading);
+    /**
+     * Cast from `origin` along unit `direction` up to `far`; `facing` decides which side of
+     * a surface is its front (null: both sides stop the ray). Returns "opaque" with `triangle`, `w1`, `w2` set; else
+     * "cutout" if it passed a cut-out point, else "back" (nothing kept).
+     */
+    cast(origin: Vector3, direction: Vector3, far: number, facing: Vector3 | null): Hit;
+    /** Distance along the ray to where it enters `box`; Infinity if it misses it before `best`. */
+    private enter;
+    /** Test triangle `j` (in BVH order). */
+    private intersect;
+}

package/dist/source/trace.js

@@ -0,0 +1,153 @@
+import { INTERSECTED, NOT_INTERSECTED } from "three-mesh-bvh";
+/**
+ * Casts rays at the source and finds the nearest hit the material keeps: the back of a
+ * single-sided surface and cut-out points are passed through, as three draws neither.
+ * One walk through the BVH, boxes nearest first and skipped once they start beyond the
+ * best hit so far, triangles tested inline (Möller–Trumbore); nothing is allocated per ray.
+ */
+export class Tracer {
+    source;
+    shading;
+    /** after `cast`, the triangle hit (in the source's index) and the hit's weights for its second and third corners */
+    triangle = -1;
+    w1 = 0;
+    w2 = 0;
+    ox = 0;
+    oy = 0;
+    oz = 0;
+    dx = 0;
+    dy = 0;
+    dz = 0;
+    /** 1 / direction, per axis */
+    ix = 0;
+    iy = 0;
+    iz = 0;
+    best = Infinity;
+    cutout = false;
+    facing = null;
+    callbacks;
+    constructor(source, shading) {
+        this.source = source;
+        this.shading = shading;
+        this.callbacks = {
+            boundsTraverseOrder: (box) => this.enter(box),
+            intersectsBounds: (_box, _isLeaf, score) => (score !== undefined && score <= this.best ? INTERSECTED : NOT_INTERSECTED),
+            intersectsRange: (offset, count) => {
+                for (let j = offset; j < offset + count; j++)
+                    this.intersect(j);
+                return false;
+            },
+        };
+    }
+    /**
+     * Cast from `origin` along unit `direction` up to `far`; `facing` decides which side of
+     * a surface is its front (null: both sides stop the ray). Returns "opaque" with `triangle`, `w1`, `w2` set; else
+     * "cutout" if it passed a cut-out point, else "back" (nothing kept).
+     */
+    cast(origin, direction, far, facing) {
+        this.ox = origin.x;
+        this.oy = origin.y;
+        this.oz = origin.z;
+        this.dx = direction.x;
+        this.dy = direction.y;
+        this.dz = direction.z;
+        this.ix = 1 / direction.x;
+        this.iy = 1 / direction.y;
+        this.iz = 1 / direction.z;
+        this.best = far;
+        this.triangle = -1;
+        this.cutout = false;
+        this.facing = facing;
+        this.source.bvh.shapecast(this.callbacks);
+        if (this.triangle >= 0)
+            return "opaque";
+        return this.cutout ? "cutout" : "back";
+    }
+    /** Distance along the ray to where it enters `box`; Infinity if it misses it before `best`. */
+    enter({ min, max }) {
+        let near = 0;
+        let far = this.best;
+        // Slab test per axis; along an axis the ray does not move, it is inside or misses.
+        if (this.dx === 0) {
+            if (this.ox < min.x || this.ox > max.x)
+                return Infinity;
+        }
+        else {
+            const a = (min.x - this.ox) * this.ix;
+            const b = (max.x - this.ox) * this.ix;
+            near = Math.max(near, Math.min(a, b));
+            far = Math.min(far, Math.max(a, b));
+        }
+        if (this.dy === 0) {
+            if (this.oy < min.y || this.oy > max.y)
+                return Infinity;
+        }
+        else {
+            const a = (min.y - this.oy) * this.iy;
+            const b = (max.y - this.oy) * this.iy;
+            near = Math.max(near, Math.min(a, b));
+            far = Math.min(far, Math.max(a, b));
+        }
+        if (this.dz === 0) {
+            if (this.oz < min.z || this.oz > max.z)
+                return Infinity;
+        }
+        else {
+            const a = (min.z - this.oz) * this.iz;
+            const b = (max.z - this.oz) * this.iz;
+            near = Math.max(near, Math.min(a, b));
+            far = Math.min(far, Math.max(a, b));
+        }
+        return near <= far ? near : Infinity;
+    }
+    /** Test triangle `j` (in BVH order). */
+    intersect(j) {
+        const c = this.source.corners;
+        const o = j * 9;
+        const ax = c[o] ?? 0;
+        const ay = c[o + 1] ?? 0;
+        const az = c[o + 2] ?? 0;
+        const e1x = c[o + 3] ?? 0;
+        const e1y = c[o + 4] ?? 0;
+        const e1z = c[o + 5] ?? 0;
+        const e2x = c[o + 6] ?? 0;
+        const e2y = c[o + 7] ?? 0;
+        const e2z = c[o + 8] ?? 0;
+        const { dx, dy, dz } = this;
+        const px = dy * e2z - dz * e2y;
+        const py = dz * e2x - dx * e2z;
+        const pz = dx * e2y - dy * e2x;
+        const det = e1x * px + e1y * py + e1z * pz;
+        if (det === 0)
+            return;
+        const inverse = 1 / det;
+        const sx = this.ox - ax;
+        const sy = this.oy - ay;
+        const sz = this.oz - az;
+        const u = (sx * px + sy * py + sz * pz) * inverse;
+        if (u < 0 || u > 1)
+            return;
+        const qx = sy * e1z - sz * e1y;
+        const qy = sz * e1x - sx * e1z;
+        const qz = sx * e1y - sy * e1x;
+        const v = (dx * qx + dy * qy + dz * qz) * inverse;
+        if (v < 0 || u + v > 1)
+            return;
+        const t = (e2x * qx + e2y * qy + e2z * qz) * inverse;
+        if (t < 0 || t >= this.best)
+            return;
+        const triangle = this.source.order[j];
+        if (triangle === undefined)
+            throw new Error("@drawcall/lod: ray state broken");
+        const hit = this.shading.test(triangle, u, v, this.facing);
+        if (hit === "cutout")
+            this.cutout = true;
+        if (hit !== "opaque")
+            return;
+        this.best = t;
+        this.triangle = triangle;
+        this.w1 = u;
+        this.w2 = v;
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/source/trace.js.map

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

package/dist/three.d.ts

@@ -0,0 +1,55 @@
+import { MeshStandardNodeMaterial, type BatchedMesh, type BufferAttribute, type Color, type InstancedMesh, type Material, type Mesh, type MeshPhysicalMaterial, type MeshStandardMaterial, type NodeMaterial, type Object3D, type Renderer, type Scene, type SkinnedMesh, type StorageInstancedBufferAttribute, type Texture } from "three/webgpu";
+import type { InstancedLod } from "./instanced/index.js";
+import type { ImpostorMesh } from "./impostor/mesh/index.js";
+import type { LazyImpostor } from "./lazy.js";
+export declare const isObject3D: (value: unknown) => value is Object3D;
+export declare const isMesh: (node: Object3D) => node is Mesh;
+export declare const isSkinnedMesh: (node: Object3D) => node is SkinnedMesh;
+export declare const isInstancedMesh: (node: Object3D) => node is InstancedMesh;
+export declare const isBatchedMesh: (node: Object3D) => node is BatchedMesh;
+export declare const isLight: (node: Object3D) => boolean;
+export declare const isScene: (node: Object3D) => node is Scene;
+export declare const isImpostorMesh: (node: Object3D) => node is ImpostorMesh;
+export declare const isLazyImpostor: (node: Object3D) => node is LazyImpostor;
+export declare const isInstancedLod: (node: Object3D) => node is InstancedLod;
+/** three's LOD and this package's Lod and InstancedLod. */
+export declare const isLOD: (node: Object3D) => node is Object3D & {
+    isLOD: true;
+    autoUpdate: boolean;
+    readonly levels: ReadonlyArray<{
+        readonly object: Object3D;
+    }>;
+};
+export declare const isStandard: (material: Material) => material is MeshStandardMaterial;
+export declare const isPhysical: (material: Material) => material is MeshPhysicalMaterial;
+export declare const isNodeMaterial: (material: Material) => material is NodeMaterial;
+export declare const isStandardNode: (material: Material) => material is MeshStandardNodeMaterial;
+export declare const isStorageInstanced: (attribute: BufferAttribute) => attribute is StorageInstancedBufferAttribute;
+/**
+ * A node material that renders like `material`: a clone when it is one, else the node
+ * material of its type with its values, as three converts it for WebGPU itself.
+ */
+export declare function toNodeMaterial(material: Material): NodeMaterial;
+export declare const isTexture: (value: unknown) => value is Texture;
+export declare const isColor: (value: unknown) => value is Color;
+/**
+ * `renderer` as the WebGPU renderer it is: three's typings give render callbacks a
+ * WebGLRenderer, which this package does not draw with.
+ */
+export declare function gpuRenderer(renderer: unknown): Renderer;
+/**
+ * Whether the scene `node` is in is being drawn into a shadow map: three's shadow pass
+ * 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 view chose.
+ */
+export declare function inShadowPass(node: Object3D): boolean;
+/** Whether `material` is the one three draws shadow maps with (a node material building for a shadow pass has it). */
+export declare const isShadowPass: (material: unknown) => boolean;
+/** The instance matrices of `object` when it keeps them in a storage buffer (an ImpostorMesh, or such an InstancedMesh); else null. */
+export declare function storageMatrices(object: Object3D): StorageInstancedBufferAttribute | null;
+/** Whether `value` is of exactly `like`'s class: a guard for clone() overrides. */
+export declare const sameClass: <T extends object>(like: T, value: object) => value is T;
+/** Throws if anything under `root` is skinned; `who` names the caller in the message. */
+export declare function rejectSkinned(root: Object3D, who: string): void;
+/** Give `level` the transform of `source`, and its shadows: cast or receive if any mesh of it does. */
+export declare function placeLike(level: Object3D, source: Object3D): void;

package/dist/three.js

@@ -0,0 +1,103 @@
+import { MeshBasicNodeMaterial, MeshLambertNodeMaterial, MeshMatcapNodeMaterial, MeshNormalNodeMaterial, MeshPhongNodeMaterial, MeshPhysicalNodeMaterial, MeshStandardNodeMaterial, MeshToonNodeMaterial, } from "three/webgpu";
+// Type guards on three's `isX` flags, which hold across copies of three (and of this
+// package, as in .glts scripts) where `instanceof` does not, and small checks on objects.
+const flag = (value, name) => typeof value === "object" && value !== null && Reflect.get(value, name) === true;
+export const isObject3D = (value) => flag(value, "isObject3D");
+export const isMesh = (node) => flag(node, "isMesh");
+export const isSkinnedMesh = (node) => flag(node, "isSkinnedMesh");
+export const isInstancedMesh = (node) => flag(node, "isInstancedMesh");
+export const isBatchedMesh = (node) => flag(node, "isBatchedMesh");
+export const isLight = (node) => flag(node, "isLight");
+export const isScene = (node) => flag(node, "isScene");
+export const isImpostorMesh = (node) => flag(node, "isImpostorMesh");
+export const isLazyImpostor = (node) => flag(node, "isLazyImpostor");
+export const isInstancedLod = (node) => flag(node, "isInstancedLod");
+/** three's LOD and this package's Lod and InstancedLod. */
+export const isLOD = (node) => flag(node, "isLOD");
+export const isStandard = (material) => flag(material, "isMeshStandardMaterial");
+export const isPhysical = (material) => flag(material, "isMeshPhysicalMaterial");
+export const isNodeMaterial = (material) => flag(material, "isNodeMaterial");
+export const isStandardNode = (material) => flag(material, "isMeshStandardNodeMaterial");
+export const isStorageInstanced = (attribute) => flag(attribute, "isStorageInstancedBufferAttribute");
+/** The node material each built-in mesh material draws as with WebGPU. */
+const NODE_MATERIALS = {
+    MeshBasicMaterial: MeshBasicNodeMaterial,
+    MeshLambertMaterial: MeshLambertNodeMaterial,
+    MeshPhongMaterial: MeshPhongNodeMaterial,
+    MeshStandardMaterial: MeshStandardNodeMaterial,
+    MeshPhysicalMaterial: MeshPhysicalNodeMaterial,
+    MeshToonMaterial: MeshToonNodeMaterial,
+    MeshMatcapMaterial: MeshMatcapNodeMaterial,
+    MeshNormalMaterial: MeshNormalNodeMaterial,
+};
+/**
+ * A node material that renders like `material`: a clone when it is one, else the node
+ * material of its type with its values, as three converts it for WebGPU itself.
+ */
+export function toNodeMaterial(material) {
+    if (isNodeMaterial(material)) {
+        const copy = material.clone();
+        // three's NodeMaterial.copy skips accessors of Material itself, alphaTest among them.
+        copy.alphaTest = material.alphaTest;
+        return copy;
+    }
+    const Type = NODE_MATERIALS[material.type];
+    if (!Type)
+        throw new Error(`@drawcall/lod: ${material.type} has no node material to draw with WebGPU`);
+    // Every own value but the source's identity and its event listeners.
+    const values = Object.fromEntries(Object.entries(material).filter(([key]) => key !== "uuid" && key !== "_listeners"));
+    return Object.assign(new Type(), values);
+}
+export const isTexture = (value) => flag(value, "isTexture");
+export const isColor = (value) => flag(value, "isColor");
+/**
+ * `renderer` as the WebGPU renderer it is: three's typings give render callbacks a
+ * WebGLRenderer, which this package does not draw with.
+ */
+export function gpuRenderer(renderer) {
+    if (!isRenderer(renderer))
+        throw new Error("@drawcall/lod: draws with three's WebGPURenderer only");
+    return renderer;
+}
+const isRenderer = (value) => flag(value, "isRenderer");
+/**
+ * Whether the scene `node` is in is being drawn into a shadow map: three's shadow pass
+ * 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 view chose.
+ */
+export function inShadowPass(node) {
+    let root = node;
+    while (root.parent)
+        root = root.parent;
+    return "overrideMaterial" in root && isShadowPass(root.overrideMaterial);
+}
+/** Whether `material` is the one three draws shadow maps with (a node material building for a shadow pass has it). */
+export const isShadowPass = (material) => flag(material, "isShadowPassMaterial");
+/** The instance matrices of `object` when it keeps them in a storage buffer (an ImpostorMesh, or such an InstancedMesh); else null. */
+export function storageMatrices(object) {
+    if (isImpostorMesh(object))
+        return object.instanceMatrix;
+    return isInstancedMesh(object) && isStorageInstanced(object.instanceMatrix) ? object.instanceMatrix : null;
+}
+/** Whether `value` is of exactly `like`'s class: a guard for clone() overrides. */
+export const sameClass = (like, value) => Object.getPrototypeOf(value) === Object.getPrototypeOf(like);
+/** Throws if anything under `root` is skinned; `who` names the caller in the message. */
+export function rejectSkinned(root, who) {
+    root.traverse((node) => {
+        if (isSkinnedMesh(node))
+            throw new Error(`${who}: skinned meshes are not supported ("${node.name}")`);
+    });
+}
+/** Give `level` the transform of `source`, and its shadows: cast or receive if any mesh of it does. */
+export function placeLike(level, source) {
+    level.position.copy(source.position);
+    level.quaternion.copy(source.quaternion);
+    level.scale.copy(source.scale);
+    source.traverse((node) => {
+        if (!isMesh(node))
+            return;
+        level.castShadow ||= node.castShadow;
+        level.receiveShadow ||= node.receiveShadow;
+    });
+}
+//# sourceMappingURL=three.js.map

package/dist/three.js.map

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

package/dist/tsl.d.ts

@@ -0,0 +1,45 @@
+import type { BufferAttribute, ContextNode, Node, NodeBuilder, StorageBufferNode } from "three/webgpu";
+/** Column `i` (0..3) of `m`. */
+export declare const column: (m: Node<"mat4">, i: 0 | 1 | 2 | 3) => Node<"vec4">;
+/** The largest scale `m` applies along an axis. */
+export declare const maxScale: (m: Node<"mat4">) => Node<"float">;
+/** Whether projection `m` is orthographic: its bottom-right element is 1. */
+export declare const isOrthographic: (m: Node<"mat4">) => Node<"bool">;
+/** An affine matrix `m` and the inverse of its linear part, as cofactor columns over the determinant. */
+export interface Affine {
+    /** `m`'s linear part applied to direction `v` */
+    apply(v: Node<"vec3">): Node<"vec3">;
+    /** the inverse of the linear part applied to direction `v` */
+    solve(v: Node<"vec3">): Node<"vec3">;
+    /** point `p` through the inverse of `m`: into the space `m` maps from */
+    unproject(p: Node<"vec3">): Node<"vec3">;
+    /** the inverse transpose applied to `v`: how normals transform */
+    normal(v: Node<"vec3">): Node<"vec3">;
+    /** the columns of the inverse transpose */
+    normalColumns: [Node<"vec3">, Node<"vec3">, Node<"vec3">];
+}
+export declare function affine(m: Node<"mat4">): Affine;
+/** The node at `path` in the context `builder` builds with, which three's typings leave open. */
+export declare function contextNode(builder: NodeBuilder, ...path: string[]): Node;
+/**
+ * An object that stays the same throughout one build of a shader, to cache per build
+ * what several of a material's slots read. Each slot is handed its own proxy of the
+ * builder, and three's typings expose no handle of the build itself: this is what the
+ * build keeps for `anchor`.
+ */
+export declare function buildKey(builder: NodeBuilder, anchor: Node): object;
+/**
+ * Whether `node` builds to a `type` value, which three's typings leave open for a
+ * material's slots. Checked while a shader builds, so a slot of another type fails there.
+ */
+export declare function isNodeOf<T extends "bool" | "float" | "vec3" | "vec4" | "color">(node: Node, type: T, builder: NodeBuilder): node is Node<T>;
+export declare const instanceFades: (attribute: BufferAttribute) => StorageBufferNode<"float">;
+export declare const instanceColors: (attribute: BufferAttribute) => StorageBufferNode<"vec4">;
+export declare const instanceMatrices: (attribute: BufferAttribute) => StorageBufferNode<"mat4">;
+export declare const roomBounds: (attribute: BufferAttribute) => StorageBufferNode<"vec4">;
+/**
+ * A context in which every texture read is `bias` mip levels above the level the
+ * hardware would pick: the level from the read's own texel footprint, plus `bias`. Reads
+ * with uv of their own making, or with an explicit level or gradients, keep theirs.
+ */
+export declare function biasedTextures(bias: Node<"float">): ContextNode<unknown>;