@momoyu-ink/kit 0.9.0 → 0.10.0

package/dist/lib.d.mts

@@ -1,13 +1,13 @@
 import * as react from 'react';
 import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ReactNode, ComponentType } from 'react';
-import { S as ShaderDirection, M as MouseEvent, a as MoyuEvent, C as Command, b as MaybePromise, J as JSX, c as JsonValue } from './jsx-dev-runtime-De053cfK.mjs';
-export { A as AudioCommand, d as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, E as EffectParams, G as GamepadCommand, K as KeyboardEvent, e as KeyboardEventKind, f as MakeNullOptional, g as MouseEventKind, h as MoyuAnimationAttributes, i as MoyuBackdropAttributes, j as MoyuClipAttributes, k as MoyuContainerAttributes, l as MoyuEventHandler, m as MoyuFilterAttributes, n as MoyuListenerAttributes, o as MoyuNodeAttributes, p as MoyuShaderAttributes, q as MoyuShaderSlotAttributes, r as MoyuSpriteAttributes, s as MoyuTextAttributes, t as MoyuVideoAttributes, N as Node, R as RetainMode, u as ScenarioCommand, v as ShaderCommand, w as ShaderParam, x as ShaderParamType, y as ShaderSource, z as ShaderTimeControl, F as SystemCommand, T as TextCommand, H as TouchEvent, I as TouchEventKind, L as Tuple2, O as Tuple3, P as Tuple4, W as WindowState, Q as createBubbleEvent, U as getStageSize } from './jsx-dev-runtime-De053cfK.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 SpriteProps, i as JsonValue } from './jsx-dev-runtime-gGlb6FbX.mjs';
+export { A as AudioCommand, j as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, E as EffectParams, G as GamepadCommand, K as KeyboardEvent, k as KeyboardEventKind, l as MakeNullOptional, m as MouseEventKind, n as MoyuAnimationAttributes, o as MoyuBackdropAttributes, p as MoyuContainerAttributes, q as MoyuEventHandler, r as MoyuFilterAttributes, s as MoyuHBoxAttributes, t as MoyuListenerAttributes, u as MoyuShaderAttributes, v as MoyuShaderSlotAttributes, w as MoyuTextAttributes, x as MoyuVideoAttributes, N as Node, R as RetainMode, y as ScenarioCommand, z as ShaderCommand, F as ShaderParam, H as ShaderParamType, I as ShaderSource, O as ShaderTimeControl, P as SystemCommand, Q as TextCommand, U as TouchEventKind, V as Tuple2, X as Tuple3, Y as Tuple4, Z as WheelEventDeltaMode, _ as WindowState, $ as createBubbleEvent, a0 as getStageSize, a1 as mergeEvent } from './jsx-dev-runtime-gGlb6FbX.mjs';
 import { FluidValue } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
-import { ZodType } from 'zod';
-import { SpringValues, SpringRef } from '@react-spring/core';
+import { SpringValue, SpringValues, SpringRef } from '@react-spring/core';
 export * from '@react-spring/core';
+import { ZodType } from 'zod';
 import 'react/jsx-runtime';
 import 'react/jsx-dev-runtime';
 
@@ -32,54 +32,11 @@ interface RootOptions {
 }
 declare function createRoot(options?: RootOptions): RootHandle;
 
-type ShaderBuiltin = {
-    name: 'crossfade';
-} | {
-    name: 'wipe';
-    softness: number;
-    direction: ShaderDirection;
-} | {
-    name: 'fade';
-    out: number;
-    hold: number;
-    in: number;
-    color: string;
-} | {
-    name: 'push';
-    direction: ShaderDirection;
-} | {
-    name: 'slideaway';
-    direction: ShaderDirection;
-} | {
-    name: 'zoom';
-    startScale: number;
-    endScale: number;
-    origin: [number, number];
-} | {
-    name: 'pixellate';
-    steps: number;
-} | {
-    name: 'mask';
-    rule: string;
-    softness: number;
-    reverse: boolean;
-};
-
-type ShaderBuiltinName = 'crossfade' | 'wipe' | 'fade' | 'push' | 'slideaway' | 'zoom' | 'pixellate' | 'mask';
-
 declare const globalEventListeners: Record<string, ((event: unknown) => void)[]>;
 declare const globalRequestAnimationFrameListeners: FrameRequestCallback[];
 
 declare function addEventListener(name: string, callback: (...args: any[]) => void): () => void;
 
