@doki-land/live2d-renderer 0.0.14 → 0.0.15

package/README.md

@@ -1,3 +1,3 @@
 # @doki-land/live2d-renderer
 
-live2d.ts package 0.0.14.
+live2d.ts package 0.0.15.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as _doki_land_live2d_core from '@doki-land/live2d-core';
 import { ParameterProgram, ModelProgram, ModelInstance, FrameSnapshot, ModelFormat, ModelSettings, AssetResolver, InternalModel } from '@doki-land/live2d-core';
 export { detectModelSettingsFormat } from '@doki-land/live2d-core';
 
@@ -376,6 +377,8 @@ interface ModelBackendOptions {
     resolver?: AssetResolver;
     /** Preloaded moc bytes (tests). */
     mocBytes?: ArrayBuffer;
+    /** Reuse a prior compile from {@link SharedModelCompile}. */
+    sharedCompile?: SharedModelCompile;
 }
 /** Live parameter binding for inspectors / playground. */
 interface ParameterBinding {
@@ -385,6 +388,16 @@ interface ParameterBinding {
     readonly defaultValue: number;
     readonly value: number;
 }
+/** Shared read-only decode payload (renderer-internal; set by stage asset cache). */
+interface SharedModelCompile {
+    readonly mocBytes: ArrayBuffer;
+    /** moc3 official `.moc3` document. */
+    readonly moc3Doc?: unknown;
+    /** moc3 CPU `.program.json` program. */
+    readonly cpuProgram?: _doki_land_live2d_core.ModelProgram;
+    /** Parsed moc2 model graph. */
+    readonly moc2Model?: unknown;
+}
 /** moc2 / moc3 model runtime. */
 interface ModelBackend {
     readonly format: ModelFormat;
@@ -525,6 +538,9 @@ declare const PREVIEW_STROKE: {
 /** Expand triangle indices into a line-list (each edge twice-wound). */
 declare function triangleEdgesToLineList(indices: Uint16Array): Uint16Array;
 
+/** One-time decode of moc bytes for stage-level {@link ModelAsset} sharing. */
+declare function compileSharedModelCompile(settings: ModelSettings, mocBytes: ArrayBuffer): SharedModelCompile;
+
 /**
  * `@doki-land/live2d-renderer`
  *
@@ -537,4 +553,4 @@ declare function triangleEdgesToLineList(indices: Uint16Array): Uint16Array;
 
 declare const LIVE2D_RENDERER_VERSION: "0.0.0";
 
-export { BlendMode, CPU_PROGRAM_KIND, Canvas2DRendererImpl, type Canvas2DRendererOptions, type ClippingContext, type ClippingDrawableRef, type ClippingPartition, type CpuProgramFile, type CreateRendererOptions, type DecodedMoc2, type DecodedMoc3, type DrawableMesh, FULL_NDC_BOUNDS, LIVE2D_RENDERER_VERSION, type LaidOutClippingContext, MASK_CHANNEL_FLAGS, type MaskAtlasMode, type MaskAtlasOptions, type MaskChannelFlag, type MaskLayoutRect, Moc2Backend, Moc3Backend, Moc3DrawableFlag, type Moc3GlueDef, type Moc3GluePair, type ModelBackend, type ModelBackendOptions, type ModelDrawPass, PREVIEW_FILL, PREVIEW_STROKE, type ParameterBinding, type Renderer, type RendererKind, type TextureData, type WebGl2Renderer, WebGl2RendererImpl, type WebGl2RendererOptions, type WebGpuRenderer, WebGpuRendererImpl, type WebGpuRendererOptions, applyMoc3Glues, applyWebGl2BlendMode, buildClippingContexts, calcClippedDrawableBounds, calcVertexBounds, canvasCompositeForBlendMode, createCanvas2DRenderer, createMoc2Backend, createMoc3Backend, createModelInstance, createQuadProgram, createRenderer, createWebGl2Renderer, createWebGpuRenderer, decodeMoc2, decodeMoc2ColorComposition, decodeMoc3, decodeMoc3DrawableFlags, detectMocBinaryFormat, evaluateFrame, expandBounds, fingerprintSnapshot, fitClippingContexts, isCanvas2DAvailable, isCpuProgramBytes, isWebGl2Available, isWebGpuAvailable, layoutMaskAtlas, layoutMaskAtlasRgba, layoutMaskAtlasUvGrid, loadMoc3Glues, maskChannelVec4, maskLayoutVec4, meanGlueSeamDistance, parseCpuProgram, partitionForClipping, selectModelBackend, serializeCpuProgram, setParameterValue, triangleEdgesToLineList, webGpuBlendState };
+export { BlendMode, CPU_PROGRAM_KIND, Canvas2DRendererImpl, type Canvas2DRendererOptions, type ClippingContext, type ClippingDrawableRef, type ClippingPartition, type CpuProgramFile, type CreateRendererOptions, type DecodedMoc2, type DecodedMoc3, type DrawableMesh, FULL_NDC_BOUNDS, LIVE2D_RENDERER_VERSION, type LaidOutClippingContext, MASK_CHANNEL_FLAGS, type MaskAtlasMode, type MaskAtlasOptions, type MaskChannelFlag, type MaskLayoutRect, Moc2Backend, Moc3Backend, Moc3DrawableFlag, type Moc3GlueDef, type Moc3GluePair, type ModelBackend, type ModelBackendOptions, type ModelDrawPass, PREVIEW_FILL, PREVIEW_STROKE, type ParameterBinding, type Renderer, type RendererKind, type SharedModelCompile, type TextureData, type WebGl2Renderer, WebGl2RendererImpl, type WebGl2RendererOptions, type WebGpuRenderer, WebGpuRendererImpl, type WebGpuRendererOptions, applyMoc3Glues, applyWebGl2BlendMode, buildClippingContexts, calcClippedDrawableBounds, calcVertexBounds, canvasCompositeForBlendMode, compileSharedModelCompile, createCanvas2DRenderer, createMoc2Backend, createMoc3Backend, createModelInstance, createQuadProgram, createRenderer, createWebGl2Renderer, createWebGpuRenderer, decodeMoc2, decodeMoc2ColorComposition, decodeMoc3, decodeMoc3DrawableFlags, detectMocBinaryFormat, evaluateFrame, expandBounds, fingerprintSnapshot, fitClippingContexts, isCanvas2DAvailable, isCpuProgramBytes, isWebGl2Available, isWebGpuAvailable, layoutMaskAtlas, layoutMaskAtlasRgba, layoutMaskAtlasUvGrid, loadMoc3Glues, maskChannelVec4, maskLayoutVec4, meanGlueSeamDistance, parseCpuProgram, partitionForClipping, selectModelBackend, serializeCpuProgram, setParameterValue, triangleEdgesToLineList, webGpuBlendState };

package/dist/index.js

@@ -5236,7 +5236,8 @@ var Moc2Backend = class {
     return detectModelSettingsFormat2(json) === "moc2";
   }
   async createModel(settings, options) {
-    let bytes = options?.mocBytes;
+    const shared = options?.sharedCompile;
+    let bytes = options?.mocBytes ?? shared?.mocBytes;
     if (!bytes) {
       if (!options?.resolver) {
         throw new Error(
@@ -5245,7 +5246,7 @@ var Moc2Backend = class {
       }
       bytes = await options.resolver.fetchBytes(settings.moc);
     }
-    const moc = new Moc2Parser(bytes).parseModel();
+    const moc = shared?.moc2Model ?? new Moc2Parser(bytes).parseModel();
     const program = moc2ModelToProgram(moc);
     const instance = createModelInstance(program);
     const model = {
@@ -5400,7 +5401,8 @@ var Moc3Backend = class {
     return detectModelSettingsFormat3(json) === "moc3";
   }
   async createModel(settings, options) {
-    let bytes = options?.mocBytes;
+    const shared = options?.sharedCompile;
+    let bytes = options?.mocBytes ?? shared?.mocBytes;
     if (!bytes) {
       if (!options?.resolver) {
         throw new Error(
@@ -5413,9 +5415,9 @@ var Moc3Backend = class {
     let doc = null;
     let program;
     if (isCpu) {
-      program = parseCpuProgram(bytes);
+      program = shared?.cpuProgram ?? parseCpuProgram(bytes);
     } else {
-      doc = parseMoc3Document(bytes);
+      doc = shared?.moc3Doc ?? parseMoc3Document(bytes);
       program = moc3DocumentToProgram(doc);
     }
     const instance = createModelInstance(program);
@@ -5521,6 +5523,22 @@ function selectModelBackend(backends, json) {
   return hit;
 }
 
+// src/shared-compile.ts
+function compileSharedModelCompile(settings, mocBytes) {
+  if (settings.format === "moc2") {
+    return {
+      mocBytes,
+      moc2Model: new Moc2Parser(mocBytes).parseModel()
+    };
+  }
+  const isCpu = settings.moc.toLowerCase().endsWith(".program.json") || isCpuProgramBytes(mocBytes);
+  if (isCpu) {
+    const cpuProgram = parseCpuProgram(mocBytes);
+    return { mocBytes, cpuProgram };
+  }
+  return { mocBytes, moc3Doc: parseMoc3Document(mocBytes) };
+}
+
 // src/index.ts
 var LIVE2D_RENDERER_VERSION = "0.0.0";
 export {
@@ -5543,6 +5561,7 @@ export {
   calcClippedDrawableBounds,
   calcVertexBounds,
   canvasCompositeForBlendMode,
+  compileSharedModelCompile,
   createCanvas2DRenderer,
   createMoc2Backend,
   createMoc3Backend,

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@doki-land/live2d-renderer",
-  "version": "0.0.14",
-  "description": "Live2D graphics backends (WebGPU/WebGL2/Canvas2D) plus moc2/moc3 CPU model runtimes",
+  "version": "0.0.15",
+  "description": "Live2D rendering — moc2/moc3 decode + WebGPU, WebGL2, Canvas2D backends for live2d.ts.",
   "type": "module",
   "license": "MIT",
-  "author": "Doki Land",
+  "homepage": "https://github.com/doki-land/live2d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doki-land/live2d.ts.git",
+    "directory": "projects/live2d-renderer"
+  },
   "keywords": [
     "live2d",
     "webgpu",
@@ -20,7 +25,8 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "README.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -39,11 +45,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@doki-land/live2d-core": "0.0.14"
+    "@doki-land/live2d-core": "0.0.15"
   },
-  "sideEffects": false,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/doki-land/live2d.ts.git"
-  }
+  "sideEffects": false
 }

package/src/index.ts

@@ -100,6 +100,7 @@ export {
     type ModelBackend,
     type ModelBackendOptions,
     type ParameterBinding,
+    type SharedModelCompile,
     selectModelBackend,
 } from "./model-runtime.js";
 export {
@@ -107,6 +108,7 @@ export {
     PREVIEW_STROKE,
     triangleEdgesToLineList,
 } from "./preview-style.js";
+export { compileSharedModelCompile } from "./shared-compile.js";
 export {
     BlendMode,
     type DrawableMesh,

package/src/moc/moc2.ts

@@ -92,7 +92,8 @@ export class Moc2Backend implements ModelBackend {
         settings: ModelSettings,
         options?: ModelBackendOptions,
     ): Promise<InternalModel> {
-        let bytes = options?.mocBytes;
+        const shared = options?.sharedCompile;
+        let bytes = options?.mocBytes ?? shared?.mocBytes;
         if (!bytes) {
             if (!options?.resolver) {
                 throw new Error(
@@ -102,7 +103,9 @@ export class Moc2Backend implements ModelBackend {
             bytes = await options.resolver.fetchBytes(settings.moc);
         }
 
-        const moc = new Moc2Parser(bytes).parseModel();
+        const moc =
+            (shared?.moc2Model as Moc2ModelImpl | undefined) ??
+            new Moc2Parser(bytes).parseModel();
         const program = moc2ModelToProgram(moc);
         const instance = createModelInstance(program);
         const model: InternalModel = {

package/src/moc/moc3.ts

@@ -94,7 +94,8 @@ export class Moc3Backend implements ModelBackend {
         settings: ModelSettings,
         options?: ModelBackendOptions,
     ): Promise<InternalModel> {
-        let bytes = options?.mocBytes;
+        const shared = options?.sharedCompile;
+        let bytes = options?.mocBytes ?? shared?.mocBytes;
         if (!bytes) {
             if (!options?.resolver) {
                 throw new Error(
@@ -111,9 +112,11 @@ export class Moc3Backend implements ModelBackend {
         let doc: Moc3Document | null = null;
         let program: ModelProgram;
         if (isCpu) {
-            program = parseCpuProgram(bytes);
+            program = shared?.cpuProgram ?? parseCpuProgram(bytes);
         } else {
-            doc = parseMoc3Document(bytes);
+            doc =
+                (shared?.moc3Doc as Moc3Document | undefined) ??
+                parseMoc3Document(bytes);
             program = moc3DocumentToProgram(doc);
         }
 

package/src/model-runtime.ts

@@ -18,6 +18,8 @@ export interface ModelBackendOptions {
     resolver?: AssetResolver;
     /** Preloaded moc bytes (tests). */
     mocBytes?: ArrayBuffer;
+    /** Reuse a prior compile from {@link SharedModelCompile}. */
+    sharedCompile?: SharedModelCompile;
 }
 
 /** Live parameter binding for inspectors / playground. */
@@ -29,6 +31,17 @@ export interface ParameterBinding {
     readonly value: number;
 }
 
+/** Shared read-only decode payload (renderer-internal; set by stage asset cache). */
+export interface SharedModelCompile {
+    readonly mocBytes: ArrayBuffer;
+    /** moc3 official `.moc3` document. */
+    readonly moc3Doc?: unknown;
+    /** moc3 CPU `.program.json` program. */
+    readonly cpuProgram?: import("@doki-land/live2d-core").ModelProgram;
+    /** Parsed moc2 model graph. */
+    readonly moc2Model?: unknown;
+}
+
 /** moc2 / moc3 model runtime. */
 export interface ModelBackend {
     readonly format: ModelFormat;

package/src/shared-compile.ts

@@ -0,0 +1,28 @@
+import type { ModelProgram, ModelSettings } from "@doki-land/live2d-core";
+import { isCpuProgramBytes, parseCpuProgram } from "./cpu/cpu-program.js";
+import { Moc2Parser } from "./moc/moc2-objects.js";
+import { parseMoc3Document } from "./moc/moc3-reader.js";
+import type { SharedModelCompile } from "./model-runtime.js";
+
+/** One-time decode of moc bytes for stage-level {@link ModelAsset} sharing. */
+export function compileSharedModelCompile(
+    settings: ModelSettings,
+    mocBytes: ArrayBuffer,
+): SharedModelCompile {
+    if (settings.format === "moc2") {
+        return {
+            mocBytes,
+            moc2Model: new Moc2Parser(mocBytes).parseModel(),
+        };
+    }
+
+    const isCpu =
+        settings.moc.toLowerCase().endsWith(".program.json") ||
+        isCpuProgramBytes(mocBytes);
+    if (isCpu) {
+        const cpuProgram: ModelProgram = parseCpuProgram(mocBytes);
+        return { mocBytes, cpuProgram };
+    }
+
+    return { mocBytes, moc3Doc: parseMoc3Document(mocBytes) };
+}