@drawcall/lod 0.2.0 → 0.4.0

package/dist/levels.js

@@ -1,171 +0,0 @@
-import { Color } from "three/webgpu";
-import { texelPixels } from "./impostor/impostor.js";
-import { isImpostorMesh, isLOD } from "./three.js";
-import { at } from "./at.js";
-/** Share of each level's range over which its finer neighbour fades out. */
-export const FADE = 0.1;
-/** One owner's resolved threshold and drawable, separate from its reusable description. */
-export class Level {
-    input;
-    index;
-    ladder;
-    tint = new Color(1, 1, 1);
-    box;
-    object;
-    nested;
-    explicit;
-    base = Infinity;
-    value = Infinity;
-    constructor(input, index, ladder) {
-        this.input = input;
-        this.index = index;
-        this.ladder = ladder;
-        this.explicit = input.maxPixels ?? null;
-        if (input.maxPixels !== undefined)
-            checkThreshold(input.maxPixels, index);
-        this.box = input.box;
-        if (this.box && !this.box.isEmpty() && ![...this.box.min.toArray(), ...this.box.max.toArray()].every(Number.isFinite))
-            throw new Error("Lod: a deferred level's box must be finite");
-        this.object = input.object?.clone();
-        this.nested = this.object ? isLOD(this.object) : false;
-    }
-    get maxPixels() {
-        return this.value;
-    }
-    set maxPixels(value) {
-        checkThreshold(value, this.index);
-        this.explicit = value;
-        resolve(this.ladder);
-    }
-}
-function checkThreshold(value, index) {
-    if (index === 0 && value !== Infinity)
-        throw new Error(`Lod: level 0, the source, is used at any height: its maxPixels is Infinity, not ${value}`);
-    if (!(value > 0))
-        throw new Error(`Lod: maxPixels must be > 0, got ${value}`);
-}
-const deviations = new WeakMap();
-/** Surface deviation from the source, in the source's units. */
-export const recordDeviation = (level, deviation) => void deviations.set(level, deviation);
-export const deviationOf = (level) => deviations.get(level);
-/** Descriptions for a new owner, retaining threshold edits and sharing deferred decode. */
-export function cloneLevels(levels) {
-    return levels.map((level) => {
-        const { input, explicit } = level;
-        if (input.load)
-            return { ...input, maxPixels: level.maxPixels };
-        return { object: input.object, ...(explicit === null ? {} : { maxPixels: explicit }) };
-    });
-}
-export function measure(object) {
-    return { deviation: deviationOf(object), texels: isImpostorMesh(object) ? texelPixels(object.impostor) : undefined };
-}
-function bases(levels, diameter) {
-    let finer = 1024;
-    return levels.map(({ maxPixels, measured }, index) => {
-        if (index === 0)
-            return Infinity;
-        const base = !measured
-            ? maxPixels
-            : measured.deviation !== undefined
-                ? diameter / Math.max(measured.deviation, diameter * 1e-4)
-                : (measured.texels ?? finer / 2);
-        if (base === undefined)
-            throw new Error("Lod: a deferred level needs maxPixels");
-        finer = base;
-        return base;
-    });
-}
-/** Resolve thresholds from measurements without constructing renderer state. */
-export function resolveThresholds(levels, diameter) {
-    const defaults = bases(levels, diameter);
-    const thresholds = levels.map((level, index) => {
-        if (level.maxPixels !== undefined)
-            checkThreshold(level.maxPixels, index);
-        return { index, explicit: level.maxPixels ?? null, base: defaults[index] ?? Infinity, value: Infinity };
-    });
-    resolve(thresholds);
-    validate(thresholds.map(({ value }) => ({ maxPixels: value })));
-    return thresholds.map(({ value }) => value);
-}
-/** Resolve defaults once, retaining writable owner thresholds. */
-export function estimate(levels, diameter) {
-    const defaults = bases(levels.map(({ input }) => ({ maxPixels: input.maxPixels, measured: input.object && measure(input.object) })), diameter);
-    levels.forEach((level, index) => {
-        level.base = defaults[index] ?? Infinity;
-    });
-    resolve(levels);
-}
-function resolve(levels) {
-    let next = 0;
-    for (let i = levels.length - 1; i >= 0; i--) {
-        const level = at(levels, i);
-        level.value = level.index === 0 ? Infinity : (level.explicit ?? Math.max(level.base, 2 * next));
-        next = level.value;
-    }
-}
-/** Throws when neighbouring fades overlap. */
-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;
-}
-/** The coarsest level whose maxPixels `height` still fits; level 0 fits any height. */
-export function lastFitting(levels, height) {
-    for (let i = levels.length - 1; i > 0; i--)
-        if (height <= at(levels, i).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);
-}
-// Start refinement 20% below its lower fade bound, leaving time for decode and GPU preparation.
-export const DEMAND = 0.8;
-/** Logical demand and the next finer fade partner, including a small approach margin. */
-export function demandLevels(levels, height, forced) {
-    const desired = levelAt(levels, height, forced);
-    if (forced !== null)
-        return [desired];
-    const finer = levels[desired.index - 1];
-    return finer && height >= DEMAND * desired.maxPixels * (1 - FADE) ? [desired, finer] : [desired];
-}
-/** Nearest ready finer level, else nearest coarser; -1 draws nothing until one is ready. */
-export function fallbacks(levels, ready) {
-    return levels.map((_, index) => {
-        for (let finer = index; finer >= 0; finer--)
-            if (ready.has(at(levels, finer)))
-                return finer;
-        for (let coarser = index + 1; coarser < levels.length; coarser++)
-            if (ready.has(at(levels, coarser)))
-                return coarser;
-        return -1;
-    });
-}
-//# sourceMappingURL=levels.js.map

