cubing 0.61.3 → 0.62.1

package/README.md

@@ -66,7 +66,7 @@ make dev
 # Now visit http://cubing.localhost:3333
 ```
 
-To quickly check any changes for issues, try `make test-fast`. Run `make test` for more thorough testing options.
+To quickly check any changes for issues, try `make check-fast`. Run `make check` to run all possible checks.
 
 ### Developing on Windows
 

package/dist/bin/chunks/{chunk-5WXNSJ2M.js → chunk-7HTSOKX4.js}

@@ -5,10 +5,10 @@ import "path-class";
 var packageVersion = (
   // biome-ignore lint/suspicious/noTsIgnore: This comment is stil present in the compiled file, where an error is *not* expected.
   /** @ts-ignore Populated by `esbuild` at compile time. */
-  "0.61.3"
+  "0.62.1"
 );
 
 export {
   packageVersion
 };
-//# sourceMappingURL=chunk-5WXNSJ2M.js.map
+//# sourceMappingURL=chunk-7HTSOKX4.js.map

package/dist/bin/order.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-5WXNSJ2M.js";
+} from "./chunks/chunk-7HTSOKX4.js";
 
 // src/bin/order.ts
+import { basename } from "node:path";
 import { argv } from "node:process";
 import { argument, map, message, object, string } from "@optique/core";
 import { run } from "@optique/run";
@@ -11,7 +12,6 @@ import { Alg } from "cubing/alg";
 import { KPuzzle } from "cubing/kpuzzle";
 import { getPuzzleGeometryByName } from "cubing/puzzle-geometry";
 import { puzzles } from "cubing/puzzles";
-import { Path } from "path-class";
 var args = run(
   object({
     puzzleGeometryID: argument(string({ metavar: "PUZZLE" }), {
@@ -25,7 +25,7 @@ var args = run(
     )
   }),
   {
-    programName: new Path(argv[1]).basename.path,
+    programName: basename(argv[1]),
     description: message`Example: order 3x3x3 "R U R' U R U2' R'"`,
     help: "option",
     completion: {

package/dist/bin/order.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/order.ts"],
-  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/order.ts 3x3x3 \"R U R' U R U2' R'\"\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\norder --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(order --completions zsh)\n```\n\n*/\n\nimport { argv } from \"node:process\";\nimport { argument, map, message, object, string } from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport { Alg } from \"cubing/alg\";\nimport { KPuzzle } from \"cubing/kpuzzle\";\nimport { getPuzzleGeometryByName } from \"cubing/puzzle-geometry\";\nimport { puzzles } from \"cubing/puzzles\";\nimport { Path } from \"path-class\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst args = run(\n  object({\n    puzzleGeometryID: argument(string({ metavar: \"PUZZLE\" }), {\n      description: message`Puzzle geometry ID`,\n    }),\n    alg: map(\n      argument(string({ metavar: \"ALG\" }), {\n        description: message`Alg`,\n      }),\n      Alg.fromString,\n    ),\n  }),\n  {\n    programName: new Path(argv[1]).basename.path,\n    description: message`Example: order 3x3x3 \"R U R' U R U2' R'\"`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nconst { puzzleGeometryID, alg } = args;\n\n/*\n *   Turn a name into a geometry.\n */\nconst puzzleLoader = puzzles[puzzleGeometryID];\nconst kpuzzle = await (async () => {\n  if (puzzleLoader) {\n    return await puzzles[puzzleGeometryID].kpuzzle();\n  } else {\n    const pg = getPuzzleGeometryByName(puzzleGeometryID, {\n      allMoves: true,\n    });\n    return new KPuzzle(pg.getKPuzzleDefinition(true));\n  }\n})();\n\nconst order = kpuzzle.algToTransformation(alg).repetitionOrder();\nconsole.log(order);\n"],
-  "mappings": ";;;;;;AA0BA,SAAS,YAAY;AACrB,SAAS,UAAU,KAAK,SAAS,QAAQ,cAAc;AACvD,SAAS,WAAW;AACpB,SAAS,WAAW;AACpB,SAAS,eAAe;AACxB,SAAS,+BAA+B;AACxC,SAAS,eAAe;AACxB,SAAS,YAAY;AAGrB,IAAM,OAAO;AAAA,EACX,OAAO;AAAA,IACL,kBAAkB,SAAS,OAAO,EAAE,SAAS,SAAS,CAAC,GAAG;AAAA,MACxD,aAAa;AAAA,IACf,CAAC;AAAA,IACD,KAAK;AAAA,MACH,SAAS,OAAO,EAAE,SAAS,MAAM,CAAC,GAAG;AAAA,QACnC,aAAa;AAAA,MACf,CAAC;AAAA,MACD,IAAI;AAAA,IACN;AAAA,EACF,CAAC;AAAA,EACD;AAAA,IACE,aAAa,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,SAAS;AAAA,IACxC,aAAa;AAAA,IACb,MAAM;AAAA,IACN,YAAY;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAEA,IAAM,EAAE,kBAAkB,IAAI,IAAI;AAKlC,IAAM,eAAe,QAAQ,gBAAgB;AAC7C,IAAM,UAAU,OAAO,YAAY;AACjC,MAAI,cAAc;AAChB,WAAO,MAAM,QAAQ,gBAAgB,EAAE,QAAQ;AAAA,EACjD,OAAO;AACL,UAAM,KAAK,wBAAwB,kBAAkB;AAAA,MACnD,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,IAAI,QAAQ,GAAG,qBAAqB,IAAI,CAAC;AAAA,EAClD;AACF,GAAG;AAEH,IAAM,QAAQ,QAAQ,oBAAoB,GAAG,EAAE,gBAAgB;AAC/D,QAAQ,IAAI,KAAK;",
+  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/order.ts 3x3x3 \"R U R' U R U2' R'\"\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\norder --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(order --completions zsh)\n```\n\n*/\n\nimport { basename } from \"node:path\";\nimport { argv } from \"node:process\";\nimport { argument, map, message, object, string } from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport { Alg } from \"cubing/alg\";\nimport { KPuzzle } from \"cubing/kpuzzle\";\nimport { getPuzzleGeometryByName } from \"cubing/puzzle-geometry\";\nimport { puzzles } from \"cubing/puzzles\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst args = run(\n  object({\n    puzzleGeometryID: argument(string({ metavar: \"PUZZLE\" }), {\n      description: message`Puzzle geometry ID`,\n    }),\n    alg: map(\n      argument(string({ metavar: \"ALG\" }), {\n        description: message`Alg`,\n      }),\n      Alg.fromString,\n    ),\n  }),\n  {\n    programName: basename(argv[1]),\n    description: message`Example: order 3x3x3 \"R U R' U R U2' R'\"`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nconst { puzzleGeometryID, alg } = args;\n\n/*\n *   Turn a name into a geometry.\n */\nconst puzzleLoader = puzzles[puzzleGeometryID];\nconst kpuzzle = await (async () => {\n  if (puzzleLoader) {\n    return await puzzles[puzzleGeometryID].kpuzzle();\n  } else {\n    const pg = getPuzzleGeometryByName(puzzleGeometryID, {\n      allMoves: true,\n    });\n    return new KPuzzle(pg.getKPuzzleDefinition(true));\n  }\n})();\n\nconst order = kpuzzle.algToTransformation(alg).repetitionOrder();\nconsole.log(order);\n"],
+  "mappings": ";;;;;;AA0BA,SAAS,gBAAgB;AACzB,SAAS,YAAY;AACrB,SAAS,UAAU,KAAK,SAAS,QAAQ,cAAc;AACvD,SAAS,WAAW;AACpB,SAAS,WAAW;AACpB,SAAS,eAAe;AACxB,SAAS,+BAA+B;AACxC,SAAS,eAAe;AAGxB,IAAM,OAAO;AAAA,EACX,OAAO;AAAA,IACL,kBAAkB,SAAS,OAAO,EAAE,SAAS,SAAS,CAAC,GAAG;AAAA,MACxD,aAAa;AAAA,IACf,CAAC;AAAA,IACD,KAAK;AAAA,MACH,SAAS,OAAO,EAAE,SAAS,MAAM,CAAC,GAAG;AAAA,QACnC,aAAa;AAAA,MACf,CAAC;AAAA,MACD,IAAI;AAAA,IACN;AAAA,EACF,CAAC;AAAA,EACD;AAAA,IACE,aAAa,SAAS,KAAK,CAAC,CAAC;AAAA,IAC7B,aAAa;AAAA,IACb,MAAM;AAAA,IACN,YAAY;AAAA,MACV,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAEA,IAAM,EAAE,kBAAkB,IAAI,IAAI;AAKlC,IAAM,eAAe,QAAQ,gBAAgB;AAC7C,IAAM,UAAU,OAAO,YAAY;AACjC,MAAI,cAAc;AAChB,WAAO,MAAM,QAAQ,gBAAgB,EAAE,QAAQ;AAAA,EACjD,OAAO;AACL,UAAM,KAAK,wBAAwB,kBAAkB;AAAA,MACnD,UAAU;AAAA,IACZ,CAAC;AACD,WAAO,IAAI,QAAQ,GAAG,qBAAqB,IAAI,CAAC;AAAA,EAClD;AACF,GAAG;AAEH,IAAM,QAAQ,QAAQ,oBAAoB,GAAG,EAAE,gBAAgB;AAC/D,QAAQ,IAAI,KAAK;",
   "names": []
 }

