scrabble-solver 2.18.9 → 2.18.10-alpha.1

package/packages/types/build/lib/transpose.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transpose = transpose;
-function transpose(array) {
-    const rows = array.length;
-    const cols = array[0].length;
-    const transposed = Array(cols)
-        .fill(null)
-        .map(() => Array(rows));
-    for (let y = 0; y < rows; ++y) {
-        for (let x = 0; x < cols; ++x) {
-            transposed[x][y] = array[y][x];
-        }
-    }
-    return transposed;
-}

package/packages/types/build/type-guards/index.d.ts

@@ -1,10 +0,0 @@
-export { isBingo } from './isBingo';
-export { isBoardJson } from './isBoardJson';
-export { isCellJson } from './isCellJson';
-export { isError } from './isError';
-export { isGame } from './isGame';
-export { isLocale } from './isLocale';
-export { isMultiplierBingo } from './isMultiplierBingo';
-export { isObject } from './isObject';
-export { isScoreBingo } from './isScoreBingo';
-export { isTileJson } from './isTileJson';

package/packages/types/build/type-guards/index.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTileJson = exports.isScoreBingo = exports.isObject = exports.isMultiplierBingo = exports.isLocale = exports.isGame = exports.isError = exports.isCellJson = exports.isBoardJson = exports.isBingo = void 0;
-var isBingo_1 = require("./isBingo");
-Object.defineProperty(exports, "isBingo", { enumerable: true, get: function () { return isBingo_1.isBingo; } });
-var isBoardJson_1 = require("./isBoardJson");
-Object.defineProperty(exports, "isBoardJson", { enumerable: true, get: function () { return isBoardJson_1.isBoardJson; } });
-var isCellJson_1 = require("./isCellJson");
-Object.defineProperty(exports, "isCellJson", { enumerable: true, get: function () { return isCellJson_1.isCellJson; } });
-var isError_1 = require("./isError");
-Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return isError_1.isError; } });
-var isGame_1 = require("./isGame");
-Object.defineProperty(exports, "isGame", { enumerable: true, get: function () { return isGame_1.isGame; } });
-var isLocale_1 = require("./isLocale");
-Object.defineProperty(exports, "isLocale", { enumerable: true, get: function () { return isLocale_1.isLocale; } });
-var isMultiplierBingo_1 = require("./isMultiplierBingo");
-Object.defineProperty(exports, "isMultiplierBingo", { enumerable: true, get: function () { return isMultiplierBingo_1.isMultiplierBingo; } });
-var isObject_1 = require("./isObject");
-Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return isObject_1.isObject; } });
-var isScoreBingo_1 = require("./isScoreBingo");
-Object.defineProperty(exports, "isScoreBingo", { enumerable: true, get: function () { return isScoreBingo_1.isScoreBingo; } });
-var isTileJson_1 = require("./isTileJson");
-Object.defineProperty(exports, "isTileJson", { enumerable: true, get: function () { return isTileJson_1.isTileJson; } });

package/packages/types/build/type-guards/isBingo.d.ts

@@ -1,2 +0,0 @@
-import { type Bingo } from '../Bingo';
-export declare const isBingo: (value: unknown) => value is Bingo;

package/packages/types/build/type-guards/isBingo.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBingo = void 0;
-const isMultiplierBingo_1 = require("./isMultiplierBingo");
-const isScoreBingo_1 = require("./isScoreBingo");
-const isBingo = (value) => {
-    return (0, isScoreBingo_1.isScoreBingo)(value) || (0, isMultiplierBingo_1.isMultiplierBingo)(value);
-};
-exports.isBingo = isBingo;

package/packages/types/build/type-guards/isBoardJson.d.ts

@@ -1,2 +0,0 @@
-import { type BoardJson } from '../BoardJson';
-export declare const isBoardJson: (value: unknown) => value is BoardJson;

