scrabble-solver 2.18.9 → 2.18.10-alpha.0

package/packages/scrabble-solver/public/site.webmanifest

@@ -1,14 +0,0 @@
-{
-  "name": "Scrabble Solver",
-  "short_name": "Scrabble Solver",
-  "description": "Free Scrabble word finder and board solver.",
-  "start_url": "/",
-  "display": "standalone",
-  "background_color": "#f4f4f4",
-  "theme_color": "#efe3ae",
-  "icons": [
-    { "src": "/icons/favicon-196x196.png", "sizes": "196x196", "type": "image/png" },
-    { "src": "/icons/favicon-128.png", "sizes": "128x128", "type": "image/png" },
-    { "src": "/icons/favicon.svg", "sizes": "any", "type": "image/svg+xml" }
-  ]
-}

package/packages/scrabble-solver/public/sitemap.xml

@@ -1 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"><url><loc>https://scrabble-solver.org/</loc></url></urlset>

package/packages/scrabble-solver/scripts/generate-scss-types.ts

@@ -1,112 +0,0 @@
-import { existsSync, readdirSync, readFileSync, unlinkSync, watch, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import postcss from 'postcss';
-import * as sass from 'sass';
-
-const packageDirectory = path.join(__dirname, '..');
-const sourceDirectory = path.join(packageDirectory, 'src');
-const loadPaths = [sourceDirectory, path.join(packageDirectory, '../../node_modules/include-media/dist')];
-const compiler = sass.initCompiler();
-
-generateAll();
-
-if (process.argv.includes('--watch')) {
-  watchModuleStylesheets();
-} else {
-  compiler.dispose();
-}
-
-function generateAll() {
-  const files = findModuleStylesheets();
-
-  for (const file of files) {
-    generate(file);
-  }
-
-  console.log(`Generated type definitions for ${files.length} .module.scss files`);
-}
-
-function findModuleStylesheets(): string[] {
-  return readdirSync(sourceDirectory, { encoding: 'utf8', recursive: true })
-    .filter((file) => file.endsWith('.module.scss'))
-    .sort()
-    .map((file) => path.join(sourceDirectory, file));
-}
-
-function watchModuleStylesheets() {
-  console.log(`Watching ${sourceDirectory} for .module.scss changes`);
-
-  watch(sourceDirectory, { recursive: true }, (_event, filename) => {
-    if (!filename || !filename.endsWith('.module.scss')) {
-      return;
-    }
-
-    const file = path.join(sourceDirectory, filename);
-
-    try {
-      if (existsSync(file)) {
-        generate(file);
-      } else if (existsSync(getTypesFilepath(file))) {
-        unlinkSync(getTypesFilepath(file));
-      }
-    } catch (error) {
-      console.error(String(error));
-    }
-  });
-}
-
-function generate(file: string) {
-  const { css } = compiler.compile(file, { loadPaths, quietDeps: true });
-  const content = formatTypesFile(extractClassNames(css));
-  const typesFilepath = getTypesFilepath(file);
-
-  if (!existsSync(typesFilepath) || readFileSync(typesFilepath, 'utf8') !== content) {
-    writeFileSync(typesFilepath, content);
-    console.log(`Generated ${path.relative(packageDirectory, typesFilepath)}`);
-  }
-}
-
-function extractClassNames(css: string): string[] {
-  const classNames = new Set<string>();
-  const stylesheet = postcss.parse(css);
-
-  stylesheet.walkAtRules('keyframes', (atRule) => {
-    classNames.add(atRule.params);
-  });
-
-  stylesheet.walkRules((rule) => {
-    if (rule.selector === ':export') {
-      rule.walkDecls((declaration) => {
-        classNames.add(declaration.prop);
-      });
-    } else {
-      const localSelector = rule.selector.replace(/:global\([^)]*\)/g, '');
-
-      for (const [, className] of localSelector.matchAll(/\.(-?[A-Za-z_][\w-]*)/g)) {
-        classNames.add(className);
-      }
-    }
-  });
-
-  return [...classNames].sort();
-}
-
-function formatTypesFile(classNames: string[]): string {
-  return [
-    '// Generated by scripts/generate-scss-types.ts - do not edit.',
-    'declare const styles: {',
-    ...classNames.map((className) => `  readonly ${formatKey(className)}: string;`),
-    '};',
-    '',
-    'export default styles;',
-    '',
-  ].join('\n');
-}
-
-function formatKey(className: string): string {
-  return /^[A-Za-z_$][\w$]*$/.test(className) ? className : `'${className}'`;
-}
-
-function getTypesFilepath(file: string): string {
-  return `${file}.d.ts`;
-}

