lecodes-sdk 2.4.6 → 2.4.7

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

@@ -18,6 +18,11 @@ export type LightmapLoadOptions = {
      *  `{ through, diffuse }` adds the share the fibres SCATTER - the cloth's underside glows like a matte panel and lights
      *  what is under it by the solid angle it fills, 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 record's key
+     *  (`<node key>@<ordinal>`: `"SM_pipe"` takes every pipe node, `"@1$"` the second mesh of each): a record that matches
+     *  leaves the atlas like a small or thin one — an occluder lit by ambient cubes baked where it stands — whatever its size
+     *  or charts. Added to the CLI's `--cube` patterns (both apply). */
+    cube?: string[];
 };
 /** one `transmit` entry (LightmapLoadOptions.transmit): the straight share, or both shares */
 export type LightmapTransmit = number | {
@@ -49,6 +54,10 @@ export type LightmapFiles = {
     /** THE LIGHT GRID for movers (`<stem>.lgrid`, `lecodes lightmap bake --volume`): the baked ambient light of every
      *  place a mover can be. Absent = movers keep the scene's IBL. */
     volume?: string;
+    /** THE PACKED LIGHTMAP UV1 (`<stem>-uv1.bin`, the .bake's `uv1`): the bake packs every mesh's lightmap charts into a
+     *  square of their own and its rects map that uv1 — the engine swaps it into the models' TEXCOORD_1 first. Required
+     *  when the bake names one. */
+    uv1?: string;
 };
 /** The lightmap material's data views (`Lightmap.debug`); "direct" / "indirect" bind a `--split` bake's pages instead. */
 export type LightmapDebugMode = "off" | "irradiance" | "albedo" | "normal" | "shadingNormal" | "share" | "skyVis" | "atlas" | "direction" | "lux" | "relief" | "direct" | "indirect" | "probe" | "probeMap" | "skyPath" | "probePath";
@@ -69,6 +78,14 @@ export type LightmapProbe = {
     world: [number, number, number];
     distance: number;
 };
+/** `Lightmap.add`'s options */
+export type LightmapAddOptions = {
+    /** Bake it as AMBIENT CUBES instead of atlas texels: an occluder (its shadow and bounce stay in the atlas) whose own
+     *  light is baked where it stands — the way the bake treats small and thin objects (`--min-texels`, `--thin-texels`),
+     *  here by hand: a pipe run, a fence, a prop whose charts show their seams. A long one takes a slab of cubes per metre
+     *  (`--object-slab`). Default false. */
+    cube?: boolean;
+};
 export declare class Lightmap {
     /** True while `lecodes lightmap bake` runs the app — skip menus and build the scene straight away. */
     static get baking(): boolean;
@@ -81,8 +98,8 @@ export declare class Lightmap {
      *  both receivers and occluders in the bake (a model without lightmap UVs, or with materials the lightmap shader
      *  declines — alpha cards — is an occluder alone; a terrain is ONE rect, built with `Material.terrainLightmap()`).
      *  `key` names the entry in the .bake (default: the node's name + a running number, `container#3`); pass one when
-     *  names are not stable. */
-    static add(node: Node, key?: string): Node;
+     *  names are not stable. `{ cube: true }` bakes it as ambient cubes instead of atlas texels (`LightmapAddOptions`). */
+    static add(node: Node, key?: string, options?: LightmapAddOptions): Node;
     private static next;
     private static movers;
     private static volumeOn;
@@ -93,6 +110,10 @@ export declare class Lightmap {
      *  the subtree back to the scene's IBL. Safe before the level's bake has loaded. */
     static track(node: Node, on?: boolean): void;
     private static loadVolume;
+    /** THE PACKED UV1 the bake's rects map (the .bake's `uv1`), into the host BEFORE any rect is applied: the host swaps it
+     *  into the models' TEXCOORD_1 as their rects go on. A bake without one clears the last (the models' own uv1 back).
+     *  False = the bake needs it and it cannot be had - its rects would read the wrong texels. */
+    private static loadUv1;
     /** Forget every registration (a scene rebuild). */
     static clear(): void;
     /** THE MOVERS' SUN SHADOWS ON THE BAKED STATICS (a bot, a barrel, the player's rifle darkening the ground under
@@ -110,8 +131,8 @@ export declare class Lightmap {
      *  applied (no bake yet, a host without the feature, bake mode). */
     private static scene;
     static load(scene: Scene, files: LightmapFiles, options?: LightmapLoadOptions): Promise<LightmapInfo | null>;
-    /** The bake's `<key>#k` instances by their base key: the parts of a GLB unwrapped in groups (k = extras.lightmapGroup). */
-    private static groupsOf;
+    /** The bake's `<key>@k` records by their node key: a model's meshes (k = the primitive's ordinal in its file). */
+    private static recordsOf;
     /** Switch every lightmapped surface to a DATA view (or back with `"off"` / 0). Level-wide, instant —
      *  except "direct" / "indirect", which load that page set the first time (a `--split` bake listed in the scene). */
     static debug(mode: LightmapDebugMode | number, params?: LightmapDebugParams): void;

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

@@ -12,8 +12,8 @@ export interface TrianglePick {
     mesh: string;
     primitive: number;
     material: string;
-    /** the node's lightmap group (scene-file extras), when it has one */
-    lightmapGroup?: number;
+    /** the primitive's index over its file's meshes: the lightmap bake's record `<key>@<ordinal>` */
+    lightmapOrdinal: number;
     /** triangle index within the primitive (index-buffer order), and whether the ray came from behind */
     triangle: number;
     backface: boolean;
@@ -83,8 +83,8 @@ export declare class Model extends Node {
             total?: number;
         }) => void;
         /** Baked lighting (engines/bake). `true` = a STATIC: loads through the lightmap material so
-         *  `Lightmap.load` can bind its atlas rect (the GLB needs TEXCOORD_1 — `lecodes assets doctor
-         *  --lightmap-uv`) and takes nothing from the real-time lights once the bake applies. Omitted / `false` =
+         *  `Lightmap.load` can bind its atlas rect (the GLB needs TEXCOORD_1 —
+         *  `lecodes assets unwrap`, which `lightmap bake` runs itself on raw GLBs) and takes nothing from the real-time lights once the bake applies. Omitted / `false` =
          *  the standard shader, lit real-time (movers). Hosts without lightmap support ignore it. */
         lightmap?: boolean;
         /** Vegetation: load through the FOLIAGE tier (see `Foliage`) — wind, touch bending, distance fade,

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

@@ -130,8 +130,12 @@ export type SceneNodeDef = {
     /** Baked lighting (a scene with `env.lightmap`): is this model/mesh node a lightmap STATIC — a
      *  receiver and an occluder in the bake, real-time shadow casting off once the bake applies?
      *  Default: static unless a `Physics` aspect moves the node (`dynamic` — Physics' default — or
-     *  `kinematic`). Set it only to override that rule; prefab subtrees inherit the verdict. */
-    lightmap?: boolean;
+     *  `kinematic`). Set it only to override that rule; prefab subtrees inherit the verdict.
+     *  `'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`. */
+    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
      *  copy past `end` — for ground cover. The fade is per ASSET: every node of the same GLB shares it. */
@@ -184,10 +188,19 @@ export type SceneLightmapDef = {
      *  `{ 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;
 };

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "2.4.6";
+export declare const SDK_VERSION = "2.4.7";
 /** 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