reze-engine 0.10.1 → 0.10.2

package/README.md

@@ -43,13 +43,14 @@ engine.runRenderLoop();
 
 ## API
 
-One WebGPU **Engine** per page (singleton after `init()`). Load models via `engine.loadModel(path)` or `engine.loadModel(name, path)`.
+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
 
 ```javascript
 engine.init()
 engine.loadModel(name, path)
+engine.loadModel(name, { files, pmxFile? })  // folder upload — see below
 engine.getModel(name)
 engine.getModelNames()
 engine.removeModel(name)
@@ -75,6 +76,38 @@ 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
 
 ```javascript
@@ -108,12 +141,12 @@ model.getBoneWorldPosition(name)
 `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()
+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
@@ -149,6 +182,7 @@ Call `model.play(name, options?)` to start or switch motion. `loop: true` makes
 
 ## 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":"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"}
+{"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 };
+}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { Engine, type EngineStats } from "./engine";
+export { Engine, type EngineStats, type LoadModelFromFilesOptions } from "./engine";
+export { parsePmxFolderInput, pmxFileAtRelativePath, type PmxFolderInputResult } from "./folder-upload";
 export { Model } from "./model";
 export { Vec3, Quat, Mat4 } from "./math";
 export type { AnimationClip, AnimationPlayOptions, AnimationProgress, BoneKeyframe, MorphKeyframe, BoneInterpolation, ControlPoint, } from "./animation";
 export { FPS } from "./animation";
 export { Physics, type PhysicsOptions } from "./physics";
-export { VMDWriter } from "./vmd-writer";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACvG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export { Engine } from "./engine";
+export { parsePmxFolderInput, pmxFileAtRelativePath } from "./folder-upload";
 export { Model } from "./model";
 export { Vec3, Quat, Mat4 } from "./math";
 export { FPS } from "./animation";
 export { Physics } from "./physics";
-export { VMDWriter } from "./vmd-writer";

package/dist/model.d.ts

@@ -1,4 +1,5 @@
 import { Mat4, Quat, Vec3 } from "./math";
+import { type AssetReader } from "./asset-reader";
 import { Rigidbody, Joint } from "./physics";
 import { AnimationClip, AnimationPlayOptions, AnimationProgress } from "./animation";
 export interface Texture {
@@ -118,6 +119,10 @@ export declare class Model {
     private boneTrackIndices;
     private morphTrackIndices;
     private lastAppliedClip;
+    private assetReader;
+    private assetBasePath;
+    /** Called by Engine when registering the model; enables loadVmd to resolve relative paths for folder uploads. */
+    setAssetContext(reader: AssetReader, basePath: string): void;
     constructor(vertexData: Float32Array<ArrayBuffer>, indexData: Uint32Array<ArrayBuffer>, textures: Texture[], materials: Material[], skeleton: Skeleton, skinning: Skinning, morphing: Morphing, rigidbodies?: Rigidbody[], joints?: Joint[]);
     private initializeRuntimeSkeleton;
     private initializeIKRuntime;
@@ -145,7 +150,7 @@ export declare class Model {
     setMorphWeight(name: string, weight: number, durationMs?: number): void;
     private applyMorphs;
     private buildClipFromVmdKeyFrames;
-    loadVmd(name: string, url: string): Promise<void>;
+    loadVmd(name: string, urlOrRelative: string): Promise<void>;
     loadClip(name: string, clip: AnimationClip): void;
     resetAllBones(): void;
     resetAllMorphs(): void;

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/model.js

@@ -1,5 +1,6 @@
 import { Mat4, Quat, Vec3 } from "./math";
 import { Engine } from "./engine";
+import { joinAssetPath } from "./asset-reader";
 import { IKSolverSystem } from "./ik-solver";
 import { VMDLoader } from "./vmd-loader";
 import { VMDWriter } from "./vmd-writer";
@@ -12,6 +13,11 @@ export class Model {
     setName(value) {
         this._name = value;
     }
+    /** Called by Engine when registering the model; enables loadVmd to resolve relative paths for folder uploads. */
+    setAssetContext(reader, basePath) {
+        this.assetReader = reader;
+        this.assetBasePath = basePath;
+    }
     constructor(vertexData, indexData, textures, materials, skeleton, skinning, morphing, rigidbodies = [], joints = []) {
         this._name = "";
         this.textures = [];
@@ -29,6 +35,8 @@ export class Model {
         this.boneTrackIndices = new Map();
         this.morphTrackIndices = new Map();
         this.lastAppliedClip = null;
+        this.assetReader = null;
+        this.assetBasePath = "";
         // Cached set to track which bones are being computed in current IK pass (to avoid infinite recursion)
         this.ikComputedSet = new Set();
         // Store base vertex data (original positions before morphing)
@@ -579,8 +587,32 @@ export class Model {
         }
         return { boneTracks, morphTracks, frameCount: maxFrame };
     }
-    loadVmd(name, url) {
-        return VMDLoader.load(url).then((vmdKeyFrames) => {
+    loadVmd(name, urlOrRelative) {
+        const loadBuffer = () => {
+            const u = urlOrRelative.trim();
+            const useSiteFetch = u.startsWith("http://") ||
+                u.startsWith("https://") ||
+                u.startsWith("/") ||
+                u.startsWith("blob:") ||
+                u.startsWith("data:");
+            if (useSiteFetch) {
+                return fetch(u).then((r) => {
+                    if (!r.ok)
+                        throw new Error(`Failed to fetch VMD ${u}: ${r.status}`);
+                    return r.arrayBuffer();
+                });
+            }
+            if (this.assetReader) {
+                return this.assetReader.readBinary(joinAssetPath(this.assetBasePath, u));
+            }
+            return fetch(u).then((r) => {
+                if (!r.ok)
+                    throw new Error(`Failed to fetch VMD ${u}: ${r.status}`);
+                return r.arrayBuffer();
+            });
+        };
+        return loadBuffer().then((buf) => {
+            const vmdKeyFrames = VMDLoader.loadFromBuffer(buf);
             const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames);
             this.animationState.loadAnimation(name, clip);
         });

package/dist/pmx-loader.d.ts

@@ -1,4 +1,5 @@
 import { Model } from "./model";
+import { type AssetReader } from "./asset-reader";
 export declare class PmxLoader {
     private view;
     private offset;
@@ -23,6 +24,8 @@ export declare class PmxLoader {
     private joints;
     private constructor();
     static load(url: string): Promise<Model>;
+    static loadFromBuffer(buffer: ArrayBuffer): Model;
+    static loadFromReader(reader: AssetReader, pmxLogicalPath: string): Promise<Model>;
     private parse;
     private parseHeader;
     private parseVertices;

package/dist/pmx-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pmx-loader.d.ts","sourceRoot":"","sources":["../src/pmx-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAWN,MAAM,SAAS,CAAA;AAIhB,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO;WAIM,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAK9C,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,WAAW;IA+CnB,OAAO,CAAC,aAAa;IA+FrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,cAAc;IAoEtB,OAAO,CAAC,UAAU;IAsKlB,OAAO,CAAC,WAAW;IA+InB,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,gBAAgB;IAyFxB,OAAO,CAAC,WAAW;IAmGnB,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,OAAO;IAkLf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,QAAQ;CAIjB"}
+{"version":3,"file":"pmx-loader.d.ts","sourceRoot":"","sources":["../src/pmx-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAWN,MAAM,SAAS,CAAA;AAGhB,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEzE,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,eAAe,CAAI;IAC3B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAY;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO;WAIM,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI9C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;WAIpC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKxF,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,WAAW;IA+CnB,OAAO,CAAC,aAAa;IA+FrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,cAAc;IAoEtB,OAAO,CAAC,UAAU;IAsKlB,OAAO,CAAC,WAAW;IA+InB,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,gBAAgB;IAyFxB,OAAO,CAAC,WAAW;IAmGnB,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,OAAO;IAkLf,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/pmx-loader.js

@@ -1,5 +1,6 @@
 import { Model, } from "./model";
 import { Mat4, Vec3 } from "./math";
+import { createFetchAssetReader } from "./asset-reader";
 export class PmxLoader {
     constructor(buffer) {
         this.offset = 0;
@@ -24,8 +25,14 @@ export class PmxLoader {
         this.view = new DataView(buffer);
     }
     static async load(url) {
-        const loader = new PmxLoader(await fetch(url).then((r) => r.arrayBuffer()));
-        return loader.parse();
+        return PmxLoader.loadFromReader(createFetchAssetReader(), url);
+    }
+    static loadFromBuffer(buffer) {
+        return new PmxLoader(buffer).parse();
+    }
+    static async loadFromReader(reader, pmxLogicalPath) {
+        const buffer = await reader.readBinary(pmxLogicalPath);
+        return PmxLoader.loadFromBuffer(buffer);
     }
     parse() {
         this.parseHeader();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.10.1",
+    "version": "0.10.2",
     "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",

package/src/asset-reader.ts

@@ -0,0 +1,79 @@
+/** 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 function normalizeAssetPath(p: string): string {
+  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: string, relative: string): string {
+  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: string): string {
+  const pathParts = pmxPath.replace(/\\/g, "/").split("/")
+  pathParts.pop()
+  return pathParts.join("/") + (pathParts.length > 0 ? "/" : "")
+}
+
+export function createFetchAssetReader(): AssetReader {
+  return {
+    async readBinary(logicalPath: string) {
+      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: Map<string, File>): AssetReader {
+  return {
+    async readBinary(logicalPath: string) {
+      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: FileList | File[]): Map<string, File> {
+  const m = new Map<string, File>()
+  for (const f of Array.from(files)) {
+    const rel = (f as File & { webkitRelativePath?: string }).webkitRelativePath ?? f.name
+    m.set(normalizeAssetPath(rel), f)
+  }
+  return m
+}
+
+export function findFirstPmxFileInList(files: FileList | File[]): File | null {
+  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 as File & { webkitRelativePath?: string }).webkitRelativePath ?? a.name
+    const pb = (b as File & { webkitRelativePath?: string }).webkitRelativePath ?? b.name
+    return pa.localeCompare(pb)
+  })
+  return list[0] ?? null
+}

package/src/engine.ts

@@ -3,9 +3,25 @@ import { Mat4, Vec3 } from "./math"
 import { Model } from "./model"
 import { PmxLoader } from "./pmx-loader"
 import { Physics, type PhysicsOptions } from "./physics"
+import {
+  createFetchAssetReader,
+  createFileMapAssetReader,
+  deriveBasePathFromPmxPath,
+  fileListToMap,
+  findFirstPmxFileInList,
+  joinAssetPath,
+  normalizeAssetPath,
+  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
@@ -62,6 +78,9 @@ interface ModelInstance {
   name: string
   model: Model
   basePath: string
+  assetReader: AssetReader
+  gpuBuffers: GPUBuffer[]
+  textureCacheKeys: string[]
   vertexBuffer: GPUBuffer
   indexBuffer: GPUBuffer
   jointsBuffer: GPUBuffer
@@ -1151,30 +1170,62 @@ export class Engine {
 
   async loadModel(path: string): Promise<Model>
   async loadModel(name: string, path: string): Promise<Model>
-  async loadModel(nameOrPath: string, path?: string): Promise<Model> {
-    const pmxPath = path === undefined ? nameOrPath : path
-    const name = path === undefined ? "model_" + (this._nextDefaultModelId++) : nameOrPath
+  async loadModel(name: string, options: LoadModelFromFilesOptions): Promise<Model>
+  async loadModel(
+    nameOrPath: string,
+    pathOrOptions?: string | LoadModelFromFilesOptions
+  ): Promise<Model> {
+    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 as File & { webkitRelativePath?: string }).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: Model, pmxPath: string, name?: string): Promise<string> {
+  async addModel(model: Model, pmxPath: string, name?: string, assetReader?: AssetReader): Promise<string> {
     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: string): void {
+    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)
   }
 
@@ -1262,7 +1313,7 @@ export class Engine {
     inst.vertexBufferNeedsUpdate = false
   }
 
-  private async setupModelInstance(name: string, model: Model, basePath: string): Promise<void> {
+  private async setupModelInstance(name: string, model: Model, basePath: string, assetReader: AssetReader): Promise<void> {
     const vertices = model.getVertices()
     const skinning = model.getSkinning()
     const skeleton = model.getSkeleton()
@@ -1345,10 +1396,21 @@ export class Engine {
       ],
     })
 
+    const gpuBuffers: GPUBuffer[] = [
+      vertexBuffer,
+      indexBuffer,
+      jointsBuffer,
+      weightsBuffer,
+      skinMatrixBuffer,
+    ]
+
     const inst: ModelInstance = {
       name,
       model,
       basePath,
+      assetReader,
+      gpuBuffers,
+      textureCacheKeys: [],
       vertexBuffer,
       indexBuffer,
       jointsBuffer,
@@ -1510,8 +1572,8 @@ export class Engine {
 
     const loadTextureByIndex = async (texIndex: number): Promise<GPUTexture | null> => {
       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
@@ -1535,6 +1597,7 @@ export class Engine {
         mat.specular,
         mat.shininess
       )
+      inst.gpuBuffers.push(materialUniformBuffer)
 
       const textureView = diffuseTexture.createView()
       const bindGroup = this.device.createBindGroup({
@@ -1555,6 +1618,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,
@@ -1569,6 +1633,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,
@@ -1621,24 +1686,22 @@ export class Engine {
     return !inst.hiddenMaterials.has(drawCall.materialName)
   }
 
-  private async createTextureFromPath(path: string): Promise<GPUTexture | null> {
-    const cached = this.textureCache.get(path)
+  private async createTextureFromLogicalPath(inst: ModelInstance, logicalPath: string): Promise<GPUTexture | null> {
+    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,
@@ -1648,7 +1711,8 @@ export class Engine {
         imageBitmap.height,
       ])
 
-      this.textureCache.set(path, texture)
+      this.textureCache.set(cacheKey, texture)
+      inst.textureCacheKeys.push(cacheKey)
       return texture
     } catch {
       return null

package/src/folder-upload.ts

@@ -0,0 +1,59 @@
+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: FileList | null | undefined): {
+  files: File[]
+  pmxRelativePaths: string[]
+} {
+  const files = fileList?.length ? Array.from(fileList) : []
+  const pmxRelativePaths: string[] = []
+  for (const f of files) {
+    const wr = (f as File & { webkitRelativePath?: string }).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: File[]): boolean {
+  return files.length > 0 && files.every((f) => !!(f as File & { webkitRelativePath?: string }).webkitRelativePath)
+}
+
+/** After choosing a path from `multiple`, get the `File` for `loadModel(..., { files, pmxFile })`. */
+export function pmxFileAtRelativePath(files: File[], relativePath: string): File | undefined {
+  const norm = normalizeAssetPath(relativePath)
+  for (const f of files) {
+    const wr = (f as File & { webkitRelativePath?: string }).webkitRelativePath
+    if (wr && normalizeAssetPath(wr) === norm) return f
+  }
+  return 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 function parsePmxFolderInput(fileList: FileList | null | undefined): PmxFolderInputResult {
+  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 }
+}

package/src/index.ts

@@ -1,4 +1,5 @@
-export { Engine, type EngineStats } from "./engine"
+export { Engine, type EngineStats, type LoadModelFromFilesOptions } from "./engine"
+export { parsePmxFolderInput, pmxFileAtRelativePath, type PmxFolderInputResult } from "./folder-upload"
 export { Model } from "./model"
 export { Vec3, Quat, Mat4 } from "./math"
 export type {
@@ -11,5 +12,4 @@ export type {
   ControlPoint,
 } from "./animation"
 export { FPS } from "./animation"
-export { Physics, type PhysicsOptions } from "./physics"
-export { VMDWriter } from "./vmd-writer"
+export { Physics, type PhysicsOptions } from "./physics"

package/src/model.ts

@@ -1,5 +1,6 @@
 import { Mat4, Quat, Vec3 } from "./math"
 import { Engine } from "./engine"
+import { joinAssetPath, type AssetReader } from "./asset-reader"
 import { Rigidbody, Joint } from "./physics"
 import { IKSolverSystem } from "./ik-solver"
 import { VMDLoader, type VMDKeyFrame } from "./vmd-loader"
@@ -206,6 +207,14 @@ export class Model {
   private morphTrackIndices: Map<string, number> = new Map()
   private lastAppliedClip: AnimationClip | null = null
 
+  private assetReader: AssetReader | null = null
+  private assetBasePath = ""
+
+  /** Called by Engine when registering the model; enables loadVmd to resolve relative paths for folder uploads. */
+  setAssetContext(reader: AssetReader, basePath: string): void {
+    this.assetReader = reader
+    this.assetBasePath = basePath
+  }
 
   constructor(
     vertexData: Float32Array<ArrayBuffer>,
@@ -857,8 +866,31 @@ export class Model {
     return { boneTracks, morphTracks, frameCount: maxFrame }
   }
 
-  loadVmd(name: string, url: string): Promise<void> {
-    return VMDLoader.load(url).then((vmdKeyFrames) => {
+  loadVmd(name: string, urlOrRelative: string): Promise<void> {
+    const loadBuffer = (): Promise<ArrayBuffer> => {
+      const u = urlOrRelative.trim()
+      const useSiteFetch =
+        u.startsWith("http://") ||
+        u.startsWith("https://") ||
+        u.startsWith("/") ||
+        u.startsWith("blob:") ||
+        u.startsWith("data:")
+      if (useSiteFetch) {
+        return fetch(u).then((r) => {
+          if (!r.ok) throw new Error(`Failed to fetch VMD ${u}: ${r.status}`)
+          return r.arrayBuffer()
+        })
+      }
+      if (this.assetReader) {
+        return this.assetReader.readBinary(joinAssetPath(this.assetBasePath, u))
+      }
+      return fetch(u).then((r) => {
+        if (!r.ok) throw new Error(`Failed to fetch VMD ${u}: ${r.status}`)
+        return r.arrayBuffer()
+      })
+    }
+    return loadBuffer().then((buf) => {
+      const vmdKeyFrames = VMDLoader.loadFromBuffer(buf)
       const clip = this.buildClipFromVmdKeyFrames(vmdKeyFrames)
       this.animationState.loadAnimation(name, clip)
     })

package/src/pmx-loader.ts

@@ -13,6 +13,7 @@ import {
 } from "./model"
 import { Mat4, Vec3 } from "./math"
 import { Rigidbody, Joint, RigidbodyShape, RigidbodyType } from "./physics"
+import { createFetchAssetReader, type AssetReader } from "./asset-reader"
 
 export class PmxLoader {
   private view: DataView
@@ -42,8 +43,16 @@ export class PmxLoader {
   }
 
   static async load(url: string): Promise<Model> {
-    const loader = new PmxLoader(await fetch(url).then((r) => r.arrayBuffer()))
-    return loader.parse()
+    return PmxLoader.loadFromReader(createFetchAssetReader(), url)
+  }
+
+  static loadFromBuffer(buffer: ArrayBuffer): Model {
+    return new PmxLoader(buffer).parse()
+  }
+
+  static async loadFromReader(reader: AssetReader, pmxLogicalPath: string): Promise<Model> {
+    const buffer = await reader.readBinary(pmxLogicalPath)
+    return PmxLoader.loadFromBuffer(buffer)
   }
 
   private parse(): Model {