@momoyu-ink/kit 0.1.0

package/dist/components/navigation.d.ts

@@ -0,0 +1,154 @@
+import React from 'react';
+/**
+ * Context for page parameters
+ * Used to provide params to page components via React tree
+ */
+export declare const PageParamsContext: React.Context<Record<string, any> | undefined>;
+/**
+ * Context for overlay parameters
+ * Used to provide params to overlay components via React tree
+ */
+export declare const OverlayParamsContext: React.Context<Record<string, any> | undefined>;
+/**
+ * Placeholder for global navigation types.
+ * Projects can augment this interface to provide type safety for the global navigator.
+ * @example
+ * declare module './utils/navigation' {
+ *   interface RootNavigatorList {
+ *     pages: typeof myPages;
+ *     overlays: typeof myOverlays;
+ *   }
+ * }
+ */
+export interface RootNavigatorList {
+}
+/**
+ * Type helper to register a navigator instance's types globally.
+ * Use this in a declare module block to get automatic type safety.
+ */
+export type RegisterNavigator<T extends Navigator<any, any>> = {
+    pages: T extends Navigator<infer P, any> ? Record<P, any> : never;
+    overlays: T extends Navigator<any, infer O> ? Record<O, any> : never;
+};
+type GetPages<T> = T extends {
+    pages: infer P;
+} ? (P extends Record<string, any> ? keyof P & string : string) : string;
+type GetOverlays<T> = T extends {
+    overlays: infer O;
+} ? O extends Record<string, any> ? keyof O & string : string : string;
+export type DefaultPageName = GetPages<RootNavigatorList>;
+export type DefaultOverlayName = GetOverlays<RootNavigatorList>;
+export interface PageDescriptor {
+    component: React.ComponentType<any>;
+    options?: Record<string, any>;
+    requiredParams?: string[];
+}
+export interface OverlayDescriptor {
+    component: React.ComponentType<any>;
+    options?: Record<string, any>;
+    requiredParams?: string[];
+}
+export type PageConfig = PageDescriptor['component'] | PageDescriptor;
+export type OverlayConfig = OverlayDescriptor['component'] | OverlayDescriptor;
+export interface StackNavigatorOptions<Pages extends Record<string, PageConfig>, Overlays extends Record<string, OverlayConfig>> {
+    initialPage: keyof Pages & string;
+    pages: Pages;
+    overlays?: Overlays;
+}
+export interface Navigator<PageName extends string = DefaultPageName, OverlayName extends string = DefaultOverlayName> {
+    /**
+     * Navigate to a page
+     * @param page Page name
+     * @param params Parameters to pass to the page (optional)
+     */
+    navigate: (page: PageName, params?: Record<string, any>) => void;
+    /**
+     * Go back to the previous page (not implemented yet)
+     */
+    goBack: () => void;
+    /**
+     * Push an overlay to the overlay stack
+     * @param overlay Overlay name
+     * @param params Parameters to pass to the overlay (optional)
+     */
+    pushOverlay: (overlay: OverlayName, params?: Record<string, any>) => void;
+    /**
+     * Pop the top overlay from the stack
+     */
+    popOverlay: () => void;
+    /**
+     * Clear all overlays
+     */
+    clearOverlays: () => void;
+    /**
+     * Get current page name
+     */
+    getCurrentPage: () => PageName;
+    /**
+     * Get current page parameters
+     */
+    getParams: () => Record<string, any> | undefined;
+    /**
+     * Get overlay stack
+     */
+    getOverlayStack: () => OverlayInfo[];
+    /**
+     * Check if an overlay is active
+     * @param type Overlay type/name
+     */
+    isOverlayActive: (type: OverlayName) => boolean;
+    /** @internal */
+    _descriptors: {
+        pages: Record<string, PageDescriptor>;
+        overlays: Record<string, OverlayDescriptor>;
+    };
+    /** @internal */
+    _state: NavigationState;
+}
+export interface OverlayInfo {
+    type: string;
+    id: string;
+}
+interface NavigationState {
+    currentPage: string;
+    pageParams: Record<string, Record<string, any>>;
+    overlayStack: OverlayInfo[];
+    overlayParams: Record<string, Record<string, any>>;
+}
+/**
+ * Create a stack navigator
+ * @param options Navigator configuration
+ * @returns Navigator instance
+ */
+export declare function createStackNavigator<Pages extends Record<string, PageConfig>, Overlays extends Record<string, OverlayConfig>>(options: StackNavigatorOptions<Pages, Overlays>): Navigator<keyof Pages & string, keyof Overlays & string>;
+/**
+ * Create a navigation component for a navigator
+ * @param navigator The navigator instance
+ * @returns A React component that renders the navigation state
+ */
+export declare function createStaticNavigation(navigator: Navigator<any, any>): React.FC;
+/**
+ * Get the navigator instance (stable reference)
+ * Can be used in both components and state logic
+ * @returns Navigator object
+ */
+export declare function getNavigator<PageName extends string = DefaultPageName, OverlayName extends string = DefaultOverlayName>(): Navigator<PageName, OverlayName>;
+/**
+ * Hook to get the navigator instance in components
+ */
+export declare const useNavigation: typeof getNavigator;
+/**
+ * Get navigation parameters for current component
+ * @returns Parameters object (cast as T)
+ *
+ * This hook reads params from React Context, which is provided by the router.
+ * - If called from within an overlay context, returns overlay params
+ * - If called from within a page context, returns page params
+ * - Supports multiple nested overlays (each gets its own params)
+ *
+ * Note: We cast the result to T and provide an empty object as fallback.
+ * Since required parameters are validated at navigation entry points, we can
+ * safely assume the runtime object matches T.
+ */
+export declare function useNavigationParams<T = Record<string, any>>(): T;
+export {};

