@slugbugblue/trax 0.23.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @slugbugblue/trax
 
+## 1.0.1 - 2026-02-20
+
+- Add references for ambient typescript definitions
+
+## 1.0.0 - 2025-11-04
+
+v1 release:
+
+- Update dev dependencies to latest versions
+- Fix xo complaints
+- No other code changes
+
 ## 0.23.0 - 2023-03-28
 
 Release candidate
@@ -18,7 +30,6 @@ Finalize work with jsdoc/typescript
 ## 0.21.0 - 2023-03-12
 
 - Update the analysis engine to be more lazy
-
   - The LRU cache is more likely to have a hit because it no longer separates
     validated from unvalidated analyses
   - Suggestions are much faster because it now skips validations for low-scoring
@@ -43,23 +54,19 @@ Finalize work with jsdoc/typescript
 ## 0.18.0 - 2023-02-05
 
 - Analysis improvements:
-
   - Add `count.b(level)` and `count.w(level)` methods to an analysis to quickly
     count the number of threats at a given level
   - Remove faulty threats from an analysis
   - Add additional threats for more puzzle solving mojo
 
 - Development environment enhancements:
-
   - Added an initial benchmarking framework with puzzle benchmarks so far
   - Added husky pre-commit hook to ensure npm test is run before a commit
 
 - CLI improvements:
-
   - Puzzle information is now stored as notes, to make it searchable
 
 - More puzzles:
-
   - Martin M. S. Pedersen contributed eleven new puzzles
 
 ## 0.17.0 - 2022-12-29
@@ -69,7 +76,6 @@ Finalize work with jsdoc/typescript
 ## 0.16.0 - 2022-12-27
 
 - Added a `notes` command to the CLI to add comments to a game
-
   - all comments are included in the output generated by the `export` command
   - the latest comment can be used as a text filter by the `list` command
   - the latest comment is displayed by the `view` and `list` commands
@@ -79,17 +85,14 @@ Finalize work with jsdoc/typescript
 ## 0.15.0 - 2022-12-14
 
 - Added shared `puzzles` commands to the CLI:
-
   - `trax ls puzzles`: see all the puzzles
   - `trax new puzzle`: start a new puzzle
 
 - Puzzle improvements:
-
   - Adjust puzzle category levels for harder puzzles
   - Add multiple hints when the puzzle can be solved multiple ways
 
 - Analysis improvements:
-
   - Analysis suggestions now "solve" all tough puzzles
   - Reworked threats to be more precise
   - Reworked scoring to add more nuance
@@ -97,7 +100,6 @@ Finalize work with jsdoc/typescript
 ## 0.14.0 - 2022-12-05
 
 - Added `puzzles` to the CLI:
-
   - `trax puzzles ls`: see all the puzzles
   - `trax puzzle new`: start a new puzzle
 
@@ -108,13 +110,11 @@ Finalize work with jsdoc/typescript
 ## 0.13.0 - 2022-11-25
 
 - Add move suggestions to `analyst.js` for CLI and bot use
-
   - use `suggest(trax)` to get a suggestion for the current position
   - added the `suggest` CLI command for quick access to a random suggestion
 
 - Use font glyphs for text bubbles in `tty.js` only if one of the following
   environment variables are defined and non-empty:
-
   - `NERDFONT`, `POWERLINE`, `P9K_TTY`, `P9K_SSH`
 
 - Begin work on documenting the javascript files using jsdoc, with the initial
@@ -131,7 +131,6 @@ Finalize work with jsdoc/typescript
   `play()`. `playMove()` is no longer available.
 - Add a new function `playMoves()` to submit multiple moves at once
 - Initial work on `analyst.js`, with documentation and a start on tests
-
   - use `analyze(trax)` to perform an analysis
   - added the `analyze` CLI command to see an analysis
 
@@ -191,7 +190,6 @@ variables from snake_case to camelCase.
 - The name and signature for provisional move handling, which was broken, has
   been changed. It is now called `provisional_moves()` and takes three
   arguments:
-
   - `from`: the normalized position code of the board before the move
   - `to`: the normalized position code of the board after the move
   - `via`: the move notation to go from `from` to `to`
@@ -227,7 +225,6 @@ More convenience:
 Initial release:
 
 - engine.js
-
   - create a new Trax game with `trax = new Trax()`
   - play one move at a time with `trax.play('@0/')`
   - ... etc

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright © 2021-2023 Chad Transtrum
+   Copyright © 2019-2026 Chad Transtrum
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -71,7 +71,7 @@ Trax][gnutrax] for over two decades, and has a lot of expertise in this area.
 
 ## License
 
-Copyright 2019-2023 Chad Transtrum
+Copyright 2019-2026 Chad Transtrum
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 the files in this project except in compliance with the License. You may obtain

package/docs/engine.md

@@ -75,7 +75,6 @@ trax = new Trax(rules, moves, id)
   that if an array is used, each item in the array should be a notation string.
   If a string is used instead, it is permissible to include the move numbers of
   each move as well. As an example, the following are equivalent:
-
   - `['@0/', '@1+', 'B0\\']`
   - `'1. @0/ 2. @1+ 3. B0\\'`
   - `@0/ @1+ b0\\`
@@ -414,7 +413,7 @@ tie.
 
 ## License
 
