qpremake 1.5.2 → 1.5.3

package/README.md

@@ -1,9 +1,54 @@
-# qpRemake 
-
-This is a card processing system for the game "Quantum Protocol" remade in native Typescript.
-Quantum Protocol and Jkong reserves all rights to the game and all related assets.
-
-## Installation
+# qpRemake
+
+This is a card effect processing system for the game "Quantum Protocol" remade in native Typescript.
+
+> Quantum Protocol and Jkong reserves all rights to the game and all related assets.
+
+## Table of contents
+
+- [qpRemake](#qpremake)
+  - [Table of contents](#table-of-contents)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Basic usage](#basic-usage)
+  - [What the imported objects do](#what-the-imported-objects-do)
+    - [**queenSystem**](#queensystem)
+    - [**queenSystemComponents**](#queensystemcomponents)
+      - [**gameComponent**:](#gamecomponent)
+      - [**systemComponent**](#systemcomponent)
+    - [**queenSystemUtils**](#queensystemutils)
+  - [Advanced usage:](#advanced-usage)
+    - [Making your own renderer](#making-your-own-renderer)
+    - [Saving and loading game state:](#saving-and-loading-game-state)
+    - [Display texts](#display-texts)
+    - [Handling inputs](#handling-inputs)
+- [Modding](#modding)
+  - [What is a mod?](#what-is-a-mod)
+  - [How mods are run](#how-mods-are-run)
+  - [How to make a mod](#how-to-make-a-mod)
+  - [Adding a mod](#adding-a-mod)
+  - [Example: Adding a custom effect](#example-adding-a-custom-effect)
+- [Project contribution](#project-contribution)
+  - [Current progress:](#current-progress)
+  - [How to get and develop the project](#how-to-get-and-develop-the-project)
+    - [Clone the project:](#clone-the-project)
+    - [Run the project](#run-the-project)
+  - [Game components](#game-components)
+  - [Main gameplay loop](#main-gameplay-loop)
+  - [Project structure](#project-structure)
+  - [Contribution workflow guide](#contribution-workflow-guide)
+    - [Make effects](#make-effects)
+    - [Add more actions (if needed)](#add-more-actions-if-needed)
+    - [Update effect registry](#update-effect-registry)
+    - [Update card registry](#update-card-registry)
+    - [Update defaultSetting](#update-defaultsetting)
+    - [Running tests](#running-tests)
+    - [Make renderers](#make-renderers)
+    - [Improving the text parser](#improving-the-text-parser)
+
+
+
+# Installation
 
 The system is available via npm.
 
@@ -14,8 +59,9 @@ npm i qpremake
 And then can be imported via 
 
 ```ts
+// ts
 import { 
-   queenSystem, 
+   queenSystem as s, 
    queenSystemComponents, 
    queenSystemUtils 
 } from "qpremake"
@@ -24,6 +70,7 @@ import {
 or 
 
 ```js
+// js
 const { 
    queenSystem, 
    queenSystemComponents, 
@@ -34,15 +81,21 @@ const {
 There is also a default import for just the ```queenSystem```
 
 ```ts
+// ts
 import queenSystem from "qpRemake"
 ```
 
 or
 
 ```js
+// js
 const queenSystem = require("qpRemake")
 ```
 
+# Usage
+
+This section is dedicated to thos who wish to use the system and render out a game, rather than modding stuff.
+
 ## Basic usage
 
 This here is just a calculator for card effects. To have it renders out something visible, (like text or an HTML page), you have to hook it up to a ```Renderer```.
@@ -53,13 +106,15 @@ This code binds a renderer of your choice to the system for rendering. More info
 import {queenSystem, queenSystemComponents} from "qpRemake"
 
 const { operatorRegistry } = queenSystemComponents.registry
+const sampleRenderer = queenSystemComponents.systemComponent.sampleRenderer
+const defaultSetting = { queenSystemComponents } 
 
 let setting = new defaultSetting()
 let renderer = new YourRendererHere() 
 // Your renderer shoudld be here
 // What interface it follows is in the later sections.
 
-let s = new queenSystem(setting, renderer)
+let s = new queenSystem(setting, sampleRenderer)
 renderer.bind(s)
 s.addPlayers("player", operatorRegistry.o_esper)
 s.addPlayers("enemy", operatorRegistry.o_null)
@@ -70,7 +125,7 @@ s.start();
 
 ## What the imported objects do
 
-### queenSystem
+### **queenSystem**
 
 The queenSystem is a class that handles card effect calculations. 
 
@@ -95,191 +150,289 @@ Here is a cheatsheet of what this class does from the perspective of a renderer:
 3. ```addDeck``` : for adding decks
 4. ```start``` : start the game
 
-### queenSystemComponents
+### **queenSystemComponents**
 
 Various classes used in the processing of card effects. 
 
 Use from the perspective of a modder who wants to add more cards / effects.
 Outside of this, one can read the data from the various registries (either enum or const key -> data pair).
 
-The structure of this object is as follows:
+For a cheat sheet, here are the properties of systemComponent:
+
+1. ```gameComponent``` : holds various game component classes. 
+2. ```systemComponent``` : holds various services to operate on data
+3. ```displayComponent``` : holds display parsed segements
+4. ```registry``` : holds data
+5. ```defaultSetting``` : holds the default setting
+6. ```mod``` : holds what format mods must follows
+
+#### **gameComponent**:
+
+Holds various game component classes like ```Card, Effect, ...```.
+
+The complete list is:
+
+*Class entries*
+1. ```Card```
+2. ```Effect```
+3. ```Zone_grid``` and ```Zone_stack``` : Default zone implementation
+4. ```Action```
+
+*Objects with classes inside*
+
+5. ```EffectType``` :Various effect types
+6. ```EffectSubType``` : Various effect subtypes
+7. ```Zone``` : Various default zones
+8. ```Serialized``` : Serialized components, for saving and loading
+9. ```Localized``` : Localized components, passed to the renderer
+
+#### **systemComponent**
+
+Hold various services outside of gameplay intepretations.
+
+The complete list is:
+
+1. ```EffectTextParser``` : parses effect text
+2. ```Localizer``` : localzied game components
+3. ```ActionGenerator``` : generates actions
+4. ```InputRequester``` : generates input requests
+5. ```Renderer``` : an abstract class to how a renderer linked to the system shoudll be formatted.
+6. ```SampleRenderer``` : an example renderer
+
+### **queenSystemUtils**
+
+Holds various utilities functions like rng or ID generation.
+
+This object is also available as a global object in ```Utils```.
+
+## Advanced usage:
+
+### Making your own renderer
+
+A renderer's job is to ..well render stuff.
+
+The work flow of a renderer in **qpRemake** is to receive API like requests during the turn, renders it, then return control to the system to process more stuff.
+
+The base abstract class / interface can be found in 
 
 ```ts
-const queenSystemComponents = {
-    "gameComponent" : {
-         //Action class, stores what to do (move card, delete, execute, etc)
-        Action, 
-
-        //Card class, represents a card, all cards extends from this
-        Card,   
-
-        //Effect class, cards contain effects, all effects extends from this
-        Effect, 
-
-        //Two premade form of a zone class, mainly differ in how to store and interact with stored cards
-        Zone_grid, Zone_stack, 
-        "Zone" : {
-
-            //Zone class, mainly just here for instanceof, use the above Zone_grid and Zone_stack instead
-            "ParentClass" : Zone, 
-
-            //Below this are various premade zones
-            //To add your own, extend from one of Zone_grid or Zone_stack
-            //and implement zone methods to move cards and interupt events
-
-            //Zones initiates with a data structure
-            //to define capacity, shape, etc
-            //See zoneDataRegistry
-
-            Ability, 
-            Deck, 
-            Drop,
-            Field,
-            Grave,
-            Hand,
-            Storage,
-            System,
-            Void
-        },
-        "EffectSubType" : {
-
-            // Effects can have subtypes
-            // subtypes of an effect modifies an Effect's attribute
-            // and / or modifies the response
-            "ParentClass" : EffectSubtype,
-
-            //Below are various premade subtypes
-
-            Chained, 
-            Delayed, 
-            FieldLock, 
-            GraveLock, 
-            HandOrFieldLock, 
-            HardUnique, 
-            Instant, 
-            Once, 
-            Unique
-        },
-        "EffectType" : {
-
-            // Effects can also have a type
-            "ParentClass" : EffectType,
-            InitEffect, 
-            LockEffect,
-            ManualEffect,
-            PassiveEffect,
-            TriggerEffect
-        },
-        "Serialized" : {
-
-            // The serialized version of game components
-            // remove circular references and should be save to JSON stringify
-            // and save
-            SerializedCard,
-            Serialized_effect,
-            SerializedZone,
-            SerializedPlayer,
-            SerializedSystem,
-        },
-        "Localized" : {
-
-            // Localized versions of game components
-            // All texts of these objects is parsed through the localizer already
-            // should also have no circular refs
-            LocalizedAction,
-            LocalizedCard,
-            LocalizedEffect,
-            LocalizedZone,
-            LocalizedPlayer,
-            LocalizedSystem,
-        }
-    },
-    "systemComponent" : {
-
-         // Various short hand services
-
-         // This one parses effect text, see more in later sections
-         "effectTextParser" : Parser,
-
-         // This one localizes the objects
-         "localizer" : Localizer,
-
-         // This one generate actions from a quick hand format
-         "actionGenerator" : actionConstructorRegistry,
-
-         // This one generates quick input array
-         "inputRequester" : Request,
-    },
-    "displayComponent" : {
-
-         // The parsed text is in an array of DisplayComponents
-         // For adaptability with various renderer
-
-         "ParentClass" : DisplayComponent,
-         TextComponent,
-         IconComponent,
-         ReferenceComponent,
-         ImageComponent,
-         SymbolComponent,
-    },
-    "registry" : {
-         // Registries are hard coded data
-         // some are enums, some are const key -> value
-
-        actionRegistry,
-
-        cardDataRegistry,
-
-        effectDataRegistry,
-        effectTypeRegistry,
-
-        operatorRegistry,
-        operatorDataRegistry,
-
-        rarityRegistry,
-        rarityDataRegistry,
-
-        subtypeRegistry,
-
-        zoneRegistry,
-        zoneDataRegistry,
-    },
-    "defaultSetting" : settings,
-    "mod" : {
-
-         //These are the class a mod must follows
-         // and extends from
-
-        GameModule,
-        ParserModule,
-    },
-};
+import {queenSystemComponents} from "qpremake"
+const {Renderer} = queenSystemComponents.systemComponent
 ```
 
-For a cheat sheet, here are the properties of systemComponent:
+This class is as follows:
+
+```ts
+abstract class Renderer {
+    abstract gameStart(
+            s: LocalizedSystem, 
+            callback: () => any
+        ) : void;
+
+    abstract turnStart(
+        s: LocalizedSystem, 
+        callback: (a? : Action) => any
+        ) : void;
+
+    abstract update(
+        phase: TurnPhase, 
+        s: LocalizedSystem, 
+        a: Action, 
+        callback: () => any
+        ) : void;
+
+    abstract requestInput(
+        inputSet: inputData[], 
+        phase: TurnPhase, 
+        s: LocalizedSystem, 
+        a: Action, 
+        callback: (
+            input : inputData
+            ) => any
+        ) : void;
+}
+```
+
+These methods are called appropriately. There shoudl be guide comments when one implement these.
+
+Notably, the system is paused after calling one of these. Sort of *"handing control over"* to the renderer. The system only resumes after **the provided callback()** is called.
+
+One can make a new renderer to whatever front end frame work one likes by implementing this class.
+
+### Saving and loading game state:
+
+Game state or more specifically is an instance of ```SerializedSystem```. 
+
+At any time, this is obtained via:
+
+```ts
+s.toSerialized()
+```
+
+This file can then be JSON and saved to a text file.
+
+Loading said file is possible via the normal ```load()``` functionn before start:
+
+```ts
+const data = fs.readFileSync(...) as SerializedSystem
+s.load(data)
+```
+
+### Display texts
+
+All texts provided via a ```Localized``` object is an array of ```Display components``` to guide the injection of icons and text formatting.
+
+Those objects are available via:
+
+```ts
+import {queenSystemComponents} from "qpremake"
+const {TextComponent, IconComponent, ImageComponent} = queenSystemComponents.displayComponent
+```
 
-1. gameComponent : holds various game component classes
-2. systemComponent : holds various services to operate on data
-3. displayComponent : holds display parsed segements
-4. registry : holds data
-5. defaultSetting : holds the default setting
-6. mod : holds what format mods must follows
+### Handling inputs
 
-### Utils
+Whenever an action wants an input (say, when a card says choose a card, choose a space on the board, etc). The method ```requestInput``` of the renderer is called.
 
-Utils is a custom util object which hodl various utility methods. ts should suggest what it has already. 
+All possible inputs is in the ```inputSet``` components, all these are in one specific type (a card, a spot on the field, a number, etc).
 
-## Pending Tasks
+Inputs if required multiple are done sequentially. If a card wants the player to select 2 spots in the field, the request input function will be called twice for each.
+
+At the start of the turn, there is also the need to select a **turn action**. Thus the ```turnStart``` method also have an option to continue with a player action.
+
+
+# Modding
+
+This section is dedicated to whomever wants to mod the system (add more cards, more localizations, etc).
+
+## What is a mod?
+
+Mods are ts files that changes the data od the system
+
+There are 2 types:
+
+1. gameplay mods, these can change what effects, cards, zones, characters, ... are possible
+2. parsing mods, these changes the behavior of how card text are parse and localized. (If one specifically target changing localization, look in a localization file.)
+
+## How mods are run
+
+In the loading step of the system, mods are loaded and can change various registries via an API interface.
+
+## How to make a mod
+
+There are 2 ways. One either can clone / fork [the github rerpo](https://github.com/BlueG15/qpRemake).
+Or add stuff after installing the system in the setting.
+
+Both are essentially the same but you appear on the npm of the project under contribution :). 
+
+## Adding a mod
+
+In the settings of the system, there is the field ```mods```, which stores an array of strings to code files inside the mod folder ("One can change this too").
+
+A mod file exports default an implementation to the class ```mod``` available via:
+
+```ts
+import {queenSystemComponents} from "qpremake"
+const {GameModule, ParserModule} = queenSystemComponents.mod
+```
+
+This game module is just this:
+
+```ts
+class GameModule {
+    //should override, call upon load
+    load(API : registryAPI) : void {}
+}
+```
+
+Very simple. That registryAPI looks like this:
+
+```ts
+interface registryAPI {
+    //SAFE registry edit
+    //There is also the registry for effectType and Action, but those doesnt need to be modified
+    registry_edit_card(key : string, value : cardData) : void;
+    registry_edit_effect_data(key : string, data : effectData) : void;
+    registry_edit_effect_class(
+        key : string, 
+        constructors : typeof Effect | Record<string, typeof Effect>
+    ) : void;
+    registry_edit_effect(
+        key : string,
+        data : effectData,
+        constructors : typeof Effect | Record<string, typeof Effect>
+    ): void
+    registry_edit_effect_subtype(
+        key : string, 
+        constructor : typeof EffectSubtype
+    ) : void;
+    
+    registry_edit_zone_data(key : string, data : zoneData) : void;
+    registry_edit_zone_class(
+        key : string,
+        constructor : typeof Zone 
+    ) : void;
+    registry_edit_zone(
+        key : string, 
+        data : zoneData,
+        constructor : typeof Zone 
+    ) : void;
+
+    //UNSFAFE registry edit
+    registry_edit_custom_action_handler(
+        actionIDs : number[],
+        handlerFunc : ((a : Action, system : queenSystem) => undefined | void | Action[])
+    ) : void;
+   
+    //localization edit
+    registry_edit_localization(language : string, key : string, val : string) : void;
+
+    //... more coming
+}
+```
+
+These methods are passed into the mod for editting. 
+
+## Example: Adding a custom effect
+
+Effect have 2 parts, like almost every other gameplay components.
+
+Those 2 parts are **Class part** and **Data part**
+
+Those 2 parts are available via ```registry_edit_effect_data``` and ```registry_edit_effect_class``` respectively.
+
+or both at the same time via ```registry_edit_effect```.
+
+For this simple example, we ignore the data for now and implements the class part (data can be hard coded via the specified **effectData**) type.
+
+We import the ```Effect``` class:
+
+```ts
+import {queenSystemComponents} from "qpremake"
+const {Effect} = queenSystemComponents.gameComponent
+```
+
+And add it in:
+
+```ts
+class CustomEffect extends Effect {
+    // Your implementation here
+}
+
+export default class customMod extends GameModule {
+    override load(API : registryAPI){
+        API.registry_edit_effect_class(
+            "customEffect1", 
+            CustomEffect
+        )
+    }
+}
+```
 
-1. make effects
-2. add more actions (if needed)
-3. update the effect registry
-4. update the card registry
-5. add a deck registry
-6. make level / wave control
-7. make a good renderer
+What an effect does and how to implement its behavior is in the **make effect** section below.
 
+Importantly, one **MUST NOT** override the contructor.
 
+# Project contribution
 
 ## Current progress:
 

package/lib/_queenSystem/renderer/rendererInterface.d.ts

@@ -1,7 +1,25 @@
 import type { Action } from "../handler/actionGenrator";
 import type { inputDataSpecific, inputType, TurnPhase } from "../../data/systemRegistry";
 import type { LocalizedSystem } from "../../types/abstract/serializedGameComponents/Localized";
-export interface qpRenderer {
+export declare abstract class qpRenderer {
+    abstract gameStart(s: LocalizedSystem, callback: () => any): void;
+    abstract turnStart(s: LocalizedSystem, callback: (a?: Action) => any): void;
+    /**
+     * update is called upon every game update for every phase for whatever reason
+     * right after applying the action to the game states
+     * call callback() to conttinue */
+    abstract update(phase: TurnPhase, s: LocalizedSystem, a: Action, callback: () => any): void;
+    /**
+     * request input is called wheever the system is processing an action and wants a user input
+     * @param inputSet : a array of allowed inputs
+     * @param phase : phase
+     * @param s : system state
+     * @param a : action
+     * @param callback : callback function, call to continue
+     */
+    abstract requestInput<T extends inputType>(inputSet: inputDataSpecific<T>[], phase: TurnPhase, s: LocalizedSystem, a: Action, callback: (input: inputDataSpecific<T>) => any): void;
+}
+export declare class sampleRenderer extends qpRenderer {
     gameStart(s: LocalizedSystem, callback: () => any): void;
     turnStart(s: LocalizedSystem, callback: (a?: Action) => any): void;
     update(phase: TurnPhase, s: LocalizedSystem, a: Action, callback: () => any): void;

package/lib/_queenSystem/renderer/rendererInterface.js

@@ -1,2 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.sampleRenderer = exports.qpRenderer = void 0;
+class qpRenderer {
+}
+exports.qpRenderer = qpRenderer;
+class sampleRenderer extends qpRenderer {
+    gameStart(s, callback) {
+        console.log("Game start called");
+        return callback();
+    }
+    turnStart(s, callback) {
+        console.log(`Turn start called`);
+        return callback();
+    }
+    update(phase, s, a, callback) {
+        console.log(`Update called on phase ${phase}, on action ${a.type}`);
+        return callback();
+    }
+    requestInput(inputSet, phase, s, a, callback) {
+        console.log(`Input requested, continue with 1st input`);
+        return callback(inputSet[0]);
+    }
+}
+exports.sampleRenderer = sampleRenderer;

package/lib/index.d.ts

@@ -29,6 +29,7 @@ import LockEffect from "./types/effects/effectTypes/lockEffect";
 import ManualEffect from "./types/effects/effectTypes/manualEffect";
 import PassiveEffect from "./types/effects/effectTypes/passiveEffect";
 import TriggerEffect from "./types/effects/effectTypes/triggerEffect";
+import { defaultSetting, Setting } from "./types/abstract/gameComponents/settings";
 import { SerializedCard, Serialized_effect, SerializedPlayer, SerializedSystem, SerializedZone } from "./types/abstract/serializedGameComponents/Gamestate";
 import { LocalizedAction, LocalizedCard, LocalizedEffect, LocalizedPlayer, LocalizedSystem, LocalizedZone } from "./types/abstract/serializedGameComponents/Localized";
 import Parser from "./effectTextParser";
@@ -43,6 +44,7 @@ import { operatorRegistry } from "./data/operatorRegistry";
 import { rarityRegistry } from "./data/rarityRegistry";
 import { zoneRegistry } from "./data/zoneRegistry";
 import subtypeRegistry from "./data/subtypeRegistry";
+import { qpRenderer, sampleRenderer } from "./_queenSystem/renderer/rendererInterface";
 declare const queenSystemComponents: {
     gameComponent: {
         Action: typeof Action_class;
@@ -99,9 +101,9 @@ declare const queenSystemComponents: {
         };
     };
     systemComponent: {
-        effectTextParser: typeof Parser;
-        localizer: typeof Localizer;
-        actionGenerator: {
+        EffectTextParser: typeof Parser;
+        Localizer: typeof Localizer;
+        ActionGenerator: {
             readonly error: (cause: import("./data/systemRegistry").identificationInfo) => Action_class<[import("./data/systemRegistry").identificationInfo_none], never, {}>;
             readonly a_null: (cause: import("./data/systemRegistry").identificationInfo) => Action_class<[import("./data/systemRegistry").identificationInfo_none], never, {}>;
             readonly a_negate_action: (cause: import("./data/systemRegistry").identificationInfo) => Action_class<[import("./data/systemRegistry").identificationInfo_none], never, {}>;
@@ -2337,7 +2339,7 @@ declare const queenSystemComponents: {
                 delayEID: string;
             }>;
         };
-        inputRequester: {
+        InputRequester: {
             field(s: import("./data/systemRegistry").dry_system, c: import("./types/misc").Player_specific | import("./types/misc").Positionable): {
                 s: import("./data/systemRegistry").dry_system;
                 zones: import("./data/systemRegistry").dry_zone[];
@@ -2391,7 +2393,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -2503,7 +2505,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -2585,7 +2587,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -2652,7 +2654,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -2741,7 +2743,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -2853,7 +2855,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -2935,7 +2937,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -3002,7 +3004,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -3091,7 +3093,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -3203,7 +3205,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -3285,7 +3287,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -3352,7 +3354,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -3441,7 +3443,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -3553,7 +3555,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -3635,7 +3637,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -3702,7 +3704,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -3791,7 +3793,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -3903,7 +3905,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -3985,7 +3987,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -4052,7 +4054,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -4141,7 +4143,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -4253,7 +4255,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -4335,7 +4337,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -4402,7 +4404,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -4491,7 +4493,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     })[];
@@ -4603,7 +4605,7 @@ declare const queenSystemComponents: {
                         statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                         totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                        setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                        setting: import("./types/misc").Readonly_recur<Setting>;
                     } & {
                         ___zone: import("./data/systemRegistry").dry_zone;
                     }) => boolean): /*elided*/ any;
@@ -4685,7 +4687,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         })[];
@@ -4752,7 +4754,7 @@ declare const queenSystemComponents: {
                             statusEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             effects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
                             totalEffects: ReadonlyArray<import("./data/systemRegistry").dry_effect>;
-                            setting: import("./types/misc").Readonly_recur<import("./types/abstract/gameComponents/settings").Setting>;
+                            setting: import("./types/misc").Readonly_recur<Setting>;
                         } & {
                             ___zone: import("./data/systemRegistry").dry_zone;
                         }) => boolean): /*elided*/ any;
@@ -4796,6 +4798,8 @@ declare const queenSystemComponents: {
                 many<L extends number>(l: L, e?: Effect<any>): import("./_queenSystem/handler/actionInputGenerator").inputRequester_multiple<import("./data/systemRegistry").inputType.number, L>;
             };
         };
+        Renderer: typeof qpRenderer;
+        SampleRenderer: typeof sampleRenderer;
     };
     displayComponent: {
         ParentClass: typeof DisplayComponent;
@@ -6318,7 +6322,10 @@ declare const queenSystemComponents: {
         zoneRegistry: typeof zoneRegistry;
         zoneDataRegistry: Record<"z_system" | "z_drop" | "z_void" | "z_deck" | "z_field" | "z_grave" | "z_hand" | "z_storage" | "z_ability", import("./data/zoneRegistry").zoneData>;
     };
-    defaultSetting: import("./types/abstract/gameComponents/settings").defaultSetting;
+    setting: {
+        defaultSetting: typeof defaultSetting;
+        settingClass: typeof Setting;
+    };
     mod: {
         GameModule: typeof GameModule;
         ParserModule: typeof ParserModule;
@@ -6326,16 +6333,3 @@ declare const queenSystemComponents: {
 };
 export { queenSystem, queenSystemComponents, Utils as queenSystemUtils };
 export default queenSystem;
-/**
- * Usage :
- *
- *  let setting = new defaultSetting()
-    let renderer = new qpTerminalRenderer()
-    let s = new queenSystem(setting, renderer)
-    renderer.bind(s)
-    s.addPlayers("player", operatorRegistry.o_esper)
-    s.addPlayers("enemy", operatorRegistry.o_null)
-    await s.load()
-
-    renderer.start();
- */

package/lib/index.js

@@ -82,7 +82,7 @@ const manualEffect_1 = __importDefault(require("./types/effects/effectTypes/manu
 const passiveEffect_1 = __importDefault(require("./types/effects/effectTypes/passiveEffect"));
 const triggerEffect_1 = __importDefault(require("./types/effects/effectTypes/triggerEffect"));
 // default settings
-const settings_1 = __importDefault(require("./types/abstract/gameComponents/settings"));
+const settings_1 = require("./types/abstract/gameComponents/settings");
 // serialized 
 const Gamestate_1 = require("./types/abstract/serializedGameComponents/Gamestate");
 // localized
@@ -108,6 +108,7 @@ const operatorRegistry_1 = __importStar(require("./data/operatorRegistry"));
 const rarityRegistry_1 = __importStar(require("./data/rarityRegistry"));
 const zoneRegistry_1 = __importStar(require("./data/zoneRegistry"));
 const subtypeRegistry_1 = __importDefault(require("./data/subtypeRegistry"));
+const rendererInterface_1 = require("./_queenSystem/renderer/rendererInterface");
 const queenSystemComponents = {
     "gameComponent": {
         "Action": actionGenrator_1.Action_class,
@@ -163,10 +164,12 @@ const queenSystemComponents = {
         }
     },
     "systemComponent": {
-        "effectTextParser": effectTextParser_1.default,
-        "localizer": localizationHandler_1.default,
-        "actionGenerator": actionGenrator_1.actionConstructorRegistry,
-        "inputRequester": actionInputRequesterGenerator_1.default,
+        "EffectTextParser": effectTextParser_1.default,
+        "Localizer": localizationHandler_1.default,
+        "ActionGenerator": actionGenrator_1.actionConstructorRegistry,
+        "InputRequester": actionInputRequesterGenerator_1.default,
+        "Renderer": rendererInterface_1.qpRenderer,
+        "SampleRenderer": rendererInterface_1.sampleRenderer,
     },
     "displayComponent": {
         "ParentClass": parser_1.DisplayComponent,
@@ -189,7 +192,10 @@ const queenSystemComponents = {
         zoneRegistry: zoneRegistry_1.zoneRegistry,
         zoneDataRegistry: zoneRegistry_1.default,
     },
-    "defaultSetting": settings_1.default,
+    "setting": {
+        defaultSetting: settings_1.defaultSetting,
+        "settingClass": settings_1.Setting,
+    },
     "mod": {
         GameModule: gameModule_1.default,
         ParserModule: effectTextParserModule_1.ParserModule,
@@ -197,16 +203,3 @@ const queenSystemComponents = {
 };
 exports.queenSystemComponents = queenSystemComponents;
 exports.default = queenSystem_1.default;
-/**
- * Usage :
- *
- *  let setting = new defaultSetting()
-    let renderer = new qpTerminalRenderer()
-    let s = new queenSystem(setting, renderer)
-    renderer.bind(s)
-    s.addPlayers("player", operatorRegistry.o_esper)
-    s.addPlayers("enemy", operatorRegistry.o_null)
-    await s.load()
-
-    renderer.start();
- */

package/lib/types/abstract/gameComponents/settings.d.ts

@@ -27,31 +27,31 @@ declare enum auto_input_option {
     last = 3,//auto chooses the last option
     random = 4
 }
-interface Setting {
-    languageID: supporttedLanguages;
-    dynamic_id_len: number;
-    id_style: id_style;
-    id_separator: string;
-    max_id_count: number;
-    effectFolder: string;
-    effectFiles: string[];
-    mods: string[];
-    modFolder_game: string;
-    modFolder_parser: string;
-    localizationFolder: string;
-    ignore_undefined_subtype: boolean;
-    ignore_undefined_effect: boolean;
-    show_negative_stat: boolean;
-    auto_input: auto_input_option;
-    ignore_invalid_partition_mapping: boolean;
-    global_partition_setting: partitionSetting;
-    default_partition_behavior: partitionActivationBehavior;
-    parser_modules: string[];
-    singleton_effect_subtype: boolean;
-    singleton_effect_type: boolean;
-    spawn_instanced_zones_per_player: boolean;
+declare abstract class Setting {
+    abstract languageID: supporttedLanguages;
+    abstract dynamic_id_len: number;
+    abstract id_style: id_style;
+    abstract id_separator: string;
+    abstract max_id_count: number;
+    abstract effectFolder: string;
+    abstract effectFiles: string[];
+    abstract mods: string[];
+    abstract modFolder_game: string;
+    abstract modFolder_parser: string;
+    abstract localizationFolder: string;
+    abstract ignore_undefined_subtype: boolean;
+    abstract ignore_undefined_effect: boolean;
+    abstract show_negative_stat: boolean;
+    abstract auto_input: auto_input_option;
+    abstract ignore_invalid_partition_mapping: boolean;
+    abstract global_partition_setting: partitionSetting;
+    abstract default_partition_behavior: partitionActivationBehavior;
+    abstract parser_modules: string[];
+    abstract singleton_effect_subtype: boolean;
+    abstract singleton_effect_type: boolean;
+    abstract spawn_instanced_zones_per_player: boolean;
 }
-declare class defaultSetting implements Setting {
+declare class defaultSetting extends Setting {
     languageID: supporttedLanguages;
     mods: never[];
     dynamic_id_len: number;

package/lib/types/abstract/gameComponents/settings.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.id_style = exports.auto_input_option = exports.supporttedLanguages = exports.defaultSetting = exports.partitionSetting = void 0;
+exports.id_style = exports.auto_input_option = exports.supporttedLanguages = exports.defaultSetting = exports.Setting = exports.partitionSetting = void 0;
 const cardRegistry_1 = require("../../../data/cardRegistry");
 var partitionSetting;
 (function (partitionSetting) {
@@ -33,8 +33,12 @@ var auto_input_option;
     auto_input_option[auto_input_option["last"] = 3] = "last";
     auto_input_option[auto_input_option["random"] = 4] = "random";
 })(auto_input_option || (exports.auto_input_option = auto_input_option = {}));
-class defaultSetting {
+class Setting {
+}
+exports.Setting = Setting;
+class defaultSetting extends Setting {
     constructor() {
+        super(...arguments);
         this.languageID = supporttedLanguages.English;
         this.mods = []; //no mods
         this.dynamic_id_len = 5;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "qpremake",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "Remake of the qp engine in ts / js, with moddability in mind",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {
     "test": "node ./lib/testFile.js",
-    "build": "tsc",
+    "build": "(IF EXIST \".\\lib\" RD /S /Q \".\\lib\") && tsc",
     "dev": "npm run build && npm run test",
     "prepublishOnly" : "npm run build"
   },