@gamepark/rules-api 7.6.4 → 7.6.5

package/dist/options/Option.d.ts

@@ -1,4 +1,4 @@
-import { TFunction } from 'i18next';
+import { TFunction } from './TFunction';
 export type Option = {
     label: (t: TFunction) => string;
     help?: (t: TFunction) => string;

package/dist/options/OptionsSpec.d.ts

@@ -1,4 +1,4 @@
-import { TFunction } from 'i18next';
+import { TFunction } from './TFunction';
 import { OptionSpecOf } from './OptionSpecOf';
 import { WithPlayerOptionsSpec } from './WithPlayerOptionsSpec';
 import { WithPlayersOptions } from './WithPlayersOptions';

package/dist/options/TFunction.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Minimal structural type for a translation function, compatible with i18next's `TFunction`.
+ * Declared locally so this library does not depend on i18next.
+ */
+export type TFunction = (key: string | string[], options?: Record<string, any>) => string;

package/dist/options/TFunction.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TFunction.js.map

package/dist/options/TFunction.js.map

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

package/dist/options/index.d.ts

@@ -7,6 +7,7 @@ export * from './OptionsSpec';
 export * from './OptionsValidationError';
 export * from './PlayerEnumOption';
 export * from './PlayersOptionsSpec';
+export * from './TFunction';
 export * from './WithIdOption';
 export * from './WithPlayerOptionsSpec';
 export * from './WithPlayersOptions';

package/dist/options/index.js

@@ -7,6 +7,7 @@ export * from './OptionsSpec';
 export * from './OptionsValidationError';
 export * from './PlayerEnumOption';
 export * from './PlayersOptionsSpec';
+export * from './TFunction';
 export * from './WithIdOption';
 export * from './WithPlayerOptionsSpec';
 export * from './WithPlayersOptions';

package/dist/options/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/options/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/options/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA"}

package/dist/utils/grid.squares.util.d.ts

@@ -1,3 +1,4 @@
+import { Location } from '../material';
 import { XYCoordinates } from './grid.util';
 /**
  * Check if two squares in a grid are orthogonally adjacent based on their coordinates
@@ -35,3 +36,38 @@ export declare const directions: Direction[];
  * @returns the coordinates of the destination square
  */
 export declare const getSquareInDirection: (origin: Partial<XYCoordinates>, direction: Direction, distance?: number) => XYCoordinates;
+/**
+ * Rotate square-grid coordinates.
+ * A quarter turn (90°) matches a positive CSS rotation (clockwise on a y-down screen).
+ * @param vector Vector to rotate
+ * @param rotation Number of 90 degrees rotations to apply (1 = 90°, 2 = 180°...)
+ * @return the rotated vector
+ */
+export declare function squareRotate(vector: XYCoordinates, rotation?: number): XYCoordinates;
+/**
+ * Translate square-grid coordinates by a vector.
+ * @param square Coordinates of the square to translate
+ * @param vector Vector of the translation
+ * @return the coordinates of the square after the translation
+ */
+export declare function squareTranslate(square: XYCoordinates, vector: XYCoordinates): XYCoordinates;
+/**
+ * Get all the squares that are exactly at a specific (Manhattan) distance from a given square.
+ * @param square Coordinates of the square
+ * @param distance Distance of the squares we want
+ * @return the list of the squares found at distance from given square
+ */
+export declare function getSquaresAtDistance(square: XYCoordinates, distance: number): XYCoordinates[];
+/**
+ * Get the coordinates of the 4 squares orthogonally adjacent to a given square.
+ * @param square Coordinates of the square
+ * @return the coordinates of the adjacent squares
+ */
+export declare function getAdjacentSquares(square: XYCoordinates): XYCoordinates[];
+/**
+ * Get the coordinates that will be covered by a polyomino tile when at a specific grid location.
+ * @param polyomino Coordinates occupied by the polyomino without any rotation
+ * @param location Location of the polyomino on the grid (x, y, and rotation)
+ * @return coordinates in the grid covered when the polyomino has this location
+ */
+export declare function getPolyominoSpaces(polyomino: XYCoordinates[], location: Partial<Location>): XYCoordinates[];

package/dist/utils/grid.squares.util.js

@@ -44,4 +44,72 @@ export const getSquareInDirection = (origin, direction, distance = 1) => {
         y: direction === Direction.North ? origin.y - distance : direction === Direction.South ? origin.y + distance : origin.y
     };
 };
