narraleaf-react 0.5.0 → 0.7.0

package/dist/game/player/lib/Preloaded.d.ts

@@ -1,48 +1,48 @@
-import { Sound } from "../../nlcore/elements/sound";
-import { Src } from "../../nlcore/action/srcManager";
-import { EventDispatcher } from "../../../util/data";
-import { Image } from "../../nlcore/elements/displayable/image";
-export type PreloadedSrcTypes = "image" | "audio" | "video";
-export type PreloadedSrc<T extends PreloadedSrcTypes = any> = ({
-    type: "image";
-    src: Image;
-} | {
-    type: "audio";
-    src: Sound;
-} | {
-    type: "video";
-    src: string;
-}) & (T extends undefined ? {} : ({
-    type: T;
-} & T extends "image" ? {
-    src: Image;
-} : T extends "audio" ? {
-    src: Sound;
-} : T extends "video" ? {
-    src: string;
-} : {}));
-export type PreloadedEventTypes = {
-    "event:preloaded.add": [PreloadedSrc | string];
-    "event:preloaded.remove": [PreloadedSrc | string];
-    "event:preloaded.change": [];
-    "event:preloaded.mount": [];
-    "event:preloaded.ready": [];
-    "event:preloaded.unmount": [];
-};
-export declare class Preloaded {
-    static EventTypes: {
-        [K in keyof PreloadedEventTypes]: K;
-    };
-    preloaded: PreloadedSrc[];
-    events: EventDispatcher<PreloadedEventTypes>;
-    add<T extends PreloadedSrcTypes = PreloadedSrcTypes>(src: PreloadedSrc<T>): this;
-    get<T extends PreloadedSrcTypes = any>(src: string): PreloadedSrc<T> | undefined;
-    has(src: string): boolean;
-    has(src: string[]): boolean;
-    remove(src: string): this;
-    remove(src: PreloadedSrc): this;
-    remove(src: string[]): this;
-    remove(src: PreloadedSrc[]): this;
-    clear(): this;
-    getSrc(src: Src | string): string | null;
-}
+import { Sound } from "../../nlcore/elements/sound";
+import { Src } from "../../nlcore/action/srcManager";
+import { EventDispatcher } from "../../../util/data";
+import { Image } from "../../nlcore/elements/displayable/image";
+export type PreloadedSrcTypes = "image" | "audio" | "video";
+export type PreloadedSrc<T extends PreloadedSrcTypes = any> = ({
+    type: "image";
+    src: Image;
+} | {
+    type: "audio";
+    src: Sound;
+} | {
+    type: "video";
+    src: string;
+}) & (T extends undefined ? {} : ({
+    type: T;
+} & T extends "image" ? {
+    src: Image;
+} : T extends "audio" ? {
+    src: Sound;
+} : T extends "video" ? {
+    src: string;
+} : {}));
+export type PreloadedEventTypes = {
+    "event:preloaded.add": [PreloadedSrc | string];
+    "event:preloaded.remove": [PreloadedSrc | string];
+    "event:preloaded.change": [];
+    "event:preloaded.mount": [];
+    "event:preloaded.ready": [];
+    "event:preloaded.unmount": [];
+};
+export declare class Preloaded {
+    static EventTypes: {
+        [K in keyof PreloadedEventTypes]: K;
+    };
+    preloaded: PreloadedSrc[];
+    events: EventDispatcher<PreloadedEventTypes>;
+    add<T extends PreloadedSrcTypes = PreloadedSrcTypes>(src: PreloadedSrc<T>): this;
+    get<T extends PreloadedSrcTypes = any>(src: string): PreloadedSrc<T> | undefined;
+    has(src: string): boolean;
+    has(src: string[]): boolean;
+    remove(src: string): this;
+    remove(src: PreloadedSrc): this;
+    remove(src: string[]): this;
+    remove(src: PreloadedSrc[]): this;
+    clear(): this;
+    getSrc(src: Src | string): string | null;
+}

package/dist/game/player/lib/flush.d.ts

@@ -1,5 +1,5 @@
-import React from "react";
-export declare function useFlush(deps?: React.DependencyList): [
-    () => void,
-    number
-];
+import React from "react";
+export declare function useFlush(deps?: React.DependencyList): [
+    () => void,
+    number
+];

package/dist/game/player/lib/isolated.d.ts