package/dist/components/navigation.js

@@ -0,0 +1,253 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useNavigation = exports.OverlayParamsContext = exports.PageParamsContext = void 0;
+exports.createStackNavigator = createStackNavigator;
+exports.createStaticNavigation = createStaticNavigation;
+exports.getNavigator = getNavigator;
+exports.useNavigationParams = useNavigationParams;
+const react_1 = __importStar(require("react"));
+const valtio_1 = require("valtio");
+// ============================================================================
+// React Contexts for Parameters
+// ============================================================================
+/**
+ * Context for page parameters
+ * Used to provide params to page components via React tree
+ */
+exports.PageParamsContext = (0, react_1.createContext)(undefined);
+/**
+ * Context for overlay parameters
+ * Used to provide params to overlay components via React tree
+ */
+exports.OverlayParamsContext = (0, react_1.createContext)(undefined);
+// ============================================================================
+// Helper Functions
+// ============================================================================
+let overlayIdCounter = 0;
+const generateOverlayId = () => {
+    return `overlay-${++overlayIdCounter}-${Date.now()}`;
+};
+/**
+ * Validate navigation parameters against descriptor schema
+ */
+function validateParams(type, name, descriptor, params) {
+    if (!descriptor?.requiredParams)
+        return;
+    const actualParams = params ?? {};
+    for (const key of descriptor.requiredParams) {
+        if (actualParams[key] === undefined) {
+            throw new Error(`Navigation Error: Missing required parameter "${key}" for ${type} "${name}". ` +
+                `Expected: { ${descriptor.requiredParams.join(', ')} }`);
+        }
+    }
+}
+// ============================================================================
+// Global Navigation State and Navigator
+// ============================================================================
+let globalNavigator = null;
+/**
+ * Normalize page/overlay config to descriptor format
+ * Allows shorthand syntax: Component or { component: Component, options?: {} }
+ */
+function normalizeDescriptor(config) {
+    if (typeof config === 'function' || config.$$typeof) {
+        // It's a component (function or React element)
+        return { component: config };
+    }
+    // It's already a descriptor
+    return config;
+}
+/**
+ * Create a stack navigator
+ * @param options Navigator configuration
+ * @returns Navigator instance
+ */
+function createStackNavigator(options) {
+    // Normalize pages and overlays
+    const normalizedPages = {};
+    for (const [key, config] of Object.entries(options.pages)) {
+        normalizedPages[key] = normalizeDescriptor(config);
+    }
+    const normalizedOverlays = {};
+    if (options.overlays) {
+        for (const [key, config] of Object.entries(options.overlays)) {
+            normalizedOverlays[key] = normalizeDescriptor(config);
+        }
+    }
+    // Initialize navigation state
+    const navigationState = (0, valtio_1.proxy)({
+        currentPage: options.initialPage,
+        pageParams: {},
+        overlayStack: [],
+        overlayParams: {},
+    });
+    // Create navigator API
+    const navigator = {
+        navigate: (page, params) => {
+            // Check if page exists
+            if (!normalizedPages[page]) {
+                console.error(`Navigation Error: Page "${page}" not found in navigator configuration.`);
+                return;
+            }
+            // Validate parameters
+            validateParams('page', page, normalizedPages[page], params);
+            navigationState.currentPage = page;
+            if (params !== undefined) {
+                navigationState.pageParams[page] = params;
+            }
+            else {
+                // Clear params if no params provided
+                delete navigationState.pageParams[page];
+            }
+        },
+        goBack: () => {
+            // TODO: Implement history stack
+            console.warn('goBack() not implemented yet');
+        },
+        pushOverlay: (overlay, params) => {
+            // Check if overlay exists
+            if (!normalizedOverlays[overlay]) {
+                console.error(`Navigation Error: Overlay "${overlay}" not found in navigator configuration.`);
+                return;
+            }
+            // Validate parameters
+            validateParams('overlay', overlay, normalizedOverlays[overlay], params);
+            const id = generateOverlayId();
+            const overlayInfo = { type: overlay, id };
+            navigationState.overlayStack.push(overlayInfo);
+            if (params !== undefined) {
+                navigationState.overlayParams[id] = params;
+            }
+        },
+        popOverlay: () => {
+            const overlay = navigationState.overlayStack.pop();
+            if (overlay) {
+                delete navigationState.overlayParams[overlay.id];
+            }
+        },
+        clearOverlays: () => {
+            // Clear all overlay params
+            for (const overlay of navigationState.overlayStack) {
+                delete navigationState.overlayParams[overlay.id];
+            }
+            // Clear stack
+            navigationState.overlayStack = [];
+        },
+        getCurrentPage: () => {
+            return navigationState.currentPage;
+        },
+        getParams: () => {
+            return navigationState.pageParams[navigationState.currentPage];
+        },
+        getOverlayStack: () => {
+            return [...navigationState.overlayStack];
+        },
+        isOverlayActive: (type) => {
+            return navigationState.overlayStack.some((overlay) => overlay.type === type);
+        },
+        _descriptors: {
+            pages: normalizedPages,
+            overlays: normalizedOverlays,
+        },
+        _state: navigationState,
+    };
+    // Store as global navigator
+    globalNavigator = navigator;
+    return navigator;
+}
+/**
+ * Create a navigation component for a navigator
+ * @param navigator The navigator instance
+ * @returns A React component that renders the navigation state
+ */
+function createStaticNavigation(navigator) {
+    return () => {
+        // navigator._state is a Valtio proxy, useSnapshot makes it reactive
+        const navState = (0, valtio_1.useSnapshot)(navigator._state);
+        const { pages, overlays } = navigator._descriptors;
+        // Get current page component
+        const pageDescriptor = pages[navState.currentPage];
+        const Page = pageDescriptor?.component || (() => null);
+        return (react_1.default.createElement(react_1.default.Fragment, null,
+            react_1.default.createElement(exports.PageParamsContext.Provider, { value: navState.pageParams[navState.currentPage] },
+                react_1.default.createElement(Page, null)),
+            navState.overlayStack.map((overlay) => {
+                const overlayDescriptor = overlays[overlay.type];
+                const OverlayComponent = overlayDescriptor?.component || (() => null);
+                return (react_1.default.createElement(exports.OverlayParamsContext.Provider, { key: overlay.id, value: navState.overlayParams[overlay.id] },
+                    react_1.default.createElement(OverlayComponent, null)));
+            })));
+    };
+}
+// ============================================================================
+// React Hooks
+// ============================================================================
+/**
+ * Get the navigator instance (stable reference)
+ * Can be used in both components and state logic
+ * @returns Navigator object
+ */
+function getNavigator() {
+    if (!globalNavigator) {
+        throw new Error('Navigator not initialized. Call createStackNavigator first.');
+    }
+    return globalNavigator;
+}
+/**
+ * Hook to get the navigator instance in components
+ */
+exports.useNavigation = getNavigator;
+/**
+ * Get navigation parameters for current component
+ * @returns Parameters object (cast as T)
+ *
+ * This hook reads params from React Context, which is provided by the router.
+ * - If called from within an overlay context, returns overlay params
+ * - If called from within a page context, returns page params
+ * - Supports multiple nested overlays (each gets its own params)
+ *
+ * Note: We cast the result to T and provide an empty object as fallback.
+ * Since required parameters are validated at navigation entry points, we can
+ * safely assume the runtime object matches T.
+ */
+function useNavigationParams() {
+    const overlayParams = (0, react_1.useContext)(exports.OverlayParamsContext);
+    const pageParams = (0, react_1.useContext)(exports.PageParamsContext);
+    // If in overlay context, return overlay params; otherwise return page params
+    // Default to empty object if both are undefined
+    return (overlayParams ?? pageParams ?? {});
+}
+//# sourceMappingURL=navigation.js.map