+/**
+ * Rotate square-grid coordinates.
+ * A quarter turn (90°) matches a positive CSS rotation (clockwise on a y-down screen).
+ * @param vector Vector to rotate
+ * @param rotation Number of 90 degrees rotations to apply (1 = 90°, 2 = 180°...)
+ * @return the rotated vector
+ */
+export function squareRotate(vector, rotation = 0) {
+    switch (((rotation % 4) + 4) % 4) {
+        case 1:
+            return { x: -vector.y, y: vector.x };
+        case 2:
+            return { x: -vector.x, y: -vector.y };
+        case 3:
+            return { x: vector.y, y: -vector.x };
+        default:
+            return vector;
+    }
+}
+/**
+ * Translate square-grid coordinates by a vector.
+ * @param square Coordinates of the square to translate
+ * @param vector Vector of the translation
+ * @return the coordinates of the square after the translation
+ */
+export function squareTranslate(square, vector) {
+    return { x: square.x + vector.x, y: square.y + vector.y };
+}
+/**
+ * Get all the squares that are exactly at a specific (Manhattan) distance from a given square.
+ * @param square Coordinates of the square
+ * @param distance Distance of the squares we want
+ * @return the list of the squares found at distance from given square
+ */
+export function getSquaresAtDistance(square, distance) {
+    if (distance <= 0)
+        return [square];
+    const result = [];
+    let currentSquare = { x: square.x + distance, y: square.y };
+    const vectors = [{ x: -1, y: 1 }, { x: -1, y: -1 }, { x: 1, y: -1 }, { x: 1, y: 1 }];
+    for (const vector of vectors) {
+        for (let j = 0; j < distance; j++) {
+            result.push(currentSquare);
+            currentSquare = squareTranslate(currentSquare, vector);
+        }
+    }
+    return result;
+}
+/**
+ * Get the coordinates of the 4 squares orthogonally adjacent to a given square.
+ * @param square Coordinates of the square
+ * @return the coordinates of the adjacent squares
+ */
+export function getAdjacentSquares(square) {
+    return directions.map((direction) => getSquareInDirection(square, direction));
+}
+/**
+ * Get the coordinates that will be covered by a polyomino tile when at a specific grid location.
+ * @param polyomino Coordinates occupied by the polyomino without any rotation
+ * @param location Location of the polyomino on the grid (x, y, and rotation)
+ * @return coordinates in the grid covered when the polyomino has this location
+ */
+export function getPolyominoSpaces(polyomino, location) {
+    const vector = { x: location.x ?? 0, y: location.y ?? 0 };
+    return polyomino
+        .map((square) => squareRotate(square, location.rotation ?? 0))
+        .map((square) => squareTranslate(square, vector));
+}
 //# sourceMappingURL=grid.squares.util.js.map

