@momoyu-ink/kit 0.4.2 → 0.5.1

package/dist/events.js

@@ -1,49 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./events/base"), exports);
-__exportStar(require("./events/globals"), exports);
-__exportStar(require("./events/keyboard"), exports);
-__exportStar(require("./events/listener"), exports);
-__exportStar(require("./events/mouse"), exports);
-__exportStar(require("./events/touch"), exports);
-__exportStar(require("./events/wheel"), exports);
-__exportStar(require("./bindings/AnimationFrameCallbackEvent"), exports);
-__exportStar(require("./bindings/BeforeUnloadEvent"), exports);
-__exportStar(require("./bindings/CustomEvent"), exports);
-__exportStar(require("./bindings/FocusEvent"), exports);
-__exportStar(require("./bindings/FocusEventKind"), exports);
-__exportStar(require("./bindings/FullScreenEvent"), exports);
-__exportStar(require("./bindings/FullscreenEventKind"), exports);
-__exportStar(require("./bindings/GameEvent"), exports);
-__exportStar(require("./bindings/Gamepad"), exports);
-__exportStar(require("./bindings/GamepadButton"), exports);
-__exportStar(require("./bindings/GamepadEvent"), exports);
-__exportStar(require("./bindings/GamepadHapticActuator"), exports);
-__exportStar(require("./bindings/KeyboardEventKind"), exports);
-__exportStar(require("./bindings/KeyboardLocation"), exports);
-__exportStar(require("./bindings/Literal"), exports);
-__exportStar(require("./bindings/MouseEventKind"), exports);
-__exportStar(require("./bindings/NodeEvent"), exports);
-__exportStar(require("./bindings/ResizeEvent"), exports);
-__exportStar(require("./bindings/ResolvedArgument"), exports);
-__exportStar(require("./bindings/ResolvedCommandLine"), exports);
-__exportStar(require("./bindings/ResolvedSystemCallLine"), exports);
-__exportStar(require("./bindings/TextLine"), exports);
-__exportStar(require("./bindings/ScenarioEvent"), exports);
-__exportStar(require("./bindings/TextEvent"), exports);
-__exportStar(require("./bindings/TouchEventKind"), exports);
-__exportStar(require("./bindings/WheelEventDeltaMode"), exports);

package/dist/hooks/useFadeInOut.d.ts

@@ -1,16 +0,0 @@
-import { type SpringRef, type SpringValues } from '../spring';
-export declare function useFadeInOut(inTime: number, _keepTime: number, _outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
-    opacity: number;
-}>, SpringRef<{
-    opacity: number;
-}>, () => void];
-export declare function useFadeIn(inTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
-    opacity: number;
-}>, SpringRef<{
-    opacity: number;
-}>, () => void];
-export declare function useFadeOut(outTime: number, pause?: boolean, onFinished?: () => void): [SpringValues<{
-    opacity: number;
-}>, SpringRef<{
-    opacity: number;
-}>, () => void];

package/dist/hooks/useFadeInOut.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useFadeInOut = useFadeInOut;
-exports.useFadeIn = useFadeIn;
-exports.useFadeOut = useFadeOut;
-const spring_1 = require("../spring");
-function useFadeInOut(inTime, _keepTime, _outTime, pause = false, onFinished) {
-    const [style, api] = (0, spring_1.useSpring)(() => ({
-        from: { opacity: 0 },
-        to: { opacity: 1 },
-        config: { duration: inTime },
-        pause,
-        onRest: (result) => {
-            if (result.value.opacity === 1) {
-                void api.start({ reverse: true, delay: 1500, config: { duration: 1000 } });
-            }
-            else {
-                onFinished?.();
-            }
-        },
-    }), []);
-    const skip = () => {
-        api.stop();
-        api.set({ opacity: 0 });
-        onFinished?.();
-    };
-    return [style, api, skip];
-}
-function useFadeIn(inTime, pause = false, onFinished) {
-    const [style, api] = (0, spring_1.useSpring)(() => ({
-        from: { opacity: 0 },
-        to: { opacity: 1 },
-        config: { duration: inTime },
-        pause,
-        onRest: () => {
-            onFinished?.();
-        },
-    }), []);
-    const skip = () => {
-        api.stop();
-        api.set({ opacity: 1 });
-        onFinished?.();
-    };
-    return [style, api, skip];
-}
-function useFadeOut(outTime, pause = false, onFinished) {
-    const [style, api] = (0, spring_1.useSpring)(() => ({
-        from: { opacity: 1 },
-        to: { opacity: 0 },
-        config: { duration: outTime },
-        pause,
-        onRest: () => {
-            onFinished?.();
-        },
-    }), []);
-    const skip = () => {
-        api.stop();
-        api.set({ opacity: 1 });
-        onFinished?.();
-    };
-    return [style, api, skip];
-}