package/packages/types/build/type-guards/isBoardJson.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isBoardJson = void 0;
-const isCellJson_1 = require("./isCellJson");
-const isBoardJson = (value) => {
-    if (!Array.isArray(value)) {
-        return false;
-    }
-    for (const row of value) {
-        if (!Array.isArray(row)) {
-            return false;
-        }
-        for (const cell of row) {
-            if (!(0, isCellJson_1.isCellJson)(cell)) {
-                return false;
-            }
-        }
-    }
-    return true;
-};
-exports.isBoardJson = isBoardJson;

package/packages/types/build/type-guards/isCellJson.d.ts

@@ -1,2 +0,0 @@
-import { type CellJson } from '../CellJson';
-export declare const isCellJson: (value: unknown) => value is CellJson;

package/packages/types/build/type-guards/isCellJson.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCellJson = void 0;
-const isObject_1 = require("./isObject");
-const isTileJson_1 = require("./isTileJson");
-const isCellJson = (value) => {
-    return ((0, isObject_1.isObject)(value) &&
-        typeof value.isEmpty === 'boolean' &&
-        ((0, isTileJson_1.isTileJson)(value.tile) || value.tile === null) &&
-        typeof value.x === 'number' &&
-        typeof value.y === 'number');
-};
-exports.isCellJson = isCellJson;

package/packages/types/build/type-guards/isError.d.ts

@@ -1 +0,0 @@
-export declare const isError: (value: unknown) => value is Error;

package/packages/types/build/type-guards/isError.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isError = void 0;
-const isObject_1 = require("./isObject");
-const isError = (value) => {
-    if (!(0, isObject_1.isObject)(value)) {
-        return false;
-    }
-    return typeof value.message === 'string';
-};
-exports.isError = isError;

package/packages/types/build/type-guards/isGame.d.ts

@@ -1,2 +0,0 @@
-import { Game } from '../Game';
-export declare const isGame: (locale: unknown) => locale is Game;

package/packages/types/build/type-guards/isGame.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isGame = void 0;
-const Game_1 = require("../Game");
-const games = Object.values(Game_1.Game);
-const isGame = (locale) => games.includes(locale);
-exports.isGame = isGame;

package/packages/types/build/type-guards/isLocale.d.ts

@@ -1,2 +0,0 @@
-import { Locale } from '../Locale';
-export declare const isLocale: (locale: unknown) => locale is Locale;

package/packages/types/build/type-guards/isLocale.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLocale = void 0;
-const Locale_1 = require("../Locale");
-const locales = Object.values(Locale_1.Locale);
-const isLocale = (locale) => locales.includes(locale);
-exports.isLocale = isLocale;

package/packages/types/build/type-guards/isMultiplierBingo.d.ts

@@ -1,2 +0,0 @@
-import { type MultiplierBingo } from '../Bingo';
-export declare const isMultiplierBingo: (value: unknown) => value is MultiplierBingo;

package/packages/types/build/type-guards/isMultiplierBingo.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMultiplierBingo = void 0;
-const isObject_1 = require("./isObject");
-const isMultiplierBingo = (value) => {
-    return (0, isObject_1.isObject)(value) && 'multiplier' in value && typeof value.multiplier === 'number';
-};
-exports.isMultiplierBingo = isMultiplierBingo;

package/packages/types/build/type-guards/isObject.d.ts

@@ -1 +0,0 @@
-export declare const isObject: (value: unknown) => value is Record<string, unknown>;

package/packages/types/build/type-guards/isObject.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isObject = void 0;
-const isObject = (value) => {
-    return typeof value === 'object' && value !== null;
-};
-exports.isObject = isObject;

package/packages/types/build/type-guards/isScoreBingo.d.ts

@@ -1,2 +0,0 @@
-import { type ScoreBingo } from '../Bingo';
-export declare const isScoreBingo: (value: unknown) => value is ScoreBingo;