-Copyright 2019-2023 Chad Transtrum
+Copyright 2019-2026 Chad Transtrum
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 the files in this project except in compliance with the License. You may obtain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slugbugblue/trax",
-  "version": "0.23.0",
+  "version": "1.0.1",
   "description": "Trax game engine",
   "keywords": [
     "trax",
@@ -19,25 +19,25 @@
   },
   "repository": "gitlab:slugbugblue/trax",
   "scripts": {
-    "genversion": "genversion --es6 src/version.js",
+    "genversion": "genversion --esm src/version.js",
     "git-add": "git add src/version.js",
     "test": "xo && c8 ava",
-    "prepare": "husky install",
+    "prepare": "[ -n \"$CI\" ] || husky",
     "preversion": "npm test",
     "version": "npm run genversion ; npm run git-add",
-    "postversion": "git push && git push --tags && npm publish"
+    "postversion": "git push && git push --tags"
   },
   "dependencies": {
     "@slugbugblue/lru": "^1.0.0",
     "@slugbugblue/point": "^1.0.0"
   },
   "devDependencies": {
-    "ava": "^5.1.0",
-    "c8": "^7.11.0",
+    "ava": "^6.4.1",
+    "c8": "^10.1.3",
     "genversion": "^3.0.2",
-    "husky": "^8.0.3",
-    "prettier": "^2.6.1",
-    "xo": "0.*"
+    "husky": "^9.1.7",
+    "prettier": "^3.6.2",
+    "xo": "^1.2.3"
   },
   "type": "module",
   "engines": {
@@ -60,6 +60,7 @@
   },
   "xo": {
     "prettier": true,
+    "space": true,
     "rules": {
       "curly": [
         "error",

package/src/engine.js

@@ -1,9 +1,11 @@
 /** Trax engine.
- * @copyright 2019-2022
+ * @copyright 2019-2026
  * @author Chad Transtrum <chad@transtrum.net>
  * @license Apache-2.0
  */
 
+/// <reference path="./types.d.ts" />
+
 import { Point } from '@slugbugblue/point'
 
 // Fun trax helper constants
@@ -110,50 +112,42 @@ const addBlank = (code) => {
  * @returns {number} - the actual length of the row
  */
 const codeRowLength = (row) =>
-  row.replace(/\d/g, (n) => '.'.repeat(Number(n) + 1)).length
+  row.replaceAll(/\d/g, (n) => '.'.repeat(Number(n) + 1)).length
 
 // This is where the magic happens
 /** A digital representation of a Trax game. */
 export class Trax {
   // Static class properties
-
   /** @readonly @type {Record<TraxVariant, string>} */
   static names = {
     trax: 'Trax',
     traxloop: 'Loop Trax',
     trax8: '8x8 Trax',
   }
-
   /** @readonly */
   static variants = new Set(Object.keys(this.names)) // Known variants
-
   // Static class methods
-
   /** Create an x,y Point object with special functions.
    * @arg {number|PointLike} x - either the x value, or an object with x,y keys
    * @arg {number} [y] - if x is a number, y must be provided as well
    * @returns {Point} a new Point object
    */
   static point = (x, y) => new Point(x, y)
-
   /** Given a player number, get the color.
    * @arg {number} playerNumber - the player number, 1 or 2
    * @returns {Color} the color of that player, w or b
    */
-  static colorOf = (playerNumber) => ({ 1: 'w', 2: 'b' }[playerNumber])
-
+  static colorOf = (playerNumber) => ({ 1: 'w', 2: 'b' })[playerNumber]
   /** Given a color, get the player number.
    * @arg {string} color - the color, w or b
    * @returns {number} the player number, 1 or 2
    */
-  static playerNumber = (color) => ({ b: 2, w: 1 }[color])
-
+  static playerNumber = (color) => ({ b: 2, w: 1 })[color]
   /** Given a color, get the other color.
    * @arg {string} color - the color, w or b
    * @returns {Color} the other color, b or w
    */
-  static other = (color) => ({ b: 'w', w: 'b' }[color])
-
+  static other = (color) => ({ b: 'w', w: 'b' })[color]
   /** Encode a numeric column number into the Trax notation column letter.
    * @arg {number} col - the colum number, with 0 just to the left of the tiles
    * @returns {string} the encoded column letter
@@ -168,7 +162,6 @@ export class Trax {
 
     return n || '@'
   }
-
   /** Decode a Trax notation column letter back to a number.
    * @arg {string} col - the Trax column letter
    * @returns {number} the column number
@@ -626,12 +619,12 @@ export class Trax {
       moves = moves.join(' ')
     }
 
-    moves = moves.replace(/\n/g, ' ').split(/\s+/)
+    moves = moves.replaceAll('\n', ' ').split(/\s+/)
 
     let moveNumber = 0
     for (const move of moves) {
       if (moveNumberRegex.test(move)) {
-        moveNumber = Number(move.replace(/\D/g, ''))
+        moveNumber = Number(move.replaceAll(/\D/g, ''))
       }
 
       if (notationRegex.test(move)) {
@@ -663,7 +656,7 @@ export class Trax {
   /** An array of the moves made in the game. */
   get moves() {
     return this.notation
-      .replace(/\n/g, ' ')
+      .replaceAll('\n', ' ')
       .split(' ')
       .filter((n) => Boolean(n) && !n.endsWith('.'))
   }

package/src/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '0.23.0'
+export const version = '1.0.1'