package/dist/hooks/useScenario.d.ts

@@ -1,13 +0,0 @@
-/** Advance to the next line in the current story. */
-export declare function nextLine(): any;
-/** Set a timed wait, optionally skippable. */
-export declare function setWaiting(time: number, skippable: boolean): void;
-/**
- * Custom hook to manage scenario lifecycle (load, start, terminate).
- *
- * @param {string[]} stories - An array of story names to load.
- * @param {string} [startName] - The name of the story to start.
- * @param {string} [entryName] - The entry point within the story to start from.
- * @param {boolean} [goNextOnLoad=false] - Whether to automatically advance to the next line after loading.
- */
-export declare function useScenario(stories: string[], startName?: string, entryName?: string, goNextOnLoad?: boolean): void;

package/dist/hooks/useScenario.js

@@ -1,64 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nextLine = nextLine;
-exports.setWaiting = setWaiting;
-exports.useScenario = useScenario;
-const moyu_1 = require("../moyu");
-const react_1 = require("react");
-/** Advance to the next line in the current story. */
-function nextLine() {
-    return (0, moyu_1.executePluginCommand)('scenario', { subCommand: 'nextLine' });
-}
-/** Set a timed wait, optionally skippable. */
-function setWaiting(time, skippable) {
-    (0, moyu_1.executePluginCommand)('scenario', { subCommand: 'setWaiting', time, skippable });
-}
-/**
- * Custom hook to manage scenario lifecycle (load, start, terminate).
- *
- * @param {string[]} stories - An array of story names to load.
- * @param {string} [startName] - The name of the story to start.
- * @param {string} [entryName] - The entry point within the story to start from.
- * @param {boolean} [goNextOnLoad=false] - Whether to automatically advance to the next line after loading.
- */
-function useScenario(stories, startName, entryName, goNextOnLoad = false) {
-    (0, react_1.useEffect)(() => {
-        const loadScenario = async () => {
-            for (const story of stories) {
-                if (!story)
-                    continue;
-                try {
-                    await (0, moyu_1.executePluginCommand)('scenario', {
-                        subCommand: 'addStory',
-                        name: story,
-                    });
-                }
-                catch (error) {
-                    console.error(`Failed to load scenario:`, error);
-                }
-            }
-        };
-        void loadScenario().then(async () => {
-            try {
-                if (startName) {
-                    await (0, moyu_1.executePluginCommand)('scenario', {
-                        subCommand: 'startStory',
-                        name: startName,
-                        entry: entryName,
-                    });
-                }
-                if (goNextOnLoad) {
-                    await nextLine();
-                }
-            }
-            catch (error) {
-                console.error(`Failed to start scenario ${startName}:`, error);
-            }
-        });
-        return () => {
-            (0, moyu_1.executePluginCommand)('scenario', {
-                subCommand: 'terminateStory',
-            });
-        };
-    }, [stories, startName, entryName, goNextOnLoad]);
-}

package/dist/hooks/useSoundEffect.d.ts

@@ -1,4 +0,0 @@
-/**
- * Used to load a sound effect and provide a function to play it.
- */
-export declare function useSoundEffect(src: string): () => void;