package/dist/components/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/components/navigation.tsx"],"names":[],"mappings":"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"}

package/dist/declaration.d.ts

@@ -0,0 +1,74 @@
+import type { ClassAttributes, ReactNode } from 'react';
+import type { Node } from './node';
+import type { BubbleEvent } from './events/base';
+import type { MouseEvent } from './events/mouse';
+import type { TouchEvent } from './events/touch';
+import type { KeyboardEvent } from './events/keyboard';
+import { NodeProps } from './bindings/NodeProps';
+import { ClipProps } from './bindings/ClipProps';
+import { FilterProps } from './bindings/FilterProps';
+import { BackdropProps } from './bindings/BackdropProps';
+import { SpriteProps } from './bindings/SpriteProps';
+import { TextProps } from './bindings/TextProps';
+import { AnimationProps } from './bindings/AnimationProps';
+export type Tuple2 = [number, number];
+export type Tuple3 = [number, number, number];
+export type Tuple4 = [number, number, number, number];
+export type DetailedMoyuProps<E extends MoyuNodeAttributes> = ClassAttributes<Node> & E;
+export type MoyuEventHandler<T extends BubbleEvent> = (event: T) => void;
+export interface MoyuListenerAttributes {
+    onClick?: MoyuEventHandler<MouseEvent>;
+    onMouseEnter?: MoyuEventHandler<MouseEvent>;
+    onMouseLeave?: MoyuEventHandler<MouseEvent>;
+    onMouseDown?: MoyuEventHandler<MouseEvent>;
+    onMouseUp?: MoyuEventHandler<MouseEvent>;
+    onMouseMove?: MoyuEventHandler<MouseEvent>;
+    onKeyDown?: MoyuEventHandler<KeyboardEvent>;
+    onKeyUp?: MoyuEventHandler<KeyboardEvent>;
+    onKeyPress?: MoyuEventHandler<KeyboardEvent>;
+    onTouchStart?: MoyuEventHandler<TouchEvent>;
+    onTouchMove?: MoyuEventHandler<TouchEvent>;
+    onTouchEnd?: MoyuEventHandler<TouchEvent>;
+    onTouchCancel?: MoyuEventHandler<TouchEvent>;
+}
+export type MoyuNodeAttributes = MoyuListenerAttributes & NodeProps & {
+    children?: ReactNode;
+};
+export type MoyuContainerAttributes = MoyuNodeAttributes;
+export type MoyuClipAttributes = ClipProps & MoyuNodeAttributes;
+export type MoyuFilterAttributes = FilterProps & MoyuNodeAttributes;
+export type MoyuBackdropAttributes = BackdropProps & MoyuNodeAttributes;
+export type MoyuAnimationAttributes = AnimationProps & MoyuNodeAttributes;
+export type MoyuSpriteAttributes = SpriteProps & MoyuNodeAttributes;
+export type MoyuTextAttributes = TextProps & MoyuNodeAttributes & {
+    onStart?: () => void;
+    onFinish?: () => void;
+    onProgress?: (progress: number) => void;
+};
+export declare namespace JSX {
+    type ElementType = string | React.JSXElementConstructor<any>;
+    interface Element extends React.ReactElement<any, any> {
+    }
+    interface ElementClass extends React.Component<any> {
+        render(): React.ReactNode;
+    }
+    interface ElementAttributesProperty {
+        props: {};
+    }
+    interface ElementChildrenAttribute {
+        children: {};
+    }
+    interface IntrinsicAttributes extends React.Attributes {
+    }
+    interface IntrinsicClassAttributes<T> extends React.ClassAttributes<T> {
+    }
+    interface IntrinsicElements {
+        container: DetailedMoyuProps<MoyuContainerAttributes>;
+        sprite: DetailedMoyuProps<MoyuSpriteAttributes>;
+        text: DetailedMoyuProps<MoyuTextAttributes>;
+        clip: DetailedMoyuProps<MoyuClipAttributes>;
+        filter: DetailedMoyuProps<MoyuFilterAttributes>;
+        backdrop: DetailedMoyuProps<MoyuBackdropAttributes>;
+        animation: DetailedMoyuProps<MoyuAnimationAttributes>;
+    }
+}