package/dist/bin/puzzle-geometry-bin.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-5WXNSJ2M.js";
+} from "./chunks/chunk-7HTSOKX4.js";
 
 // src/bin/puzzle-geometry-bin.ts
+import { basename } from "node:path";
 import { argv } from "node:process";
 import {
   argument,
@@ -27,7 +28,6 @@ import {
   PuzzleGeometry,
   parsePuzzleDescription
 } from "cubing/puzzle-geometry";
-import { Path } from "path-class";
 import { PrintableShellCommand } from "printable-shell-command";
 var puzzleList = getPG3DNamedPuzzles();
 function antiBool(optionName, description) {
@@ -267,7 +267,7 @@ The recognized puzzle names are: ${Object.keys(puzzleList).map((p) => JSON.strin
     })
   ),
   {
-    programName: new Path(argv[1]).basename.path,
+    programName: basename(argv[1]),
     description: message`
 Examples:
 

package/dist/bin/puzzle-geometry-bin.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/puzzle-geometry-bin.ts"],
-  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/puzzle-geometry-bin.ts <program args>\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\npuzzle-geometry --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(puzzle-geometry --completions zsh)\n```\n\n*/\n\nimport { argv } from \"node:process\";\nimport {\n  argument,\n  constant,\n  flag,\n  integer,\n  type Message,\n  map,\n  merge,\n  message,\n  multiple,\n  type OptionName,\n  object,\n  option,\n  optional,\n  or,\n  string,\n} from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport { Move } from \"cubing/alg\";\nimport {\n  type ExperimentalPuzzleGeometryOptions,\n  getPG3DNamedPuzzles,\n  PuzzleGeometry,\n  parsePuzzleDescription,\n} from \"cubing/puzzle-geometry\";\nimport { Path } from \"path-class\";\nimport { PrintableShellCommand } from \"printable-shell-command\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst puzzleList = getPG3DNamedPuzzles();\n\n// TODO: make this a `ValueParser`?\nfunction antiBool(optionName: OptionName, description: Message) {\n  return optional(\n    map(\n      flag(optionName, {\n        description,\n      }),\n      (v) => !v,\n    ),\n  );\n}\n\n// Include using `...subcommandDefaults` at the *beginning* of a subcommand `object({ \u2026 })`.\nconst subcommandDefaults = {\n  commentStyle: constant(\"hash\"),\n  forceQuiet: constant(undefined),\n} as const;\n\nconst args = run(\n  merge(\n    object({\n      verbosity: optional(\n        or(\n          map(multiple(flag(\"--verbose\", \"-v\")), (v) => v.length),\n          map(flag(\"--quiet\", \"-q\"), () => 0),\n        ),\n      ),\n    }),\n    or(\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"KSolve\"),\n        subcommandFlag: flag(\"--ksolve\", {\n          description: message`Print KSolve (\\`.tws\\`).`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"SVG\"),\n        subcommandFlag: flag(\"--svg\", {\n          description: message`Print SVG. Forces \\`--quiet\\`.`,\n        }),\n        commentStyle: constant(\"none\"),\n        svg3D: optional(\n          option(\"--3d\", {\n            description: message`Use 3D format for SVG file.`,\n          }),\n        ),\n        verbosity: constant(0),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"GAP\"),\n        subcommandFlag: flag(\"--gap\", {\n          description: message`Print GAP output.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Mathematica\"),\n        subcommandFlag: flag(\"--mathematica\", {\n          description: message`Print Mathematica output.`,\n        }),\n        commentStyle: constant(\"Pascal\"),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Schreier-Sims\"),\n        subcommandFlag: flag(\"--ss\", {\n          description: message`Perform Schrier-Sims calculation.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Canonical string analysis\"),\n        subcommandFlag: flag(\"--canon\", {\n          description: message`Print canonical string analysis.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"3D\"),\n        subcommandFlag: flag(\"--3d\", {\n          description: message`Print 3D information.`,\n        }),\n      }),\n    ),\n    object({\n      // This doesn't apply to SVG, but we place it here so that it doesn't print once for each non-SVG subcommand in the help string.\n      optimizeOrbits: option(\"--optimize\", {\n        description: message`Optimize output (when possible).`,\n      }),\n      addRotations: option(\"--rotations\", {\n        description: message`Include full-puzzle rotations as moves.`,\n      }),\n      allMoves: option(\"--allmoves\", {\n        description: message`Includes all moves (i.e., slice moves for 3x3x3).`,\n      }),\n      outerBlockMoves: option(\"--outerblockmoves\", {\n        description: message`Use outer block moves rather than slice moves.`,\n      }),\n      vertexMoves: option(\"--vertexmoves\", {\n        description: message`For tetrahedral puzzles, prefer vertex moves to face moves.`,\n      }),\n      includeCornerOrbits: antiBool(\n        \"--nocorners\",\n        message`Ignore all corners.`,\n      ),\n      excludeOrbits: optional(\n        map(\n          option(\"--omit\", string({ metavar: \"COMMA_SEPARATED_ORBITS\" }), {\n            description: message`Omit orbits.`,\n          }),\n          (s) => s.split(\",\"),\n        ),\n      ),\n      includeEdgeOrbits: antiBool(\"--noedges\", message`Ignore all edges.`),\n      includeCenterOrbits: antiBool(\n        \"--nocenters\",\n        message`Ignore all centers.`,\n      ),\n      grayCorners: option(\"--graycorners\", {\n        description: message`Gray corners.`,\n      }),\n      grayEdges: option(\"--grayedges\", { description: message`Gray edges.` }),\n      grayCenters: option(\"--graycenters\", {\n        description: message`Gray centers.`,\n      }),\n      fixedOrientation: option(\"--noorientation\", {\n        description: message`Ignore orientations.`,\n      }),\n      orientCenters: option(\"--orientcenters\", {\n        description: message`Give centers an orientation.`,\n      }),\n    }),\n    optional(\n      or(\n        object({\n          puzzleOrientation: optional(\n            map(\n              option(\n                \"--puzzleorientation\",\n                string({ metavar: \"JSON_STRING\" }),\n                {\n                  description: message`For 3D formats, give puzzle orientation.`,\n                },\n              ),\n              (s) => JSON.parse(s),\n            ),\n          ),\n          puzzleOrientations: constant(undefined),\n        }),\n        object({\n          puzzleOrientation: constant(undefined),\n          puzzleOrientations: optional(\n            map(\n              option(\n                \"--puzzleorientations\",\n                string({ metavar: \"JSON_STRING\" }),\n                {\n                  description: message`For 3D formats, give puzzle orientations.`,\n                },\n              ),\n              (s) => JSON.parse(s),\n            ),\n          ),\n        }),\n      ),\n    ),\n    object({\n      fixedPieceType: optional(\n        or(\n          map(\n            flag(\"--fixcorner\", {\n              description: message`Auto-select a subset of moves to keep a corner fixed in place.`,\n            }),\n            () => \"v\" as const,\n          ),\n          map(\n            flag(\"--fixedge\", {\n              description: message`Auto-select a subset of moves to keep an edge fixed in place.`,\n            }),\n            () => \"e\" as const,\n          ),\n          map(\n            flag(\"--fixcenter\", {\n              description: message`Auto-select a subset of moves to keep a center fixed in place.`,\n            }),\n            () => \"f\" as const,\n          ),\n        ),\n      ),\n      // TODO: this doesn't make sense for all subcommands?\n      scrambleAmount: optional(\n        option(\"--scramble\", integer({ min: 0 }), {\n          description: message`Scramble solved position.`,\n        }),\n      ),\n      moveList: optional(\n        map(\n          option(\"--moves\", string({ metavar: \"COMMA_SEPARATED_MOVES\" }), {\n            description: message`Restrict moves to this list. Example: \\\"U2,F,r\\\").`,\n          }),\n          (s) => s.split(\",\").map((m) => Move.fromString(m)),\n        ),\n      ),\n      puzzle: map(\n        argument(string({ metavar: \"PUZZLE\" }), {\n          description: message`The puzzle can be given as a geometric description or by name.\nThe geometric description starts with one of:\n\n- \\`c\\` (cube),\\n\n- \\`t\\` (tetrahedron),\\n\n- \\`d\\` (dodecahedron),\\n\n- \\`i\\` (icosahedron),\\n\n- \\`o\\` (octahedron),\\n\n\nthen a space, then a series of cuts. Each cut begins with one of:\n\n- \\`f\\` (for a cut parallel to faces),\\n\n- \\`v\\` (for a cut perpendicular to a ray from the center through a corner),\\n\n- \\`e\\` (for a cut perpendicular to a ray from the center through an edge),\\n\n\nfollowed by a decimal number giving a distance, where 1 is the distance\nbetween the center of the puzzle and the center of a face.\n\nExample description: \\`c f 0 v 0.577350269189626 e 0\\`. Corresponds to: https://alpha.twizzle.net/explore/?puzzle=2x2x2+%2B+dino+%2B+little+chop\n\nThe recognized puzzle names are: ${Object.keys(puzzleList)\n            .map((p) => JSON.stringify(p))\n            .join(\", \")}`,\n        }),\n        (s) => {\n          const parsed = parsePuzzleDescription(puzzleList[s] ?? s);\n          if (parsed === null) {\n            throw new Error(\"Could not parse puzzle description!\");\n          }\n          return parsed;\n        },\n      ),\n    }),\n  ),\n  {\n    programName: new Path(argv[1]).basename.path,\n    description: message`\nExamples:\n\n    puzzle-geometry --ss 2x2x2\\n\n    puzzle-geometry --ss --fixcorner 2x2x2\\n\n    puzzle-geometry --ss --moves U,F2,r 4x4x4\\n\n    puzzle-geometry --ksolve --optimize --moves U,F,R megaminx\\n\n    puzzle-geometry --gap --noedges megaminx\n`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nif (args.verbosity !== 0) {\n  const cmd = () => {\n    const [command, ...args] = argv;\n    return new PrintableShellCommand(command, args).getPrintableCommand({\n      argumentLineWrapping: \"inline\",\n    });\n  };\n\n  switch (args.commentStyle) {\n    case \"hash\": {\n      console.log(`# ${cmd()}`);\n      break;\n    }\n    case \"none\": {\n      break;\n    }\n    case \"Pascal\": {\n      console.log(`(* ${cmd()} *)`);\n      break;\n    }\n    default:\n      throw new Error(\"Invalid comment style.\") as never;\n  }\n}\n\nfunction buildPuzzleGeometry(): PuzzleGeometry {\n  const {\n    verbosity,\n    optimizeOrbits,\n    addRotations,\n    allMoves,\n    outerBlockMoves,\n    vertexMoves,\n    includeCornerOrbits,\n    includeCenterOrbits,\n    includeEdgeOrbits,\n    excludeOrbits,\n    grayCorners,\n    grayEdges,\n    grayCenters,\n    fixedOrientation,\n    orientCenters,\n    puzzleOrientation,\n    puzzleOrientations,\n    fixedPieceType,\n    scrambleAmount,\n    moveList,\n  } = args;\n  const options: ExperimentalPuzzleGeometryOptions = {\n    verbosity,\n    optimizeOrbits,\n    addRotations,\n    allMoves,\n    outerBlockMoves,\n    vertexMoves,\n    includeCornerOrbits,\n    includeCenterOrbits,\n    includeEdgeOrbits,\n    excludeOrbits,\n    grayCorners,\n    grayEdges,\n    grayCenters,\n    fixedOrientation,\n    orientCenters,\n    puzzleOrientation,\n    puzzleOrientations,\n    fixedPieceType,\n    scrambleAmount,\n    moveList,\n  };\n\n  const puzzleGeometry = new PuzzleGeometry(args.puzzle, options);\n  // TODO: why are these calls needed?\n  puzzleGeometry.allstickers();\n  puzzleGeometry.genperms();\n  return puzzleGeometry;\n}\n\nswitch (args.subcommand) {\n  case \"KSolve\": {\n    console.log(buildPuzzleGeometry().writeksolve());\n    break;\n  }\n  case \"SVG\": {\n    console.log(\n      buildPuzzleGeometry().generatesvg(\n        undefined,\n        undefined,\n        undefined,\n        args.svg3D,\n      ),\n    );\n    break;\n  }\n  case \"GAP\": {\n    console.log(buildPuzzleGeometry().writegap());\n    break;\n  }\n  case \"Mathematica\": {\n    console.log(buildPuzzleGeometry().writemathematica());\n    break;\n  }\n  case \"Schreier-Sims\": {\n    buildPuzzleGeometry().writeSchreierSims(console.log);\n    break;\n  }\n  case \"Canonical string analysis\": {\n    buildPuzzleGeometry().showcanon(console.log);\n    break;\n  }\n  case \"3D\": {\n    console.log(JSON.stringify(buildPuzzleGeometry().get3d(), null, \"  \"));\n    break;\n  }\n  default:\n    throw new Error(\"Invalid subcommand.\") as never;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/puzzle-geometry-bin.ts <program args>\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\npuzzle-geometry --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(puzzle-geometry --completions zsh)\n```\n\n*/\n\nimport { basename } from \"node:path\";\nimport { argv } from \"node:process\";\nimport {\n  argument,\n  constant,\n  flag,\n  integer,\n  type Message,\n  map,\n  merge,\n  message,\n  multiple,\n  type OptionName,\n  object,\n  option,\n  optional,\n  or,\n  string,\n} from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport { Move } from \"cubing/alg\";\nimport {\n  type ExperimentalPuzzleGeometryOptions,\n  getPG3DNamedPuzzles,\n  PuzzleGeometry,\n  parsePuzzleDescription,\n} from \"cubing/puzzle-geometry\";\nimport { PrintableShellCommand } from \"printable-shell-command\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst puzzleList = getPG3DNamedPuzzles();\n\n// TODO: make this a `ValueParser`?\nfunction antiBool(optionName: OptionName, description: Message) {\n  return optional(\n    map(\n      flag(optionName, {\n        description,\n      }),\n      (v) => !v,\n    ),\n  );\n}\n\n// Include using `...subcommandDefaults` at the *beginning* of a subcommand `object({ \u2026 })`.\nconst subcommandDefaults = {\n  commentStyle: constant(\"hash\"),\n  forceQuiet: constant(undefined),\n} as const;\n\nconst args = run(\n  merge(\n    object({\n      verbosity: optional(\n        or(\n          map(multiple(flag(\"--verbose\", \"-v\")), (v) => v.length),\n          map(flag(\"--quiet\", \"-q\"), () => 0),\n        ),\n      ),\n    }),\n    or(\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"KSolve\"),\n        subcommandFlag: flag(\"--ksolve\", {\n          description: message`Print KSolve (\\`.tws\\`).`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"SVG\"),\n        subcommandFlag: flag(\"--svg\", {\n          description: message`Print SVG. Forces \\`--quiet\\`.`,\n        }),\n        commentStyle: constant(\"none\"),\n        svg3D: optional(\n          option(\"--3d\", {\n            description: message`Use 3D format for SVG file.`,\n          }),\n        ),\n        verbosity: constant(0),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"GAP\"),\n        subcommandFlag: flag(\"--gap\", {\n          description: message`Print GAP output.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Mathematica\"),\n        subcommandFlag: flag(\"--mathematica\", {\n          description: message`Print Mathematica output.`,\n        }),\n        commentStyle: constant(\"Pascal\"),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Schreier-Sims\"),\n        subcommandFlag: flag(\"--ss\", {\n          description: message`Perform Schrier-Sims calculation.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"Canonical string analysis\"),\n        subcommandFlag: flag(\"--canon\", {\n          description: message`Print canonical string analysis.`,\n        }),\n      }),\n      object({\n        ...subcommandDefaults,\n        subcommand: constant(\"3D\"),\n        subcommandFlag: flag(\"--3d\", {\n          description: message`Print 3D information.`,\n        }),\n      }),\n    ),\n    object({\n      // This doesn't apply to SVG, but we place it here so that it doesn't print once for each non-SVG subcommand in the help string.\n      optimizeOrbits: option(\"--optimize\", {\n        description: message`Optimize output (when possible).`,\n      }),\n      addRotations: option(\"--rotations\", {\n        description: message`Include full-puzzle rotations as moves.`,\n      }),\n      allMoves: option(\"--allmoves\", {\n        description: message`Includes all moves (i.e., slice moves for 3x3x3).`,\n      }),\n      outerBlockMoves: option(\"--outerblockmoves\", {\n        description: message`Use outer block moves rather than slice moves.`,\n      }),\n      vertexMoves: option(\"--vertexmoves\", {\n        description: message`For tetrahedral puzzles, prefer vertex moves to face moves.`,\n      }),\n      includeCornerOrbits: antiBool(\n        \"--nocorners\",\n        message`Ignore all corners.`,\n      ),\n      excludeOrbits: optional(\n        map(\n          option(\"--omit\", string({ metavar: \"COMMA_SEPARATED_ORBITS\" }), {\n            description: message`Omit orbits.`,\n          }),\n          (s) => s.split(\",\"),\n        ),\n      ),\n      includeEdgeOrbits: antiBool(\"--noedges\", message`Ignore all edges.`),\n      includeCenterOrbits: antiBool(\n        \"--nocenters\",\n        message`Ignore all centers.`,\n      ),\n      grayCorners: option(\"--graycorners\", {\n        description: message`Gray corners.`,\n      }),\n      grayEdges: option(\"--grayedges\", { description: message`Gray edges.` }),\n      grayCenters: option(\"--graycenters\", {\n        description: message`Gray centers.`,\n      }),\n      fixedOrientation: option(\"--noorientation\", {\n        description: message`Ignore orientations.`,\n      }),\n      orientCenters: option(\"--orientcenters\", {\n        description: message`Give centers an orientation.`,\n      }),\n    }),\n    optional(\n      or(\n        object({\n          puzzleOrientation: optional(\n            map(\n              option(\n                \"--puzzleorientation\",\n                string({ metavar: \"JSON_STRING\" }),\n                {\n                  description: message`For 3D formats, give puzzle orientation.`,\n                },\n              ),\n              (s) => JSON.parse(s),\n            ),\n          ),\n          puzzleOrientations: constant(undefined),\n        }),\n        object({\n          puzzleOrientation: constant(undefined),\n          puzzleOrientations: optional(\n            map(\n              option(\n                \"--puzzleorientations\",\n                string({ metavar: \"JSON_STRING\" }),\n                {\n                  description: message`For 3D formats, give puzzle orientations.`,\n                },\n              ),\n              (s) => JSON.parse(s),\n            ),\n          ),\n        }),\n      ),\n    ),\n    object({\n      fixedPieceType: optional(\n        or(\n          map(\n            flag(\"--fixcorner\", {\n              description: message`Auto-select a subset of moves to keep a corner fixed in place.`,\n            }),\n            () => \"v\" as const,\n          ),\n          map(\n            flag(\"--fixedge\", {\n              description: message`Auto-select a subset of moves to keep an edge fixed in place.`,\n            }),\n            () => \"e\" as const,\n          ),\n          map(\n            flag(\"--fixcenter\", {\n              description: message`Auto-select a subset of moves to keep a center fixed in place.`,\n            }),\n            () => \"f\" as const,\n          ),\n        ),\n      ),\n      // TODO: this doesn't make sense for all subcommands?\n      scrambleAmount: optional(\n        option(\"--scramble\", integer({ min: 0 }), {\n          description: message`Scramble solved position.`,\n        }),\n      ),\n      moveList: optional(\n        map(\n          option(\"--moves\", string({ metavar: \"COMMA_SEPARATED_MOVES\" }), {\n            description: message`Restrict moves to this list. Example: \\\"U2,F,r\\\").`,\n          }),\n          (s) => s.split(\",\").map((m) => Move.fromString(m)),\n        ),\n      ),\n      puzzle: map(\n        argument(string({ metavar: \"PUZZLE\" }), {\n          description: message`The puzzle can be given as a geometric description or by name.\nThe geometric description starts with one of:\n\n- \\`c\\` (cube),\\n\n- \\`t\\` (tetrahedron),\\n\n- \\`d\\` (dodecahedron),\\n\n- \\`i\\` (icosahedron),\\n\n- \\`o\\` (octahedron),\\n\n\nthen a space, then a series of cuts. Each cut begins with one of:\n\n- \\`f\\` (for a cut parallel to faces),\\n\n- \\`v\\` (for a cut perpendicular to a ray from the center through a corner),\\n\n- \\`e\\` (for a cut perpendicular to a ray from the center through an edge),\\n\n\nfollowed by a decimal number giving a distance, where 1 is the distance\nbetween the center of the puzzle and the center of a face.\n\nExample description: \\`c f 0 v 0.577350269189626 e 0\\`. Corresponds to: https://alpha.twizzle.net/explore/?puzzle=2x2x2+%2B+dino+%2B+little+chop\n\nThe recognized puzzle names are: ${Object.keys(puzzleList)\n            .map((p) => JSON.stringify(p))\n            .join(\", \")}`,\n        }),\n        (s) => {\n          const parsed = parsePuzzleDescription(puzzleList[s] ?? s);\n          if (parsed === null) {\n            throw new Error(\"Could not parse puzzle description!\");\n          }\n          return parsed;\n        },\n      ),\n    }),\n  ),\n  {\n    programName: basename(argv[1]),\n    description: message`\nExamples:\n\n    puzzle-geometry --ss 2x2x2\\n\n    puzzle-geometry --ss --fixcorner 2x2x2\\n\n    puzzle-geometry --ss --moves U,F2,r 4x4x4\\n\n    puzzle-geometry --ksolve --optimize --moves U,F,R megaminx\\n\n    puzzle-geometry --gap --noedges megaminx\n`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nif (args.verbosity !== 0) {\n  const cmd = () => {\n    const [command, ...args] = argv;\n    return new PrintableShellCommand(command, args).getPrintableCommand({\n      argumentLineWrapping: \"inline\",\n    });\n  };\n\n  switch (args.commentStyle) {\n    case \"hash\": {\n      console.log(`# ${cmd()}`);\n      break;\n    }\n    case \"none\": {\n      break;\n    }\n    case \"Pascal\": {\n      console.log(`(* ${cmd()} *)`);\n      break;\n    }\n    default:\n      throw new Error(\"Invalid comment style.\") as never;\n  }\n}\n\nfunction buildPuzzleGeometry(): PuzzleGeometry {\n  const {\n    verbosity,\n    optimizeOrbits,\n    addRotations,\n    allMoves,\n    outerBlockMoves,\n    vertexMoves,\n    includeCornerOrbits,\n    includeCenterOrbits,\n    includeEdgeOrbits,\n    excludeOrbits,\n    grayCorners,\n    grayEdges,\n    grayCenters,\n    fixedOrientation,\n    orientCenters,\n    puzzleOrientation,\n    puzzleOrientations,\n    fixedPieceType,\n    scrambleAmount,\n    moveList,\n  } = args;\n  const options: ExperimentalPuzzleGeometryOptions = {\n    verbosity,\n    optimizeOrbits,\n    addRotations,\n    allMoves,\n    outerBlockMoves,\n    vertexMoves,\n    includeCornerOrbits,\n    includeCenterOrbits,\n    includeEdgeOrbits,\n    excludeOrbits,\n    grayCorners,\n    grayEdges,\n    grayCenters,\n    fixedOrientation,\n    orientCenters,\n    puzzleOrientation,\n    puzzleOrientations,\n    fixedPieceType,\n    scrambleAmount,\n    moveList,\n  };\n\n  const puzzleGeometry = new PuzzleGeometry(args.puzzle, options);\n  // TODO: why are these calls needed?\n  puzzleGeometry.allstickers();\n  puzzleGeometry.genperms();\n  return puzzleGeometry;\n}\n\nswitch (args.subcommand) {\n  case \"KSolve\": {\n    console.log(buildPuzzleGeometry().writeksolve());\n    break;\n  }\n  case \"SVG\": {\n    console.log(\n      buildPuzzleGeometry().generatesvg(\n        undefined,\n        undefined,\n        undefined,\n        args.svg3D,\n      ),\n    );\n    break;\n  }\n  case \"GAP\": {\n    console.log(buildPuzzleGeometry().writegap());\n    break;\n  }\n  case \"Mathematica\": {\n    console.log(buildPuzzleGeometry().writemathematica());\n    break;\n  }\n  case \"Schreier-Sims\": {\n    buildPuzzleGeometry().writeSchreierSims(console.log);\n    break;\n  }\n  case \"Canonical string analysis\": {\n    buildPuzzleGeometry().showcanon(console.log);\n    break;\n  }\n  case \"3D\": {\n    console.log(JSON.stringify(buildPuzzleGeometry().get3d(), null, \"  \"));\n    break;\n  }\n  default:\n    throw new Error(\"Invalid subcommand.\") as never;\n}\n"],
+  "mappings": "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",
   "names": ["args"]
 }