package/dist/hooks/useSoundEffect.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSoundEffect = useSoundEffect;
-const moyu_1 = require("../moyu");
-const react_1 = require("react");
-// avoid loading or releasing the same sound effect multiple times
-const LOADED_SOUNDS = new Set();
-/**
- * Used to load a sound effect and provide a function to play it.
- */
-function useSoundEffect(src) {
-    (0, react_1.useEffect)(() => {
-        // Load the sound effect when the component mounts
-        const loadSound = async () => {
-            try {
-                await (0, moyu_1.executePluginCommand)('audio', {
-                    subCommand: 'load',
-                    name: src,
-                    src,
-                });
-            }
-            catch (error) {
-                console.error(`Failed to load sound effect ${src}:`, error);
-            }
-            LOADED_SOUNDS.add(src);
-        };
-        let needRelease = false;
-        if (!LOADED_SOUNDS.has(src)) {
-            void loadSound();
-            needRelease = true;
-        }
-        // Cleanup function to unload the sound effect when the component unmounts
-        return () => {
-            const releaseSound = () => {
-                try {
-                    (0, moyu_1.executePluginCommand)('audio', {
-                        subCommand: 'release',
-                        name: src,
-                    });
-                }
-                catch (error) {
-                    console.error(`Failed to release sound effect ${src}:`, error);
-                }
-                LOADED_SOUNDS.delete(src);
-            };
-            if (needRelease) {
-                releaseSound();
-            }
-        };
-    }, [src]);
-    // Function to play the sound effect
-    return (0, react_1.useCallback)(() => {
-        try {
-            (0, moyu_1.executePluginCommand)('audio', {
-                subCommand: 'play',
-                name: src,
-            });
-        }
-        catch (error) {
-            console.error(`Failed to play sound effect ${src}:`, error);
-        }
-    }, [src]);
-}

package/dist/hooks/useStage.d.ts

