lecodes-sdk 0.20.2 → 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/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. */