@@ -1,7 +1,7 @@
-import React, { ReactNode } from "react";
-export default function Isolated({ children, className, style, ref, ...props }: Readonly<{
-    children: ReactNode;
-    className?: string;
-    style?: React.CSSProperties;
-    ref?: React.RefObject<HTMLDivElement | null>;
-} & React.HTMLAttributes<HTMLDivElement>>): React.JSX.Element;
+import React, { ReactNode } from "react";
+export default function Isolated({ children, className, style, ref, ...props }: Readonly<{
+    children: ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    ref?: React.RefObject<HTMLDivElement | null>;
+} & React.HTMLAttributes<HTMLDivElement>>): React.JSX.Element;

package/dist/game/player/lib/keyMap.d.ts

@@ -0,0 +1,3 @@
+import { KeyBindingValue } from "../../../game/nlcore/game/keyMap";
+import { KeyBindingType } from "../../../game/nlcore/game/types";
+export declare function useKeyBinding(type: KeyBindingType): [KeyBindingValue, (value: KeyBindingValue) => void];

package/dist/game/player/lib/notification.d.ts

@@ -1,47 +1,47 @@
-import { Awaitable } from "../../../util/data";
-import { GameState } from "../gameState";
-import { LiveGameEventToken } from "../../../game/nlcore/types";
-export type Notification = {
-    message: string;
-    id: string;
-    duration: number;
-};
-export declare class NotificationArray {
-    private readonly notifications;
-    static create(notifications: Notification[]): NotificationArray;
-    private readonly stringified;
-    private constructor();
-    private wrap;
-    /**
-     * Map the notifications to a new array
-     *
-     * **Note:** The callback function is called with the notification message, the **id** of the notification, and the array of notifications.
-     *
-     * @param callbackfn - The callback function
-     * @returns The new array
-     */
-    map<U>(callbackfn: (notification: string, id: string, array: string[]) => U): U[];
-    filter(callbackfn: (notification: string, id: string, array: string[]) => boolean): string[];
-    forEach(callbackfn: (notification: string, id: string, array: string[]) => void): void;
-    find(callbackfn: (notification: string, id: string, array: string[]) => boolean): string | undefined;
-    findIndex(callbackfn: (notification: string, id: string, array: string[]) => boolean): number;
-}
-export declare class NotificationManager {
-    gameState: GameState;
-    notifications: Notification[];
-    private readonly events;
-    constructor(gameState: GameState, notifications: Notification[]);
-    addNotification(notification: Notification): void;
-    removeNotification(notification: Notification): void;
-    clearNotifications(): void;
-    /**
-     * Consume a notification
-     *
-     * @param notification - The notification to consume
-     * @returns A promise that resolves when the notification is consumed
-     */
-    consume(notification: Notification): Awaitable<void>;
-    onFlush(callback: () => void): LiveGameEventToken;
-    toArray(): Notification[];
-    private flush;
-}
+import { Awaitable } from "../../../util/data";
+import { GameState } from "../gameState";
+import { LiveGameEventToken } from "../../../game/nlcore/types";
+export type Notification = {
+    message: string;
+    id: string;
+    duration: number | null;
+};
+export declare class NotificationArray {
+    private readonly notifications;
+    static create(notifications: Notification[]): NotificationArray;
+    private readonly stringified;
+    private constructor();
+    private wrap;
+    /**
+     * Map the notifications to a new array
+     *
+     * **Note:** The callback function is called with the notification message, the **id** of the notification, and the array of notifications.
+     *
+     * @param callbackfn - The callback function
+     * @returns The new array
+     */
+    map<U>(callbackfn: (notification: string, id: string, array: string[]) => U): U[];
+    filter(callbackfn: (notification: string, id: string, array: string[]) => boolean): string[];
+    forEach(callbackfn: (notification: string, id: string, array: string[]) => void): void;
+    find(callbackfn: (notification: string, id: string, array: string[]) => boolean): string | undefined;
+    findIndex(callbackfn: (notification: string, id: string, array: string[]) => boolean): number;
+}
+export declare class NotificationManager {
+    gameState: GameState;
+    notifications: Notification[];
+    private readonly events;
+    constructor(gameState: GameState, notifications: Notification[]);
+    addNotification(notification: Notification): void;
+    removeNotification(notification: Notification): void;
+    clearNotifications(): void;
+    /**
+     * Consume a notification
+     *
+     * @param notification - The notification to consume
+     * @returns A promise that resolves when the notification is consumed
+     */
+    consume(notification: Notification): Awaitable<void>;
+    onFlush(callback: () => void): LiveGameEventToken;
+    toArray(): Notification[];
+    private flush;
+}