package/dist/bin/scramble.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-5WXNSJ2M.js";
+} from "./chunks/chunk-7HTSOKX4.js";
 
 // src/bin/scramble.ts
+import { basename } from "node:path";
 import { argv } from "node:process";
 import {
   argument,
@@ -20,7 +21,6 @@ import { run } from "@optique/run";
 import { eventInfo, twizzleEvents } from "cubing/puzzles";
 import { randomScrambleForEvent } from "cubing/scramble";
 import { setSearchDebug } from "cubing/search";
-import { Path } from "path-class";
 var outputFormats = ["auto", "text", "link", "json-text"];
 var notationTypes = ["auto", "LGN"];
 var eventIDs = Object.entries(twizzleEvents).filter(([_, eventInfo2]) => !!eventInfo2.scramblesImplemented).map(([eventID2, _]) => eventID2);
@@ -60,7 +60,7 @@ var args = run(
     })
   ),
   {
-    programName: new Path(argv[1]).basename.path,
+    programName: basename(argv[1]),
     description: message`Example: order 3x3x3 "R U R' U R U2' R'"`,
     help: "option",
     completion: {

package/dist/bin/scramble.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/scramble.ts"],
-  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/scramble.ts 333\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\nscramble --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(scramble --completions zsh)\n```\n\n*/\n\nimport { argv } from \"node:process\";\nimport {\n  argument,\n  choice,\n  integer,\n  map,\n  merge,\n  message,\n  object,\n  option,\n  withDefault,\n} from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport type { Alg } from \"cubing/alg\";\nimport { eventInfo, twizzleEvents } from \"cubing/puzzles\";\nimport { randomScrambleForEvent } from \"cubing/scramble\";\nimport { setSearchDebug } from \"cubing/search\";\nimport { Path } from \"path-class\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst outputFormats = [\"auto\", \"text\", \"link\", \"json-text\"] as const;\nconst notationTypes = [\"auto\", \"LGN\"] as const;\nconst eventIDs = Object.entries(twizzleEvents)\n  .filter(([_, eventInfo]) => !!eventInfo.scramblesImplemented)\n  .map(([eventID, _]) => eventID);\n\nconst args = run(\n  merge(\n    object({\n      amount: withDefault(\n        option(\"--amount\", \"-n\", integer({ metavar: \"AMOUNT\", min: 1 }), {\n          description: message`Amount of scrambles.`,\n        }),\n        1,\n      ),\n      notation: withDefault(\n        option(\"--notation\", choice(notationTypes, { metavar: \"NOTATION\" })),\n        \"auto\",\n      ),\n    }),\n    object({\n      format: withDefault(\n        option(\"--format\", \"-f\", choice(outputFormats, { metavar: \"FORMAT\" })),\n        \"auto\",\n      ),\n    }),\n    object({\n      // TODO: consolidate this with `format`: https://github.com/dahlia/optique/issues/57\n      text: map(\n        option(\"--text\", \"-t\", {\n          description: message`Convenient shorthand for \\`--format text\\`.`,\n        }),\n        () => \"text\",\n      ),\n    }),\n    object({\n      eventID: argument(choice(eventIDs, { metavar: \"EVENT_ID\" }), {\n        description: message`WCA or unoffiical event ID.`,\n      }),\n    }),\n  ),\n  {\n    programName: new Path(argv[1]).basename.path,\n    description: message`Example: order 3x3x3 \"R U R' U R U2' R'\"`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nconst { amount, format: argsFormat, notation, text, eventID } = args;\nconst format = argsFormat ?? text ?? (!process.stdout.isTTY ? \"text\" : \"auto\");\n\nsetSearchDebug({ logPerf: false, showWorkerInstantiationWarnings: false });\n\nfunction scrambleText(scramble: Alg): string {\n  return scramble.toString({\n    // TODO: any\n    notation: notation as (typeof notationTypes)[number], // TODO: handle type conversion at arg parse time.\n  });\n}\n\nfunction scrambleLink(scramble: Alg): string {\n  const url = new URL(\"https://alpha.twizzle.net/edit/\");\n  const puzzleID = eventInfo(eventID)?.puzzleID;\n  puzzleID && url.searchParams.set(\"puzzle\", puzzleID);\n  url.searchParams.set(\"alg\", scrambleText(scramble));\n  return url.toString();\n}\n\nclass JSONListPrinter<T> {\n  #finished = false;\n  #firstValuePrintedAlready = false;\n  constructor() {\n    process.stdout.write(\"[\\n  \");\n  }\n\n  push(value: T) {\n    if (this.#firstValuePrintedAlready) {\n      process.stdout.write(\",\\n  \");\n    }\n    this.#firstValuePrintedAlready = true;\n    process.stdout.write(JSON.stringify(value));\n  }\n\n  finish() {\n    if (this.#finished) {\n      throw new Error(\"Tried to finish JSON list printing multiple times.\");\n    }\n    this.#finished = true;\n    console.log(\"\\n]\");\n  }\n}\n\n// Possibly: https://github.com/nodejs/node/issues/55468 Technically we could\n// just remove `await` from the called function, but this is semantically\n// unsound. This function encapsulates the unsoundness.\nfunction nodeForgetTopLevelAwaitWorkaround(\n  _promise: Promise<void>,\n): Promise<void> {\n  return Promise.resolve();\n}\n\nawait nodeForgetTopLevelAwaitWorkaround(\n  (async () => {\n    if (format !== \"json-text\" && amount === 1) {\n      const scramble = await randomScrambleForEvent(eventID);\n\n      switch (format) {\n        case \"auto\": {\n          console.log(`${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}`);\n          break;\n        }\n        case \"text\": {\n          console.log(scrambleText(scramble));\n          break;\n        }\n        case \"link\": {\n          console.log(scrambleLink(scramble));\n          break;\n        }\n        // @ts-expect-error This is a code guard for future refactoring.\n        case \"json-text\": {\n          throw new Error(\n            \"Encountered `json` format in code that is not expected to handle it.\",\n          );\n        }\n        default: {\n          throw new Error(\"Invalid format!\") as never;\n        }\n      }\n    } else {\n      const jsonListPrinter: JSONListPrinter<string> | undefined =\n        format === \"json-text\" ? new JSONListPrinter() : undefined;\n      for (let i = 0; i < amount; i++) {\n        const scramble = await randomScrambleForEvent(eventID);\n        switch (format) {\n          case \"auto\": {\n            console.log(`// Scramble #${i + 1}\n${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}\n`);\n            break;\n          }\n          case \"text\": {\n            console.log(`// Scramble #${i + 1}`);\n            console.log(`${scrambleText(scramble)}\\n`);\n            break;\n          }\n          case \"link\": {\n            console.log(`// Scramble #${i + 1}`);\n            console.log(`${scrambleLink(scramble)}\\n`);\n            break;\n          }\n          case \"json-text\": {\n            jsonListPrinter?.push(scramble.toString());\n            break;\n          }\n          default: {\n            throw new Error(\"Invalid format!\") as never;\n          }\n        }\n      }\n      jsonListPrinter?.finish();\n    }\n  })(),\n);\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n\nTo run this file directly:\n\n```shell\nbun run -- ./src/bin/scramble.ts 333\n```\n\nTo test completions:\n\n```shell\n# fish (from repo root)\nset PATH (pwd)/src/test/bin-path $PATH\nscramble --completions fish | source\n```\n\n```shell\n# zsh (from repo root)\nautoload -Uz compinit\ncompinit\nexport PATH=$(pwd)/src/test/bin-path:$PATH\nsource <(scramble --completions zsh)\n```\n\n*/\n\nimport { basename } from \"node:path\";\nimport { argv } from \"node:process\";\nimport {\n  argument,\n  choice,\n  integer,\n  map,\n  merge,\n  message,\n  object,\n  option,\n  withDefault,\n} from \"@optique/core\";\nimport { run } from \"@optique/run\";\nimport type { Alg } from \"cubing/alg\";\nimport { eventInfo, twizzleEvents } from \"cubing/puzzles\";\nimport { randomScrambleForEvent } from \"cubing/scramble\";\nimport { setSearchDebug } from \"cubing/search\";\nimport { packageVersion } from \"../metadata/packageVersion\";\n\nconst outputFormats = [\"auto\", \"text\", \"link\", \"json-text\"] as const;\nconst notationTypes = [\"auto\", \"LGN\"] as const;\nconst eventIDs = Object.entries(twizzleEvents)\n  .filter(([_, eventInfo]) => !!eventInfo.scramblesImplemented)\n  .map(([eventID, _]) => eventID);\n\nconst args = run(\n  merge(\n    object({\n      amount: withDefault(\n        option(\"--amount\", \"-n\", integer({ metavar: \"AMOUNT\", min: 1 }), {\n          description: message`Amount of scrambles.`,\n        }),\n        1,\n      ),\n      notation: withDefault(\n        option(\"--notation\", choice(notationTypes, { metavar: \"NOTATION\" })),\n        \"auto\",\n      ),\n    }),\n    object({\n      format: withDefault(\n        option(\"--format\", \"-f\", choice(outputFormats, { metavar: \"FORMAT\" })),\n        \"auto\",\n      ),\n    }),\n    object({\n      // TODO: consolidate this with `format`: https://github.com/dahlia/optique/issues/57\n      text: map(\n        option(\"--text\", \"-t\", {\n          description: message`Convenient shorthand for \\`--format text\\`.`,\n        }),\n        () => \"text\",\n      ),\n    }),\n    object({\n      eventID: argument(choice(eventIDs, { metavar: \"EVENT_ID\" }), {\n        description: message`WCA or unoffiical event ID.`,\n      }),\n    }),\n  ),\n  {\n    programName: basename(argv[1]),\n    description: message`Example: order 3x3x3 \"R U R' U R U2' R'\"`,\n    help: \"option\",\n    completion: {\n      mode: \"option\",\n      name: \"plural\",\n    },\n    version: {\n      mode: \"option\",\n      value: packageVersion,\n    },\n  },\n);\n\nconst { amount, format: argsFormat, notation, text, eventID } = args;\nconst format = argsFormat ?? text ?? (!process.stdout.isTTY ? \"text\" : \"auto\");\n\nsetSearchDebug({ logPerf: false, showWorkerInstantiationWarnings: false });\n\nfunction scrambleText(scramble: Alg): string {\n  return scramble.toString({\n    // TODO: any\n    notation: notation as (typeof notationTypes)[number], // TODO: handle type conversion at arg parse time.\n  });\n}\n\nfunction scrambleLink(scramble: Alg): string {\n  const url = new URL(\"https://alpha.twizzle.net/edit/\");\n  const puzzleID = eventInfo(eventID)?.puzzleID;\n  puzzleID && url.searchParams.set(\"puzzle\", puzzleID);\n  url.searchParams.set(\"alg\", scrambleText(scramble));\n  return url.toString();\n}\n\nclass JSONListPrinter<T> {\n  #finished = false;\n  #firstValuePrintedAlready = false;\n  constructor() {\n    process.stdout.write(\"[\\n  \");\n  }\n\n  push(value: T) {\n    if (this.#firstValuePrintedAlready) {\n      process.stdout.write(\",\\n  \");\n    }\n    this.#firstValuePrintedAlready = true;\n    process.stdout.write(JSON.stringify(value));\n  }\n\n  finish() {\n    if (this.#finished) {\n      throw new Error(\"Tried to finish JSON list printing multiple times.\");\n    }\n    this.#finished = true;\n    console.log(\"\\n]\");\n  }\n}\n\n// Possibly: https://github.com/nodejs/node/issues/55468 Technically we could\n// just remove `await` from the called function, but this is semantically\n// unsound. This function encapsulates the unsoundness.\nfunction nodeForgetTopLevelAwaitWorkaround(\n  _promise: Promise<void>,\n): Promise<void> {\n  return Promise.resolve();\n}\n\nawait nodeForgetTopLevelAwaitWorkaround(\n  (async () => {\n    if (format !== \"json-text\" && amount === 1) {\n      const scramble = await randomScrambleForEvent(eventID);\n\n      switch (format) {\n        case \"auto\": {\n          console.log(`${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}`);\n          break;\n        }\n        case \"text\": {\n          console.log(scrambleText(scramble));\n          break;\n        }\n        case \"link\": {\n          console.log(scrambleLink(scramble));\n          break;\n        }\n        // @ts-expect-error This is a code guard for future refactoring.\n        case \"json-text\": {\n          throw new Error(\n            \"Encountered `json` format in code that is not expected to handle it.\",\n          );\n        }\n        default: {\n          throw new Error(\"Invalid format!\") as never;\n        }\n      }\n    } else {\n      const jsonListPrinter: JSONListPrinter<string> | undefined =\n        format === \"json-text\" ? new JSONListPrinter() : undefined;\n      for (let i = 0; i < amount; i++) {\n        const scramble = await randomScrambleForEvent(eventID);\n        switch (format) {\n          case \"auto\": {\n            console.log(`// Scramble #${i + 1}\n${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}\n`);\n            break;\n          }\n          case \"text\": {\n            console.log(`// Scramble #${i + 1}`);\n            console.log(`${scrambleText(scramble)}\\n`);\n            break;\n          }\n          case \"link\": {\n            console.log(`// Scramble #${i + 1}`);\n            console.log(`${scrambleLink(scramble)}\\n`);\n            break;\n          }\n          case \"json-text\": {\n            jsonListPrinter?.push(scramble.toString());\n            break;\n          }\n          default: {\n            throw new Error(\"Invalid format!\") as never;\n          }\n        }\n      }\n      jsonListPrinter?.finish();\n    }\n  })(),\n);\n"],
+  "mappings": "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",
   "names": ["eventInfo", "eventID"]
 }