package/packages/scrabble-solver/src/@types/scss.d.ts

@@ -1,6 +0,0 @@
-/**
- * Covers side-effect imports of global stylesheets. Imports of *.module.scss
- * files resolve to their sibling .d.ts files, generated by
- * scripts/generate-scss-types.ts (run via the build, type-check, and dev scripts).
- */
-declare module '*.scss' {}

package/packages/scrabble-solver/src/@types/svg.d.ts

@@ -1,7 +0,0 @@
-declare module '@/icons/*.svg' {
-  import { FunctionComponent, SVGAttributes } from 'react';
-
-  const component: FunctionComponent<SVGAttributes<SVGElement>>;
-
-  export default component;
-}

package/packages/scrabble-solver/src/api/BadRequestError.ts

@@ -1,6 +0,0 @@
-export class BadRequestError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'BadRequestError';
-  }
-}

package/packages/scrabble-solver/src/api/index.ts

@@ -1,6 +0,0 @@
-export { BadRequestError } from './BadRequestError';
-export { isBoardValid } from './isBoardValid';
-export { isCellValid } from './isCellValid';
-export { isCharacterValid } from './isCharacterValid';
-export { isRowValid } from './isRowValid';
-export { type ApiContext, withApiLog } from './withApiLog';

package/packages/scrabble-solver/src/api/isBoardValid.ts

@@ -1,41 +0,0 @@
-import { type BoardJson, type CellJson, type Config } from '@scrabble-solver/types';
-
-import { isRowValid } from './isRowValid';
-
-export const isBoardValid = (board: BoardJson, config: Config): boolean => {
-  if (board.length !== config.boardHeight) {
-    return false;
-  }
-
-  for (const row of board) {
-    if (!isRowValid(row, config)) {
-      return false;
-    }
-  }
-
-  return areTwoCharacterTilesValid(board, config);
-};
-
-const areTwoCharacterTilesValid = (board: CellJson[][], config: Config): boolean => {
-  const cells: CellJson[] = board
-    .flat()
-    .filter((cell) => cell && cell.tile && config.isTwoCharacterTilePrefix(cell.tile.character));
-
-  for (const cell of cells) {
-    for (const characters of config.twoCharacterTiles) {
-      const cellDown = board[cell.y + 1]?.[cell.x];
-      const cellRight = board[cell.y]?.[cell.x + 1];
-      const canCheckDown = cell.y + 1 < board.length && Boolean(cellDown);
-      const canCheckRight = cell.x + 1 < board[0].length && Boolean(cellRight);
-      const collidesDown = canCheckDown && cellDown.tile && cellDown.tile.character === characters[1];
-      const collidesRight = canCheckRight && cellRight.tile && cellRight.tile.character === characters[1];
-      const collides = collidesDown || collidesRight;
-
-      if (cell.tile && characters.startsWith(cell.tile.character) && collides) {
-        return false;
-      }
-    }
-  }
-
-  return true;
-};

package/packages/scrabble-solver/src/api/isCellValid.ts

@@ -1,25 +0,0 @@
-import { type CellJson, type Config } from '@scrabble-solver/types';
-
-import { isCharacterValid } from './isCharacterValid';
-
-export const isCellValid = (cell: CellJson, config: Config): boolean => {
-  const { isEmpty, tile, x, y } = cell;
-
-  if (x < 0 || x >= config.boardWidth) {
-    return false;
-  }
-
-  if (y < 0 || y >= config.boardHeight) {
-    return false;
-  }
-
-  if (isEmpty && tile !== null) {
-    return false;
-  }
-
-  if (tile !== null && !isCharacterValid(tile.character)) {
-    return false;
-  }
-
-  return true;
-};