package/dist/levels.js.map

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

package/dist/loader/bundle.d.ts

@@ -1,25 +0,0 @@
-import { type Object3D } from "three/webgpu";
-import { disposeRejected } from "../dispose.js";
-import { type ImpostorMeshOptions } from "../impostor/mesh/index.js";
-import { type LodLevel } from "../levels.js";
-import type { LevelRequest } from "../loader.js";
-export type Kind = "source" | LevelRequest["type"];
-/** The ladder indices whose payload is saved as its own entry: every derived drawable level except the inlined coarsest. */
-export declare function separateLevels(kinds: readonly Kind[]): number[];
-/**
- * Inline coarse derived payloads; a source-only request leaves its source deferred. The index
- * keeps what thresholds are measured from, not thresholds or impostor draw options, so changing
- * either reuses the cache. `levels` maps each deferred level index to its payload.
- */
-export declare function encode(objects: readonly Object3D[], kinds: readonly Kind[]): Promise<{
-    index: Uint8Array;
-    levels: Map<number, Uint8Array>;
-}>;
-/** What a request sets per level at decode, without changing cached content. */
-interface Requested {
-    maxPixels?: number;
-    draw?: ImpostorMeshOptions;
-}
-/** Index metadata exposes every drawable level without decoding its payload. `requested` holds level i's request at i. */
-export declare function decode(bytes: Uint8Array, requested: readonly Requested[], loadSource: () => Promise<Object3D>, loadLevel: (index: number) => Promise<Uint8Array>, onLevel?: (object: Object3D, index: number) => void | Promise<void>, release?: typeof disposeRejected): LodLevel[];
-export {};

package/dist/loader/bundle.js