package/dist/lib/cubing/{PuzzleLoader-CkghxdIL.d.ts → PuzzleLoader-B2JfN7uX.d.ts}

@@ -1,16 +1,16 @@
 import { Tagged } from 'type-fest';
 import { Texture, Object3D, Raycaster, PerspectiveCamera, Scene, WebGLRenderer } from 'three/src/Three.js';
 
-type ExperimentalNotationType = "auto" | "LGN";
-interface ExperimentalSerializationOptions {
-    notation?: ExperimentalNotationType;
-}
-
 declare enum IterationDirection {
     Forwards = 1,
     Backwards = -1
 }
 
+type ExperimentalNotationType = "auto" | "LGN";
+interface ExperimentalSerializationOptions {
+    notation?: ExperimentalNotationType;
+}
+
 declare abstract class Comparable {
     is(c: any): boolean;
     as<T>(c: new (...args: any) => T): T | null;
@@ -1757,7 +1757,7 @@ declare class TwistyAnimationController {
         untilBoundary?: BoundaryType;
         autoSkipToOtherEndIfStartingAtBoundary?: boolean;
         loop?: boolean;
-    }): Promise<void>;
+    }): void;
     pause(): void;
     animFrame(frameDatestamp: MillisecondTimestamp): Promise<void>;
 }