@@ -1,126 +0,0 @@
-import { ZodType } from 'zod';
-import { ResolvedCommandLine, TextLine } from '../events';
-/** Flow control interface passed to every handler. */
-export interface GameControl {
-    /** Timed wait — blocks auto-advance. Engine fires scenariowaitingcancelled on timeout or skip. */
-    setWaiting(time: number, skippable: boolean): void;
-    /** Indefinite hold — blocks auto-advance until user action. */
-    hold(): void;
-    /** Manually advance (rarely needed, e.g. `!` tailing). */
-    nextLine(): void;
-    /** Mark this dispatch cycle as unskippable. If skipping, hold() will stop skip instead of advancing. */
-    unskippable(): void;
-    /** Record the current runtime snapshot for backlog usage. */
-    record(meta: Record<string, any>): string;
-}
-export interface ScenarioCommandBaseType {
-    command: string;
-    [key: string]: unknown;
-}
-/** Command handler function. */
-export type CommandHandler<T extends ScenarioCommandBaseType = ScenarioCommandBaseType> = (cmd: T, control: GameControl) => void;
-/** Text line handler function. */
-export type TextLineHandler = (text: TextLine, control: GameControl) => void;
-export interface AutoTicketOptions {
-    label?: string;
-    tailMs?: number;
-}
-export interface AutoTicketHandle {
-    done(): void;
-    cancel(): void;
-}
-/** Reactive skip state. Actors read via useIsSkipping(). */
-export declare const skipState: {
-    active: boolean;
-};
-/** Reactive auto state. Actors read via useIsAutoing(). */
-export declare const autoState: {
-    active: boolean;
-};
-/** Reactively returns whether skip (Ctrl fast-forward) is active. */
-export declare function useIsSkipping(): boolean;
-/** Reactively returns whether auto mode is active. */
-export declare function useIsAutoing(): boolean;
-/** Set the default tail delay in milliseconds for newly created auto tickets. */
-export declare function setDefaultAutoTailMs(ms: number): void;
-export declare function createStage(): {
-    registerCommandSchema: <T extends ZodType>(schema: T) => () => void;
-    registerCommand: <T extends ScenarioCommandBaseType>(commands: string | string[], handler: CommandHandler<T>) => () => void;
-    registerTextLine: (handler: TextLineHandler) => () => void;
-    addSkipCallback: (cb: () => void) => () => void;
-    addInterruptCallback: (cb: () => boolean) => () => void;
-    addSkipBlocker: (cb: () => boolean) => () => void;
-    addAutoBlocker: (cb: () => boolean) => () => void;
-    addBeforeHandleCommandCallback: (cb: (upcomingCommand: ResolvedCommandLine) => void) => () => void;
-    issueAutoTicket: (options?: AutoTicketOptions) => AutoTicketHandle | null;
-    tryInterrupt: () => boolean;
-    startSkip: () => void;
-    stopSkip: () => void;
-    isSkipping: () => boolean;
-    startAuto: () => void;
-    stopAuto: () => void;
-    isAutoing: () => boolean;
-    bindEvents: () => () => void;
-};
-export type StageInstance = ReturnType<typeof createStage>;
-/** Access the stage instance from within StageContextProvider. */
-export declare function useStageContext(): StageInstance;
-export declare function StageContextProvider({ stage, children }: {
-    stage: StageInstance;
-    children: React.ReactNode;
-}): import("react").FunctionComponentElement<import("react").ProviderProps<{
-    registerCommandSchema: <T extends ZodType>(schema: T) => () => void;
-    registerCommand: <T extends ScenarioCommandBaseType>(commands: string | string[], handler: CommandHandler<T>) => () => void;
-    registerTextLine: (handler: TextLineHandler) => () => void;
-    addSkipCallback: (cb: () => void) => () => void;
-    addInterruptCallback: (cb: () => boolean) => () => void;
-    addSkipBlocker: (cb: () => boolean) => () => void;
-    addAutoBlocker: (cb: () => boolean) => () => void;
-    addBeforeHandleCommandCallback: (cb: (upcomingCommand: ResolvedCommandLine) => void) => () => void;
-    issueAutoTicket: (options?: AutoTicketOptions) => AutoTicketHandle | null;
-    tryInterrupt: () => boolean;
-    startSkip: () => void;
-    stopSkip: () => void;
-    isSkipping: () => boolean;
-    startAuto: () => void;
-    stopAuto: () => void;
-    isAutoing: () => boolean;
-    bindEvents: () => () => void;
-} | null>>;
-/**
- * Register a skip callback that fires when scenariowaitingcancelled is received.
- * Automatically removed on unmount.
- */
-export declare function useSkipCallback(callback: () => void): void;
-/**
- * Register an interrupt callback for user click handling.
- * Return `true` from the callback to consume the click.
- * Automatically removed on unmount.
- */
-export declare function useInterruptCallback(callback: () => boolean): void;
-/**
- * Register a skip blocker callback. Return `true` to block skipping.
- * When any blocker is active, skip mode cannot start or will be stopped.
- * Automatically removed on unmount.
- *
- * NOTE: `callback` must be a stable reference (wrap with `useCallback`).
- */
-export declare function useSkipBlocker(callback: () => boolean): void;
-/**
- * Register an auto blocker callback. Return `true` to block auto mode.
- * Automatically removed on unmount.
- *
- * NOTE: `callback` must be a stable reference (wrap with `useCallback`).
- */
-export declare function useAutoBlocker(callback: () => boolean): void;
-/**
- * Get a function that issues an auto ticket for the current active barrier.
- * Returns `null` when auto is inactive or the collection window has closed.
- */
-export declare function useAutoTicket(): (options?: AutoTicketOptions) => AutoTicketHandle | null;
-/**
- * Register a callback to be invoked before handling each command.
- * The callback receives the upcoming command object, allowing conditional logic.
- * Automatically removed on unmount.
- */
-export declare function useBeforeHandleCommandCallback(callback: (upcomingCommand: ResolvedCommandLine) => void): void;