@@ -1,241 +0,0 @@
-import { Box3, Group, Matrix4 } from "three/webgpu";
-import { decodeBakedMeshAsync, encodeBakedMesh } from "../baked/codec.js";
-import { boundingBox, measureLevels } from "../bounds.js";
-import { loadOnce } from "../deferred.js";
-import { disposeRejected } from "../dispose.js";
-import { decodeImpostorAsync, encodeImpostor } from "../impostor/codec.js";
-import { ImpostorMesh } from "../impostor/mesh/index.js";
-import { measure, recordDeviation, resolveThresholds } from "../levels.js";
-import { isImpostorMesh, isMesh } from "../three.js";
-import { decodeMeshAsync, encodeMesh } from "../mesh/codec.js";
-/** The coarsest drawable level, whose payload the index inlines unless it is the source, which loads from its URL. */
-function coarsestOf(kinds) {
-    return kinds.reduce((last, kind, index) => (kind === "empty" ? last : index), -1);
-}
-/** The ladder indices whose payload is saved as its own entry: every derived drawable level except the inlined coarsest. */
-export function separateLevels(kinds) {
-    const coarsest = coarsestOf(kinds);
-    return kinds.flatMap((kind, index) => (kind === "source" || kind === "empty" || index === coarsest ? [] : [index]));
-}
-/**
- * Inline coarse derived payloads; a source-only request leaves its source deferred. The index
- * keeps what thresholds are measured from, not thresholds or impostor draw options, so changing
- * either reuses the cache. `levels` maps each deferred level index to its payload.
- */
-export async function encode(objects, kinds) {
-    const payloads = [];
-    const metadata = [];
-    const materials = materialsOf(objects[0]);
-    if (kinds.length !== objects.length)
-        throw new Error("LodLoader: level kinds do not match levels");
-    for (const [level, object] of objects.entries()) {
-        const kind = kinds[level];
-        if (!kind)
-            throw new Error("LodLoader: missing level kind");
-        const box = boundingBox(object);
-        if (box.isEmpty() && kind !== "empty")
-            throw new Error(`LodLoader: ${kind} level ${level} has an empty box`);
-        const bytes = await payload(object, kind, materials);
-        if (object.matrixAutoUpdate)
-            object.updateMatrix();
-        metadata.push({
-            kind,
-            name: object.name,
-            ...measure(object),
-            box: box.isEmpty() ? null : [...box.min.toArray(), ...box.max.toArray()],
-            matrix: object.matrix.toArray(),
-            matrixAutoUpdate: object.matrixAutoUpdate,
-            castShadow: object.castShadow,
-            receiveShadow: object.receiveShadow,
-            length: bytes.byteLength,
-        });
-        payloads.push(bytes);
-    }
-    const coarsest = coarsestOf(kinds);
-    if (coarsest < 0)
-        throw new Error("LodLoader: cache has no drawable level");
-    const coarse = coarsest > 0 ? payloads[coarsest] : new Uint8Array();
-    if (!coarse)
-        throw new Error("LodLoader: missing coarse payload");
-    const header = new TextEncoder().encode(JSON.stringify(metadata));
-    const index = new Uint8Array(8 + header.length + coarse.length);
-    const view = new DataView(index.buffer);
-    view.setUint32(0, 0x32444f4c, true);
-    view.setUint32(4, header.length, true);
-    index.set(header, 8);
-    index.set(coarse, 8 + header.length);
-    const levels = new Map(separateLevels(kinds).map((level) => {
-        const bytes = payloads[level];
-        if (!bytes)
-            throw new Error(`LodLoader: missing payload ${level}`);
-        return [level, bytes];
-    }));
-    return { index, levels };
-}
-async function payload(object, kind, materials) {
-    switch (kind) {
-        case "source":
-        case "empty":
-            return new Uint8Array();
-        case "simplify":
-            return encodeMesh(object, materials);
-        case "baked":
-            if (!isMesh(object))
-                throw new Error("LodLoader: baked level is not a mesh");
-            return encodeBakedMesh(object);
-        case "impostor":
-            if (!isImpostorMesh(object))
-                throw new Error("LodLoader: impostor level is not an ImpostorMesh");
-            return encodeImpostor(object.impostor);
-    }
-}
-/** The inverse of `payload`; `read` has checked that a source or empty level has no bytes. */
-async function decodePayload(kind, bytes, loadSource, materials, draw) {
-    switch (kind) {
-        case "source":
-            return loadSource();
-        case "empty":
-            return new Group();
-        case "simplify":
-            return decodeMeshAsync(await bytes(), await materials());
-        case "baked":
-            return decodeBakedMeshAsync(await bytes());
-        case "impostor":
-            return new ImpostorMesh(await decodeImpostorAsync(await bytes()), 1, draw);
-    }
-}
-/** Index metadata exposes every drawable level without decoding its payload. `requested` holds level i's request at i. */
-export function decode(bytes, requested, loadSource, loadLevel, onLevel, release = disposeRejected) {
-    const { metadata, coarsest, coarse } = read(bytes);
-    if (requested.length !== metadata.length)
-        fail("level count");
-    const diameter = measureLevels(metadata, "LodLoader").own.radius * 2;
-    const thresholds = resolveThresholds(metadata.map(({ deviation, texels }, index) => ({ maxPixels: requested[index]?.maxPixels, measured: { deviation, texels } })), diameter);
-    const materials = async () => {
-        const source = levels[0];
-        if (!source)
-            fail("missing source materials");
-        return materialsOf(source.object ?? (await loadOnce(source.load).promise));
-    };
-    const levels = metadata.map((level, index) => {
-        const load = async () => {
-            const levelBytes = async () => {
-                const payload = index === coarsest && coarsest > 0 ? coarse : await loadLevel(index);
-                if (payload.length !== level.length)
-                    fail(`level ${index} payload length`);
-                return payload;
-            };
-            const loaded = await decodePayload(level.kind, levelBytes, loadSource, materials, requested[index]?.draw);
-            try {
-                place(loaded, level);
-                if (level.deviation !== undefined)
-                    recordDeviation(loaded, level.deviation);
-                await onLevel?.(loaded, index);
-                return loaded;
-            }
-            catch (error) {
-                release(loaded);
-                throw error;
-            }
-        };
-        return {
-            load,
-            maxPixels: thresholds[index] ?? fail("missing threshold"),
-            box: level.box.clone().applyMatrix4(level.matrix),
-        };
-    });
-    return levels;
-}
-function materialsOf(object) {
-    const materials = [];
-    object?.traverse((node) => {
-        if (isMesh(node))
-            for (const material of [node.material].flat())
-                materials.push(material);
-    });
-    return materials;
-}
-function place(object, level) {
-    object.name = level.name;
-    level.matrix.decompose(object.position, object.quaternion, object.scale);
-    object.matrix.copy(level.matrix);
-    object.matrixAutoUpdate = level.matrixAutoUpdate;
-    object.castShadow = level.castShadow;
-    object.receiveShadow = level.receiveShadow;
-}
-function read(bytes) {
-    if (bytes.length < 8)
-        fail("missing header");
-    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    const length = view.getUint32(4, true);
-    if (view.getUint32(0, true) !== 0x32444f4c || length > bytes.length - 8)
-        fail("invalid header");
-    const parsed = JSON.parse(new TextDecoder().decode(bytes.subarray(8, 8 + length)));
-    if (!Array.isArray(parsed) || !parsed.length)
-        fail("missing levels");
-    const metadata = parsed.map((value) => {
-        const meta = object(value);
-        const kind = meta.kind;
-        if (kind !== "simplify" && kind !== "baked" && kind !== "impostor" && kind !== "empty" && kind !== "source")
-            fail("unknown level kind");
-        if (typeof meta.name !== "string" ||
-            typeof meta.castShadow !== "boolean" ||
-            typeof meta.receiveShadow !== "boolean" ||
-            typeof meta.matrixAutoUpdate !== "boolean")
-            fail("invalid level settings");
-        const size = finite(meta.length);
-        if (!Number.isSafeInteger(size) || size < 0)
-            fail("invalid payload length");
-        const box = meta.box === null ? new Box3() : new Box3().setFromArray(numbers(meta.box, 6));
-        if (box.isEmpty() && kind !== "empty")
-            fail("drawable level has an empty box");
-        if ((kind === "empty" || kind === "source") !== (size === 0))
-            fail("invalid level payload length");
-        const matrix = new Matrix4().fromArray(numbers(meta.matrix, 16));
-        const deviation = meta.deviation === undefined ? undefined : finite(meta.deviation);
-        if (deviation !== undefined && deviation < 0)
-            fail("negative deviation");
-        const texels = meta.texels === undefined ? undefined : finite(meta.texels);
-        if (texels !== undefined && texels <= 0)
-            fail("invalid texels");
-        const level = {
-            kind,
-            name: meta.name,
-            deviation,
-            texels,
-            box,
-            matrix,
-            matrixAutoUpdate: meta.matrixAutoUpdate,
-            castShadow: meta.castShadow,
-            receiveShadow: meta.receiveShadow,
-            length: size,
-        };
-        return level;
-    });
-    const coarsest = coarsestOf(metadata.map((level) => level.kind));
-    if (coarsest < 0)
-        fail("no drawable level");
-    const size = coarsest > 0 ? metadata[coarsest]?.length : 0;
-    if (size === undefined || bytes.length !== 8 + length + size)
-        fail("invalid coarse payload length");
-    return { metadata, coarsest, coarse: bytes.subarray(8 + length) };
-}
-function object(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value))
-        fail("expected metadata object");
-    return Object.fromEntries(Object.entries(value));
-}
-function finite(value) {
-    if (typeof value !== "number" || !Number.isFinite(value))
-        fail("expected finite number");
-    return value;
-}
-function numbers(value, count) {
-    if (!Array.isArray(value) || value.length !== count)
-        fail(`expected ${count} numbers`);
-    return value.map(finite);
-}
-function fail(reason) {
-    throw new Error(`LodLoader: invalid cache (${reason})`);
-}
-//# sourceMappingURL=bundle.js.map