@@ -2082,7 +2082,7 @@ declare class TwistyPlayer extends TwistyPlayerSettable implements TwistyAnimati
     buttons?: TwistyButtons;
     experimentalCanvasClickCallback: (...args: any) => void;
     constructor(config?: TwistyPlayerConfig);
-    connectedCallback(): Promise<void>;
+    connectedCallback(): void;
     [intersectedCallback](): Promise<void>;
     /** @deprecated */
     experimentalSetFlashLevel(newLevel: "auto" | "none"): void;

package/dist/lib/cubing/alg/index.d.ts

@@ -1,5 +1,5 @@
-import { R as AlgNode, r as Alg, M as Move, U as AppendOptions, W as Grouping, X as LineComment, Y as Commutator, Z as Conjugate, _ as Newline, $ as Pause, a0 as KeyMapping, A as AlgLeaf } from '../PuzzleLoader-CkghxdIL.js';
-export { a1 as AlgBranch, a7 as AppendCancelOptions, a5 as ExperimentalNotationType, a4 as ExperimentalParsed, a6 as ExperimentalSerializationOptions, a2 as GroupingModifications, a3 as MoveModifications, w as PuzzleSpecificSimplifyOptions, a9 as QuantumMove, a8 as SimplifyOptions } from '../PuzzleLoader-CkghxdIL.js';
+import { R as AlgNode, r as Alg, M as Move, U as AppendOptions, W as Grouping, X as LineComment, Y as Commutator, Z as Conjugate, _ as Newline, $ as Pause, a0 as KeyMapping, A as AlgLeaf } from '../PuzzleLoader-B2JfN7uX.js';
+export { a1 as AlgBranch, a7 as AppendCancelOptions, a5 as ExperimentalNotationType, a4 as ExperimentalParsed, a6 as ExperimentalSerializationOptions, a2 as GroupingModifications, a3 as MoveModifications, w as PuzzleSpecificSimplifyOptions, a9 as QuantumMove, a8 as SimplifyOptions } from '../PuzzleLoader-B2JfN7uX.js';
 import 'type-fest';
 import 'three/src/Three.js';
 

