@doki-land/live2d-renderer 0.0.22 → 0.0.24

package/dist/index.d.ts

@@ -285,6 +285,8 @@ interface ModelBackend {
      */
     resolveParameter?(model: InternalModel, id: string): number | undefined;
     listParameters?(model: InternalModel): readonly ParameterBinding[];
+    /** Drawable index → MOC art-mesh id (program order), when known. */
+    getDrawableArtMeshId?(model: InternalModel, drawableIndex: number): string | undefined;
 }
 declare function selectModelBackend(backends: ModelBackend[], json: unknown): ModelBackend;
 
@@ -318,6 +320,7 @@ declare class Moc3Backend implements ModelBackend {
     setPartOpacity(model: InternalModel, id: string, value: number): void;
     resolveParameter(model: InternalModel, id: string): number | undefined;
     listParameters(model: InternalModel): readonly ParameterBinding[];
+    getDrawableArtMeshId(model: InternalModel, drawableIndex: number): string | undefined;
     hitTest(_model: InternalModel, _x: number, _y: number): string | null;
     destroyModel(model: InternalModel): void;
     getResidentInstance(model: InternalModel): ModelInstance | null;

package/dist/index.js

@@ -5963,12 +5963,15 @@ var Moc3Backend = class {
     const instance = createModelInstance(program);
     const meshes = allocateMeshesFromProgram2(program);
     const byArtMesh = /* @__PURE__ */ new Map();
+    const drawableArtMeshIds = [];
     if (doc) {
+      const artMeshIds = moc3SectionStrings(doc, "art_mesh.ids");
       const artOrder = moc3ArtMeshIndicesInProgramOrder(doc);
       for (let i = 0; i < artOrder.length; i++) {
         const art = artOrder[i];
         const mesh = meshes[i];
         if (mesh) byArtMesh.set(art, mesh);
+        drawableArtMeshIds.push(artMeshIds[art] ?? "");
       }
     }
     const poseOpacity = new Float32Array(meshes.length);
@@ -5989,7 +5992,8 @@ var Moc3Backend = class {
       poseDirty: true,
       partOpacity: /* @__PURE__ */ new Map(),
       bindings,
-      paramIndexById
+      paramIndexById,
+      drawableArtMeshIds
     };
     bakePose2(state);
     applyPartOpacity(state);
@@ -6048,6 +6052,12 @@ var Moc3Backend = class {
     syncBindingValues2(state);
     return state.bindings;
   }
+  getDrawableArtMeshId(model, drawableIndex) {
+    const state = stateByModel2.get(model);
+    if (!state) return void 0;
+    const id = state.drawableArtMeshIds[drawableIndex];
+    return id || void 0;
+  }
   hitTest(_model, _x, _y) {
     return null;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/live2d-renderer",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "description": "Live2D rendering — moc2/moc3 decode + WebGPU, WebGL2, Canvas2D backends for live2d.ts.",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@doki-land/live2d-core": "0.0.22"
+    "@doki-land/live2d-core": "0.0.24"
   },
   "sideEffects": false
 }

package/src/moc/moc3.ts

@@ -20,7 +20,11 @@ import type {
 } from "../runtime/model-runtime.js";
 import type { BlendMode, DrawableMesh } from "../types.js";
 import { cascadedPartOpacity, readMoc3PartTables } from "./moc3-parts.js";
-import { type Moc3Document, parseMoc3Document } from "./moc3-reader.js";
+import {
+    type Moc3Document,
+    moc3SectionStrings,
+    parseMoc3Document,
+} from "./moc3-reader.js";
 import {
     evaluateMoc3PoseInto,
     moc3ArtMeshIndicesInProgramOrder,
@@ -40,6 +44,8 @@ interface Moc3State {
     partOpacity: Map<string, number>;
     bindings: ParameterBinding[];
     paramIndexById: Map<string, number>;
+    /** Program-order art-mesh ids for HitArea resolution. */
+    drawableArtMeshIds: readonly string[];
 }
 
 const stateByModel = new WeakMap<InternalModel, Moc3State>();
@@ -191,12 +197,15 @@ export class Moc3Backend implements ModelBackend {
         const instance = createModelInstance(program);
         const meshes = allocateMeshesFromProgram(program);
         const byArtMesh = new Map<number, DrawableMesh>();
+        const drawableArtMeshIds: string[] = [];
         if (doc) {
+            const artMeshIds = moc3SectionStrings(doc, "art_mesh.ids");
             const artOrder = moc3ArtMeshIndicesInProgramOrder(doc);
             for (let i = 0; i < artOrder.length; i++) {
                 const art = artOrder[i]!;
                 const mesh = meshes[i];
                 if (mesh) byArtMesh.set(art, mesh);
+                drawableArtMeshIds.push(artMeshIds[art] ?? "");
             }
         }
         const poseOpacity = new Float32Array(meshes.length);
@@ -218,6 +227,7 @@ export class Moc3Backend implements ModelBackend {
             partOpacity: new Map(),
             bindings,
             paramIndexById,
+            drawableArtMeshIds,
         };
         bakePose(state);
         applyPartOpacity(state);
@@ -286,6 +296,16 @@ export class Moc3Backend implements ModelBackend {
         return state.bindings;
     }
 
+    getDrawableArtMeshId(
+        model: InternalModel,
+        drawableIndex: number,
+    ): string | undefined {
+        const state = stateByModel.get(model);
+        if (!state) return undefined;
+        const id = state.drawableArtMeshIds[drawableIndex];
+        return id || undefined;
+    }
+
     hitTest(_model: InternalModel, _x: number, _y: number): string | null {
         return null;
     }

package/src/runtime/model-runtime.ts

@@ -76,6 +76,12 @@ export interface ModelBackend {
     resolveParameter?(model: InternalModel, id: string): number | undefined;
 
     listParameters?(model: InternalModel): readonly ParameterBinding[];
+
+    /** Drawable index → MOC art-mesh id (program order), when known. */
+    getDrawableArtMeshId?(
+        model: InternalModel,
+        drawableIndex: number,
+    ): string | undefined;
 }
 
 export function selectModelBackend(