@laplace.live/pixijs-live2d 0.1.0 → 0.3.0

package/dist/extra.d.ts

@@ -1,6 +1,6 @@
 import { Graphics, Renderer, Text } from "pixi.js";
 //#region src/tools/HitAreaFrames.d.ts
-declare class HitAreaFrames extends Graphics {
+export declare class HitAreaFrames extends Graphics {
   initialized: boolean;
   texts: Text[];
   strokeWidth: number;
@@ -12,5 +12,4 @@ declare class HitAreaFrames extends Graphics {
   protected _render(renderer: Renderer): void;
 }
 //#endregion
-export { HitAreaFrames };
 //# sourceMappingURL=extra.d.ts.map

package/dist/index.d.ts

@@ -103,17 +103,17 @@ declare class CubismIdManager {
 }
 //#endregion
 //#region vendor/cubism/src/live2dcubismframework.d.ts
-declare function strtod(s: string, endPtr: string[]): number;
+export declare function strtod(s: string, endPtr: string[]): number;
 /**
  * Framework内で使う定数の宣言
  */
-declare const Constant: Readonly<Record<string, number>>;
-declare function csmDelete<T>(address: T): void;
+export declare const Constant: Readonly<Record<string, number>>;
+export declare function csmDelete<T>(address: T): void;
 /**
  * Live2D Cubism SDK Original Workflow SDKのエントリポイント
  * 利用開始時はCubismFramework.initialize()を呼び、CubismFramework.dispose()で終了する。
  */
-declare class CubismFramework {
+export declare class CubismFramework {
   /**
    * Cubism FrameworkのAPIを使用可能にする。
    *  APIを実行する前に必ずこの関数を実行すること。
@@ -178,14 +178,14 @@ declare class CubismFramework {
    */
   private constructor();
 }
-declare class Option {
+export declare class Option {
   logFunction: Live2DCubismCore.csmLogFunction;
   loggingLevel: LogLevel;
 }
 /**
  * ログ出力のレベル
  */
-declare enum LogLevel {
+export declare enum LogLevel {
   LogLevel_Verbose = 0 // 詳細ログ
   ,
   LogLevel_Debug = 1 // デバッグログ
@@ -200,8 +200,8 @@ declare enum LogLevel {
 }
 //#endregion
 //#region src/cubism-common/constants.d.ts
-declare const LOGICAL_WIDTH = 2;
-declare const LOGICAL_HEIGHT = 2;
+export declare const LOGICAL_WIDTH = 2;
+export declare const LOGICAL_HEIGHT = 2;
 //#endregion
 //#region src/types/helpers.d.ts
 type JSONObject = object;
@@ -211,7 +211,7 @@ type Mutable<T> = { -readonly [P in keyof T]: T[P]; };
 /**
  * Parses, and provides access to the settings JSON.
  */
-declare abstract class ModelSettings {
+export declare abstract class ModelSettings {
   json: JSONObject;
   /**
    * The model's name, typically used for displaying or logging. By default it's inferred from
@@ -2724,7 +2724,7 @@ interface CommonLayout {
 /**
  * Indicates the motion priority.
  */
-declare enum MotionPriority {
+export declare enum MotionPriority {
   /** States that the model is currently not playing any motion. This priority cannot be applied to a motion. */
   NONE = 0,
   /** Low priority, used when starting idle motions automatically. */
@@ -2737,7 +2737,7 @@ declare enum MotionPriority {
 /**
  * Handles the state of a MotionManager.
  */
-declare class MotionState {
+export declare class MotionState {
   /**
    * Tag for logging.
    */
@@ -2937,7 +2937,7 @@ declare abstract class ParallelMotionManager<Motion = never, MotionSpec = never>
 /**
  * Interpolates the transition of focus position.
  */
-declare class FocusController {
+export declare class FocusController {
   /** The focus position. */
   targetX: number;
   /** The focus position. */
@@ -2968,19 +2968,19 @@ declare class FocusController {
 /**
  * Common hit area definition shared between all Cubism versions.
  */
-interface CommonHitArea {
+export interface CommonHitArea {
   id: string;
   name: string;
   index: number;
 }
-declare function normalizeHitAreaDefs(raw: unknown, resolveIndex: (id: string) => number): CommonHitArea[];
-interface Bounds {
+export declare function normalizeHitAreaDefs(raw: unknown, resolveIndex: (id: string) => number): CommonHitArea[];
+export interface Bounds {
   x: number;
   y: number;
   width: number;
   height: number;
 }
-interface InternalModelOptions extends MotionManagerOptions {
+export interface InternalModelOptions extends MotionManagerOptions {
   /**
    * Define natural movements depth (0.0-1.0).
    * @default 1.0
@@ -3012,7 +3012,7 @@ interface InternalModelOptions extends MotionManagerOptions {
  * A wrapper that manages the states of a Live2D core model, and delegates all operations to it.
  * @emits {@link InternalModelEvents}
  */
-declare abstract class InternalModel extends EventEmitter {
+export declare abstract class InternalModel extends EventEmitter {
   /**
    * The managed Live2D core model.
    */
@@ -3024,6 +3024,12 @@ declare abstract class InternalModel extends EventEmitter {
   abstract parallelMotionManager: ParallelMotionManager<CubismMotion>[];
   pose?: unknown;
   physics?: unknown;
+  /**
+   * Retune the idle breath live, where the engine has one — `breathDepth` is a construction
+   * option, and a host that exposes it as a control needs to change it after load. Absent on a
+   * model type with no breath, so callers skip rather than branch.
+   */
+  setBreath?(enabled: boolean, depth?: number): void;
   /**
    * Original canvas width of the model. Note this doesn't represent the model's real size,
    * as the model can overflow from its canvas.
@@ -3192,7 +3198,7 @@ declare abstract class InternalModel extends EventEmitter {
 }
 //#endregion
 //#region src/cubism-common/MotionManager.d.ts
-interface MotionManagerOptions {
+export interface MotionManagerOptions {
   /**
    * How to preload the motions.
    * @default {@link MotionPreloadStrategy.NONE}
@@ -3209,7 +3215,7 @@ interface MotionManagerOptions {
    */
   checkMotionConsistency?: boolean;
 }
-interface MotionStartOptions {
+export interface MotionStartOptions {
   sound?: string;
   volume?: number;
   expression?: number | string;
@@ -3222,11 +3228,11 @@ interface MotionStartOptions {
    */
   loop?: boolean;
 }
-type MotionStartRandomOptions = Omit<MotionStartOptions, 'ignoreParamIds'>;
+export type MotionStartRandomOptions = Omit<MotionStartOptions, 'ignoreParamIds'>;
 /**
  * Indicates how the motions will be preloaded.
  */
-declare enum MotionPreloadStrategy {
+export declare enum MotionPreloadStrategy {
   /** Preload all the motions. */
   ALL = "ALL",
   /** Preload only the idle motions. */
@@ -3239,7 +3245,7 @@ declare enum MotionPreloadStrategy {
  * Responsible for loading, playing, and managing motion states and audio.
  * @emits {@link MotionManagerEvents}
  */
-declare abstract class MotionManager<Motion = unknown, MotionSpec = unknown> extends EventEmitter {
+export declare abstract class MotionManager<Motion = unknown, MotionSpec = unknown> extends EventEmitter {
   /**
    * Tag for logging.
    * @type {string}
@@ -3524,7 +3530,7 @@ declare abstract class MotionManager<Motion = unknown, MotionSpec = unknown> ext
  * any number can be active at once, each fading in/out on its own.
  * @emits {@link ExpressionManagerEvents}
  */
-declare abstract class ExpressionManager<Expression = unknown, ExpressionSpec = unknown> extends EventEmitter<keyof ExpressionManagerEvents> {
+export declare abstract class ExpressionManager<Expression = unknown, ExpressionSpec = unknown> extends EventEmitter<keyof ExpressionManagerEvents> {
   /**
    * Indicates the content type used when loading expressions.
    * @default "json"
@@ -3687,11 +3693,11 @@ declare abstract class ExpressionManager<Expression = unknown, ExpressionSpec =
 }
 //#endregion
 //#region src/cubism-common/SoundManager.d.ts
-declare const VOLUME = 0.5;
+export declare const VOLUME = 0.5;
 /**
  * Manages all the sounds.
  */
-declare class SoundManager {
+export declare class SoundManager {
   /**
    * Audio elements playing or pending to play. Finished audios will be removed automatically.
    */
@@ -3867,7 +3873,7 @@ declare const CSM_LOG_LEVEL: number;
 /**
  * Global configs.
  */
-declare const config: {
+export declare const config: {
   LOG_LEVEL_VERBOSE: number;
   LOG_LEVEL_WARNING: number;
   LOG_LEVEL_ERROR: number;
@@ -4014,7 +4020,7 @@ declare module '@/cubism-common/ModelSettings' {
     _objectURL?: string;
   }
 }
-type ExtendedFileList = File[] & {
+export type ExtendedFileList = File[] & {
   settings?: ModelSettings;
 };
 /**
@@ -4027,7 +4033,7 @@ type ExtendedFileList = File[] & {
  * Though named as a "Loader", this class has nothing to do with Live2DLoader,
  * it only contains a middleware for the Live2DFactory.
  */
-declare class FileLoader {
+export declare class FileLoader {
   static live2dFactory?: typeof Live2DFactory;
   /**
    * Stores all the object URLs of uploaded files.
@@ -4133,10 +4139,10 @@ declare class Automator {
 /**
  * Useless class. May be useful in the future.
  */
-declare class Live2DTransform extends Transform {}
+export declare class Live2DTransform extends Transform {}
 //#endregion
 //#region src/Live2DModel.d.ts
-interface Live2DModelOptions extends InternalModelOptions, AutomatorOptions {
+export interface Live2DModelOptions extends InternalModelOptions, AutomatorOptions {
   /**
    * Defines which bounds are used to resolve the normalized {@link Live2DModel.anchor}.
    * `'canvas'` preserves the historical model-canvas behavior, while `'drawable'`
@@ -4153,7 +4159,7 @@ interface Live2DModelOptions extends InternalModelOptions, AutomatorOptions {
    */
   textureOptions?: Live2DTextureSourceOptions;
 }
-type Live2DConstructor = {
+export type Live2DConstructor = {
   new (options?: Live2DModelOptions): Live2DModel;
 };
 type Live2DPrepareInstruction = {
@@ -4194,7 +4200,7 @@ declare class Live2DPipe {
  * extensions.add(Live2DPlugin)
  * ```
  */
-declare const Live2DPlugin: typeof Live2DPipe;
+export declare const Live2DPlugin: typeof Live2DPipe;
 /**
  * A wrapper that allows the Live2D model to be used as a DisplayObject in PixiJS.
  *
@@ -4204,7 +4210,7 @@ declare const Live2DPlugin: typeof Live2DPipe;
  * ```
  * @emits {@link Live2DModelEvents}
  */
-declare class Live2DModel<IM extends InternalModel = InternalModel> extends Container {
+export declare class Live2DModel<IM extends InternalModel = InternalModel> extends Container {
   /** @internal */
   renderPipeId: string;
   /** @internal */
@@ -4515,7 +4521,7 @@ declare class Live2DModel<IM extends InternalModel = InternalModel> extends Cont
 }
 //#endregion
 //#region src/factory/Live2DFactory.d.ts
-interface Live2DFactoryOptions extends Live2DModelOptions {
+export interface Live2DFactoryOptions extends Live2DModelOptions {
   /**
    * Whether to check the consistency of the moc file. It's an internal
    * function of Cubism core and only available since Cubism 4 R7.
@@ -4554,7 +4560,7 @@ interface Live2DFactoryOptions extends Live2DModelOptions {
 /**
  * The context transferred through the model creation middlewares.
  */
-interface Live2DFactoryContext {
+export interface Live2DFactoryContext {
   source: any;
   options: Live2DFactoryOptions;
   live2dModel: Live2DModel;
@@ -4564,7 +4570,7 @@ interface Live2DFactoryContext {
 /**
  * Represents a Cubism version.
  */
-interface Live2DRuntime {
+export interface Live2DRuntime {
   /**
    * The version number. Higher version takes priority when matching the runtime.
    */
@@ -4625,7 +4631,7 @@ interface Live2DRuntime {
  * - Motion loading: implements the load method of MotionManager.
  * - Expression loading: implements the load method of ExpressionManager.
  */
-declare class Live2DFactory {
+export declare class Live2DFactory {
   /**
    * All registered runtimes, sorted by versions in descending order.
    */
@@ -4689,11 +4695,11 @@ declare class Live2DFactory {
 }
 //#endregion
 //#region src/factory/Live2DLoader.d.ts
-type Live2DLoaderTarget = Live2DModel | InternalModel | MotionManager | ExpressionManager;
+export type Live2DLoaderTarget = Live2DModel | InternalModel | MotionManager | ExpressionManager;
 /**
  * The context transferred through Live2DLoader middlewares.
  */
-interface Live2DLoaderContext {
+export interface Live2DLoaderContext {
   /** The XHR's response type. */
   type: XMLHttpRequestResponseType;
   /** Will be resolved by {@link ModelSettings.resolveURL} if a ModelSettings is provided. */
@@ -4708,7 +4714,7 @@ interface Live2DLoaderContext {
   /** Loaded data. */
   result?: unknown;
 }
-declare class Live2DLoader {
+export declare class Live2DLoader {
   static middlewares: Middleware<Live2DLoaderContext>[];
   /**
    * Loads a resource.
@@ -4726,7 +4732,7 @@ declare class Live2DLoader {
  * - `status` - The HTTP status.
  * - `aborted` - True if the error is caused by aborting the XHR.
  */
-declare class XHRLoader {
+export declare class XHRLoader {
   /**
    * All the created XHRs, keyed by their owners respectively.
    */
@@ -4762,7 +4768,7 @@ declare class XHRLoader {
 /**
  * Remove an element from array.
  */
-declare function remove<T>(array: T[], item: T): void;
+export declare function remove<T>(array: T[], item: T): void;
 //#endregion
 //#region src/utils/log.d.ts
 /**
@@ -4778,7 +4784,7 @@ declare function remove<T>(array: T[], item: T): void;
  * };
  * ```
  */
-declare const logger: {
+export declare const logger: {
   log(tag: string, ...messages: unknown[]): void;
   warn(tag: string, ...messages: unknown[]): void;
   error(tag: string, ...messages: unknown[]): void;
@@ -4789,9 +4795,9 @@ declare const logger: {
  * These functions can be slightly faster than the ones in Lodash.
  * @packageDocumentation
  */
-declare function clamp(num: number, lower: number, upper: number): number;
-declare function rand(min: number, max: number): number;
-declare function MBToByte(value: number): number;
+export declare function clamp(num: number, lower: number, upper: number): number;
+export declare function rand(min: number, max: number): number;
+export declare function MBToByte(value: number): number;
 //#endregion
 //#region src/utils/obj.d.ts
 /**
@@ -4802,7 +4808,7 @@ declare function MBToByte(value: number): number;
  * @param fromKey - Key of the property in source object.
  * @param toKey - Key of the property in destination object.
  */
-declare function copyProperty<From, FromKey extends keyof From, ToKey extends keyof any, To extends Partial<Record<ToKey, From[FromKey]>>>(type: string, from: From, to: To, fromKey: FromKey, toKey: ToKey): void;
+export declare function copyProperty<From, FromKey extends keyof From, ToKey extends keyof any, To extends Partial<Record<ToKey, From[FromKey]>>>(type: string, from: From, to: To, fromKey: FromKey, toKey: ToKey): void;
 /**
  * Copies an array at `key`, filtering the items that match the `type`.
  * @param type - Type expected to match `typeof` on the items.
@@ -4811,11 +4817,11 @@ declare function copyProperty<From, FromKey extends keyof From, ToKey extends ke
  * @param fromKey - Key of the array property in source object.
  * @param toKey - Key of the array property in destination object.
  */
-declare function copyArray<FromKey extends keyof any, From extends Partial<Record<FromKey, any[]>>, ToKey extends keyof any, To extends Partial<Record<ToKey, any[]>>>(type: string, from: From, to: To, fromKey: FromKey, toKey: ToKey): void;
+export declare function copyArray<FromKey extends keyof any, From extends Partial<Record<FromKey, any[]>>, ToKey extends keyof any, To extends Partial<Record<ToKey, any[]>>>(type: string, from: From, to: To, fromKey: FromKey, toKey: ToKey): void;
 /**
  * @see {@link https://www.typescriptlang.org/docs/handbook/mixins.html}
  */
-declare function applyMixins(derivedCtor: new (...args: any[]) => any, baseCtors: Array<new (...args: any[]) => any>): void;
+export declare function applyMixins(derivedCtor: new (...args: any[]) => any, baseCtors: Array<new (...args: any[]) => any>): void;
 //#endregion
 //#region src/utils/string.d.ts
 /**
@@ -4823,15 +4829,16 @@ declare function applyMixins(derivedCtor: new (...args: any[]) => any, baseCtors
  * @param url - URL of a file.
  * @return Name of the parent folder, or the file itself if it has no parent folder.
  */
-declare function folderName(url: string): string;
+export declare function folderName(url: string): string;
 //#endregion
 //#region src/utils/url.d.ts
 /**
  * Resolves a path/URL against a base string without relying on Node's `url` module.
  */
-declare function resolveURL(base: string, path: string): string;
-//#endregion
-//#region src/types/cubism-shim.d.ts
+export declare function resolveURL(base: string, path: string): string;
+declare namespace cubism_shim_d_exports {
+  export { Expression, FileReferences, Group, HitArea, ModelJSON, Motion };
+}
 interface Motion {
   File: string;
   FadeInTime?: number;
@@ -5704,8 +5711,8 @@ declare class CubismModelSettingJson extends ICubismModelSetting {
 //#endregion
 //#region src/cubism/CubismModelSettings.d.ts
 type CubismModelSettingJsonMixin = Omit<CubismModelSettingJson, 'name'>;
-interface CubismModelSettings extends CubismModelSettingJsonMixin {}
-declare class CubismModelSettings extends ModelSettings {
+export interface CubismModelSettings extends CubismModelSettingJsonMixin {}
+export declare class CubismModelSettings extends ModelSettings {
   json: ModelJSON;
   moc: string;
   textures: string[];
@@ -5730,7 +5737,7 @@ declare class CubismModelSettings extends ModelSettings {
 }
 //#endregion
 //#region src/cubism/CubismExpressionManager.d.ts
-declare class CubismExpressionManager extends ExpressionManager<CubismExpressionMotion, Expression> {
+export declare class CubismExpressionManager extends ExpressionManager<CubismExpressionMotion, Expression> {
   readonly expressionDataType: "arraybuffer";
   readonly definitions: Expression[];
   /** Active fade entries in activation order; deactivated ones stay until fully faded out. */
@@ -6897,7 +6904,7 @@ declare class CubismRenderer_WebGL extends CubismRenderer {
 }
 //#endregion
 //#region src/cubism/CubismMotionManager.d.ts
-declare class CubismMotionManager extends MotionManager<CubismMotion, Motion> {
+export declare class CubismMotionManager extends MotionManager<CubismMotion, Motion> {
   readonly definitions: Partial<Record<string, Motion[]>>;
   readonly groups: {
     readonly idle: "Idle";
@@ -6926,7 +6933,7 @@ declare class CubismMotionManager extends MotionManager<CubismMotion, Motion> {
 }
 //#endregion
 //#region src/cubism/CubismParallelMotionManager.d.ts
-declare class CubismParallelMotionManager extends ParallelMotionManager<CubismMotion, Motion> {
+export declare class CubismParallelMotionManager extends ParallelMotionManager<CubismMotion, Motion> {
   readonly queueManager: CubismMotionQueueManager;
   readonly settings: CubismModelSettings;
   constructor(parent: CubismInternalModel);
@@ -6941,7 +6948,7 @@ declare class CubismParallelMotionManager extends ParallelMotionManager<CubismMo
 }
 //#endregion
 //#region src/cubism/CubismInternalModel.d.ts
-declare class CubismInternalModel extends InternalModel {
+export declare class CubismInternalModel extends InternalModel {
   settings: CubismModelSettings;
   options: InternalModelOptions;
   coreModel: CubismModel;
@@ -6949,6 +6956,8 @@ declare class CubismInternalModel extends InternalModel {
   parallelMotionManager: CubismParallelMotionManager[];
   lipSync: boolean;
   breath: CubismBreath;
+  /** Whether the idle breath contributes at all; see {@link setBreath}. */
+  breathEnabled: boolean;
   eyeBlink?: CubismEyeBlink;
   pose?: CubismPose;
   physics?: CubismPhysics;
@@ -6988,6 +6997,16 @@ declare class CubismInternalModel extends InternalModel {
   update(dt: DOMHighResTimeStamp, now: DOMHighResTimeStamp): void;
   updateFocus(): void;
   updateFacialEmotion(mouthForm: number): void;
+  /**
+   * The idle breath set, scaled by `breathDepth`. Amplitudes and periods are the Cubism sample's
+   * own: a head sway across `ParamAngle*`/`ParamBodyAngleX` alongside `ParamBreath` itself.
+   */
+  protected applyBreathParameters(): void;
+  /**
+   * Retune the idle breath live. `enabled: false` stops the contribution outright rather than
+   * scaling it to nothing, so a host can turn it off without losing the depth it returns to.
+   */
+  setBreath(enabled: boolean, depth?: number): void;
   updateNaturalMovements(dt: DOMHighResTimeStamp, _now: DOMHighResTimeStamp): void;
   draw(gl: WebGLRenderingContext): void;
   extendParallelMotionManager(managerCount: number): void;
@@ -7004,20 +7023,20 @@ interface CubismConfig {
 /**
  * Configures global Cubism startup settings.
  */
-declare function configureCubismSDK(config?: CubismConfig): void;
+export declare function configureCubismSDK(config?: CubismConfig): void;
 /**
  * Promises that the Cubism framework is ready to work.
  * @return Promise that resolves if the startup has succeeded, rejects if failed.
  */
-declare function cubismReady(): Promise<void>;
+export declare function cubismReady(): Promise<void>;
 /**
  * Starts up the Cubism framework.
  */
-declare function startUpCubism(options?: Option, memorySizeMB?: number): void;
+export declare function startUpCubism(options?: Option, memorySizeMB?: number): void;
 /**
  * Reconfigures Cubism settings and restarts the framework so they take effect.
  */
-declare function reconfigureCubismSDK(config?: CubismConfig): void;
+export declare function reconfigureCubismSDK(config?: CubismConfig): void;
 //#endregion
-export { Bounds, CommonHitArea, type CommonLayout, Constant, type CreateTextureOptions, CubismExpressionManager, CubismFramework, CubismInternalModel, CubismModelSettings, CubismMotionManager, CubismParallelMotionManager, ExpressionManager, type ExpressionManagerEvents, ExtendedFileList, FileLoader, FocusController, InternalModel, type InternalModelEvents, InternalModelOptions, type JSONObject, LOGICAL_HEIGHT, LOGICAL_WIDTH, Live2DConstructor, Live2DFactory, Live2DFactoryContext, Live2DFactoryOptions, Live2DLoader, Live2DLoaderContext, Live2DLoaderTarget, Live2DModel, type Live2DModelEvents, Live2DModelOptions, Live2DPlugin, Live2DRuntime, type Live2DTextureLODFilter, type Live2DTextureLODMode, type Live2DTextureLODOptions, type Live2DTextureSourceOptions, Live2DTransform, LogLevel, MBToByte, ModelSettings, MotionManager, type MotionManagerEvents, MotionManagerOptions, MotionPreloadStrategy, MotionPriority, MotionStartOptions, MotionStartRandomOptions, MotionState, type Mutable, Option, SoundManager, type TextureLODPlan, type TextureLODPlanInput, VOLUME, XHRLoader, applyMixins, clamp, config, configureCubismSDK, copyArray, copyProperty, csmDelete, cubismReady, folderName, logger, normalizeHitAreaDefs, rand, reconfigureCubismSDK, remove, resolveURL, startUpCubism, strtod };
+export type { CommonLayout, CreateTextureOptions, ExpressionManagerEvents, InternalModelEvents, JSONObject, Live2DModelEvents, Live2DTextureLODFilter, Live2DTextureLODMode, Live2DTextureLODOptions, Live2DTextureSourceOptions, MotionManagerEvents, Mutable, TextureLODPlan, TextureLODPlanInput };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -15140,6 +15140,8 @@ var CubismInternalModel = class extends InternalModel {
 	parallelMotionManager;
 	lipSync = true;
 	breath = CubismBreath.create();
+	/** Whether the idle breath contributes at all; see {@link setBreath}. */
+	breathEnabled = true;
 	eyeBlink;
 	renderer = new CubismRenderer_WebGL(0, 0);
 	idManager;
@@ -15192,13 +15194,7 @@ var CubismInternalModel = class extends InternalModel {
 			eyeBlink.setParameterIds?.(parameterIds);
 			this.eyeBlink = eyeBlink;
 		}
-		this.breath.setParameters([
-			new BreathParameterData(this.idParamAngleX, 0, 15 * this.options.breathDepth, 6.5345, .5),
-			new BreathParameterData(this.idParamAngleY, 0, 8 * this.options.breathDepth, 3.5345, .5),
-			new BreathParameterData(this.idParamAngleZ, 0, 10 * this.options.breathDepth, 5.5345, .5),
-			new BreathParameterData(this.idParamBodyAngleX, 0, 4 * this.options.breathDepth, 15.5345, .5),
-			new BreathParameterData(this.idParamBreath, 0, .5, 3.2345, .5)
-		]);
+		this.applyBreathParameters();
 		this.renderer.initialize(this.coreModel, getRequiredMaskRenderTextureCount(this.coreModel));
 		this.renderer.useHighPrecisionMask(this.renderer.isUsingHighPrecisionMask() || resolveHighPrecisionMaskOption(this.coreModel, this.options.useHighPrecisionMask));
 		this.renderer.setIsPremultipliedAlpha(true);
@@ -15315,8 +15311,31 @@ var CubismInternalModel = class extends InternalModel {
 	updateFacialEmotion(mouthForm) {
 		this.coreModel.addParameterValueById(this.idParamMouthForm, mouthForm);
 	}
+	/**
+	* The idle breath set, scaled by `breathDepth`. Amplitudes and periods are the Cubism sample's
+	* own: a head sway across `ParamAngle*`/`ParamBodyAngleX` alongside `ParamBreath` itself.
+	*/
+	applyBreathParameters() {
+		const depth = this.options.breathDepth ?? 1;
+		this.breath.setParameters([
+			new BreathParameterData(this.idParamAngleX, 0, 15 * depth, 6.5345, .5),
+			new BreathParameterData(this.idParamAngleY, 0, 8 * depth, 3.5345, .5),
+			new BreathParameterData(this.idParamAngleZ, 0, 10 * depth, 5.5345, .5),
+			new BreathParameterData(this.idParamBodyAngleX, 0, 4 * depth, 15.5345, .5),
+			new BreathParameterData(this.idParamBreath, 0, .5 * depth, 3.2345, .5)
+		]);
+	}
+	/**
+	* Retune the idle breath live. `enabled: false` stops the contribution outright rather than
+	* scaling it to nothing, so a host can turn it off without losing the depth it returns to.
+	*/
+	setBreath(enabled, depth = this.options.breathDepth ?? 1) {
+		this.breathEnabled = enabled;
+		this.options.breathDepth = depth;
+		this.applyBreathParameters();
+	}
 	updateNaturalMovements(dt, _now) {
-		this.breath?.updateParameters(this.coreModel, dt / 1e3);
+		if (this.breathEnabled) this.breath?.updateParameters(this.coreModel, dt / 1e3);
 	}
 	draw(gl) {
 		const matrix = this.drawingMatrix;