@momoyu-ink/kit 0.11.3 → 0.13.0

package/AGENTS.md

@@ -47,7 +47,8 @@ packages/kit/src/
 │   ├── useStage.ts          # createStage / StageContextProvider / GameControl
 │   ├── useScenario.ts       # useScenario / nextLine / setWaiting
 │   ├── useFadeInOut.ts      # 淡入淡出辅助
-│   └── useSoundEffect.ts    # 音效便捷 hook
+│   ├── useSoundEffect.ts    # 音效便捷 hook
+│   └── useTouchInput.ts     # 当前输入是否来自触摸
 ├── components/
 │   └── navigation.tsx       # createStackNavigator / Navigation / useNavigation
 ├── spring/                  # react-spring 集成
@@ -120,7 +121,8 @@ moyu.executePluginCommand(pluginName, payload); // 插件命令
 
 **事件类别：**
 
-- **冒泡事件**：`MouseEvent` / `TouchEvent` / `KeyboardEvent` / `WheelEvent`，从目标节点向上冒泡
+- **冒泡事件**：`MouseEvent` / `TouchEvent` / `KeyboardEvent` / `WheelEvent`，从目标节点向上冒泡；`MouseEvent.synthetic` 为 `true` 表示事件由引擎产生（tap 的鼠标兼容手势，或每帧的 hover 刷新），而不是鼠标设备。
+- **触摸的鼠标兼容事件**：触摸 tap 结束时，引擎会补发一套鼠标事件（`MouseMove` / `MouseDown` / `MouseUp` / `Click`），因此 `onClick` 与 `onPress` 在鼠标与触摸下都生效。控件不要再从 `onTouchEnd` 触发点击动作，否则同一次 tap 会触发两次；拖动类交互继续用触摸事件。
 - **节点事件**：`NodeEvent`（创建、销毁）
 - **全局事件**：通过 `addEventListener(type, handler)` 监听
 
