@gamepark/rules-api 6.24.2 → 6.25.0

package/dist/material/moves/items/Shuffle.js.map

@@ -1 +1 @@
-{"version":3,"file":"Shuffle.js","sourceRoot":"","sources":["../../../../src/material/moves/items/Shuffle.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAG7C,wCAAsC;AA2BtC,SAAgB,SAAS,CAAuD,IAA2B;IACzG,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,2BAAY,CAAC,OAAO,CAAA;AAC9E,CAAC;AAFD,8BAEC;AAOD,SAAgB,iBAAiB,CAC/B,IAAO;IAEP,OAAO,UAAC,IAA2B;QACjC,OAAA,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;IAAzC,CAAyC,CAAA;AAC7C,CAAC;AALD,8CAKC;AAOD,SAAgB,mBAAmB,CAAuD,IAA2B;IACnH,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAE,IAA6B,CAAC,UAAU,CAAC,CAAA;AACpF,CAAC;AAFD,kDAEC"}
+{"version":3,"file":"Shuffle.js","sourceRoot":"","sources":["../../../../src/material/moves/items/Shuffle.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAG7C,wCAAsC;AAsBtC;;;;GAIG;AACH,SAAgB,SAAS,CAAuD,IAA2B;IACzG,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,2BAAY,CAAC,OAAO,CAAA;AAC9E,CAAC;AAFD,8BAEC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,IAAO;IAEP,OAAO,UAAC,IAA2B;QACjC,OAAA,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;IAAzC,CAAyC,CAAA;AAC7C,CAAC;AALD,8CAKC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAuD,IAA2B;IACnH,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAE,IAA6B,CAAC,UAAU,CAAC,CAAA;AACpF,CAAC;AAFD,kDAEC"}

package/dist/material/moves/local/CloseTutorialPopup.d.ts

@@ -1,8 +1,16 @@
 import { MoveKind } from '../MoveKind';
 import { LocalMoveType } from './LocalMove';
 import { MaterialMove } from '../MaterialMove';
+/**
+ * Move object to close the popup during a tutorial
+ */
 export type CloseTutorialPopup = {
     kind: MoveKind.LocalMove;
     type: LocalMoveType.CloseTutorialPopup;
 };
+/**
+ * Type guard to test if a {@link MaterialMove} is a {@link CloseTutorialPopup} move
+ * @param move Move to test
+ * @returns true if move is a {@link CloseTutorialPopup}
+ */
 export declare function isCloseTutorialPopup(move: MaterialMove): move is CloseTutorialPopup;

package/dist/material/moves/local/CloseTutorialPopup.js

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isCloseTutorialPopup = void 0;
 var MoveKind_1 = require("../MoveKind");
 var LocalMove_1 = require("./LocalMove");
+/**
+ * Type guard to test if a {@link MaterialMove} is a {@link CloseTutorialPopup} move
+ * @param move Move to test
+ * @returns true if move is a {@link CloseTutorialPopup}
+ */
 function isCloseTutorialPopup(move) {
     return move.kind === MoveKind_1.MoveKind.LocalMove && move.type === LocalMove_1.LocalMoveType.CloseTutorialPopup;
 }

package/dist/material/moves/local/CloseTutorialPopup.js.map

@@ -1 +1 @@
-{"version":3,"file":"CloseTutorialPopup.js","sourceRoot":"","sources":["../../../../src/material/moves/local/CloseTutorialPopup.ts"],"names":[],"mappings":";;;AAAA,wCAAsC;AACtC,yCAA2C;AAgB3C,SAAgB,oBAAoB,CAAC,IAAkB;IACrD,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAa,CAAC,kBAAkB,CAAA;AAC3F,CAAC;AAFD,oDAEC"}
+{"version":3,"file":"CloseTutorialPopup.js","sourceRoot":"","sources":["../../../../src/material/moves/local/CloseTutorialPopup.ts"],"names":[],"mappings":";;;AAAA,wCAAsC;AACtC,yCAA2C;AAW3C;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,IAAkB;IACrD,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAa,CAAC,kBAAkB,CAAA;AAC3F,CAAC;AAFD,oDAEC"}

package/dist/material/moves/local/DisplayHelp.d.ts

@@ -2,12 +2,21 @@ import { MaterialItem } from '../../items';
 import { Location } from '../../location';
 import { MoveKind } from '../MoveKind';
 import { LocalMoveType } from './LocalMove';
+/**
+ * Common type for the moves that display a help dialog
+ */
 export type HelpDisplay<P extends number = number, M extends number = number, L extends number = number, RuleId extends number = number> = MaterialHelpDisplay<P, M, L> | LocationHelpDisplay<P, L> | RulesHelpDisplay<RuleId>;
+/**
+ * Type of help dialogs that can be opened
+ */
 export declare enum HelpDisplayType {
     Material = 1,
     Location = 2,
     Rules = 3
 }
+/**
+ * Data structure describing a help dialog about a {@link MaterialItem}
+ */
 export type MaterialHelpDisplay<P extends number = number, M extends number = number, L extends number = number> = {
     type: typeof HelpDisplayType.Material;
     itemType: M;
@@ -15,14 +24,23 @@ export type MaterialHelpDisplay<P extends number = number, M extends number = nu
     displayIndex?: number;
     item: Partial<MaterialItem<P, L>>;
 };
+/**
+ * Data structure describing a help dialog about a {@link Location}
+ */
 export type LocationHelpDisplay<P extends number = number, L extends number = number> = {
     type: typeof HelpDisplayType.Location;
     location: Location<P, L>;
 };
+/**
+ * Data structure describing a help dialog about a point in the rules of a game
+ */
 export type RulesHelpDisplay<RuleId extends number = number> = {
     type: typeof HelpDisplayType.Rules;
     ruleId: RuleId;
 };
+/**
+ * Move object to display a help dialog
+ */
 export type DisplayHelp<P extends number = number, M extends number = number, L extends number = number> = {
     kind: MoveKind.LocalMove;
     type: typeof LocalMoveType.DisplayHelp;

package/dist/material/moves/local/DisplayHelp.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HelpDisplayType = void 0;
+/**
+ * Type of help dialogs that can be opened
+ */
 var HelpDisplayType;
 (function (HelpDisplayType) {
     HelpDisplayType[HelpDisplayType["Material"] = 1] = "Material";

package/dist/material/moves/local/DisplayHelp.js.map

@@ -1 +1 @@
-{"version":3,"file":"DisplayHelp.js","sourceRoot":"","sources":["../../../../src/material/moves/local/DisplayHelp.ts"],"names":[],"mappings":";;;AAgBA,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,6DAAY,CAAA;IAAE,6DAAQ,CAAA;IAAE,uDAAK,CAAA;AAC/B,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B"}
+{"version":3,"file":"DisplayHelp.js","sourceRoot":"","sources":["../../../../src/material/moves/local/DisplayHelp.ts"],"names":[],"mappings":";;;AAaA;;GAEG;AACH,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,6DAAY,CAAA;IAAE,6DAAQ,CAAA;IAAE,uDAAK,CAAA;AAC/B,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B"}

package/dist/material/moves/local/DropItem.d.ts

@@ -1,10 +1,19 @@
 import { MoveKind } from '../MoveKind';
 import { LocalMoveType } from './LocalMove';
+/**
+ * Move object to remind when a player has dropped an item
+ */
 export type DropItem<M extends number = number> = {
     kind: MoveKind.LocalMove;
     type: typeof LocalMoveType.DropItem;
     item: DisplayedItem<M>;
 };
+/**
+ * Data structure of an item displayed on screen
+ * @property type the type of item
+ * @property index index of the item
+ * @property displayIndex when the item has a quantity, the index of the specific item inside the quantity (otherwise 0)
+ */
 export type DisplayedItem<M extends number = number> = {
     type: M;
     index: number;

package/dist/material/moves/local/LocalMove.d.ts

@@ -2,7 +2,13 @@ import { CloseTutorialPopup } from './CloseTutorialPopup';
 import { DisplayHelp } from './DisplayHelp';
 import { DropItem } from './DropItem';
 import { SetTutorialStep } from './SetTutorialStep';
+/**
+ * Common type for all the moves designed to be local (not sent to the server)
+ */
 export type LocalMove<Player extends number = number, MaterialType extends number = number, LocationType extends number = number> = DisplayHelp<Player, MaterialType, LocationType> | DropItem<MaterialType> | SetTutorialStep | CloseTutorialPopup;
+/**
+ * Types of local moves
+ */
 export declare enum LocalMoveType {
     DisplayHelp = 1,
     DropItem = 2,

package/dist/material/moves/local/LocalMove.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalMoveType = void 0;
+/**
+ * Types of local moves
+ */
 var LocalMoveType;
 (function (LocalMoveType) {
     LocalMoveType[LocalMoveType["DisplayHelp"] = 1] = "DisplayHelp";

package/dist/material/moves/local/LocalMove.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalMove.js","sourceRoot":"","sources":["../../../../src/material/moves/local/LocalMove.ts"],"names":[],"mappings":";;;AAiBA,IAAY,aAEX;AAFD,WAAY,aAAa;IACvB,+DAAe,CAAA;IAAE,yDAAQ,CAAA;IAAE,uEAAe,CAAA;IAAE,6EAAkB,CAAA;AAChE,CAAC,EAFW,aAAa,6BAAb,aAAa,QAExB"}
+{"version":3,"file":"LocalMove.js","sourceRoot":"","sources":["../../../../src/material/moves/local/LocalMove.ts"],"names":[],"mappings":";;;AAcA;;GAEG;AACH,IAAY,aAEX;AAFD,WAAY,aAAa;IACvB,+DAAe,CAAA;IAAE,yDAAQ,CAAA;IAAE,uEAAe,CAAA;IAAE,6EAAkB,CAAA;AAChE,CAAC,EAFW,aAAa,6BAAb,aAAa,QAExB"}

package/dist/material/moves/local/SetTutorialStep.d.ts

@@ -1,9 +1,17 @@
 import { MoveKind } from '../MoveKind';
 import { LocalMoveType } from './LocalMove';
 import { MaterialMove } from '../MaterialMove';
+/**
+ * Move object to set a tutorial to a specific step
+ */
 export type SetTutorialStep = {
     kind: MoveKind.LocalMove;
     type: LocalMoveType.SetTutorialStep;
     step: number;
 };
+/**
+ * Type guard to test if a {@link MaterialMove} is a {@link SetTutorialStep} move
+ * @param move Move to test
+ * @returns true if move is a {@link SetTutorialStep}
+ */
 export declare function isSetTutorialStep(move: MaterialMove): move is SetTutorialStep;

package/dist/material/moves/local/SetTutorialStep.js

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSetTutorialStep = void 0;
 var MoveKind_1 = require("../MoveKind");
 var LocalMove_1 = require("./LocalMove");
+/**
+ * Type guard to test if a {@link MaterialMove} is a {@link SetTutorialStep} move
+ * @param move Move to test
+ * @returns true if move is a {@link SetTutorialStep}
+ */
 function isSetTutorialStep(move) {
     return move.kind === MoveKind_1.MoveKind.LocalMove && move.type === LocalMove_1.LocalMoveType.SetTutorialStep;
 }

package/dist/material/moves/local/SetTutorialStep.js.map

@@ -1 +1 @@
-{"version":3,"file":"SetTutorialStep.js","sourceRoot":"","sources":["../../../../src/material/moves/local/SetTutorialStep.ts"],"names":[],"mappings":";;;AAAA,wCAAsC;AACtC,yCAA2C;AAiB3C,SAAgB,iBAAiB,CAAC,IAAkB;IAClD,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAa,CAAC,eAAe,CAAA;AACxF,CAAC;AAFD,8CAEC"}
+{"version":3,"file":"SetTutorialStep.js","sourceRoot":"","sources":["../../../../src/material/moves/local/SetTutorialStep.ts"],"names":[],"mappings":";;;AAAA,wCAAsC;AACtC,yCAA2C;AAY3C;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,IAAkB;IAClD,OAAO,IAAI,CAAC,IAAI,KAAK,mBAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAa,CAAC,eAAe,CAAA;AACxF,CAAC;AAFD,8CAEC"}

package/dist/material/rules/MaterialRulesPart.d.ts

@@ -4,24 +4,100 @@ import { MaterialGame } from '../MaterialGame';
 import { GameMemory, PlayerMemory } from '../memory';
 import { CustomMove, ItemMove, MaterialMove, MaterialMoveBuilder, RuleMove } from '../moves';
 import { RuleStep } from './RuleStep';
+/**
+ * When you implement the rules of a game using {@link MaterialRules}, the rules are split into small parts.
+ * This is the base class to implement one part of the rules.
+ * The constructor cannot be changed as the class is instantiated by {@link MaterialRules}.
+ */
 export declare abstract class MaterialRulesPart<Player extends number = number, MaterialType extends number = number, LocationType extends number = number> extends Rules<MaterialGame<Player, MaterialType, LocationType>, MaterialMove<Player, MaterialType, LocationType>, Player> {
+    /**
+     * Helper function to get a {@link Material} instance to work on some item type in the game.
+     * @param type Type of material
+     * @returns {Material} the material instance
+     */
     material(type: MaterialType): Material<Player, MaterialType, LocationType>;
+    /**
+     * This function is called immediately before an {@link ItemMove} is played.
+     * @param _move The move which is going to be played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     beforeItemMove(_move: ItemMove<Player, MaterialType, LocationType>, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * This function is called immediately after an {@link ItemMove} is played.
+     * @param _move The move which has just been played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     afterItemMove(_move: ItemMove<Player, MaterialType, LocationType>, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * This function is called immediately after the {@link RuleMove} that started this rules step was played
+     * @param _move The move which has just been played
+     * @param _previousRule The step of the rules immediately before this one started
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     onRuleStart<RuleId extends number>(_move: RuleMove<Player, RuleId>, _previousRule?: RuleStep, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * This function is called just before a {@link RuleMove} that leave this rules step is played.
+     *
+     * BEWARE: any consequences returned here will happen inside the next rule step. Usually we only clean the memory here.
+     *
+     * @param _move The move which is going to be played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     onRuleEnd<RuleId extends number>(_move: RuleMove<Player, RuleId>, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * This function is called when a {@link CustomMove} is played.
+     * @param _move The move
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     onCustomMove(_move: CustomMove, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * @deprecated replace this.rules().[the function] with: this.[the function]
+     */
     rules(): typeof MaterialMoveBuilder;
     startPlayerTurn: <P extends number = number, R extends number = number>(id: R, player: P) => import("../moves").StartPlayerTurn<P, R>;
     startSimultaneousRule: <P extends number = number, R extends number = number>(id: R, players?: P[] | undefined) => import("../moves").StartSimultaneousRule<P, R>;
     startRule: <R extends number = number>(id: R) => import("../moves").StartRule<R>;
     customMove: <Type extends number = number>(type: Type, data?: any) => CustomMove;
     endGame: () => import("../moves").EndGame;
+    /**
+     * Utility function to access the memory tool for the game or on player.
+     * this.game.memory can be used to store any data that is not available through the state of the material, or current rule.
+     *
+     * @param player Optional, identifier of the player if we want to manipulate a specific player's memory
+     * @returns {@link GameMemory} or {@link PlayerMemory} utility
+     * @protected
+     */
     protected getMemory(player?: Player): GameMemory<Player> | PlayerMemory<Player>;
+    /**
+     * Save a new value inside the memory.
+     * @param key The key to index the memorized value.
+     * @param value Any JSON serializable value to store, or a function that takes previous stored value and returns the new value to store.
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     memorize<T = any>(key: keyof any, value: T | ((lastValue: T) => T), player?: Player): void;
+    /**
+     * Retrieve the value memorized under a given key.
+     * Shortcut for this.game.memory[key] or this.game.memory[key][player]
+     *
+     * @param key Key under which the memory is store. Usually a value of a numeric enum named "Memory".
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     remind<T = any>(key: keyof any, player?: Player): T;
+    /**
+     * Delete a value from the memory
+     * @param key Key of the value to delete
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     forget(key: keyof any, player?: Player): void;
 }
+/**
+ * Creator interface for a class that extends {@link MaterialRulesPart} with the same constructor.
+ */
 export interface MaterialRulesPartCreator<Player extends number = number, MaterialType extends number = number, LocationType extends number = number> {
     new (game: MaterialGame<Player, MaterialType, LocationType>): MaterialRulesPart<Player, MaterialType, LocationType>;
 }

package/dist/material/rules/MaterialRulesPart.js

@@ -20,7 +20,12 @@ var Rules_1 = require("../../Rules");
 var items_1 = require("../items");
 var memory_1 = require("../memory");
 var moves_1 = require("../moves");
-var MaterialRulesPart = (function (_super) {
+/**
+ * When you implement the rules of a game using {@link MaterialRules}, the rules are split into small parts.
+ * This is the base class to implement one part of the rules.
+ * The constructor cannot be changed as the class is instantiated by {@link MaterialRules}.
+ */
+var MaterialRulesPart = /** @class */ (function (_super) {
     __extends(MaterialRulesPart, _super);
     function MaterialRulesPart() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
@@ -31,37 +36,104 @@ var MaterialRulesPart = (function (_super) {
         _this.endGame = moves_1.MaterialMoveBuilder.endGame;
         return _this;
     }
+    /**
+     * Helper function to get a {@link Material} instance to work on some item type in the game.
+     * @param type Type of material
+     * @returns {Material} the material instance
+     */
     MaterialRulesPart.prototype.material = function (type) {
-        var _a;
-        return new items_1.Material(type, Array.from(((_a = this.game.items[type]) !== null && _a !== void 0 ? _a : []).entries()).filter(function (entry) { return entry[1].quantity !== 0; }));
+        return new items_1.Material(type, this.game.items[type]);
     };
+    /**
+     * This function is called immediately before an {@link ItemMove} is played.
+     * @param _move The move which is going to be played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     MaterialRulesPart.prototype.beforeItemMove = function (_move, _context) {
         return [];
     };
+    /**
+     * This function is called immediately after an {@link ItemMove} is played.
+     * @param _move The move which has just been played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     MaterialRulesPart.prototype.afterItemMove = function (_move, _context) {
         return [];
     };
+    /**
+     * This function is called immediately after the {@link RuleMove} that started this rules step was played
+     * @param _move The move which has just been played
+     * @param _previousRule The step of the rules immediately before this one started
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     MaterialRulesPart.prototype.onRuleStart = function (_move, _previousRule, _context) {
         return [];
     };
+    /**
+     * This function is called just before a {@link RuleMove} that leave this rules step is played.
+     *
+     * BEWARE: any consequences returned here will happen inside the next rule step. Usually we only clean the memory here.
+     *
+     * @param _move The move which is going to be played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     MaterialRulesPart.prototype.onRuleEnd = function (_move, _context) {
         return [];
     };
+    /**
+     * This function is called when a {@link CustomMove} is played.
+     * @param _move The move
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     MaterialRulesPart.prototype.onCustomMove = function (_move, _context) {
         return [];
     };
+    /**
+     * @deprecated replace this.rules().[the function] with: this.[the function]
+     */
     MaterialRulesPart.prototype.rules = function () {
         return moves_1.MaterialMoveBuilder;
     };
+    /**
+     * Utility function to access the memory tool for the game or on player.
+     * this.game.memory can be used to store any data that is not available through the state of the material, or current rule.
+     *
+     * @param player Optional, identifier of the player if we want to manipulate a specific player's memory
+     * @returns {@link GameMemory} or {@link PlayerMemory} utility
+     * @protected
+     */
     MaterialRulesPart.prototype.getMemory = function (player) {
         return player === undefined ? new memory_1.GameMemory(this.game) : new memory_1.PlayerMemory(this.game, player);
     };
+    /**
+     * Save a new value inside the memory.
+     * @param key The key to index the memorized value.
+     * @param value Any JSON serializable value to store, or a function that takes previous stored value and returns the new value to store.
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     MaterialRulesPart.prototype.memorize = function (key, value, player) {
         this.getMemory(player).memorize(key, value);
     };
+    /**
+     * Retrieve the value memorized under a given key.
+     * Shortcut for this.game.memory[key] or this.game.memory[key][player]
+     *
+     * @param key Key under which the memory is store. Usually a value of a numeric enum named "Memory".
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     MaterialRulesPart.prototype.remind = function (key, player) {
         return this.getMemory(player).remind(key);
     };
+    /**
+     * Delete a value from the memory
+     * @param key Key of the value to delete
+     * @param player optional, if we need to memorize a different value for each player.
+     */
     MaterialRulesPart.prototype.forget = function (key, player) {
         this.getMemory(player).forget(key);
     };

package/dist/material/rules/MaterialRulesPart.js.map

@@ -1 +1 @@
-{"version":3,"file":"MaterialRulesPart.js","sourceRoot":"","sources":["../../../src/material/rules/MaterialRulesPart.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,qCAAoD;AACpD,kCAAmC;AAEnC,oCAAoD;AACpD,kCAA4F;AAQ5F;IACU,qCAAiH;IAD3H;;QAyEE,qBAAe,GAAG,2BAAmB,CAAC,eAAe,CAAA;QACrD,2BAAqB,GAAG,2BAAmB,CAAC,qBAAqB,CAAA;QACjE,eAAS,GAAG,2BAAmB,CAAC,SAAS,CAAA;QACzC,gBAAU,GAAG,2BAAmB,CAAC,UAAU,CAAA;QAC3C,aAAO,GAAG,2BAAmB,CAAC,OAAO,CAAA;;IA2CvC,CAAC;IAhHC,oCAAQ,GAAR,UAAS,IAAkB;;QACzB,OAAO,IAAI,gBAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAA,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,UAAA,KAAK,IAAI,OAAA,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAvB,CAAuB,CAAC,CAAC,CAAA;IACzH,CAAC;IAQD,0CAAc,GAAd,UAAe,KAAmD,EAAE,QAA0B;QAC5F,OAAO,EAAE,CAAA;IACX,CAAC;IAQD,yCAAa,GAAb,UAAc,KAAmD,EAAE,QAA0B;QAC3F,OAAO,EAAE,CAAA;IACX,CAAC;IASD,uCAAW,GAAX,UAAmC,KAA+B,EAAE,aAAwB,EAAE,QAA0B;QACtH,OAAO,EAAE,CAAA;IACX,CAAC;IAWD,qCAAS,GAAT,UAAiC,KAA+B,EAAE,QAA0B;QAC1F,OAAO,EAAE,CAAA;IACX,CAAC;IAQD,wCAAY,GAAZ,UAAa,KAAiB,EAAE,QAA0B;QACxD,OAAO,EAAE,CAAA;IACX,CAAC;IAKD,iCAAK,GAAL;QACE,OAAO,2BAAmB,CAAA;IAC5B,CAAC;IAgBS,qCAAS,GAAnB,UAAoB,MAAe;QACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,mBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,qBAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/F,CAAC;IAQD,oCAAQ,GAAR,UAAkB,GAAc,EAAE,KAAgC,EAAE,MAAe;QACjF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7C,CAAC;IASD,kCAAM,GAAN,UAAgB,GAAc,EAAE,MAAe;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC3C,CAAC;IAOD,kCAAM,GAAN,UAAO,GAAc,EAAE,MAAe;QACpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpC,CAAC;IACH,wBAAC;AAAD,CAAC,AAxHD,CACU,aAAK,GAuHd;AAxHqB,8CAAiB"}
+{"version":3,"file":"MaterialRulesPart.js","sourceRoot":"","sources":["../../../src/material/rules/MaterialRulesPart.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,qCAAoD;AACpD,kCAAmC;AAEnC,oCAAoD;AACpD,kCAA4F;AAG5F;;;;GAIG;AACH;IACU,qCAAiH;IAD3H;;QAyEE,qBAAe,GAAG,2BAAmB,CAAC,eAAe,CAAA;QACrD,2BAAqB,GAAG,2BAAmB,CAAC,qBAAqB,CAAA;QACjE,eAAS,GAAG,2BAAmB,CAAC,SAAS,CAAA;QACzC,gBAAU,GAAG,2BAAmB,CAAC,UAAU,CAAA;QAC3C,aAAO,GAAG,2BAAmB,CAAC,OAAO,CAAA;;IA2CvC,CAAC;IArHC;;;;OAIG;IACH,oCAAQ,GAAR,UAAS,IAAkB;QACzB,OAAO,IAAI,gBAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAClD,CAAC;IAED;;;;;OAKG;IACH,0CAAc,GAAd,UAAe,KAAmD,EAAE,QAA0B;QAC5F,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;OAKG;IACH,yCAAa,GAAb,UAAc,KAAmD,EAAE,QAA0B;QAC3F,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;;OAMG;IACH,uCAAW,GAAX,UAAmC,KAA+B,EAAE,aAAwB,EAAE,QAA0B;QACtH,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;;;;OAQG;IACH,qCAAS,GAAT,UAAiC,KAA+B,EAAE,QAA0B;QAC1F,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;OAKG;IACH,wCAAY,GAAZ,UAAa,KAAiB,EAAE,QAA0B;QACxD,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACH,iCAAK,GAAL;QACE,OAAO,2BAAmB,CAAA;IAC5B,CAAC;IAQD;;;;;;;OAOG;IACO,qCAAS,GAAnB,UAAoB,MAAe;QACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,mBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,qBAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC/F,CAAC;IAED;;;;;OAKG;IACH,oCAAQ,GAAR,UAAkB,GAAc,EAAE,KAAgC,EAAE,MAAe;QACjF,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,kCAAM,GAAN,UAAgB,GAAc,EAAE,MAAe;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC3C,CAAC;IAED;;;;OAIG;IACH,kCAAM,GAAN,UAAO,GAAc,EAAE,MAAe;QACpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACpC,CAAC;IACH,wBAAC;AAAD,CAAC,AAxHD,CACU,aAAK,GAuHd;AAxHqB,8CAAiB"}

package/dist/material/rules/PlayerTurnRule.d.ts

@@ -1,9 +1,28 @@
 import { MaterialMove } from '../moves';
 import { MaterialRulesPart } from './MaterialRulesPart';
+/**
+ * Base class for any part of the rules where only one player has to do something.
+ */
 export declare abstract class PlayerTurnRule<Player extends number = number, MaterialType extends number = number, LocationType extends number = number> extends MaterialRulesPart<Player, MaterialType, LocationType> {
+    /**
+     * Shortcut to get the awaited player (this.game.rule.player)
+     */
     get player(): Player;
+    /**
+     * Utility function to get the id of the next player in the table order
+     */
     get nextPlayer(): Player;
+    /**
+     * See {@link Rules.getActivePlayer}
+     */
     getActivePlayer(): Player;
+    /**
+     * See {@link Rules.getLegalMoves}
+     */
     getLegalMoves(player: Player): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * Implement this to expose all the legal moves of the active player.
+     * @returns All the {@link MaterialMove} that current active player can play
+     */
     getPlayerMoves(): MaterialMove<Player, MaterialType, LocationType>[];
 }

package/dist/material/rules/PlayerTurnRule.js

@@ -17,12 +17,18 @@ var __extends = (this && this.__extends) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlayerTurnRule = void 0;
 var MaterialRulesPart_1 = require("./MaterialRulesPart");
-var PlayerTurnRule = (function (_super) {
+/**
+ * Base class for any part of the rules where only one player has to do something.
+ */
+var PlayerTurnRule = /** @class */ (function (_super) {
     __extends(PlayerTurnRule, _super);
     function PlayerTurnRule() {
         return _super !== null && _super.apply(this, arguments) || this;
     }
     Object.defineProperty(PlayerTurnRule.prototype, "player", {
+        /**
+         * Shortcut to get the awaited player (this.game.rule.player)
+         */
         get: function () {
             return this.game.rule.player;
         },
@@ -30,20 +36,33 @@ var PlayerTurnRule = (function (_super) {
         configurable: true
     });
     Object.defineProperty(PlayerTurnRule.prototype, "nextPlayer", {
+        /**
+         * Utility function to get the id of the next player in the table order
+         */
         get: function () {
             return this.game.players[(this.game.players.indexOf(this.player) + 1) % this.game.players.length];
         },
         enumerable: false,
         configurable: true
     });
+    /**
+     * See {@link Rules.getActivePlayer}
+     */
     PlayerTurnRule.prototype.getActivePlayer = function () {
         return this.player;
     };
+    /**
+     * See {@link Rules.getLegalMoves}
+     */
     PlayerTurnRule.prototype.getLegalMoves = function (player) {
         if (player !== this.getActivePlayer())
             return [];
         return this.getPlayerMoves();
     };
+    /**
+     * Implement this to expose all the legal moves of the active player.
+     * @returns All the {@link MaterialMove} that current active player can play
+     */
     PlayerTurnRule.prototype.getPlayerMoves = function () {
         return [];
     };

package/dist/material/rules/PlayerTurnRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerTurnRule.js","sourceRoot":"","sources":["../../../src/material/rules/PlayerTurnRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,yDAAuD;AAKvD;IACU,kCAAqD;IAD/D;;IAuCA,CAAC;IAjCC,sBAAI,kCAAM;aAAV;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAK,CAAC,MAAO,CAAA;QAChC,CAAC;;;OAAA;IAKD,sBAAI,sCAAU;aAAd;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACnG,CAAC;;;OAAA;IAKD,wCAAe,GAAf;QACE,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAKD,sCAAa,GAAb,UAAc,MAAc;QAC1B,IAAI,MAAM,KAAK,IAAI,CAAC,eAAe,EAAE;YAAE,OAAO,EAAE,CAAA;QAChD,OAAO,IAAI,CAAC,cAAc,EAAE,CAAA;IAC9B,CAAC;IAMD,uCAAc,GAAd;QACE,OAAO,EAAE,CAAA;IACX,CAAC;IACH,qBAAC;AAAD,CAAC,AAvCD,CACU,qCAAiB,GAsC1B;AAvCqB,wCAAc"}
+{"version":3,"file":"PlayerTurnRule.js","sourceRoot":"","sources":["../../../src/material/rules/PlayerTurnRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,yDAAuD;AAEvD;;GAEG;AACH;IACU,kCAAqD;IAD/D;;IAuCA,CAAC;IAjCC,sBAAI,kCAAM;QAHV;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAK,CAAC,MAAO,CAAA;QAChC,CAAC;;;OAAA;IAKD,sBAAI,sCAAU;QAHd;;WAEG;aACH;YACE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACnG,CAAC;;;OAAA;IAED;;OAEG;IACH,wCAAe,GAAf;QACE,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,sCAAa,GAAb,UAAc,MAAc;QAC1B,IAAI,MAAM,KAAK,IAAI,CAAC,eAAe,EAAE;YAAE,OAAO,EAAE,CAAA;QAChD,OAAO,IAAI,CAAC,cAAc,EAAE,CAAA;IAC9B,CAAC;IAED;;;OAGG;IACH,uCAAc,GAAd;QACE,OAAO,EAAE,CAAA;IACX,CAAC;IACH,qBAAC;AAAD,CAAC,AAvCD,CACU,qCAAiB,GAsC1B;AAvCqB,wCAAc"}

package/dist/material/rules/RuleStep.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Common data structure for any step of the rules
+ */
 export type RuleStep<Player extends number = number, RuleId extends number = number> = {
     id: RuleId;
     player?: Player;

package/dist/material/rules/SimultaneousRule.d.ts

@@ -1,12 +1,37 @@
 import { PlayMoveContext } from '../../Rules';
 import { EndPlayerTurn, MaterialMove } from '../moves';
 import { MaterialRulesPart } from './MaterialRulesPart';
+/**
+ * Base class for any part of the rules where multiple players have to do something at the same time.
+ */
 export declare abstract class SimultaneousRule<Player extends number = number, MaterialType extends number = number, LocationType extends number = number> extends MaterialRulesPart<Player, MaterialType, LocationType> {
     endPlayerTurn: <P extends number = number>(player: P) => EndPlayerTurn<P>;
+    /**
+     * See {@link Rules.isTurnToPlay}
+     */
     isTurnToPlay(player: Player): boolean;
+    /**
+     * See {@link Rules.getLegalMoves}
+     */
     getLegalMoves(player: Player): MaterialMove<Player, MaterialType, LocationType>[];
     abstract getActivePlayerLegalMoves(playerId: Player): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * This function is called immediately after a {@link EndPlayerTurn} has been played.
+     * @param _move The move which has just been played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     onPlayerTurnEnd(_move: EndPlayerTurn<Player>, _context?: PlayMoveContext): MaterialMove<Player, MaterialType, LocationType>[];
+    /**
+     * Implement this to return the consequences when all the players have completed their task.
+     * Usually, a new rule part should start.
+     * @returns the consequences when the last awaited player have played
+     */
     abstract getMovesAfterPlayersDone(): MaterialMove<Player, MaterialType, LocationType>[];
 }
+/**
+ * Type guard to know if a {@link MaterialRulesPart} is a {@link SimultaneousRule}
+ * @param rule The rule
+ * @returns true if the rule if a {@link SimultaneousRule}
+ */
 export declare function isSimultaneousRule<P extends number = number, M extends number = number, L extends number = number>(rule?: MaterialRulesPart<P, M, L>): rule is SimultaneousRule<P, M, L>;

package/dist/material/rules/SimultaneousRule.js

@@ -18,26 +18,46 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSimultaneousRule = exports.SimultaneousRule = void 0;
 var moves_1 = require("../moves");
 var MaterialRulesPart_1 = require("./MaterialRulesPart");
-var SimultaneousRule = (function (_super) {
+/**
+ * Base class for any part of the rules where multiple players have to do something at the same time.
+ */
+var SimultaneousRule = /** @class */ (function (_super) {
     __extends(SimultaneousRule, _super);
     function SimultaneousRule() {
         var _this = _super !== null && _super.apply(this, arguments) || this;
         _this.endPlayerTurn = moves_1.MaterialMoveBuilder.endPlayerTurn;
         return _this;
     }
+    /**
+     * See {@link Rules.isTurnToPlay}
+     */
     SimultaneousRule.prototype.isTurnToPlay = function (player) {
         var _a, _b, _c;
         return (_c = (_b = (_a = this.game.rule) === null || _a === void 0 ? void 0 : _a.players) === null || _b === void 0 ? void 0 : _b.includes(player)) !== null && _c !== void 0 ? _c : false;
     };
+    /**
+     * See {@link Rules.getLegalMoves}
+     */
     SimultaneousRule.prototype.getLegalMoves = function (player) {
         return this.isTurnToPlay(player) ? this.getActivePlayerLegalMoves(player) : [];
     };
+    /**
+     * This function is called immediately after a {@link EndPlayerTurn} has been played.
+     * @param _move The move which has just been played
+     * @param _context Context of execution
+     * @returns {MaterialMove[]} Any consequences that should automatically be played after the move
+     */
     SimultaneousRule.prototype.onPlayerTurnEnd = function (_move, _context) {
         return [];
     };
     return SimultaneousRule;
 }(MaterialRulesPart_1.MaterialRulesPart));
 exports.SimultaneousRule = SimultaneousRule;
+/**
+ * Type guard to know if a {@link MaterialRulesPart} is a {@link SimultaneousRule}
+ * @param rule The rule
+ * @returns true if the rule if a {@link SimultaneousRule}
+ */
 function isSimultaneousRule(rule) {
     return rule !== undefined && typeof rule.getMovesAfterPlayersDone === 'function';
 }

package/dist/material/rules/SimultaneousRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"SimultaneousRule.js","sourceRoot":"","sources":["../../../src/material/rules/SimultaneousRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,kCAA2E;AAC3E,yDAAuD;AAKvD;IACU,oCAAqD;IAD/D;;QAGE,mBAAa,GAAG,2BAAmB,CAAC,aAAa,CAAA;;IAkCnD,CAAC;IA7BC,uCAAY,GAAZ,UAAa,MAAc;;QACzB,OAAO,MAAA,MAAA,MAAA,IAAI,CAAC,IAAI,CAAC,IAAI,0CAAE,OAAO,0CAAE,QAAQ,CAAC,MAAM,CAAC,mCAAI,KAAK,CAAA;IAC3D,CAAC;IAKD,wCAAa,GAAb,UAAc,MAAc;QAC1B,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAChF,CAAC;IAUD,0CAAe,GAAf,UAAgB,KAA4B,EAAE,QAA0B;QACtE,OAAO,EAAE,CAAA;IACX,CAAC;IAQH,uBAAC;AAAD,CAAC,AArCD,CACU,qCAAiB,GAoC1B;AArCqB,4CAAgB;AA4CtC,SAAgB,kBAAkB,CAChC,IAAiC;IAEjC,OAAO,IAAI,KAAK,SAAS,IAAI,OAAQ,IAAkC,CAAC,wBAAwB,KAAK,UAAU,CAAA;AACjH,CAAC;AAJD,gDAIC"}
+{"version":3,"file":"SimultaneousRule.js","sourceRoot":"","sources":["../../../src/material/rules/SimultaneousRule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,kCAA2E;AAC3E,yDAAuD;AAEvD;;GAEG;AACH;IACU,oCAAqD;IAD/D;;QAGE,mBAAa,GAAG,2BAAmB,CAAC,aAAa,CAAA;;IAkCnD,CAAC;IAhCC;;OAEG;IACH,uCAAY,GAAZ,UAAa,MAAc;;QACzB,OAAO,MAAA,MAAA,MAAA,IAAI,CAAC,IAAI,CAAC,IAAI,0CAAE,OAAO,0CAAE,QAAQ,CAAC,MAAM,CAAC,mCAAI,KAAK,CAAA;IAC3D,CAAC;IAED;;OAEG;IACH,wCAAa,GAAb,UAAc,MAAc;QAC1B,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAChF,CAAC;IAID;;;;;OAKG;IACH,0CAAe,GAAf,UAAgB,KAA4B,EAAE,QAA0B;QACtE,OAAO,EAAE,CAAA;IACX,CAAC;IAQH,uBAAC;AAAD,CAAC,AArCD,CACU,qCAAiB,GAoC1B;AArCqB,4CAAgB;AAuCtC;;;;GAIG;AACH,SAAgB,kBAAkB,CAChC,IAAiC;IAEjC,OAAO,IAAI,KAAK,SAAS,IAAI,OAAQ,IAAkC,CAAC,wBAAwB,KAAK,UAAU,CAAA;AACjH,CAAC;AAJD,gDAIC"}

package/dist/material/tutorial/TutorialState.d.ts

@@ -1,4 +1,11 @@
 import { MaterialMove } from '../moves';
+/**
+ * Data structure for the state of the tutorial in a tutorial game implement with {@link MaterialRules}.
+ * @property step Current step of the tutorial.
+ * @property popupClosed true when the popup has been closed by the player.
+ * @property stepComplete if true, the tutorial engine will move on to next step automatically.
+ * @property interrupt The automatic consequences that have been interrupted to display some information explaining what is happening.
+ */
 export type TutorialState<P extends number = number, M extends number = number, L extends number = number> = {
     step: number;
     popupClosed: boolean;

package/dist/options/OptionsValidationError.js

@@ -16,7 +16,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OptionsValidationError = void 0;
-var OptionsValidationError = (function (_super) {
+var OptionsValidationError = /** @class */ (function (_super) {
     __extends(OptionsValidationError, _super);
     function OptionsValidationError(message, fields) {
         if (fields === void 0) { fields = []; }