package/packages/scrabble-solver/src/api/isCharacterValid.ts

@@ -1,12 +0,0 @@
-const TWO_TILE_CHARACTER_LENGTH = 2;
-
-const MAX_CHARACTER_LENGTH = TWO_TILE_CHARACTER_LENGTH;
-
-export const isCharacterValid = (character: string): boolean => {
-  /*
-   * We could be strict here and check whether config.hasCharacter(character) || character === BLANK
-   * but since this case won't really affect/break solving, we don't need to worry about it.
-   * It's better to display an empty state than error state in UI, so this is a sanity check only.
-   */
-  return character.length !== 0 && character.length <= MAX_CHARACTER_LENGTH;
-};

package/packages/scrabble-solver/src/api/isRowValid.ts

@@ -1,17 +0,0 @@
-import { type CellJson, type Config } from '@scrabble-solver/types';
-
-import { isCellValid } from './isCellValid';
-
-export const isRowValid = (row: CellJson[], config: Config): boolean => {
-  if (row.length !== config.boardWidth) {
-    return false;
-  }
-
-  for (const cell of row) {
-    if (!isCellValid(cell, config)) {
-      return false;
-    }
-  }
-
-  return true;
-};

package/packages/scrabble-solver/src/api/withApiLog.ts

@@ -1,85 +0,0 @@
-import { type Operation, logError, logEvent } from '@scrabble-solver/logger';
-import { isObject } from '@scrabble-solver/types';
-import { type NextApiHandler, type NextApiRequest, type NextApiResponse } from 'next';
-
-import { BadRequestError } from './BadRequestError';
-
-export interface ApiContext {
-  ip: string | undefined;
-  ua: string | undefined;
-  getElapsedMs: () => number;
-}
-
-type ApiHandler = (request: NextApiRequest, response: NextApiResponse, context: ApiContext) => Promise<void> | void;
-
-interface ErrorResponse {
-  error: string;
-  message: string;
-}
-
-const INPUT_EXCERPT_LENGTH = 1024;
-const UA_MAX_LENGTH = 512;
-
-export function withApiLog(operation: Operation, handler: ApiHandler): NextApiHandler {
-  return async (request, response) => {
-    const startedAt = performance.now();
-    const context: ApiContext = {
-      ip: getClientIp(request),
-      ua: request.headers['user-agent']?.slice(0, UA_MAX_LENGTH),
-      getElapsedMs: () => Math.round(performance.now() - startedAt),
-    };
-
-    try {
-      await handler(request, response, context);
-    } catch (error) {
-      const { ip, ua } = context;
-      const input = getInputExcerpt(request);
-
-      if (error instanceof BadRequestError) {
-        logEvent({ type: 'error', level: 'warn', operation, ip, ua, message: error.message, input });
-        respond(response, 400, { error: 'Bad request', message: error.message });
-      } else {
-        logError(operation, error, { ip, ua, input });
-        respond(response, 500, {
-          error: 'Server error',
-          message: error instanceof Error ? error.message : 'Unknown error',
-        });
-      }
-    }
-  };
-}
-
-function respond(response: NextApiResponse, status: number, body: ErrorResponse): void {
-  if (!response.headersSent) {
-    response.status(status).send(body);
-  }
-}
-
-function getClientIp(request: NextApiRequest): string | undefined {
-  const forwardedFor = request.headers['x-forwarded-for'];
-  const header = Array.isArray(forwardedFor) ? forwardedFor.at(-1) : forwardedFor;
-  const ip = header?.split(',').at(-1)?.trim() || request.socket.remoteAddress;
-  return ip?.replace(/^::ffff:/, '');
-}
-
-function getInputExcerpt(request: NextApiRequest): string {
-  const input: unknown = request.method === 'GET' ? request.query : request.body;
-
-  try {
-    return JSON.stringify(sortFieldsBySize(input) ?? null).slice(0, INPUT_EXCERPT_LENGTH);
-  } catch (error) {
-    return `(unserializable: ${String(error)})`;
-  }
-}
-
-function sortFieldsBySize(input: unknown): unknown {
-  if (!isObject(input) || Array.isArray(input)) {
-    return input;
-  }
-
-  return Object.fromEntries(Object.entries(input).sort(([, a], [, b]) => getJsonSize(a) - getJsonSize(b)));
-}
-
-function getJsonSize(value: unknown): number {
-  return JSON.stringify(value ?? null).length;
-}