package/dist/loader/bundle.js.map

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

package/dist/loader/cache.d.ts

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

package/dist/loader/cache.js

@@ -1,75 +0,0 @@
-import { CacheEntry } from "vitecache";
-import { urlQuery } from "./url.js";
-const version = "lod-levels@18";
-/**
- * The index of a ladder: keyed by the requested URLs, levels and bundled modules, and saved with what loading the sources
- * revealed, so vitecache rechecks those without loading the sources.
- */
-export function indexEntry(inputs, levels, modules, options) {
-    // vitecache resolves URLs to file paths; keep generation parameters in the key.
-    const queries = {};
-    for (const [name, dependency] of Object.entries(inputs)) {
-        const query = dependency.url === undefined ? "" : urlQuery(dependency.url);
-        if (query)
-            queries[name] = query;
-    }
-    return new CacheEntry({
-        basePath: options?.basePath,
-        root: options?.root,
-        version,
-        dependencies: {
-            ...inputs,
-            "lod:levels": { value: levels.map(parameters) },
-            "lod:modules": { value: modules },
-            "lod:queries": { value: queries },
-            // Only packages the app installs resolve from its root; this package's own dependencies are covered by its version and `version` above.
-            "lod:package": { package: "@drawcall/lod" },
-            "lod:three": { package: "three" },
-        },
-    });
-}
-/**
- * A level payload saved apart from its index, addressed by the index's content: a valid index vouches for its payloads,
- * and rebuilds write new ones rather than replacing those a live ladder or another build still reads.
- */
-export function payloadEntry(index, level, options) {
-    return new CacheEntry({
-        basePath: options?.basePath,
-        root: options?.root,
-        version,
-        dependencies: { "lod:index": { value: index }, "lod:level": { value: level } },
-    });
-}
-export async function sha256(bytes) {
-    const hash = await crypto.subtle.digest("SHA-256", new Uint8Array(bytes));
-    return Array.from(new Uint8Array(hash), (byte) => byte.toString(16).padStart(2, "0")).join("");
-}
-/** What derives each level's content. Switch thresholds and impostor draw options apply at decode, so changing one reuses the cache. */
-function parameters(level) {
-    switch (level.type) {
-        case "empty":
-            return { type: level.type };
-        case "simplify":
-            return { type: level.type, ratio: level.ratio ?? null };
-        case "baked":
-            return {
-                type: level.type,
-                ratio: level.ratio ?? null,
-                textureSize: level.textureSize ?? null,
-                low: level.low ?? null,
-                interior: level.interior ?? null,
-            };
-        case "impostor":
-            return {
-                type: level.type,
-                // The impostor bakes its top mip for this height too.
-                maxPixels: level.maxPixels ?? null,
-                layout: level.layout ?? null,
-                frames: level.frames ?? null,
-                resolution: level.resolution ?? null,
-                emissive: level.emissive ?? null,
-                supersample: level.supersample ?? null,
-            };
-    }
-}
-//# sourceMappingURL=cache.js.map