package/dist/lib/cubing/alg/index.js

@@ -18,7 +18,7 @@ import {
   functionFromTraversal,
   keyToMove,
   setAlgDebug
-} from "../chunks/chunk-7D7ZUWUK.js";
+} from "../chunks/chunk-O6HEZXGY.js";
 export {
   Alg,
   AlgBuilder,

package/dist/lib/cubing/bluetooth/index.d.ts

@@ -1,11 +1,30 @@
-import { t as PuzzleID, s as PuzzleLoader, a0 as KeyMapping, K as KPattern, r as Alg, M as Move, z as MillisecondTimestamp } from '../PuzzleLoader-CkghxdIL.js';
-import { B as BluetoothPuzzle } from '../bluetooth-puzzle-c-_IBAdu.js';
-export { A as MoveEvent, O as OrientationEvent } from '../bluetooth-puzzle-c-_IBAdu.js';
+import { A as AlgLeafEvent, O as OrientationEvent } from '../events-BDkOaqlG.js';
+import { K as KPattern, t as PuzzleID, s as PuzzleLoader, a0 as KeyMapping, r as Alg, M as Move, z as MillisecondTimestamp } from '../PuzzleLoader-B2JfN7uX.js';
 import 'type-fest';
 import 'three/src/Three.js';
 
 declare function enableDebugLogging(enable: boolean): void;
 
+interface StreamTransformer {
+    transformAlgLeaf(algLeafEvent: AlgLeafEvent): void;
+    transformOrientation(orientationEvent: OrientationEvent): void;
+}
+
+/** @category Smart Puzzles */
+declare abstract class BluetoothPuzzle extends EventTarget {
+    transformers: StreamTransformer[];
+    protected listeners: Array<(e: AlgLeafEvent) => void>;
+    protected orientationListeners: Array<(e: OrientationEvent) => void>;
+    abstract name(): string | undefined;
+    abstract disconnect(): void;
+    getPattern(): Promise<KPattern>;
+    addAlgLeafListener(listener: (e: AlgLeafEvent) => void): void;
+    addOrientationListener(listener: (e: OrientationEvent) => void): void;
+    experimentalAddBasicRotationTransformer(): void;
+    protected dispatchAlgLeaf(algLeaf: AlgLeafEvent): void;
+    protected dispatchOrientation(orientationEvent: OrientationEvent): void;
+}
+
 /** @category Keyboard Puzzles */
 declare class KeyboardPuzzle extends BluetoothPuzzle {
     private target;
@@ -154,4 +173,4 @@ type BluetoothTimer = GanTimer;
 /** @category Timers */
 declare function connectSmartTimer(options?: BluetoothConnectOptions): Promise<BluetoothTimer>;
 
-export { BluetoothPuzzle, type BluetoothRobot, type BluetoothTimer, GanCube, GiiKERCube, GoCube, KeyboardPuzzle, connectSmartPuzzle, connectSmartRobot, connectSmartTimer, debugKeyboardConnect, enableDebugLogging };
+export { BluetoothPuzzle, type BluetoothRobot, type BluetoothTimer, GanCube, GiiKERCube, GoCube, KeyboardPuzzle, AlgLeafEvent as MoveEvent, OrientationEvent, connectSmartPuzzle, connectSmartRobot, connectSmartTimer, debugKeyboardConnect, enableDebugLogging };

package/dist/lib/cubing/bluetooth/index.js

@@ -1,23 +1,23 @@
 import {
   binaryComponentsToReid3x3x3,
   twizzleBinaryToBinaryComponents
-} from "../chunks/chunk-WI337PMF.js";
+} from "../chunks/chunk-NGW52SHR.js";
 import {
   puzzles
-} from "../chunks/chunk-MZKROP74.js";
+} from "../chunks/chunk-FLK6AZKB.js";
 import {
   cube3x3x3,
   experimental3x3x3KPuzzle
-} from "../chunks/chunk-QSGI7DXX.js";
+} from "../chunks/chunk-FUHYAW74.js";
 import {
   KPattern
-} from "../chunks/chunk-WAYEJXCG.js";
+} from "../chunks/chunk-RINY3U6G.js";
 import {
   Alg,
   Move,
   experimentalAppendMove,
   keyToMove
-} from "../chunks/chunk-7D7ZUWUK.js";
+} from "../chunks/chunk-O6HEZXGY.js";
 
 // src/cubing/bluetooth/debug.ts
 var DEBUG_LOGGING_ENABLED = false;