package/dist/utils/grid.squares.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid.squares.util.js","sourceRoot":"","sources":["../../src/utils/grid.squares.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAiB,MAAM,aAAa,CAAA;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAA+B,EAAE,OAA+B,EAAW,EAAE,CAC9G,eAAe,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,yBAAyB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;AAE3G;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAsB,EAAE,OAAsB,EAAU,EAAE,CAClG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEnE;;GAEG;AACH,MAAM,CAAN,IAAY,SAEX;AAFD,WAAY,SAAS;IACnB,2CAAS,CAAA;IAAE,2CAAK,CAAA;IAAE,yCAAI,CAAA;IAAE,yCAAI,CAAA;AAC9B,CAAC,EAFW,SAAS,KAAT,SAAS,QAEpB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAA8B,EAAE,SAAoB,EAAE,QAAQ,GAAG,CAAC,EAAiB,EAAE;IACxH,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC/G,OAAO;QACL,CAAC,EAAE,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrH,CAAC,EAAE,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;KACxH,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"grid.squares.util.js","sourceRoot":"","sources":["../../src/utils/grid.squares.util.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -12,5 +12,6 @@ export * from './loops.util';
 export * from './money.util';
 export * from './neighbors.util';
 export * from './polyhex.util';
+export * from './polyomino.util';
 export * from './random.util';
 export * from './rank.util';

package/dist/utils/index.js

@@ -12,6 +12,7 @@ export * from './loops.util';
 export * from './money.util';
 export * from './neighbors.util';
 export * from './polyhex.util';
+export * from './polyomino.util';
 export * from './random.util';
 export * from './rank.util';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA"}

package/dist/utils/polyomino.util.d.ts

@@ -0,0 +1,52 @@
+import { XYCoordinates } from './grid.util';
+/**
+ * Configuration of a Polyomino
+ */
+export interface PolyominoConfig<T = any> {
+    /**
+     * Minimum x coordinates of the polyomino (arrays cannot have negative index)
+     */
+    xMin: number;
+    /**
+     * Minimum y coordinates of the polyomino (arrays cannot have negative index)
+     */
+    yMin: number;
+    /**
+     * Function to evaluate whether a value is empty or not in the grid.
+     * By default, undefined and null values are considered as empty.
+     * @param value Value to evaluate
+     * @return true if the value should be considered as empty
+     */
+    isEmpty: (value: T) => boolean;
+}
+/**
+ * Class to work on Polyominoes (multiple squares linked together)
+ */
+export declare class Polyomino<T = any> implements PolyominoConfig<T> {
+    grid: (T | undefined)[][];
+    xMin: number;
+    yMin: number;
+    isEmpty: (value: (T | undefined)) => boolean;
+    constructor(grid: (T | undefined)[][], config?: Partial<PolyominoConfig>);
+    get xMax(): number;
+    get yMax(): number;
+    getValue(coordinates: XYCoordinates): T | undefined;
+    /**
+     * Utility function to merge multiple polyominoes together to create a bigger polyomino: it merges given polyomino grid in current polyomino.
+     * @param polyomino Polyomino to merge in the current polyomino
+     * @param location Location to merge the new polyomino in
+     * @param onOverlap Callback function when a non-empty value is erased
+     */
+    merge(polyomino: Polyomino, location?: {
+        x?: number;
+        y?: number;
+        rotation?: number;
+    }, onOverlap?: (x: number, y: number) => void): void;
+    /**
+     * Get the minimum distance from given square to a square of the polyomino that matches given predicate
+     * @param square Starting square
+     * @param predicate The predicate to match (not empty by default)
+     * @returns the minimum distance found
+     */
+    getDistance(square: XYCoordinates, predicate?: (value: T | undefined) => boolean): number;
+}

package/dist/utils/polyomino.util.js

@@ -0,0 +1,81 @@
+import { getSquaresAtDistance, squareRotate, squareTranslate } from './grid.squares.util';
+/**
+ * Class to work on Polyominoes (multiple squares linked together)
+ */
+export class Polyomino {
+    grid;
+    xMin = 0;
+    yMin = 0;
+    isEmpty = (value) => value == null; // true for null and undefined
+    constructor(grid, config) {
+        this.grid = grid;
+        this.xMin = config?.xMin ?? this.xMin;
+        this.yMin = config?.yMin ?? this.yMin;
+        this.isEmpty = config?.isEmpty ?? this.isEmpty;
+    }
+    get xMax() {
+        return Math.max(...this.grid.map((line) => line.length)) + this.xMin - 1;
+    }
+    get yMax() {
+        return this.grid.length + this.yMin - 1;
+    }
+    getValue(coordinates) {
+        return this.grid[coordinates.y - this.yMin]?.[coordinates.x - this.xMin];
+    }
+    /**
+     * Utility function to merge multiple polyominoes together to create a bigger polyomino: it merges given polyomino grid in current polyomino.
+     * @param polyomino Polyomino to merge in the current polyomino
+     * @param location Location to merge the new polyomino in
+     * @param onOverlap Callback function when a non-empty value is erased
+     */
+    merge(polyomino, location = {}, onOverlap = () => {
+    }) {
+        for (let y = polyomino.yMin; y <= polyomino.yMax; y++) {
+            for (let x = polyomino.xMin; x <= polyomino.xMax; x++) {
+                const value = polyomino.getValue({ x, y });
+                if (!this.isEmpty(value)) {
+                    const rotatedCoordinates = squareRotate({ x, y }, location.rotation);
+                    const coordinates = squareTranslate(rotatedCoordinates, { x: location.x ?? 0, y: location.y ?? 0 });
+                    while (coordinates.y < this.yMin) {
+                        this.grid.unshift([]);
+                        this.yMin--;
+                    }
+                    while (coordinates.x < this.xMin) {
+                        for (const line1 of this.grid) {
+                            line1.unshift(undefined);
+                        }
+                        this.xMin--;
+                    }
+                    while (this.grid.length <= coordinates.y - this.yMin) {
+                        this.grid.push([]);
+                    }
+                    if (this.grid[coordinates.y - this.yMin][coordinates.x - this.xMin]) {
+                        onOverlap(x, y);
+                    }
+                    this.grid[coordinates.y - this.yMin][coordinates.x - this.xMin] = value;
+                }
+            }
+        }
+    }
+    /**
+     * Get the minimum distance from given square to a square of the polyomino that matches given predicate
+     * @param square Starting square
+     * @param predicate The predicate to match (not empty by default)
+     * @returns the minimum distance found
+     */
+    getDistance(square, predicate = (value) => !this.isEmpty(value)) {
+        let distance = 0;
+        const maxDistance = this.xMax + this.yMax - this.xMin - this.yMin;
+        while (distance < maxDistance) {
+            const squaresAtDistance = getSquaresAtDistance(square, distance);
+            if (squaresAtDistance.some((square) => predicate(this.getValue(square)))) {
+                return distance;
+            }
+            else {
+                distance++;
+            }
+        }
+        return Infinity;
+    }
+}
+//# sourceMappingURL=polyomino.util.js.map

package/dist/utils/polyomino.util.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamepark/rules-api",
-  "version": "7.6.4",
+  "version": "7.6.5",
   "description": "API to implement the rules of a board game",
   "type": "module",
   "main": "dist/index.js",
@@ -27,11 +27,10 @@
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "es-toolkit": "^1.46.0",
-    "i18next": "^26.0.8",
+    "@types/node": "^26.0.1",
+    "es-toolkit": "^1.49.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.9"
   },
   "peerDependencies": {
     "es-toolkit": "^1.46.0"