package/dist/game/player/lib/preferences.d.ts

@@ -1,8 +1,8 @@
-import { StringKeyOf } from "../../../util/data";
-import { GamePreference } from "../../nlcore/game";
-/**
- * Custom hook for managing game preferences
- * @param key - Preference key to access/modify
- * @returns Tuple containing current preference value and setter function
- */
-export declare function usePreference<K extends StringKeyOf<GamePreference>>(key: K): [GamePreference[K], (value: GamePreference[K]) => void];
+import { StringKeyOf } from "../../../util/data";
+import { GamePreference } from "../../../game/nlcore/gameTypes";
+/**
+ * Custom hook for managing game preferences
+ * @param key - Preference key to access/modify
+ * @returns Tuple containing current preference value and setter function
+ */
+export declare function usePreference<K extends StringKeyOf<GamePreference>>(key: K): [GamePreference[K], (value: GamePreference[K]) => void];

package/dist/game/player/lib/useConstant.d.ts

@@ -0,0 +1 @@
+export declare function useConstant<T>(fn: () => T): T;

package/dist/game/player/lib/useElementVisibility.d.ts

@@ -1,5 +1,5 @@
-import { RefObject } from "react";
-export declare function useElementVisibility<T extends HTMLElement>(ref: RefObject<T | null>): {
-    show: () => void;
-    hide: () => void;
-};
+import { RefObject } from "react";
+export declare function useElementVisibility<T extends HTMLElement>(ref: RefObject<T | null>): {
+    show: () => void;
+    hide: () => void;
+};

package/dist/game/player/lib/useExposeState.d.ts

@@ -1,10 +1,10 @@
-import { ExposedKeys, ExposedState, ExposedStateType } from "../type";
-import React from "react";
-/**
- * Custom hook for exposing state to the game state manager
- * @param key - Unique identifier for the state
- * @param value - State value or function returning state value
- * @param deps - Dependency array for state updates
- * @returns Empty array (for consistency with React hooks)
- */
-export declare function useExposeState<T extends ExposedStateType>(key: ExposedKeys[T], value: ExposedState[T] | (() => ExposedState[T]), deps?: React.DependencyList): [];
+import { ExposedKeys, ExposedState, ExposedStateType } from "../type";
+import React from "react";
+/**
+ * Custom hook for exposing state to the game state manager
+ * @param key - Unique identifier for the state
+ * @param value - State value or function returning state value
+ * @param deps - Dependency array for state updates
+ * @returns Empty array (for consistency with React hooks)
+ */
+export declare function useExposeState<T extends ExposedStateType>(key: ExposedKeys[T], value: ExposedState[T] | (() => ExposedState[T]), deps?: React.DependencyList): [];

package/dist/game/player/lib/useLiveGame.d.ts

@@ -1 +1 @@
-export declare function useLiveGame(): import("../../..").LiveGame;
+export declare function useLiveGame(): import("../../..").LiveGame;

package/dist/game/player/libElements.d.ts

@@ -1,12 +1,15 @@
-import Isolated from "./lib/isolated";
-import { usePreference } from "./lib/preferences";
-import { Stage } from "./lib/PageRouter/Stage";
-import { Page } from "./lib/PageRouter/Page";
-import GameMenu from "./elements/menu/UIMenu/Menu";
-import Item from "./elements/menu/UIMenu/Item";
-import Notifications from "./elements/notification/Notifications";
-import Texts from "./elements/say/Sentence";
-import Nametag from "./elements/say/Nametag";
-import Dialog from "./elements/say/Dialog";
-import { useDialog } from "./elements/say/useDialog";
-export { Isolated, usePreference, Stage, Page, GameMenu, Item, Notifications, Texts, Nametag, Dialog, useDialog, };
+import Isolated from "./lib/isolated";
+import { usePreference } from "./lib/preferences";
+import { Stage } from "./lib/PageRouter/Stage";
+import GameMenu from "./elements/menu/UIMenu/Menu";
+import Item from "./elements/menu/UIMenu/Item";
+import Notifications from "./elements/notification/Notifications";
+import Texts from "./elements/say/Sentence";
+import Nametag from "./elements/say/Nametag";
+import Dialog from "./elements/say/Dialog";
+import { useDialog } from "./elements/say/useDialog";
+import { Page, PageInjectContext } from "./lib/PageRouter/Page";
+import { Layout, LayoutRouterProvider } from "./lib/PageRouter/Layout";
+import { RootPath } from "./lib/PageRouter/router";
+import { useKeyBinding } from "./lib/keyMap";
+export { Isolated, usePreference, Stage, GameMenu, Item, Notifications, Texts, Nametag, Dialog, useDialog, Page, Layout, LayoutRouterProvider, PageInjectContext, RootPath, useKeyBinding, };