@@ -261,7 +261,7 @@ async function importKey(keyBytes) {
   );
 }
 async function unsafeEncryptBlockWithIV(key, plaintextBlock, iv) {
-  const cryptoResult = await window.crypto.subtle.encrypt(
+  const cryptoResult = await globalThis.crypto.subtle.encrypt(
     {
       name: AES_CBC,
       iv
@@ -286,7 +286,7 @@ async function unsafeDecryptBlock(key, ciphertextBlock) {
   const cbcCiphertext = new Uint8Array(2 * blockSize);
   cbcCiphertext.set(new Uint8Array(ciphertextBlock), 0);
   cbcCiphertext.set(new Uint8Array(paddingBlock), blockSize);
-  const cryptoResult = await window.crypto.subtle.decrypt(
+  const cryptoResult = await globalThis.crypto.subtle.decrypt(
     {
       name: AES_CBC,
       iv: zeros
@@ -1605,9 +1605,12 @@ var QiyiCube = class _QiyiCube extends BluetoothPuzzle {
     this.kpuzzle = kpuzzle;
     this.aesKey = aesKey;
     this.server = server;
-    this.startNotifications().then(this.sendAppHello.bind(this));
     this.allTimeStamps = /* @__PURE__ */ new Set();
     this.allTimeStampsQueue = [];
+    void (async () => {
+      await this.startNotifications();
+      void this.sendAppHello();
+    })();
   }
   latestTimestamp;
   allTimeStamps;
@@ -2195,7 +2198,7 @@ var GanTimer = class _GanTimer extends EventTarget {
       }
     }
     this.previousDetail = detail;
-    this.poll();
+    void this.poll();
   }
   onDisconnect() {
     this.dispatchEvent(new CustomEvent("disconnect"));
@@ -2212,7 +2215,7 @@ var GanTimer = class _GanTimer extends EventTarget {
   }
   startPolling() {
     this.polling = true;
-    this.poll();
+    void this.poll();
   }
   stopPolling() {
     this.polling = false;