-interface WheelEvent extends Omit<MouseEvent, 'kind'> {
-    kind: 'wheel';
-    deltaX: number;
-    deltaY: number;
-    deltaZ: number;
-    deltaMode: WheelEventDeltaMode;
-}
-
 type AnimationFrameCallbackEvent = {
     timestamp: number;
 };
@@ -246,7 +203,7 @@ type ResolvedSystemCallLine = {
     arguments: Array<ResolvedArgument>;
 };
 
-type ShaderEvent = null;
+type ShaderEvent = null | null;
 
 type TextLine = {
     leading: string | null;
@@ -262,7 +219,40 @@ type MarkerEnter = {
 
 type ScenarioEvent = MarkerEnter | ResolvedCommandLine | ResolvedSystemCallLine | TextLine | null | null | null | null;
 
-type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
+type ShaderBuiltin = {
+    name: 'crossfade';
+} | {
+    name: 'wipe';
+    softness: number;
+    direction: ShaderDirection;
+} | {
+    name: 'fade';
+    out: number;
+    hold: number;
+    in: number;
+    color: string;
+} | {
+    name: 'push';
+    direction: ShaderDirection;
+} | {
+    name: 'slideaway';
+    direction: ShaderDirection;
+} | {
+    name: 'zoom';
+    startScale: number;
+    endScale: number;
+    origin: [number, number];
+} | {
+    name: 'pixellate';
+    steps: number;
+} | {
+    name: 'mask';
+    rule: string;
+    softness: number;
+    reverse: boolean;
+};
+
+type ShaderBuiltinName = 'crossfade' | 'wipe' | 'fade' | 'push' | 'slideaway' | 'zoom' | 'pixellate' | 'mask';
 
 declare global {
     interface Window {
@@ -575,6 +565,116 @@ declare function useNavigationState(): Snapshot<NavigationState>;
  */
 declare function useNavigationParams<T = Record<string, any>>(): T;
 
+interface UseScrollViewOptions {
+    viewportHeight: number;
+    initialPosition?: 'start' | 'end';
+    wheelStep?: number;
+}
+interface ScrollViewController {
+    scrollOffset: SpringValue<number>;
+    contentHeight: number;
+    maxScroll: number;
+    handleContentLayout: (event: LayoutEvent) => void;
+    handleWheel: (event: WheelEvent) => void;
+    handleTouchStart: (event: TouchEvent) => void;
+    handleTouchMove: (event: TouchEvent) => void;
+    handleTouchEnd: (event: TouchEvent) => void;
+    scrollTo: (offset: number, immediate?: boolean) => void;
+    scrollToRatio: (ratio: number, immediate?: boolean) => void;
+}
+declare function useScrollView({ viewportHeight, initialPosition, wheelStep, }: UseScrollViewOptions): ScrollViewController;
+
+interface ScrollViewProps {
+    width: number;
+    height: number;
+    controller: ScrollViewController;
+    children?: ReactNode;
+    clipProps?: Omit<MoyuClipAttributes, 'children' | 'height' | 'onTouchEnd' | 'onTouchMove' | 'onTouchStart' | 'onWheel' | 'width'>;
+    contentProps?: Omit<MoyuVBoxAttributes, 'children' | 'onLayout' | 'y'>;
+}
+declare function ScrollView({ width, height, controller, children, clipProps, contentProps }: ScrollViewProps): JSX.Element;
+
+type ControlState = 'idle' | 'hover' | 'press' | 'disabled';
+type ControlStateValue<T> = T | readonly [idle: T, hover?: T, press?: T, disabled?: T];
+type ControlTextStyle = Omit<TextProps, 'text'>;
+interface ControlSpriteProps extends Omit<MoyuSpriteAttributes, 'children' | 'src'> {
+    src: ControlStateValue<string>;
+}
+
+type PressEvent = MouseEvent | TouchEvent;
+interface ButtonProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    sprite: ControlSpriteProps;
+    disabled?: boolean;
+    lockOn?: Exclude<ControlState, 'disabled'>;
+    onPress?: (event: PressEvent) => void;
+    text?: string;
+    textStyle?: ControlStateValue<ControlTextStyle>;
+    textOffsetX?: number;
+    textOffsetY?: number;
+    textAlign?: 'left' | 'center' | 'right';
+}
+declare function Button({ sprite, disabled, lockOn, onPress, text, textStyle, textOffsetX, textOffsetY, textAlign, anchor, pivot, interactive, onMouseEnter, onMouseLeave, onMouseDown, onMouseUp, onTouchStart, onTouchEnd, onTouchCancel, ...containerProps }: ButtonProps): JSX.Element;
+
+interface CheckboxProps extends Omit<ButtonProps, 'lockOn' | 'sprite'> {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    uncheckedSprite: ControlSpriteProps;
+    checkedSprite: ControlSpriteProps;
+}
+declare function Checkbox({ checked, defaultChecked, onCheckedChange, uncheckedSprite, checkedSprite, onPress, ...buttonProps }: CheckboxProps): JSX.Element;
+
+interface SelectOption {
+    text: string;
+    value: string;
+}
+interface SelectListProps extends Omit<SpriteProps, 'src' | 'targetHeight'> {
+    src: string;
+    paddingX?: number;
+    paddingY?: number;
+    gap?: number;
+    offsetX?: number;
+    offsetY?: number;
+}
+interface SelectOptionSpriteProps extends Omit<ControlSpriteProps, 'targetHeight'> {
+    targetHeight: number;
+}
+interface SelectProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string, option: SelectOption) => void;
+    onPress?: (event: PressEvent) => void;
+    disabled?: boolean;
+    options: readonly SelectOption[];
+    trigger: ControlSpriteProps;
+    list: SelectListProps;
+    option: SelectOptionSpriteProps;
+    textStyle?: ControlStateValue<ControlTextStyle>;
+    textOffsetX?: number;
+    textOffsetY?: number;
+    textAlign?: 'left' | 'center' | 'right';
+}
+declare function Select({ value, defaultValue, onValueChange, onPress, disabled, options, trigger, list, option, textStyle, textOffsetX, textOffsetY, textAlign, anchor, pivot, ...containerProps }: SelectProps): JSX.Element;
+
+interface SliderTrackProps extends Omit<SpriteProps, 'src' | 'targetWidth'> {
+    src: ControlStateValue<string>;
+    targetWidth: number;
+}
+interface SliderThumbProps extends Omit<SpriteProps, 'src' | 'targetWidth'> {
+    src: ControlStateValue<string>;
+    targetWidth: number;
+}
+interface SliderProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (value: number) => void;
+    onPress?: (event: PressEvent) => void;
+    disabled?: boolean;
+    track: SliderTrackProps;
+    thumb: SliderThumbProps;
+}
+declare function Slider({ value, defaultValue, onValueChange, onPress, disabled, track, thumb, anchor, pivot, interactive, onMouseEnter, onMouseLeave, onMouseDown, onMouseUp, onMouseMove, onTouchStart, onTouchMove, onTouchEnd, onTouchCancel, ...containerProps }: SliderProps): JSX.Element;
+
 type ExecutionCursor = {
     story: string;
     paragraph: string;
@@ -907,9 +1007,10 @@ declare module 'zod' {
         title?: string;
         format?: string;
         'x-asset-kind'?: 'audio' | 'image' | 'font' | 'video' | 'other';
+        'x-step'?: number;
         'x-i18n'?: Record<string, string>;
         'x-i18n-desc'?: Record<string, string>;
     }
 }
 
