narraleaf-react 0.0.1-beta.3 → 0.0.1-beta.5

package/README.md

@@ -0,0 +1,119 @@
+![](./docs/nlr-logo-md.png)
+
+# NarraLeaf-React
+
+A React visual novel player framework
+
+## What is NarraLeaf-React?
+
+NarraLeaf-React is a lightweight front-end visual novel player.  
+NL focuses on visual novel playing, so the user interface can be customized very easily.
+
+It doesn't use any rendering libraries and can be used on any web platform (e.g. Electron)
+
+## Get Started
+
+### Install
+
+```bash
+npm install narraleaf-react
+```
+
+### Example
+
+```tsx
+"use client";
+
+import { Character, Scene, Story, Image, Game, Player, GameProviders } from "narraleaf-react";
+
+export default function App() {
+    const story = new Story("My First NarraLeaf Story");
+
+    const scene1 = new Scene("scene1");
+
+    const character1 = new Character("character1");
+    const image1 = new Image({
+        src: "https://placehold.it/200x200",
+    })
+
+    // Add actions to the scene
+    scene1.action([
+        // Show image1 for 1 second
+        image1.show({
+            duration: 1000,
+        }).toActions(),
+
+        // Say something
+        character1
+            .say("Hello, world!")
+            .say("This is my first NarraLeaf story.")
+            .say("Start editing this file and enjoy the journey!")
+            .toActions(),
+    ]);
+
+    story.entry(scene1);
+
+    function handleOnReady(game: Game) {
+        game.getLiveGame().newGame();
+        console.log("Game is ready!");
+    }
+
+    return (
+        <GameProviders>
+            <Player
+                story={story}
+                onReady={handleOnReady}
+                width="100vw"
+                height="100vh"
+            />
+        </GameProviders>
+    );
+}
+```
+
+Read more in [Quick Start](./docs/quick-start.md)
+
+### Performance
+
+Please enable image cache for a better performance.
+
+for NextJS, add this to your `next.config.js`:
+
+```js
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+    async headers() {
+        return [
+            {
+                source: '/YOUR_IMAGE_ENDPOINT/(.*)', // ex: /static/images/(.*)
+                headers: [
+                    {
+                        key: 'Cache-Control',
+                        value: 'public, max-age=31536000, immutable',
+                    },
+                ],
+            }
+        ]
+    }
+};
+
+export default nextConfig;
+```
+
+## Documentation
+
+- [Quick Start](./docs/quick-start.md)  
+- [Customization](./docs/customization.md)
+
+in progress...
+
+## License
+
+> NarraLeaf-React is licensed under the MIT License.
+
+## Contributing
+
+We welcome all contributions.  
+If you have any ideas, just open an issue or a pull request.
+
+

package/dist/game/nlcore/action/action.d.ts

@@ -1,8 +1,8 @@
 import { LogicAction } from "./logicAction";
-import { ContentNode } from "@core/action/tree/actionTree";
+import { ContentNode } from "../action/tree/actionTree";
 import type { CalledActionResult } from "@core/gameTypes";