package/packages/types/build/type-guards/isScoreBingo.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isScoreBingo = void 0;
-const isObject_1 = require("./isObject");
-const isScoreBingo = (value) => {
-    return (0, isObject_1.isObject)(value) && 'score' in value && typeof value.score === 'number';
-};
-exports.isScoreBingo = isScoreBingo;

package/packages/types/build/type-guards/isTileJson.d.ts

@@ -1,2 +0,0 @@
-import { type TileJson } from '../TileJson';
-export declare const isTileJson: (value: unknown) => value is TileJson;

package/packages/types/build/type-guards/isTileJson.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTileJson = void 0;
-const isObject_1 = require("./isObject");
-const isTileJson = (value) => {
-    return (0, isObject_1.isObject)(value) && typeof value.character === 'string' && typeof value.isBlank === 'boolean';
-};
-exports.isTileJson = isTileJson;

package/packages/types/package.json

@@ -1,37 +0,0 @@
-{
-  "name": "@scrabble-solver/types",
-  "version": "2.18.9",
-  "description": "Domain model for Scrabble Solver: Board, Cell, Tile, Result, Config, Locale, and their JSON wire shapes.",
-  "keywords": [
-    "scrabble",
-    "types",
-    "domain-model",
-    "board",
-    "tiles"
-  ],
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/kamilmielnik/scrabble-solver.git"
-  },
-  "author": {
-    "name": "Kamil Mielnik",
-    "email": "kamil@kamilmielnik.com",
-    "url": "https://kamilmielnik.com"
-  },
-  "license": "CC-BY-NC-ND-4.0",
-  "bugs": {
-    "url": "https://github.com/kamilmielnik/scrabble-solver/issues"
-  },
-  "homepage": "https://scrabble-solver.org",
-  "scripts": {
-    "build": "tsc --project .",
-    "clean": "rimraf build/",
-    "test": "bun test src"
-  },
-  "dependencies": {
-    "@scrabble-solver/constants": "2.18.9"
-  },
-  "gitHead": "f029a11f306a01937ee99fc6365cb226b972dfed"
-}

package/packages/types/src/Bingo.ts

@@ -1,5 +0,0 @@
-export type MultiplierBingo = { multiplier: number };
-
-export type ScoreBingo = { score: number };
-
-export type Bingo = MultiplierBingo | ScoreBingo;

package/packages/types/src/Board.test.ts