-export { type AnimatedComponent, type AnimatedProps, type AnimationFrameCallbackEvent, type AppStateAdapter, type AutoTicketHandle, type AutoTicketOptions, type BeforeUnloadEvent, type CombinedCheckpoint, Command, type CommandHandler, type CustomEvent, DEBUG_EMPTY_PAGE, type DebugSessionConfig, type DebugSessionController, type DebugWarpBoundary, type DebugWarpOptions, type DefaultOverlayName, type DefaultPageName, type FastForwardOptions, type FocusEvent, type FocusEventKind, type FullScreenEvent, type FullscreenEventKind, type GameControl, type GameEvent, type GameStateSourceProps, type GameStateStore, type Gamepad, type GamepadButton, type GamepadEvent, type GamepadHapticActuator, JSX, type KeyboardLocation, type Literal, MaybePromise, MouseEvent, MoyuEvent, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type RegisterNavigator, type ResizeEvent, type ResolvedArgument, type ResolvedCommandLine, type ResolvedSystemCallLine, type RootErrorInfo, type RootHandle, type RootNavigatorList, type RootOptions, type RootUiDataMap, type RootUncaughtErrorInfo, type ScenarioCommandBaseType, type ScenarioEvent, type ShaderBuiltin, type ShaderBuiltinName, type ShaderEvent, type StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, type WheelEvent, type WheelEventDeltaMode, type WithAnimated, animated as a, addEventListener, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, replaceUiData, setDefaultAutoTailMs, setWaiting, skipState, startDebugSession, startRuntimeDebugSession, stopDebugSession, stopRuntimeDebugSession, useAutoBlocker, useAutoTicket, useBeforeHandleCommandCallback, useDebugSession, useFadeIn, useFadeInOut, useFadeOut, useInterruptCallback, useIsAutoing, useIsSeeking, useIsSkipping, useNavigation, useNavigationParams, useNavigationState, useScenario, useSkipBlocker, useSkipCallback, useSoundEffect, useStageContext, useUiData, warpState };
+export { type AnimatedComponent, type AnimatedProps, type AnimationFrameCallbackEvent, type AppStateAdapter, type AutoTicketHandle, type AutoTicketOptions, type BeforeUnloadEvent, Button, type ButtonProps, Checkbox, type CheckboxProps, type CombinedCheckpoint, Command, type CommandHandler, type ControlSpriteProps, type ControlState, type ControlStateValue, type ControlTextStyle, type CustomEvent, DEBUG_EMPTY_PAGE, type DebugSessionConfig, type DebugSessionController, type DebugWarpBoundary, type DebugWarpOptions, type DefaultOverlayName, type DefaultPageName, type FastForwardOptions, type FocusEvent, type FocusEventKind, type FullScreenEvent, type FullscreenEventKind, type GameControl, type GameEvent, type GameStateSourceProps, type GameStateStore, type Gamepad, type GamepadButton, type GamepadEvent, type GamepadHapticActuator, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, type RegisterNavigator, type ResizeEvent, type ResolvedArgument, type ResolvedCommandLine, type ResolvedSystemCallLine, type RootErrorInfo, type RootHandle, type RootNavigatorList, type RootOptions, type RootUiDataMap, type RootUncaughtErrorInfo, type ScenarioCommandBaseType, type ScenarioEvent, ScrollView, type ScrollViewController, type ScrollViewProps, Select, type SelectListProps, type SelectOption, type SelectOptionSpriteProps, type SelectProps, type ShaderBuiltin, type ShaderBuiltinName, type ShaderEvent, Slider, type SliderProps, type SliderThumbProps, type SliderTrackProps, type StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, TouchEvent, type UseScrollViewOptions, WheelEvent, type WithAnimated, animated as a, addEventListener, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, replaceUiData, setDefaultAutoTailMs, setWaiting, skipState, startDebugSession, startRuntimeDebugSession, stopDebugSession, stopRuntimeDebugSession, useAutoBlocker, useAutoTicket, useBeforeHandleCommandCallback, useDebugSession, useFadeIn, useFadeInOut, useFadeOut, useInterruptCallback, useIsAutoing, useIsSeeking, useIsSkipping, useNavigation, useNavigationParams, useNavigationState, useScenario, useScrollView, useSkipBlocker, useSkipCallback, useSoundEffect, useStageContext, useUiData, warpState };