package/dist/game/player/provider/game-state.d.ts

@@ -1,24 +1,24 @@
-import "client-only";
-import React, { ReactNode } from "react";
-import { Game } from "../../nlcore/game";
-/**
- * Context type definition for game state management
- */
-type GameContextType = Game;
-/**
- * Game state provider component
- * Provides game state context to all child components
- * @param children - React children components
- * @param game - Optional initial game instance
- */
-export declare function GameProvider({ children, game }: {
-    children?: ReactNode;
-    game?: Game;
-}): React.JSX.Element;
-/**
- * Custom hook to access game state context
- * @returns GameContextType object containing game instance and setter
- * @throws Error if used outside of GameProvider
- */
-export declare function useGame(): GameContextType;
-export {};
+import "client-only";
+import React, { ReactNode } from "react";
+import { Game } from "../../nlcore/game";
+/**
+ * Context type definition for game state management
+ */
+type GameContextType = Game;
+/**
+ * Game state provider component
+ * Provides game state context to all child components
+ * @param children - React children components
+ * @param game - Optional initial game instance
+ */
+export declare function GameProvider({ children, game }: {
+    children?: ReactNode;
+    game?: Game;
+}): React.JSX.Element;
+/**
+ * Custom hook to access game state context
+ * @returns GameContextType object containing game instance and setter
+ * @throws Error if used outside of GameProvider
+ */
+export declare function useGame(): GameContextType;
+export {};

package/dist/game/player/provider/preloaded.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/dist/game/player/provider/providers.d.ts

@@ -1,7 +1,7 @@
-import "client-only";
-import React from "react";
-import { Game } from "../../nlcore/game";
-export default function GameProviders({ children, game }: Readonly<{
-    children?: React.ReactNode;
-    game?: Game;
-}>): React.JSX.Element;
+import "client-only";
+import React from "react";
+import { Game } from "../../nlcore/game";
+export default function GameProviders({ children, game }: Readonly<{
+    children?: React.ReactNode;
+    game?: Game;
+}>): React.JSX.Element;

package/dist/game/player/provider/ratio.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/dist/game/player/type.d.ts