@@ -1,85 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-
-import { Board } from './Board';
-import { Cell } from './Cell';
-import { Tile } from './Tile';
-
-describe('Board.getWords', () => {
-  it('returns no words for an empty board', () => {
-    const board = Board.fromStringArray(['     ', '     ', '     ', '     ', '     ']);
-
-    expect(board.getWords()).toEqual([]);
-  });
-
-  it('locates a horizontal word', () => {
-    const board = Board.fromStringArray(['     ', ' cat ', '     ', '     ', '     ']);
-
-    expect(board.getWords()).toEqual([{ direction: 'horizontal', word: 'cat', x: 1, y: 1 }]);
-  });
-
-  it('locates a vertical word', () => {
-    const board = Board.fromStringArray(['     ', '  c  ', '  a  ', '  t  ', '     ']);
-
-    expect(board.getWords()).toEqual([{ direction: 'vertical', word: 'cat', x: 2, y: 1 }]);
-  });
-
-  it('locates crossing words in both directions', () => {
-    const board = Board.fromStringArray(['     ', ' cat ', ' o   ', ' d   ', '     ']);
-
-    expect(board.getWords()).toEqual([
-      { direction: 'horizontal', word: 'cat', x: 1, y: 1 },
-      { direction: 'vertical', word: 'cod', x: 1, y: 1 },
-    ]);
-  });
-
-  it('distinguishes the same word at different positions', () => {
-    const board = Board.fromStringArray(['cat  ', '     ', '  cat', '     ', '     ']);
-
-    expect(board.getWords()).toEqual([
-      { direction: 'horizontal', word: 'cat', x: 0, y: 0 },
-      { direction: 'horizontal', word: 'cat', x: 2, y: 2 },
-    ]);
-  });
-
-  it('skips single-tile runs', () => {
-    const board = Board.fromStringArray(['     ', ' a   ', '     ', '   to', '     ']);
-
-    expect(board.getWords()).toEqual([{ direction: 'horizontal', word: 'to', x: 3, y: 3 }]);
-  });
-
-  it('locates a word with a digraph tile occupying a single cell', () => {
-    const board = Board.fromStringArray(['   ', '  e', '   ']);
-    board.updateCell(1, 1, () => new Cell({ isEmpty: false, tile: new Tile({ character: 'ch' }), x: 1, y: 1 }));
-
-    expect(board.getWords()).toEqual([{ direction: 'horizontal', word: 'che', x: 1, y: 1 }]);
-  });
-});
-
-describe('Board.getCollidingWords', () => {
-  const board = Board.fromStringArray(['     ', ' cat ', ' o  o', ' dot ', '     ']);
-
-  it('finds the words crossing each cell of a horizontal word', () => {
-    expect(board.getCollidingWords({ direction: 'horizontal', word: 'cat', x: 1, y: 1 })).toEqual([
-      { direction: 'vertical', word: 'cod', x: 1, y: 1 },
-    ]);
-  });
-
-  it('finds the words crossing each cell of a vertical word', () => {
-    expect(board.getCollidingWords({ direction: 'vertical', word: 'cod', x: 1, y: 1 })).toEqual([
-      { direction: 'horizontal', word: 'cat', x: 1, y: 1 },
-      { direction: 'horizontal', word: 'dot', x: 1, y: 3 },
-    ]);
-  });
-
-  it('finds a crossing word entered away from its start', () => {
-    expect(board.getCollidingWords({ direction: 'horizontal', word: 'dot', x: 1, y: 3 })).toEqual([
-      { direction: 'vertical', word: 'cod', x: 1, y: 1 },
-    ]);
-  });
-
-  it('returns no words for a word without crossings', () => {
-    const lonely = Board.fromStringArray(['     ', ' cat ', '     ', '     ', '     ']);
-
-    expect(lonely.getCollidingWords({ direction: 'horizontal', word: 'cat', x: 1, y: 1 })).toEqual([]);
-  });
-});

package/packages/types/src/Board.ts

