@doki-land/live2d-renderer 0.0.18 → 0.0.20

package/dist/index.d.ts

@@ -34,7 +34,7 @@ interface TextureData {
 }
 interface ModelDrawPass {
     setTextures(textures: TextureData[]): void;
-    draw(drawables: DrawableMesh[], modelMatrix: Float32Array): void;
+    draw(drawables: readonly DrawableMesh[], modelMatrix: Float32Array): void;
     destroy(): void;
 }
 /** Top-level renderer bound to a canvas. */
@@ -177,7 +177,7 @@ declare function parseCpuProgram(bytes: ArrayBuffer): ModelProgram;
 /** Create a runtime instance with default parameter values. */
 declare function createModelInstance(program: ModelProgram): ModelInstance;
 declare function setParameterValue(instance: ModelInstance, parameterId: string, value: number): void;
-/** CPU deform 鈫?FrameSnapshot. */
+/** CPU deform → FrameSnapshot. */
 declare function evaluateFrame(instance: ModelInstance): FrameSnapshot;
 /** Stable fingerprint for golden tests (positions + topology). */
 declare function fingerprintSnapshot(snapshot: FrameSnapshot): string;
@@ -279,6 +279,11 @@ interface ModelBackend {
     setParameter?(model: InternalModel, id: string, value: number): void;
     /** Optional PartOpacity override (moc3 parts / pose / motion). */
     setPartOpacity?(model: InternalModel, id: string, value: number): void;
+    /**
+     * Resolve parameter id → index (O(1) after load).
+     * Used by motion blend / hosts instead of `listParameters().find`.
+     */
+    resolveParameter?(model: InternalModel, id: string): number | undefined;
     listParameters?(model: InternalModel): readonly ParameterBinding[];
 }
 declare function selectModelBackend(backends: ModelBackend[], json: unknown): ModelBackend;
@@ -292,9 +297,12 @@ declare class Moc2Backend implements ModelBackend {
     getDrawables(model: InternalModel): DrawableMesh[];
     captureFrame(model: InternalModel): FrameSnapshot | null;
     setParameter(model: InternalModel, id: string, value: number): void;
+    resolveParameter(model: InternalModel, id: string): number | undefined;
     listParameters(model: InternalModel): readonly ParameterBinding[];
     hitTest(_model: InternalModel, _x: number, _y: number): string | null;
     destroyModel(model: InternalModel): void;
+    /** Test/harness: stable program + instance refs. */
+    getResidentInstance(model: InternalModel): ModelInstance | null;
 }
 declare function createMoc2Backend(): Moc2Backend;
 
@@ -308,9 +316,11 @@ declare class Moc3Backend implements ModelBackend {
     captureFrame(model: InternalModel): FrameSnapshot | null;
     setParameter(model: InternalModel, id: string, value: number): void;
     setPartOpacity(model: InternalModel, id: string, value: number): void;
+    resolveParameter(model: InternalModel, id: string): number | undefined;
     listParameters(model: InternalModel): readonly ParameterBinding[];
     hitTest(_model: InternalModel, _x: number, _y: number): string | null;
     destroyModel(model: InternalModel): void;
+    getResidentInstance(model: InternalModel): ModelInstance | null;
 }
 declare function createMoc3Backend(): Moc3Backend;
 
