lecodes-sdk 0.20.0 → 1.0.0

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

@@ -11,6 +11,19 @@ export declare function openFilePicker(options: OpenFilePickerOptions & {
 /** Anything writable as-is: text, raw bytes, or a buffer the host already holds
  *  (a picked `File`, a `FetchResponse`, a `Canvas.toFile()` snapshot). */
 export type FileData = string | Uint8Array | ArrayBuffer | File | FetchResponse;
+/** One directory entry, as `files.ls` / `files.stat` report it. */
+export type FileEntry = {
+    /** The last path segment. */
+    name: string;
+    /** Relative to the listed directory, `/`-separated — equal to `name` unless the listing was
+     *  recursive. Join it onto the directory you listed to read the file. */
+    path: string;
+    kind: "file" | "dir";
+    /** Bytes; 0 for a directory. */
+    size: number;
+    /** Last modification, ms since the epoch (a `Date` value). */
+    modified: number;
+};
 export declare const files: {
     /** Is there a filesystem here (desktop)? False on web/mobile, where every other call rejects. */
     readonly supported: boolean;
@@ -24,10 +37,20 @@ export declare const files: {
     readBytes(path: string): Promise<Uint8Array | null>;
     /** Delete a file, or a directory (empty, or any directory with `{ recursive: true }`). Deleting
      *  something already gone is success — what's promised is that the path is free afterwards. */
-    delete(path: string, options?: {
+    rm(path: string, options?: {
         recursive?: boolean;
     }): Promise<void>;
     /** Create a directory and any missing parents. An existing directory is fine. */
     mkdir(path: string): Promise<void>;
+    /** The entries of a directory, sorted by path — null when there is no such directory (an empty
+     *  one is `[]`, so `(await files.ls("saves")) ?? []` covers both). `{ recursive: true }` walks
+     *  the subfolders too; each entry's `path` is then relative to the directory listed. A path that
+     *  is a file, not a directory, rejects. Filter in JS — `entries.filter(e => e.name.endsWith(".json"))`. */
+    ls(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<FileEntry[] | null>;
+    /** What is at `path`: a file or a directory entry (`path` equal to `name`), or null when nothing
+     *  is there — `(await files.stat(p)) !== null` is the exists check. */
+    stat(path: string): Promise<FileEntry | null>;
 };
 export {};

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

@@ -8,6 +8,7 @@ export declare const InputChannel: {
     readonly WheelY: 5;
     readonly PointerLocked: 6;
     readonly GamepadCount: 7;
+    readonly PointerOnUI: 8;
     readonly GamepadBase: 16;
     readonly GamepadStride: 16;
     readonly PadConnected: 0;
@@ -64,6 +65,11 @@ export declare const mouse: {
      *  gesture (call it in a 'keydown' handler for MouseLeft); hosts drop it on focus loss and
      *  re-acquire on focus. Escape does NOT unlock by itself on native hosts — call `unlock()`. */
     readonly locked: boolean;
+    /** The primary button went down on a UI element (a button, a scrollable, an input, a modal
+     *  backdrop) and is still held. Stays true wherever the cursor drifts until the release, so
+     *  `if (!Input.mouse.onUI) look(Input.mouse.delta)` never turns a HUD drag into camera look.
+     *  Always false while `locked`. A press that fell through to the scene reads false. */
+    readonly onUI: boolean;
     lock(): boolean;
     unlock(): void;
 };
@@ -108,6 +114,11 @@ export declare const Input: {
          *  gesture (call it in a 'keydown' handler for MouseLeft); hosts drop it on focus loss and
          *  re-acquire on focus. Escape does NOT unlock by itself on native hosts — call `unlock()`. */
         readonly locked: boolean;
+        /** The primary button went down on a UI element (a button, a scrollable, an input, a modal
+         *  backdrop) and is still held. Stays true wherever the cursor drifts until the release, so
+         *  `if (!Input.mouse.onUI) look(Input.mouse.delta)` never turns a HUD drag into camera look.
+         *  Always false while `locked`. A press that fell through to the scene reads false. */
+        readonly onUI: boolean;
         lock(): boolean;
         unlock(): void;
     };

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

@@ -5,10 +5,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 TerrainLayer, type TerrainRegion, type TerrainOptions } from "../gl/Terrain";
+import { type TerrainLayer, type TerrainRegion, type TerrainOptions } from "../gl/terrain/Terrain";
 import { Light, type SunOptions } from "../gl/Light";
 import { type MaterialDef } from "./material";
-import type { CylinderOptions, PlaneOptions, SphereOptions } from "../gl/Geometry";
+import type { CapsuleOptions, CylinderOptions, PlaneOptions, SphereOptions } from "../gl/Geometry";
 export type MeshDef = {
     kind: "box";
     size?: Vec3Like | number;
@@ -17,6 +17,8 @@ export type MeshDef = {
 } & SphereOptions) | ({
     kind: "cylinder";
 } & CylinderOptions) | ({
+    kind: "capsule";
+} & CapsuleOptions) | ({
     kind: "plane";
 } & PlaneOptions);
 export type LightDef = {
@@ -173,6 +175,10 @@ export type SceneLightmapDef = {
      *  ambient cube (2026-08-31) movers shade like the statics and the default is right; it stays as a
      *  trim. See `LightmapLoadOptions.volumeBoost`. */
     volumeBoost?: number;
+    /** Occluder-only statics (props without lightmap UVs): `"baked"` (default) = their shadow is in the
+     *  atlas, they stop casting in real time and the shadow pass draws only the movers; `"realtime"` =
+     *  they keep casting (their shadow on other non-receiver props). See `LightmapLoadOptions.occluderShadows`. */
+    occluderShadows?: "baked" | "realtime";
 };
 /** `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. */
@@ -256,7 +262,8 @@ export type ModelPartRow = {
  *  not parts, skipped. Filtering BEFORE segment math keeps `name[i]` indices stable no matter
  *  what defs are parented in. */
 export declare const modelPartRows: (root: Node) => ModelPartRow[];
-/** The static verdict for one node def (the editor's "Baked lighting" switch shows the same rule). */
+/** The static verdict for one node def (the editor's "Baked lighting" switch shows the same rule).
+ *  Children of a mover are movers too — buildNodes carries that down, this is the node's own verdict. */
 export declare const isLightmapStatic: (def: SceneNodeDef) => boolean;
 /** Edit mode: play the preview pose on a model node (`editor: { clip, time }`) — idempotent, the
  *  harness re-applies it on inspector edits. No clip = back to the rest pose. */

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

@@ -2,6 +2,7 @@ import type { FetchResponse } from "../runtime/fetch";
 import type { SvgSourceValue as SvgSource } from "../runtime/misc";
 import type { File } from "../runtime/fetch";
 import { Canvas } from "../canvas/Canvas";
+import type { Scene2D } from "../g2/Scene2D";
 import { type Color, type ElementStyle, type UIElementBase } from "./UINode";
 export type UIImageStyle = ElementStyle & {
     borderRadius?: number;
@@ -13,12 +14,21 @@ export type UIImageStyle = ElementStyle & {
 export type CanvasImageSource = {
     canvasSurface: number;
 };
-/** Accepted image sources. A Canvas is baked to a surface marker on assign. */
-export type ImageSource = string | FetchResponse | File | SvgSource | Canvas;
-/** The stored/resolved image source (a Canvas is resolved to a surface marker). */
-export type ResolvedImageSource = string | FetchResponse | File | SvgSource | CanvasImageSource;
+/** A live 2D scene as an image source: the host draws the scene into the node's box every frame
+ *  (the scene's camera, projected into the box). No intrinsic size — give the node a width and
+ *  height. */
+export type Scene2DImageSource = {
+    scene2d: number;
+};
+/** Accepted image sources. A Canvas is baked to a surface marker on assign; a Scene2D becomes a
+ *  live-scene marker. */
+export type ImageSource = string | FetchResponse | File | SvgSource | Canvas | Scene2D;
+/** The stored/resolved image source (a Canvas is resolved to a surface marker, a Scene2D to a
+ *  live-scene marker). */
+export type ResolvedImageSource = string | FetchResponse | File | SvgSource | CanvasImageSource | Scene2DImageSource;
 /** An image element. Sources: URL / `asset(...)`, fetch response / File, an SVG source
- *  (`assetIcon`), or a live Canvas (`canvas.update()` refreshes the node in place). */
+ *  (`assetIcon`), a live Canvas (`canvas.update()` refreshes the node in place), or a live Scene2D
+ *  (drawn into the box every frame — a minimap). */
 export interface UIImage extends UIElementBase<UIImageStyle> {
     readonly type: "image";
     /** The image source — writable to swap the picture in place. */