package/dist/loader/cache.js.map

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

package/dist/loader/provenance.d.ts

@@ -1,30 +0,0 @@
-import type { LoadingManager, Object3D } from "three/webgpu";
-import type { Dependencies, SavedDependencies } from "vitecache";
-/** The requested assets, and the files and packages loading them revealed, for saving with the index built from them. */
-export declare class Provenance {
-    private readonly manager;
-    readonly inputs: Dependencies;
-    private readonly resources;
-    /** Kept whole: a GLTS source reports what it has observed so far, so it is read when saving. */
-    private readonly scripts;
-    constructor(urls: Readonly<Record<string, string>>, manager: LoadingManager);
-    capture(url: string, object: Object3D, result: unknown): void;
-    /** The requested URLs, resolved as `inputs` holds them. */
-    get requested(): string[];
-    /**
-     * What the captured assets were built from so far, beyond the requested URLs, or why that cannot be validated later:
-     * a CDN module fetched at runtime, which bundled moduleSources cannot vouch for, or a cross-origin resource, which
-     * vitecache cannot hash.
-     */
-    dependencies(): {
-        dependencies: SavedDependencies;
-    } | {
-        reason: string;
-    };
-}
-/**
- * Digests of the bundled modules each input script's GLTS loader links, by input name. They are known before a source runs,
- * so they key its levels: a source's bundled module hashes come from these moduleSources. Any change to them, such as a new
- * bare import in any .glts, therefore invalidates every GLTS-derived level.
- */
-export declare function bundledModules(urls: Readonly<Record<string, string>>, manager: LoadingManager): Promise<Record<string, string>>;