@@ -1,141 +0,0 @@
-import { EMPTY_CELL } from '@scrabble-solver/constants';
-
-import { type BoardJson } from './BoardJson';
-import { type BoardWord } from './BoardWord';
-import { Cell } from './Cell';
-import { getBoardWords, getCollidingWords } from './lib';
-import { Tile } from './Tile';
-
-export class Board {
-  public static create = (width: number, height: number): Board => {
-    const rows = Array(height);
-    const emptyRow = Array(width).fill(' ').join('');
-    const emptyRows: string[] = rows.fill(emptyRow);
-    return Board.fromStringArray(emptyRows);
-  };
-
-  public static fromJson = (json: BoardJson): Board => {
-    return new Board({
-      rows: json.map((row) => row.map(Cell.fromJson)),
-    });
-  };
-
-  public static fromStringArray(stringArray: string[]): Board {
-    return new Board({
-      rows: stringArray.map((row, y) =>
-        row.split('').map(
-          (character, x) =>
-            new Cell({
-              isEmpty: !character || character === EMPTY_CELL,
-              tile: character === EMPTY_CELL ? Tile.Null : new Tile({ character }),
-              x,
-              y,
-            }),
-        ),
-      ),
-    });
-  }
-
-  public readonly columnsCount: number;
-
-  public readonly rows: Cell[][];
-
-  public readonly rowsCount: number;
-
-  constructor({ rows }: { rows: Cell[][] }) {
-    this.rows = rows;
-    this.columnsCount = rows[0].length;
-    this.rowsCount = rows.length;
-  }
-
-  public get center(): Cell {
-    const x = Math.floor(this.columnsCount / 2);
-    const y = Math.floor(this.rowsCount / 2);
-    return this.rows[y][x];
-  }
-
-  public clone(): Board {
-    const rows = this.rows.map((row) => row.map((cell) => cell.clone()));
-    return new Board({ rows });
-  }
-
-  public collides(cell: Cell): boolean {
-    return this.collidesUp(cell) || this.collidesDown(cell) || this.collidesLeft(cell) || this.collidesRight(cell);
-  }
-
-  public collidesDown({ x, y }: Cell): boolean {
-    return y < this.rowsCount - 1 && !this.rows[y + 1][x].isEmpty;
-  }
-
-  public collidesLeft({ x, y }: Cell): boolean {
-    return x > 0 && !this.rows[y][x - 1].isEmpty;
-  }
-
-  public collidesRight({ x, y }: Cell): boolean {
-    return x < this.columnsCount - 1 && !this.rows[y][x + 1].isEmpty;
-  }
-
-  public collidesUp({ x, y }: Cell): boolean {
-    return y > 0 && !this.rows[y - 1][x].isEmpty;
-  }
-
-  public equals(other: Board): boolean {
-    return (
-      this.columnsCount === other.columnsCount &&
-      this.rowsCount === other.rowsCount &&
-      this.rows.every((row, rowIndex) => {
-        return row.every((cell, cellIndex) => {
-          return cell.equals(other.rows[rowIndex][cellIndex]);
-        });
-      })
-    );
-  }
-
-  public getBlanksCount(): number {
-    return this.rows.reduce((count, row) => {
-      return count + row.reduce((rowCount, cell) => rowCount + (cell.tile.isBlank ? 1 : 0), 0);
-    }, 0);
-  }
-
-  public getCollidingWords(word: BoardWord): BoardWord[] {
-    return getCollidingWords(this, word);
-  }
-
-  public getColumn(index: number): Cell[] {
-    return this.rows.map((row) => row[index]);
-  }
-
-  public getRow(index: number): Cell[] {
-    return this.rows[index];
-  }
-
-  public getTilesCount(): number {
-    return this.rows.reduce((count, row) => {
-      return count + row.reduce((rowCount, cell) => rowCount + (cell.hasTile() ? 1 : 0), 0);
-    }, 0);
-  }
-
-  public getWords(): BoardWord[] {
-    return getBoardWords(this);
-  }
-
-  public isEmpty(): boolean {
-    return this.rows.every((row) => row.every(({ isEmpty }) => isEmpty));
-  }
-
-  public toJson(): BoardJson {
-    return this.rows.map((row) => row.map((cell) => cell.toJson()));
-  }
-
-  public toString(): string {
-    return this.rows.map((row) => row.map(String).join('')).join('\n');
-  }
-
-  public updateCell(x: number, y: number, updateCell: (cell: Cell) => Cell): void {
-    this.rows[y][x] = updateCell(this.rows[y][x]);
-  }
-
-  public updateRow(y: number, updateRow: (cells: Cell[]) => Cell[]): void {
-    this.rows[y] = updateRow(this.rows[y]);
-  }
-}

package/packages/types/src/BoardJson.ts

@@ -1,3 +0,0 @@
-import { type CellJson } from './CellJson';
-
-export type BoardJson = CellJson[][];

package/packages/types/src/BoardWord.ts

@@ -1,8 +0,0 @@
-import { type Direction } from './Direction';
-
-export interface BoardWord {
-  direction: Direction;
-  word: string;
-  x: number;
-  y: number;
-}

package/packages/types/src/Bonus.ts

