@momoyu-ink/kit 0.8.1 → 0.9.0

package/dist/{jsx-dev-runtime-BCxm528Z.d.mts → jsx-dev-runtime-De053cfK.d.mts}

@@ -266,6 +266,24 @@ type ScenarioCommand = {
     pattern?: string;
 };
 
+type RetainMode = 'static' | 'live';
+
+type ShaderCommand = {
+    subCommand: 'prepare';
+    fromChannel: number;
+    toChannel: number;
+    mode?: RetainMode;
+} | {
+    subCommand: 'perform';
+    duration: number;
+} | {
+    subCommand: 'start';
+} | {
+    subCommand: 'stop';
+} | {
+    subCommand: 'reset';
+};
+
 type ReadFormat = 'text' | 'binary';
 
 type WindowState = 'idle' | 'maximized' | 'minimized' | 'fullscreen';
@@ -325,7 +343,58 @@ type MakeNullOptional<T> = T extends any ? {
     [K in keyof T as null extends T[K] ? K : never]?: T[K];
 } : never;
 
-type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | SystemCommand;
+type ShaderDirection = 'left' | 'right' | 'up' | 'down';
+
+type ShaderParamType = 'float' | 'int';
+
+type ShaderParam = {
+    name: string;
+    type: ShaderParamType;
+    value: number;
+};
+
+type ShaderSource = ({
+    type: 'builtin';
+} & ({
+    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: 'raw';
+    content: string;
+    params?: Array<ShaderParam>;
+};
+
+type ShaderTimeControl = 'auto' | 'manual' | 'transition';
+
+type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SystemCommand;
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
@@ -564,6 +633,23 @@ type TextProps = {
     shadowWidth?: number;
 };
 
+type ShaderProps = {
+    shader?: ShaderSource;
+    timeControl?: ShaderTimeControl;
+    displayChannel?: number | null;
+};
+
+type ShaderSlotSpace = 'normal' | 'shader';
+
+type ShaderSlotProps = {
+    channel?: number;
+    empty?: boolean;
+    static?: boolean;
+    space?: ShaderSlotSpace;
+    width?: number;
+    height?: number;
+};
+
 type AnimationFormat = 'apng' | 'webp';
 
 type AnimationProps = {
@@ -608,6 +694,10 @@ type MoyuClipAttributes = ClipProps & MoyuNodeAttributes;
 type MoyuFilterAttributes = FilterProps & MoyuNodeAttributes;
 type MoyuBackdropAttributes = BackdropProps & MoyuNodeAttributes;
 type MoyuAnimationAttributes = AnimationProps & MoyuNodeAttributes;
+type MoyuShaderAttributes = ShaderProps & MoyuNodeAttributes & {
+    onFinished?: () => void;
+};
+type MoyuShaderSlotAttributes = ShaderSlotProps & MoyuNodeAttributes;
 type MoyuVideoAttributes = VideoProps & MoyuNodeAttributes & {
     onEnded?: () => void;
     onStateChange?: (state: string) => void;
@@ -643,8 +733,10 @@ declare namespace JSX {
         filter: DetailedMoyuProps<MoyuFilterAttributes>;
         backdrop: DetailedMoyuProps<MoyuBackdropAttributes>;
         animation: DetailedMoyuProps<MoyuAnimationAttributes>;
+        shader: DetailedMoyuProps<MoyuShaderAttributes>;
+        'shader-slot': DetailedMoyuProps<MoyuShaderSlotAttributes>;
         video: DetailedMoyuProps<MoyuVideoAttributes>;
     }
 }
 
-export { type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type GamepadCommand as G, JSX as J, type KeyboardEvent as K, type MouseEvent as M, Node as N, type ScenarioCommand as S, type TextCommand as T, type WindowState as W, type MoyuEvent as a, type MaybePromise as b, type JsonValue as c, type AudioSettings as d, type KeyboardEventKind as e, type MakeNullOptional as f, type MouseEventKind as g, type MoyuAnimationAttributes as h, type MoyuBackdropAttributes as i, type MoyuClipAttributes as j, type MoyuContainerAttributes as k, type MoyuEventHandler as l, type MoyuFilterAttributes as m, type MoyuListenerAttributes as n, type MoyuNodeAttributes as o, type MoyuSpriteAttributes as p, type MoyuTextAttributes as q, type MoyuVideoAttributes as r, type SystemCommand as s, type TouchEvent as t, type TouchEventKind as u, type Tuple2 as v, type Tuple3 as w, type Tuple4 as x, createBubbleEvent as y, getStageSize as z };
+export { type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type SystemCommand as F, type GamepadCommand as G, type TouchEvent as H, type TouchEventKind as I, JSX as J, type KeyboardEvent as K, type Tuple2 as L, type MouseEvent as M, Node as N, type Tuple3 as O, type Tuple4 as P, createBubbleEvent as Q, type RetainMode as R, type ShaderDirection as S, type TextCommand as T, getStageSize as U, type WindowState as W, type MoyuEvent as a, type MaybePromise as b, type JsonValue as c, type AudioSettings as d, type KeyboardEventKind as e, type MakeNullOptional as f, type MouseEventKind as g, type MoyuAnimationAttributes as h, type MoyuBackdropAttributes as i, type MoyuClipAttributes as j, type MoyuContainerAttributes as k, type MoyuEventHandler as l, type MoyuFilterAttributes as m, type MoyuListenerAttributes as n, type MoyuNodeAttributes as o, type MoyuShaderAttributes as p, type MoyuShaderSlotAttributes as q, type MoyuSpriteAttributes as r, type MoyuTextAttributes as s, type MoyuVideoAttributes as t, type ScenarioCommand as u, type ShaderCommand as v, type ShaderParam as w, type ShaderParamType as x, type ShaderSource as y, type ShaderTimeControl as z };

package/dist/{jsx-dev-runtime-BCxm528Z.d.ts → jsx-dev-runtime-De053cfK.d.ts}

@@ -266,6 +266,24 @@ type ScenarioCommand = {
     pattern?: string;
 };
 
+type RetainMode = 'static' | 'live';
+
+type ShaderCommand = {
+    subCommand: 'prepare';
+    fromChannel: number;
+    toChannel: number;
+    mode?: RetainMode;
+} | {
+    subCommand: 'perform';
+    duration: number;
+} | {
+    subCommand: 'start';
+} | {
+    subCommand: 'stop';
+} | {
+    subCommand: 'reset';
+};
+
 type ReadFormat = 'text' | 'binary';
 
 type WindowState = 'idle' | 'maximized' | 'minimized' | 'fullscreen';
@@ -325,7 +343,58 @@ type MakeNullOptional<T> = T extends any ? {
     [K in keyof T as null extends T[K] ? K : never]?: T[K];
 } : never;
 
-type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | SystemCommand;
+type ShaderDirection = 'left' | 'right' | 'up' | 'down';
+
+type ShaderParamType = 'float' | 'int';
+
+type ShaderParam = {
+    name: string;
+    type: ShaderParamType;
+    value: number;
+};
+
+type ShaderSource = ({
+    type: 'builtin';
+} & ({
+    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: 'raw';
+    content: string;
+    params?: Array<ShaderParam>;
+};
+
+type ShaderTimeControl = 'auto' | 'manual' | 'transition';
+
+type _Command = AudioCommand | TextCommand | GamepadCommand | ScenarioCommand | ShaderCommand | SystemCommand;
 type Command = MakeNullOptional<_Command>;
 type MaybePromise = any;
 
@@ -564,6 +633,23 @@ type TextProps = {
     shadowWidth?: number;
 };
 
+type ShaderProps = {
+    shader?: ShaderSource;
+    timeControl?: ShaderTimeControl;
+    displayChannel?: number | null;
+};
+
+type ShaderSlotSpace = 'normal' | 'shader';
+
+type ShaderSlotProps = {
+    channel?: number;
+    empty?: boolean;
+    static?: boolean;
+    space?: ShaderSlotSpace;
+    width?: number;
+    height?: number;
+};
+
 type AnimationFormat = 'apng' | 'webp';
 
 type AnimationProps = {
@@ -608,6 +694,10 @@ type MoyuClipAttributes = ClipProps & MoyuNodeAttributes;
 type MoyuFilterAttributes = FilterProps & MoyuNodeAttributes;
 type MoyuBackdropAttributes = BackdropProps & MoyuNodeAttributes;
 type MoyuAnimationAttributes = AnimationProps & MoyuNodeAttributes;
+type MoyuShaderAttributes = ShaderProps & MoyuNodeAttributes & {
+    onFinished?: () => void;
+};
+type MoyuShaderSlotAttributes = ShaderSlotProps & MoyuNodeAttributes;
 type MoyuVideoAttributes = VideoProps & MoyuNodeAttributes & {
     onEnded?: () => void;
     onStateChange?: (state: string) => void;
@@ -643,8 +733,10 @@ declare namespace JSX {
         filter: DetailedMoyuProps<MoyuFilterAttributes>;
         backdrop: DetailedMoyuProps<MoyuBackdropAttributes>;
         animation: DetailedMoyuProps<MoyuAnimationAttributes>;
+        shader: DetailedMoyuProps<MoyuShaderAttributes>;
+        'shader-slot': DetailedMoyuProps<MoyuShaderSlotAttributes>;
         video: DetailedMoyuProps<MoyuVideoAttributes>;
     }
 }
 
-export { type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type GamepadCommand as G, JSX as J, type KeyboardEvent as K, type MouseEvent as M, Node as N, type ScenarioCommand as S, type TextCommand as T, type WindowState as W, type MoyuEvent as a, type MaybePromise as b, type JsonValue as c, type AudioSettings as d, type KeyboardEventKind as e, type MakeNullOptional as f, type MouseEventKind as g, type MoyuAnimationAttributes as h, type MoyuBackdropAttributes as i, type MoyuClipAttributes as j, type MoyuContainerAttributes as k, type MoyuEventHandler as l, type MoyuFilterAttributes as m, type MoyuListenerAttributes as n, type MoyuNodeAttributes as o, type MoyuSpriteAttributes as p, type MoyuTextAttributes as q, type MoyuVideoAttributes as r, type SystemCommand as s, type TouchEvent as t, type TouchEventKind as u, type Tuple2 as v, type Tuple3 as w, type Tuple4 as x, createBubbleEvent as y, getStageSize as z };
+export { type AudioCommand as A, type BubbleEvent as B, type Command as C, type DetailedMoyuProps as D, type EffectParams as E, type SystemCommand as F, type GamepadCommand as G, type TouchEvent as H, type TouchEventKind as I, JSX as J, type KeyboardEvent as K, type Tuple2 as L, type MouseEvent as M, Node as N, type Tuple3 as O, type Tuple4 as P, createBubbleEvent as Q, type RetainMode as R, type ShaderDirection as S, type TextCommand as T, getStageSize as U, type WindowState as W, type MoyuEvent as a, type MaybePromise as b, type JsonValue as c, type AudioSettings as d, type KeyboardEventKind as e, type MakeNullOptional as f, type MouseEventKind as g, type MoyuAnimationAttributes as h, type MoyuBackdropAttributes as i, type MoyuClipAttributes as j, type MoyuContainerAttributes as k, type MoyuEventHandler as l, type MoyuFilterAttributes as m, type MoyuListenerAttributes as n, type MoyuNodeAttributes as o, type MoyuShaderAttributes as p, type MoyuShaderSlotAttributes as q, type MoyuSpriteAttributes as r, type MoyuTextAttributes as s, type MoyuVideoAttributes as t, type ScenarioCommand as u, type ShaderCommand as v, type ShaderParam as w, type ShaderParamType as x, type ShaderSource as y, type ShaderTimeControl 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-BCxm528Z.mjs';
+export { J as JSX } from './jsx-dev-runtime-De053cfK.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-BCxm528Z.js';
+export { J as JSX } from './jsx-dev-runtime-De053cfK.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-BCxm528Z.mjs';
+export { J as JSX } from './jsx-dev-runtime-De053cfK.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-BCxm528Z.js';
+export { J as JSX } from './jsx-dev-runtime-De053cfK.js';
 import 'react/jsx-dev-runtime';
 import 'react';

package/dist/lib.cjs

@@ -40,6 +40,7 @@ __export(lib_exports, {
   animated: () => animated,
   autoState: () => autoState,
   createBubbleEvent: () => createBubbleEvent,
+  createGameStateContext: () => createGameStateContext,
   createRoot: () => createRoot,
   createStackNavigator: () => createStackNavigator,
   createStage: () => createStage,
@@ -751,7 +752,7 @@ var globalVariables = new Proxy(
   }
 );
 function safeEval(code, sandbox) {
-  const proxy5 = new Proxy(sandbox, {
+  const proxy6 = new Proxy(sandbox, {
     has(target, key) {
       if (typeof key === "string" && JS_GLOBAL_KEYS.has(key)) {
         return false;
@@ -759,7 +760,7 @@ function safeEval(code, sandbox) {
       return key in target || key === "LOCAL" || key === "ARCHIVE" || key === "GLOBAL" || key === "window" || key === "globalThis";
     },
     get(target, key) {
-      if (key === "window" || key === "globalThis") return proxy5;
+      if (key === "window" || key === "globalThis") return proxy6;
       if (key === "LOCAL") return localVariables;
       if (key === "ARCHIVE") return archiveVariables;
       if (key === "GLOBAL") return globalVariables;
@@ -771,7 +772,7 @@ function safeEval(code, sandbox) {
       return true;
     }
   });
-  return new Function("sandbox", `with(sandbox) { return (${code}) }`).bind(proxy5)(proxy5);
+  return new Function("sandbox", `with(sandbox) { return (${code}) }`).bind(proxy6)(proxy6);
 }
 globalThis.__moyu_eval_sandbox = (code) => {
   try {
@@ -952,12 +953,85 @@ function getStageSize() {
   return stageSize;
 }
 
-// src/components/navigation.tsx
+// src/gameState.ts
 var import_react2 = require("react");
 var import_valtio = require("valtio");
+function cloneStateValue(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function syncStateValue(target, source) {
+  if (Array.isArray(source)) {
+    if (!Array.isArray(target)) {
+      return cloneStateValue(source);
+    }
+    target.length = source.length;
+    for (let index = 0; index < source.length; index += 1) {
+      target[index] = syncStateValue(target[index], source[index]);
+    }
+    return target;
+  }
+  if (isPlainObject(source)) {
+    if (!isPlainObject(target)) {
+      return cloneStateValue(source);
+    }
+    for (const key of Object.keys(target)) {
+      if (!Object.hasOwn(source, key)) {
+        delete target[key];
+      }
+    }
+    for (const [key, nextValue] of Object.entries(source)) {
+      target[key] = syncStateValue(target[key], nextValue);
+    }
+    return target;
+  }
+  return source;
+}
+function createGameStateContext(defaults) {
+  const defaultState = cloneStateValue(defaults);
+  const gameState = (0, import_valtio.proxy)(cloneStateValue(defaults));
+  function snapshotGameState() {
+    return (0, import_valtio.snapshot)(gameState);
+  }
+  function syncGameState(source) {
+    const target = gameState;
+    for (const key of Object.keys(source)) {
+      target[key] = syncStateValue(target[key], source[key]);
+    }
+  }
+  function resetGameState() {
+    syncGameState(defaultState);
+  }
+  const StoreContext = (0, import_react2.createContext)(gameState);
+  function GameStateProvider({ store, children }) {
+    return (0, import_react2.createElement)(StoreContext.Provider, { value: store }, children);
+  }
+  function useGameStateStore() {
+    return (0, import_react2.useContext)(StoreContext);
+  }
+  function useGameStateSection(key) {
+    const store = useGameStateStore();
+    return (0, import_valtio.useSnapshot)(store)[key];
+  }
+  return {
+    gameState,
+    snapshotGameState,
+    syncGameState,
+    resetGameState,
+    GameStateProvider,
+    useGameStateStore,
+    useGameStateSection
+  };
+}
+
+// src/components/navigation.tsx
+var import_react3 = require("react");
+var import_valtio2 = require("valtio");
 var import_jsx_runtime = require("react/jsx-runtime");
-var PageParamsContext = (0, import_react2.createContext)(void 0);
-var OverlayParamsContext = (0, import_react2.createContext)(void 0);
+var PageParamsContext = (0, import_react3.createContext)(void 0);
+var OverlayParamsContext = (0, import_react3.createContext)(void 0);
 var DEBUG_EMPTY_PAGE = "debug-empty";
 var overlayIdCounter = 0;
 var generateOverlayId = () => {
@@ -998,7 +1072,7 @@ function createStackNavigator(options) {
       normalizedOverlays[key] = normalizeDescriptor(config);
     }
   }
-  const navigationState = (0, import_valtio.proxy)({
+  const navigationState = (0, import_valtio2.proxy)({
     currentPage: options.initialPage,
     pageParams: {},
     overlayStack: [],
@@ -1029,7 +1103,6 @@ function createStackNavigator(options) {
     },
     hasActiveOverlay: (overlay, id) => {
       if (id) {
-        console.log(navigationState.overlayStack.some((o) => o.type === overlay && o.id === id));
         return navigationState.overlayStack.some((o) => o.type === overlay && o.id === id);
       }
       return navigationState.overlayStack.some((o) => o.type === overlay);
@@ -1082,7 +1155,7 @@ function createStackNavigator(options) {
 }
 function createStaticNavigation(navigator) {
   return () => {
-    const navState = (0, import_valtio.useSnapshot)(navigator._state);
+    const navState = (0, import_valtio2.useSnapshot)(navigator._state);
     const { pages, overlays } = navigator._descriptors;
     const pageDescriptor = pages[navState.currentPage];
     const Page = pageDescriptor?.component || (() => null);
@@ -1104,17 +1177,17 @@ function getNavigator() {
 }
 var useNavigation = getNavigator;
 function useNavigationState() {
-  return (0, import_valtio.useSnapshot)(getNavigator()._state);
+  return (0, import_valtio2.useSnapshot)(getNavigator()._state);
 }
 function useNavigationParams() {
-  const overlayParams = (0, import_react2.useContext)(OverlayParamsContext);
-  const pageParams = (0, import_react2.useContext)(PageParamsContext);
+  const overlayParams = (0, import_react3.useContext)(OverlayParamsContext);
+  const pageParams = (0, import_react3.useContext)(PageParamsContext);
   return overlayParams ?? pageParams ?? {};
 }
 
 // src/debug/session.ts
-var import_valtio2 = require("valtio");
-var debugState = (0, import_valtio2.proxy)({
+var import_valtio3 = require("valtio");
+var debugState = (0, import_valtio3.proxy)({
   active: false,
   checkpoints: {},
   currentCursor: null,
@@ -1629,9 +1702,9 @@ async function stopDebugSession() {
   clearLocalRuntimeState();
 }
 function useDebugSession() {
-  const snapshot = (0, import_valtio2.useSnapshot)(debugState);
+  const snapshot2 = (0, import_valtio3.useSnapshot)(debugState);
   return {
-    ...snapshot,
+    ...snapshot2,
     startDebugSession,
     stopDebugSession,
     restoreCheckpoint: debugSessionController.restoreCheckpoint,
@@ -1642,11 +1715,11 @@ function useDebugSession() {
 }
 
 // src/ui.ts
-var import_valtio3 = require("valtio");
+var import_valtio4 = require("valtio");
 var UI_DATA_ASSET_PATH = "assets:///data/ui.json";
 var activeUiSchema = null;
-var uiDataState = (0, import_valtio3.proxy)({});
-var uiRuntimeState = (0, import_valtio3.proxy)({
+var uiDataState = (0, import_valtio4.proxy)({});
+var uiRuntimeState = (0, import_valtio4.proxy)({
   initialized: false,
   error: null
 });
@@ -1707,11 +1780,11 @@ function useUiData(name) {
   if (!uiRuntimeState.initialized) {
     throw new Error("UI data has not been initialized. Call initUiData() before rendering UI pages.");
   }
-  const snapshot = (0, import_valtio3.useSnapshot)(uiDataState);
-  if (!(name in snapshot)) {
+  const snapshot2 = (0, import_valtio4.useSnapshot)(uiDataState);
+  if (!(name in snapshot2)) {
     throw new Error(`UI data "${name}" is not available.`);
   }
-  return snapshot[name];
+  return snapshot2[name];
 }
 
 // src/debug/runtime.ts
@@ -2066,7 +2139,7 @@ function useFadeOut(outTime, pause = false, onFinished) {
 }
 
 // src/hooks/useScenario.ts
-var import_react3 = require("react");
+var import_react4 = require("react");
 var currentScenarioSession = null;
 var scenarioSessionId = 0;
 var scenarioLifecycleQueue = Promise.resolve();
@@ -2208,7 +2281,7 @@ function setWaiting(time, skippable) {
   executePluginCommand("scenario", { subCommand: "setWaiting", time, skippable });
 }
 function useScenario(stories, startName, entryName, goNextOnLoad = false) {
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     const session = acquireScenarioSession({
       stories: normalizeStories(stories),
       startName,
@@ -2222,9 +2295,9 @@ function useScenario(stories, startName, entryName, goNextOnLoad = false) {
 }
 
 // src/hooks/useSoundEffect.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 function useSoundEffect(src) {
-  (0, import_react4.useEffect)(() => {
+  (0, import_react5.useEffect)(() => {
     return () => {
       try {
         if (src) {
@@ -2239,7 +2312,7 @@ function useSoundEffect(src) {
       }
     };
   }, [src]);
-  return (0, import_react4.useCallback)(() => {
+  return (0, import_react5.useCallback)(() => {
     try {
       if (src) {
         executePluginCommand("audio", {
@@ -2255,26 +2328,26 @@ function useSoundEffect(src) {
 }
 
 // src/hooks/useStage.ts
-var import_react5 = require("react");
-var import_valtio4 = require("valtio");
+var import_react6 = require("react");
+var import_valtio5 = require("valtio");
 var SKIP_INTERVAL_MS = 80;
 var DEFAULT_FAST_FORWARD_STEP_LIMIT = 1e4;
 var DEFAULT_FAST_FORWARD_TIME_LIMIT_MS = 3e3;
 var autoRuntime = {
   defaultTailMs: 0
 };
-var skipState = (0, import_valtio4.proxy)({ active: false });
-var autoState = (0, import_valtio4.proxy)({ active: false });
-var fastForwardState = (0, import_valtio4.proxy)({ active: false });
-var warpState = (0, import_valtio4.proxy)({ active: false });
+var skipState = (0, import_valtio5.proxy)({ active: false });
+var autoState = (0, import_valtio5.proxy)({ active: false });
+var fastForwardState = (0, import_valtio5.proxy)({ active: false });
+var warpState = (0, import_valtio5.proxy)({ active: false });
 function useIsSkipping() {
-  return (0, import_valtio4.useSnapshot)(skipState).active;
+  return (0, import_valtio5.useSnapshot)(skipState).active;
 }
 function useIsAutoing() {
-  return (0, import_valtio4.useSnapshot)(autoState).active;
+  return (0, import_valtio5.useSnapshot)(autoState).active;
 }
 function useIsSeeking() {
-  return (0, import_valtio4.useSnapshot)(fastForwardState).active;
+  return (0, import_valtio5.useSnapshot)(fastForwardState).active;
 }
 function getSeekingType() {
   if (warpState.active) return "warp";
@@ -2925,45 +2998,45 @@ function createStage() {
     bindEvents
   };
 }
-var StageContext = (0, import_react5.createContext)(null);
+var StageContext = (0, import_react6.createContext)(null);
 function useStageContext() {
-  const ctx = (0, import_react5.useContext)(StageContext);
+  const ctx = (0, import_react6.useContext)(StageContext);
   if (!ctx) throw new Error("useStageContext must be used within StageContextProvider");
   return ctx;
 }
 function StageContextProvider({ stage, children }) {
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.bindEvents();
   }, [stage]);
-  return (0, import_react5.createElement)(StageContext.Provider, { value: stage }, children);
+  return (0, import_react6.createElement)(StageContext.Provider, { value: stage }, children);
 }
 function useSkipCallback(callback) {
   const stage = useStageContext();
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.addSkipCallback(callback);
   }, [stage, callback]);
 }
 function useInterruptCallback(callback) {
   const stage = useStageContext();
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.addInterruptCallback(callback);
   }, [stage, callback]);
 }
 function useSkipBlocker(callback) {
   const stage = useStageContext();
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.addSkipBlocker(callback);
   }, [stage, callback]);
 }
 function useAutoBlocker(callback) {
   const stage = useStageContext();
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.addAutoBlocker(callback);
   }, [stage, callback]);
 }
 function useAutoTicket() {
   const stage = useStageContext();
-  return (0, import_react5.useCallback)(
+  return (0, import_react6.useCallback)(
     (options) => {
       return stage.issueAutoTicket(options);
     },
@@ -2972,7 +3045,7 @@ function useAutoTicket() {
 }
 function useBeforeHandleCommandCallback(callback) {
   const stage = useStageContext();
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     return stage.addBeforeHandleCommandCallback(callback);
   }, [stage, callback]);
 }

package/dist/lib.d.mts

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ComponentType } from 'react';
-import { M as MouseEvent, a as MoyuEvent, C as Command, b as MaybePromise, J as JSX, c as JsonValue } from './jsx-dev-runtime-BCxm528Z.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 MoyuSpriteAttributes, q as MoyuTextAttributes, r as MoyuVideoAttributes, N as Node, S as ScenarioCommand, s as SystemCommand, T as TextCommand, t as TouchEvent, u as TouchEventKind, v as Tuple2, w as Tuple3, x as Tuple4, W as WindowState, y as createBubbleEvent, z as getStageSize } from './jsx-dev-runtime-BCxm528Z.mjs';
+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 { FluidValue } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
@@ -32,6 +32,41 @@ 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[];
 
@@ -211,6 +246,8 @@ type ResolvedSystemCallLine = {
     arguments: Array<ResolvedArgument>;
 };
 
+type ShaderEvent = null;
+
 type TextLine = {
     leading: string | null;
     text: string | null;
@@ -285,6 +322,21 @@ type AnimatedLeaf<T> = Exclude<T, object | undefined> | Extract<T, ReadonlyArray
 
 declare const animated: WithAnimated;
 
+type GameStateStore<TState extends object> = TState;
+interface GameStateSourceProps<TState extends object> {
+    store: GameStateStore<TState>;
+    children: ReactNode;
+}
+declare function createGameStateContext<TState extends object>(defaults: TState): {
+    gameState: TState;
+    snapshotGameState: () => TState;
+    syncGameState: (source: TState) => void;
+    resetGameState: () => void;
+    GameStateProvider: ({ store, children }: GameStateSourceProps<TState>) => react.FunctionComponentElement<react.ProviderProps<TState>>;
+    useGameStateStore: () => GameStateStore<TState>;
+    useGameStateSection: <K extends keyof TState>(key: K) => TState[K];
+};
+
 declare global {
     /**
      * The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox).
@@ -860,4 +912,4 @@ declare module 'zod' {
     }
 }
 
-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 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 StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, type WheelEvent, type WheelEventDeltaMode, type WithAnimated, animated as a, addEventListener, animated, autoState, 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, 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 };

package/dist/lib.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
-import { ReactElement, Component, ForwardRefExoticComponent, CSSProperties, FC, ComponentType } from 'react';
-import { M as MouseEvent, a as MoyuEvent, C as Command, b as MaybePromise, J as JSX, c as JsonValue } from './jsx-dev-runtime-BCxm528Z.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 MoyuSpriteAttributes, q as MoyuTextAttributes, r as MoyuVideoAttributes, N as Node, S as ScenarioCommand, s as SystemCommand, T as TextCommand, t as TouchEvent, u as TouchEventKind, v as Tuple2, w as Tuple3, x as Tuple4, W as WindowState, y as createBubbleEvent, z as getStageSize } from './jsx-dev-runtime-BCxm528Z.js';
+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 { FluidValue } from '@react-spring/shared';
 import { ElementType, AssignableKeys, ComponentPropsWithRef } from '@react-spring/types';
 import { Snapshot } from 'valtio';
@@ -32,6 +32,41 @@ 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[];
 
@@ -211,6 +246,8 @@ type ResolvedSystemCallLine = {
     arguments: Array<ResolvedArgument>;
 };
 
+type ShaderEvent = null;
+
 type TextLine = {
     leading: string | null;
     text: string | null;
@@ -285,6 +322,21 @@ type AnimatedLeaf<T> = Exclude<T, object | undefined> | Extract<T, ReadonlyArray
 
 declare const animated: WithAnimated;
 
+type GameStateStore<TState extends object> = TState;
+interface GameStateSourceProps<TState extends object> {
+    store: GameStateStore<TState>;
+    children: ReactNode;
+}
+declare function createGameStateContext<TState extends object>(defaults: TState): {
+    gameState: TState;
+    snapshotGameState: () => TState;
+    syncGameState: (source: TState) => void;
+    resetGameState: () => void;
+    GameStateProvider: ({ store, children }: GameStateSourceProps<TState>) => react.FunctionComponentElement<react.ProviderProps<TState>>;
+    useGameStateStore: () => GameStateStore<TState>;
+    useGameStateSection: <K extends keyof TState>(key: K) => TState[K];
+};
+
 declare global {
     /**
      * The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox).
@@ -860,4 +912,4 @@ declare module 'zod' {
     }
 }
 
-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 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 StackNavigatorOptions, StageContextProvider, type StageInstance, type TextLine, type TextLineHandler, type WheelEvent, type WheelEventDeltaMode, type WithAnimated, animated as a, addEventListener, animated, autoState, 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, 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 };

package/dist/lib.mjs

@@ -28,6 +28,7 @@ __export(lib_exports, {
   animated: () => animated,
   autoState: () => autoState,
   createBubbleEvent: () => createBubbleEvent,
+  createGameStateContext: () => createGameStateContext,
   createRoot: () => createRoot,
   createStackNavigator: () => createStackNavigator,
   createStage: () => createStage,
@@ -738,7 +739,7 @@ var globalVariables = new Proxy(
   }
 );
 function safeEval(code, sandbox) {
-  const proxy5 = new Proxy(sandbox, {
+  const proxy6 = new Proxy(sandbox, {
     has(target, key) {
       if (typeof key === "string" && JS_GLOBAL_KEYS.has(key)) {
         return false;
@@ -746,7 +747,7 @@ function safeEval(code, sandbox) {
       return key in target || key === "LOCAL" || key === "ARCHIVE" || key === "GLOBAL" || key === "window" || key === "globalThis";
     },
     get(target, key) {
-      if (key === "window" || key === "globalThis") return proxy5;
+      if (key === "window" || key === "globalThis") return proxy6;
       if (key === "LOCAL") return localVariables;
       if (key === "ARCHIVE") return archiveVariables;
       if (key === "GLOBAL") return globalVariables;
@@ -758,7 +759,7 @@ function safeEval(code, sandbox) {
       return true;
     }
   });
-  return new Function("sandbox", `with(sandbox) { return (${code}) }`).bind(proxy5)(proxy5);
+  return new Function("sandbox", `with(sandbox) { return (${code}) }`).bind(proxy6)(proxy6);
 }
 globalThis.__moyu_eval_sandbox = (code) => {
   try {
@@ -940,12 +941,85 @@ function getStageSize() {
   return stageSize;
 }
 
+// src/gameState.ts
+import { createContext, createElement, useContext } from "react";
+import { proxy, snapshot, useSnapshot } from "valtio";
+function cloneStateValue(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function syncStateValue(target, source) {
+  if (Array.isArray(source)) {
+    if (!Array.isArray(target)) {
+      return cloneStateValue(source);
+    }
+    target.length = source.length;
+    for (let index = 0; index < source.length; index += 1) {
+      target[index] = syncStateValue(target[index], source[index]);
+    }
+    return target;
+  }
+  if (isPlainObject(source)) {
+    if (!isPlainObject(target)) {
+      return cloneStateValue(source);
+    }
+    for (const key of Object.keys(target)) {
+      if (!Object.hasOwn(source, key)) {
+        delete target[key];
+      }
+    }
+    for (const [key, nextValue] of Object.entries(source)) {
+      target[key] = syncStateValue(target[key], nextValue);
+    }
+    return target;
+  }
+  return source;
+}
+function createGameStateContext(defaults) {
+  const defaultState = cloneStateValue(defaults);
+  const gameState = proxy(cloneStateValue(defaults));
+  function snapshotGameState() {
+    return snapshot(gameState);
+  }
+  function syncGameState(source) {
+    const target = gameState;
+    for (const key of Object.keys(source)) {
+      target[key] = syncStateValue(target[key], source[key]);
+    }
+  }
+  function resetGameState() {
+    syncGameState(defaultState);
+  }
+  const StoreContext = createContext(gameState);
+  function GameStateProvider({ store, children }) {
+    return createElement(StoreContext.Provider, { value: store }, children);
+  }
+  function useGameStateStore() {
+    return useContext(StoreContext);
+  }
+  function useGameStateSection(key) {
+    const store = useGameStateStore();
+    return useSnapshot(store)[key];
+  }
+  return {
+    gameState,
+    snapshotGameState,
+    syncGameState,
+    resetGameState,
+    GameStateProvider,
+    useGameStateStore,
+    useGameStateSection
+  };
+}
+
 // src/components/navigation.tsx
-import { createContext, useContext } from "react";
-import { proxy, useSnapshot } from "valtio";
+import { createContext as createContext2, useContext as useContext2 } from "react";
+import { proxy as proxy2, useSnapshot as useSnapshot2 } from "valtio";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-var PageParamsContext = createContext(void 0);
-var OverlayParamsContext = createContext(void 0);
+var PageParamsContext = createContext2(void 0);
+var OverlayParamsContext = createContext2(void 0);
 var DEBUG_EMPTY_PAGE = "debug-empty";
 var overlayIdCounter = 0;
 var generateOverlayId = () => {
@@ -986,7 +1060,7 @@ function createStackNavigator(options) {
       normalizedOverlays[key] = normalizeDescriptor(config);
     }
   }
-  const navigationState = proxy({
+  const navigationState = proxy2({
     currentPage: options.initialPage,
     pageParams: {},
     overlayStack: [],
@@ -1017,7 +1091,6 @@ function createStackNavigator(options) {
     },
     hasActiveOverlay: (overlay, id) => {
       if (id) {
-        console.log(navigationState.overlayStack.some((o) => o.type === overlay && o.id === id));
         return navigationState.overlayStack.some((o) => o.type === overlay && o.id === id);
       }
       return navigationState.overlayStack.some((o) => o.type === overlay);
@@ -1070,7 +1143,7 @@ function createStackNavigator(options) {
 }
 function createStaticNavigation(navigator) {
   return () => {
-    const navState = useSnapshot(navigator._state);
+    const navState = useSnapshot2(navigator._state);
     const { pages, overlays } = navigator._descriptors;
     const pageDescriptor = pages[navState.currentPage];
     const Page = pageDescriptor?.component || (() => null);
@@ -1092,17 +1165,17 @@ function getNavigator() {
 }
 var useNavigation = getNavigator;
 function useNavigationState() {
-  return useSnapshot(getNavigator()._state);
+  return useSnapshot2(getNavigator()._state);
 }
 function useNavigationParams() {
-  const overlayParams = useContext(OverlayParamsContext);
-  const pageParams = useContext(PageParamsContext);
+  const overlayParams = useContext2(OverlayParamsContext);
+  const pageParams = useContext2(PageParamsContext);
   return overlayParams ?? pageParams ?? {};
 }
 
 // src/debug/session.ts
-import { useSnapshot as useSnapshot2, proxy as proxy2 } from "valtio";
-var debugState = proxy2({
+import { useSnapshot as useSnapshot3, proxy as proxy3 } from "valtio";
+var debugState = proxy3({
   active: false,
   checkpoints: {},
   currentCursor: null,
@@ -1617,9 +1690,9 @@ async function stopDebugSession() {
   clearLocalRuntimeState();
 }
 function useDebugSession() {
-  const snapshot = useSnapshot2(debugState);
+  const snapshot2 = useSnapshot3(debugState);
   return {
-    ...snapshot,
+    ...snapshot2,
     startDebugSession,
     stopDebugSession,
     restoreCheckpoint: debugSessionController.restoreCheckpoint,
@@ -1630,11 +1703,11 @@ function useDebugSession() {
 }
 
 // src/ui.ts
-import { proxy as proxy3, useSnapshot as useSnapshot3 } from "valtio";
+import { proxy as proxy4, useSnapshot as useSnapshot4 } from "valtio";
 var UI_DATA_ASSET_PATH = "assets:///data/ui.json";
 var activeUiSchema = null;
-var uiDataState = proxy3({});
-var uiRuntimeState = proxy3({
+var uiDataState = proxy4({});
+var uiRuntimeState = proxy4({
   initialized: false,
   error: null
 });
@@ -1695,11 +1768,11 @@ function useUiData(name) {
   if (!uiRuntimeState.initialized) {
     throw new Error("UI data has not been initialized. Call initUiData() before rendering UI pages.");
   }
-  const snapshot = useSnapshot3(uiDataState);
-  if (!(name in snapshot)) {
+  const snapshot2 = useSnapshot4(uiDataState);
+  if (!(name in snapshot2)) {
     throw new Error(`UI data "${name}" is not available.`);
   }
-  return snapshot[name];
+  return snapshot2[name];
 }
 
 // src/debug/runtime.ts
@@ -2243,26 +2316,26 @@ function useSoundEffect(src) {
 }
 
 // src/hooks/useStage.ts
-import { createContext as createContext2, useContext as useContext2, useEffect as useEffect3, createElement, useCallback as useCallback2 } from "react";
-import { proxy as proxy4, useSnapshot as useSnapshot4 } from "valtio";
+import { createContext as createContext3, useContext as useContext3, useEffect as useEffect3, createElement as createElement2, useCallback as useCallback2 } from "react";
+import { proxy as proxy5, useSnapshot as useSnapshot5 } from "valtio";
 var SKIP_INTERVAL_MS = 80;
 var DEFAULT_FAST_FORWARD_STEP_LIMIT = 1e4;
 var DEFAULT_FAST_FORWARD_TIME_LIMIT_MS = 3e3;
 var autoRuntime = {
   defaultTailMs: 0
 };
-var skipState = proxy4({ active: false });
-var autoState = proxy4({ active: false });
-var fastForwardState = proxy4({ active: false });
-var warpState = proxy4({ active: false });
+var skipState = proxy5({ active: false });
+var autoState = proxy5({ active: false });
+var fastForwardState = proxy5({ active: false });
+var warpState = proxy5({ active: false });
 function useIsSkipping() {
-  return useSnapshot4(skipState).active;
+  return useSnapshot5(skipState).active;
 }
 function useIsAutoing() {
-  return useSnapshot4(autoState).active;
+  return useSnapshot5(autoState).active;
 }
 function useIsSeeking() {
-  return useSnapshot4(fastForwardState).active;
+  return useSnapshot5(fastForwardState).active;
 }
 function getSeekingType() {
   if (warpState.active) return "warp";
@@ -2913,9 +2986,9 @@ function createStage() {
     bindEvents
   };
 }
-var StageContext = createContext2(null);
+var StageContext = createContext3(null);
 function useStageContext() {
-  const ctx = useContext2(StageContext);
+  const ctx = useContext3(StageContext);
   if (!ctx) throw new Error("useStageContext must be used within StageContextProvider");
   return ctx;
 }
@@ -2923,7 +2996,7 @@ function StageContextProvider({ stage, children }) {
   useEffect3(() => {
     return stage.bindEvents();
   }, [stage]);
-  return createElement(StageContext.Provider, { value: stage }, children);
+  return createElement2(StageContext.Provider, { value: stage }, children);
 }
 function useSkipCallback(callback) {
   const stage = useStageContext();
@@ -2977,6 +3050,7 @@ export {
   animated,
   autoState,
   createBubbleEvent,
+  createGameStateContext,
   createRoot,
   createStackNavigator,
   createStage,

package/package.json

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