package/dist/lib.d.ts

@@ -1,13 +1,13 @@
 import * as react from 'react';
 import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ReactNode, ComponentType } from 'react';
-import { S as ShaderDirection, M as MouseEvent, a as MoyuEvent, C as Command, b as MaybePromise, J as JSX, c as JsonValue } from './jsx-dev-runtime-De053cfK.js';
-export { A as AudioCommand, d as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, E as EffectParams, G as GamepadCommand, K as KeyboardEvent, e as KeyboardEventKind, f as MakeNullOptional, g as MouseEventKind, h as MoyuAnimationAttributes, i as MoyuBackdropAttributes, j as MoyuClipAttributes, k as MoyuContainerAttributes, l as MoyuEventHandler, m as MoyuFilterAttributes, n as MoyuListenerAttributes, o as MoyuNodeAttributes, p as MoyuShaderAttributes, q as MoyuShaderSlotAttributes, r as MoyuSpriteAttributes, s as MoyuTextAttributes, t as MoyuVideoAttributes, N as Node, R as RetainMode, u as ScenarioCommand, v as ShaderCommand, w as ShaderParam, x as ShaderParamType, y as ShaderSource, z as ShaderTimeControl, F as SystemCommand, T as TextCommand, H as TouchEvent, I as TouchEventKind, L as Tuple2, O as Tuple3, P as Tuple4, W as WindowState, Q as createBubbleEvent, U as getStageSize } from './jsx-dev-runtime-De053cfK.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 SpriteProps, i as JsonValue } from './jsx-dev-runtime-gGlb6FbX.js';
+export { A as AudioCommand, j as AudioSettings, B as BubbleEvent, D as DetailedMoyuProps, E as EffectParams, G as GamepadCommand, K as KeyboardEvent, k as KeyboardEventKind, l as MakeNullOptional, m as MouseEventKind, n as MoyuAnimationAttributes, o as MoyuBackdropAttributes, p as MoyuContainerAttributes, q as MoyuEventHandler, r as MoyuFilterAttributes, s as MoyuHBoxAttributes, t as MoyuListenerAttributes, u as MoyuShaderAttributes, v as MoyuShaderSlotAttributes, w as MoyuTextAttributes, x as MoyuVideoAttributes, N as Node, R as RetainMode, y as ScenarioCommand, z as ShaderCommand, F as ShaderParam, H as ShaderParamType, I as ShaderSource, O as ShaderTimeControl, P as SystemCommand, Q as TextCommand, U as TouchEventKind, V as Tuple2, X as Tuple3, Y as Tuple4, Z as WheelEventDeltaMode, _ as WindowState, $ as createBubbleEvent, a0 as getStageSize, a1 as mergeEvent } from './jsx-dev-runtime-gGlb6FbX.js';
 import { FluidValue } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
