lecodes-sdk 2.4.7 → 2.4.9

package/dist/types/gl/Scene.d.ts

@@ -8,6 +8,7 @@ import { Camera } from "./Camera";
 import { SceneAudio } from "./audio/SceneAudio";
 import { Material } from "./Material";
 import { PostProcessing, type PostProcessingOptions } from "./postProcessing";
+import { ReflectionProbe } from "./ReflectionProbe";
 import { Node } from "./Node";
 /** `SceneOptions.taa` / `scene.setAntialias("taa", 4, taa)`: the temporal anti-aliasing knobs. */
 export type TaaOptions = {
@@ -187,6 +188,26 @@ export declare class Scene implements Presentable {
     get environmentIntensity(): number;
     set environmentIntensity(lux: number);
     private static _warnedEnvIntensity;
+    /**
+     * Light the scene from a live REFLECTION PROBE (ReflectionProbe.ts) — a cube drawn around the probe's position, the
+     * probe riding the car / standing in the room: chrome and glass show what is actually around them, moving objects
+     * included. `null` gives the light back to the scene's own probe (`SceneOptions.ibl`, at `environmentIntensity`;
+     * re-installing it reloads the probe — a switch, not a per-frame call). A probe in no scene yet starts its view in this
+     * one; one already in another scene draws only while that scene is on show.
+     *
+     * Prefiltered (the default), the probe gives the reflections at every roughness — a car body, painted metal blur it as
+     * they should — and the diffuse ambient too (then `environmentIntensity` no longer changes it); it costs a GPU
+     * filtering per completed cube (`ReflectionProbeOptions.prefilter`). `prefilter: false` gives one sharp level:
+     * mirror-like surfaces (roughness near 0) are right, rougher ones read the sharp cube too, and only the reflections
+     * change — the diffuse ambient keeps the scene's own probe's shape at `environmentIntensity`.
+     *
+     * A probe that draws while it lights reads what it writes — fine on OpenGL; a Vulkan backend may want two probes in
+     * turn (a prefiltered probe never does: it lights from the filtered copy). Leave the probe's own carrier out of its view
+     * (`layers`), or the cube is the inside of the car. Warns once on a host without the call.
+     */
+    get environment(): ReflectionProbe | null;
+    set environment(probe: ReflectionProbe | null);
+    private static _warnedEnvTexture;
     /** The scene's stencil buffer on / off (see `SceneOptions.stencil`). */
     setStencil(enabled: boolean): void;
     add(...list: Node[]): this;

package/dist/types/inject.d.ts

@@ -130,6 +130,7 @@ export type { DynamicBoneCurve, DynamicBoneFloor, DynamicBoneColliders } from ".
 export type { IKTwoBone, IKLookAt } from "./gl/animation/IK";
 export { Light } from "./gl/Light";
 export { Lightmap } from "./gl/Lightmap";
+export type { LightmapDef, LightmapFiles, LightmapOptions, LightmapTransmit } from "./gl/Lightmap";
 export { Foliage } from "./gl/Foliage";
 export type { FoliageOptions, FoliageWind } from "./gl/Foliage";
 export { Terrain } from "./gl/terrain/Terrain";
@@ -148,7 +149,11 @@ export type { ScatterPlacement, ScatterOptions } from "./gl/Scatter";
 export type { InstanceTransform } from "./gl/InstancedMesh";
 export { Texture } from "./gl/Texture";
 export type { TextureLoadOptions } from "./gl/Texture";
+export { RenderTexture } from "./gl/RenderTexture";
 export { Camera } from "./gl/Camera";
+export type { CameraOptions, RenderToTextureOptions } from "./gl/Camera";
+export { ReflectionProbe } from "./gl/ReflectionProbe";
+export type { ReflectionProbeOptions } from "./gl/ReflectionProbe";
 export { Ray } from "./gl/Ray";
 export { Plane } from "./gl/Plane";
 export { Noise } from "./gl/Noise";

package/dist/types/scene/defineScene.d.ts

@@ -4,10 +4,10 @@ import { Scene, type SceneOptions } from "../gl/Scene";
 import { Node } from "../gl/Node";
 import { Mesh } from "../gl/Mesh";
 import { Model } from "../gl/Model";
-import { type LightmapTransmit } from "../gl/Lightmap";
+import { type LightmapDef } from "../gl/Lightmap";
 import { type FoliageOptions } from "../gl/Foliage";
 import { type TerrainLayer, type TerrainRegion, type TerrainOptions } from "../gl/terrain/Terrain";
-import { Light, type SunOptions } from "../gl/Light";
+import { Light, type PointOptions, type SpotOptions, type SunOptions } from "../gl/Light";
 import { type MaterialDef } from "./material";
 import type { CapsuleOptions, CylinderOptions, PlaneOptions, SphereOptions } from "../gl/Geometry";
 import { GizmoBuffer } from "./gizmos";
@@ -23,9 +23,16 @@ export type MeshDef = {
 } & CapsuleOptions) | ({
     kind: "plane";
 } & PlaneOptions);
-export type LightDef = {
+/** The `light: {}` source block, by `kind` — `Light.sun` / `Light.point` / `Light.spot` with the node's transform: a
+ *  point light's `bakeArea` panel lies in the node's local XZ plane and emits along its local -Y, so `eulerAngles`
+ *  tilts it; a spot shines along the node's -Z (`direction` aims it, as a sun's does). */
+export type LightDef = ({
     kind: "sun";
-} & SunOptions;
+} & SunOptions) | ({
+    kind: "point";
+} & PointOptions) | ({
+    kind: "spot";
+} & SpotOptions);
 /** A stamp: the terrain conforms to another node of this file (a road) at load — see Terrain.conform. */
 export type TerrainStampDef = {
     /** Path of the node (a Mesh, a Model, or a node holding them) the ground hugs. */
@@ -134,7 +141,7 @@ export type SceneNodeDef = {
      *  `'cube'` = a static whose every mesh bakes as AMBIENT CUBES instead of atlas texels — an occluder (its shadow and
      *  bounce stay in the bake) lit where it stands, the way the bake treats small and thin props on its own: a pipe run, a
      *  fence, a prop whose lightmap seams show. A prefab marked `'cube'` bakes its statics that way too. By name for a whole
-     *  kit: `env.lightmap.cube`. */
+     *  kit: the `cube` option of `env.lightmap`'s `bake()`. */
     lightmap?: boolean | "cube";
     /** `model` nodes: vegetation — load through the FOLIAGE tier (wind, touch bending, per-copy tint; see
      *  `Foliage`). `{ fade: [start, end] }` also thins the cards out over that distance range (m) and drops the
@@ -156,54 +163,6 @@ export type SceneCameraDef = CameraProjectionDef & {
     /** Point the camera looks at. */
     target?: Vec3Like;
 };
-/** `env.lightmap` — the level's baked lighting (engines/bake): the files `lecodes lightmap bake`
- *  writes. Absent = real-time only. */
-export type SceneLightmapDef = {
-    /** `asset('./assets/lightmap/level.bake')` */
-    data: string;
-    /** `asset('./assets/lightmap/level-light.ktx2')` — or, for a bake that took more than one atlas PAGE
-     *  (`lecodes lightmap bake --pages`), every page in order: `[asset('x-light.ktx2'), asset('x-light_1.ktx2')]`. */
-    light: string | string[];
-    /** `asset('./assets/lightmap/level-aux.ktx2')` (pages like `light`) — sun / sky visibility + light direction. */
-    aux: string | string[];
-    /** DEBUG: the page sets a `lecodes lightmap bake --split` wrote (`<stem>-direct[_n].ktx2`, `<stem>-indirect[_n].ktx2`),
-     *  pages like `light` — the `Lightmap.debug("direct" | "indirect")` views bind them in place of `light`. */
-    direct?: string | string[];
-    indirect?: string | string[];
-    /** `asset('./assets/lightmap/level-probes.ktx2')` — the bake's reflection probes (one prefiltered cubemap of the level's
-     *  radiance per probe; every static reflects the nearest). Absent = statics reflect the sky's SH alone. */
-    probes?: string;
-    /** FOR THE BAKE: the radiance in cd / m² of emission 1.0 on this level (emissive factor x strength x map) - every lit
-     *  region of an emissive surface bakes as a rectangle lamp. An imported pack's emission is a LOOK (the school's panels
-     *  say 10); this is where the level says what they give: a 1.3 m ceiling panel of ~8000 lm is ~1600 nits. Default: what
-     *  the camera makes of 1.0 (`1.2 x 2^EV100`). 0 = emissive surfaces light nothing. `--emissive-nits` overrides. */
-    emissiveNits?: number;
-    /** `false` = the emissive surfaces light nothing in the bake - the level is lit by its lamps (`Light.point` with a
-     *  `bakeArea` next to every panel, the Unity packs' way) and the panels are decoration; `emissiveNits` then only says how
-     *  bright their glow is DRAWN (scene-referred: nits through the camera's exposure). Default true. */
-    emissiveBake?: boolean;
-    /** FOR THE BAKE: materials that let light THROUGH them, by glTF material name (`"name*"` = every name with that start) →
-     *  the share of a shadow ray that passes, tinted by the material's base colour x map: `{ mat_awning: 0.3 }` puts the
-     *  awning's warm, patterned light on the sand. The surface stays opaque - baked, drawn as before, a shadow caster.
-     *  `{ through, diffuse }` splits it: `through` goes straight (the picture of the map), `diffuse` is scattered by the
-     *  fibres (the underside glows, a soft fill with no picture) - dense canvas: `{ through: 0.08, diffuse: 0.25 }`. */
-    transmit?: Record<string, LightmapTransmit>;
-    /** FOR THE BAKE: CUBES BY NAME — regular expressions (ECMAScript, case-sensitive) searched in every baked mesh's key
-     *  (`<node path>@<ordinal>`): `['SM_pipe', 'SM_fence']` bakes every pipe and fence node as ambient cubes instead of atlas
-     *  texels, like a node's `lightmap: 'cube'`. The CLI's `--cube` adds to these. */
-    cube?: string[];
-    /** `asset('./assets/lightmap/level.lgrid')` — THE LIGHT GRID for movers: every node a Physics aspect or a
-     *  CharacterController moves (and what code marks with `Lightmap.track`) takes its ambient light from the bake at the
-     *  place it is at, whatever its shader. Absent = movers keep the scene's IBL. */
-    volume?: string;
-    /** `asset('./assets/lightmap/level-uv1.bin')` — THE PACKED LIGHTMAP UV1 the bake's rects map: it packs every mesh's
-     *  lightmap charts into a square of their own instead of the unwrap's (once per mesh, whatever model holds it), and the
-     *  engine swaps this into the models' TEXCOORD_1 before the rects go on. Required when the bake wrote one (the .bake's `uv1`): without it the statics
-     *  read the wrong texels, so the bake is not applied. */
-    uv1?: string;
-    /** A DEBUG multiplier on the atlas' lux (default 1). */
-    lightScale?: number;
-};
 /** `env.navmesh` — the level's navigation mesh (see navmesh.md): the file `lecodes navmesh bake`
  *  writes, the agent size it is built for, and the named areas. Absent = no navigation. */
 export type SceneNavmeshDef = {
@@ -220,8 +179,10 @@ export type SceneNavmeshDef = {
     areas?: Record<string, number>;
 };
 export type SceneDef = {
+    /** `lightmap` = the level's baked lighting (engines/bake): `bake('./assets/lightmap/level.bake', { …options })`, the
+     *  macro that reads the bake's manifest at compile time (`LightmapDef`). Absent = real-time only. */
     env?: SceneOptions & {
-        lightmap?: SceneLightmapDef;
+        lightmap?: LightmapDef;
         navmesh?: SceneNavmeshDef;
         foliage?: FoliageOptions;
     };

package/dist/types/ui/tree.d.ts

@@ -72,5 +72,6 @@ export declare const OWNED_KIND_ENTITY_2D = 5;
 export declare const OWNED_KIND_MEDIA = 6;
 export declare const OWNED_KIND_TWEEN = 7;
 export declare const OWNED_KIND_CANVAS = 8;
+export declare const OWNED_KIND_GL_RENDER_VIEW = 9;
 import { DEAD_HANDLE } from "../core/pins";
 export { DEAD_HANDLE };

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "2.4.7";
+export declare const SDK_VERSION = "2.4.9";
 /** The major of a semver string, or null when it is not one. */
 export declare const sdkMajor: (version: string | null | undefined) => number | null;
 /** The `// sdk: <version>` line of a compiled bundle's header (sdk/src/compile/header.ts), read from