-import { Awaitable } from "@lib/util/data";
-import { GameState } from "@player/gameState";
+import { Awaitable } from "../../../util/data";
+import { GameState } from "../../player/gameState";
 export declare class Action<ContentNodeType = any, Callee = LogicAction.GameElement> {
     static ActionTypes: {
         action: string;

package/dist/game/nlcore/action/actionTypes.d.ts

@@ -1,15 +1,15 @@
-import { LogicAction } from "@core/action/logicAction";
-import type { Story } from "@core/elements/story";
-import type { ConditionData } from "@core/elements/condition";
-import { Background, CommonImage } from "@core/types";
-import { Transform } from "@core/elements/transform/transform";
-import type { Scene } from "@core/elements/scene";
-import type { Sentence } from "@core/elements/text";
-import type { MenuData } from "@core/elements/menu";
-import { Awaitable } from "@lib/util/data";
-import { ITransition } from "@core/elements/transition/type";
-import type { Sound } from "@core/elements/sound";
-import type { Script } from "@core/elements/script";
+import { LogicAction } from "../action/logicAction";
+import type { Story } from "../elements/story";
+import type { ConditionData } from "../elements/condition";
+import { Background, CommonImage } from "../types";
+import { Transform } from "../elements/transform/transform";
+import type { Scene } from "../elements/scene";
+import type { Sentence } from "../elements/text";
+import type { MenuData } from "../elements/menu";
+import { Awaitable } from "../../../util/data";
+import { ITransition } from "../elements/transition/type";
+import type { Sound } from "../elements/sound";
+import type { Script } from "../elements/script";
 export declare const CharacterActionTypes: {
     readonly say: "character:say";
     readonly action: "character:action";
@@ -79,15 +79,17 @@ export declare const SoundActionTypes: {
     readonly fade: "sound:fade";
     readonly setVolume: "sound:setVolume";
     readonly setRate: "sound:setRate";
+    readonly pause: "sound:pause";
+    readonly resume: "sound:resume";
 };
 export type SoundActionContentType = {
     [K in typeof SoundActionTypes[keyof typeof SoundActionTypes]]: K extends "sound:play" ? [void] : K extends "sound:stop" ? [void] : K extends "sound:fade" ? [
         {
-            start: number;
+            start?: number;
             end: number;
             duration: number;
         }
-    ] : K extends "sound:setVolume" ? [number] : K extends "sound:setRate" ? [number] : any;
+    ] : K extends "sound:setVolume" ? [number] : K extends "sound:setRate" ? [number] : K extends "sound:pause" ? [void] : K extends "sound:resume" ? [void] : any;
 };
 export declare const ControlActionTypes: {
     readonly action: "control:action";

package/dist/game/nlcore/action/actionable.d.ts

@@ -1,4 +1,4 @@
-import { LogicAction } from "@core/action/logicAction";
+import { LogicAction } from "../action/logicAction";
 export declare class Actionable<StateData extends Record<string, any> = Record<string, any>> {
     static IdPrefixes: {
         readonly Actionable: "actionable";

package/dist/game/nlcore/action/actions.d.ts

@@ -1,19 +1,19 @@
-import { ContentNode } from "@core/action/tree/actionTree";
-import { Awaitable } from "@lib/util/data";
-import { Image } from "@core/elements/image";
-import { LogicAction } from "@core/action/logicAction";
-import { Action } from "@core/action/action";
-import type { Character } from "@core/elements/text";
-import type { Scene } from "@core/elements/scene";
-import type { Story } from "@core/elements/story";
-import type { Script } from "@core/elements/script";
-import type { Menu } from "@core/elements/menu";
-import type { Condition } from "@core/elements/condition";
+import { ContentNode } from "../action/tree/actionTree";
+import { Awaitable } from "../../../util/data";
+import { Image } from "../elements/image";
+import { LogicAction } from "../action/logicAction";
+import { Action } from "../action/action";
+import type { Character } from "../elements/text";
+import type { Scene } from "../elements/scene";
+import type { Story } from "../elements/story";
+import type { Script } from "../elements/script";
+import type { Menu } from "../elements/menu";
+import type { Condition } from "../elements/condition";
 import type { CalledActionResult } from "@core/gameTypes";
-import { GameState } from "@player/gameState";
-import type { Sound } from "@core/elements/sound";
-import { Control } from "@core/elements/control";
-import { CharacterActionContentType, CharacterActionTypes, ConditionActionContentType, ConditionActionTypes, ControlActionContentType, ControlActionTypes, ImageActionContentType, ImageActionTypes, MenuActionContentType, MenuActionTypes, SceneActionContentType, SceneActionTypes, ScriptActionContentType, ScriptActionTypes, SoundActionContentType, SoundActionTypes, StoryActionContentType, StoryActionTypes } from "@core/action/actionTypes";
+import { GameState } from "../../player/gameState";
+import type { Sound } from "../elements/sound";
+import { Control } from "../elements/control";
+import { CharacterActionContentType, CharacterActionTypes, ConditionActionContentType, ConditionActionTypes, ControlActionContentType, ControlActionTypes, ImageActionContentType, ImageActionTypes, MenuActionContentType, MenuActionTypes, SceneActionContentType, SceneActionTypes, ScriptActionContentType, ScriptActionTypes, SoundActionContentType, SoundActionTypes, StoryActionContentType, StoryActionTypes } from "../action/actionTypes";
 export declare class TypedAction<ContentType extends Record<string, any> = Record<string, any>, T extends keyof ContentType & string = keyof ContentType & string, Callee extends LogicAction.GameElement = LogicAction.GameElement> extends Action<ContentType[T], Callee> {
     callee: Callee;
     constructor(callee: Callee, type: any, contentNode: ContentNode<ContentType[T]>);
@@ -97,6 +97,8 @@ export declare class SoundAction<T extends typeof SoundActionTypes[keyof typeof
         readonly fade: "sound:fade";
         readonly setVolume: "sound:setVolume";
         readonly setRate: "sound:setRate";
+        readonly pause: "sound:pause";
+        readonly resume: "sound:resume";
     };
     static initSound(state: GameState, sound: Sound): void;
     executeAction(state: GameState): CalledActionResult | Awaitable<CalledActionResult, any>;

package/dist/game/nlcore/action/constructable.d.ts

@@ -1,5 +1,5 @@
-import { ContentNode, RenderableNode, RootNode } from "@core/action/tree/actionTree";
-import { LogicAction } from "@core/action/logicAction";
+import { ContentNode, RenderableNode, RootNode } from "../action/tree/actionTree";
+import { LogicAction } from "../action/logicAction";
 export declare class Constructable<T extends typeof Constructable = any, TAction extends LogicAction.Actions = LogicAction.Actions, CAction extends LogicAction.Actions = LogicAction.Actions> {
     static targetAction: any;
     private readonly actions;

package/dist/game/nlcore/action/logicAction.d.ts

@@ -1,15 +1,15 @@
-import type { Character } from "@core/elements/text";
-import type { Scene } from "@core/elements/scene";
-import type { Story } from "@core/elements/story";
-import type { Image } from "@core/elements/image";
-import type { Condition } from "@core/elements/condition";
-import type { Script } from "@core/elements/script";
-import type { Menu } from "@core/elements/menu";
-import { Values } from "@lib/util/data";
-import { CharacterAction, ConditionAction, ControlAction, ImageAction, MenuAction, SceneAction, ScriptAction, SoundAction, StoryAction, TypedAction } from "@core/action/actions";
-import { Sound } from "@core/elements/sound";
-import { Control } from "@core/elements/control";
-import { CharacterActionContentType, CharacterActionTypes, ConditionActionContentType, ConditionActionTypes, ControlActionContentType, ImageActionContentType, ImageActionTypes, MenuActionContentType, MenuActionTypes, SceneActionContentType, SceneActionTypes, ScriptActionContentType, ScriptActionTypes, SoundActionContentType, StoryActionContentType, StoryActionTypes } from "@core/action/actionTypes";
+import type { Character } from "../elements/text";
+import type { Scene } from "../elements/scene";
+import type { Story } from "../elements/story";
+import type { Image } from "../elements/image";
+import type { Condition } from "../elements/condition";
+import type { Script } from "../elements/script";
+import type { Menu } from "../elements/menu";
+import { Values } from "../../../util/data";
+import { CharacterAction, ConditionAction, ControlAction, ImageAction, MenuAction, SceneAction, ScriptAction, SoundAction, StoryAction, TypedAction } from "../action/actions";
+import { Sound } from "../elements/sound";
+import { Control } from "../elements/control";
+import { CharacterActionContentType, CharacterActionTypes, ConditionActionContentType, ConditionActionTypes, ControlActionContentType, ImageActionContentType, ImageActionTypes, MenuActionContentType, MenuActionTypes, SceneActionContentType, SceneActionTypes, ScriptActionContentType, ScriptActionTypes, SoundActionContentType, StoryActionContentType, StoryActionTypes } from "../action/actionTypes";
 export declare namespace LogicAction {
     type GameElement = Character | Scene | Story | Image | Condition | Script | Menu | Sound | Control;
     type Actions = (TypedAction | CharacterAction | ConditionAction | ImageAction | SceneAction | ScriptAction | StoryAction | MenuAction | SoundAction | ControlAction);

package/dist/game/nlcore/action/tree/actionTree.d.ts

@@ -1,4 +1,4 @@
-import { LogicAction } from "@core/action/logicAction";
+import { LogicAction } from "../../action/logicAction";
 export declare enum NodeType {
     TreeNode = "TreeNode",
     ContentNode = "ContentNode"

package/dist/game/nlcore/common/Utils.d.ts

@@ -1,6 +1,6 @@
-import type { Background, NextJSStaticImageData } from "@core/types";
-import type { Scene } from "@core/elements/scene";
-import type { Image } from "@core/elements/image";
+import type { Background, NextJSStaticImageData } from "../types";
+import type { Scene } from "../elements/scene";
+import type { Image } from "../elements/image";
 export declare class Utils {
     static srcToString(src: string | NextJSStaticImageData): string;
     static staticImageDataToSrc(image: NextJSStaticImageData | string): string;

package/dist/game/nlcore/common/elements.d.ts

@@ -1,13 +1,13 @@
 import { Character, Sentence, Word } from "../elements/text";
 import { Condition, Lambda } from "../elements/condition";
-import { Control } from "@core/elements/control";
-import { Game } from "@core/game";
+import { Control } from "../elements/control";
+import { Game } from "../game";
 import { Image } from "../elements/image";
 import { Menu } from "../elements/menu";
 import { Scene } from "../elements/scene";
 import { Script } from "../elements/script";
-import { Sound, SoundType } from "@core/elements/sound";
+import { Sound, SoundType } from "../elements/sound";
 import { Story } from "../elements/story";
-import { Transform } from "@core/elements/transform/transform";
+import { Transform } from "../elements/transform/transform";
 import { Utils } from "./Utils";
 export { Character, Condition, Control, Game, Image, Lambda, Menu, Scene, Script, Sentence, Sound, SoundType, Story, Transform, Utils, Word };

package/dist/game/nlcore/common/game.d.ts

@@ -1,3 +1,3 @@
-import { LiveGame } from "@core/game";
-import { GameState } from "@player/gameState";
+import { LiveGame } from "../game";
+import { GameState } from "../../player/gameState";
 export { LiveGame, GameState };

package/dist/game/nlcore/common/player.d.ts

@@ -1,4 +1,7 @@
-import Player from "@player/elements/Player";
-import GameProviders from "@player/provider/providers";
-import { GameState } from "@player/gameState";
-export { GameProviders, Player, GameState, };
+import Player from "../../player/elements/Player";
+import GameProviders from "../../player/provider/providers";
+import { GameState } from "../../player/gameState";
+import { useGame } from "../../../game/player/provider/game-state";
+export * from "../../player/type";
+export * from "../../player/libElements";
+export { GameProviders, Player, useGame, GameState, };

package/dist/game/nlcore/common/position.d.ts

@@ -1,2 +1,2 @@
-import { Align, CommonPosition, Coord2D, CommonPositionType } from "@core/elements/transform/position";
+import { Align, CommonPosition, Coord2D, CommonPositionType } from "../elements/transform/position";
 export { Align, CommonPosition, Coord2D, CommonPositionType };

package/dist/game/nlcore/common/transition.d.ts

@@ -1,6 +1,6 @@
-import { ITransition } from "@core/elements/transition/type";
-import { Fade } from "@core/elements/transition/fade";
-import { FadeIn } from "@core/elements/transition/fadeIn";
-import { Dissolve } from "@core/elements/transition/dissolve";
+import { ITransition } from "../elements/transition/type";
+import { Fade } from "../elements/transition/fade";
+import { FadeIn } from "../elements/transition/fadeIn";
+import { Dissolve } from "../elements/transition/dissolve";
 export { Fade, FadeIn, Dissolve };
 export type { ITransition };

package/dist/game/nlcore/common/types.d.ts

@@ -1,2 +1,2 @@
-import { TransformDefinitions } from "@core/elements/transform/type";
+import { TransformDefinitions } from "../elements/transform/type";
 export type { TransformDefinitions, };

package/dist/game/nlcore/elements/condition.d.ts

@@ -1,7 +1,7 @@
-import { RenderableNode } from "@core/action/tree/actionTree";
-import { LogicAction } from "@core/action/logicAction";
-import { Actionable } from "@core/action/actionable";
-import { GameState } from "@player/gameState";
+import { RenderableNode } from "../action/tree/actionTree";
+import { LogicAction } from "../action/logicAction";
+import { Actionable } from "../action/actionable";
+import { GameState } from "../../player/gameState";
 export type ConditionConfig = {};
 interface LambdaCtx {
     gameState: GameState;

package/dist/game/nlcore/elements/control.d.ts

@@ -1,5 +1,5 @@
-import { Actionable } from "@core/action/actionable";
-import { LogicAction } from "@core/action/logicAction";
+import { Actionable } from "../action/actionable";
+import { LogicAction } from "../action/logicAction";
 import Actions = LogicAction.Actions;
 export declare class Control extends Actionable {
     /**

package/dist/game/nlcore/elements/image.d.ts

@@ -1,12 +1,12 @@
-import { CommonImage, NextJSStaticImageData, StaticImageData } from "@core/types";
-import { DeepPartial, EventDispatcher } from "@lib/util/data";
-import { Transform } from "./transform/transform";
-import { ImageAction } from "@core/action/actions";
-import { Actionable } from "@core/action/actionable";
-import type { TransformDefinitions } from "@core/elements/transform/type";
 import React from "react";
+import type { TransformDefinitions } from "../elements/transform/type";
 import { AnimationScope } from "framer-motion";
-import { ITransition } from "@core/elements/transition/type";
+import { ImageAction } from "../action/actions";
+import { Actionable } from "../action/actionable";
+import { Transform } from "./transform/transform";
+import { CommonImage, NextJSStaticImageData, StaticImageData } from "../types";
+import { ITransition } from "../elements/transition/type";
+import { DeepPartial, EventDispatcher } from "../../../util/data";
 export type ImageConfig = {
     src: string | NextJSStaticImageData;
     display: boolean;

package/dist/game/nlcore/elements/menu.d.ts

@@ -1,8 +1,8 @@
 import { Sentence, Word } from "./text";
-import { RenderableNode } from "@core/action/tree/actionTree";
-import { LogicAction } from "@core/action/logicAction";
-import { MenuAction } from "@core/action/actions";
-import { Actionable } from "@core/action/actionable";
+import { RenderableNode } from "../action/tree/actionTree";
+import { LogicAction } from "../action/logicAction";
+import { MenuAction } from "../action/actions";
+import { Actionable } from "../action/actionable";
 import Actions = LogicAction.Actions;
 export type MenuConfig = {};
 export type MenuChoice = {

package/dist/game/nlcore/elements/scene.d.ts

@@ -1,13 +1,13 @@
 import { Constructable } from "../action/constructable";
-import { Awaitable, DeepPartial, EventDispatcher } from "@lib/util/data";
-import { Background, CommonImage } from "@core/types";
-import { LogicAction } from "@core/action/logicAction";
-import { SceneAction } from "@core/action/actions";
-import { Transform } from "@core/elements/transform/transform";
-import { ITransition } from "@core/elements/transition/type";
-import { SrcManager } from "@core/elements/srcManager";
-import { Sound, SoundDataRaw } from "@core/elements/sound";
-import { TransformDefinitions } from "@core/elements/transform/type";
+import { Awaitable, DeepPartial, EventDispatcher } from "../../../util/data";
+import { Background, CommonImage } from "../types";
+import { LogicAction } from "../action/logicAction";
+import { SceneAction } from "../action/actions";
+import { Transform } from "../elements/transform/transform";
+import { ITransition } from "../elements/transition/type";
+import { SrcManager } from "../elements/srcManager";
+import { Sound, SoundDataRaw } from "../elements/sound";
+import { TransformDefinitions } from "../elements/transform/type";
 import Actions = LogicAction.Actions;
 import ImageTransformProps = TransformDefinitions.ImageTransformProps;
 export type SceneConfig = {

package/dist/game/nlcore/elements/script.d.ts

@@ -1,6 +1,6 @@
-import { LogicAction } from "@core/action/logicAction";
-import { Actionable } from "@core/action/actionable";
-import { GameState } from "@player/gameState";
+import { LogicAction } from "../action/logicAction";
+import { Actionable } from "../action/actionable";
+import { GameState } from "../../player/gameState";
 import Actions = LogicAction.Actions;
 export interface ScriptCtx {
     script: Script;

package/dist/game/nlcore/elements/sound.d.ts

@@ -1,5 +1,5 @@
-import { Actionable } from "@core/action/actionable";
-import { DeepPartial } from "@lib/util/data";
+import { Actionable } from "../action/actionable";
+import { DeepPartial } from "../../../util/data";
 import * as Howler from "howler";
 import { HowlOptions } from "howler";
 export declare enum SoundType {
@@ -42,9 +42,11 @@ export declare class Sound extends Actionable<SoundDataRaw> {
     constructor(config?: DeepPartial<SoundConfig>);
     play(): this;
     stop(): this;
-    fade(start: number, end: number, duration: number): this;
+    fade(start: number | undefined, end: number, duration: number): this;
     setVolume(volume: number): this;
     setRate(rate: number): this;
+    pause(fade?: number): this;
+    resume(fade?: number): this;
     getHowlOptions(): HowlOptions;
     getSrc(): string;
     $setToken(token: any): void;

package/dist/game/nlcore/elements/srcManager.d.ts

@@ -1,6 +1,6 @@
-import { Sound } from "@core/elements/sound";
-import { Image } from "@core/elements/image";
-import { StaticImageData } from "@core/types";
+import { Sound } from "../elements/sound";
+import { Image } from "../elements/image";
+import { StaticImageData } from "../types";
 export type SrcType = "image" | "video" | "audio";
 export type Src = {
     type: "image";

package/dist/game/nlcore/elements/story.d.ts

@@ -1,8 +1,8 @@
 import { Constructable } from "../action/constructable";
 import { LogicAction } from "../game";
-import { SceneAction, StoryAction } from "@core/action/actions";
-import { RawData, RenderableNode } from "@core/action/tree/actionTree";
-import { Scene } from "@core/elements/scene";
+import { SceneAction, StoryAction } from "../action/actions";
+import { RawData, RenderableNode } from "../action/tree/actionTree";
+import { Scene } from "../elements/scene";
 export type StoryConfig = {};
 export type ElementStateRaw = Record<string, any>;
 export type NodeChildIdMap = Map<string, string>;

package/dist/game/nlcore/elements/text.d.ts

@@ -1,5 +1,5 @@
-import { Color } from "@core/types";
-import { Actionable } from "@core/action/actionable";
+import { Color } from "../types";
+import { Actionable } from "../action/actionable";
 export type SentenceConfig = {
     pause?: boolean | number;
 } & Color;

package/dist/game/nlcore/elements/transform/position.d.ts

@@ -1,4 +1,4 @@
-import { CSSProps } from "@core/elements/transition/type";
+import { CSSProps } from "../../elements/transition/type";
 export declare enum CommonPositionType {
     Left = 0,
     Center = 1,

package/dist/game/nlcore/elements/transform/transform.d.ts

@@ -1,10 +1,10 @@
-import type { Background, CommonImage, CommonImagePosition } from "@core/types";
+import type { Background, CommonImage, CommonImagePosition } from "../../types";
 import type { AnimationPlaybackControls, DOMKeyframesDefinition, DynamicAnimationOptions } from "framer-motion";
-import { DeepPartial } from "@lib/util/data";
-import { GameState } from "@player/gameState";
+import { DeepPartial } from "../../../../util/data";
+import { GameState } from "../../../player/gameState";
 import { TransformDefinitions } from "./type";
 import { Align, Coord2D, IPosition } from "./position";
-import { CSSProps } from "@core/elements/transition/type";
+import { CSSProps } from "../../elements/transition/type";
 import Sequence = TransformDefinitions.Sequence;
 import SequenceProps = TransformDefinitions.SequenceProps;
 export type Transformers = "position" | "opacity" | "scale" | "rotation" | "display" | "src" | "backgroundColor" | "backgroundOpacity" | "transform";

package/dist/game/nlcore/elements/transform/type.d.ts

@@ -1,5 +1,5 @@
-import { Background, CommonImage } from "@core/types";
-import { DeepPartial } from "@lib/util/data";
+import { Background, CommonImage } from "../../types";
+import { DeepPartial } from "../../../../util/data";
 import type { AnimationPlaybackControls, AnimationScope, AnimationSequence, DOMKeyframesDefinition, DynamicAnimationOptions, ElementOrSelector, MotionValue, ValueAnimationTransition } from "framer-motion";
 export declare namespace TransformDefinitions {
     type BezierDefinition = [number, number, number, number];

package/dist/game/nlcore/elements/transition/base.d.ts

@@ -1,4 +1,4 @@
-import { EventDispatcher } from "@lib/util/data";
+import { EventDispatcher } from "../../../../util/data";
 import { ElementProp, EventTypes, ITransition } from "./type";
 import { AnimationPlaybackControls, ValueAnimationTransition } from "framer-motion";
 export declare class Base<T extends ElementProp> implements ITransition<T> {

package/dist/game/nlcore/elements/transition/dissolve.d.ts

@@ -1,7 +1,7 @@
 import { ElementProp, ITransition } from "./type";
 import { Base } from "./base";
-import { Scene } from "@core/elements/scene";
-import { NextJSStaticImageData } from "@core/types";
+import { Scene } from "../../elements/scene";
+import { NextJSStaticImageData } from "../../types";
 export type DissolveElementProps = {
     opacity: number;
 };

package/dist/game/nlcore/elements/transition/fade.d.ts

@@ -1,7 +1,7 @@
 import { ElementProp, ITransition } from "./type";
 import { Base } from "./base";
-import { Scene } from "@core/elements/scene";
-import { StaticImageData } from "@core/types";
+import { Scene } from "../../elements/scene";
+import { StaticImageData } from "../../types";
 export type FadeElementProps = {
     opacity: number;
 };

package/dist/game/nlcore/elements/transition/fadeIn.d.ts

@@ -1,7 +1,7 @@
-import { ElementProp, ITransition } from "@core/elements/transition/type";
-import { Base } from "@core/elements/transition/base";
-import { Scene } from "@core/elements/scene";
-import { StaticImageData } from "@core/types";
+import { ElementProp, ITransition } from "../../elements/transition/type";
+import { Base } from "../../elements/transition/base";
+import { Scene } from "../../elements/scene";
+import { StaticImageData } from "../../types";
 type FadeInProps = {
     style?: {
         opacity: number;

package/dist/game/nlcore/elements/transition/type.d.ts

@@ -1,4 +1,4 @@
-import type { EventDispatcher } from "@lib/util/data";
+import type { EventDispatcher } from "../../../../util/data";
 import React from "react";
 import { DOMKeyframesDefinition } from "framer-motion";
 export type ElementProp<T extends Element = Element, U extends React.HTMLAttributes<T> = React.HTMLAttributes<T>> = React.JSX.IntrinsicAttributes & React.ClassAttributes<T> & React.HTMLAttributes<T> & U;

package/dist/game/nlcore/game.d.ts

@@ -1,9 +1,10 @@
 import type { CalledActionResult, GameConfig, GameSettings, SavedGame } from "./gameTypes";
-import { Awaitable, DeepPartial } from "@lib/util/data";
-import { Storable } from "@core/store/storable";
+import { Awaitable, DeepPartial } from "../../util/data";
+import { Storable } from "./store/storable";
 import { Story } from "./elements/story";
-import { LogicAction } from "@core/action/logicAction";
-import { GameState } from "@player/gameState";
+import { LogicAction } from "./action/logicAction";
+import { GameState } from "../player/gameState";
+import { ComponentsTypes } from "../player/elements/type";
 declare const IdManager_base: {
     new (): {};
     _instance: {} | null;
@@ -26,6 +27,9 @@ declare enum GameSettingsNamespace {
 }
 export declare class Game {
     static defaultSettings: GameSettings;
+    static ComponentTypes: {
+        [K in keyof ComponentsTypes]: K;
+    };
     static DefaultConfig: GameConfig;
     static GameSettingsNamespace: typeof GameSettingsNamespace;
     readonly config: Readonly<GameConfig>;
@@ -36,6 +40,7 @@ export declare class Game {
      */
     constructor(config: DeepPartial<GameConfig>);
     static getIdManager(): IdManager;
+    useComponent<T extends keyof ComponentsTypes>(key: T, components: ComponentsTypes[T]): this;
     getLiveGame(): LiveGame;
     private createLiveGame;
 }