-import { ZodType } from 'zod';
-import { SpringValues, SpringRef } from '@react-spring/core';
+import { SpringValue, SpringValues, SpringRef } from '@react-spring/core';
 export * from '@react-spring/core';
+import { ZodType } from 'zod';
 import 'react/jsx-runtime';
 import 'react/jsx-dev-runtime';
 
@@ -32,54 +32,11 @@ interface RootOptions {
 }
 declare function createRoot(options?: RootOptions): RootHandle;
 
-type ShaderBuiltin = {
-    name: 'crossfade';
-} | {
-    name: 'wipe';
-    softness: number;
-    direction: ShaderDirection;
-} | {
-    name: 'fade';
-    out: number;
-    hold: number;
-    in: number;
-    color: string;
-} | {
-    name: 'push';
-    direction: ShaderDirection;
-} | {
-    name: 'slideaway';
-    direction: ShaderDirection;
-} | {
-    name: 'zoom';
-    startScale: number;
-    endScale: number;
-    origin: [number, number];
-} | {
-    name: 'pixellate';
-    steps: number;
-} | {
-    name: 'mask';
-    rule: string;
-    softness: number;
-    reverse: boolean;
-};
-
-type ShaderBuiltinName = 'crossfade' | 'wipe' | 'fade' | 'push' | 'slideaway' | 'zoom' | 'pixellate' | 'mask';
-
 declare const globalEventListeners: Record<string, ((event: unknown) => void)[]>;
 declare const globalRequestAnimationFrameListeners: FrameRequestCallback[];
 
 declare function addEventListener(name: string, callback: (...args: any[]) => void): () => void;
 
