@doki-land/live2d-core 0.0.17 → 0.0.19

package/dist/index.d.ts

@@ -37,51 +37,6 @@ interface SessionState {
     readonly generation: number;
 }
 
-/** Model binary family (file extension / settings shape). */
-type ModelFormat = "moc2" | "moc3";
-/** Normalized, format-agnostic model settings. */
-interface ModelSettings {
-    format: ModelFormat;
-    url: string;
-    name?: string;
-    moc: string;
-    textures: string[];
-    motionGroups: Record<string, MotionDefinition[]>;
-    expressions: ExpressionDefinition[];
-    physics?: string;
-    pose?: string;
-    hitAreas: HitAreaDefinition[];
-    layout?: Record<string, number>;
-}
-interface MotionDefinition {
-    file: string;
-    sound?: string;
-    fadeInTime?: number;
-    fadeOutTime?: number;
-}
-interface ExpressionDefinition {
-    name: string;
-    file: string;
-}
-interface HitAreaDefinition {
-    name: string;
-    id: string;
-}
-/** Opaque in-memory model handle. */
-interface InternalModel {
-    readonly id: string;
-    readonly settings: ModelSettings;
-    readonly format: ModelFormat;
-}
-
-/**
- * Settings JSON format detection (moc2 vs moc3).
- * Shared by loader normalize and renderer backends — keep binary peek in renderer.
- */
-
-/** Detect moc2 vs moc3 from model settings JSON shape. Returns null if unknown. */
-declare function detectModelSettingsFormat(json: unknown): ModelFormat | null;
-
 /** Load pipeline stage for progress UI. */
 type LoadProgressStage = "mounting" | "resolve" | "settings" | "moc" | "textures" | "decode" | "ready";
 interface LoadProgress {
@@ -151,6 +106,51 @@ declare class EventEmitter {
     clear(): void;
 }
 
+/** Model binary family (file extension / settings shape). */
+type ModelFormat = "moc2" | "moc3";
+/** Normalized, format-agnostic model settings. */
+interface ModelSettings {
+    format: ModelFormat;
+    url: string;
+    name?: string;
+    moc: string;
+    textures: string[];
+    motionGroups: Record<string, MotionDefinition[]>;
+    expressions: ExpressionDefinition[];
+    physics?: string;
+    pose?: string;
+    hitAreas: HitAreaDefinition[];
+    layout?: Record<string, number>;
+}
+interface MotionDefinition {
+    file: string;
+    sound?: string;
+    fadeInTime?: number;
+    fadeOutTime?: number;
+}
+interface ExpressionDefinition {
+    name: string;
+    file: string;
+}
+interface HitAreaDefinition {
+    name: string;
+    id: string;
+}
+/** Opaque in-memory model handle. */
+interface InternalModel {
+    readonly id: string;
+    readonly settings: ModelSettings;
+    readonly format: ModelFormat;
+}
+
+/**
+ * Settings JSON format detection (moc2 vs moc3).
+ * Shared by loader normalize and renderer backends — keep binary peek in renderer.
+ */
+
+/** Detect moc2 vs moc3 from model settings JSON shape. Returns null if unknown. */
+declare function detectModelSettingsFormat(json: unknown): ModelFormat | null;
+
 /**
  * CPU frame output — format-agnostic mesh list ready for any RenderDevice.
  */
@@ -348,6 +348,16 @@ interface Live2dActor {
         defaultValue: number;
         value: number;
     }>;
+    /** Load-time stable id → binding map (binding.value updated on setParameter). */
+    parameterMap(): ReadonlyMap<string, {
+        id: string;
+        min: number;
+        max: number;
+        defaultValue: number;
+        value: number;
+    }>;
+    /** Resolve parameter id → index (O(1) after load). */
+    resolveParameter(id: string): number | undefined;
     listMotionGroups(): Record<string, readonly MotionDefinition[]>;
     playMotion(group: string, index?: number, options?: PlayMotionActorOptions): Promise<boolean>;
     stopMotion(opts?: {

package/dist/index.js

@@ -9,6 +9,28 @@ function modelSourceUrl(source) {
   return source.baseUrl;
 }
 
+// src/events.ts
+var EventEmitter = class {
+  #listeners = /* @__PURE__ */ new Map();
+  on(event, listener) {
+    const set = this.#listeners.get(event) ?? /* @__PURE__ */ new Set();
+    set.add(listener);
+    this.#listeners.set(event, set);
+    return () => this.off(event, listener);
+  }
+  off(event, listener) {
+    this.#listeners.get(event)?.delete(listener);
+  }
+  emit(event, payload) {
+    for (const listener of this.#listeners.get(event) ?? []) {
+      listener(payload);
+    }
+  }
+  clear() {
+    this.#listeners.clear();
+  }
+};
+
 // src/format/detect-format.ts
 function detectModelSettingsFormat(json) {
   if (!json || typeof json !== "object") return null;
@@ -33,28 +55,6 @@ function detectModelSettingsFormat(json) {
   return null;
 }
 
-// src/events.ts
-var EventEmitter = class {
-  #listeners = /* @__PURE__ */ new Map();
-  on(event, listener) {
-    const set = this.#listeners.get(event) ?? /* @__PURE__ */ new Set();
-    set.add(listener);
-    this.#listeners.set(event, set);
-    return () => this.off(event, listener);
-  }
-  off(event, listener) {
-    this.#listeners.get(event)?.delete(listener);
-  }
-  emit(event, payload) {
-    for (const listener of this.#listeners.get(event) ?? []) {
-      listener(payload);
-    }
-  }
-  clear() {
-    this.#listeners.clear();
-  }
-};
-
 // src/frame.ts
 var FrameBlendMode = {
   Normal: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/live2d-core",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "Shared TypeScript contracts for live2d.ts — ModelSource, Live2dStage/Actor, ModelAsset, events (no DOM/GPU).",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -16,7 +16,6 @@ export type {
     SessionState,
 } from "./contracts.js";
 export { modelSourceUrl } from "./contracts.js";
-export { detectModelSettingsFormat } from "./format/detect-format.js";
 export {
     EventEmitter,
     type FrameProfile,
@@ -26,6 +25,7 @@ export {
     type LoadProgress,
     type LoadProgressStage,
 } from "./events.js";
+export { detectModelSettingsFormat } from "./format/detect-format.js";
 export {
     FrameBlendMode,
     type FrameDrawable,

package/src/stage/stage.ts

@@ -117,6 +117,21 @@ export interface Live2dActor {
         value: number;
     }>;
 
+    /** Load-time stable id → binding map (binding.value updated on setParameter). */
+    parameterMap(): ReadonlyMap<
+        string,
+        {
+            id: string;
+            min: number;
+            max: number;
+            defaultValue: number;
+            value: number;
+        }
+    >;
+
+    /** Resolve parameter id → index (O(1) after load). */
+    resolveParameter(id: string): number | undefined;
+
     listMotionGroups(): Record<string, readonly MotionDefinition[]>;
 
     playMotion(