reze-engine 0.10.0 → 0.10.2

package/README.md

@@ -2,6 +2,8 @@
 
 A minimal-dependency WebGPU engine for real-time MMD/PMX rendering. Only external dependency is Ammo.js for physics.
 
+![screenshot](./screenshot.png)
+
 ## Install
 
 ```bash
@@ -14,80 +16,146 @@ npm install reze-engine
 - VMD animation with IK solver and Bullet physics
 - Orbit camera with bone-follow mode
 - GPU picking (double-click/tap)
-- Ground plane with PCF shadow mapping, grid lines, and frosted texture
+- Ground plane with PCF shadow mapping
 - Multi-model support
 
-## Quick Start
+## Usage
 
 ```javascript
-import { Engine, Vec3 } from "reze-engine"
+import { Engine, Vec3 } from "reze-engine";
 
 const engine = new Engine(canvas, {
   ambientColor: new Vec3(0.88, 0.92, 0.99),
   cameraDistance: 31.5, // MMD units (1 unit = 8 cm)
-})
-await engine.init()
-
-const model = await engine.loadModel("hero", "/models/hero/hero.pmx")
-await model.loadAnimation("idle", "/animations/idle.vmd")
-model.show("idle")
-model.play()
-
-engine.setCameraFollow(model, "センター", new Vec3(0, 3.5, 0))
-engine.addGround({ width: 160, height: 160 })
-engine.runRenderLoop()
+  cameraTarget: new Vec3(0, 11.5, 0),
+});
+await engine.init();
+
+const model = await engine.loadModel("hero", "/models/hero/hero.pmx");
+await model.loadVmd("idle", "/animations/idle.vmd");
+model.show("idle");
+model.play();
+
+engine.setCameraFollow(model, "センター", new Vec3(0, 3.5, 0));
+engine.addGround({ width: 160, height: 160 });
+engine.runRenderLoop();
 ```
 
 ## API
 
+One WebGPU **Engine** per page (singleton after `init()`). Load models via URL **or** from a user-selected folder (see [Local folder uploads](#local-folder-uploads-browser)).
+
 ### Engine
 
-| Method | Description |
-|--------|-------------|
-| `new Engine(canvas, options?)` | Create engine with optional config |
-| `engine.init()` | Initialize WebGPU device and context |
-| `engine.loadModel(path)` | Load PMX model (auto-named) |
-| `engine.loadModel(name, path)` | Load PMX model with name |
-| `engine.getModel(name)` | Get model by name |
-| `engine.getModelNames()` | List all model names |
-| `engine.removeModel(name)` | Remove model |
-| `engine.setMaterialVisible(model, mat, visible)` | Show/hide material |
-| `engine.toggleMaterialVisible(model, mat)` | Toggle material visibility |
-| `engine.setIKEnabled(enabled)` | Enable/disable IK globally |
-| `engine.setPhysicsEnabled(enabled)` | Enable/disable physics globally |
-| `engine.setCameraFollow(model, bone?, offset?)` | Orbit center tracks a bone |
-| `engine.setCameraTarget(vec3)` | Static camera target |
-| `engine.setCameraDistance(d)` | Set orbit radius |
-| `engine.setCameraAlpha(a)` | Set horizontal orbit angle |
-| `engine.setCameraBeta(b)` | Set vertical orbit angle |
-| `engine.addGround(options?)` | Add ground plane with shadows |
-| `engine.runRenderLoop(callback?)` | Start render loop |
-| `engine.stopRenderLoop()` | Stop render loop |
-| `engine.getStats()` | Returns `{ fps, frameTime }` |
-| `engine.dispose()` | Clean up all resources |
+```javascript
+engine.init()
+engine.loadModel(name, path)
+engine.loadModel(name, { files, pmxFile? })  // folder upload — see below
+engine.getModel(name)
+engine.getModelNames()
+engine.removeModel(name)
+
+engine.setMaterialVisible(name, material, visible)
+engine.toggleMaterialVisible(name, material)
+engine.isMaterialVisible(name, material)
+
+engine.setIKEnabled(enabled)
+engine.setPhysicsEnabled(enabled)
+
+engine.setCameraFollow(model, bone?, offset?)
+engine.setCameraFollow(null)
+engine.setCameraTarget(vec3)
+engine.setCameraDistance(d)
+engine.setCameraAlpha(a)
+engine.setCameraBeta(b)
+
+engine.addGround(options?)
+engine.runRenderLoop(callback?)
+engine.stopRenderLoop()
+engine.getStats()
+engine.dispose()
+```
+
+### Local folder uploads (browser)
+
+Use a hidden `<input type="file" webkitdirectory multiple>` (or drag/drop) and pass the resulting `FileList` or `File[]` into the engine. Textures resolve relative to the chosen PMX file inside that tree.
+
+**Important:** read `input.files` into a normal array **before** setting `input.value = ""`. The browser’s `FileList` is *live* — clearing the input empties it.
+
+1. **`parsePmxFolderInput(fileList)`** — returns a tagged result (`empty` | `not_directory` | `no_pmx` | `single` | `multiple`). For `single`, you already have `files` and `pmxFile`. For `multiple`, show a picker (dropdown) of `pmxRelativePaths`, then resolve with **`pmxFileAtRelativePath(files, path)`**.
+2. **`engine.loadModel(name, { files, pmxFile })`** — `pmxFile` selects which `.pmx` when the folder contains several.
+
+```javascript
+import { Engine, parsePmxFolderInput, pmxFileAtRelativePath } from "reze-engine";
+
+// In <input onChange>:
+const picked = parsePmxFolderInput(e.target.files);
+e.target.value = "";
+
+if (picked.status === "single") {
+  const model = await engine.loadModel("myModel", {
+    files: picked.files,
+    pmxFile: picked.pmxFile,
+  });
+}
+
+if (picked.status === "multiple") {
+  // Let the user choose `chosenPath` from picked.pmxRelativePaths, then:
+  const pmxFile = pmxFileAtRelativePath(picked.files, chosenPath);
+  const model = await engine.loadModel("myModel", { files: picked.files, pmxFile });
+}
+```
+
+VMD and other assets still load by URL when the path starts with `/` or `http(s):`; relative paths are resolved against the PMX directory inside the upload.
 
 ### Model
 
-| Method | Description |
-|--------|-------------|
-| `model.loadAnimation(name, url)` | Load VMD animation |
-| `model.loadAnimation(name, clip)` | Load/replace animation clip directly |
-| `model.show(name)` | Set pose at time 0 (resets bones and morphs first) |
-| `model.play(name?)` | Play animation (queued if busy; named play resets bones/morphs first) |
-| `model.play(name, { priority?, loop? })` | Priority-aware play; `loop` wraps at end (`0` default/lowest priority) |
-| `model.pause()` | Pause playback |
-| `model.stop()` | Stop playback |
-| `model.seek(time)` | Seek to time |
-| `model.getAnimationProgress()` | `{ current, duration, percentage, animationName, looping, playing, paused }` — `current`/`duration` are seconds |
-| `model.getAnimationClip(name)` | Get loaded clip by name |
-| `model.rotateBones(rotations, ms?)` | Tween bone rotations |
-| `model.moveBones(translations, ms?)` | Tween bone translations |
-| `model.setMorphWeight(name, weight, ms?)` | Tween morph weight |
-| `model.resetAllBones()` | Reset to bind pose |
-| `model.resetAllMorphs()` | Reset all morph weights |
-| `model.getBoneWorldPosition(name)` | World position of bone |
-
-`AnimationClip` is frame-based: `frameCount` is the last keyframe frame index, keyframes store `frame`. Engine playback uses fixed 30 FPS. Looping is controlled via `play(name, { loop: true })`, not on the clip.
+```javascript
+await model.loadVmd(name, url)
+model.loadClip(name, clip)
+model.show(name)
+model.play(name)
+model.play(name, { priority: 8 }) // higher number = higher priority (0 default/lowest)
+model.play(name, { loop: true }) // repeat until stop/pause or another play
+model.pause()
+model.stop()
+model.seek(time)
+model.getAnimationProgress()
+model.getClip(name)
+model.exportVmd(name)              // returns ArrayBuffer
+
+model.rotateBones({ 首: quat, 頭: quat }, ms?)
+model.moveBones({ センター: vec3 }, ms?)
+model.setMorphWeight(name, weight, ms?)
+model.resetAllBones()
+model.resetAllMorphs()
+model.getBoneWorldPosition(name)
+```
+
+#### Animation data
+
+`AnimationClip` holds keyframes only: bone/morph tracks keyed by `frame`, and `frameCount` (last keyframe index). Time advances at fixed `FPS` (see package export `FPS`, default 30).
+
+#### VMD Export
+
+`model.exportVmd(name)` serialises a loaded clip back to the VMD binary format and returns an `ArrayBuffer`. Bone and morph names are Shift-JIS encoded for compatibility with standard MMD tools.
+
+```javascript
+const buffer = model.exportVmd("idle");
+const blob = new Blob([buffer], { type: "application/octet-stream" });
+const link = document.createElement("a");
+link.href = URL.createObjectURL(blob);
+link.download = "idle.vmd";
+link.click();
+```
+
+#### Playback
+
+Call `model.play(name, options?)` to start or switch motion. `loop: true` makes the playhead wrap at the end of the clip until you stop, pause, or call `play` with something else. `priority` chooses which request wins when several clips compete.
+
+#### Progress
+
+`getAnimationProgress()` reports `current` and `duration` in seconds, plus `playing`, `paused`, `looping`, and related fields.
 
 ### Engine Options
 
@@ -112,27 +180,9 @@ engine.runRenderLoop()
 
 `constraintSolverKeywords` — joints whose name contains any keyword use the Bullet 2.75 constraint solver; all others keep the stable Ammo 2.82+ default. See [babylon-mmd: Fix Constraint Behavior](https://noname0310.github.io/babylon-mmd/docs/reference/runtime/apply-physics-to-mmd-models/#fix-constraint-behavior) for details.
 
-### Ground Options
-
-```javascript
-engine.addGround({
-  width: 100,            // ground plane width
-  height: 100,           // ground plane depth
-  diffuseColor: Vec3,    // base color (default: 0.8, 0.1, 1.0)
-  fadeStart: 5.0,        // distance where edge fade begins
-  fadeEnd: 60.0,         // distance where ground fully fades out
-  shadowMapSize: 4096,   // shadow map resolution
-  shadowStrength: 1.0,   // shadow darkness
-  gridSpacing: 5.0,      // world-space distance between grid lines
-  gridLineWidth: 0.012,  // thickness of grid lines
-  gridLineOpacity: 0.4,  // grid line visibility (0–1)
-  gridLineColor: Vec3,   // grid line color (default: 0.8, 0.8, 0.8)
-  noiseStrength: 0.08,   // frosted/matte micro-texture intensity
-})
-```
-
 ## Projects Using This Engine
 
+- **[Reze Studio](https://reze.studio)** - Web-native MMD animation editor
 - **[MiKaPo](https://mikapo.vercel.app)** — Real-time motion capture for MMD
 - **[Popo](https://popo.love)** — LLM-generated MMD poses
 - **[MPL](https://mmd-mpl.vercel.app)** — Motion programming language for MMD

package/dist/asset-reader.d.ts

@@ -0,0 +1,16 @@
+/** Unified binary I/O for PMX/VMD/textures: HTTP(s) or user folder (File map). */
+export type AssetReader = {
+    readBinary(logicalPath: string): Promise<ArrayBuffer>;
+};
+/** Normalize PMX-style paths: backslashes, trim, strip leading ./ */
+export declare function normalizeAssetPath(p: string): string;
+/** Join PMX directory prefix and texture-relative path (both may be ""). */
+export declare function joinAssetPath(baseDir: string, relative: string): string;
+/** Same rules as the original engine string split: supports absolute site paths like `/models/a/b.pmx`. */
+export declare function deriveBasePathFromPmxPath(pmxPath: string): string;
+export declare function createFetchAssetReader(): AssetReader;
+/** Keys must be normalized paths relative to the selected folder root (see fileListToMap). */
+export declare function createFileMapAssetReader(files: Map<string, File>): AssetReader;
+export declare function fileListToMap(files: FileList | File[]): Map<string, File>;
+export declare function findFirstPmxFileInList(files: FileList | File[]): File | null;
+//# sourceMappingURL=asset-reader.d.ts.map

package/dist/asset-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-reader.d.ts","sourceRoot":"","sources":["../src/asset-reader.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACtD,CAAA;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,2GAA2G;AAC3G,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAQpD;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,WAAW,CAkB9E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAOzE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAS5E"}

package/dist/asset-reader.js

@@ -0,0 +1,74 @@
+/** Unified binary I/O for PMX/VMD/textures: HTTP(s) or user folder (File map). */
+/** Normalize PMX-style paths: backslashes, trim, strip leading ./ */
+export function normalizeAssetPath(p) {
+    let s = p.replace(/\\/g, "/").trim();
+    if (s.startsWith("./"))
+        s = s.slice(2);
+    return s;
+}
+/** Join PMX directory prefix and texture-relative path (both may be ""). */
+export function joinAssetPath(baseDir, relative) {
+    const rel = normalizeAssetPath(relative);
+    if (!rel)
+        return normalizeAssetPath(baseDir);
+    const base = baseDir.endsWith("/") ? baseDir.slice(0, -1) : baseDir;
+    if (!base)
+        return rel;
+    return `${base}/${rel}`;
+}
+/** Same rules as the original engine string split: supports absolute site paths like `/models/a/b.pmx`. */
+export function deriveBasePathFromPmxPath(pmxPath) {
+    const pathParts = pmxPath.replace(/\\/g, "/").split("/");
+    pathParts.pop();
+    return pathParts.join("/") + (pathParts.length > 0 ? "/" : "");
+}
+export function createFetchAssetReader() {
+    return {
+        async readBinary(logicalPath) {
+            const r = await fetch(logicalPath);
+            if (!r.ok)
+                throw new Error(`Failed to fetch ${logicalPath}: ${r.status} ${r.statusText}`);
+            return r.arrayBuffer();
+        },
+    };
+}
+/** Keys must be normalized paths relative to the selected folder root (see fileListToMap). */
+export function createFileMapAssetReader(files) {
+    return {
+        async readBinary(logicalPath) {
+            const key = normalizeAssetPath(logicalPath);
+            let file = files.get(key);
+            if (!file) {
+                const lower = key.toLowerCase();
+                for (const [k, f] of files) {
+                    if (k.toLowerCase() === lower) {
+                        file = f;
+                        break;
+                    }
+                }
+            }
+            if (!file)
+                throw new Error(`Missing file in folder: ${key}`);
+            return file.arrayBuffer();
+        },
+    };
+}
+export function fileListToMap(files) {
+    const m = new Map();
+    for (const f of Array.from(files)) {
+        const rel = f.webkitRelativePath ?? f.name;
+        m.set(normalizeAssetPath(rel), f);
+    }
+    return m;
+}
+export function findFirstPmxFileInList(files) {
+    const list = Array.from(files).filter((f) => f.name.toLowerCase().endsWith(".pmx"));
+    if (list.length === 0)
+        return null;
+    list.sort((a, b) => {
+        const pa = a.webkitRelativePath ?? a.name;
+        const pb = b.webkitRelativePath ?? b.name;
+        return pa.localeCompare(pb);
+    });
+    return list[0] ?? null;
+}

package/dist/engine.d.ts

@@ -1,7 +1,13 @@
 import { Vec3 } from "./math";
 import { Model } from "./model";
 import { type PhysicsOptions } from "./physics";
+import { type AssetReader } from "./asset-reader";
 export type RaycastCallback = (modelName: string, material: string | null, screenX: number, screenY: number) => void;
+/** Select a folder (webkitdirectory) and pass FileList or File[]; pmxFile picks which .pmx when several exist. */
+export type LoadModelFromFilesOptions = {
+    files: FileList | File[];
+    pmxFile?: File;
+};
 export type EngineOptions = {
     ambientColor?: Vec3;
     directionalLightIntensity?: number;
@@ -154,7 +160,8 @@ export declare class Engine {
     dispose(): void;
     loadModel(path: string): Promise<Model>;
     loadModel(name: string, path: string): Promise<Model>;
-    addModel(model: Model, pmxPath: string, name?: string): Promise<string>;
+    loadModel(name: string, options: LoadModelFromFilesOptions): Promise<Model>;
+    addModel(model: Model, pmxPath: string, name?: string, assetReader?: AssetReader): Promise<string>;
     removeModel(name: string): void;
     getModelNames(): string[];
     getModel(name: string): Model | null;
@@ -178,7 +185,7 @@ export declare class Engine {
     private createMaterialUniformBuffer;
     private createUniformBuffer;
     private shouldRenderDrawCall;
-    private createTextureFromPath;
+    private createTextureFromLogicalPath;
     private renderGround;
     private handleCanvasDoubleClick;
     private handleCanvasTouch;

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,IAAI,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/B,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEpH,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,oBAAoB,CAAC,EAAE,IAAI,CAAA;CAC5B,CAAA;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAWlC,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB;AA2CD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAE7C,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,kBAAkB,CAAmB;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,oBAAoB,CAAoB;IAChD,OAAO,CAAC,2BAA2B,CAAqB;IACxD,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,2BAA2B,CAAqB;IACxD,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,iBAAiB,CAAe;IACxC,OAAO,CAAC,wBAAwB,CAAe;IAC/C,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAI;IAC7C,OAAO,CAAC,oBAAoB,CAA0B;IAGtD,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,oBAAoB,CAAS;IAErC,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,kBAAkB,CAAC,CAAW;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAW;IACrC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,gBAAgB,CAAC,CAAY;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAgB;IAC3C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,qBAAqB,CAAC,CAAc;IAC5C,OAAO,CAAC,uBAAuB,CAAa;IAC5C,OAAO,CAAC,0BAA0B,CAAC,CAAW;IAC9C,OAAO,CAAC,cAAc,CAAwB;IAE9C,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,cAAc,CAAwD;IAC9E,OAAO,CAAC,oBAAoB,CAAoD;IAChF,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAM;IAEvC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,2BAA2B,CAAqB;IACxD,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,8BAA8B,CAAqB;IAC3D,OAAO,CAAC,qBAAqB,CAAe;IAC5C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,WAAW,CAAwC;IAE3D,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,mBAAmB,CAAI;IAG/B,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,cAAc,CAAO;IAG7B,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,qBAAqB,CAAI;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,KAAK,CAGZ;IACD,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,kBAAkB,CAA4B;gBAE1C,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,aAAa;IAkBxD,IAAI;IA6BV,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,eAAe;IAumBvB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,YAAY;IAwEpB,OAAO,CAAC,WAAW;IAanB,iFAAiF;IACjF,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI;IAC9B,gGAAgG;IAChG,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI;IAoB3E,mIAAmI;IACnI,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI;IAY5E,iBAAiB,IAAI,MAAM;IAC3B,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAClC,cAAc,IAAI,MAAM;IACxB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAC/B,aAAa,IAAI,MAAM;IACvB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAG9B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,QAAQ;IAmBhB,SAAS,CAAC,OAAO,CAAC,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,YAAY,CAAC,EAAE,IAAI,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,aAAa,CAAC,EAAE,IAAI,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,GAAG,IAAI;IA4BR,OAAO,CAAC,iBAAiB;IAIzB,QAAQ,IAAI,WAAW;IAIvB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI;IAgBnC,cAAc;IAQd,OAAO;IAkBD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAUrD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,aAAa,IAAI,MAAM,EAAE;IAIzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAIpC,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAe9D,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAOnF,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOpE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAKnE,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIpC,YAAY,IAAI,OAAO;IAIvB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC,iBAAiB,IAAI,OAAO;IAI5B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,kBAAkB;YAOZ,kBAAkB;IA0GhC,OAAO,CAAC,oBAAoB;IAwE5B,OAAO,CAAC,2BAA2B;IA2CnC,OAAO,CAAC,kBAAkB,CAAO;IACjC,OAAO,CAAC,mBAAmB;YAeb,yBAAyB;IAsFvC,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,oBAAoB;YAId,qBAAqB;IAmCnC,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,uBAAuB,CAI9B;IAED,OAAO,CAAC,iBAAiB,CA0BxB;IAED,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,cAAc;YA6CR,iBAAiB;IAuC/B,MAAM;IA+DN,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,WAAW;CAyBpB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/engine.js

@@ -2,6 +2,7 @@ import { Camera } from "./camera";
 import { Mat4, Vec3 } from "./math";
 import { PmxLoader } from "./pmx-loader";
 import { Physics } from "./physics";
+import { createFetchAssetReader, createFileMapAssetReader, deriveBasePathFromPmxPath, fileListToMap, findFirstPmxFileInList, joinAssetPath, normalizeAssetPath, } from "./asset-reader";
 export const DEFAULT_ENGINE_OPTIONS = {
     ambientColor: new Vec3(0.88, 0.88, 0.88),
     directionalLightIntensity: 0.24,
@@ -965,28 +966,55 @@ export class Engine {
             this.resizeObserver = null;
         }
     }
-    async loadModel(nameOrPath, path) {
-        const pmxPath = path === undefined ? nameOrPath : path;
-        const name = path === undefined ? "model_" + (this._nextDefaultModelId++) : nameOrPath;
+    async loadModel(nameOrPath, pathOrOptions) {
+        if (pathOrOptions !== undefined && typeof pathOrOptions === "object" && "files" in pathOrOptions) {
+            const name = nameOrPath;
+            const pmxFile = pathOrOptions.pmxFile ?? findFirstPmxFileInList(pathOrOptions.files);
+            if (!pmxFile)
+                throw new Error("No .pmx file found in the selected folder");
+            const map = fileListToMap(pathOrOptions.files);
+            const pmxKey = normalizeAssetPath(pmxFile.webkitRelativePath ?? pmxFile.name);
+            const reader = createFileMapAssetReader(map);
+            const model = await PmxLoader.loadFromReader(reader, pmxKey);
+            model.setName(name);
+            await this.addModel(model, pmxKey, name, reader);
+            return model;
+        }
+        const pmxPath = pathOrOptions === undefined ? nameOrPath : pathOrOptions;
+        const name = pathOrOptions === undefined ? "model_" + this._nextDefaultModelId++ : nameOrPath;
         const model = await PmxLoader.load(pmxPath);
         model.setName(name);
         await this.addModel(model, pmxPath, name);
         return model;
     }
-    async addModel(model, pmxPath, name) {
+    async addModel(model, pmxPath, name, assetReader) {
         const requested = name ?? model.name;
         let key = requested;
         let n = 1;
         while (this.modelInstances.has(key)) {
             key = `${requested}_${n++}`;
         }
-        const pathParts = pmxPath.split("/");
-        pathParts.pop();
-        const basePath = pathParts.join("/") + "/";
-        await this.setupModelInstance(key, model, basePath);
+        const reader = assetReader ?? createFetchAssetReader();
+        const basePath = deriveBasePathFromPmxPath(pmxPath);
+        model.setAssetContext(reader, basePath);
+        await this.setupModelInstance(key, model, basePath, reader);
         return key;
     }
     removeModel(name) {
+        const inst = this.modelInstances.get(name);
+        if (!inst)
+            return;
+        inst.model.stopAnimation();
+        for (const path of inst.textureCacheKeys) {
+            const tex = this.textureCache.get(path);
+            if (tex) {
+                tex.destroy();
+                this.textureCache.delete(path);
+            }
+        }
+        for (const buf of inst.gpuBuffers) {
+            buf.destroy();
+        }
         this.modelInstances.delete(name);
     }
     getModelNames() {
@@ -1068,7 +1096,7 @@ export class Engine {
         this.device.queue.writeBuffer(inst.vertexBuffer, 0, vertices);
         inst.vertexBufferNeedsUpdate = false;
     }
-    async setupModelInstance(name, model, basePath) {
+    async setupModelInstance(name, model, basePath, assetReader) {
         const vertices = model.getVertices();
         const skinning = model.getSkinning();
         const skeleton = model.getSkeleton();
@@ -1130,10 +1158,20 @@ export class Engine {
                 { binding: 0, resource: { buffer: skinMatrixBuffer } },
             ],
         });
+        const gpuBuffers = [
+            vertexBuffer,
+            indexBuffer,
+            jointsBuffer,
+            weightsBuffer,
+            skinMatrixBuffer,
+        ];
         const inst = {
             name,
             model,
             basePath,
+            assetReader,
+            gpuBuffers,
+            textureCacheKeys: [],
             vertexBuffer,
             indexBuffer,
             jointsBuffer,
@@ -1285,8 +1323,8 @@ export class Engine {
         const loadTextureByIndex = async (texIndex) => {
             if (texIndex < 0 || texIndex >= textures.length)
                 return null;
-            const path = inst.basePath + textures[texIndex].path;
-            return this.createTextureFromPath(path);
+            const logicalPath = joinAssetPath(inst.basePath, normalizeAssetPath(textures[texIndex].path));
+            return this.createTextureFromLogicalPath(inst, logicalPath);
         };
         let currentIndexOffset = 0;
         let materialId = 0;
@@ -1301,6 +1339,7 @@ export class Engine {
             const materialAlpha = mat.diffuse[3];
             const isTransparent = materialAlpha < 1.0 - 0.001;
             const materialUniformBuffer = this.createMaterialUniformBuffer(prefix + mat.name, materialAlpha, [mat.diffuse[0], mat.diffuse[1], mat.diffuse[2]], mat.ambient, mat.specular, mat.shininess);
+            inst.gpuBuffers.push(materialUniformBuffer);
             const textureView = diffuseTexture.createView();
             const bindGroup = this.device.createBindGroup({
                 label: `${prefix}material: ${mat.name}`,
@@ -1318,6 +1357,7 @@ export class Engine {
                     mat.edgeSize, 0, 0, 0,
                 ]);
                 const outlineUniformBuffer = this.createUniformBuffer(`${prefix}outline: ${mat.name}`, materialUniformData);
+                inst.gpuBuffers.push(outlineUniformBuffer);
                 const outlineBindGroup = this.device.createBindGroup({
                     label: `${prefix}outline: ${mat.name}`,
                     layout: this.outlinePerMaterialBindGroupLayout,
@@ -1331,6 +1371,7 @@ export class Engine {
             if (this.onRaycast) {
                 const pickIdData = new Float32Array([modelId, materialId, 0, 0]);
                 const pickIdBuffer = this.createUniformBuffer(`${prefix}pick: ${mat.name}`, pickIdData);
+                inst.gpuBuffers.push(pickIdBuffer);
                 const pickBindGroup = this.device.createBindGroup({
                     label: `${prefix}pick: ${mat.name}`,
                     layout: this.pickPerMaterialBindGroupLayout,
@@ -1371,22 +1412,20 @@ export class Engine {
     shouldRenderDrawCall(inst, drawCall) {
         return !inst.hiddenMaterials.has(drawCall.materialName);
     }
-    async createTextureFromPath(path) {
-        const cached = this.textureCache.get(path);
+    async createTextureFromLogicalPath(inst, logicalPath) {
+        const cacheKey = logicalPath;
+        const cached = this.textureCache.get(cacheKey);
         if (cached) {
             return cached;
         }
         try {
-            const response = await fetch(path);
-            if (!response.ok) {
-                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-            }
-            const imageBitmap = await createImageBitmap(await response.blob(), {
+            const buffer = await inst.assetReader.readBinary(logicalPath);
+            const imageBitmap = await createImageBitmap(new Blob([buffer]), {
                 premultiplyAlpha: "none",
                 colorSpaceConversion: "none",
             });
             const texture = this.device.createTexture({
-                label: `texture: ${path}`,
+                label: `texture: ${cacheKey}`,
                 size: [imageBitmap.width, imageBitmap.height],
                 format: "rgba8unorm",
                 usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
@@ -1395,7 +1434,8 @@ export class Engine {
                 imageBitmap.width,
                 imageBitmap.height,
             ]);
-            this.textureCache.set(path, texture);
+            this.textureCache.set(cacheKey, texture);
+            inst.textureCacheKeys.push(cacheKey);
             return texture;
         }
         catch {

package/dist/folder-upload.d.ts

@@ -0,0 +1,24 @@
+/** After choosing a path from `multiple`, get the `File` for `loadModel(..., { files, pmxFile })`. */
+export declare function pmxFileAtRelativePath(files: File[], relativePath: string): File | undefined;
+/** Result of reading a folder input — switch on `status` in your UI. */
+export type PmxFolderInputResult = {
+    status: "empty";
+} | {
+    status: "not_directory";
+} | {
+    status: "no_pmx";
+} | {
+    status: "single";
+    files: File[];
+    pmxFile: File;
+} | {
+    status: "multiple";
+    files: File[];
+    pmxRelativePaths: string[];
+};
+/**
+ * One call from `onChange`: snapshots files, validates folder pick, resolves a single PMX or asks you to pick among several.
+ * Reset the input after: `e.target.value = ""`.
+ */
+export declare function parsePmxFolderInput(fileList: FileList | null | undefined): PmxFolderInputResult;
+//# sourceMappingURL=folder-upload.d.ts.map

package/dist/folder-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-upload.d.ts","sourceRoot":"","sources":["../src/folder-upload.ts"],"names":[],"mappings":"AAyBA,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAO3F;AAED,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,GAC3B;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAErE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,CAW/F"}

package/dist/folder-upload.js

@@ -0,0 +1,50 @@
+import { normalizeAssetPath } from "./asset-reader";
+/**
+ * Call on `<input type="file" webkitdirectory>` `change` **before** `input.value = ""`.
+ * `FileList` is live — clearing the input empties it; this copies to a stable `File[]`.
+ */
+function prepareLocalFolderFiles(fileList) {
+    const files = fileList?.length ? Array.from(fileList) : [];
+    const pmxRelativePaths = [];
+    for (const f of files) {
+        const wr = f.webkitRelativePath;
+        if (!wr || !wr.toLowerCase().endsWith(".pmx"))
+            continue;
+        pmxRelativePaths.push(normalizeAssetPath(wr));
+    }
+    pmxRelativePaths.sort((a, b) => a.localeCompare(b));
+    return { files, pmxRelativePaths };
+}
+function isDirectoryUpload(files) {
+    return files.length > 0 && files.every((f) => !!f.webkitRelativePath);
+}
+/** After choosing a path from `multiple`, get the `File` for `loadModel(..., { files, pmxFile })`. */
+export function pmxFileAtRelativePath(files, relativePath) {
+    const norm = normalizeAssetPath(relativePath);
+    for (const f of files) {
+        const wr = f.webkitRelativePath;
+        if (wr && normalizeAssetPath(wr) === norm)
+            return f;
+    }
+    return undefined;
+}
+/**
+ * One call from `onChange`: snapshots files, validates folder pick, resolves a single PMX or asks you to pick among several.
+ * Reset the input after: `e.target.value = ""`.
+ */
+export function parsePmxFolderInput(fileList) {
+    const { files, pmxRelativePaths } = prepareLocalFolderFiles(fileList);
+    if (files.length === 0)
+        return { status: "empty" };
+    if (!isDirectoryUpload(files))
+        return { status: "not_directory" };
+    if (pmxRelativePaths.length === 0)
+        return { status: "no_pmx" };
+    if (pmxRelativePaths.length === 1) {
+        const pmxFile = pmxFileAtRelativePath(files, pmxRelativePaths[0]);
+        if (!pmxFile)
+            return { status: "no_pmx" };
+        return { status: "single", files, pmxFile };
+    }
+    return { status: "multiple", files, pmxRelativePaths };
+}