package/dist/declaration.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=declaration.js.map

package/dist/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../src/declaration.ts"],"names":[],"mappings":""}

package/dist/events/base.d.ts

@@ -0,0 +1,16 @@
+export interface MoyuEvent<T extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    body: T;
+}
+export interface BubbleEvent {
+    targetId: number;
+    bubbleTargetIds: number[];
+    currentTargetId: number;
+    stopPropagation: () => void;
+    preventDefault: () => void;
+    defaultPrevented: boolean;
+    bubbles: boolean;
+}
+export declare function createBubbleEvent<T extends BubbleEvent>(body: Record<string, any> & {
+    bubbleTargetIds: number[];
+}, targetId: number): T;

package/dist/events/base.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBubbleEvent = createBubbleEvent;
+function createBubbleEvent(body, targetId) {
+    const event = {
+        ...body,
+        targetId,
+        currentTargetId: targetId,
+        stopPropagation: () => {
+            event.bubbles = false;
+        },
+        preventDefault: () => {
+            event.defaultPrevented = true;
+        },
+        defaultPrevented: false,
+        bubbles: true,
+    };
+    return event;
+}
+//# sourceMappingURL=base.js.map

package/dist/events/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/events/base.ts"],"names":[],"mappings":";;AAeA,8CAmBC;AAnBD,SAAgB,iBAAiB,CAC/B,IAAyD,EACzD,QAAgB;IAEhB,MAAM,KAAK,GAAgB;QACzB,GAAG,IAAI;QACP,QAAQ;QACR,eAAe,EAAE,QAAQ;QACzB,eAAe,EAAE,GAAG,EAAE;YACpB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,CAAC;QACD,cAAc,EAAE,GAAG,EAAE;YACnB,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAChC,CAAC;QACD,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE,IAAI;KACd,CAAC;IAEF,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/events/globals.d.ts

