@rydr/game-sdk 9.10.0 → 9.12.0

package/dist/three/baked-lighting.js

@@ -0,0 +1,289 @@
+/**
+ * baked-lighting — load a BAKED scene ({@link SceneBake}) and render it with its lightmaps.
+ *
+ * A baked scene is one self-contained glb produced by the platform's bake pipeline (Blender, see the
+ * platform repo's `docs/baked-lighting.md`): the world plus whatever a game baked with it, every static
+ * mesh carrying a second UV set (`TEXCOORD_1`) and a material extension, `RYDR_lightmap`, that points at
+ * the lightmap atlas it was baked into.
+ *
+ * ## What a lightmap holds, and how it is shown
+ *
+ * The light each surface RECEIVES (sun, sky, lamps, bounce) — not its colour. So a baked material is
+ * `albedo × lightmap`, which keeps the full detail of the colour textures at a low lightmap resolution,
+ * and it is a `MeshBasicMaterial`: the scene's live lights must not light it a second time. That is
+ * also why a baked world is CHEAPER than a live one — no per-pixel lighting at all.
+ *
+ * The atlas is an 8-bit sRGB PNG: the bake divides the light by a per-atlas `scale` before encoding,
+ * the GPU's sRGB decode undoes the curve for free, and `intensity` (= π × scale, the π cancelling
+ * `MeshBasicMaterial`'s Lambert term) puts the range back. No custom shader, no alpha channel for
+ * a browser to premultiply.
+ *
+ * ## What stays live
+ *
+ * Anything that moves. A car is still lit by the game's own sun + environment, and its shadow is put
+ * on the baked ground by a SHADOW CATCHER ({@link createShadowCatcher}): a `ShadowMaterial` overlay on
+ * the meshes the export marked as receivers (the road, the ground around it). Everything else in the
+ * baked scene casts and receives nothing live — its shadows are in the lightmap.
+ */
+import * as THREE from "three";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { DRACOLoader } from "three/addons/loaders/DRACOLoader.js";
+import { DRACO_DECODER_PATH } from "./world-loader.js";
+import { createGlbCache } from "./glb-cache.js";
+import { mergeByMaterial } from "./merge.js";
+/** The glTF material extension a baked glb carries. */
+export const RYDR_LIGHTMAP_EXTENSION = "RYDR_lightmap";
+/** Node extras the export writes and the bake carries through (see the platform's bake docs). */
+export const BAKE_EXTRAS = {
+    /** `"static"` (gets a lightmap) or `"occluder"` (casts in the bake, then dropped). */
+    role: "rydr_role",
+    /** true on meshes a moving object's live shadow must land on (a road). */
+    receiveShadow: "rydr_receive_shadow",
+    /** Texels per metre wanted for this mesh. */
+    density: "rydr_lm_density",
+    /** Atlas preference, e.g. `"near-road"`. */
+    atlasHint: "rydr_atlas_hint",
+    /** Written BY the bake: the atlas a mesh ended up in. */
+    lightmap: "rydr_lightmap",
+    /**
+     * `"world"` (the platform world's geometry) or `"game"` (what the game added: a road, walls). Lets a
+     * game tell the two apart in a baked scene — racing probes the drivable height off the WORLD alone.
+     */
+    layer: "rydr_layer",
+};
+/** Name of the empty node carrying the bake manifest (a JSON string in its extras). */
+export const BAKE_MANIFEST_NODE = "RYDR_BAKE_MANIFEST";
+/** The extras key on {@link BAKE_MANIFEST_NODE}. */
+export const BAKE_MANIFEST_KEY = "rydr_bake_manifest";
+/**
+ * GLTFLoader plugin for `RYDR_lightmap`: assigns the atlas as the material's `lightMap` on UV channel 1
+ * with the extension's intensity. Register it on any GLTFLoader that may meet a baked glb:
+ * `loader.register((parser) => new RydrLightmapPlugin(parser))`.
+ */
+export class RydrLightmapPlugin {
+    parser;
+    name = RYDR_LIGHTMAP_EXTENSION;
+    constructor(parser) {
+        this.parser = parser;
+    }
+    extendMaterialParams(materialIndex, materialParams) {
+        const def = this.parser.json.materials?.[materialIndex];
+        const ext = def?.extensions?.[RYDR_LIGHTMAP_EXTENSION];
+        if (!ext)
+            return Promise.resolve();
+        materialParams.lightMapIntensity = ext.intensity;
+        return this.parser.assignTexture(materialParams, "lightMap", { index: ext.index, texCoord: ext.texCoord ?? 1 }, THREE.SRGBColorSpace);
+    }
+}
+/** Add the {@link RydrLightmapPlugin} to a loader (idempotent per loader instance is the caller's job). */
+export function registerBakedLighting(loader) {
+    loader.register((parser) => new RydrLightmapPlugin(parser));
+    return loader;
+}
+/**
+ * The material a baked mesh renders with: `albedo × lightmap`, unlit by the live rig.
+ *
+ * Returns `src` untouched when it has no lightmap (a mesh the bake skipped stays lit live, rather than
+ * turning black). Emissive surfaces keep their glow — a lit window IS its emission — via a two-line
+ * shader addition, since `MeshBasicMaterial` has no emissive of its own.
+ */
+export function toBakedMaterial(src) {
+    const s = src;
+    if (!s.lightMap)
+        return src;
+    const m = new THREE.MeshBasicMaterial({
+        name: s.name,
+        color: s.color?.clone() ?? new THREE.Color(0xffffff),
+        map: s.map,
+        alphaMap: s.alphaMap,
+        alphaTest: s.alphaTest,
+        transparent: s.transparent,
+        opacity: s.opacity,
+        side: s.side,
+        vertexColors: s.vertexColors,
+        lightMap: s.lightMap,
+        lightMapIntensity: s.lightMapIntensity,
+        depthWrite: s.depthWrite,
+        fog: true,
+    });
+    m.userData = { ...s.userData, rydrBaked: true };
+    const emissive = s.emissive ? s.emissive.clone().multiplyScalar(s.emissiveIntensity ?? 1) : null;
+    const hasEmissive = !!emissive && (emissive.r > 0 || emissive.g > 0 || emissive.b > 0);
+    if (hasEmissive) {
+        // The emissive map is only honoured when it shares the colour map's UV channel, which is the only
+        // case the fragment already has a UV for. Otherwise the flat emissive colour still shows.
+        const emissiveMap = s.emissiveMap && s.map && s.emissiveMap.channel === s.map.channel ? s.emissiveMap : null;
+        m.onBeforeCompile = (shader) => {
+            shader.uniforms.rydrEmissive = { value: emissive };
+            if (emissiveMap)
+                shader.uniforms.rydrEmissiveMap = { value: emissiveMap };
+            shader.fragmentShader = shader.fragmentShader
+                .replace("#include <common>", `#include <common>\nuniform vec3 rydrEmissive;\n${emissiveMap ? "uniform sampler2D rydrEmissiveMap;" : ""}`)
+                .replace("#include <opaque_fragment>", `${emissiveMap
+                ? "outgoingLight += rydrEmissive * texture2D( rydrEmissiveMap, vMapUv ).rgb;"
+                : "outgoingLight += rydrEmissive;"}\n#include <opaque_fragment>`);
+        };
+        m.customProgramCacheKey = () => (emissiveMap ? "rydr-baked-emissive-map" : "rydr-baked-emissive");
+    }
+    return m;
+}
+const bakedCache = new Map();
+/**
+ * Load (and cache by glb path) a baked scene, with every lightmapped material swapped for its
+ * {@link toBakedMaterial}. Pass the {@link SceneBake} (or its url). Rejects if the glb fails to load —
+ * the caller falls back to rendering live.
+ */
+export function loadBakedScene(bake, opts = {}) {
+    const url = typeof bake === "string" ? bake : bake.glbUrl;
+    const cut = url.search(/[?#]/);
+    const key = cut === -1 ? url : url.slice(0, cut);
+    let p = bakedCache.get(key);
+    if (!p) {
+        p = buildBakedScene(url, key, opts);
+        p.catch(() => {
+            if (bakedCache.get(key) === p)
+                bakedCache.delete(key);
+        });
+        bakedCache.set(key, p);
+    }
+    return p;
+}
+async function buildBakedScene(url, key, opts) {
+    const loader = registerBakedLighting(new GLTFLoader());
+    const draco = new DRACOLoader();
+    draco.setDecoderPath(opts.dracoDecoderPath ?? DRACO_DECODER_PATH);
+    loader.setDRACOLoader(draco);
+    const cache = opts.cache === false ? null : createGlbCache(opts.cache);
+    const path = key.slice(0, key.lastIndexOf("/") + 1);
+    const gltf = cache
+        ? await cache.bytes(url).then((buf) => loader.parseAsync(buf, path))
+        : await loader.loadAsync(url);
+    draco.dispose();
+    const group = new THREE.Group();
+    group.name = "baked-scene";
+    group.add(gltf.scene);
+    const receivers = [];
+    let manifest = null;
+    const swapped = new Map();
+    const swap = (mat) => {
+        let out = swapped.get(mat);
+        if (!out) {
+            out = toBakedMaterial(mat);
+            if (out !== mat)
+                mat.dispose();
+            swapped.set(mat, out);
+        }
+        return out;
+    };
+    gltf.scene.traverse((o) => {
+        const raw = o.userData?.[BAKE_MANIFEST_KEY];
+        if (typeof raw === "string" && !manifest) {
+            try {
+                manifest = JSON.parse(raw);
+            }
+            catch {
+                /* a malformed manifest only costs the diagnostics */
+            }
+        }
+        const mesh = o;
+        if (!mesh.isMesh)
+            return;
+        mesh.material = Array.isArray(mesh.material) ? mesh.material.map(swap) : swap(mesh.material);
+        // The lightmap already holds every static shadow; nothing in here takes part in the live pass.
+        mesh.castShadow = false;
+        mesh.receiveShadow = false;
+        if (o.userData?.[BAKE_EXTRAS.receiveShadow]) {
+            receivers.push(mesh);
+            // A merged receiver would take its catcher's geometry reference with it.
+            mesh.userData.__noMerge = true;
+        }
+    });
+    if (opts.mergeStatics)
+        mergeByMaterial(group, { groupBy: "instance", disposeConsumed: false });
+    return {
+        id: key,
+        group,
+        receivers,
+        manifest,
+        attach: (parent) => void parent.add(group),
+        detach: () => void group.removeFromParent(),
+        dispose: () => {
+            group.removeFromParent();
+            const textures = new Set();
+            group.traverse((o) => {
+                const mesh = o;
+                if (!mesh.isMesh)
+                    return;
+                mesh.geometry?.dispose();
+                for (const m of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
+                    const mm = m;
+                    if (mm.lightMap)
+                        textures.add(mm.lightMap);
+                    m.dispose();
+                }
+            });
+            // Lightmaps belong to this scene alone (unlike shared colour textures), so free them here.
+            for (const t of textures)
+                t.dispose();
+            if (bakedCache.has(key))
+                bakedCache.delete(key);
+        },
+    };
+}
+/** Drop cached baked scenes (all, or one glb path) and free them. */
+export function clearBakedSceneCache(url) {
+    const drop = (k, p) => {
+        bakedCache.delete(k);
+        void p.then((s) => s.dispose()).catch(() => { });
+    };
+    if (url !== undefined) {
+        const cut = url.search(/[?#]/);
+        const k = cut === -1 ? url : url.slice(0, cut);
+        const p = bakedCache.get(k);
+        if (p)
+            drop(k, p);
+        return;
+    }
+    for (const [k, p] of bakedCache)
+        drop(k, p);
+}
+/**
+ * Put a moving object's LIVE shadow on baked ground: one `ShadowMaterial` overlay per receiver, sharing
+ * its geometry and parented to it (so it follows exactly, at zero extra memory), drawn just in front
+ * of it with a polygon offset.
+ *
+ * It only darkens, which is the point — the receiver's own lighting is the lightmap and must not
+ * change. The catcher needs the game's sun to cast shadows as it already does; nothing else about the
+ * live rig changes.
+ */
+export function createShadowCatcher(receivers, opts = {}) {
+    const material = new THREE.ShadowMaterial({
+        opacity: opts.opacity ?? 0.45,
+        transparent: true,
+        depthWrite: false,
+        polygonOffset: true,
+        polygonOffsetFactor: -1,
+        polygonOffsetUnits: -1,
+    });
+    const meshes = [];
+    for (const r of receivers) {
+        const catcher = new THREE.Mesh(r.geometry, material);
+        catcher.name = "__shadow-catcher";
+        catcher.receiveShadow = true;
+        catcher.castShadow = false;
+        catcher.renderOrder = 1;
+        catcher.raycast = () => { }; // never pickable: it is a coat of paint, not geometry
+        r.add(catcher);
+        meshes.push(catcher);
+    }
+    return {
+        meshes,
+        setOpacity: (o) => void (material.opacity = o),
+        dispose: () => {
+            for (const m of meshes)
+                m.removeFromParent();
+            material.dispose();
+        },
+    };
+}
+//# sourceMappingURL=baked-lighting.js.map

package/dist/three/baked-lighting.js.map

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

package/dist/three/index.d.ts

@@ -6,6 +6,8 @@
  * `GLTFLoader` + DRACO + caching per game.
  */
 export * from "./world-loader.js";
+export * from "./baked-lighting.js";
+export * from "./preset-lighting.js";
 export * from "./glb-cache.js";
 export * from "./merge.js";
 export * from "./perf-marks.js";

package/dist/three/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/index.js

@@ -6,6 +6,8 @@
  * `GLTFLoader` + DRACO + caching per game.
  */
 export * from "./world-loader.js";
+export * from "./baked-lighting.js";
+export * from "./preset-lighting.js";
 export * from "./glb-cache.js";
 export * from "./merge.js";
 export * from "./perf-marks.js";

package/dist/three/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/three/preset-lighting.d.ts

@@ -0,0 +1,65 @@
+/**
+ * preset-lighting — light a three.js scene LIVE from a {@link WorldLightingPreset}, and turn a world's
+ * placed lights into real three.js lights (opt-in, capped).
+ *
+ * The rig is the one a preset describes, field for field: a shadow-casting sun, an unshadowed fill
+ * opposite it, a hemisphere, a flat ambient, and a gradient sky that is both `scene.background` and
+ * the PMREM environment. The platform's bake lights the same scene in Blender from the same fields,
+ * with the same gradient ({@link buildSkyTexture}), which is what makes a baked scene and a live one
+ * of the same preset look alike.
+ *
+ * A game with its own rig (racing's `installSceneLighting`) does not need this module: it reads the
+ * preset's fields into its own. This is for games and tools that don't have one.
+ */
+import * as THREE from "three";
+import type { CoreWorld, WorldLight, WorldLightingPreset } from "../protocol/worlds.js";
+/**
+ * The sky gradient, as a small equirect canvas texture (sRGB). The stops are the contract the bake's
+ * world shader reproduces: zenith down to 14.4° above the horizon, horizon haze AT the horizon, ground
+ * from 3.6° below it. Tiny on purpose — PMREM blurs it anyway.
+ */
+export declare function buildSkyTexture(sky: WorldLightingPreset["sky"]): THREE.CanvasTexture;
+/** The gradient stops (0 = straight up, 0.5 = horizon, 1 = straight down). Mirrored by the bake script. */
+export declare function skyStops(sky: WorldLightingPreset["sky"]): Array<[number, string]>;
+export interface PresetRigOptions {
+    /** Needed for the environment probe. Without it the sky is only a background. */
+    renderer?: THREE.WebGLRenderer;
+    /** Distance the sun sits from its target. Default 200. */
+    sunDistance?: number;
+    /** Cast the sun's shadow. Default false (the caller sizes the frustum). */
+    shadows?: boolean;
+    /** Apply fog. Default true. */
+    fog?: boolean;
+}
+/** A live rig built from a preset. `apply` re-lights it from another preset without rebuilding. */
+export interface PresetRig {
+    readonly sun: THREE.DirectionalLight;
+    readonly fill: THREE.DirectionalLight;
+    readonly hemisphere: THREE.HemisphereLight;
+    readonly ambient: THREE.AmbientLight;
+    apply(preset: WorldLightingPreset): void;
+    dispose(): void;
+}
+/**
+ * Light `scene` from `preset`: adds the rig's lights, sets background / environment / fog, and the
+ * renderer's exposure (ACES filmic) when a renderer is given.
+ */
+export declare function applyLightingPreset(scene: THREE.Scene, preset: WorldLightingPreset, opts?: PresetRigOptions): PresetRig;
+export interface WorldLightsOptions {
+    /**
+     * At most this many live lights (default 8): each one costs every lit pixel of the frame in WebGL.
+     * The strongest are kept — or the nearest to `near`, when given.
+     */
+    max?: number;
+    near?: THREE.Vector3;
+    /** Let them cast shadows. Default false (a point light's shadow is six renders). */
+    shadows?: boolean;
+}
+/**
+ * Real three.js lights for a world's placed {@link WorldLight}s, under a preset's groups. Area lights
+ * are skipped (bake-only). For a LIVE scene only — a baked one already has their light.
+ */
+export declare function createWorldLights(world: Pick<CoreWorld, "map">, preset: WorldLightingPreset | null, opts?: WorldLightsOptions): THREE.Group;
+/** One {@link WorldLight} as a three.js light (an area light is approximated as a point). Intensity already includes the preset. */
+export declare function threeLight(l: WorldLight, intensity: number): THREE.Light;
+//# sourceMappingURL=preset-lighting.d.ts.map

package/dist/three/preset-lighting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-lighting.d.ts","sourceRoot":"","sources":["../../src/three/preset-lighting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGxF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,aAAa,CAepF;AAED,2GAA2G;AAC3G,wBAAgB,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQjF;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC/B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,gBAAgB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,gBAAqB,GAC1B,SAAS,CA2DX;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAC7B,MAAM,EAAE,mBAAmB,GAAG,IAAI,EAClC,IAAI,GAAE,kBAAuB,GAC5B,KAAK,CAAC,KAAK,CAgBb;AAED,oIAAoI;AACpI,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAqBxE"}

package/dist/three/preset-lighting.js

@@ -0,0 +1,163 @@
+/**
+ * preset-lighting — light a three.js scene LIVE from a {@link WorldLightingPreset}, and turn a world's
+ * placed lights into real three.js lights (opt-in, capped).
+ *
+ * The rig is the one a preset describes, field for field: a shadow-casting sun, an unshadowed fill
+ * opposite it, a hemisphere, a flat ambient, and a gradient sky that is both `scene.background` and
+ * the PMREM environment. The platform's bake lights the same scene in Blender from the same fields,
+ * with the same gradient ({@link buildSkyTexture}), which is what makes a baked scene and a live one
+ * of the same preset look alike.
+ *
+ * A game with its own rig (racing's `installSceneLighting`) does not need this module: it reads the
+ * preset's fields into its own. This is for games and tools that don't have one.
+ */
+import * as THREE from "three";
+import { effectiveLights, sunDirection } from "../world-lighting.js";
+/**
+ * The sky gradient, as a small equirect canvas texture (sRGB). The stops are the contract the bake's
+ * world shader reproduces: zenith down to 14.4° above the horizon, horizon haze AT the horizon, ground
+ * from 3.6° below it. Tiny on purpose — PMREM blurs it anyway.
+ */
+export function buildSkyTexture(sky) {
+    const canvas = document.createElement("canvas");
+    canvas.width = 32;
+    canvas.height = 128;
+    const ctx = canvas.getContext("2d");
+    if (!ctx)
+        throw new Error("[rydr-sdk] buildSkyTexture: 2D context unavailable");
+    const grad = ctx.createLinearGradient(0, 0, 0, canvas.height);
+    for (const [at, colour] of skyStops(sky))
+        grad.addColorStop(at, colour);
+    ctx.fillStyle = grad;
+    ctx.fillRect(0, 0, canvas.width, canvas.height);
+    const tex = new THREE.CanvasTexture(canvas);
+    tex.mapping = THREE.EquirectangularReflectionMapping;
+    tex.colorSpace = THREE.SRGBColorSpace;
+    tex.needsUpdate = true;
+    return tex;
+}
+/** The gradient stops (0 = straight up, 0.5 = horizon, 1 = straight down). Mirrored by the bake script. */
+export function skyStops(sky) {
+    return [
+        [0, sky.zenith],
+        [0.42, sky.zenith],
+        [0.5, sky.horizon],
+        [0.52, sky.ground],
+        [1, sky.ground],
+    ];
+}
+/**
+ * Light `scene` from `preset`: adds the rig's lights, sets background / environment / fog, and the
+ * renderer's exposure (ACES filmic) when a renderer is given.
+ */
+export function applyLightingPreset(scene, preset, opts = {}) {
+    const dist = opts.sunDistance ?? 200;
+    const sun = new THREE.DirectionalLight();
+    sun.name = "preset-sun";
+    sun.castShadow = !!opts.shadows;
+    const fill = new THREE.DirectionalLight();
+    fill.name = "preset-fill";
+    const hemisphere = new THREE.HemisphereLight();
+    const ambient = new THREE.AmbientLight();
+    scene.add(sun, sun.target, fill, fill.target, hemisphere, ambient);
+    let sky = null;
+    let env = null;
+    const apply = (p) => {
+        const d = sunDirection(p.sun);
+        sun.color.set(p.sun.color);
+        sun.intensity = p.sun.intensity;
+        sun.position.set(d[0] * dist, d[1] * dist, d[2] * dist);
+        fill.color.set(p.fill?.color ?? p.hemisphere?.sky ?? "#ffffff");
+        fill.intensity = p.fill?.intensity ?? 0;
+        fill.position.set(-d[0] * dist, Math.max(0.2, d[1] * 0.4) * dist, -d[2] * dist);
+        hemisphere.color.set(p.hemisphere?.sky ?? "#ffffff");
+        hemisphere.groundColor.set(p.hemisphere?.ground ?? "#000000");
+        hemisphere.intensity = p.hemisphere?.intensity ?? 0;
+        ambient.color.set(p.ambient?.color ?? "#ffffff");
+        ambient.intensity = p.ambient?.intensity ?? 0;
+        sky?.dispose();
+        env?.dispose();
+        sky = buildSkyTexture(p.sky);
+        scene.background = sky;
+        if (opts.renderer) {
+            const pmrem = new THREE.PMREMGenerator(opts.renderer);
+            env = pmrem.fromEquirectangular(sky);
+            pmrem.dispose();
+            scene.environment = env.texture;
+            scene.environmentIntensity = p.sky.intensity;
+            opts.renderer.toneMapping = THREE.ACESFilmicToneMapping;
+            opts.renderer.toneMappingExposure = p.exposure ?? 1;
+        }
+        scene.fog = opts.fog !== false && p.fog ? new THREE.Fog(p.fog.color, p.fog.near, p.fog.far) : null;
+    };
+    apply(preset);
+    return {
+        sun,
+        fill,
+        hemisphere,
+        ambient,
+        apply,
+        dispose: () => {
+            for (const l of [sun, sun.target, fill, fill.target, hemisphere, ambient])
+                l.removeFromParent();
+            sky?.dispose();
+            env?.dispose();
+            if (scene.background === sky)
+                scene.background = null;
+            if (env && scene.environment === env.texture)
+                scene.environment = null;
+        },
+    };
+}
+/**
+ * Real three.js lights for a world's placed {@link WorldLight}s, under a preset's groups. Area lights
+ * are skipped (bake-only). For a LIVE scene only — a baked one already has their light.
+ */
+export function createWorldLights(world, preset, opts = {}) {
+    const group = new THREE.Group();
+    group.name = "world-lights";
+    const max = opts.max ?? 8;
+    const candidates = effectiveLights(world, preset)
+        .filter((l) => l.type !== "area")
+        .map((l) => ({ l, i: l.intensity }));
+    const near = opts.near;
+    candidates.sort((a, b) => (near ? dist2(a.l, near) - dist2(b.l, near) : b.i - a.i));
+    for (const { l, i } of candidates.slice(0, max)) {
+        const light = threeLight(l, i);
+        light.castShadow = !!opts.shadows && l.castShadow !== false;
+        group.add(light);
+        if (light.target)
+            group.add(light.target);
+    }
+    return group;
+}
+/** One {@link WorldLight} as a three.js light (an area light is approximated as a point). Intensity already includes the preset. */
+export function threeLight(l, intensity) {
+    const pos = new THREE.Vector3(...l.position);
+    const q = l.rotation ? new THREE.Quaternion(...l.rotation) : new THREE.Quaternion();
+    // A light shines down its local -Y (see WorldLight.rotation): aim targets one metre along it.
+    const aim = new THREE.Vector3(0, -1, 0).applyQuaternion(q).add(pos);
+    let light;
+    if (l.type === "directional") {
+        const d = new THREE.DirectionalLight(l.color, intensity);
+        d.target.position.copy(aim);
+        light = d;
+    }
+    else if (l.type === "spot") {
+        const s = new THREE.SpotLight(l.color, intensity, l.range ?? 0, l.angle ?? Math.PI / 6, l.penumbra ?? 0.2, 2);
+        s.target.position.copy(aim);
+        light = s;
+    }
+    else {
+        light = new THREE.PointLight(l.color, intensity, l.range ?? 0, 2);
+    }
+    light.position.copy(pos);
+    light.name = l.name ?? l.id;
+    light.userData.worldLightId = l.id;
+    return light;
+}
+function dist2(l, p) {
+    const [x, y, z] = l.position;
+    return (x - p.x) ** 2 + (y - p.y) ** 2 + (z - p.z) ** 2;
+}
+//# sourceMappingURL=preset-lighting.js.map

package/dist/three/preset-lighting.js.map

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