lecodes-sdk 2.4.4 → 2.4.6

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

@@ -1,5 +1,5 @@
 import { type ColorInput } from "../core/color";
-import type { Vec3Like } from "../math/vec";
+import { Vec3, type Vec3Like } from "../math/vec";
 import { Node, type NodeTweenProps } from "./Node";
 import { type TweenMeta } from "../animate/tween/spec";
 import type { Animation } from "../animate/tween/Animation";
@@ -9,7 +9,10 @@ export type LightTweenProps = NodeTweenProps & {
     color?: ColorInput | ColorInput[];
 };
 export type SunOptions = {
-    /** Light direction (points where the light travels). Defaults to a typical key-light angle. */
+    /**
+     * Where the light travels (pointing down for a sun above the scene) - it sets the node's rotation, so it stays live
+     * as `light.direction` and turns with the node. Defaults to a typical key-light angle.
+     */
     direction?: Vec3Like;
     /** Luminous intensity. */
     intensity?: number;
@@ -125,8 +128,12 @@ export declare class Light extends Node {
     destroy(): void;
     set color(value: ColorInput);
     get color(): ColorInput;
-    /** Sun direction as created (the engine keeps it; a settings menu rebuilds a sun from it). */
-    get direction(): [number, number, number];
+    /**
+     * Where a sun's or a spot's light travels now, in world space (unit length): the node's forward (-Z). Writing it
+     * turns the node - live, the shadows follow; a parent's rotation is taken into account. A zero vector is ignored.
+     */
+    get direction(): Vec3;
+    set direction(value: Vec3Like);
     /** Sun shadow options as created — creation-time in the engine, so a change means a new sun. */
     get shadowsQuality(): number;
     get shadowDistance(): number;

package/dist/types/runtime/app.d.ts

@@ -80,6 +80,20 @@ export declare const app: {
      *  screen); a standalone-built app leaves to the platform instead — Android backgrounds it,
      *  iOS ignores the call (the platform forbids programmatic exit). */
     quit(): void;
+    /** Collect garbage now: what the app no longer references — a finished level's nodes, its
+     *  textures and materials — is freed before this returns, not whenever the collector next runs.
+     *  Call it where a pause is invisible (a loading screen, between levels), after dropping the
+     *  references; never during play — a collection walks the whole heap. It also puts the next
+     *  automatic collection at half again the heap it leaves: the room the next stretch of play has.
+     *  `headroomMB` asks for more room when the play ahead allocates more than that — a drive that
+     *  streams in hundreds of megabytes of terrain buffers: `app.gc({ headroomMB: 512 })` keeps the
+     *  next collection at least 512 MB away (until it comes; then the engine's rule again). The log's
+     *  `[gc]` line says what it took, what it freed and where the next one is. On iOS a request the
+     *  engine serves on its own schedule, without the headroom; a no-op in the browser, where a page
+     *  cannot ask for a collection. */
+    gc(options?: {
+        headroomMB?: number;
+    }): void;
     /** Global back-press fallback (Android back button/gesture — iOS has no system back). Fires
      *  only when nothing else consumed the press: no open widget/modal claimed it, the current
      *  screen has no `onBack`, every pager is at its tab root and the router is at its

package/dist/types/version.d.ts

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