-interface WheelEvent extends Omit<MouseEvent, 'kind'> {
-    kind: 'wheel';
-    deltaX: number;
-    deltaY: number;
-    deltaZ: number;
-    deltaMode: WheelEventDeltaMode;
-}
-
 type AnimationFrameCallbackEvent = {
     timestamp: number;
 };
@@ -246,7 +203,7 @@ type ResolvedSystemCallLine = {
     arguments: Array<ResolvedArgument>;
 };
 
-type ShaderEvent = null;
+type ShaderEvent = null | null;
 
 type TextLine = {
     leading: string | null;
@@ -262,7 +219,40 @@ type MarkerEnter = {
 
 type ScenarioEvent = MarkerEnter | ResolvedCommandLine | ResolvedSystemCallLine | TextLine | null | null | null | null;
 
-type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
+type ShaderBuiltin = {
+    name: 'crossfade';
+} | {
+    name: 'wipe';
+    softness: number;
+    direction: ShaderDirection;
+} | {
+    name: 'fade';
+    out: number;
+    hold: number;
+    in: number;
+    color: string;
+} | {
+    name: 'push';
+    direction: ShaderDirection;
+} | {
+    name: 'slideaway';
+    direction: ShaderDirection;
+} | {
+    name: 'zoom';
+    startScale: number;
+    endScale: number;
+    origin: [number, number];
+} | {
+    name: 'pixellate';
+    steps: number;
+} | {
+    name: 'mask';
+    rule: string;
+    softness: number;
+    reverse: boolean;
+};
+
+type ShaderBuiltinName = 'crossfade' | 'wipe' | 'fade' | 'push' | 'slideaway' | 'zoom' | 'pixellate' | 'mask';
 
 declare global {
     interface Window {
@@ -575,6 +565,116 @@ declare function useNavigationState(): Snapshot<NavigationState>;
  */
 declare function useNavigationParams<T = Record<string, any>>(): T;
 
+interface UseScrollViewOptions {
+    viewportHeight: number;
+    initialPosition?: 'start' | 'end';
+    wheelStep?: number;
+}
+interface ScrollViewController {
+    scrollOffset: SpringValue<number>;
+    contentHeight: number;
+    maxScroll: number;
+    handleContentLayout: (event: LayoutEvent) => void;
+    handleWheel: (event: WheelEvent) => void;
+    handleTouchStart: (event: TouchEvent) => void;
+    handleTouchMove: (event: TouchEvent) => void;
+    handleTouchEnd: (event: TouchEvent) => void;
+    scrollTo: (offset: number, immediate?: boolean) => void;
+    scrollToRatio: (ratio: number, immediate?: boolean) => void;
+}
+declare function useScrollView({ viewportHeight, initialPosition, wheelStep, }: UseScrollViewOptions): ScrollViewController;
+
+interface ScrollViewProps {
+    width: number;
+    height: number;
+    controller: ScrollViewController;
+    children?: ReactNode;
+    clipProps?: Omit<MoyuClipAttributes, 'children' | 'height' | 'onTouchEnd' | 'onTouchMove' | 'onTouchStart' | 'onWheel' | 'width'>;
+    contentProps?: Omit<MoyuVBoxAttributes, 'children' | 'onLayout' | 'y'>;
+}
+declare function ScrollView({ width, height, controller, children, clipProps, contentProps }: ScrollViewProps): JSX.Element;
+
+type ControlState = 'idle' | 'hover' | 'press' | 'disabled';
+type ControlStateValue<T> = T | readonly [idle: T, hover?: T, press?: T, disabled?: T];
+type ControlTextStyle = Omit<TextProps, 'text'>;
+interface ControlSpriteProps extends Omit<MoyuSpriteAttributes, 'children' | 'src'> {
+    src: ControlStateValue<string>;
+}
+
+type PressEvent = MouseEvent | TouchEvent;
+interface ButtonProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    sprite: ControlSpriteProps;
+    disabled?: boolean;
+    lockOn?: Exclude<ControlState, 'disabled'>;
+    onPress?: (event: PressEvent) => void;
+    text?: string;
+    textStyle?: ControlStateValue<ControlTextStyle>;
+    textOffsetX?: number;
+    textOffsetY?: number;
+    textAlign?: 'left' | 'center' | 'right';
+}
+declare function Button({ sprite, disabled, lockOn, onPress, text, textStyle, textOffsetX, textOffsetY, textAlign, anchor, pivot, interactive, onMouseEnter, onMouseLeave, onMouseDown, onMouseUp, onTouchStart, onTouchEnd, onTouchCancel, ...containerProps }: ButtonProps): JSX.Element;
+
+interface CheckboxProps extends Omit<ButtonProps, 'lockOn' | 'sprite'> {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    uncheckedSprite: ControlSpriteProps;
+    checkedSprite: ControlSpriteProps;
+}
+declare function Checkbox({ checked, defaultChecked, onCheckedChange, uncheckedSprite, checkedSprite, onPress, ...buttonProps }: CheckboxProps): JSX.Element;
+
+interface SelectOption {
+    text: string;
+    value: string;
+}
+interface SelectListProps extends Omit<SpriteProps, 'src' | 'targetHeight'> {
+    src: string;
+    paddingX?: number;
+    paddingY?: number;
+    gap?: number;
+    offsetX?: number;
+    offsetY?: number;
+}
+interface SelectOptionSpriteProps extends Omit<ControlSpriteProps, 'targetHeight'> {
+    targetHeight: number;
+}
+interface SelectProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string, option: SelectOption) => void;
+    onPress?: (event: PressEvent) => void;
+    disabled?: boolean;
+    options: readonly SelectOption[];
+    trigger: ControlSpriteProps;
+    list: SelectListProps;
+    option: SelectOptionSpriteProps;
+    textStyle?: ControlStateValue<ControlTextStyle>;
+    textOffsetX?: number;
+    textOffsetY?: number;
+    textAlign?: 'left' | 'center' | 'right';
+}
+declare function Select({ value, defaultValue, onValueChange, onPress, disabled, options, trigger, list, option, textStyle, textOffsetX, textOffsetY, textAlign, anchor, pivot, ...containerProps }: SelectProps): JSX.Element;
+
+interface SliderTrackProps extends Omit<SpriteProps, 'src' | 'targetWidth'> {
+    src: ControlStateValue<string>;
+    targetWidth: number;
+}
+interface SliderThumbProps extends Omit<SpriteProps, 'src' | 'targetWidth'> {
+    src: ControlStateValue<string>;
+    targetWidth: number;
+}
+interface SliderProps extends Omit<MoyuNodeAttributes, 'onClick'> {
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (value: number) => void;
+    onPress?: (event: PressEvent) => void;
+    disabled?: boolean;
+    track: SliderTrackProps;
+    thumb: SliderThumbProps;
+}
+declare function Slider({ value, defaultValue, onValueChange, onPress, disabled, track, thumb, anchor, pivot, interactive, onMouseEnter, onMouseLeave, onMouseDown, onMouseUp, onMouseMove, onTouchStart, onTouchMove, onTouchEnd, onTouchCancel, ...containerProps }: SliderProps): JSX.Element;
+
 type ExecutionCursor = {
     story: string;
     paragraph: string;
@@ -907,9 +1007,10 @@ declare module 'zod' {
         title?: string;
         format?: string;
         'x-asset-kind'?: 'audio' | 'image' | 'font' | 'video' | 'other';
+        'x-step'?: number;
         'x-i18n'?: Record<string, string>;
         'x-i18n-desc'?: Record<string, string>;
     }
 }
 
-export { type AnimatedComponent, type AnimatedProps, type AnimationFrameCallbackEvent, type AppStateAdapter, type AutoTicketHandle, type AutoTicketOptions, type BeforeUnloadEvent, type CombinedCheckpoint, Command, type CommandHandler, type CustomEvent, DEBUG_EMPTY_PAGE, type DebugSessionConfig, type DebugSessionController, type DebugWarpBoundary, type DebugWarpOptions, type DefaultOverlayName, type DefaultPageName, type FastForwardOptions, type FocusEvent, type FocusEventKind, type FullScreenEvent, type FullscreenEventKind, type GameControl, type GameEvent, type GameStateSourceProps, type GameStateStore, type Gamepad, type GamepadButton, type GamepadEvent, type GamepadHapticActuator, JSX, type KeyboardLocation, type Literal, MaybePromise, MouseEvent, MoyuEvent, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type RegisterNavigator, type ResizeEvent, type ResolvedArgument, type ResolvedCommandLine, type ResolvedSystemCallLine, type RootErrorInfo, type RootHandle, type RootNavigatorList, type RootOptions, type RootUiDataMap, type RootUncaughtErrorInfo, type ScenarioCommandBaseType, type ScenarioEvent, type ShaderBuiltin, type ShaderBuiltinName, type ShaderEvent, type StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, type WheelEvent, type WheelEventDeltaMode, type WithAnimated, animated as a, addEventListener, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, replaceUiData, setDefaultAutoTailMs, setWaiting, skipState, startDebugSession, startRuntimeDebugSession, stopDebugSession, stopRuntimeDebugSession, useAutoBlocker, useAutoTicket, useBeforeHandleCommandCallback, useDebugSession, useFadeIn, useFadeInOut, useFadeOut, useInterruptCallback, useIsAutoing, useIsSeeking, useIsSkipping, useNavigation, useNavigationParams, useNavigationState, useScenario, useSkipBlocker, useSkipCallback, useSoundEffect, useStageContext, useUiData, warpState };
+export { type AnimatedComponent, type AnimatedProps, type AnimationFrameCallbackEvent, type AppStateAdapter, type AutoTicketHandle, type AutoTicketOptions, type BeforeUnloadEvent, Button, type ButtonProps, Checkbox, type CheckboxProps, type CombinedCheckpoint, Command, type CommandHandler, type ControlSpriteProps, type ControlState, type ControlStateValue, type ControlTextStyle, type CustomEvent, DEBUG_EMPTY_PAGE, type DebugSessionConfig, type DebugSessionController, type DebugWarpBoundary, type DebugWarpOptions, type DefaultOverlayName, type DefaultPageName, type FastForwardOptions, type FocusEvent, type FocusEventKind, type FullScreenEvent, type FullscreenEventKind, type GameControl, type GameEvent, type GameStateSourceProps, type GameStateStore, type Gamepad, type GamepadButton, type GamepadEvent, type GamepadHapticActuator, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, type RegisterNavigator, type ResizeEvent, type ResolvedArgument, type ResolvedCommandLine, type ResolvedSystemCallLine, type RootErrorInfo, type RootHandle, type RootNavigatorList, type RootOptions, type RootUiDataMap, type RootUncaughtErrorInfo, type ScenarioCommandBaseType, type ScenarioEvent, ScrollView, type ScrollViewController, type ScrollViewProps, Select, type SelectListProps, type SelectOption, type SelectOptionSpriteProps, type SelectProps, type ShaderBuiltin, type ShaderBuiltinName, type ShaderEvent, Slider, type SliderProps, type SliderThumbProps, type SliderTrackProps, type StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, TouchEvent, type UseScrollViewOptions, WheelEvent, type WithAnimated, animated as a, addEventListener, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, replaceUiData, setDefaultAutoTailMs, setWaiting, skipState, startDebugSession, startRuntimeDebugSession, stopDebugSession, stopRuntimeDebugSession, useAutoBlocker, useAutoTicket, useBeforeHandleCommandCallback, useDebugSession, useFadeIn, useFadeInOut, useFadeOut, useInterruptCallback, useIsAutoing, useIsSeeking, useIsSkipping, useNavigation, useNavigationParams, useNavigationState, useScenario, useScrollView, useSkipBlocker, useSkipCallback, useSoundEffect, useStageContext, useUiData, warpState };