@@ -501,10 +511,56 @@ declare function calcClippedDrawableBounds(clippedIndices: readonly number[], by
  * drawable AABB into the atlas cell (higher mask texel density).
  */
 declare function fitClippingContexts(contexts: readonly LaidOutClippingContext[], byIndex: ReadonlyMap<number, MaskBoundsMeshRef>, margin?: number): LaidOutClippingContext[];
-/** Flatten layout to `[x, y, w, h]` for GPU uniforms. */
-declare function maskLayoutVec4(layout: MaskLayoutRect): Float32Array;
-/** Flatten channel flag to `[r, g, b, a]` for GPU uniforms. */
-declare function maskChannelVec4(flag: MaskChannelFlag): Float32Array;
+/** Flatten layout to `[x, y, w, h]` for GPU uniforms. Reuses `into` when provided. */
+declare function maskLayoutVec4(layout: MaskLayoutRect, into?: Float32Array): Float32Array;
+/** Flatten channel flag to `[r, g, b, a]` for GPU uniforms. Reuses `into` when provided. */
+declare function maskChannelVec4(flag: MaskChannelFlag, into?: Float32Array): Float32Array;
+
+/**
+ * Resident clipping / mask atlas plan.
+ *
+ * Topology (maskIndices / invert / packing options) is compiled once; per frame
+ * only `modelBounds` is refreshed from current vertex positions.
+ */
+
+/** Stable key for mask topology (ignores vertex positions / opacity). */
+declare function clippingTopologyKey(drawables: readonly ClippingDrawableRef[]): string;
+type ResidentContext = {
+    -readonly [K in keyof LaidOutClippingContext]: LaidOutClippingContext[K];
+} & {
+    modelBounds: MaskLayoutRect;
+};
+/**
+ * Update `modelBounds` on resident contexts without reallocating the plan.
+ */
+declare function fitClippingContextsInPlace(contexts: readonly ResidentContext[], byIndex: ReadonlyMap<number, MaskBoundsMeshRef>, margin?: number): void;
+/**
+ * Caches atlas layout + mask/clipped sets while drawable mask topology is
+ * unchanged. Call {@link resolve} each frame; call {@link clear} on destroy.
+ */
+declare class ResidentClippingPlan {
+    #private;
+    /**
+     * Returns a partition whose `contexts` array identity is stable across
+     * frames with the same topology. `modelBounds` are refreshed in place.
+     */
+    resolve(drawables: readonly ClippingDrawableRef[], options?: MaskAtlasOptions): ClippingPartition;
+    /** Convenience for full drawable meshes (GPU backends). */
+    resolveMeshes(drawables: readonly DrawableMesh[], options?: MaskAtlasOptions): ClippingPartition;
+    /** True when the last {@link resolve} reused the cached atlas layout. */
+    get hasPlan(): boolean;
+    /** Exposed for tests — context array identity while topology holds. */
+    get residentContexts(): readonly LaidOutClippingContext[];
+    clear(): void;
+}
+
+/**
+ * Pos/UV interleave with optional resident output buffer (GPU upload scratch).
+ */
+/** Interleave `[x,y]` + `[u,v]` into `[x,y,u,v,…]`. Reuses `into` when large enough. */
+declare function interleavePosUv(positions: Float32Array, uvs: Float32Array, into?: Float32Array): Float32Array;
+/** Byte length of the live interleaved prefix (vertexCount * 16). */
+declare function interleaveByteLength(positions: Float32Array): number;
 
 /** Shared untextured preview colors (Canvas2D / WebGL2 / WebGPU parity). */
 declare const PREVIEW_FILL: {
@@ -556,4 +612,4 @@ declare function compileSharedModelCompile(settings: ModelSettings, mocBytes: Ar
 
 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 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 };
+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, ResidentClippingPlan, type SharedModelCompile, type TextureData, type WebGl2Renderer, WebGl2RendererImpl, type WebGl2RendererOptions, type WebGpuRenderer, WebGpuRendererImpl, type WebGpuRendererOptions, applyMoc3Glues, applyWebGl2BlendMode, buildClippingContexts, calcClippedDrawableBounds, calcVertexBounds, canvasCompositeForBlendMode, clippingTopologyKey, compileSharedModelCompile, createCanvas2DRenderer, createMoc2Backend, createMoc3Backend, createModelInstance, createQuadProgram, createRenderer, createWebGl2Renderer, createWebGpuRenderer, decodeMoc2, decodeMoc2ColorComposition, decodeMoc3, decodeMoc3DrawableFlags, detectMocBinaryFormat, evaluateFrame, expandBounds, fingerprintSnapshot, fitClippingContexts, fitClippingContextsInPlace, interleaveByteLength, interleavePosUv, isCanvas2DAvailable, isCpuProgramBytes, isWebGl2Available, isWebGpuAvailable, layoutMaskAtlas, layoutMaskAtlasRgba, layoutMaskAtlasUvGrid, loadMoc3Glues, maskChannelVec4, maskLayoutVec4, meanGlueSeamDistance, parseCpuProgram, partitionForClipping, selectModelBackend, serializeCpuProgram, setParameterValue, triangleEdgesToLineList, webGpuBlendState };