@drawcall/lod 0.0.0-stage → 0.1.0

package/dist/impostor/bake/materials.js

@@ -0,0 +1,156 @@
+import { DoubleSide, MeshStandardNodeMaterial, NoBlending } from "three/webgpu";
+import { ambientOcclusion, cameraViewMatrix, Fn, clamp, diffuseColor, emissive, faceDirection, float, materialMetalness, materialOpacity, materialRoughness, max, mrt, normalView, normalize, positionView, specularColor, specularF90, step, vec4, } from "three/tsl";
+import { isMesh, isNodeMaterial, isPhysical, isStandard, isStandardNode, toNodeMaterial } from "../../three.js";
+import { affine, biasedTextures, isNodeOf } from "../../tsl.js";
+import { originalOf } from "../../material.js";
+/**
+ * The outputs a bake material writes, by name: one per atlas map, then the second way to
+ * store the normals (see Atlas) and the specular. A render target takes the ones it has
+ * textures of that name for, so every material writes them all and the bake decides,
+ * once it knows every material, which it keeps.
+ */
+export const OUTPUTS = ["base", "normalDepth", "orm", "emissive", "turned", "specular"];
+/**
+ * Replace the materials of every visible mesh under `root` with bake materials, which
+ * write the surface values unlit into the atlas maps. Returns the bake materials (to
+ * dispose), whether any of them emits light and whether any changes three's default specular.
+ */
+export function swapMaterials(root, settings) {
+    const baked = new Map();
+    const plain = new Set();
+    root.traverseVisible((node) => {
+        // Lines, points and sprites would write their colour into the data targets. Layers
+        // rather than `visible`, which would also hide any mesh children.
+        if ("isLine" in node || "isPoints" in node || "isSprite" in node)
+            return node.layers.disableAll();
+        if (!isMesh(node))
+            return;
+        const swap = (material) => {
+            // A deferred bake may see a source already hooked by Lod or Wind. Bake its
+            // authored surface at rest, without the runtime fade/tint/sway wrappers.
+            const source = originalOf(material);
+            let entry = baked.get(source);
+            if (!entry) {
+                entry = bakeMaterial(source, settings);
+                baked.set(source, entry);
+                if (!isStandard(source) && !isNodeMaterial(source) && !MAPPED.has(source.type))
+                    plain.add(source.type);
+            }
+            return entry.material;
+        };
+        node.material = Array.isArray(node.material) ? node.material.map(swap) : swap(node.material);
+    });
+    if (plain.size > 0)
+        console.warn(`bakeImpostor: ${[...plain].join(", ")} bake as a plain rough MeshStandardMaterial with their color/map only`);
+    const entries = [...baked.values()];
+    return { materials: entries.map((e) => e.material), emits: entries.some((e) => e.emits), specular: entries.some((e) => e.specular) };
+}
+const STANDARD_KEYS = [
+    "color",
+    "map",
+    "alphaMap",
+    "alphaTest",
+    "alphaHash",
+    "alphaToCoverage",
+    "side",
+    "vertexColors",
+    "opacity",
+    "transparent",
+    "normalMap",
+    "normalMapType",
+    "normalScale",
+    "bumpMap",
+    "bumpScale",
+    "aoMap",
+    "aoMapIntensity",
+    "emissive",
+    "emissiveMap",
+    "emissiveIntensity",
+    "flatShading",
+    "displacementMap",
+    "displacementScale",
+    "displacementBias",
+    "wireframe",
+];
+/** Built-in materials whose look the standard keys carry over; others only keep their color/map. */
+const MAPPED = new Set(["MeshBasicMaterial", "MeshLambertMaterial", "MeshPhongMaterial", "MeshToonMaterial", "MeshMatcapMaterial"]);
+/** A node material that renders like `source`: a copy of a node or standard one, else the standard keys carried over. */
+function toStandard(source) {
+    if (isNodeMaterial(source) || isStandard(source))
+        return toNodeMaterial(source);
+    // Unlit and Lambert/Phong materials bake as a fully rough dielectric. Their settings
+    // are read by name: they are whatever subclass the app used.
+    const values = Object.fromEntries(STANDARD_KEYS.flatMap((k) => (Reflect.get(source, k) === undefined ? [] : [[k, Reflect.get(source, k)]])));
+    return new MeshStandardNodeMaterial({ roughness: 1, metalness: 0, ...values });
+}
+/** A material's float slot (or its default), as the float it builds to. */
+const scalar = (node, builder) => {
+    if (!isNodeOf(node, "float", builder))
+        throw new Error(`bakeImpostor: a material's float slot builds to ${node.getNodeType(builder)}`);
+    return node;
+};
+function bakeMaterial(source, settings) {
+    const material = toStandard(source);
+    // A material that draws no colour has no surface to bake.
+    material.visible = source.visible && source.colorWrite;
+    const emits = material.visible && emitsLight(material);
+    const specular = material.visible && changesSpecular(source);
+    // Coverage is the material's alpha where it cuts the surface out: alpha-to-coverage (no
+    // multisampling here, so it would cover the card), or a blended material's texture
+    // alpha. A blended material's uniform opacity (glass) is no hole: it folds into the
+    // colour, as if the pane were dark and opaque, which keeps its reflection.
+    const blended = material.transparent;
+    const coverage = blended ? diffuseColor.a.div(max(materialOpacity, 1e-4)) : material.alphaToCoverage ? diffuseColor.a : float(1);
+    const opacity = blended ? materialOpacity : float(1);
+    // Blending would mix the outputs with the cleared background; coverage carries alpha
+    // instead. Without normal blending three also keeps the alpha (not opaque).
+    material.transparent = false;
+    material.blending = NoBlending;
+    material.depthWrite = true;
+    material.contextNode = biasedTextures(settings.textureBias);
+    // Two ways to store the normals three shades with, each a normal and the share of the
+    // surface that shades with it rather than its opposite; the bake keeps the one whose
+    // normals agree more once averaged (see Atlas):
+    // - the surface's own normal and the share whose front faced the camera (on two-sided
+    //   surfaces three turns the normal toward the camera; this undoes it). Painted canopy
+    //   normals of cut-out foliage agree this way, which three turns inward on every leaf
+    //   seen from behind.
+    // - the shading normal turned toward the camera and the share that faced it already.
+    //   Real leaf normals agree this way, which three turns toward the camera on every leaf.
+    // The camera is orthographic, looking along -z; the object sits at the origin, so world
+    // space is its own.
+    const twoSided = material.side === DoubleSide && !(isStandardNode(material) && material.flatShading);
+    const own = twoSided ? normalView.mul(faceDirection) : normalView;
+    const front = twoSided ? faceDirection.mul(0.5).add(0.5) : float(1);
+    const facing = step(0, normalView.z);
+    const toObject = (n) => normalize(affine(cameraViewMatrix).solve(n)).mul(0.5).add(0.5);
+    const depth = clamp(positionView.z.add(settings.distance).div(settings.radius).mul(0.5).add(0.5), 0, 1);
+    // Unlit values: the material's own roughness and metalness, not three's lighting ones.
+    const roughness = (isStandardNode(material) && material.roughnessNode) || materialRoughness;
+    const metalness = (isStandardNode(material) && material.metalnessNode) || materialMetalness;
+    const outputs = {
+        base: vec4(clamp(diffuseColor.rgb.mul(opacity), 0, 1), clamp(coverage, 0, 1)),
+        normalDepth: vec4(toObject(own), depth),
+        orm: Fn((builder) => vec4(ambientOcclusion, scalar(roughness, builder), scalar(metalness, builder), front))(),
+        emissive: vec4(clamp(emissive, 0, 1), 1),
+        turned: vec4(toObject(normalView.mul(facing.mul(2).sub(1))), facing),
+        specular: vec4(specularColor, specularF90),
+    };
+    material.mrtNode = mrt(outputs);
+    return { material, emits, specular };
+}
+/** Whether `material` emits light: an emissive node, colour × intensity, or map. */
+function emitsLight(material) {
+    if (!isStandardNode(material))
+        return false;
+    const { emissive: e, emissiveIntensity, emissiveMap, emissiveNode } = material;
+    return emissiveNode !== null || (e.r + e.g + e.b) * emissiveIntensity > 0 || emissiveMap !== null;
+}
+/** Whether `material` lights with other than three's dielectric F0 0.04 and F90 1 (KHR_materials_specular). */
+function changesSpecular(material) {
+    if (!isPhysical(material))
+        return false;
+    const { ior, specularIntensity, specularColor: c, specularIntensityMap, specularColorMap } = material;
+    return ior !== 1.5 || specularIntensity !== 1 || c.r !== 1 || c.g !== 1 || c.b !== 1 || specularIntensityMap !== null || specularColorMap !== null;
+}
+//# sourceMappingURL=materials.js.map