package/packages/scrabble-solver/src/components/Alert/Alert.module.scss

@@ -1,52 +0,0 @@
-.alert {
-  display: flex;
-  min-width: 0;
-  width: 100%;
-  border: var(--border);
-  border-radius: var(--border--radius);
-  background-color: var(--color--white);
-  text-align: center;
-}
-
-.iconContainer {
-  flex: 0 0 auto;
-  display: flex;
-  justify-content: center;
-  padding: var(--spacing--m);
-  color: var(--color--foreground--secondary);
-  border-start-start-radius: var(--border--radius);
-  border-end-start-radius: var(--border--radius);
-  border-inline-end: var(--border);
-
-  .error & {
-    background-color: var(--color--red--light);
-    color: var(--color--error);
-  }
-
-  .info & {
-    background-color: var(--color--blue--light);
-    color: var(--color--info);
-  }
-
-  .success & {
-    background-color: var(--color--green--light);
-    color: var(--color--success);
-  }
-
-  .warning & {
-    background-color: var(--color--yellow--light);
-    color: var(--color--warning);
-  }
-}
-
-.icon {
-  $size: 24px;
-
-  width: $size;
-  height: $size;
-}
-
-.content {
-  flex: 1;
-  padding: var(--spacing--m) var(--spacing--l);
-}

package/packages/scrabble-solver/src/components/Alert/Alert.module.scss.d.ts

@@ -1,13 +0,0 @@
-// Generated by scripts/generate-scss-types.ts - do not edit.
-declare const styles: {
-  readonly alert: string;
-  readonly content: string;
-  readonly error: string;
-  readonly icon: string;
-  readonly iconContainer: string;
-  readonly info: string;
-  readonly success: string;
-  readonly warning: string;
-};
-
-export default styles;

package/packages/scrabble-solver/src/components/Alert/Alert.tsx

@@ -1,44 +0,0 @@
-import classNames from 'classnames';
-import { type FunctionComponent, type HTMLProps, type ReactNode, type SVGAttributes } from 'react';
-
-import Check from '@/icons/Check.svg';
-import CrossCircleFill from '@/icons/CrossCircleFill.svg';
-import ExclamationTriangleFill from '@/icons/ExclamationTriangleFill.svg';
-import InfoCircleFill from '@/icons/InfoCircleFill.svg';
-
-import styles from './Alert.module.scss';
-
-interface Props extends HTMLProps<HTMLDivElement> {
-  children: ReactNode;
-  className?: string;
-  variant: 'error' | 'info' | 'success' | 'warning';
-}
-
-const ICON_PER_TYPE: Record<Props['variant'], FunctionComponent<SVGAttributes<SVGElement>>> = {
-  error: CrossCircleFill,
-  info: InfoCircleFill,
-  success: Check,
-  warning: ExclamationTriangleFill,
-};
-
-export const Alert: FunctionComponent<Props> = ({ children, className, variant, ...props }) => {
-  const Icon = ICON_PER_TYPE[variant];
-
-  return (
-    <div
-      className={classNames(styles.alert, className, {
-        [styles.error]: variant === 'error',
-        [styles.info]: variant === 'info',
-        [styles.success]: variant === 'success',
-        [styles.warning]: variant === 'warning',
-      })}
-      {...props}
-    >
-      <div className={styles.iconContainer}>
-        <Icon aria-hidden="true" className={styles.icon} role="img" />
-      </div>
-
-      <div className={styles.content}>{children}</div>
-    </div>
-  );
-};

package/packages/scrabble-solver/src/components/Alert/index.ts

