reze-engine 0.36.1 → 0.38.0

package/dist/engine.js

@@ -1,5 +1,6 @@
 import { Camera } from "./camera";
 import { Mat4, Quat, Vec3 } from "./math";
+import { MATERIAL_MORPH_MULTIPLY } from "./model";
 import { MORPH_COMPUTE_WGSL } from "./shaders/passes/morph";
 import { decodeTga } from "./tga-loader";
 import { VMDLoader } from "./vmd-loader";
@@ -2457,6 +2458,15 @@ export class Engine {
     setCameraBeta(b) {
         this.camera.beta = b;
     }
+    /** Vertical field of view in radians (default π/4). While a camera VMD
+     *  drives the view it animates fov itself; the orbit value set here is
+     *  restored when the VMD releases the camera. */
+    getCameraFov() {
+        return this.camera.fov;
+    }
+    setCameraFov(fov) {
+        this.camera.fov = fov;
+    }
     // Step 5: Create lighting buffers
     setupLighting() {
         this.lightUniformBuffer = this.device.createBuffer({
@@ -2639,7 +2649,29 @@ export class Engine {
         await this.addModel(model, pmxPath, name);
         return model;
     }
-    async addModel(model, pmxPath, name, assetReader) {
+    /** loadModel's folder/zip path for a stage. Shares the whole prelude — only
+     *  what the PMX becomes differs. */
+    async loadStage(name, options) {
+        const { model, pmxKey, reader } = await this.openPmxFromFiles(name, options);
+        await this.addStage(model, pmxKey, { name, transform: options.transform, assetReader: reader });
+        return model;
+    }
+    /** Read a PMX out of a picked folder / expanded zip. Shared by loadModel and
+     *  loadStage so the file-map and path handling exist in exactly one place. */
+    async openPmxFromFiles(name, options) {
+        const pmxFile = options.pmxFile ?? findFirstPmxFileInList(options.files);
+        if (!pmxFile)
+            throw new Error("No .pmx file found in the selected folder");
+        const map = fileListToMap(options.files);
+        // `||`, not `??`: flat-picked files carry webkitRelativePath === "" (see
+        // fileListToMap) — `""` must fall through to the filename.
+        const pmxKey = normalizeAssetPath(pmxFile.webkitRelativePath || pmxFile.name);
+        const reader = createFileMapAssetReader(map);
+        const model = await PmxLoader.loadFromReader(reader, pmxKey);
+        model.setName(name);
+        return { model, pmxKey, reader };
+    }
+    async addModel(model, pmxPath, name, assetReader, options) {
         const requested = name ?? model.name;
         let key = requested;
         let n = 1;
@@ -2649,9 +2681,42 @@ export class Engine {
         const reader = assetReader ?? createFetchAssetReader();
         const basePath = deriveBasePathFromPmxPath(pmxPath);
         model.setAssetContext(reader, basePath);
-        await this.setupModelInstance(key, model, basePath, reader);
+        await this.setupModelInstance(key, model, basePath, reader, options?.stage ?? false);
+        return key;
+    }
+    /**
+     * Add a PMX as the scene's environment rather than as a character.
+     *
+     * A stage is the same geometry and the same materials — style groups and
+     * shader graphs work on it unchanged, which is the whole reason pure-PMX
+     * stages are worth supporting — but it is not a performer:
+     *
+     *  - no physics. A stage's rigidbodies are set dressing for MMD's solver and
+     *    cost a full simulation island for scenery that never moves.
+     *  - no IK. Nothing drives a stage's chains, and solving them every frame is
+     *    pure waste on what is usually the heaviest mesh in the scene.
+     *  - no per-frame pose work while it is idle: with no clip and no morph
+     *    change there is nothing to recompute, so update is skipped entirely.
+     *  - it owns the floor. See groundIsSuppressed — the built-in ground plane
+     *    and a stage's own floor both sit at y=0 and z-fight.
+     *
+     * Bone and material morphs still apply, because that is how a stage's doors,
+     * lifts and colour switches are rigged.
+     */
+    async addStage(model, pmxPath, options) {
+        const key = await this.addModel(model, pmxPath, options?.name, options?.assetReader, { stage: true });
+        if (options?.transform)
+            this.setModelTransform(key, options.transform);
         return key;
     }
+    /** True while a stage is in the scene, which is when the built-in ground plane
+     *  must not draw. */
+    groundIsSuppressed() {
+        for (const inst of this.modelInstances.values())
+            if (inst.isStage)
+                return true;
+        return false;
+    }
     removeModel(name) {
         const inst = this.modelInstances.get(name);
         if (!inst)
@@ -2699,8 +2764,9 @@ export class Engine {
      * character — its colliders won't scale; scale stages (which are typically physics-free).
      */
     setModelTransform(name, transform) {
-        const model = this.modelInstances.get(name)?.model;
-        if (!model)
+        const inst = this.modelInstances.get(name);
+        const model = inst?.model;
+        if (!inst || !model)
             return;
         if (transform.position)
             model.setPosition(transform.position);
@@ -2710,6 +2776,11 @@ export class Engine {
             model.setScale(transform.scale);
         if (transform.visible !== undefined)
             model.setVisible(transform.visible);
+        // The root transform is baked into the skin matrices, so moving a model is a
+        // reason to re-upload them even though no pose pass ran. A cast member gets
+        // one every frame anyway; an idle stage would otherwise never see the change
+        // — which is exactly the case this API exists to serve.
+        inst.skinMatricesDirty = true;
     }
     /** Read a model's scene transform (for serialization into a scene descriptor). */
     getModelTransform(name) {
@@ -2858,8 +2929,22 @@ export class Engine {
         let physicsMs = 0;
         this.forEachInstance((inst) => {
             const tAnim = performance.now();
-            const verticesChanged = inst.model.update(deltaTime, this.ikEnabled);
+            // A stage never solves IK — nothing drives its chains — and skips the pose
+            // pass entirely while it is idle. Morph changes still come through, since
+            // that is the one thing a stage's controls do move.
+            const stageIdle = inst.isStage && inst.model.isIdle();
+            let verticesChanged = false;
+            if (!stageIdle) {
+                verticesChanged = inst.model.update(deltaTime, inst.isStage ? false : this.ikEnabled);
+                inst.skinMatricesDirty = true;
+            }
             animMs += performance.now() - tAnim;
+            // Material morphs ride the same weight change as vertex morphs but land in
+            // uniform buffers, so they consume their own flag — a model whose only
+            // morphs are material morphs never enters the GPU vertex path below.
+            if (inst.materialMorphTargets && inst.model.consumeAuxMorphDirty()) {
+                this.applyMaterialMorphs(inst);
+            }
             if (inst.gpuMorph) {
                 // GPU path: on a weight change, upload effective weights (thresholding tiny values
                 // to 0 to match the CPU skip) and flag the compute dispatch for this frame.
@@ -2935,7 +3020,7 @@ export class Engine {
         if (pass)
             pass.end();
     }
-    async setupModelInstance(name, model, basePath, assetReader) {
+    async setupModelInstance(name, model, basePath, assetReader, isStage = false) {
         const vertices = model.getVertices();
         const skinning = model.getSkinning();
         const skeleton = model.getSkeleton();
@@ -2975,7 +3060,10 @@ export class Engine {
         });
         this.device.queue.writeBuffer(indexBuffer, 0, indices);
         const rbs = model.getRigidbodies();
-        const physics = rbs.length > 0 ? new RezePhysics(rbs, model.getJoints()) : null;
+        // A stage never simulates, so its bodies are never built — constructing the
+        // solver for the heaviest mesh in the scene and dropping it afterwards was
+        // both wasted work and an invariant maintained in the wrong place.
+        const physics = !isStage && rbs.length > 0 ? new RezePhysics(rbs, model.getJoints()) : null;
         // Adopt the scene's air, or a model added mid-session would fall under
         // different gravity from the ones already on stage.
         if (physics) {
@@ -3022,7 +3110,13 @@ export class Engine {
             mainPerInstanceBindGroup,
             pickPerInstanceBindGroup,
             pickDrawCalls: [],
+            isStage,
+            // Seeded true: the bind pose has to reach the GPU once before any frame.
+            skinMatricesDirty: true,
             hiddenMaterials: new Set(),
+            morphHiddenMaterials: new Set(),
+            materialMorphTargets: null,
+            materialMorphByIndex: null,
             physics,
             vertexBufferNeedsUpdate: false,
             gpuMorph,
@@ -3247,9 +3341,28 @@ export class Engine {
         const meshIndices = model.getIndices();
         // 頭 bone index for the eye shader's rear-view gate (-1 when absent).
         const headBoneIndex = model.getSkeleton().bones.findIndex((b) => b.name === "頭");
+        // Materials a type-8 morph can reach. -1 in an offset means "all of them",
+        // so the presence of ANY material morph makes every material a target.
+        const morphedMaterials = new Set();
+        for (const morph of model.getMorphing().morphs) {
+            if (morph.type !== 8 || !morph.materialOffsets)
+                continue;
+            for (const off of morph.materialOffsets) {
+                if (off.materialIndex < 0)
+                    for (let i = 0; i < materials.length; i++)
+                        morphedMaterials.add(i);
+                else
+                    morphedMaterials.add(off.materialIndex);
+            }
+        }
+        const morphTargets = [];
         let currentIndexOffset = 0;
         let materialId = 0;
+        // The PMX index, which is what a material morph points at — distinct from
+        // materialId, which only counts materials that produced a draw.
+        let pmxMaterialIndex = -1;
         for (const mat of materials) {
+            pmxMaterialIndex++;
             const indexCount = mat.vertexCount;
             if (indexCount === 0)
                 continue;
@@ -3299,6 +3412,19 @@ export class Engine {
             }
             const materialUniformBuffer = this.createMaterialUniformBuffer(prefix + mat.name, mat, sphereMode, headBoneIndex);
             inst.gpuBuffers.push(materialUniformBuffer);
+            if (morphedMaterials.has(pmxMaterialIndex)) {
+                const base = this.materialUniformData(mat, sphereMode, headBoneIndex);
+                morphTargets.push({
+                    pmxIndex: pmxMaterialIndex,
+                    materialName: mat.name,
+                    buffer: materialUniformBuffer,
+                    base,
+                    work: new Float32Array(base.length),
+                    // Seeded from base: that is what createMaterialUniformBuffer already
+                    // uploaded, so an unmorphed material never writes a first time.
+                    last: Float32Array.from(base),
+                });
+            }
             const textureView = diffuseTexture.createView();
             const baseBindGroupEntries = [
                 { binding: 0, resource: textureView },
@@ -3314,8 +3440,13 @@ export class Engine {
             // its own hull where it is see-through instead of us skipping it here.
             // Drawn interleaved right after this material's color draw (babylon-mmd's
             // per-mesh afterRender outline stage) — see drawMaterials.
+            // Stages get no outline hulls. The inverted hull is a SECOND full draw of
+            // the material's geometry, and stage PMX routinely set the edge flag across
+            // every material — on the heaviest mesh in the scene that doubles the
+            // geometry submitted per frame to draw cartoon outlines around
+            // architecture, which is not the look anyone is after.
             let outline;
-            if ((mat.edgeFlag & 0x10) !== 0 && mat.edgeSize > 0) {
+            if (!inst.isStage && (mat.edgeFlag & 0x10) !== 0 && mat.edgeSize > 0) {
                 const materialUniformData = new Float32Array([
                     mat.edgeColor[0],
                     mat.edgeColor[1],
@@ -3371,10 +3502,17 @@ export class Engine {
         // by render-class when groups are assigned. Array.sort is stable → PMX order preserved
         // within a bucket.
         this.sortDrawCalls(inst);
-    }
-    createMaterialUniformBuffer(label, mat, sphereMode, headBoneIndex) {
-        // Matches the WGSL MaterialUniforms struct in common.ts — 64 bytes
-        // (diffuse+alpha | ambient+shininess | specular+sphereMode | headIdx+pad).
+        inst.materialMorphTargets = morphTargets.length > 0 ? morphTargets : null;
+        inst.materialMorphByIndex = inst.materialMorphTargets
+            ? new Map(morphTargets.map((t) => [t.pmxIndex, t]))
+            : null;
+        // Seed from the current weights: a scene can open with a switch already on.
+        if (inst.materialMorphTargets)
+            this.applyMaterialMorphs(inst);
+    }
+    /** Matches the WGSL MaterialUniforms struct in common.ts — 64 bytes
+     *  (diffuse+alpha | ambient+shininess | specular+sphereMode | headIdx+pad). */
+    materialUniformData(mat, sphereMode, headBoneIndex) {
         const data = new Float32Array(16);
         data[0] = mat.diffuse[0];
         data[1] = mat.diffuse[1];
@@ -3389,7 +3527,102 @@ export class Engine {
         data[10] = mat.specular[2];
         data[11] = sphereMode;
         data[12] = headBoneIndex;
-        return this.createUniformBuffer(`material uniform: ${label}`, data);
+        return data;
+    }
+    createMaterialUniformBuffer(label, mat, sphereMode, headBoneIndex) {
+        return this.createUniformBuffer(`material uniform: ${label}`, this.materialUniformData(mat, sphereMode, headBoneIndex));
+    }
+    /**
+     * Re-derive every morph-targeted material's uniform block from base and push
+     * the ones that moved.
+     *
+     * Blend maths follow MMD (and babylon-mmd's _applyMaterialMorph): multiply
+     * lerps from base toward base*morph, add offsets from base. Weight 0 must
+     * therefore land exactly on base, which is why this recomputes rather than
+     * accumulates.
+     *
+     * A material driven to zero alpha is dropped from the draw instead of being
+     * written through: the opaque/transparent bucket is decided at load from the
+     * PMX alpha, so an opaque draw cannot become see-through by uniform alone.
+     * Full-off is the switch stage artists actually ship (帽子消失 and friends);
+     * a partial fade on a material that loaded opaque still will not blend.
+     */
+    applyMaterialMorphs(inst) {
+        const targets = inst.materialMorphTargets;
+        if (!targets)
+            return;
+        const morphs = inst.model.getMorphing().morphs;
+        const weights = inst.model.getEffectiveMorphWeights();
+        for (const target of targets) {
+            target.work.set(target.base);
+        }
+        for (let i = 0; i < morphs.length; i++) {
+            const w = weights[i];
+            if (w < 0.0001)
+                continue;
+            const morph = morphs[i];
+            if (morph.type !== 8 || !morph.materialOffsets)
+                continue;
+            for (const off of morph.materialOffsets) {
+                // A named material resolves in one lookup. Only the -1 wildcard walks
+                // every target — and once any offset uses it, every material in the
+                // model is a target, so scanning per offset would be quadratic on the
+                // large stages this is meant to serve.
+                const hit = off.materialIndex >= 0 ? inst.materialMorphByIndex?.get(off.materialIndex) : undefined;
+                const affected = off.materialIndex >= 0 ? (hit ? [hit] : []) : targets;
+                for (const target of affected) {
+                    const d = target.work;
+                    if (off.offsetType === MATERIAL_MORPH_MULTIPLY) {
+                        d[0] += (d[0] * off.diffuse[0] - d[0]) * w;
+                        d[1] += (d[1] * off.diffuse[1] - d[1]) * w;
+                        d[2] += (d[2] * off.diffuse[2] - d[2]) * w;
+                        d[3] += (d[3] * off.diffuse[3] - d[3]) * w;
+                        d[4] += (d[4] * off.ambient[0] - d[4]) * w;
+                        d[5] += (d[5] * off.ambient[1] - d[5]) * w;
+                        d[6] += (d[6] * off.ambient[2] - d[6]) * w;
+                        d[7] += (d[7] * off.shininess - d[7]) * w;
+                        d[8] += (d[8] * off.specular[0] - d[8]) * w;
+                        d[9] += (d[9] * off.specular[1] - d[9]) * w;
+                        d[10] += (d[10] * off.specular[2] - d[10]) * w;
+                    }
+                    else {
+                        d[0] += off.diffuse[0] * w;
+                        d[1] += off.diffuse[1] * w;
+                        d[2] += off.diffuse[2] * w;
+                        d[3] += off.diffuse[3] * w;
+                        d[4] += off.ambient[0] * w;
+                        d[5] += off.ambient[1] * w;
+                        d[6] += off.ambient[2] * w;
+                        d[7] += off.shininess * w;
+                        d[8] += off.specular[0] * w;
+                        d[9] += off.specular[1] * w;
+                        d[10] += off.specular[2] * w;
+                    }
+                }
+            }
+        }
+        inst.morphHiddenMaterials.clear();
+        for (const target of targets) {
+            const d = target.work;
+            // Alpha is the switch; clamp the rest so a stacked multiply cannot send a
+            // colour negative and light the material from the inside.
+            for (let k = 0; k < 11; k++)
+                if (d[k] < 0)
+                    d[k] = 0;
+            if (d[3] < 0.0001)
+                inst.morphHiddenMaterials.add(target.materialName);
+            let changed = false;
+            for (let k = 0; k < 11; k++) {
+                if (d[k] !== target.last[k]) {
+                    changed = true;
+                    break;
+                }
+            }
+            if (!changed)
+                continue;
+            target.last.set(d);
+            this.device.queue.writeBuffer(target.buffer, 0, d);
+        }
     }
     createUniformBuffer(label, data) {
         const buffer = this.device.createBuffer({
@@ -3401,7 +3634,7 @@ export class Engine {
         return buffer;
     }
     shouldRenderDrawCall(inst, drawCall) {
-        return !inst.hiddenMaterials.has(drawCall.materialName);
+        return !inst.hiddenMaterials.has(drawCall.materialName) && !inst.morphHiddenMaterials.has(drawCall.materialName);
     }
     async createTextureFromLogicalPath(inst, logicalPath) {
         const cacheKey = logicalPath;
@@ -3526,6 +3759,12 @@ export class Engine {
         this.device.queue.submit([encoder.finish()]);
     }
     renderGround(pass) {
+        // A stage brings its own floor. Both sit at y=0, so drawing the built-in
+        // plane underneath produces z-fighting across the whole scene — enforced
+        // here rather than left to callers, who cannot see the conflict coming.
+        // hasGround is left alone: remove the stage and the ground comes back.
+        if (this.groundIsSuppressed())
+            return;
         if (!this.hasGround || !this.groundVertexBuffer || !this.groundIndexBuffer || !this.groundDrawCall)
             return;
         pass.setPipeline(this.groundShadowPipeline);
@@ -4594,8 +4833,14 @@ export class Engine {
     }
     updateSkinMatrices() {
         this.forEachInstance((inst) => {
+            // Only a pose pass can change these, and an idle stage did not run one —
+            // re-uploading bones×64 bytes for scenery that never moves is the one
+            // per-frame cost a stage would otherwise still pay in full.
+            if (!inst.skinMatricesDirty)
+                return;
             const skinMatrices = inst.model.getSkinMatrices();
             this.device.queue.writeBuffer(inst.skinMatrixBuffer, 0, skinMatrices.buffer, skinMatrices.byteOffset, skinMatrices.byteLength);
+            inst.skinMatricesDirty = false;
         });
     }
     // frameIntervalMs is the true vsync-to-vsync frame interval (render dt), NOT the CPU

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { BODY_GRAPH } from "./graph/presets/body";
 export { STOCKINGS_GRAPH } from "./graph/presets/stockings";
 export { EYE_GRAPH } from "./graph/presets/eye";
 export { FACE_GRAPH } from "./graph/presets/face";
-export { Model, type ClipEventInfo } from "./model";
+export { Model, MATERIAL_MORPH_MULTIPLY, MATERIAL_MORPH_ADD, type ClipEventInfo, type RootMotionProfile, type Morph, type Morphing, type BoneMorphOffset, type MaterialMorphOffset, type UvMorphOffset, } from "./model";
 export { Vec3, Quat, Mat4, easeInOut, type EulerOrder } from "./math";
 export type { AnimationClip, AnimationPlayOptions, AnimationProgress, BlendEntry, BoneKeyframe, IkKeyframe, MorphKeyframe, BoneInterpolation, ControlPoint, } from "./animation";
 export { LocomotionController, type LocomotionClips, type LocomotionOptions, type LocomotionPose, type StrafeClipEntry, type TurnClipEntry, type RunTurnClipEntry, type StopClipEntry, } from "./locomotion";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACvG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC7G,YAAY,EACV,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AACrE,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC5H,OAAO,EACL,GAAG,EACH,iBAAiB,EACjB,wBAAwB,EACxB,mCAAmC,GACpC,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -12,7 +12,7 @@ export { BODY_GRAPH } from "./graph/presets/body";
 export { STOCKINGS_GRAPH } from "./graph/presets/stockings";
 export { EYE_GRAPH } from "./graph/presets/eye";
 export { FACE_GRAPH } from "./graph/presets/face";
-export { Model } from "./model";
+export { Model, MATERIAL_MORPH_MULTIPLY, MATERIAL_MORPH_ADD, } from "./model";
 export { Vec3, Quat, Mat4, easeInOut } from "./math";
 export { LocomotionController, } from "./locomotion";
 export { AnimationStateMachine } from "./state-machine";

package/dist/locomotion.d.ts

@@ -177,6 +177,13 @@ export declare class LocomotionController {
     setDrive(forward: number, steer: number, sprint?: boolean): void;
     /** Place the character (initial spawn or respawn). */
     teleport(x: number, y: number, z: number, yaw?: number): void;
+    /** Teleport PLUS a hard reset of every transient motion commitment: any
+     *  in-flight authored stop/turn (whose stored start position would otherwise
+     *  keep driving the root from where it began), the exit ghost, speed and
+     *  momentum, the heading-hold gate, and the held inputs. For handing the
+     *  root back after an externally-driven action (a root-motion clip state):
+     *  wherever the action ended is simply where she now stands. */
+    reset(x: number, y: number, z: number, yaw?: number): void;
     /** Strafe mode: hold the body at this world yaw (a camera forward, a lock-on target)
      *  while setMove's vector drives the directional strafe ring — requires
      *  clips.strafeRun. null returns to turn-toward-movement. */

package/dist/locomotion.d.ts.map

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

package/dist/locomotion.js

@@ -113,6 +113,33 @@ export class LocomotionController {
         this.position.setXYZ(x, y, z);
         this.yaw = yaw;
     }
+    /** Teleport PLUS a hard reset of every transient motion commitment: any
+     *  in-flight authored stop/turn (whose stored start position would otherwise
+     *  keep driving the root from where it began), the exit ghost, speed and
+     *  momentum, the heading-hold gate, and the held inputs. For handing the
+     *  root back after an externally-driven action (a root-motion clip state):
+     *  wherever the action ended is simply where she now stands. */
+    reset(x, y, z, yaw = 0) {
+        this.position.setXYZ(x, y, z);
+        this.yaw = wrapAngle(yaw);
+        this.dirX = Math.sin(this.yaw);
+        this.dirZ = Math.cos(this.yaw);
+        this.speedLevel = 0;
+        this.recentSpeed = 0;
+        this.headingHold = 0;
+        this.headingDirX = 0;
+        this.headingDirY = 0;
+        this.gaitPhase = 0;
+        this.stopping = null;
+        this.turning = null;
+        this.runTurning = null;
+        this.exitGhost = null;
+        this.inputX = 0;
+        this.inputY = 0;
+        this.inputSprint = false;
+        this.inputForward = 0;
+        this.inputSteer = 0;
+    }
     /** Strafe mode: hold the body at this world yaw (a camera forward, a lock-on target)
      *  while setMove's vector drives the directional strafe ring — requires
      *  clips.strafeRun. null returns to turn-toward-movement. */

package/dist/model.d.ts

@@ -9,6 +9,14 @@ export interface ClipEventInfo {
     /** The clip's blend weight at the moment of firing. */
     weight: number;
 }
+/** A clip's authored horizontal root path, lifted off センター by
+ *  Model.extractRootMotion: per-key offsets from the FIRST key, raw clip
+ *  units, clip space (rest facing -Z). `frames` are VMD frames (30fps). */
+export interface RootMotionProfile {
+    frames: number[];
+    x: number[];
+    z: number[];
+}
 export interface Texture {
     path: string;
     name: string;
@@ -78,11 +86,44 @@ export interface GroupMorphReference {
     morphIndex: number;
     ratio: number;
 }
+export interface BoneMorphOffset {
+    boneIndex: number;
+    translation: [number, number, number];
+    /** Rotation quaternion (x, y, z, w). */
+    rotation: [number, number, number, number];
+}
+/** PMX material-morph blend mode. Multiply lerps toward base*morph; add offsets from base. */
+export declare const MATERIAL_MORPH_MULTIPLY = 0;
+export declare const MATERIAL_MORPH_ADD = 1;
+export interface MaterialMorphOffset {
+    /** -1 targets EVERY material in the model, per the PMX spec. */
+    materialIndex: number;
+    /** MATERIAL_MORPH_MULTIPLY | MATERIAL_MORPH_ADD */
+    offsetType: number;
+    diffuse: [number, number, number, number];
+    specular: [number, number, number];
+    shininess: number;
+    ambient: [number, number, number];
+    edgeColor: [number, number, number, number];
+    edgeSize: number;
+    textureCoeff: [number, number, number, number];
+    sphereCoeff: [number, number, number, number];
+    toonCoeff: [number, number, number, number];
+}
+export interface UvMorphOffset {
+    vertexIndex: number;
+    /** (u, v, z, w) — only u/v apply to the base channel. */
+    offset: [number, number, number, number];
+}
 export interface Morph {
     name: string;
+    /** 0=group, 1=vertex, 2=bone, 3–7=UV, 8=material, 9=flip, 10=impulse. */
     type: number;
     vertexOffsets: VertexMorphOffset[];
     groupReferences?: GroupMorphReference[];
+    boneOffsets?: BoneMorphOffset[];
+    materialOffsets?: MaterialMorphOffset[];
+    uvOffsets?: UvMorphOffset[];
 }
 export interface Morphing {
     morphs: Morph[];
@@ -146,6 +187,14 @@ export declare class Model {
     private runtimeSkeleton;
     private runtimeMorph;
     private morphsDirty;
+    private boneMorphPlan;
+    private boneMorphBones;
+    private boneMorphRestoreR;
+    private boneMorphRestoreT;
+    private boneMorphApplied;
+    /** A full pose pass has run, so the world matrices are real. See isIdle. */
+    private posedOnce;
+    private auxMorphDirty;
     private _position;
     private _rotation;
     private _scale;
@@ -189,6 +238,33 @@ export declare class Model {
     private buildDeformOrder;
     private initializeTweenBuffers;
     private initializeRuntimeMorph;
+    /**
+     * Bone morphs (type 2) compose over whatever the pose sources produced, the
+     * same way boneRotationOffsets do — they are an offset on the animated local
+     * transform, not a replacement for it. Re-applied every frame because each
+     * pose source rewrites the locals it touches.
+     *
+     * Stages are the reason this exists: a door or a lift is rigged as a bone
+     * morph and there is no VMD anywhere that drives it.
+     */
+    private applyBoneMorphs;
+    /** True (once) when effective morph weights changed — the engine re-derives
+     *  material-morph uniforms from it. Separate from the GPU vertex path's flag
+     *  so both can consume the same change. */
+    consumeAuxMorphDirty(): boolean;
+    /**
+     * Morph indices this model can actually act on, so a UI never offers a control
+     * that moves nothing.
+     *
+     * Driven directly: vertex (1), bone (2), material (8). Excluded: UV (3–7),
+     * which are parsed and kept but not yet applied; flip (9) and impulse (10),
+     * which are PMX 2.1 and would need the rigidbody solver.
+     *
+     * A group morph (0) is only as alive as what it points at — one referencing
+     * nothing but UV morphs is just as dead as the UV morphs themselves, so it is
+     * resolved rather than assumed.
+     */
+    getSupportedMorphIndices(): number[];
     private updateTweens;
     getVertices(): Float32Array<ArrayBuffer>;
     getTextures(): Texture[];
@@ -239,6 +315,24 @@ export declare class Model {
     resetAllBones(): void;
     resetAllMorphs(): void;
     getClip(name: string): AnimationClip | null;
+    /** Lift a clip's authored horizontal root path off センター so the host can
+     *  drive the MODEL ROOT along it — game-style root motion. The clip keeps
+     *  its vertical bob but its horizontal センター flattens to `rest` (default
+     *  0,0): a displaced first frame — common in per-pose game exports — would
+     *  otherwise ride the whole clip as a constant and visibly slide off during
+     *  the exit crossfade. Pass the pack's NEUTRAL standing offset (the idle
+     *  clip's first センター key) as `rest` so the flattened pose blends into
+     *  the surrounding states without even a micro-slide. The removed path
+     *  returns RELATIVE TO THE FIRST KEY, raw clip units, clip space (rest
+     *  facing -Z). Leg-IK target position tracks lose the same path so feet
+     *  keep oscillating around the body. Call once per clip, after
+     *  loadVmd/loadClip; null if the clip or its センター track doesn't exist. */
+    extractRootMotion(name: string, rest?: {
+        x?: number;
+        z?: number;
+    }): RootMotionProfile | null;
+    /** Linear sample of a keyed scalar track at fractional frame f. */
+    private static sampleTrack;
     exportVmd(name: string): ArrayBuffer;
     play(): void;
     play(name: string): boolean;
@@ -326,6 +420,19 @@ export declare class Model {
      *  animationState, already ticked by update), shape the weight with easeInOut,
      *  and hand both to the blend sampler. Holds in place while paused. */
     private applyCrossfade;
+    /**
+     * Nothing can have moved this frame: no clip, no blend, no live tween, no
+     * morph weight change.
+     *
+     * Environment geometry is in this state almost every frame, so the engine
+     * skips the whole pose pass — sampling, world matrices, and the skin-matrix
+     * upload — for a stage that reports idle. A stage is usually the heaviest mesh
+     * in the scene and the one that never moves; paying a full pose pass for it
+     * every frame is the thing worth not doing.
+     */
+    isIdle(): boolean;
+    /** Any live rotation / translation / morph tween. */
+    private hasActiveTweens;
     update(deltaTime: number, ikEnabled?: boolean): boolean;
     private solveIKChains;
     private ikComputedSet;