@@ -0,0 +1,2 @@
+export declare const globalEventListeners: Record<string, ((event: any) => void)[]>;
+export declare const globalRequestAnimationFrameListeners: FrameRequestCallback[];

package/dist/events/globals.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalRequestAnimationFrameListeners = exports.globalEventListeners = void 0;
+const state_1 = require("../state");
+const base_1 = require("./base");
+exports.globalEventListeners = {};
+exports.globalRequestAnimationFrameListeners = [];
+const BUBBLE_EVENT_NAMES = ['mouseevent', 'touchevent', 'keyboardevent'];
+globalThis.__moyu_receive_event = (raw_event) => {
+    const { name, body } = raw_event;
+    if (BUBBLE_EVENT_NAMES.includes(name)) {
+        handleBubbleEvent(name, body);
+    }
+    else {
+        // handles non-dom events and return
+        switch (name) {
+            case 'customevent': {
+                const { name, body: _body, targetId } = body;
+                // if targetId is 0, it is a global event (send to root node or send from plugin)
+                if (targetId === 0) {
+                    for (const listener of exports.globalEventListeners[name.toLowerCase()] ?? []) {
+                        listener(_body);
+                    }
+                    return;
+                }
+                state_1.STATE.nodeMap[targetId]?.listeners?.[`on${name.charAt(0).toUpperCase() + name.slice(1)}`]?.(_body);
+                return;
+            }
+            case 'nodeevent': {
+                const { kind, targetId } = body;
+                if (kind === 'Destory') {
+                    delete state_1.STATE.nodeMap[targetId];
+                }
+                return;
+            }
+            case 'animationframecallbackevent': {
+                const listeners = exports.globalRequestAnimationFrameListeners.splice(0);
+                const { timestamp } = body;
+                for (const listener of listeners) {
+                    listener?.(timestamp);
+                }
+                return;
+            }
+            default: {
+                exports.globalEventListeners[name]?.forEach((listener) => listener(body));
+                return;
+            }
+        }
+    }
+};
+function handleBubbleEvent(name, body) {
+    const event = (0, base_1.createBubbleEvent)(body, body.targetId);
+    const { kind, bubbleTargetIds } = body;
+    // if targetId is 0, it is a global event (send to root node or send from plugin)
+    if (body.targetId !== 0) {
+        const node = state_1.STATE.nodeMap[body.targetId];
+        if (!node) {
+            return;
+        }
+        if (['mouseevent', 'keyboardevent'].includes(name)) {
+            node?.listeners?.[`on${kind}`]?.(event);
+            while (event.bubbles && bubbleTargetIds.length) {
+                // biome-ignore lint/style/noNonNullAssertion: we are sure that the array is not empty, it is a bug of biomejs
+                event.currentTargetId = bubbleTargetIds.pop();
+                event.currentTargetLabel = state_1.STATE.nodeMap[event.currentTargetId]?.label;
+                state_1.STATE.nodeMap[event.currentTargetId]?.listeners?.[`on${kind}`]?.(event);
+            }
+        }
+        else if (name === 'touchevent') {
+            const { identifier } = body;
+            event.identifier = identifier;
+            node?.listeners?.[`on${kind}`]?.(event);
+            {
+                const _bubbleTargetIds = [...bubbleTargetIds];
+                while (event.bubbles && _bubbleTargetIds.length) {
+                    // biome-ignore lint/style/noNonNullAssertion: we are sure that the array is not empty, it is a bug of biomejs
+                    event.currentTargetId = _bubbleTargetIds.pop();
+                    event.currentTargetLabel = state_1.STATE.nodeMap[event.currentTargetId]?.label;
+                    state_1.STATE.nodeMap[event.currentTargetId]?.listeners?.[`on${kind}`]?.(event);
+                }
+            }
+            // simulate mouse events as same as browsers
+            // if (kind === TouchEventKind.TouchEnd && !STATE.touchMoved[identifier] && !event.defaultPrevented) {
+            //   for (const eventKind of ['MouseMove', 'MouseDown', 'MouseUp', 'Click'] as MouseEventKind[]) {
+            //     event.bubbles = true;
+            //     event.kind = eventKind;
+            //     node?.listeners?.[`on${eventKind}`]?.(event);
+            //     const _bubbleTargetIds = [...bubbleTargetIds];
+            //     while (event.bubbles && _bubbleTargetIds.length) {
+            //       // biome-ignore lint/style/noNonNullAssertion: we are sure that the array is not empty, it is a bug of biomejs
+            //       event.currentTargetId = _bubbleTargetIds.pop()!;
+            //       event.currentTargetLabel = STATE.nodeMap[event.currentTargetId]?.label;
+            //       STATE.nodeMap[event.currentTargetId]?.listeners?.[`on${eventKind}`]?.(event);
+            //     }
+            //   }
+            // }
+            if (kind === 'TouchStart') {
+                state_1.STATE.touchMoved[identifier] = false;
+            }
+            else if (kind === 'TouchMove') {
+                state_1.STATE.touchMoved[identifier] = true;
+            }
+            else if (kind === 'TouchEnd' || kind === 'TouchCancel') {
+                delete state_1.STATE.touchMoved[identifier];
+            }
+        }
+    }
+    if (event.bubbles) {
+        for (const listener of exports.globalEventListeners[kind.toLowerCase()] ?? []) {
+            listener(event);
+        }
+    }
+}
+if (globalThis.__moyu_native) {
+    // detect if it is running in browser, if not, polyfill requestAnimationFrame
+    globalThis.requestAnimationFrame = (callback) => {
+        return exports.globalRequestAnimationFrameListeners.push(callback) - 1;
+    };
+    globalThis.cancelAnimationFrame = (handle) => {
+        exports.globalRequestAnimationFrameListeners.splice(handle, 1);
+    };
+}
+//# sourceMappingURL=globals.js.map