@@ -1 +0,0 @@
-export { Alert } from './Alert';

package/packages/scrabble-solver/src/components/Badge/Badge.module.scss

@@ -1,12 +0,0 @@
-.badge {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  padding: var(--spacing--xs) var(--spacing--m);
-  border: var(--border);
-  border-radius: var(--border--radius);
-  background-color: var(--color--background--element);
-  line-height: var(--line-height);
-  font-size: var(--font--size--m);
-  font-weight: bold;
-}

package/packages/scrabble-solver/src/components/Badge/Badge.module.scss.d.ts

@@ -1,6 +0,0 @@
-// Generated by scripts/generate-scss-types.ts - do not edit.
-declare const styles: {
-  readonly badge: string;
-};
-
-export default styles;

package/packages/scrabble-solver/src/components/Badge/Badge.tsx

@@ -1,13 +0,0 @@
-import classNames from 'classnames';
-import { type FunctionComponent, type ReactNode } from 'react';
-
-import styles from './Badge.module.scss';
-
-interface Props {
-  children?: ReactNode;
-  className?: string;
-}
-
-export const Badge: FunctionComponent<Props> = ({ children, className }) => (
-  <div className={classNames(styles.badge, className)}>{children}</div>
-);

package/packages/scrabble-solver/src/components/Badge/index.ts

@@ -1 +0,0 @@
-export { Badge } from './Badge';

package/packages/scrabble-solver/src/components/Board/Board.module.scss

@@ -1,83 +0,0 @@
-@use 'styles/animations';
-@use 'styles/mixins' as *;
-
-.board {
-  --tile-size: var(--cell-size);
-  --coordinate-track-size: calc(var(--coordinate-size) - var(--border--width));
-
-  display: grid;
-  grid-template-columns: var(--coordinate-track-size) repeat(var(--board-cols), var(--cell-size));
-  grid-template-rows: var(--coordinate-track-size) repeat(var(--board-rows), var(--cell-size));
-  gap: var(--border--width);
-  box-shadow: var(--box-shadow);
-  background-color: white;
-  background-size: 100% 100%;
-  border: var(--border);
-  border-radius: var(--border--radius);
-  font-size: max(14px, calc(var(--cell-size) * 0.6));
-}
-
-.floating {
-  position: absolute;
-  z-index: var(--z-index--actions);
-  width: max-content;
-  height: max-content;
-  animation: var(--transition--duration) var(--transition--easing) show;
-}
-
-.focus {
-  @include focus-effect;
-
-  width: var(--cell-size);
-  height: var(--cell-size);
-  cursor: text;
-
-  &::after {
-    content: '';
-    box-shadow: 0 0 0 var(--focus-effect--size) var(--color--focus);
-  }
-}
-
-.hidden {
-  pointer-events: none;
-  user-select: none;
-  animation: var(--transition--duration) var(--transition--easing) hide;
-}
-
-.iconContainer {
-  position: absolute;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  pointer-events: none;
-  user-select: none;
-}
-
-.iconBackground,
-.icon {
-  position: absolute;
-  inset: calc((100% - var(--size)) / 2);
-  width: var(--size);
-  height: var(--size);
-}
-
-.iconBackground {
-  --size: 80%;
-
-  border-radius: var(--border--radius);
-  background-color: var(--color--foreground--secondary);
-}
-
-.icon {
-  --size: 40%;
-
-  color: var(--color--white);
-}
-
-.coordinate {
-  position: relative;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-size: calc(0.3 * var(--cell-size));
-}

package/packages/scrabble-solver/src/components/Board/Board.module.scss.d.ts

@@ -1,17 +0,0 @@
-// Generated by scripts/generate-scss-types.ts - do not edit.
-declare const styles: {
-  readonly board: string;
-  readonly coordinate: string;
-  readonly floating: string;
-  readonly focus: string;
-  readonly hidden: string;
-  readonly hide: string;
-  readonly icon: string;
-  readonly iconBackground: string;
-  readonly iconContainer: string;
-  readonly rotate: string;
-  readonly show: string;
-  readonly wave: string;
-};
-
-export default styles;