scrabble-solver 2.12.1 → 2.12.3

package/README.md

@@ -6,7 +6,7 @@
   </p>
 
   <p>
-    Free, open-source, and cross-platform analysis tool for <a href="https://en.wikipedia.org/wiki/Scrabble">Scrabble</a> &amp; <a href="https://pl.wikipedia.org/wiki/Literaki">Literaki</a>.
+    Free, open-source, and cross-platform analysis tool for <a href="https://en.wikipedia.org/wiki/Scrabble">Scrabble</a>, <a href="https://en.wikipedia.org/wiki/Super_Scrabble">Super Scrabble</a> &amp; <a href="https://pl.wikipedia.org/wiki/Literaki">Literaki</a>.
   </p>
 
   <p>
@@ -51,8 +51,13 @@
 3. [Install](#install)
 4. [Uninstall](#uninstall)
 5. [Develop](#develop)
+    1. [Setup](#setup)
+    2. [Run app dev server](#run-app-dev-server)
+    3. [Rebuild a single package](#rebuild-a-single-package)
+    4. [Add a new language](#add-a-new-language)
 6. [Tech stack](#tech-stack)
 7. [Related projects](#related-projects)
+8. [Media](#media)
 
 ## Dictionaries
 
@@ -88,8 +93,8 @@ scrabble-solver
 ```Shell
 npm uninstall -g scrabble-solver
 
-# The package stores logs and dictionaries in $HOME/.scrabble-solver
-# It uses os.homedir() to get $HOME location.
+# Logs and dictionaries are stored in $HOME/.scrabble-solver
+# $HOME location is acquired using os.homedir()
 rm -rf $HOME/.scrabble-solver
 ```
 
@@ -102,7 +107,7 @@ npm install
 npm run install:dev
 ```
 
-### App dev server
+### Run app dev server
 
 ```Shell
 npx lerna run dev --scope=@scrabble-solver/scrabble-solver
@@ -116,6 +121,29 @@ Note: hot code reload works only for the [`scrabble-solver`](https://github.com/
 npx lerna run build --scope=@scrabble-solver/PACKAGE_NAME_HERE
 ```
 
+### Add a new language
+
+1. Find and download a flag representing the locale in an SVG format
+    - I usually find them at https://commons.wikimedia.org/
+2. Rename the file to `FlagXX.svg` and put it in [packages/scrabble-solver/src/icons](https://github.com/kamilmielnik/scrabble-solver/tree/master/packages/scrabble-solver/src/icons)
+3. Export the SVG file in [packages/scrabble-solver/src/icons/index.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/scrabble-solver/src/icons/index.ts)
+4. Add IETF language tag for the new locale in [packages/types/src/Locale.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/types/src/Locale.ts)
+5. Rebuild the types package
+   ```Shell
+   npx lerna run build --scope=@scrabble-solver/types
+   ```
+6. Add locale configuration in [packages/scrabble-solver/src/i18n/constants.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/scrabble-solver/src/i18n/constants.ts)
+7. Update locale-detecting code in [packages/scrabble-solver/src/lib/detectLocale.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/scrabble-solver/src/lib/detectLocale.ts)
+8. Add game configs for the new locale in [packages/configs/src/locales](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/configs/src/locales)
+9. Add an export for these locale configs in [packages/configs/src/locales/index.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/configs/src/locales/index.ts)
+10. Add a translation file in [packages/scrabble-solver/src/i18n](https://github.com/kamilmielnik/scrabble-solver/tree/master/packages/scrabble-solver/src/i18n) and fill it with translations
+    - Copy any existing file, e.g. `en.json` and modify it
+11. Add an entry for the translations in [packages/scrabble-solver/src/i18n/i18n.ts](https://github.com/kamilmielnik/scrabble-solver/tree/master/packages/scrabble-solver/src/i18n/i18n.ts)
+12. Add a function to fetch the list of words in the new locale in [packages/word-lists/src/getWordList.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/word-lists/src/getWordList.ts)
+13. Add a function to fetch the word definition in the new locale in [packages/word-definitions/src/crawl/crawl.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/word-definitions/src/crawl/crawl.ts)
+14. Add a function to parse the word definition crawled in the previous step in [packages/word-definitions/src/parse/parse.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/word-definitions/src/parse/parse.ts)
+    - Bonus points for adding tests in [packages/word-definitions/src/parse/parse.test.ts](https://github.com/kamilmielnik/scrabble-solver/blob/master/packages/word-definitions/src/parse/parse.test.ts)
+
 ## Tech stack
 
 - [TypeScript](https://www.typescriptlang.org/)
@@ -143,3 +171,7 @@ The user interface and source code for the web front end of Lexatious is based o
 
 - Web: https://lexatious.com
 - GitHub: https://github.com/ericgjackson/lexatious_web
+
+## Media
+
+- [5 Free Scrabble Solver Websites To Quickly Find Top Scoring Words](https://www.ilovefreesoftware.com/05/featured/free-scrabble-solver-websites-to-quickly-find-top-scoring-words.html)

package/lerna.json

@@ -6,5 +6,5 @@
     "access": "public"
   },
   "tagVersionPrefix": "",
-  "version": "2.12.1"
+  "version": "2.12.3"
 }

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "scrabble-solver",
-  "version": "2.12.1",
-  "description": "Scrabble Solver 2 - Free, open-source, and cross-platform analysis tool for Scrabble & Literaki. Quickly find top scoring words using given letters and board state. Available in English, French, German, Polish & Spanish.",
+  "version": "2.12.3",
+  "description": "Scrabble Solver 2 - Free, open-source, and cross-platform analysis tool for Scrabble, Super Scrabble & Literaki. Quickly find top scoring words using given letters and board state. Available in English, French, German, Polish & Spanish.",
   "keywords": [
     "Scrabble",
+    "Super Scrabble",
     "Literaki",
     "Solver",
     "Finder",
@@ -72,7 +73,7 @@
   "bugs": {
     "url": "https://github.com/kamilmielnik/scrabble-solver/issues"
   },
-  "homepage": "https://github.com/kamilmielnik/scrabble-solver#readme",
+  "homepage": "https://scrabble-solver.org",
   "dependencies": {
     "lerna": "^6.6.1",
     "npm-run-all": "^4.1.5",
@@ -84,10 +85,10 @@
     "@babel/preset-env": "^7.21.4",
     "@types/jest": "^29.5.0",
     "@types/node": "^18.15.11",
-    "@typescript-eslint/eslint-plugin": "^5.57.0",
-    "@typescript-eslint/parser": "^5.57.0",
+    "@typescript-eslint/eslint-plugin": "^5.57.1",
+    "@typescript-eslint/parser": "^5.57.1",
     "babel-eslint": "10.1.0",
-    "eslint": "^8.37.0",
+    "eslint": "^8.38.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-import-resolver-node": "^0.3.7",
     "eslint-plugin-import": "^2.27.5",
@@ -98,7 +99,7 @@
     "np": "^7.7.0",
     "prettier": "^2.8.7",
     "rimraf": "^4.4.1",
-    "ts-jest": "^29.0.5",
-    "typescript": "^5.0.3"
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.4"
   }
 }

package/packages/configs/build/games/index.d.ts

@@ -0,0 +1,3 @@
+export { default as literaki } from './literaki';
+export { default as scrabble } from './scrabble';
+export { default as superScrabble } from './superScrabble';

package/packages/configs/build/games/index.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.superScrabble = exports.scrabble = exports.literaki = void 0;
+var literaki_1 = require("./literaki");
+Object.defineProperty(exports, "literaki", { enumerable: true, get: function () { return __importDefault(literaki_1).default; } });
+var scrabble_1 = require("./scrabble");
+Object.defineProperty(exports, "scrabble", { enumerable: true, get: function () { return __importDefault(scrabble_1).default; } });
+var superScrabble_1 = require("./superScrabble");
+Object.defineProperty(exports, "superScrabble", { enumerable: true, get: function () { return __importDefault(superScrabble_1).default; } });

package/packages/configs/build/games/literaki.d.ts

@@ -0,0 +1,25 @@
+import { Game } from '@scrabble-solver/types';
+declare const literaki: {
+    allTilesBonusScore: number;
+    blankScore: number;
+    blanksCount: number;
+    boardHeight: number;
+    boardWidth: number;
+    game: Game;
+    maximumCharactersCount: number;
+    name: string;
+    bonuses: ({
+        multiplier: number;
+        score: number;
+        type: string;
+        x: number;
+        y: number;
+    } | {
+        multiplier: number;
+        type: string;
+        x: number;
+        y: number;
+        score?: undefined;
+    })[];
+};
+export default literaki;

package/packages/configs/build/games/literaki.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("@scrabble-solver/constants");
+const types_1 = require("@scrabble-solver/types");
+const literaki = {
+    allTilesBonusScore: 50,
+    blankScore: 0,
+    blanksCount: 2,
+    boardHeight: 15,
+    boardWidth: 15,
+    game: types_1.Game.Literaki,
+    maximumCharactersCount: 7,
+    name: 'Literaki',
+    bonuses: [
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 0, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 2, y: 0 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 5, y: 0 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 7, y: 0 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 12, y: 0 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 14, y: 0 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 4, y: 1 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 6, y: 1 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 8, y: 1 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 1 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 2 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 5, y: 2 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 7, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 9, y: 2 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 2 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 14, y: 2 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 2, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 3 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 6, y: 3 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 8, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 10, y: 3 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 12, y: 3 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 1, y: 4 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 3, y: 4 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 5, y: 4 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 9, y: 4 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 4 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 13, y: 4 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 5 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 4, y: 5 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 7, y: 5 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 10, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 5 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 5 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 1, y: 6 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 3, y: 6 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 6, y: 6 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 6 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 11, y: 6 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 13, y: 6 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 0, y: 7 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 2, y: 7 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 5, y: 7 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 7, y: 7 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 9, y: 7 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 12, y: 7 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 14, y: 7 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 1, y: 8 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 3, y: 8 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 6, y: 8 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 8 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 11, y: 8 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 13, y: 8 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 9 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 4, y: 9 },
+        { multiplier: 3, score: 3, type: constants_1.BONUS_CHARACTER, x: 7, y: 9 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 10, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 9 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 9 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 1, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 3, y: 10 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 5, y: 10 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 9, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 10 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 13, y: 10 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 2, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 11 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 6, y: 11 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 8, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 10, y: 11 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 12, y: 11 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 12 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 5, y: 12 },
+        { multiplier: 3, score: 1, type: constants_1.BONUS_CHARACTER, x: 7, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 9, y: 12 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 14, y: 12 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 4, y: 13 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 6, y: 13 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 8, y: 13 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 13 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 0, y: 14 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 2, y: 14 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 5, y: 14 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 7, y: 14 },
+        { multiplier: 3, score: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 14 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 12, y: 14 },
+        { multiplier: 3, score: 5, type: constants_1.BONUS_CHARACTER, x: 14, y: 14 },
+    ],
+};
+exports.default = literaki;

package/packages/configs/build/games/scrabble.d.ts

@@ -0,0 +1,18 @@
+import { Game } from '@scrabble-solver/types';
+declare const scrabble: {
+    allTilesBonusScore: number;
+    blankScore: number;
+    blanksCount: number;
+    boardHeight: number;
+    boardWidth: number;
+    game: Game;
+    maximumCharactersCount: number;
+    name: string;
+    bonuses: {
+        multiplier: number;
+        type: string;
+        x: number;
+        y: number;
+    }[];
+};
+export default scrabble;

package/packages/configs/build/games/scrabble.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("@scrabble-solver/constants");
+const types_1 = require("@scrabble-solver/types");
+const scrabble = {
+    allTilesBonusScore: 50,
+    blankScore: 0,
+    blanksCount: 2,
+    boardHeight: 15,
+    boardWidth: 15,
+    game: types_1.Game.Scrabble,
+    maximumCharactersCount: 7,
+    name: 'Scrabble',
+    bonuses: [
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 7, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 14, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 1 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 5, y: 1 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 9, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 13, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 8, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 3, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 7, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 4 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 10, y: 4 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 1, y: 5 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 5, y: 5 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 9, y: 5 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 13, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 2, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 8, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 12, y: 6 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 7, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 7 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 14, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 2, y: 8 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 8 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 8, y: 8 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 12, y: 8 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 1, y: 9 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 5, y: 9 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 9, y: 9 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 13, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 10, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 3, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 7, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 8, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 13 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 5, y: 13 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 9, y: 13 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 13, y: 13 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 14 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 7, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 14 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 14, y: 14 },
+    ],
+};
+exports.default = scrabble;

package/packages/configs/build/games/superScrabble.d.ts

@@ -0,0 +1,18 @@
+import { Game } from '@scrabble-solver/types';
+declare const scrabble: {
+    allTilesBonusScore: number;
+    blankScore: number;
+    blanksCount: number;
+    boardHeight: number;
+    boardWidth: number;
+    game: Game;
+    maximumCharactersCount: number;
+    name: string;
+    bonuses: {
+        multiplier: number;
+        type: string;
+        x: number;
+        y: number;
+    }[];
+};
+export default scrabble;

package/packages/configs/build/games/superScrabble.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("@scrabble-solver/constants");
+const types_1 = require("@scrabble-solver/types");
+const scrabble = {
+    allTilesBonusScore: 50,
+    blankScore: 0,
+    blanksCount: 4,
+    boardHeight: 21,
+    boardWidth: 21,
+    game: types_1.Game.SuperScrabble,
+    maximumCharactersCount: 7,
+    name: 'Super Scrabble',
+    bonuses: [
+        { multiplier: 4, type: constants_1.BONUS_WORD, x: 0, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 7, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 0 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 13, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 17, y: 0 },
+        { multiplier: 4, type: constants_1.BONUS_WORD, x: 20, y: 0 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 1 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 4, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 8, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 1 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 16, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 19, y: 1 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 2 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 5, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 9, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 2 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 15, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 18, y: 2 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 3 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 3, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 3 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 10, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 3 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 17, y: 3 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 20, y: 3 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 1, y: 4 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 4 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 4 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 12, y: 4 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 16, y: 4 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 19, y: 4 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 2, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 5, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 15, y: 5 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 18, y: 5 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 6, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 14, y: 6 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 17, y: 6 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 7, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 13, y: 7 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 20, y: 7 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 8 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 4, y: 8 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 8 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 12, y: 8 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 16, y: 8 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 19, y: 8 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 5, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 15, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 18, y: 9 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 10 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 3, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 10 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 17, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 20, y: 10 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 5, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 15, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 18, y: 11 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 4, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 12, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 16, y: 12 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 19, y: 12 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 0, y: 13 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 7, y: 13 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 13, y: 13 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 20, y: 13 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 6, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 14, y: 14 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 17, y: 14 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 2, y: 15 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 5, y: 15 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 9, y: 15 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 11, y: 15 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 15, y: 15 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 18, y: 15 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 1, y: 16 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 4, y: 16 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 8, y: 16 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 12, y: 16 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 16, y: 16 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 19, y: 16 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 0, y: 17 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 3, y: 17 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 6, y: 17 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 10, y: 17 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 14, y: 17 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 17, y: 17 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 20, y: 17 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 2, y: 18 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 5, y: 18 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 9, y: 18 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 11, y: 18 },
+        { multiplier: 4, type: constants_1.BONUS_CHARACTER, x: 15, y: 18 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 18, y: 18 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 1, y: 19 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 4, y: 19 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 8, y: 19 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 12, y: 19 },
+        { multiplier: 3, type: constants_1.BONUS_CHARACTER, x: 16, y: 19 },
+        { multiplier: 2, type: constants_1.BONUS_WORD, x: 19, y: 19 },
+        { multiplier: 4, type: constants_1.BONUS_WORD, x: 0, y: 20 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 3, y: 20 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 7, y: 20 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 10, y: 20 },
+        { multiplier: 3, type: constants_1.BONUS_WORD, x: 13, y: 20 },
+        { multiplier: 2, type: constants_1.BONUS_CHARACTER, x: 17, y: 20 },
+        { multiplier: 4, type: constants_1.BONUS_WORD, x: 20, y: 20 },
+    ],
+};
+exports.default = scrabble;

package/packages/configs/build/getConfig.d.ts

@@ -1,7 +1,3 @@
-import { Config, Locale } from '@scrabble-solver/types';
-interface Result extends Record<Locale, Config> {
-    id: string;
-    name: string;
-}
-declare const getConfig: (configId: string) => Result;
+import { Config, Game, Locale } from '@scrabble-solver/types';
+declare const getConfig: (game: Game, locale: Locale) => Config;
 export default getConfig;

package/packages/configs/build/getConfig.js

@@ -1,16 +1,35 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const literaki_1 = __importDefault(require("./literaki"));
-const scrabble_1 = __importDefault(require("./scrabble"));
-const configs = [literaki_1.default, scrabble_1.default];
-const getConfig = (configId) => {
-    const config = configs.find(({ id }) => id === configId);
-    if (!config) {
-        throw new Error(`Invalid "configId" parameter: not one of ${configs.map(({ id }) => id).join('/')}`);
+const locales = __importStar(require("./locales"));
+const getConfig = (game, locale) => {
+    const configs = Object.values(locales).flat();
+    const localeConfig = configs.find((config) => config.game === game && config.locale === locale);
+    if (typeof localeConfig === 'undefined') {
+        throw new Error(`No game "${game}" in "${locale}"`);
     }
-    return config;
+    return localeConfig;
 };
 exports.default = getConfig;

package/packages/configs/build/hasConfig.d.ts

@@ -0,0 +1,3 @@
+import { Game, Locale } from '@scrabble-solver/types';
+declare const hasConfig: (game: Game, locale: Locale) => boolean;
+export default hasConfig;

package/packages/configs/build/hasConfig.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const locales = __importStar(require("./locales"));
+const hasConfig = (game, locale) => {
+    const configs = Object.values(locales).flat();
+    return configs.some((config) => config.game === game && config.locale === locale);
+};
+exports.default = hasConfig;