package/dist/impostor/bake/materials.js.map

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

package/dist/impostor/bake/source.d.ts

@@ -0,0 +1,3 @@
+import type { Object3D } from "three/webgpu";
+/** Snapshot before validation/bounds, without copying loader-added rooms or their resources. */
+export declare function sourceForBake(object: Object3D, excluded?: readonly Object3D[]): Object3D;

package/dist/impostor/bake/source.js

@@ -0,0 +1,23 @@
+import { clone } from "three/addons/utils/SkeletonUtils.js";
+import { forEachMesh } from "../../bounds.js";
+import { isImpostorMesh } from "../../three.js";
+/** Snapshot before validation/bounds, without copying loader-added rooms or their resources. */
+export function sourceForBake(object, excluded = []) {
+    const children = object.children;
+    try {
+        // SkeletonUtils has no exclusion hook. This synchronous view emits no events and
+        // is restored before any await, even if validation or a custom clone throws.
+        // Cloning then removing rooms would allocate excluded nested LOD resources.
+        if (excluded.length > 0)
+            object.children = children.filter((child) => !excluded.includes(child));
+        forEachMesh(object, (mesh) => {
+            if (isImpostorMesh(mesh))
+                throw new Error(`bakeImpostor: cannot bake an ImpostorMesh ("${mesh.name}"); bake from its source instead`);
+        });
+        return clone(object);
+    }
+    finally {
+        object.children = children;
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/impostor/bake/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/impostor/bake/source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,MAAgB,EAAE,WAAgC,EAAE;IAChF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,CAAC;QACH,iFAAiF;QACjF,6EAA6E;QAC7E,4EAA4E;QAC5E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACjG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,IAAI,cAAc,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;QACxI,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/impostor/cache.d.ts

@@ -0,0 +1,15 @@
+import type { Object3D } from "three/webgpu";
+import { type CacheEntryOptions, type Dependencies } from "vitecache";
+import { type BakeImpostorOptions } from "./bake/index.js";
+import type { Impostor } from "./impostor.js";
+/** Cache location; browser basePath and Node root follow vitecache's conventions. */
+export type ImpostorCacheOptions = Pick<CacheEntryOptions, "basePath" | "root">;
+/**
+ * Read or bake an impostor with vitecache. Declare every source input as a dependency;
+ * bake options and the lod/three package versions are added automatically. Dependency
+ * names beginning with `lod:` are reserved. URL dependencies need the vitecache Vite
+ * plugin during development and build. Cache errors reject instead of hiding stale data.
+ */
+export declare function cachedImpostor(source: Object3D, options: BakeImpostorOptions, dependencies: Dependencies, cacheOptions?: ImpostorCacheOptions): Promise<Impostor>;
+/** Shared persistence for the public bake and the loader's source-excluding bake. */
+export declare function cached(options: BakeImpostorOptions, dependencies: Dependencies, make: (options: BakeImpostorOptions) => Promise<Impostor>, cacheOptions?: ImpostorCacheOptions): Promise<Impostor>;

package/dist/impostor/cache.js

@@ -0,0 +1,44 @@
+import { CacheEntry } from "vitecache";
+import { bakeImpostor } from "./bake/index.js";
+import { decodeImpostorAsync, encodeImpostor } from "./codec.js";
+/**
+ * Read or bake an impostor with vitecache. Declare every source input as a dependency;
+ * bake options and the lod/three package versions are added automatically. Dependency
+ * names beginning with `lod:` are reserved. URL dependencies need the vitecache Vite
+ * plugin during development and build. Cache errors reject instead of hiding stale data.
+ */
+export function cachedImpostor(source, options, dependencies, cacheOptions) {
+    return cached(options, dependencies, (settings) => bakeImpostor(source, settings), cacheOptions);
+}
+/** Shared persistence for the public bake and the loader's source-excluding bake. */
+export async function cached(options, dependencies, make, cacheOptions) {
+    const settings = { ...options };
+    if (Object.keys(dependencies).some((name) => name.startsWith("lod:")))
+        throw new Error("cachedImpostor: dependency names beginning with lod: are reserved");
+    const entry = new CacheEntry({
+        ...cacheOptions,
+        version: "lod-impostor@1",
+        dependencies: {
+            ...dependencies,
+            "lod:options": {
+                value: {
+                    layout: settings.layout ?? null,
+                    frames: settings.frames ?? null,
+                    resolution: settings.resolution ?? null,
+                    maxPixels: settings.maxPixels ?? null,
+                    emissive: settings.emissive ?? null,
+                    supersample: settings.supersample ?? null,
+                },
+            },
+            "lod:package": { package: "@drawcall/lod" },
+            "lod:three": { package: "three" },
+        },
+    });
+    const bytes = await entry.load();
+    if (bytes !== undefined)
+        return decodeImpostorAsync(bytes);
+    const baked = await make(settings);
+    await entry.save(encodeImpostor(baked));
+    return baked;
+}
+//# sourceMappingURL=cache.js.map

package/dist/impostor/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/impostor/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAA6C,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAgB,EAChB,OAA4B,EAC5B,YAA0B,EAC1B,YAAmC;IAEnC,OAAO,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;AACnG,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAA4B,EAC5B,YAA0B,EAC1B,IAAyD,EACzD,YAAmC;IAEnC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC5J,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC;QAC3B,GAAG,YAAY;QACf,OAAO,EAAE,gBAAgB;QACzB,YAAY,EAAE;YACZ,GAAG,YAAY;YACf,aAAa,EAAE;gBACb,KAAK,EAAE;oBACL,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI;oBAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI;oBAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,IAAI;oBACvC,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;oBACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;oBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;iBAC1C;aACF;YACD,aAAa,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE;YAC3C,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;SAClC;KACF,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/impostor/codec.d.ts

@@ -0,0 +1,14 @@
+import { type Impostor } from "./impostor.js";
+/**
+ * Serializes `impostor` to a KTX2 file: one RGBA8 UNORM 2D array texture with a layer per
+ * map and its baked mip levels, zlib-supercompressed, plus the metadata as JSON under the
+ * "impostor" key.
+ */
+export declare function encodeImpostor(impostor: Impostor): Uint8Array;
+type Input = Uint8Array | ArrayBuffer | string;
+/** Parses a file written by `encodeImpostor`, given as bytes or base64. */
+export declare function decodeImpostor(input: Input): Impostor;
+/** Inflate cache files asynchronously with the runtime's native zlib decoder. */
+export declare function decodeImpostorAsync(input: Input): Promise<Impostor>;
+export declare function fromBase64(text: string): Uint8Array;
+export {};

package/dist/impostor/codec.js

@@ -0,0 +1,137 @@
+import { unzlibSync, zlibSync } from "fflate";
+import { KHR_DF_CHANNEL_RGBSDA_ALPHA, KHR_DF_CHANNEL_RGBSDA_BLUE, KHR_DF_CHANNEL_RGBSDA_GREEN, KHR_DF_CHANNEL_RGBSDA_RED, KHR_DF_MODEL_RGBSDA, KHR_DF_TRANSFER_LINEAR, KHR_SUPERCOMPRESSION_ZLIB, VK_FORMAT_R8G8B8A8_UNORM, createDefaultContainer, read, write, } from "ktx-parse";
+import { validateImpostor } from "./impostor.js";
+/** Key/value entry holding every non-pixel field as JSON. */
+const KEY = "impostor";
+/**
+ * Serializes `impostor` to a KTX2 file: one RGBA8 UNORM 2D array texture with a layer per
+ * map and its baked mip levels, zlib-supercompressed, plus the metadata as JSON under the
+ * "impostor" key.
+ */
+export function encodeImpostor(impostor) {
+    validateImpostor(impostor);
+    const { layers, ...meta } = impostor;
+    const levelCount = layers[0]?.length ?? 0;
+    // KTX2 stores each mip level with all its array layers, layer-major.
+    const levels = Array.from({ length: levelCount }, (_, m) => {
+        const bytes = (meta.size >> m) ** 2 * 4;
+        const raw = new Uint8Array(layers.length * bytes);
+        layers.forEach((layer, i) => raw.set(layer[m] ?? fail(`layer ${i} has no level ${m}`), i * bytes));
+        return { levelData: zlibSync(raw, { level: 6 }), uncompressedByteLength: raw.length };
+    });
+    const ktx = createDefaultContainer();
+    ktx.vkFormat = VK_FORMAT_R8G8B8A8_UNORM;
+    ktx.typeSize = 1;
+    ktx.pixelWidth = meta.size;
+    ktx.pixelHeight = meta.size;
+    ktx.layerCount = layers.length;
+    ktx.levelCount = levels.length;
+    ktx.supercompressionScheme = KHR_SUPERCOMPRESSION_ZLIB;
+    ktx.levels = levels;
+    // UNORM data must declare a linear transfer; base/emissive are sRGB-encoded but the
+    // renderer decodes them itself, as it does with the linear normal/orm layers.
+    const channels = [KHR_DF_CHANNEL_RGBSDA_RED, KHR_DF_CHANNEL_RGBSDA_GREEN, KHR_DF_CHANNEL_RGBSDA_BLUE, KHR_DF_CHANNEL_RGBSDA_ALPHA];
+    for (const dfd of ktx.dataFormatDescriptor) {
+        dfd.colorModel = KHR_DF_MODEL_RGBSDA;
+        dfd.transferFunction = KHR_DF_TRANSFER_LINEAR;
+        dfd.bytesPlane = [4, 0, 0, 0, 0, 0, 0, 0];
+        dfd.samples = channels.map((channelType, i) => ({
+            bitOffset: i * 8,
+            bitLength: 7, // stored as bits - 1
+            channelType,
+            samplePosition: [0, 0, 0, 0],
+            sampleLower: 0,
+            sampleUpper: 255,
+        }));
+    }
+    ktx.keyValue[KEY] = JSON.stringify(meta);
+    return write(ktx);
+}
+/** Parses a file written by `encodeImpostor`, given as bytes or base64. */
+export function decodeImpostor(input) {
+    const file = parse(input);
+    const levels = file.levels.map(({ data, length }, m) => attempt(`level ${m} does not inflate`, () => unzlibSync(data, { out: new Uint8Array(length) })));
+    return decoded(file, levels);
+}
+/** Inflate cache files asynchronously with the runtime's native zlib decoder. */
+export async function decodeImpostorAsync(input) {
+    if (typeof DecompressionStream === "undefined")
+        return decodeImpostor(input);
+    const file = parse(input);
+    const levels = await Promise.all(file.levels.map(async ({ data }, m) => {
+        try {
+            const stream = new Blob([data.slice()]).stream().pipeThrough(new DecompressionStream("deflate"));
+            return new Uint8Array(await new Response(stream).arrayBuffer());
+        }
+        catch (error) {
+            throw invalid(`level ${m} does not inflate`, error);
+        }
+    }));
+    return decoded(file, levels);
+}
+function parse(input) {
+    const bytes = typeof input === "string" ? attempt("not base64", () => fromBase64(input)) : input instanceof Uint8Array ? input : new Uint8Array(input);
+    // ktx-parse reads through `bytes.buffer` without checking the view's end, so a truncated
+    // view would read past it; give it a buffer of exactly the file instead.
+    const file = bytes.byteLength === bytes.buffer.byteLength ? bytes : bytes.slice();
+    const ktx = attempt("not a KTX2 container", () => read(file));
+    if (ktx.vkFormat !== VK_FORMAT_R8G8B8A8_UNORM)
+        fail(`vkFormat ${ktx.vkFormat} is not R8G8B8A8_UNORM`);
+    if (ktx.supercompressionScheme !== KHR_SUPERCOMPRESSION_ZLIB)
+        fail(`supercompression ${ktx.supercompressionScheme} is not zlib`);
+    if (ktx.pixelWidth !== ktx.pixelHeight)
+        fail(`atlas is ${ktx.pixelWidth}x${ktx.pixelHeight}, not square`);
+    const json = ktx.keyValue[KEY];
+    if (!(json instanceof Uint8Array))
+        fail(`missing "${KEY}" metadata`);
+    // ktx-parse returns values of keys not starting with "KTX" as raw bytes, NUL included.
+    const meta = attempt("metadata is not JSON", () => JSON.parse(new TextDecoder().decode(json).replace(/\0$/, "")));
+    if (typeof meta !== "object" || meta === null)
+        fail("metadata is not an object");
+    const levels = ktx.levels.map((level, m) => {
+        const bytes = (ktx.pixelWidth >> m) ** 2 * 4;
+        if (level.uncompressedByteLength !== bytes * ktx.layerCount)
+            fail(`level ${m} size does not match the atlas`);
+        return { data: level.levelData, length: level.uncompressedByteLength };
+    });
+    return { meta, layerCount: ktx.layerCount, levels };
+}
+function decoded(file, levels) {
+    levels.forEach((raw, m) => {
+        if (raw.length !== file.levels[m]?.length)
+            fail(`level ${m} inflates to the wrong size`);
+    });
+    // Layers share one inflated buffer per mip, in KTX2's layer-major order.
+    const layers = Array.from({ length: file.layerCount }, (_, i) => levels.map((raw) => raw.subarray((i * raw.length) / file.layerCount, ((i + 1) * raw.length) / file.layerCount)));
+    const impostor = { ...file.meta, layers };
+    validateImpostor(impostor);
+    return impostor;
+}
+function fail(why) {
+    throw new Error(`Invalid impostor file: ${why}`);
+}
+/** Runs `run`, turning any throw into an "Invalid impostor file" error. */
+function attempt(why, run) {
+    try {
+        return run();
+    }
+    catch (error) {
+        throw invalid(why, error);
+    }
+}
+function invalid(why, error) {
+    return new Error(`Invalid impostor file: ${why} (${error instanceof Error ? error.message : String(error)})`, { cause: error });
+}
+export function fromBase64(text) {
+    // Native where available (Node 25+, current browsers); the fallback covers the rest.
+    const native = Reflect.get(Uint8Array, "fromBase64");
+    const decoded = typeof native === "function" ? Reflect.apply(native, Uint8Array, [text]) : undefined;
+    if (decoded instanceof Uint8Array)
+        return decoded;
+    const binary = atob(text);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+//# sourceMappingURL=codec.js.map

package/dist/impostor/codec.js.map

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

package/dist/impostor/impostor.d.ts

@@ -0,0 +1,67 @@
+/** Which part of the view sphere the atlas covers. */
+export type ImpostorLayout = "hemi" | "full";
+/**
+ * The atlas maps, in the order they are stored. Each is one RGBA8 layer:
+ *
+ * - `base`: base colour (sRGB) in RGB, coverage in A.
+ * - `normalDepth`: an object-space normal n in RGB (`n * 0.5 + 0.5`), depth in A. The
+ *   surface shades with n on the share of it in orm.a and with -n on the rest; the
+ *   length of n is how far the normals it averages agree (1: all one way).
+ * - `orm`: occlusion, roughness, metalness in RGB (glTF / three order), and in A the
+ *   share of the surface that shades with n.
+ * - `emissive`: emissive colour (sRGB) in RGB, A unused. Only when something emits.
+ */
+export declare const MAPS: readonly ["base", "normalDepth", "orm", "emissive"];
+export type ImpostorMap = (typeof MAPS)[number];
+/**
+ * A baked octahedral impostor: plain data, no GPU resources.
+ *
+ * The atlas is `frames x frames` cells of `size / frames` pixels each. Cell (col, row)
+ * holds the view from `frameDirection(layout, frames, col, row)` and starts at pixel
+ * `(col * cell, row * cell)`; row 0 is the first row in memory, which is the bottom row
+ * of the texture (three's DataTexture convention).
+ *
+ * Depth is `0.5 + 0.5 * dot(p - centre, viewDirection) / boundingRadius(box)`, so 1 is
+ * toward the camera that baked the frame and 0 is away from it.
+ */
+export interface Impostor {
+    version: 3;
+    layout: ImpostorLayout;
+    /** frames per atlas side */
+    frames: number;
+    /** atlas edge in pixels: `frames` times a power of two */
+    size: number;
+    /** bounding box of the source in its own space: min xyz, max xyz */
+    box: [number, number, number, number, number, number];
+    /** half the edge of every frame's orthographic view, in source units, centred on the box centre */
+    halfSize: number;
+    /** `base`, `normalDepth`, `orm`, then `emissive` if it was baked */
+    maps: ImpostorMap[];
+    /**
+     * The dielectric specular three lights the surface with, F0 (linear RGB) then F90,
+     * averaged over the whole object as the frames show it. Only when a material changes
+     * it from three's 0.04 and 1 (a MeshPhysicalMaterial's ior, specularIntensity,
+     * specularColor or their maps).
+     */
+    specular?: [number, number, number, number];
+    /**
+     * One per entry in `maps`: its mip chain of RGBA8 arrays, `size >> level` square, from
+     * `size` down to one texel per frame (`frames` square). The levels are baked, not
+     * filtered from level 0. An ImpostorMesh's textures share these arrays, so they stay in
+     * memory while the impostor is referenced, ready for `encodeImpostor`.
+     */
+    layers: Uint8Array[][];
+}
+export declare function boxCentre(b: Impostor["box"]): [number, number, number];
+/** Half the box's edges. */
+export declare function boxExtent(b: Impostor["box"]): [number, number, number];
+/** Radius of the sphere around the box: the depth channel's unit. */
+export declare function boundingRadius(b: Impostor["box"]): number;
+/**
+ * On-screen height of the object at which two atlas texels span one pixel: the default
+ * `LodLevel.maxPixels` of an impostor. An impostor blends filtered reads of several
+ * views, so it keeps the source's colour detail only down to about two texels per pixel.
+ */
+export declare function texelPixels(impostor: Pick<Impostor, "size" | "frames" | "box" | "halfSize">): number;
+/** Throws unless `value` is a usable impostor. */
+export declare function validateImpostor(value: unknown): asserts value is Impostor;

package/dist/impostor/impostor.js

@@ -0,0 +1,79 @@
+/**
+ * The atlas maps, in the order they are stored. Each is one RGBA8 layer:
+ *
+ * - `base`: base colour (sRGB) in RGB, coverage in A.
+ * - `normalDepth`: an object-space normal n in RGB (`n * 0.5 + 0.5`), depth in A. The
+ *   surface shades with n on the share of it in orm.a and with -n on the rest; the
+ *   length of n is how far the normals it averages agree (1: all one way).
+ * - `orm`: occlusion, roughness, metalness in RGB (glTF / three order), and in A the
+ *   share of the surface that shades with n.
+ * - `emissive`: emissive colour (sRGB) in RGB, A unused. Only when something emits.
+ */
+export const MAPS = ["base", "normalDepth", "orm", "emissive"];
+export function boxCentre(b) {
+    return [(b[0] + b[3]) / 2, (b[1] + b[4]) / 2, (b[2] + b[5]) / 2];
+}
+/** Half the box's edges. */
+export function boxExtent(b) {
+    return [(b[3] - b[0]) / 2, (b[4] - b[1]) / 2, (b[5] - b[2]) / 2];
+}
+/** Radius of the sphere around the box: the depth channel's unit. */
+export function boundingRadius(b) {
+    return Math.hypot(b[3] - b[0], b[4] - b[1], b[5] - b[2]) / 2;
+}
+/**
+ * On-screen height of the object at which two atlas texels span one pixel: the default
+ * `LodLevel.maxPixels` of an impostor. An impostor blends filtered reads of several
+ * views, so it keeps the source's colour detail only down to about two texels per pixel.
+ */
+export function texelPixels(impostor) {
+    const cell = impostor.size / impostor.frames;
+    // A frame spans 2 × halfSize of the object; the height measured is its bounding diameter.
+    return (cell * boundingRadius(impostor.box)) / (2 * impostor.halfSize);
+}
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
+const isBox = (v) => Array.isArray(v) && v.length === 6 && v.every(isNumber);
+/** Throws unless `value` is a usable impostor. */
+export function validateImpostor(value) {
+    function fail(why) {
+        throw new Error(`Invalid impostor: ${why}`);
+    }
+    if (typeof value !== "object" || value === null)
+        fail("not an object");
+    const fields = value;
+    const { version, layout, frames, size, box, halfSize, maps, specular, layers } = fields;
+    if (version !== 3)
+        fail(`unsupported version ${String(version)}; bake it again`);
+    if (layout !== "hemi" && layout !== "full")
+        fail(`unknown layout "${String(layout)}"`);
+    if (!isNumber(frames) || !Number.isInteger(frames) || frames < 2)
+        fail("frames must be an integer >= 2");
+    if (!isNumber(size) || !Number.isInteger(size) || size <= 0 || size % frames !== 0)
+        fail(`size ${String(size)} is not a positive multiple of frames ${frames}`);
+    if (!isBox(box))
+        fail("box must be 6 finite numbers");
+    if (box[0] > box[3] || box[1] > box[4] || box[2] > box[5])
+        fail("box min must not exceed max");
+    if (!isNumber(halfSize) || halfSize <= 0)
+        fail("halfSize must be a positive number");
+    if (!Array.isArray(maps) || maps.length < 3 || !maps.every((map, i) => map === MAPS[i]))
+        fail(`maps must be base, normalDepth, orm, optionally followed by emissive; got ${String(maps)}`);
+    if (specular !== undefined && !(Array.isArray(specular) && specular.length === 4 && specular.every((v) => isNumber(v) && v >= 0 && v <= 1)))
+        fail("specular must be 4 numbers in [0, 1]");
+    if (!Array.isArray(layers) || layers.length !== maps.length)
+        fail("one layer per map");
+    const cell = size / frames;
+    if (!Number.isInteger(Math.log2(cell)))
+        fail(`frame size ${cell} is not a power of two`);
+    const levels = Math.log2(cell) + 1;
+    for (const layer of layers) {
+        if (!Array.isArray(layer) || layer.length !== levels)
+            fail(`every layer must be a mip chain of ${levels} levels`);
+        layer.forEach((level, m) => {
+            const bytes = (size >> m) ** 2 * 4;
+            if (!(level instanceof Uint8Array) || level.length !== bytes)
+                fail(`mip level ${m} must be a Uint8Array of ${bytes} bytes`);
+        });
+    }
+}
+//# sourceMappingURL=impostor.js.map

package/dist/impostor/impostor.js.map

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

package/dist/impostor/mesh/card.d.ts

@@ -0,0 +1,38 @@
+import type { Node } from "three/webgpu";
+import type { ImpostorLayout } from "../impostor.js";
+/** What every card of one impostor reads. */
+export interface CardInputs {
+    layout: ImpostorLayout;
+    /** bounding box centre and half its edges, in the object's space */
+    centre: Node<"vec3">;
+    extent: Node<"vec3">;
+    /** bounding sphere radius: the depth channel's unit */
+    radius: Node<"float">;
+    /** half the edge of every frame's view */
+    halfSize: Node<"float">;
+    /** frames per atlas side */
+    frames: Node<"float">;
+    /** where the card sits within an instance's space; identity except under InstancedLod */
+    placement: Node<"mat4">;
+}
+/** The card as the surface reads it. */
+export declare const card: {
+    /** the three frames around the view direction and their barycentric weights */
+    readonly frames: readonly [Node<"vec2">, Node<"vec2">, Node<"vec2">];
+    readonly weights: import("three/webgpu").PropertyNode<"vec3">;
+    /** the view ray through the fragment, in the object's space: from `point`, along `ray` */
+    readonly point: import("three/webgpu").PropertyNode<"vec3">;
+    readonly ray: import("three/webgpu").PropertyNode<"vec3">;
+    /** the same ray in world space: `ray` × s in object space is `worldRay` × s in the world */
+    readonly worldPoint: import("three/webgpu").PropertyNode<"vec3">;
+    readonly worldRay: import("three/webgpu").PropertyNode<"vec3">;
+    /** an object-space normal in view space, as three's normal matrix turns a mesh's */
+    readonly toView: (normal: Node<"vec3">) => Node<"vec3">;
+};
+export type Card = typeof card;
+/**
+ * The card's vertex, in the mesh's space (after the instance matrix), for the instance
+ * placed by `instance`, `deform` (wind) applied in its space. Call it while the vertex
+ * stage builds the position: it writes the varyings `card` reads.
+ */
+export declare function buildCard(inputs: CardInputs, instance: Node<"mat4">, deform: Node<"mat4"> | null): Node<"vec3">;