@@ -1,68 +1,68 @@
-import { Choice } from "../nlcore/elements/menu";
-import { Image } from "../nlcore/elements/displayable/image";
-import { EventDispatcher } from "../../util/data";
-import { ImageEvents } from "./elements/image/Image";
-import { Transform } from "../nlcore/elements/transform/transform";
-import { Transition } from "../nlcore/elements/transition/transition";
-import { Layer } from "../nlcore/elements/layer";
-import { Text } from "../nlcore/elements/displayable/text";
-import { Displayable } from "../nlcore/elements/displayable/displayable";
-import { Scene } from "../nlcore/elements/scene";
-import { Sound } from "../nlcore/elements/sound";
-import { Video } from "../nlcore/elements/video";
-import { Timeline } from "./Tasks";
-export * from "./elements/type";
-export type Chosen = Choice & {
-    evaluated: string;
-};
-export declare enum ExposedStateType {
-    image = "narraleaf:image",
-    text = "narraleaf:text",
-    layer = "narraleaf:layer",
-    scene = "narraleaf:scene",
-    video = "narraleaf:video"
-}
-export type ExposedState = {
-    [ExposedStateType.image]: {
-        createWearable: (wearable: Image) => void;
-        disposeWearable: (wearable: Image) => void;
-        events: EventDispatcher<ImageEvents>;
-        initDisplayable: (onResolve: () => void) => Timeline;
-        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
-        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
-        updateStyleSync: () => void;
-    };
-    [ExposedStateType.text]: {
-        initDisplayable: (onResolve: () => void) => Timeline;
-        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
-        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
-        updateStyleSync: () => void;
-        flush: () => void;
-    };
-    [ExposedStateType.layer]: {
-        initDisplayable: (onResolve: () => void) => Timeline;
-        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
-        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
-        updateStyleSync: () => void;
-    };
-    [ExposedStateType.scene]: {
-        setBackgroundMusic: (music: Sound | null, fade: number) => Promise<void>;
-    };
-    [ExposedStateType.video]: {
-        show: () => void;
-        hide: () => void;
-        play: () => Promise<void>;
-        pause: () => void;
-        resume: () => Promise<void>;
-        stop: () => void;
-        seek: (time: number) => void;
-    };
-};
-export type ExposedKeys = {
-    [ExposedStateType.image]: Image | Displayable<any, any>;
-    [ExposedStateType.text]: Text | Displayable<any, any>;
-    [ExposedStateType.layer]: Layer | Displayable<any, any>;
-    [ExposedStateType.scene]: Scene;
-    [ExposedStateType.video]: Video;
-};
-export type { INotificationsProps } from "./elements/notification/type";
+import { Choice } from "../nlcore/elements/menu";
+import { Image } from "../nlcore/elements/displayable/image";
+import { EventDispatcher } from "../../util/data";
+import { ImageEvents } from "./elements/image/Image";
+import { Transform } from "../nlcore/elements/transform/transform";
+import { Transition } from "../nlcore/elements/transition/transition";
+import { Layer } from "../nlcore/elements/layer";
+import { Text } from "../nlcore/elements/displayable/text";
+import { Displayable } from "../nlcore/elements/displayable/displayable";
+import { Scene } from "../nlcore/elements/scene";
+import { Sound } from "../nlcore/elements/sound";
+import { Video } from "../nlcore/elements/video";
+import { Timeline } from "./Tasks";
+export * from "./elements/type";
+export type Chosen = Choice & {
+    evaluated: string;
+};
+export declare enum ExposedStateType {
+    image = "narraleaf:image",
+    text = "narraleaf:text",
+    layer = "narraleaf:layer",
+    scene = "narraleaf:scene",
+    video = "narraleaf:video"
+}
+export type ExposedState = {
+    [ExposedStateType.image]: {
+        createWearable: (wearable: Image) => void;
+        disposeWearable: (wearable: Image) => void;
+        events: EventDispatcher<ImageEvents>;
+        initDisplayable: (onResolve: () => void) => Timeline;
+        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
+        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
+        updateStyleSync: () => void;
+    };
+    [ExposedStateType.text]: {
+        initDisplayable: (onResolve: () => void) => Timeline;
+        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
+        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
+        updateStyleSync: () => void;
+        flush: () => void;
+    };
+    [ExposedStateType.layer]: {
+        initDisplayable: (onResolve: () => void) => Timeline;
+        applyTransform: (transform: Transform, onResolve: () => void) => Timeline;
+        applyTransition: (transition: Transition<any>, onResolve: () => void) => Timeline;
+        updateStyleSync: () => void;
+    };
+    [ExposedStateType.scene]: {
+        setBackgroundMusic: (music: Sound | null, fade: number) => Promise<void>;
+    };
+    [ExposedStateType.video]: {
+        show: () => void;
+        hide: () => void;
+        play: () => Promise<void>;
+        pause: () => void;
+        resume: () => Promise<void>;
+        stop: () => void;
+        seek: (time: number) => void;
+    };
+};
+export type ExposedKeys = {
+    [ExposedStateType.image]: Image | Displayable<any, any>;
+    [ExposedStateType.text]: Text | Displayable<any, any>;
+    [ExposedStateType.layer]: Layer | Displayable<any, any>;
+    [ExposedStateType.scene]: Scene;
+    [ExposedStateType.video]: Video;
+};
+export type { INotificationsProps } from "./elements/notification/type";

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./game/nlcore/common/core";
-export * from "./game/nlcore/common/player";
-import "./styles/index.css";
+export * from "./game/nlcore/common/core";
+export * from "./game/nlcore/common/player";
+import "./styles/index.css";