@@ -1,50 +0,0 @@
-import { type BONUS_CHARACTER, type BONUS_WORD } from '@scrabble-solver/constants';
-
-import { type BonusJson } from './BonusJson';
-import { type BonusValue } from './BonusValue';
-import { type Cell } from './Cell';
-import { type Config } from './Config';
-
-export abstract class Bonus {
-  public readonly multiplier: number;
-
-  public readonly score: number | undefined;
-
-  public abstract readonly type: typeof BONUS_CHARACTER | typeof BONUS_WORD;
-
-  public readonly x: number;
-
-  public readonly y: number;
-
-  constructor({ multiplier, score, x, y }: { multiplier: number; score?: number; x: number; y: number }) {
-    this.multiplier = multiplier;
-    this.score = score;
-    this.x = x;
-    this.y = y;
-  }
-
-  public canApply(_config: Config, cell: Cell): boolean {
-    return cell.isEmpty && this.matchesCellCoordinates(cell);
-  }
-
-  public matchesCellCoordinates(cell: Cell): boolean {
-    return this.x === cell.x && this.y === cell.y;
-  }
-
-  public toJson(): BonusJson {
-    return {
-      multiplier: this.multiplier,
-      score: this.score,
-      type: this.type,
-      x: this.x,
-      y: this.y,
-    };
-  }
-
-  public get value(): BonusValue {
-    return {
-      characterMultiplier: 1,
-      wordMultiplier: 1,
-    };
-  }
-}

package/packages/types/src/BonusJson.ts

@@ -1,7 +0,0 @@
-export interface BonusJson {
-  multiplier: number;
-  score?: number;
-  type: string;
-  x: number;
-  y: number;
-}

package/packages/types/src/BonusValue.ts

@@ -1,4 +0,0 @@
-export interface BonusValue {
-  characterMultiplier: number;
-  wordMultiplier: number;
-}

package/packages/types/src/Cell.ts

@@ -1,66 +0,0 @@
-import { type CellJson } from './CellJson';
-import { Tile } from './Tile';
-
-export class Cell {
-  public static fromJson = (json: CellJson): Cell => {
-    return new Cell({
-      isEmpty: json.isEmpty,
-      tile: Tile.fromJson(json.tile),
-      x: json.x,
-      y: json.y,
-    });
-  };
-
-  public readonly isEmpty: boolean;
-
-  public tile: Tile;
-
-  public readonly x: number;
-
-  public readonly y: number;
-
-  constructor({ isEmpty = true, tile = Tile.Null, x, y }: { isEmpty?: boolean; tile?: Tile; x: number; y: number }) {
-    this.isEmpty = isEmpty;
-    this.tile = tile;
-    this.x = x;
-    this.y = y;
-  }
-
-  public clone(): Cell {
-    return new Cell({
-      isEmpty: this.isEmpty,
-      tile: this.tile.clone(),
-      x: this.x,
-      y: this.y,
-    });
-  }
-
-  public equals(other: Cell): boolean {
-    return this.x === other.x && this.y === other.y && this.isEmpty === other.isEmpty && this.tile.equals(other.tile);
-  }
-
-  public hasTile(): boolean {
-    return this.tile !== Tile.Null;
-  }
-
-  public isCandidate(): boolean {
-    return this.isEmpty && this.hasTile();
-  }
-
-  public isFilled(): boolean {
-    return !this.isEmpty && this.hasTile();
-  }
-
-  public toJson(): CellJson {
-    return {
-      isEmpty: this.isEmpty,
-      tile: this.tile.toJson(),
-      x: this.x,
-      y: this.y,
-    };
-  }
-
-  public toString(): string {
-    return this.tile.toString();
-  }
-}

package/packages/types/src/CellJson.ts

@@ -1,8 +0,0 @@
-import { type TileJson } from './TileJson';
-
-export interface CellJson {
-  isEmpty: boolean;
-  tile: TileJson | null;
-  x: number;
-  y: number;
-}