@momoyu-ink/kit 0.13.0 → 0.14.0

package/dist/{jsx-dev-runtime-Dvhilv0K.d.mts → jsx-dev-runtime-CowyIagD.d.mts}

@@ -138,6 +138,43 @@ type GamepadCommand = {
     params: EffectParams;
 };
 
+type Live2dCommand = {
+    subCommand: 'startMotion';
+    group: string;
+    index: number;
+    priority?: number;
+    fadeIn?: number;
+    fadeOut?: number;
+    loop?: boolean;
+} | {
+    subCommand: 'stopAllMotions';
+} | {
+    subCommand: 'setExpression';
+    name: string;
+} | {
+    subCommand: 'stopExpression';
+} | {
+    subCommand: 'setParameter';
+    id: string;
+    value: number;
+} | {
+    subCommand: 'setParameters';
+    values: {
+        [key in string]: number;
+    };
+} | {
+    subCommand: 'resetParameters';
+} | {
+    subCommand: 'setPartOpacity';
+    id: string;
+    value: number;
+} | {
+    subCommand: 'hitTest';
+    area: string;
+    x: number;
+    y: number;
+};
+
 type WarpBoundary = 'before' | 'after';
 
 type JsonValue = number | string | boolean | Array<JsonValue> | {
@@ -147,6 +184,10 @@ type JsonValue = number | string | boolean | Array<JsonValue> | {
 type ScenarioCommand = {
     subCommand: 'addStory';
     name: string;
+} | {
+    subCommand: 'addStoryFromContent';
+    name: string;
+    content: string;
 } | {
     subCommand: 'replaceStoryData';
     name: string;
@@ -297,6 +338,56 @@ type ShaderCommand = {
     subCommand: 'reset';
 };
 
+type SpineCommand = {
+    "subCommand": "setAnimation";
+    track: number;
+    animation: string;
+    loop?: boolean;
+    /**
+     * Transition duration; negative keeps the runtime's default.
+     */
+    mix?: number;
+    delay?: number;
+    /**
+     * Start offset in seconds.
+     */
+    time?: number;
+} | {
+    "subCommand": "addAnimation";
+    track: number;
+    animation: string;
+    loop?: boolean;
+    mix?: number;
+    delay?: number;
+    time?: number;
+} | {
+    "subCommand": "clearTrack";
+    track: number;
+    mix?: number;
+} | {
+    "subCommand": "clearTracks";
+} | {
+    "subCommand": "setDefaultMix";
+    duration: number;
+} | {
+    "subCommand": "setMix";
+    from: string;
+    to: string;
+    duration: number;
+} | {
+    "subCommand": "setAttachment";
+    slot: string;
+    name: string;
+} | {
+    "subCommand": "resetToSetupPose";
+} | {
+    "subCommand": "resetPhysics";
+} | {
+    "subCommand": "hitTest";
+    x: number;
+    y: number;
+};
+
 type OverlayDialog = 'friends' | 'community' | 'players' | 'settings' | 'officialGameGroup' | 'stats' | 'achievements';
 
 type OverlayNotificationPosition = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
@@ -429,7 +520,7 @@ type SteamCommand = {
 
 type ReadFormat = 'text' | 'binary';
 
-type WindowState = "idle" | "maximized" | "minimized" | "fullscreen";
+type WindowState = 'idle' | 'maximized' | 'minimized' | 'fullscreen';
 
 type SystemCommand = {
     subCommand: 'setWindowSize';
@@ -976,6 +1067,250 @@ type VideoProps = {
     muted?: boolean;
 };
 
+/**
+ * Canvas geometry of a model, in canvas pixels.
+ */
+type Live2dCanvas = {
+    width: number;
+    height: number;
+    originX: number;
+    originY: number;
+    pixelsPerUnit: number;
+};
+
+/**
+ * One expression of the model.
+ */
+type Live2dExpression = {
+    name: string;
+    fadeIn: number;
+    fadeOut: number;
+};
+
+/**
+ * One motion of the model.
+ */
+type Live2dMotion = {
+    group: string;
+    index: number;
+    duration: number;
+    fadeIn: number;
+    fadeOut: number;
+    /**
+     * Sound file path relative to the model directory; absent when the motion
+     * carries no sound.
+     */
+    sound?: string;
+};
+
+/**
+ * One model parameter.
+ */
+type Live2dParameter = {
+    id: string;
+    /**
+     * Parameter type: -1 unknown, 0 normal, 1 blend shape.
+     */
+    kind: number;
+    min: number;
+    max: number;
+    default: number;
+};
+
+/**
+ * Everything the `ready` event reports about a loaded model.
+ */
+type Live2dMetadata = {
+    canvas: Live2dCanvas;
+    motions: Array<Live2dMotion>;
+    expressions: Array<Live2dExpression>;
+    hitAreas: Array<string>;
+    parameters: Array<Live2dParameter>;
+};
+
+/**
+ * Events emitted by the `live2d` node.
+ */
+type Live2dEvent = ({
+    type: 'ready';
+} & Live2dMetadata) | {
+    type: 'motionFinished';
+    group: string;
+    index: number;
+} | {
+    type: 'motionEvent';
+    value: string;
+} | {
+    type: 'blendModeUnsupported';
+    value: number;
+} | {
+    type: 'hit';
+    area: string;
+    x: number;
+    y: number;
+} | {
+    type: 'error';
+    code: number;
+    message: string;
+};
+
+type Live2dProps = {
+    src: string | null;
+    physics?: boolean;
+    pose?: boolean;
+    blink?: boolean;
+    breath?: boolean;
+    look?: boolean;
+    idle?: boolean;
+    hitTest?: boolean;
+};
+
+/**
+ * Identity of one playback.
+ *
+ * `entry` is assigned by the plugin and stays unique within one loaded model;
+ * `epoch` is bumped by the host on every model change. Together they survive a
+ * reload: an entry id is reused after the plugin drops the old model, so a
+ * waiter that only compared `entry` would match the wrong playback.
+ */
+type EntryIdentity = {
+    entry: bigint;
+    epoch: bigint;
+};
+
+/**
+ * One animation of the model.
+ */
+type SpineAnimation = {
+    name: string;
+    /**
+     * Length in seconds; zero for animations that only hold a pose.
+     */
+    duration: number;
+};
+
+/**
+ * A rectangle in world units with y up.
+ */
+type SpineBounds = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+
+/**
+ * Where the `premultiplied` flag came from.
+ */
+type AlphaSource = "atlas" | "image";
+
+/**
+ * One texture page of the model.
+ */
+type SpinePage = {
+    /**
+     * Image path relative to the asset root.
+     */
+    path: string;
+    width: number;
+    height: number;
+    /**
+     * Whether the source alpha is already premultiplied.
+     */
+    premultiplied: boolean;
+    /**
+     * How the page declares premultiplied alpha, for diagnostics.
+     */
+    alphaSource: AlphaSource;
+};
+
+/**
+ * Everything the `ready` event reports about a loaded model.
+ */
+type SpineMetadata = {
+    /**
+     * Skeleton data version string, as written by the Spine Editor.
+     *
+     * Diagnostic only: it never selects a runtime.
+     */
+    dataVersion: string;
+    /**
+     * Bounds measured once at load in the setup pose, in world units.
+     *
+     * This is the layout rectangle: it does not follow animations or skin
+     * changes, and it is not a clip boundary.
+     */
+    bounds: SpineBounds;
+    animations: Array<SpineAnimation>;
+    skins: Array<string>;
+    pages: Array<SpinePage>;
+    boundingBoxes: Array<string>;
+};
+
+/**
+ * Events emitted by the `spine` node.
+ */
+type SpineEvent = {
+    "type": "ready";
+} & SpineMetadata | {
+    "type": "trackStart";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackComplete";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackEnd";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackDispose";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackEvent";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+    name: string;
+    intValue: number;
+    floatValue: number;
+    stringValue: string;
+    audioPath: string;
+    volume: number;
+    balance: number;
+} | {
+    "type": "hit";
+    epoch: bigint;
+    name: string;
+    x: number;
+    y: number;
+} | {
+    "type": "error";
+    code: number;
+    message: string;
+};
+
+/**
+ * How the runtime advances physics constraints.
+ */
+type PhysicsMode = "none" | "pose" | "update";
+
+type SpineProps = {
+    src: string | null;
+    atlas?: string;
+    skin?: string;
+    timeScale?: number;
+    paused?: boolean;
+    physics?: PhysicsMode;
+    hitArea?: boolean;
+};
+
 type Tuple2 = [number, number];
 type Tuple3 = [number, number, number];
 type Tuple4 = [number, number, number, number];
@@ -1046,6 +1381,63 @@ type MoyuVideoAttributes = VideoProps & MoyuNodeAttributes & {
     onEnded?: () => void;
     onStateChange?: (state: string) => void;
 };
+type MoyuLive2dAttributes = Live2dProps & MoyuNodeAttributes & {
+    /** The model finished loading; the payload holds its full metadata. */
+    onReady?: (event: Extract<Live2dEvent, {
+        type: 'ready';
+    }>) => void;
+    onMotionFinished?: (event: Extract<Live2dEvent, {
+        type: 'motionFinished';
+    }>) => void;
+    onMotionEvent?: (event: Extract<Live2dEvent, {
+        type: 'motionEvent';
+    }>) => void;
+    onBlendModeUnsupported?: (event: Extract<Live2dEvent, {
+        type: 'blendModeUnsupported';
+    }>) => void;
+    /**
+     * A press landed on a hit area, reported per area when several overlap.
+     * Requires the `hitTest` prop.
+     */
+    onHit?: (event: Extract<Live2dEvent, {
+        type: 'hit';
+    }>) => void;
+    onError?: (event: Extract<Live2dEvent, {
+        type: 'error';
+    }>) => void;
+};
+type MoyuSpineAttributes = SpineProps & MoyuNodeAttributes & {
+    /** The model finished parsing; the payload holds its full metadata. */
+    onReady?: (event: Extract<SpineEvent, {
+        type: 'ready';
+    }>) => void;
+    onTrackStart?: (event: Extract<SpineEvent, {
+        type: 'trackStart';
+    }>) => void;
+    onTrackComplete?: (event: Extract<SpineEvent, {
+        type: 'trackComplete';
+    }>) => void;
+    onTrackEnd?: (event: Extract<SpineEvent, {
+        type: 'trackEnd';
+    }>) => void;
+    /**
+     * The terminal signal for a playback: it fires for completion,
+     * interruption and cancellation alike, so waiting on it always returns.
+     */
+    onTrackDispose?: (event: Extract<SpineEvent, {
+        type: 'trackDispose';
+    }>) => void;
+    onTrackEvent?: (event: Extract<SpineEvent, {
+        type: 'trackEvent';
+    }>) => void;
+    /** A press landed inside a named bounding box; requires the `hitArea` prop. */
+    onHit?: (event: Extract<SpineEvent, {
+        type: 'hit';
+    }>) => void;
+    onError?: (event: Extract<SpineEvent, {
+        type: 'error';
+    }>) => void;
+};
 type MoyuSpriteAttributes = SpriteProps & MoyuNodeAttributes;
 type MoyuTextAttributes = TextProps & MoyuNodeAttributes & {
     onStart?: () => void;
@@ -1085,6 +1477,8 @@ declare namespace JSX {
         shader: DetailedMoyuProps<MoyuShaderAttributes>;
         'shader-slot': DetailedMoyuProps<MoyuShaderSlotAttributes>;
         video: DetailedMoyuProps<MoyuVideoAttributes>;
+        live2d: DetailedMoyuProps<MoyuLive2dAttributes>;
+        spine: DetailedMoyuProps<MoyuSpineAttributes>;
     }
 }
 
@@ -1101,8 +1495,8 @@ type MakeNullOptional<T> = T extends unknown ? {
 } : never;
 declare function mergeEvent<T extends BubbleEvent, K extends BubbleEvent>(handlers: MoyuEventHandler<T> | readonly MoyuEventHandler<T>[] | undefined, defaultHandler?: MoyuEventHandler<K>): (event: T | K) => void;
 
-type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SteamCommand | SystemCommand | VideoCommand;
+type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand | Live2dCommand | ScenarioCommand | ShaderCommand | SpineCommand | SteamCommand | SystemCommand | VideoCommand;
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
-export { type ShaderParam as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuHBoxAttributes as F, type GamepadCommand as G, type MoyuListenerAttributes as H, type MoyuShaderAttributes as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, type MoyuShaderSlotAttributes as N, type MoyuVideoAttributes as O, Node as P, type OverlayDialog as Q, type OverlayNotificationPosition as R, type ShaderDirection as S, type TouchEvent as T, type OverlayStoreFlag as U, type PlatformInfo as V, type WheelEvent as W, type PointerEventKind as X, type RetainMode as Y, type ScenarioCommand as Z, type ShaderCommand as _, type MaybePromise as a, type ShaderParamType as a0, type ShaderSource as a1, type ShaderTimeControl as a2, type SteamCommand as a3, type SystemCommand as a4, type TextCommand as a5, type TextInteractionEvent as a6, type TextLayoutEvent as a7, type TimelinePossibleClip as a8, type TouchEventKind as a9, type Tuple2 as aa, type Tuple3 as ab, type Tuple4 as ac, type VideoCommand as ad, type WheelEventDeltaMode as ae, type WindowState as af, createBubbleEvent as ag, getPlatform as ah, getStageSize as ai, mergeEvent as aj, type MoyuClipAttributes as b, type MoyuVBoxAttributes as c, type MoyuSpriteAttributes as d, type TextProps as e, type MoyuNodeAttributes as f, type MouseEvent as g, type MoyuTextAttributes as h, type EditableChangeSource as i, type SpriteProps as j, type JsonValue as k, type AudioSettings as l, type EditableCommand as m, type EditableEvent as n, type EffectParams as o, type KeyboardEventKind as p, type MakeNullOptional as q, MouseButton as r, MouseButtons as s, type MouseEventKind as t, type MoyuAnimationAttributes as u, type MoyuBackdropAttributes as v, type MoyuContainerAttributes as w, type MoyuEditableAttributes as x, type MoyuEventHandler as y, type MoyuFilterAttributes as z };
+export { type OverlayStoreFlag as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuContainerAttributes as F, type GamepadCommand as G, type MoyuEditableAttributes as H, type MoyuEventHandler as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, type MoyuFilterAttributes as N, type MoyuHBoxAttributes as O, type MoyuListenerAttributes as P, type MoyuLive2dAttributes as Q, type MoyuShaderAttributes as R, type ShaderDirection as S, type TouchEvent as T, type MoyuShaderSlotAttributes as U, type MoyuSpineAttributes as V, type WheelEvent as W, type MoyuVideoAttributes as X, Node as Y, type OverlayDialog as Z, type OverlayNotificationPosition as _, type MaybePromise as a, type PlatformInfo as a0, type PointerEventKind as a1, type RetainMode as a2, type ScenarioCommand as a3, type ShaderCommand as a4, type ShaderParam as a5, type ShaderParamType as a6, type ShaderSource as a7, type ShaderTimeControl as a8, type SpineCommand as a9, type SpineEvent as aa, type SpineMetadata as ab, type SteamCommand as ac, type SystemCommand as ad, type TextCommand as ae, type TextInteractionEvent as af, type TextLayoutEvent as ag, type TimelinePossibleClip as ah, type TouchEventKind as ai, type Tuple2 as aj, type Tuple3 as ak, type Tuple4 as al, type VideoCommand as am, type WheelEventDeltaMode as an, type WindowState as ao, createBubbleEvent as ap, getPlatform as aq, getStageSize as ar, mergeEvent as as, type MoyuClipAttributes as b, type MoyuVBoxAttributes as c, type MoyuSpriteAttributes as d, type TextProps as e, type MoyuNodeAttributes as f, type MouseEvent as g, type MoyuTextAttributes as h, type EditableChangeSource as i, type SpriteProps as j, type JsonValue as k, type AudioSettings as l, type EditableCommand as m, type EditableEvent as n, type EffectParams as o, type EntryIdentity as p, type KeyboardEventKind as q, type Live2dCommand as r, type Live2dEvent as s, type Live2dMetadata as t, type MakeNullOptional as u, MouseButton as v, MouseButtons as w, type MouseEventKind as x, type MoyuAnimationAttributes as y, type MoyuBackdropAttributes as z };

package/dist/{jsx-dev-runtime-Dvhilv0K.d.ts → jsx-dev-runtime-CowyIagD.d.ts}

@@ -138,6 +138,43 @@ type GamepadCommand = {
     params: EffectParams;
 };
 
+type Live2dCommand = {
+    subCommand: 'startMotion';
+    group: string;
+    index: number;
+    priority?: number;
+    fadeIn?: number;
+    fadeOut?: number;
+    loop?: boolean;
+} | {
+    subCommand: 'stopAllMotions';
+} | {
+    subCommand: 'setExpression';
+    name: string;
+} | {
+    subCommand: 'stopExpression';
+} | {
+    subCommand: 'setParameter';
+    id: string;
+    value: number;
+} | {
+    subCommand: 'setParameters';
+    values: {
+        [key in string]: number;
+    };
+} | {
+    subCommand: 'resetParameters';
+} | {
+    subCommand: 'setPartOpacity';
+    id: string;
+    value: number;
+} | {
+    subCommand: 'hitTest';
+    area: string;
+    x: number;
+    y: number;
+};
+
 type WarpBoundary = 'before' | 'after';
 
 type JsonValue = number | string | boolean | Array<JsonValue> | {
@@ -147,6 +184,10 @@ type JsonValue = number | string | boolean | Array<JsonValue> | {
 type ScenarioCommand = {
     subCommand: 'addStory';
     name: string;
+} | {
+    subCommand: 'addStoryFromContent';
+    name: string;
+    content: string;
 } | {
     subCommand: 'replaceStoryData';
     name: string;
@@ -297,6 +338,56 @@ type ShaderCommand = {
     subCommand: 'reset';
 };
 
+type SpineCommand = {
+    "subCommand": "setAnimation";
+    track: number;
+    animation: string;
+    loop?: boolean;
+    /**
+     * Transition duration; negative keeps the runtime's default.
+     */
+    mix?: number;
+    delay?: number;
+    /**
+     * Start offset in seconds.
+     */
+    time?: number;
+} | {
+    "subCommand": "addAnimation";
+    track: number;
+    animation: string;
+    loop?: boolean;
+    mix?: number;
+    delay?: number;
+    time?: number;
+} | {
+    "subCommand": "clearTrack";
+    track: number;
+    mix?: number;
+} | {
+    "subCommand": "clearTracks";
+} | {
+    "subCommand": "setDefaultMix";
+    duration: number;
+} | {
+    "subCommand": "setMix";
+    from: string;
+    to: string;
+    duration: number;
+} | {
+    "subCommand": "setAttachment";
+    slot: string;
+    name: string;
+} | {
+    "subCommand": "resetToSetupPose";
+} | {
+    "subCommand": "resetPhysics";
+} | {
+    "subCommand": "hitTest";
+    x: number;
+    y: number;
+};
+
 type OverlayDialog = 'friends' | 'community' | 'players' | 'settings' | 'officialGameGroup' | 'stats' | 'achievements';
 
 type OverlayNotificationPosition = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
@@ -429,7 +520,7 @@ type SteamCommand = {
 
 type ReadFormat = 'text' | 'binary';
 
-type WindowState = "idle" | "maximized" | "minimized" | "fullscreen";
+type WindowState = 'idle' | 'maximized' | 'minimized' | 'fullscreen';
 
 type SystemCommand = {
     subCommand: 'setWindowSize';
@@ -976,6 +1067,250 @@ type VideoProps = {
     muted?: boolean;
 };
 
+/**
+ * Canvas geometry of a model, in canvas pixels.
+ */
+type Live2dCanvas = {
+    width: number;
+    height: number;
+    originX: number;
+    originY: number;
+    pixelsPerUnit: number;
+};
+
+/**
+ * One expression of the model.
+ */
+type Live2dExpression = {
+    name: string;
+    fadeIn: number;
+    fadeOut: number;
+};
+
+/**
+ * One motion of the model.
+ */
+type Live2dMotion = {
+    group: string;
+    index: number;
+    duration: number;
+    fadeIn: number;
+    fadeOut: number;
+    /**
+     * Sound file path relative to the model directory; absent when the motion
+     * carries no sound.
+     */
+    sound?: string;
+};
+
+/**
+ * One model parameter.
+ */
+type Live2dParameter = {
+    id: string;
+    /**
+     * Parameter type: -1 unknown, 0 normal, 1 blend shape.
+     */
+    kind: number;
+    min: number;
+    max: number;
+    default: number;
+};
+
+/**
+ * Everything the `ready` event reports about a loaded model.
+ */
+type Live2dMetadata = {
+    canvas: Live2dCanvas;
+    motions: Array<Live2dMotion>;
+    expressions: Array<Live2dExpression>;
+    hitAreas: Array<string>;
+    parameters: Array<Live2dParameter>;
+};
+
+/**
+ * Events emitted by the `live2d` node.
+ */
+type Live2dEvent = ({
+    type: 'ready';
+} & Live2dMetadata) | {
+    type: 'motionFinished';
+    group: string;
+    index: number;
+} | {
+    type: 'motionEvent';
+    value: string;
+} | {
+    type: 'blendModeUnsupported';
+    value: number;
+} | {
+    type: 'hit';
+    area: string;
+    x: number;
+    y: number;
+} | {
+    type: 'error';
+    code: number;
+    message: string;
+};
+
+type Live2dProps = {
+    src: string | null;
+    physics?: boolean;
+    pose?: boolean;
+    blink?: boolean;
+    breath?: boolean;
+    look?: boolean;
+    idle?: boolean;
+    hitTest?: boolean;
+};
+
+/**
+ * Identity of one playback.
+ *
+ * `entry` is assigned by the plugin and stays unique within one loaded model;
+ * `epoch` is bumped by the host on every model change. Together they survive a
+ * reload: an entry id is reused after the plugin drops the old model, so a
+ * waiter that only compared `entry` would match the wrong playback.
+ */
+type EntryIdentity = {
+    entry: bigint;
+    epoch: bigint;
+};
+
+/**
+ * One animation of the model.
+ */
+type SpineAnimation = {
+    name: string;
+    /**
+     * Length in seconds; zero for animations that only hold a pose.
+     */
+    duration: number;
+};
+
+/**
+ * A rectangle in world units with y up.
+ */
+type SpineBounds = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+
+/**
+ * Where the `premultiplied` flag came from.
+ */
+type AlphaSource = "atlas" | "image";
+
+/**
+ * One texture page of the model.
+ */
+type SpinePage = {
+    /**
+     * Image path relative to the asset root.
+     */
+    path: string;
+    width: number;
+    height: number;
+    /**
+     * Whether the source alpha is already premultiplied.
+     */
+    premultiplied: boolean;
+    /**
+     * How the page declares premultiplied alpha, for diagnostics.
+     */
+    alphaSource: AlphaSource;
+};
+
+/**
+ * Everything the `ready` event reports about a loaded model.
+ */
+type SpineMetadata = {
+    /**
+     * Skeleton data version string, as written by the Spine Editor.
+     *
+     * Diagnostic only: it never selects a runtime.
+     */
+    dataVersion: string;
+    /**
+     * Bounds measured once at load in the setup pose, in world units.
+     *
+     * This is the layout rectangle: it does not follow animations or skin
+     * changes, and it is not a clip boundary.
+     */
+    bounds: SpineBounds;
+    animations: Array<SpineAnimation>;
+    skins: Array<string>;
+    pages: Array<SpinePage>;
+    boundingBoxes: Array<string>;
+};
+
+/**
+ * Events emitted by the `spine` node.
+ */
+type SpineEvent = {
+    "type": "ready";
+} & SpineMetadata | {
+    "type": "trackStart";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackComplete";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackEnd";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackDispose";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+} | {
+    "type": "trackEvent";
+    track: number;
+    id: EntryIdentity;
+    animation: string;
+    name: string;
+    intValue: number;
+    floatValue: number;
+    stringValue: string;
+    audioPath: string;
+    volume: number;
+    balance: number;
+} | {
+    "type": "hit";
+    epoch: bigint;
+    name: string;
+    x: number;
+    y: number;
+} | {
+    "type": "error";
+    code: number;
+    message: string;
+};
+
+/**
+ * How the runtime advances physics constraints.
+ */
+type PhysicsMode = "none" | "pose" | "update";
+
+type SpineProps = {
+    src: string | null;
+    atlas?: string;
+    skin?: string;
+    timeScale?: number;
+    paused?: boolean;
+    physics?: PhysicsMode;
+    hitArea?: boolean;
+};
+
 type Tuple2 = [number, number];
 type Tuple3 = [number, number, number];
 type Tuple4 = [number, number, number, number];
@@ -1046,6 +1381,63 @@ type MoyuVideoAttributes = VideoProps & MoyuNodeAttributes & {
     onEnded?: () => void;
     onStateChange?: (state: string) => void;
 };
+type MoyuLive2dAttributes = Live2dProps & MoyuNodeAttributes & {
+    /** The model finished loading; the payload holds its full metadata. */
+    onReady?: (event: Extract<Live2dEvent, {
+        type: 'ready';
+    }>) => void;
+    onMotionFinished?: (event: Extract<Live2dEvent, {
+        type: 'motionFinished';
+    }>) => void;
+    onMotionEvent?: (event: Extract<Live2dEvent, {
+        type: 'motionEvent';
+    }>) => void;
+    onBlendModeUnsupported?: (event: Extract<Live2dEvent, {
+        type: 'blendModeUnsupported';
+    }>) => void;
+    /**
+     * A press landed on a hit area, reported per area when several overlap.
+     * Requires the `hitTest` prop.
+     */
+    onHit?: (event: Extract<Live2dEvent, {
+        type: 'hit';
+    }>) => void;
+    onError?: (event: Extract<Live2dEvent, {
+        type: 'error';
+    }>) => void;
+};
+type MoyuSpineAttributes = SpineProps & MoyuNodeAttributes & {
+    /** The model finished parsing; the payload holds its full metadata. */
+    onReady?: (event: Extract<SpineEvent, {
+        type: 'ready';
+    }>) => void;
+    onTrackStart?: (event: Extract<SpineEvent, {
+        type: 'trackStart';
+    }>) => void;
+    onTrackComplete?: (event: Extract<SpineEvent, {
+        type: 'trackComplete';
+    }>) => void;
+    onTrackEnd?: (event: Extract<SpineEvent, {
+        type: 'trackEnd';
+    }>) => void;
+    /**
+     * The terminal signal for a playback: it fires for completion,
+     * interruption and cancellation alike, so waiting on it always returns.
+     */
+    onTrackDispose?: (event: Extract<SpineEvent, {
+        type: 'trackDispose';
+    }>) => void;
+    onTrackEvent?: (event: Extract<SpineEvent, {
+        type: 'trackEvent';
+    }>) => void;
+    /** A press landed inside a named bounding box; requires the `hitArea` prop. */
+    onHit?: (event: Extract<SpineEvent, {
+        type: 'hit';
+    }>) => void;
+    onError?: (event: Extract<SpineEvent, {
+        type: 'error';
+    }>) => void;
+};
 type MoyuSpriteAttributes = SpriteProps & MoyuNodeAttributes;
 type MoyuTextAttributes = TextProps & MoyuNodeAttributes & {
     onStart?: () => void;
@@ -1085,6 +1477,8 @@ declare namespace JSX {
         shader: DetailedMoyuProps<MoyuShaderAttributes>;
         'shader-slot': DetailedMoyuProps<MoyuShaderSlotAttributes>;
         video: DetailedMoyuProps<MoyuVideoAttributes>;
+        live2d: DetailedMoyuProps<MoyuLive2dAttributes>;
+        spine: DetailedMoyuProps<MoyuSpineAttributes>;
     }
 }
 
@@ -1101,8 +1495,8 @@ type MakeNullOptional<T> = T extends unknown ? {
 } : never;
 declare function mergeEvent<T extends BubbleEvent, K extends BubbleEvent>(handlers: MoyuEventHandler<T> | readonly MoyuEventHandler<T>[] | undefined, defaultHandler?: MoyuEventHandler<K>): (event: T | K) => void;
 
-type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SteamCommand | SystemCommand | VideoCommand;
+type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand | Live2dCommand | ScenarioCommand | ShaderCommand | SpineCommand | SteamCommand | SystemCommand | VideoCommand;
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
-export { type ShaderParam as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuHBoxAttributes as F, type GamepadCommand as G, type MoyuListenerAttributes as H, type MoyuShaderAttributes as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, type MoyuShaderSlotAttributes as N, type MoyuVideoAttributes as O, Node as P, type OverlayDialog as Q, type OverlayNotificationPosition as R, type ShaderDirection as S, type TouchEvent as T, type OverlayStoreFlag as U, type PlatformInfo as V, type WheelEvent as W, type PointerEventKind as X, type RetainMode as Y, type ScenarioCommand as Z, type ShaderCommand as _, type MaybePromise as a, type ShaderParamType as a0, type ShaderSource as a1, type ShaderTimeControl as a2, type SteamCommand as a3, type SystemCommand as a4, type TextCommand as a5, type TextInteractionEvent as a6, type TextLayoutEvent as a7, type TimelinePossibleClip as a8, type TouchEventKind as a9, type Tuple2 as aa, type Tuple3 as ab, type Tuple4 as ac, type VideoCommand as ad, type WheelEventDeltaMode as ae, type WindowState as af, createBubbleEvent as ag, getPlatform as ah, getStageSize as ai, mergeEvent as aj, type MoyuClipAttributes as b, type MoyuVBoxAttributes as c, type MoyuSpriteAttributes as d, type TextProps as e, type MoyuNodeAttributes as f, type MouseEvent as g, type MoyuTextAttributes as h, type EditableChangeSource as i, type SpriteProps as j, type JsonValue as k, type AudioSettings as l, type EditableCommand as m, type EditableEvent as n, type EffectParams as o, type KeyboardEventKind as p, type MakeNullOptional as q, MouseButton as r, MouseButtons as s, type MouseEventKind as t, type MoyuAnimationAttributes as u, type MoyuBackdropAttributes as v, type MoyuContainerAttributes as w, type MoyuEditableAttributes as x, type MoyuEventHandler as y, type MoyuFilterAttributes as z };
+export { type OverlayStoreFlag as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuContainerAttributes as F, type GamepadCommand as G, type MoyuEditableAttributes as H, type MoyuEventHandler as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, type MoyuFilterAttributes as N, type MoyuHBoxAttributes as O, type MoyuListenerAttributes as P, type MoyuLive2dAttributes as Q, type MoyuShaderAttributes as R, type ShaderDirection as S, type TouchEvent as T, type MoyuShaderSlotAttributes as U, type MoyuSpineAttributes as V, type WheelEvent as W, type MoyuVideoAttributes as X, Node as Y, type OverlayDialog as Z, type OverlayNotificationPosition as _, type MaybePromise as a, type PlatformInfo as a0, type PointerEventKind as a1, type RetainMode as a2, type ScenarioCommand as a3, type ShaderCommand as a4, type ShaderParam as a5, type ShaderParamType as a6, type ShaderSource as a7, type ShaderTimeControl as a8, type SpineCommand as a9, type SpineEvent as aa, type SpineMetadata as ab, type SteamCommand as ac, type SystemCommand as ad, type TextCommand as ae, type TextInteractionEvent as af, type TextLayoutEvent as ag, type TimelinePossibleClip as ah, type TouchEventKind as ai, type Tuple2 as aj, type Tuple3 as ak, type Tuple4 as al, type VideoCommand as am, type WheelEventDeltaMode as an, type WindowState as ao, createBubbleEvent as ap, getPlatform as aq, getStageSize as ar, mergeEvent as as, type MoyuClipAttributes as b, type MoyuVBoxAttributes as c, type MoyuSpriteAttributes as d, type TextProps as e, type MoyuNodeAttributes as f, type MouseEvent as g, type MoyuTextAttributes as h, type EditableChangeSource as i, type SpriteProps as j, type JsonValue as k, type AudioSettings as l, type EditableCommand as m, type EditableEvent as n, type EffectParams as o, type EntryIdentity as p, type KeyboardEventKind as q, type Live2dCommand as r, type Live2dEvent as s, type Live2dMetadata as t, type MakeNullOptional as u, MouseButton as v, MouseButtons as w, type MouseEventKind as x, type MoyuAnimationAttributes as y, type MoyuBackdropAttributes as z };

package/dist/jsx-dev-runtime.d.mts

@@ -1,4 +1,4 @@
 export { Fragment, jsxDEV } from 'react/jsx-dev-runtime';
-export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.mjs';
+export { J as JSX } from './jsx-dev-runtime-CowyIagD.mjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/jsx-dev-runtime.d.ts

@@ -1,4 +1,4 @@
 export { Fragment, jsxDEV } from 'react/jsx-dev-runtime';
-export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.js';
+export { J as JSX } from './jsx-dev-runtime-CowyIagD.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/jsx-runtime.d.mts

@@ -1,4 +1,4 @@
 export { Fragment, jsx, jsxs } from 'react/jsx-runtime';
-export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.mjs';
+export { J as JSX } from './jsx-dev-runtime-CowyIagD.mjs';
 import 'react/jsx-dev-runtime';
 import 'react';

package/dist/jsx-runtime.d.ts

@@ -1,4 +1,4 @@
 export { Fragment, jsx, jsxs } from 'react/jsx-runtime';
-export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.js';
+export { J as JSX } from './jsx-dev-runtime-CowyIagD.js';
 import 'react/jsx-dev-runtime';
 import 'react';

package/dist/lib.cjs

@@ -2925,7 +2925,7 @@ async function startRuntimeDebugSession() {
 }
 
 // src/hooks/useFadeInOut.ts
-function useFadeInOut(inTime, _keepTime, _outTime, pause = false, onFinished) {
+function useFadeInOut(inTime, keepTime, outTime, pause = false, onFinished) {
   const [style, api] = (0, spring_exports.useSpring)(
     () => ({
       from: { opacity: 0 },
@@ -2934,7 +2934,7 @@ function useFadeInOut(inTime, _keepTime, _outTime, pause = false, onFinished) {
       pause,
       onRest: (result) => {
         if (result.value.opacity === 1) {
-          void api.start({ reverse: true, delay: 1500, config: { duration: 1e3 } });
+          void api.start({ reverse: true, delay: keepTime, config: { duration: outTime } });
         } else {
           onFinished?.();
         }

package/dist/lib.d.mts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ReactNode, ComponentType } from 'react';
-import { S as ShaderDirection, M as MoyuEvent, C as Command, a as MaybePromise, J as JSX, L as LayoutEvent, W as WheelEvent, T as TouchEvent, b as MoyuClipAttributes, c as MoyuVBoxAttributes, d as MoyuSpriteAttributes, e as TextProps, f as MoyuNodeAttributes, g as MouseEvent, h as MoyuTextAttributes, E as EditableState, i as EditableChangeSource, j as SpriteProps, k as JsonValue } from './jsx-dev-runtime-Dvhilv0K.mjs';
-export { A as AudioCommand, l as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, m as EditableCommand, n as EditableEvent, o as EffectParams, G as GamepadCommand, K as KeyboardEvent, p as KeyboardEventKind, q as MakeNullOptional, r as MouseButton, s as MouseButtons, t as MouseEventKind, u as MoyuAnimationAttributes, v as MoyuBackdropAttributes, w as MoyuContainerAttributes, x as MoyuEditableAttributes, y as MoyuEventHandler, z as MoyuFilterAttributes, F as MoyuHBoxAttributes, H as MoyuListenerAttributes, I as MoyuShaderAttributes, N as MoyuShaderSlotAttributes, O as MoyuVideoAttributes, P as Node, Q as OverlayDialog, R as OverlayNotificationPosition, U as OverlayStoreFlag, V as PlatformInfo, X as PointerEventKind, Y as RetainMode, Z as ScenarioCommand, _ as ShaderCommand, $ as ShaderParam, a0 as ShaderParamType, a1 as ShaderSource, a2 as ShaderTimeControl, a3 as SteamCommand, a4 as SystemCommand, a5 as TextCommand, a6 as TextInteractionEvent, a7 as TextLayoutEvent, a8 as TimelinePossibleClip, a9 as TouchEventKind, aa as Tuple2, ab as Tuple3, ac as Tuple4, ad as VideoCommand, ae as WheelEventDeltaMode, af as WindowState, ag as createBubbleEvent, ah as getPlatform, ai as getStageSize, aj as mergeEvent } from './jsx-dev-runtime-Dvhilv0K.mjs';
+import { S as ShaderDirection, M as MoyuEvent, C as Command, a as MaybePromise, J as JSX, L as LayoutEvent, W as WheelEvent, T as TouchEvent, b as MoyuClipAttributes, c as MoyuVBoxAttributes, d as MoyuSpriteAttributes, e as TextProps, f as MoyuNodeAttributes, g as MouseEvent, h as MoyuTextAttributes, E as EditableState, i as EditableChangeSource, j as SpriteProps, k as JsonValue } from './jsx-dev-runtime-CowyIagD.mjs';
+export { A as AudioCommand, l as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, m as EditableCommand, n as EditableEvent, o as EffectParams, p as EntryIdentity, G as GamepadCommand, K as KeyboardEvent, q as KeyboardEventKind, r as Live2dCommand, s as Live2dEvent, t as Live2dMetadata, u as MakeNullOptional, v as MouseButton, w as MouseButtons, x as MouseEventKind, y as MoyuAnimationAttributes, z as MoyuBackdropAttributes, F as MoyuContainerAttributes, H as MoyuEditableAttributes, I as MoyuEventHandler, N as MoyuFilterAttributes, O as MoyuHBoxAttributes, P as MoyuListenerAttributes, Q as MoyuLive2dAttributes, R as MoyuShaderAttributes, U as MoyuShaderSlotAttributes, V as MoyuSpineAttributes, X as MoyuVideoAttributes, Y as Node, Z as OverlayDialog, _ as OverlayNotificationPosition, $ as OverlayStoreFlag, a0 as PlatformInfo, a1 as PointerEventKind, a2 as RetainMode, a3 as ScenarioCommand, a4 as ShaderCommand, a5 as ShaderParam, a6 as ShaderParamType, a7 as ShaderSource, a8 as ShaderTimeControl, a9 as SpineCommand, aa as SpineEvent, ab as SpineMetadata, ac as SteamCommand, ad as SystemCommand, ae as TextCommand, af as TextInteractionEvent, ag as TextLayoutEvent, ah as TimelinePossibleClip, ai as TouchEventKind, aj as Tuple2, ak as Tuple3, al as Tuple4, am as VideoCommand, an as WheelEventDeltaMode, ao as WindowState, ap as createBubbleEvent, aq as getPlatform, ar as getStageSize, as as mergeEvent } from './jsx-dev-runtime-CowyIagD.mjs';
 import { FluidValue, addFluidObserver as addFluidObserver$1, removeFluidObserver as removeFluidObserver$1 } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
@@ -1020,7 +1020,7 @@ declare function useDebugSession(): {
 declare function stopRuntimeDebugSession(): Promise<void>;
 declare function startRuntimeDebugSession(): Promise<void>;
 
-declare function useFadeInOut(inTime: number, _keepTime: number, _outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
+declare function useFadeInOut(inTime: number, keepTime: number, outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
     opacity: number;
 }>, SpringRef<{
     opacity: number;

package/dist/lib.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ReactNode, ComponentType } from 'react';
-import { S as ShaderDirection, M as MoyuEvent, C as Command, a as MaybePromise, J as JSX, L as LayoutEvent, W as WheelEvent, T as TouchEvent, b as MoyuClipAttributes, c as MoyuVBoxAttributes, d as MoyuSpriteAttributes, e as TextProps, f as MoyuNodeAttributes, g as MouseEvent, h as MoyuTextAttributes, E as EditableState, i as EditableChangeSource, j as SpriteProps, k as JsonValue } from './jsx-dev-runtime-Dvhilv0K.js';
-export { A as AudioCommand, l as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, m as EditableCommand, n as EditableEvent, o as EffectParams, G as GamepadCommand, K as KeyboardEvent, p as KeyboardEventKind, q as MakeNullOptional, r as MouseButton, s as MouseButtons, t as MouseEventKind, u as MoyuAnimationAttributes, v as MoyuBackdropAttributes, w as MoyuContainerAttributes, x as MoyuEditableAttributes, y as MoyuEventHandler, z as MoyuFilterAttributes, F as MoyuHBoxAttributes, H as MoyuListenerAttributes, I as MoyuShaderAttributes, N as MoyuShaderSlotAttributes, O as MoyuVideoAttributes, P as Node, Q as OverlayDialog, R as OverlayNotificationPosition, U as OverlayStoreFlag, V as PlatformInfo, X as PointerEventKind, Y as RetainMode, Z as ScenarioCommand, _ as ShaderCommand, $ as ShaderParam, a0 as ShaderParamType, a1 as ShaderSource, a2 as ShaderTimeControl, a3 as SteamCommand, a4 as SystemCommand, a5 as TextCommand, a6 as TextInteractionEvent, a7 as TextLayoutEvent, a8 as TimelinePossibleClip, a9 as TouchEventKind, aa as Tuple2, ab as Tuple3, ac as Tuple4, ad as VideoCommand, ae as WheelEventDeltaMode, af as WindowState, ag as createBubbleEvent, ah as getPlatform, ai as getStageSize, aj as mergeEvent } from './jsx-dev-runtime-Dvhilv0K.js';
+import { S as ShaderDirection, M as MoyuEvent, C as Command, a as MaybePromise, J as JSX, L as LayoutEvent, W as WheelEvent, T as TouchEvent, b as MoyuClipAttributes, c as MoyuVBoxAttributes, d as MoyuSpriteAttributes, e as TextProps, f as MoyuNodeAttributes, g as MouseEvent, h as MoyuTextAttributes, E as EditableState, i as EditableChangeSource, j as SpriteProps, k as JsonValue } from './jsx-dev-runtime-CowyIagD.js';
+export { A as AudioCommand, l as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, m as EditableCommand, n as EditableEvent, o as EffectParams, p as EntryIdentity, G as GamepadCommand, K as KeyboardEvent, q as KeyboardEventKind, r as Live2dCommand, s as Live2dEvent, t as Live2dMetadata, u as MakeNullOptional, v as MouseButton, w as MouseButtons, x as MouseEventKind, y as MoyuAnimationAttributes, z as MoyuBackdropAttributes, F as MoyuContainerAttributes, H as MoyuEditableAttributes, I as MoyuEventHandler, N as MoyuFilterAttributes, O as MoyuHBoxAttributes, P as MoyuListenerAttributes, Q as MoyuLive2dAttributes, R as MoyuShaderAttributes, U as MoyuShaderSlotAttributes, V as MoyuSpineAttributes, X as MoyuVideoAttributes, Y as Node, Z as OverlayDialog, _ as OverlayNotificationPosition, $ as OverlayStoreFlag, a0 as PlatformInfo, a1 as PointerEventKind, a2 as RetainMode, a3 as ScenarioCommand, a4 as ShaderCommand, a5 as ShaderParam, a6 as ShaderParamType, a7 as ShaderSource, a8 as ShaderTimeControl, a9 as SpineCommand, aa as SpineEvent, ab as SpineMetadata, ac as SteamCommand, ad as SystemCommand, ae as TextCommand, af as TextInteractionEvent, ag as TextLayoutEvent, ah as TimelinePossibleClip, ai as TouchEventKind, aj as Tuple2, ak as Tuple3, al as Tuple4, am as VideoCommand, an as WheelEventDeltaMode, ao as WindowState, ap as createBubbleEvent, aq as getPlatform, ar as getStageSize, as as mergeEvent } from './jsx-dev-runtime-CowyIagD.js';
 import { FluidValue, addFluidObserver as addFluidObserver$1, removeFluidObserver as removeFluidObserver$1 } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
@@ -1020,7 +1020,7 @@ declare function useDebugSession(): {
 declare function stopRuntimeDebugSession(): Promise<void>;
 declare function startRuntimeDebugSession(): Promise<void>;
 
-declare function useFadeInOut(inTime: number, _keepTime: number, _outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
+declare function useFadeInOut(inTime: number, keepTime: number, outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
     opacity: number;
 }>, SpringRef<{
     opacity: number;

package/dist/lib.mjs

@@ -2919,7 +2919,7 @@ async function startRuntimeDebugSession() {
 }
 
 // src/hooks/useFadeInOut.ts
-function useFadeInOut(inTime, _keepTime, _outTime, pause = false, onFinished) {
+function useFadeInOut(inTime, keepTime, outTime, pause = false, onFinished) {
   const [style, api] = (0, spring_exports.useSpring)(
     () => ({
       from: { opacity: 0 },
@@ -2928,7 +2928,7 @@ function useFadeInOut(inTime, _keepTime, _outTime, pause = false, onFinished) {
       pause,
       onRest: (result) => {
         if (result.value.opacity === 1) {
-          void api.start({ reverse: true, delay: 1500, config: { duration: 1e3 } });
+          void api.start({ reverse: true, delay: keepTime, config: { duration: outTime } });
         } else {
           onFinished?.();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@momoyu-ink/kit",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Software Development Kit of Moyu Visual Novel Engine",
   "main": "dist/lib.cjs",
   "module": "dist/lib.mjs",