@@ -349,6 +351,10 @@ declare namespace JSX {
 - 落在 `hooks/` 下单独文件，在 `hooks.ts` 中 re-export。
 - 优先复用 `useStage` / `useScenario` / valtio snapshot 等既有能力。
 
+### 输入方式相关的 UI
+
+鼠标专有的 hover 交互在触摸设备上无法触发。需要根据输入方式调整 UI 时用 `useTouchInput()`：它在触摸输入后返回 `true`，直到用户真正移动鼠标（`MouseEvent.synthetic` 为 `true` 的事件不计）。状态在模块内共享，多个组件不会重复安装监听。
+
 ### 修改 bindings
 
 **绝对不要**直接编辑 `bindings/` 下的文件。流程：

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

@@ -546,20 +546,68 @@ declare class Node {
     executeCommand(payload: Command): any;
 }
 
-type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'DoubleClick' | 'ContextMenu';
+type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'AuxClick' | 'DoubleClick' | 'ContextMenu';
 
+/**
+ * Buttons of a mouse, as `MouseEvent.button` reports them. Middle is 1, not 2: the
+ * middle button is DOM's auxiliary button.
+ */
+declare const MouseButton: {
+    readonly Left: 0;
+    readonly Middle: 1;
+    readonly Right: 2;
+    readonly Back: 3;
+    readonly Forward: 4;
+};
+/**
+ * Bits of the `MouseEvent.buttons` mask. The auxiliary (middle) button is 4, because
+ * the low three bits are reserved for primary, secondary and auxiliary.
+ */
+declare const MouseButtons: {
+    readonly Left: 1;
+    readonly Right: 2;
+    readonly Middle: 4;
+    readonly Back: 8;
+    readonly Forward: 16;
+};
 interface MouseEvent extends BubbleEvent {
     kind: MouseEventKind;
     targetId: number;
     currentTargetId: number;
     targetLabel?: string;
     currentTargetLabel?: string;
+    /**
+     * Stage logical coordinates of the pointer, an alias of `clientX` / `clientY` that
+     * matches the DOM `MouseEvent.x` / `MouseEvent.y`.
+     */
+    x: number;
+    y: number;
     clientX: number;
     clientY: number;
     screenX: number;
     screenY: number;
     offsetX: number;
     offsetY: number;
+    /**
+     * The button this event is about: 0 left, 1 middle, 2 right, 3 back, 4 forward.
+     */
+    button: number;
+    /**
+     * Buttons held when the event fired, as a bitmask: 1 left, 2 right, 4 middle, 8 back,
+     * 16 forward.
+     */
+    buttons: number;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    /**
+     * True when the engine produced this event rather than a mouse device: the mouse
+     * compatibility gesture of a touch tap, and the hover refresh a frame performs while
+     * the pointer stays where it is. A consumer that wants to know whether the user is
+     * operating a mouse should ignore synthetic events.
+     */
+    synthetic: boolean;
 }
 
 type TouchEventKind = 'TouchStart' | 'TouchMove' | 'TouchEnd' | 'TouchCancel';
@@ -638,8 +686,9 @@ type TextLayoutEvent = {
 
 type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
 
-interface WheelEvent extends Omit<MouseEvent, 'kind'> {
+interface WheelEvent extends BubbleEvent {
     kind: 'Wheel';
+    currentTargetLabel?: string;
     deltaX: number;
     deltaY: number;
     deltaZ: number;
@@ -665,6 +714,7 @@ type NodeProps = {
     tint?: string;
     opacity?: number;
     interactive?: boolean;
+    hitTestSelf?: boolean;
     cursor?: MoyuCursor;
     zIndex?: number;
     excludeFromLayout?: boolean;
@@ -796,6 +846,7 @@ type SpriteProps = {
     nineSliceMode?: NineSliceMode;
     targetWidth?: number;
     targetHeight?: number;
+    alphaHitTest?: boolean;
 };
 
 /**
@@ -937,6 +988,9 @@ interface MoyuListenerAttributes {
     onMouseDown?: MoyuEventHandler<MouseEvent>;
     onMouseUp?: MoyuEventHandler<MouseEvent>;
     onMouseMove?: MoyuEventHandler<MouseEvent>;
+    onAuxClick?: MoyuEventHandler<MouseEvent>;
+    onDoubleClick?: MoyuEventHandler<MouseEvent>;
+    onContextMenu?: MoyuEventHandler<MouseEvent>;
     onKeyDown?: MoyuEventHandler<KeyboardEvent>;
     onKeyUp?: MoyuEventHandler<KeyboardEvent>;
     onKeyPress?: MoyuEventHandler<KeyboardEvent>;
@@ -1051,4 +1105,4 @@ type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand |
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
-export { type ShaderSource as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuShaderAttributes as F, type GamepadCommand as G, type MoyuShaderSlotAttributes as H, type MoyuVideoAttributes as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, Node as N, type OverlayDialog as O, type OverlayNotificationPosition as P, type OverlayStoreFlag as Q, type PlatformInfo as R, type ShaderDirection as S, type TouchEvent as T, type PointerEventKind as U, type RetainMode as V, type WheelEvent as W, type ScenarioCommand as X, type ShaderCommand as Y, type ShaderParam as Z, type ShaderParamType as _, type MaybePromise as a, type ShaderTimeControl as a0, type SteamCommand as a1, type SystemCommand as a2, type TextCommand as a3, type TextInteractionEvent as a4, type TextLayoutEvent as a5, type TimelinePossibleClip as a6, type TouchEventKind as a7, type Tuple2 as a8, type Tuple3 as a9, type Tuple4 as aa, type VideoCommand as ab, type WheelEventDeltaMode as ac, type WindowState as ad, createBubbleEvent as ae, getPlatform as af, getStageSize as ag, mergeEvent as ah, 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, type MouseEventKind as r, type MoyuAnimationAttributes as s, type MoyuBackdropAttributes as t, type MoyuContainerAttributes as u, type MoyuEditableAttributes as v, type MoyuEventHandler as w, type MoyuFilterAttributes as x, type MoyuHBoxAttributes as y, type MoyuListenerAttributes as z };
+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 };

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

@@ -546,20 +546,68 @@ declare class Node {
     executeCommand(payload: Command): any;
 }
 
-type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'DoubleClick' | 'ContextMenu';
+type MouseEventKind = 'MouseEnter' | 'MouseLeave' | 'MouseDown' | 'MouseUp' | 'MouseMove' | 'Click' | 'AuxClick' | 'DoubleClick' | 'ContextMenu';
 
+/**
+ * Buttons of a mouse, as `MouseEvent.button` reports them. Middle is 1, not 2: the
+ * middle button is DOM's auxiliary button.
+ */
+declare const MouseButton: {
+    readonly Left: 0;
+    readonly Middle: 1;
+    readonly Right: 2;
+    readonly Back: 3;
+    readonly Forward: 4;
+};
+/**
+ * Bits of the `MouseEvent.buttons` mask. The auxiliary (middle) button is 4, because
+ * the low three bits are reserved for primary, secondary and auxiliary.
+ */
+declare const MouseButtons: {
+    readonly Left: 1;
+    readonly Right: 2;
+    readonly Middle: 4;
+    readonly Back: 8;
+    readonly Forward: 16;
+};
 interface MouseEvent extends BubbleEvent {
     kind: MouseEventKind;
     targetId: number;
     currentTargetId: number;
     targetLabel?: string;
     currentTargetLabel?: string;
+    /**
+     * Stage logical coordinates of the pointer, an alias of `clientX` / `clientY` that
+     * matches the DOM `MouseEvent.x` / `MouseEvent.y`.
+     */
+    x: number;
+    y: number;
     clientX: number;
     clientY: number;
     screenX: number;
     screenY: number;
     offsetX: number;
     offsetY: number;
+    /**
+     * The button this event is about: 0 left, 1 middle, 2 right, 3 back, 4 forward.
+     */
+    button: number;
+    /**
+     * Buttons held when the event fired, as a bitmask: 1 left, 2 right, 4 middle, 8 back,
+     * 16 forward.
+     */
+    buttons: number;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    /**
+     * True when the engine produced this event rather than a mouse device: the mouse
+     * compatibility gesture of a touch tap, and the hover refresh a frame performs while
+     * the pointer stays where it is. A consumer that wants to know whether the user is
+     * operating a mouse should ignore synthetic events.
+     */
+    synthetic: boolean;
 }
 
 type TouchEventKind = 'TouchStart' | 'TouchMove' | 'TouchEnd' | 'TouchCancel';
@@ -638,8 +686,9 @@ type TextLayoutEvent = {
 
 type WheelEventDeltaMode = 'pixel' | 'line' | 'page';
 
-interface WheelEvent extends Omit<MouseEvent, 'kind'> {
+interface WheelEvent extends BubbleEvent {
     kind: 'Wheel';
+    currentTargetLabel?: string;
     deltaX: number;
     deltaY: number;
     deltaZ: number;
@@ -665,6 +714,7 @@ type NodeProps = {
     tint?: string;
     opacity?: number;
     interactive?: boolean;
+    hitTestSelf?: boolean;
     cursor?: MoyuCursor;
     zIndex?: number;
     excludeFromLayout?: boolean;
@@ -796,6 +846,7 @@ type SpriteProps = {
     nineSliceMode?: NineSliceMode;
     targetWidth?: number;
     targetHeight?: number;
+    alphaHitTest?: boolean;
 };
 
 /**
@@ -937,6 +988,9 @@ interface MoyuListenerAttributes {
     onMouseDown?: MoyuEventHandler<MouseEvent>;
     onMouseUp?: MoyuEventHandler<MouseEvent>;
     onMouseMove?: MoyuEventHandler<MouseEvent>;
+    onAuxClick?: MoyuEventHandler<MouseEvent>;
+    onDoubleClick?: MoyuEventHandler<MouseEvent>;
+    onContextMenu?: MoyuEventHandler<MouseEvent>;
     onKeyDown?: MoyuEventHandler<KeyboardEvent>;
     onKeyUp?: MoyuEventHandler<KeyboardEvent>;
     onKeyPress?: MoyuEventHandler<KeyboardEvent>;
@@ -1051,4 +1105,4 @@ type _Command = AudioCommand | EditableCommand | TextCommand | GamepadCommand |
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
-export { type ShaderSource as $, type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EditableState as E, type MoyuShaderAttributes as F, type GamepadCommand as G, type MoyuShaderSlotAttributes as H, type MoyuVideoAttributes as I, JSX as J, type KeyboardEvent as K, type LayoutEvent as L, type MoyuEvent as M, Node as N, type OverlayDialog as O, type OverlayNotificationPosition as P, type OverlayStoreFlag as Q, type PlatformInfo as R, type ShaderDirection as S, type TouchEvent as T, type PointerEventKind as U, type RetainMode as V, type WheelEvent as W, type ScenarioCommand as X, type ShaderCommand as Y, type ShaderParam as Z, type ShaderParamType as _, type MaybePromise as a, type ShaderTimeControl as a0, type SteamCommand as a1, type SystemCommand as a2, type TextCommand as a3, type TextInteractionEvent as a4, type TextLayoutEvent as a5, type TimelinePossibleClip as a6, type TouchEventKind as a7, type Tuple2 as a8, type Tuple3 as a9, type Tuple4 as aa, type VideoCommand as ab, type WheelEventDeltaMode as ac, type WindowState as ad, createBubbleEvent as ae, getPlatform as af, getStageSize as ag, mergeEvent as ah, 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, type MouseEventKind as r, type MoyuAnimationAttributes as s, type MoyuBackdropAttributes as t, type MoyuContainerAttributes as u, type MoyuEditableAttributes as v, type MoyuEventHandler as w, type MoyuFilterAttributes as x, type MoyuHBoxAttributes as y, type MoyuListenerAttributes as z };
+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 };

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-xC0sDJ2D.mjs';
+export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.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-xC0sDJ2D.js';
+export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.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-xC0sDJ2D.mjs';
+export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.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-xC0sDJ2D.js';
+export { J as JSX } from './jsx-dev-runtime-Dvhilv0K.js';
 import 'react/jsx-dev-runtime';
 import 'react';

package/dist/lib.cjs

@@ -35,6 +35,8 @@ __export(lib_exports, {
   Checkbox: () => Checkbox,
   DEBUG_EMPTY_PAGE: () => DEBUG_EMPTY_PAGE,
   Input: () => Input,
+  MouseButton: () => MouseButton,
+  MouseButtons: () => MouseButtons,
   OverlayParamsContext: () => OverlayParamsContext,
   PageParamsContext: () => PageParamsContext,
   Radio: () => Radio,
@@ -102,6 +104,7 @@ __export(lib_exports, {
   useSkipCallback: () => useSkipCallback,
   useSoundEffect: () => useSoundEffect,
   useStageContext: () => useStageContext,
+  useTouchInput: () => useTouchInput,
   useUiData: () => useUiData,
   warpState: () => warpState
 });
@@ -174,8 +177,7 @@ function executePluginCommand(pluginName, payload) {
 
 // src/state.ts
 var STATE = {
-  nodeMap: {},
-  touchMoved: {}
+  nodeMap: {}
 };
 
 // src/node.ts
@@ -914,6 +916,11 @@ globalThis.__moyu_receive_event = (raw_event) => {
 };
 function handleBubbleEvent(name, body) {
   const event = createBubbleEvent(body, body.targetId);
+  if (name === "mouseevent") {
+    const mouseEvent = event;
+    mouseEvent.x = mouseEvent.clientX;
+    mouseEvent.y = mouseEvent.clientY;
+  }
   const { kind, bubbleTargetIds } = body;
   if (body.targetId !== 0) {
     const node = STATE.nodeMap[body.targetId];
@@ -939,13 +946,6 @@ function handleBubbleEvent(name, body) {
           STATE.nodeMap[event.currentTargetId]?.listeners?.[`on${kind}`]?.(event);
         }
       }
-      if (kind === "TouchStart") {
-        STATE.touchMoved[identifier] = false;
-      } else if (kind === "TouchMove") {
-        STATE.touchMoved[identifier] = true;
-      } else if (kind === "TouchEnd" || kind === "TouchCancel") {
-        delete STATE.touchMoved[identifier];
-      }
     }
   }
   if (event.bubbles) {
@@ -977,6 +977,22 @@ function addEventListener(name, callback) {
   };
 }
 
+// src/events/mouse.ts
+var MouseButton = {
+  Left: 0,
+  Middle: 1,
+  Right: 2,
+  Back: 3,
+  Forward: 4
+};
+var MouseButtons = {
+  Left: 1,
+  Right: 2,
+  Middle: 4,
+  Back: 8,
+  Forward: 16
+};
+
 // src/utils.ts
 function getStageSize() {
   const stageSize = executePluginCommand("system", {
@@ -1342,6 +1358,7 @@ function Button({
       anchor,
       pivot,
       interactive: disabled ? false : interactive,
+      hitTestSelf: false,
       onMouseEnter: mergeEvent(onMouseEnter, (event) => {
         if (event.targetId === event.currentTargetId) {
           event.stopPropagation();
@@ -1354,18 +1371,12 @@ function Button({
         setPressed(false);
       }),
       onMouseDown: mergeEvent(onMouseDown, () => setPressed(true)),
-      onMouseUp: mergeEvent(onMouseUp, (event) => {
-        if (pressed) {
-          onPress?.(event);
-        }
+      onMouseUp: mergeEvent(onMouseUp, () => {
         setPressed(false);
         setHovered(true);
       }),
       onTouchStart: mergeEvent(onTouchStart, () => setPressed(true)),
-      onTouchEnd: mergeEvent(onTouchEnd, (event) => {
-        if (pressed) {
-          onPress?.(event);
-        }
+      onTouchEnd: mergeEvent(onTouchEnd, () => {
         setPressed(false);
         setHovered(true);
       }),
@@ -1373,7 +1384,10 @@ function Button({
         setHovered(false);
         setPressed(false);
       }),
-      onClick: (event) => event.stopPropagation(),
+      onClick: (event) => {
+        onPress?.(event);
+        event.stopPropagation();
+      },
       children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("sprite", { ...spriteProps, src: resolveControlStateValue(src, state), cursor: "pointer", children: [
         text !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
           "text",
@@ -1794,6 +1808,7 @@ function Select({
       anchor,
       pivot,
       interactive: disabled ? false : containerProps.interactive,
+      hitTestSelf: false,
       children: [
         /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
           Button,
@@ -1909,14 +1924,18 @@ function Slider({
     }
   }, [onValueCommit]);
   (0, import_react9.useEffect)(() => {
-    const handleMouseUp = () => endDragging(true);
+    const handleMouseUp = () => {
+      if (dragStateRef.current?.pointerIdentifier === void 0) {
+        endDragging(true);
+      }
+    };
     const handleTouchEnd = (event) => {
-      if (dragStateRef.current?.touchIdentifier === event.identifier) {
+      if (dragStateRef.current?.pointerIdentifier === event.identifier) {
         endDragging(true);
       }
     };
     const handleTouchCancel2 = (event) => {
-      if (dragStateRef.current?.touchIdentifier === event.identifier) {
+      if (dragStateRef.current?.pointerIdentifier === event.identifier) {
         endDragging(false);
       }
     };
@@ -1939,45 +1958,37 @@ function Slider({
     if (dragStateRef.current !== null) {
       return;
     }
+    onPress?.(event);
+    if (event.defaultPrevented) {
+      return;
+    }
     const thumbPosition = currentValueRef.current * distance;
+    const onThumb = event.offsetX >= thumbPosition && event.offsetX <= thumbPosition + thumb.targetWidth;
+    let startValue = currentValueRef.current;
+    if (!onThumb && distance > 0) {
+      startValue = clampValue((event.offsetX - thumb.targetWidth / 2) / distance);
+      setSliderValue(startValue);
+    }
     dragStateRef.current = {
-      startPosition: event.offsetX,
-      startValue: currentValueRef.current,
-      touchIdentifier: "identifier" in event ? event.identifier : void 0,
-      startedOnThumb: event.offsetX >= thumbPosition && event.offsetX <= thumbPosition + thumb.targetWidth,
-      moved: false
+      // The movement is measured in stage coordinates: `offsetX` is relative to the node
+      // the pointer is over, which changes when the pointer leaves the track.
+      startPointerX: event.clientX,
+      startValue,
+      pointerIdentifier: "identifier" in event ? event.identifier : void 0
     };
     setDragging(true);
   };
   const moveDragging = (event) => {
     const dragState = dragStateRef.current;
-    if (dragState === null || "identifier" in event && dragState.touchIdentifier !== event.identifier || distance === 0) {
+    const eventIdentifier = "identifier" in event ? event.identifier : void 0;
+    if (dragState === null || dragState.pointerIdentifier !== eventIdentifier || distance === 0) {
       return;
     }
     event.stopPropagation();
-    const delta = event.offsetX - dragState.startPosition;
-    if (delta !== 0) {
-      dragState.moved = true;
-    }
-    setSliderValue(dragState.startValue + delta / distance);
-  };
-  const handlePress = (event) => {
-    const dragState = dragStateRef.current;
-    if (dragState === null || "identifier" in event && dragState.touchIdentifier !== event.identifier) {
-      return;
-    }
-    onPress?.(event);
-    if (event.defaultPrevented) {
-      endDragging(false);
-      return;
-    }
-    if (!dragState.moved && !dragState.startedOnThumb && distance > 0) {
-      setSliderValue((event.offsetX - thumb.targetWidth / 2) / distance);
-    }
-    endDragging(true);
+    setSliderValue(dragState.startValue + (event.clientX - dragState.startPointerX) / distance);
   };
   const handleTouchCancel = (event) => {
-    if (dragStateRef.current?.touchIdentifier === event.identifier) {
+    if (dragStateRef.current?.pointerIdentifier === event.identifier) {
       endDragging(false);
     }
   };
@@ -1995,7 +2006,6 @@ function Slider({
         pivot: [0, 0.5],
         y: (track.targetHeight ?? 0) / 2
       },
-      onPress: handlePress,
       onMouseEnter,
       onMouseLeave,
       onMouseDown: mergeEvent(onMouseDown, startDragging),
@@ -4097,5 +4107,58 @@ function useBeforeHandleCommandCallback(callback) {
   }, [stage, callback]);
 }
 
+// src/hooks/useTouchInput.ts
+var import_react14 = require("react");
+var touchInput = false;
+var subscribers = /* @__PURE__ */ new Set();
+var uninstall = null;
+function setTouchInput(value) {
+  if (value === touchInput) {
+    return;
+  }
+  touchInput = value;
+  for (const notify of [...subscribers]) {
+    notify(value);
+  }
+}
+function install() {
+  if (uninstall) {
+    return;
+  }
+  const cleanups = [
+    // A touch means the device is being used by hand.
+    addEventListener("touchstart", () => setTouchInput(true)),
+    // Only a mouse event the engine did not produce on its own means the user reached
+    // for the mouse: a tap's mouse compatibility gesture and the hover refresh a frame
+    // repeats both carry `synthetic`.
+    addEventListener("mousemove", (event) => {
+      if (!event.synthetic) {
+        setTouchInput(false);
+      }
+    })
+  ];
+  uninstall = () => {
+    for (const cleanup of cleanups) {
+      cleanup();
+    }
+    uninstall = null;
+  };
+}
+function useTouchInput() {
+  const [value, setValue] = (0, import_react14.useState)(touchInput);
+  (0, import_react14.useEffect)(() => {
+    subscribers.add(setValue);
+    setValue(touchInput);
+    install();
+    return () => {
+      subscribers.delete(setValue);
+      if (subscribers.size === 0) {
+        uninstall?.();
+      }
+    };
+  }, []);
+  return value;
+}
+
 // src/lib.ts
 __reExport(lib_exports, require("@react-spring/core"), module.exports);

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-xC0sDJ2D.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 MouseEventKind, s as MoyuAnimationAttributes, t as MoyuBackdropAttributes, u as MoyuContainerAttributes, v as MoyuEditableAttributes, w as MoyuEventHandler, x as MoyuFilterAttributes, y as MoyuHBoxAttributes, z as MoyuListenerAttributes, F as MoyuShaderAttributes, H as MoyuShaderSlotAttributes, I as MoyuVideoAttributes, N as Node, O as OverlayDialog, P as OverlayNotificationPosition, Q as OverlayStoreFlag, R as PlatformInfo, U as PointerEventKind, V as RetainMode, X as ScenarioCommand, Y as ShaderCommand, Z as ShaderParam, _ as ShaderParamType, $ as ShaderSource, a0 as ShaderTimeControl, a1 as SteamCommand, a2 as SystemCommand, a3 as TextCommand, a4 as TextInteractionEvent, a5 as TextLayoutEvent, a6 as TimelinePossibleClip, a7 as TouchEventKind, a8 as Tuple2, a9 as Tuple3, aa as Tuple4, ab as VideoCommand, ac as WheelEventDeltaMode, ad as WindowState, ae as createBubbleEvent, af as getPlatform, ag as getStageSize, ah as mergeEvent } from './jsx-dev-runtime-xC0sDJ2D.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-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 { 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';
@@ -617,7 +617,12 @@ interface ButtonProps extends Omit<MoyuNodeAttributes, 'onClick'> {
     sprite: ControlSpriteProps;
     disabled?: boolean;
     lockOn?: Exclude<ControlState, 'disabled'>;
-    onPress?: (event: PressEvent) => void;
+    /**
+     * Called when the button is activated, which is the engine's click gesture. The press
+     * visual comes from the pointer press instead, so a gesture that ends away from the
+     * button shows as pressed but does not activate it.
+     */
+    onPress?: (event: MouseEvent) => void;
     text?: string;
     textStyle?: ControlStateValue<ControlTextStyle>;
     textOffsetX?: number;
@@ -737,6 +742,7 @@ interface SliderProps extends Omit<MoyuNodeAttributes, 'onClick'> {
     defaultValue?: number;
     onValueChange?: (value: number) => void;
     onValueCommit?: (value: number) => void;
+    /** Called when the pointer presses the slider, before the drag starts. */
     onPress?: (event: PressEvent) => void;
     disabled?: boolean;
     track: SliderTrackProps;
@@ -1050,6 +1056,8 @@ declare function useScenario(stories: string[], startName?: string, entryName?:
  */
 declare function useSoundEffect(src?: string): () => void;
 
+declare function useTouchInput(): boolean;
+
 type UiDocument = Record<string, unknown>;
 type UiSchema<TUiDocument extends UiDocument> = ZodType<TUiDocument>;
 interface RootUiDataMap {
@@ -1086,4 +1094,4 @@ declare module 'zod' {
     }
 }
 
-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 DlcProgress, EditableChangeSource, EditableState, 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, Input, type InputBackground, type InputBackgroundStates, type InputBackgroundStyle, type InputCaretStyle, type InputHandle, type InputProps, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuTextAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, Radio, RadioGroup, type RadioGroupProps, type RadioProps, 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, addFluidObserver, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, removeFluidObserver, 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 };
+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 DlcProgress, EditableChangeSource, EditableState, 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, Input, type InputBackground, type InputBackgroundStates, type InputBackgroundStyle, type InputCaretStyle, type InputHandle, type InputProps, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuTextAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, Radio, RadioGroup, type RadioGroupProps, type RadioProps, 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, addFluidObserver, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, removeFluidObserver, 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, useTouchInput, useUiData, warpState };

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-xC0sDJ2D.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 MouseEventKind, s as MoyuAnimationAttributes, t as MoyuBackdropAttributes, u as MoyuContainerAttributes, v as MoyuEditableAttributes, w as MoyuEventHandler, x as MoyuFilterAttributes, y as MoyuHBoxAttributes, z as MoyuListenerAttributes, F as MoyuShaderAttributes, H as MoyuShaderSlotAttributes, I as MoyuVideoAttributes, N as Node, O as OverlayDialog, P as OverlayNotificationPosition, Q as OverlayStoreFlag, R as PlatformInfo, U as PointerEventKind, V as RetainMode, X as ScenarioCommand, Y as ShaderCommand, Z as ShaderParam, _ as ShaderParamType, $ as ShaderSource, a0 as ShaderTimeControl, a1 as SteamCommand, a2 as SystemCommand, a3 as TextCommand, a4 as TextInteractionEvent, a5 as TextLayoutEvent, a6 as TimelinePossibleClip, a7 as TouchEventKind, a8 as Tuple2, a9 as Tuple3, aa as Tuple4, ab as VideoCommand, ac as WheelEventDeltaMode, ad as WindowState, ae as createBubbleEvent, af as getPlatform, ag as getStageSize, ah as mergeEvent } from './jsx-dev-runtime-xC0sDJ2D.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-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 { 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';
@@ -617,7 +617,12 @@ interface ButtonProps extends Omit<MoyuNodeAttributes, 'onClick'> {
     sprite: ControlSpriteProps;
     disabled?: boolean;
     lockOn?: Exclude<ControlState, 'disabled'>;
-    onPress?: (event: PressEvent) => void;
+    /**
+     * Called when the button is activated, which is the engine's click gesture. The press
+     * visual comes from the pointer press instead, so a gesture that ends away from the
+     * button shows as pressed but does not activate it.
+     */
+    onPress?: (event: MouseEvent) => void;
     text?: string;
     textStyle?: ControlStateValue<ControlTextStyle>;
     textOffsetX?: number;
@@ -737,6 +742,7 @@ interface SliderProps extends Omit<MoyuNodeAttributes, 'onClick'> {
     defaultValue?: number;
     onValueChange?: (value: number) => void;
     onValueCommit?: (value: number) => void;
+    /** Called when the pointer presses the slider, before the drag starts. */
     onPress?: (event: PressEvent) => void;
     disabled?: boolean;
     track: SliderTrackProps;
@@ -1050,6 +1056,8 @@ declare function useScenario(stories: string[], startName?: string, entryName?:
  */
 declare function useSoundEffect(src?: string): () => void;
 
+declare function useTouchInput(): boolean;
+
 type UiDocument = Record<string, unknown>;
 type UiSchema<TUiDocument extends UiDocument> = ZodType<TUiDocument>;
 interface RootUiDataMap {
@@ -1086,4 +1094,4 @@ declare module 'zod' {
     }
 }
 
-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 DlcProgress, EditableChangeSource, EditableState, 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, Input, type InputBackground, type InputBackgroundStates, type InputBackgroundStyle, type InputCaretStyle, type InputHandle, type InputProps, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuTextAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, Radio, RadioGroup, type RadioGroupProps, type RadioProps, 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, addFluidObserver, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, removeFluidObserver, 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 };
+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 DlcProgress, EditableChangeSource, EditableState, 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, Input, type InputBackground, type InputBackgroundStates, type InputBackgroundStyle, type InputCaretStyle, type InputHandle, type InputProps, JSX, type KeyboardLocation, LayoutEvent, type Literal, MaybePromise, MouseEvent, MoyuClipAttributes, MoyuEvent, MoyuNodeAttributes, MoyuSpriteAttributes, MoyuTextAttributes, MoyuVBoxAttributes, type NavigationState, type Navigator, type NodeEvent, type OverlayConfig, type OverlayDescriptor, type OverlayInfo, OverlayParamsContext, type PageConfig, type PageDescriptor, PageParamsContext, type PressEvent, Radio, RadioGroup, type RadioGroupProps, type RadioProps, 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, addFluidObserver, animated, autoState, createGameStateContext, createRoot, createStackNavigator, createStage, createStaticNavigation, ensureArchiveVariableDefaults, executeNodeCommand, executePluginCommand, fastForwardState, getAppStateAdapter, getNavigator, getSeekingType, getUiData, globalEventListeners, globalRequestAnimationFrameListeners, initGlobalVariableDefaults, initUiData, loadVariablesDocument, moyu, nextLine, registerAppStateAdapter, removeFluidObserver, 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, useTouchInput, useUiData, warpState };

package/dist/lib.mjs

@@ -23,6 +23,8 @@ __export(lib_exports, {
   Checkbox: () => Checkbox,
   DEBUG_EMPTY_PAGE: () => DEBUG_EMPTY_PAGE,
   Input: () => Input,
+  MouseButton: () => MouseButton,
+  MouseButtons: () => MouseButtons,
   OverlayParamsContext: () => OverlayParamsContext,
   PageParamsContext: () => PageParamsContext,
   Radio: () => Radio,
@@ -90,6 +92,7 @@ __export(lib_exports, {
   useSkipCallback: () => useSkipCallback,
   useSoundEffect: () => useSoundEffect,
   useStageContext: () => useStageContext,
+  useTouchInput: () => useTouchInput,
   useUiData: () => useUiData,
   warpState: () => warpState
 });
@@ -161,8 +164,7 @@ function executePluginCommand(pluginName, payload) {
 
 // src/state.ts
 var STATE = {
-  nodeMap: {},
-  touchMoved: {}
+  nodeMap: {}
 };
 
 // src/node.ts
@@ -908,6 +910,11 @@ globalThis.__moyu_receive_event = (raw_event) => {
 };
 function handleBubbleEvent(name, body) {
   const event = createBubbleEvent(body, body.targetId);
+  if (name === "mouseevent") {
+    const mouseEvent = event;
+    mouseEvent.x = mouseEvent.clientX;
+    mouseEvent.y = mouseEvent.clientY;
+  }
   const { kind, bubbleTargetIds } = body;
   if (body.targetId !== 0) {
     const node = STATE.nodeMap[body.targetId];
@@ -933,13 +940,6 @@ function handleBubbleEvent(name, body) {
           STATE.nodeMap[event.currentTargetId]?.listeners?.[`on${kind}`]?.(event);
         }
       }
-      if (kind === "TouchStart") {
-        STATE.touchMoved[identifier] = false;
-      } else if (kind === "TouchMove") {
-        STATE.touchMoved[identifier] = true;
-      } else if (kind === "TouchEnd" || kind === "TouchCancel") {
-        delete STATE.touchMoved[identifier];
-      }
     }
   }
   if (event.bubbles) {
@@ -971,6 +971,22 @@ function addEventListener(name, callback) {
   };
 }
 
+// src/events/mouse.ts
+var MouseButton = {
+  Left: 0,
+  Middle: 1,
+  Right: 2,
+  Back: 3,
+  Forward: 4
+};
+var MouseButtons = {
+  Left: 1,
+  Right: 2,
+  Middle: 4,
+  Back: 8,
+  Forward: 16
+};
+
 // src/utils.ts
 function getStageSize() {
   const stageSize = executePluginCommand("system", {
@@ -1336,6 +1352,7 @@ function Button({
       anchor,
       pivot,
       interactive: disabled ? false : interactive,
+      hitTestSelf: false,
       onMouseEnter: mergeEvent(onMouseEnter, (event) => {
         if (event.targetId === event.currentTargetId) {
           event.stopPropagation();
@@ -1348,18 +1365,12 @@ function Button({
         setPressed(false);
       }),
       onMouseDown: mergeEvent(onMouseDown, () => setPressed(true)),
-      onMouseUp: mergeEvent(onMouseUp, (event) => {
-        if (pressed) {
-          onPress?.(event);
-        }
+      onMouseUp: mergeEvent(onMouseUp, () => {
         setPressed(false);
         setHovered(true);
       }),
       onTouchStart: mergeEvent(onTouchStart, () => setPressed(true)),
-      onTouchEnd: mergeEvent(onTouchEnd, (event) => {
-        if (pressed) {
-          onPress?.(event);
-        }
+      onTouchEnd: mergeEvent(onTouchEnd, () => {
         setPressed(false);
         setHovered(true);
       }),
@@ -1367,7 +1378,10 @@ function Button({
         setHovered(false);
         setPressed(false);
       }),
-      onClick: (event) => event.stopPropagation(),
+      onClick: (event) => {
+        onPress?.(event);
+        event.stopPropagation();
+      },
       children: /* @__PURE__ */ jsxs("sprite", { ...spriteProps, src: resolveControlStateValue(src, state), cursor: "pointer", children: [
         text !== void 0 ? /* @__PURE__ */ jsx(
           "text",
@@ -1788,6 +1802,7 @@ function Select({
       anchor,
       pivot,
       interactive: disabled ? false : containerProps.interactive,
+      hitTestSelf: false,
       children: [
         /* @__PURE__ */ jsx(
           Button,
@@ -1903,14 +1918,18 @@ function Slider({
     }
   }, [onValueCommit]);
   useEffect3(() => {
-    const handleMouseUp = () => endDragging(true);
+    const handleMouseUp = () => {
+      if (dragStateRef.current?.pointerIdentifier === void 0) {
+        endDragging(true);
+      }
+    };
     const handleTouchEnd = (event) => {
-      if (dragStateRef.current?.touchIdentifier === event.identifier) {
+      if (dragStateRef.current?.pointerIdentifier === event.identifier) {
         endDragging(true);
       }
     };
     const handleTouchCancel2 = (event) => {
-      if (dragStateRef.current?.touchIdentifier === event.identifier) {
+      if (dragStateRef.current?.pointerIdentifier === event.identifier) {
         endDragging(false);
       }
     };
@@ -1933,45 +1952,37 @@ function Slider({
     if (dragStateRef.current !== null) {
       return;
     }
+    onPress?.(event);
+    if (event.defaultPrevented) {
+      return;
+    }
     const thumbPosition = currentValueRef.current * distance;
+    const onThumb = event.offsetX >= thumbPosition && event.offsetX <= thumbPosition + thumb.targetWidth;
+    let startValue = currentValueRef.current;
+    if (!onThumb && distance > 0) {
+      startValue = clampValue((event.offsetX - thumb.targetWidth / 2) / distance);
+      setSliderValue(startValue);
+    }
     dragStateRef.current = {
-      startPosition: event.offsetX,
-      startValue: currentValueRef.current,
-      touchIdentifier: "identifier" in event ? event.identifier : void 0,
-      startedOnThumb: event.offsetX >= thumbPosition && event.offsetX <= thumbPosition + thumb.targetWidth,
-      moved: false
+      // The movement is measured in stage coordinates: `offsetX` is relative to the node
+      // the pointer is over, which changes when the pointer leaves the track.
+      startPointerX: event.clientX,
+      startValue,
+      pointerIdentifier: "identifier" in event ? event.identifier : void 0
     };
     setDragging(true);
   };
   const moveDragging = (event) => {
     const dragState = dragStateRef.current;
-    if (dragState === null || "identifier" in event && dragState.touchIdentifier !== event.identifier || distance === 0) {
+    const eventIdentifier = "identifier" in event ? event.identifier : void 0;
+    if (dragState === null || dragState.pointerIdentifier !== eventIdentifier || distance === 0) {
       return;
     }
     event.stopPropagation();
-    const delta = event.offsetX - dragState.startPosition;
-    if (delta !== 0) {
-      dragState.moved = true;
-    }
-    setSliderValue(dragState.startValue + delta / distance);
-  };
-  const handlePress = (event) => {
-    const dragState = dragStateRef.current;
-    if (dragState === null || "identifier" in event && dragState.touchIdentifier !== event.identifier) {
-      return;
-    }
-    onPress?.(event);
-    if (event.defaultPrevented) {
-      endDragging(false);
-      return;
-    }
-    if (!dragState.moved && !dragState.startedOnThumb && distance > 0) {
-      setSliderValue((event.offsetX - thumb.targetWidth / 2) / distance);
-    }
-    endDragging(true);
+    setSliderValue(dragState.startValue + (event.clientX - dragState.startPointerX) / distance);
   };
   const handleTouchCancel = (event) => {
-    if (dragStateRef.current?.touchIdentifier === event.identifier) {
+    if (dragStateRef.current?.pointerIdentifier === event.identifier) {
       endDragging(false);
     }
   };
@@ -1989,7 +2000,6 @@ function Slider({
         pivot: [0, 0.5],
         y: (track.targetHeight ?? 0) / 2
       },
-      onPress: handlePress,
       onMouseEnter,
       onMouseLeave,
       onMouseDown: mergeEvent(onMouseDown, startDragging),
@@ -4091,6 +4101,59 @@ function useBeforeHandleCommandCallback(callback) {
   }, [stage, callback]);
 }
 
+// src/hooks/useTouchInput.ts
+import { useEffect as useEffect8, useState as useState8 } from "react";
+var touchInput = false;
+var subscribers = /* @__PURE__ */ new Set();
+var uninstall = null;
+function setTouchInput(value) {
+  if (value === touchInput) {
+    return;
+  }
+  touchInput = value;
+  for (const notify of [...subscribers]) {
+    notify(value);
+  }
+}
+function install() {
+  if (uninstall) {
+    return;
+  }
+  const cleanups = [
+    // A touch means the device is being used by hand.
+    addEventListener("touchstart", () => setTouchInput(true)),
+    // Only a mouse event the engine did not produce on its own means the user reached
+    // for the mouse: a tap's mouse compatibility gesture and the hover refresh a frame
+    // repeats both carry `synthetic`.
+    addEventListener("mousemove", (event) => {
+      if (!event.synthetic) {
+        setTouchInput(false);
+      }
+    })
+  ];
+  uninstall = () => {
+    for (const cleanup of cleanups) {
+      cleanup();
+    }
+    uninstall = null;
+  };
+}
+function useTouchInput() {
+  const [value, setValue] = useState8(touchInput);
+  useEffect8(() => {
+    subscribers.add(setValue);
+    setValue(touchInput);
+    install();
+    return () => {
+      subscribers.delete(setValue);
+      if (subscribers.size === 0) {
+        uninstall?.();
+      }
+    };
+  }, []);
+  return value;
+}
+
 // src/lib.ts
 export * from "@react-spring/core";
 export {
@@ -4098,6 +4161,8 @@ export {
   Checkbox,
   DEBUG_EMPTY_PAGE,
   Input,
+  MouseButton,
+  MouseButtons,
   OverlayParamsContext,
   PageParamsContext,
   Radio,
@@ -4165,6 +4230,7 @@ export {
   useSkipCallback,
   useSoundEffect,
   useStageContext,
+  useTouchInput,
   useUiData,
   warpState
 };

package/package.json

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