cubing 0.52.4 → 0.53.0

package/dist/bin/order.js

@@ -1,22 +1,50 @@
 #!/usr/bin/env node
 
 // src/bin/order.ts
+import {
+  binary,
+  string as cmdString,
+  command,
+  positional,
+  run
+} from "cmd-ts";
+import { Alg } from "cubing/alg";
 import { KPuzzle } from "cubing/kpuzzle";
 import { getPuzzleGeometryByName } from "cubing/puzzle-geometry";
 import { puzzles } from "cubing/puzzles";
-var puzzleName = process.argv[2];
-var algString = process.argv[3];
-if (!(puzzleName && algString)) {
-  console.log("Usage: order <puzzle-geometry-id> <alg>");
-  console.log("");
-  console.log(`Example: order 3x3x3 "R U R' U R U2' R'"`);
-  process.exit(0);
-}
-var kpuzzle = await puzzles[puzzleName].kpuzzle();
-if (!kpuzzle) {
-  const pg = getPuzzleGeometryByName(puzzleName, { allMoves: true });
-  kpuzzle = new KPuzzle(pg.getKPuzzleDefinition(true));
-}
-var order = kpuzzle.algToTransformation(algString).repetitionOrder();
-console.log(order);
+var ReadAlg = {
+  async from(str) {
+    return Alg.fromString(str);
+  }
+};
+var app = command({
+  name: "order",
+  description: `Example: order 3x3x3 "R U R' U R U2' R'"`,
+  args: {
+    puzzleGeometryID: positional({
+      type: cmdString,
+      displayName: "Puzzle geometry ID"
+    }),
+    alg: positional({
+      type: ReadAlg,
+      displayName: "Alg"
+    })
+  },
+  handler: async ({ puzzleGeometryID, alg }) => {
+    const puzzleLoader = puzzles[puzzleGeometryID];
+    const kpuzzle = await (async () => {
+      if (puzzleLoader) {
+        return await puzzles[puzzleGeometryID].kpuzzle();
+      } else {
+        const pg = getPuzzleGeometryByName(puzzleGeometryID, {
+          allMoves: true
+        });
+        return new KPuzzle(pg.getKPuzzleDefinition(true));
+      }
+    })();
+    const order = kpuzzle.algToTransformation(alg).repetitionOrder();
+    console.log(order);
+  }
+});
+await run(binary(app), process.argv);
 //# sourceMappingURL=order.js.map

package/dist/bin/order.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/order.ts"],
-  "sourcesContent": ["// To run this file directly:\n// bun run src/bin/order.ts -- <program args>\n\nimport { KPuzzle } from \"cubing/kpuzzle\";\nimport { getPuzzleGeometryByName } from \"cubing/puzzle-geometry\";\nimport { puzzles } from \"cubing/puzzles\";\n\n/*\n *   Given a puzzle name and an algorithm, calculate the order of that\n *   algorithm (how many repetitions are needed for the algorithm to be\n *   the no-op).\n */\n\nconst puzzleName = process.argv[2];\nconst algString = process.argv[3];\n\nif (!(puzzleName && algString)) {\n  console.log(\"Usage: order <puzzle-geometry-id> <alg>\");\n  console.log(\"\");\n  console.log(\"Example: order 3x3x3 \\\"R U R' U R U2' R'\\\"\");\n  process.exit(0);\n}\n\n/*\n *   Turn a name into a geometry.\n */\n\n// @ts-ignore: Top-level await is okay because this is not part of the main library.\nlet kpuzzle = await puzzles[puzzleName].kpuzzle();\nif (!kpuzzle) {\n  const pg = getPuzzleGeometryByName(puzzleName, { allMoves: true });\n  kpuzzle = new KPuzzle(pg.getKPuzzleDefinition(true));\n}\nconst order = kpuzzle.algToTransformation(algString).repetitionOrder();\nconsole.log(order);\n"],
-  "mappings": ";;;AAGA,SAAS,eAAe;AACxB,SAAS,+BAA+B;AACxC,SAAS,eAAe;AAQxB,IAAM,aAAa,QAAQ,KAAK,CAAC;AACjC,IAAM,YAAY,QAAQ,KAAK,CAAC;AAEhC,IAAI,EAAE,cAAc,YAAY;AAC9B,UAAQ,IAAI,yCAAyC;AACrD,UAAQ,IAAI,EAAE;AACd,UAAQ,IAAI,0CAA4C;AACxD,UAAQ,KAAK,CAAC;AAChB;AAOA,IAAI,UAAU,MAAM,QAAQ,UAAU,EAAE,QAAQ;AAChD,IAAI,CAAC,SAAS;AACZ,QAAM,KAAK,wBAAwB,YAAY,EAAE,UAAU,KAAK,CAAC;AACjE,YAAU,IAAI,QAAQ,GAAG,qBAAqB,IAAI,CAAC;AACrD;AACA,IAAM,QAAQ,QAAQ,oBAAoB,SAAS,EAAE,gBAAgB;AACrE,QAAQ,IAAI,KAAK;",
+  "sourcesContent": ["// To run this file directly:\n// bun run src/bin/order.ts -- 3x3x3 \"R U R' U R U2' R'\"\n\nimport {\n  binary,\n  string as cmdString,\n  command,\n  positional,\n  run,\n  type Type,\n} from \"cmd-ts\";\nimport { Alg } from \"cubing/alg\";\nimport { KPuzzle } from \"cubing/kpuzzle\";\nimport { getPuzzleGeometryByName } from \"cubing/puzzle-geometry\";\nimport { puzzles } from \"cubing/puzzles\";\n\n// TODO: dedup with `screenshot` implementation.\nconst ReadAlg: Type<string, Alg> = {\n  async from(str) {\n    return Alg.fromString(str);\n  },\n};\n\nconst app = command({\n  name: \"order\",\n  description: \"Example: order 3x3x3 \\\"R U R' U R U2' R'\\\"\",\n  args: {\n    puzzleGeometryID: positional({\n      type: cmdString,\n      displayName: \"Puzzle geometry ID\",\n    }),\n    alg: positional({\n      type: ReadAlg,\n      displayName: \"Alg\",\n    }),\n  },\n  handler: async ({ puzzleGeometryID, alg }) => {\n    /*\n     *   Turn a name into a geometry.\n     */\n\n    const puzzleLoader = puzzles[puzzleGeometryID];\n    const 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    const order = kpuzzle.algToTransformation(alg).repetitionOrder();\n    console.log(order);\n  },\n});\n\nawait run(binary(app), process.argv);\n"],
+  "mappings": ";;;AAGA;AAAA,EACE;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,WAAW;AACpB,SAAS,eAAe;AACxB,SAAS,+BAA+B;AACxC,SAAS,eAAe;AAGxB,IAAM,UAA6B;AAAA,EACjC,MAAM,KAAK,KAAK;AACd,WAAO,IAAI,WAAW,GAAG;AAAA,EAC3B;AACF;AAEA,IAAM,MAAM,QAAQ;AAAA,EAClB,MAAM;AAAA,EACN,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,kBAAkB,WAAW;AAAA,MAC3B,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC;AAAA,IACD,KAAK,WAAW;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AAAA,EACA,SAAS,OAAO,EAAE,kBAAkB,IAAI,MAAM;AAK5C,UAAM,eAAe,QAAQ,gBAAgB;AAC7C,UAAM,UAAU,OAAO,YAAY;AACjC,UAAI,cAAc;AAChB,eAAO,MAAM,QAAQ,gBAAgB,EAAE,QAAQ;AAAA,MACjD,OAAO;AACL,cAAM,KAAK,wBAAwB,kBAAkB;AAAA,UACnD,UAAU;AAAA,QACZ,CAAC;AACD,eAAO,IAAI,QAAQ,GAAG,qBAAqB,IAAI,CAAC;AAAA,MAClD;AAAA,IACF,GAAG;AACH,UAAM,QAAQ,QAAQ,oBAAoB,GAAG,EAAE,gBAAgB;AAC/D,YAAQ,IAAI,KAAK;AAAA,EACnB;AACF,CAAC;AAED,MAAM,IAAI,OAAO,GAAG,GAAG,QAAQ,IAAI;",
   "names": []
 }

package/dist/bin/scramble.js

@@ -1,146 +1,165 @@
 #!/usr/bin/env node
 
 // src/bin/scramble.ts
+import {
+  binary,
+  number as cmdNumber,
+  string as cmdString,
+  command,
+  flag,
+  oneOf,
+  option,
+  optional,
+  positional,
+  run
+} from "cmd-ts";
 import { eventInfo } from "cubing/puzzles";
 import { randomScrambleForEvent } from "cubing/scramble";
 import { setSearchDebug } from "cubing/search";
-var [yargs, hideBin] = await (async () => {
-  try {
-    const yargs2 = (await import("yargs")).default;
-    const { hideBin: hideBin2 } = await import("yargs/helpers");
-    return [yargs2, hideBin2];
-  } catch (e) {
-    throw new Error(
-      "Could not import `yargs`, which is not automatically installed as a regular dependency of `cubing`. Please run `npm install yargs` (or the equivalent) separately."
-    );
-  }
-})();
-var argv = await yargs(
-  // TODO: `hideBin` just shows `bun` in `bun`.
-  hideBin(process.argv)
-).option("amount", {
-  describe: "Amount of scrambles.",
-  default: 1,
-  type: "number",
-  alias: "n"
-}).option("format", {
-  describe: "Output format.",
-  choices: ["text", "link", "json-text"],
-  alias: "f"
-}).option("notation", {
-  describe: "Notation type.",
-  default: "auto",
-  choices: ["auto", "LGN"]
-}).option("text", {
-  type: "boolean",
-  describe: "Convenient shorthand for `--format text`.",
-  alias: "t"
-}).usage(
-  "$0 eventID",
-  "Generate cubing scrambles.",
-  (yargs2) => yargs2.positional("eventID", {
-    describe: "WCA or unofficial event ID",
-    type: "string"
-  })
-).version(false).strictOptions().argv;
-var eventID = argv.eventID;
-var { format } = argv;
-format ??= argv.text || !process.stdout.isTTY ? "text" : "auto";
-setSearchDebug({ logPerf: false, showWorkerInstantiationWarnings: false });
-function scrambleText(scramble) {
-  return scramble.toString({
-    // TODO: any
-    notation: argv.notation
-  });
-}
-function scrambleLink(scramble) {
-  const url = new URL("https://alpha.twizzle.net/edit/");
-  const puzzleID = eventInfo(eventID)?.puzzleID;
-  puzzleID && url.searchParams.set("puzzle", puzzleID);
-  url.searchParams.set("alg", scrambleText(scramble));
-  return url.toString();
+try {
+  await import("cmd-ts");
+} catch (e) {
+  throw new Error(
+    "Could not import `cmd-ts`, which is not automatically installed as a regular dependency of `cubing`. Please run `npm install cmd-ts` (or the equivalent) separately."
+  );
 }
-var JSONListPrinter = class {
-  #finished = false;
-  #firstValuePrintedAlready = false;
-  constructor() {
-    process.stdout.write("[\n  ");
-  }
-  push(value) {
-    if (this.#firstValuePrintedAlready) {
-      process.stdout.write(",\n  ");
-    }
-    this.#firstValuePrintedAlready = true;
-    process.stdout.write(JSON.stringify(value));
-  }
-  finish() {
-    if (this.#finished) {
-      throw new Error("Tried to finish JSON list printing multiple times.");
+var outputFormats = ["text", "link", "json-text"];
+var notationTypes = ["auto", "LGN"];
+var app = command({
+  name: "scramble",
+  args: {
+    amount: option({
+      description: "Amount of scrambles",
+      type: cmdNumber,
+      long: "amount",
+      short: "n",
+      defaultValue: () => 1,
+      defaultValueIsSerializable: true
+    }),
+    format: option({
+      description: `Output format. One of: ${outputFormats.join(", ")}`,
+      type: optional(oneOf(outputFormats)),
+      long: "format",
+      short: "f"
+    }),
+    notation: option({
+      description: `Notation type. One of: ${notationTypes.join(", ")}`,
+      type: optional(oneOf(["auto", "LGN"])),
+      long: "notation"
+    }),
+    text: flag({
+      description: "Convenient shorthand for `--format text`.",
+      long: "t",
+      // TODO: https://github.com/Schniz/cmd-ts/issues/221
+      short: "t"
+    }),
+    eventID: positional({
+      type: cmdString,
+      displayName: "WCA or unofficial event ID"
+    })
+  },
+  handler: async ({ amount, format: argsFormat, notation, text, eventID }) => {
+    const format = argsFormat ?? (text || !process.stdout.isTTY ? "text" : "auto");
+    setSearchDebug({ logPerf: false, showWorkerInstantiationWarnings: false });
+    function scrambleText(scramble) {
+      return scramble.toString({
+        // TODO: any
+        notation
+        // TODO: handle type conversion at arg parse time.
+      });
     }
-    this.#finished = true;
-    console.log("\n]");
-  }
-};
-if (format !== "json-text" && argv.amount === 1) {
-  const scramble = await randomScrambleForEvent(eventID);
-  switch (format) {
-    case "text": {
-      console.log(scrambleText(scramble));
-      break;
-    }
-    case "link": {
-      console.log(scrambleLink(scramble));
-      break;
+    function scrambleLink(scramble) {
+      const url = new URL("https://alpha.twizzle.net/edit/");
+      const puzzleID = eventInfo(eventID)?.puzzleID;
+      puzzleID && url.searchParams.set("puzzle", puzzleID);
+      url.searchParams.set("alg", scrambleText(scramble));
+      return url.toString();
     }
-    case "json-text": {
-      throw new Error(
-        "Encountered `json` format in code that is not expected to handle it."
-      );
+    class JSONListPrinter {
+      #finished = false;
+      #firstValuePrintedAlready = false;
+      constructor() {
+        process.stdout.write("[\n  ");
+      }
+      push(value) {
+        if (this.#firstValuePrintedAlready) {
+          process.stdout.write(",\n  ");
+        }
+        this.#firstValuePrintedAlready = true;
+        process.stdout.write(JSON.stringify(value));
+      }
+      finish() {
+        if (this.#finished) {
+          throw new Error("Tried to finish JSON list printing multiple times.");
+        }
+        this.#finished = true;
+        console.log("\n]");
+      }
     }
-    case "auto": {
-      console.log(`${scrambleText(scramble)}
+    if (format !== "json-text" && amount === 1) {
+      const scramble = await randomScrambleForEvent(eventID);
+      switch (format) {
+        case "text": {
+          console.log(scrambleText(scramble));
+          break;
+        }
+        case "link": {
+          console.log(scrambleLink(scramble));
+          break;
+        }
+        // @ts-ignore This is a code guard for future refactoring.
+        case "json-text": {
+          throw new Error(
+            "Encountered `json` format in code that is not expected to handle it."
+          );
+        }
+        case "auto": {
+          console.log(`${scrambleText(scramble)}
 
 \u{1F517} ${scrambleLink(scramble)}`);
-      break;
-    }
-    default: {
-      throw new Error("Unknown format!");
-    }
-  }
-} else {
-  const jsonListPrinter = format === "json-text" ? new JSONListPrinter() : void 0;
-  for (let i = 0; i < argv.amount; i++) {
-    const scramble = await randomScrambleForEvent(eventID);
-    switch (format) {
-      case "text": {
-        console.log(`// Scramble #${i + 1}`);
-        console.log(`${scrambleText(scramble)}
-`);
-        break;
+          break;
+        }
+        default: {
+          throw new Error("Unknown format!");
+        }
       }
-      case "link": {
-        console.log(`// Scramble #${i + 1}`);
-        console.log(`${scrambleLink(scramble)}
+    } else {
+      const jsonListPrinter = format === "json-text" ? new JSONListPrinter() : void 0;
+      for (let i = 0; i < amount; i++) {
+        const scramble = await randomScrambleForEvent(eventID);
+        switch (format) {
+          case "text": {
+            console.log(`// Scramble #${i + 1}`);
+            console.log(`${scrambleText(scramble)}
 `);
-        break;
-      }
-      case "json-text": {
-        jsonListPrinter?.push(scramble.toString());
-        break;
-      }
-      case "auto": {
-        console.log(`// Scramble #${i + 1}
+            break;
+          }
+          case "link": {
+            console.log(`// Scramble #${i + 1}`);
+            console.log(`${scrambleLink(scramble)}
+`);
+            break;
+          }
+          case "json-text": {
+            jsonListPrinter?.push(scramble.toString());
+            break;
+          }
+          case "auto": {
+            console.log(`// Scramble #${i + 1}
 ${scrambleText(scramble)}
 
 \u{1F517} ${scrambleLink(scramble)}
 `);
-        break;
-      }
-      default: {
-        throw new Error("Unknown format!");
+            break;
+          }
+          default: {
+            throw new Error("Unknown format!");
+          }
+        }
       }
+      jsonListPrinter?.finish();
     }
   }
-  jsonListPrinter?.finish();
-}
+});
+await run(binary(app), process.argv);
 //# sourceMappingURL=scramble.js.map

package/dist/bin/scramble.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/bin/scramble.ts"],
-  "sourcesContent": ["// To run this file directly:\n// bun run src/bin/scramble.ts -- 333\n\nimport type { Alg, ExperimentalSerializationOptions } from \"cubing/alg\";\nimport { eventInfo } from \"cubing/puzzles\";\nimport { randomScrambleForEvent } from \"cubing/scramble\";\nimport { setSearchDebug } from \"cubing/search\";\n\n// TODO: completions for `bash`, `zsh`, and `fish`: https://github.com/loilo/completarr\n\nconst [yargs, hideBin] = await (async () => {\n  try {\n    const yargs = (await import(\"yargs\")).default;\n    const { hideBin } = await import(\"yargs/helpers\");\n    return [yargs, hideBin];\n  } catch (e) {\n    throw new Error(\n      \"Could not import `yargs`, which is not automatically installed as a regular dependency of `cubing`. Please run `npm install yargs` (or the equivalent) separately.\",\n    );\n  }\n})();\n\n// @ts-ignore: Top-level await is okay because this is not part of the main library.\nconst argv = await yargs(\n  // TODO: `hideBin` just shows `bun` in `bun`.\n  hideBin(process.argv),\n)\n  .option(\"amount\", {\n    describe: \"Amount of scrambles.\",\n    default: 1,\n    type: \"number\",\n    alias: \"n\",\n  })\n  .option(\"format\", {\n    describe: \"Output format.\",\n    choices: [\"text\", \"link\", \"json-text\"],\n    alias: \"f\",\n  })\n  .option(\"notation\", {\n    describe: \"Notation type.\",\n    default: \"auto\",\n    choices: [\"auto\", \"LGN\"],\n  })\n  .option(\"text\", {\n    type: \"boolean\",\n    describe: \"Convenient shorthand for `--format text`.\",\n    alias: \"t\",\n  })\n  .usage(\"$0 eventID\", \"Generate cubing scrambles.\", (yargs) =>\n    yargs.positional(\"eventID\", {\n      describe: \"WCA or unofficial event ID\",\n      type: \"string\",\n    }),\n  )\n  .version(false) // TODO: why doesn't `yargs` get the right version in `bun` or for the `dist` bin?\n  .strictOptions().argv;\n\nconst eventID = argv.eventID as string;\nlet { format } = argv;\nformat ??= argv.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: (argv as ExperimentalSerializationOptions).notation,\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\nif (format !== \"json-text\" && argv.amount === 1) {\n  // @ts-ignore: Top-level await is okay because this is not part of the main library.\n  const scramble = await randomScrambleForEvent(eventID);\n\n  switch (format) {\n    case \"text\": {\n      console.log(scrambleText(scramble));\n      break;\n    }\n    case \"link\": {\n      console.log(scrambleLink(scramble));\n      break;\n    }\n    case \"json-text\": {\n      throw new Error(\n        \"Encountered `json` format in code that is not expected to handle it.\",\n      );\n    }\n    case \"auto\": {\n      console.log(`${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}`);\n      break;\n    }\n    default: {\n      throw new Error(\"Unknown format!\");\n    }\n  }\n} else {\n  const jsonListPrinter: JSONListPrinter<string> | undefined =\n    format === \"json-text\" ? new JSONListPrinter() : undefined;\n  for (let i = 0; i < argv.amount; i++) {\n    // @ts-ignore: Top-level await is okay because this is not part of the main library.\n    const scramble = await randomScrambleForEvent(eventID);\n    switch (format) {\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      case \"auto\": {\n        console.log(`// Scramble #${i + 1}\n${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}\n`);\n        break;\n      }\n      default: {\n        throw new Error(\"Unknown format!\");\n      }\n    }\n  }\n  jsonListPrinter?.finish();\n}\n"],
-  "mappings": "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",
-  "names": ["yargs", "hideBin"]
+  "sourcesContent": ["// To run this file directly:\n// bun run src/bin/scramble.ts -- 333\n\n// TODO: completions for `bash`, `zsh`, and `fish`: https://github.com/loilo/completarr\ntry {\n  await import(\"cmd-ts\");\n} catch (e) {\n  throw new Error(\n    \"Could not import `cmd-ts`, which is not automatically installed as a regular dependency of `cubing`. Please run `npm install cmd-ts` (or the equivalent) separately.\",\n  );\n}\n\nimport {\n  binary,\n  number as cmdNumber,\n  string as cmdString,\n  command,\n  flag,\n  oneOf,\n  option,\n  optional,\n  positional,\n  run,\n} from \"cmd-ts\";\nimport type { Alg } from \"cubing/alg\";\nimport { eventInfo } from \"cubing/puzzles\";\nimport { randomScrambleForEvent } from \"cubing/scramble\";\nimport { setSearchDebug } from \"cubing/search\";\n\n// TODO: file an issue about printing these values.\nconst outputFormats = [\"text\", \"link\", \"json-text\"] as const;\nconst notationTypes = [\"auto\", \"LGN\"] as const;\n\nconst app = command({\n  name: \"scramble\",\n  args: {\n    amount: option({\n      description: \"Amount of scrambles\",\n      type: cmdNumber,\n      long: \"amount\",\n      short: \"n\",\n      defaultValue: () => 1,\n      defaultValueIsSerializable: true,\n    }),\n    format: option({\n      description: `Output format. One of: ${outputFormats.join(\", \")}`,\n      type: optional(oneOf(outputFormats)),\n      long: \"format\",\n      short: \"f\",\n    }),\n    notation: option({\n      description: `Notation type. One of: ${notationTypes.join(\", \")}`,\n      type: optional(oneOf([\"auto\", \"LGN\"])),\n      long: \"notation\",\n    }),\n    text: flag({\n      description: \"Convenient shorthand for `--format text`.\",\n      long: \"t\", // TODO: https://github.com/Schniz/cmd-ts/issues/221\n      short: \"t\",\n    }),\n    eventID: positional({\n      type: cmdString,\n      displayName: \"WCA or unofficial event ID\",\n    }),\n  },\n  handler: async ({ amount, format: argsFormat, notation, text, eventID }) => {\n    const format =\n      argsFormat ?? (text || !process.stdout.isTTY ? \"text\" : \"auto\");\n\n    setSearchDebug({ logPerf: false, showWorkerInstantiationWarnings: false });\n\n    function 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\n    function 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\n    class 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    if (format !== \"json-text\" && amount === 1) {\n      const scramble = await randomScrambleForEvent(eventID);\n\n      switch (format) {\n        case \"text\": {\n          console.log(scrambleText(scramble));\n          break;\n        }\n        case \"link\": {\n          console.log(scrambleLink(scramble));\n          break;\n        }\n        // @ts-ignore 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        case \"auto\": {\n          console.log(`${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}`);\n          break;\n        }\n        default: {\n          throw new Error(\"Unknown format!\");\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        // @ts-ignore: Top-level await is okay because this is not part of the main library.\n        const scramble = await randomScrambleForEvent(eventID);\n        switch (format) {\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          case \"auto\": {\n            console.log(`// Scramble #${i + 1}\n${scrambleText(scramble)}\n\n\uD83D\uDD17 ${scrambleLink(scramble)}\n`);\n            break;\n          }\n          default: {\n            throw new Error(\"Unknown format!\");\n          }\n        }\n      }\n      jsonListPrinter?.finish();\n    }\n  },\n});\n\nawait run(binary(app), process.argv);\n"],
+  "mappings": "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",
+  "names": []
 }

package/dist/lib/cubing/{index-BieP5oS7.d.ts → KPattern.d-BYanty6A.d.ts}

@@ -1,107 +1,4 @@
-import { M as Move, A as Alg } from './PuzzleLoader-Cas0EZPp.js';
-
-interface NotationMapper {
-    notationToInternal(move: Move): Move | null;
-    notationToExternal(move: Move): Move | null;
-}
-
-declare function parseOptions(argv: string[]): {
-    puzzleDescription: PuzzleDescription | null;
-    options: PuzzleGeometryOptions;
-};
-type FaceName = string;
-type OrientationDirection = [number, number, number];
-type FaceBasedOrientationDescription = [
-    [
-        FaceName,
-        OrientationDirection
-    ],
-    [
-        FaceName,
-        OrientationDirection
-    ]
-];
-type BaseFaceCount = 4 | 6 | 8 | 12 | 20;
-type FaceBasedOrientationDescriptionLookup = Record<BaseFaceCount, FaceBasedOrientationDescription>;
-declare class PuzzleGeometryFullOptions {
-    verbosity: number;
-    allMoves: boolean;
-    outerBlockMoves: boolean;
-    vertexMoves: boolean;
-    addRotations: boolean;
-    moveList: string[] | null;
-    fixedOrientation: boolean;
-    fixedPieceType: null | "e" | "v" | "f";
-    orientCenters: boolean;
-    includeCornerOrbits: boolean;
-    includeCenterOrbits: boolean;
-    includeEdgeOrbits: boolean;
-    excludeOrbits: string[];
-    optimizeOrbits: boolean;
-    grayCorners: boolean;
-    grayCenters: boolean;
-    grayEdges: boolean;
-    puzzleOrientation: FaceBasedOrientationDescription | null;
-    puzzleOrientations: FaceBasedOrientationDescriptionLookup | null;
-    scrambleAmount: number;
-    constructor(options?: PuzzleGeometryOptions);
-}
-type PuzzleGeometryOptions = Partial<PuzzleGeometryFullOptions>;
-
-declare class Perm {
-    n: number;
-    p: number[];
-    constructor(a: number[]);
-    toString(): string;
-    mul(p2: Perm): Perm;
-    rmul(p2: Perm): Perm;
-    inv(): Perm;
-    compareTo(p2: Perm): number;
-    toGap(): string;
-    toMathematica(): string;
-    order(): number;
-}
-
-declare class KTransformation {
-    #private;
-    readonly kpuzzle: KPuzzle;
-    readonly transformationData: KTransformationData;
-    constructor(kpuzzle: KPuzzle, transformationData: KTransformationData);
-    toJSON(): any;
-    invert(): KTransformation;
-    isIdentityTransformation(): boolean;
-    /** @deprecated */
-    static experimentalConstructIdentity(kpuzzle: KPuzzle): KTransformation;
-    isIdentical(t2: KTransformation): boolean;
-    /** @deprecated */
-    apply(source: KTransformationSource): KTransformation;
-    applyTransformation(t2: KTransformation): KTransformation;
-    applyMove(move: Move | string): KTransformation;
-    applyAlg(alg: Alg | string): KTransformation;
-    toKPattern(): KPattern;
-    repetitionOrder(): number;
-    selfMultiply(amount: number): KTransformation;
-}
-
-declare class KPattern {
-    readonly kpuzzle: KPuzzle;
-    readonly patternData: KPatternData;
-    constructor(kpuzzle: KPuzzle, patternData: KPatternData);
-    toJSON(): any;
-    static fromTransformation(transformation: KTransformation): KPattern;
-    /** @deprecated */
-    apply(source: KTransformationSource): KPattern;
-    applyTransformation(transformation: KTransformation): KPattern;
-    applyMove(move: Move | string): KPattern;
-    applyAlg(alg: Alg | string): KPattern;
-    isIdentical(other: KPattern): boolean;
-    /** @deprecated */
-    experimentalToTransformation(): KTransformation | null;
-    experimentalIsSolved(options: {
-        ignorePuzzleOrientation: boolean;
-        ignoreCenterOrientation: boolean;
-    }): boolean;
-}
+import { M as Move, A as Alg } from './PuzzleLoader-Bxh01zKY.js';
 
 type KPatternData = Record<string, KPatternOrbitData>;
 interface KPatternOrbitData {
@@ -254,6 +151,89 @@ interface KPuzzleDefinition {
     }) => boolean;
 }
 
+declare class KTransformation {
+    #private;
+    readonly kpuzzle: KPuzzle;
+    readonly transformationData: KTransformationData;
+    constructor(kpuzzle: KPuzzle, transformationData: KTransformationData);
+    toJSON(): any;
+    invert(): KTransformation;
+    isIdentityTransformation(): boolean;
+    /** @deprecated */
+    static experimentalConstructIdentity(kpuzzle: KPuzzle): KTransformation;
+    isIdentical(t2: KTransformation): boolean;
+    /** @deprecated */
+    apply(source: KTransformationSource): KTransformation;
+    applyTransformation(t2: KTransformation): KTransformation;
+    applyMove(move: Move | string): KTransformation;
+    applyAlg(alg: Alg | string): KTransformation;
+    toKPattern(): KPattern;
+    repetitionOrder(): number;
+    selfMultiply(amount: number): KTransformation;
+}
+
+interface NotationMapper {
+    notationToInternal(move: Move): Move | null;
+    notationToExternal(move: Move): Move | null;
+}
+
+declare function parseOptions(argv: string[]): {
+    puzzleDescription: PuzzleDescription | null;
+    options: PuzzleGeometryOptions;
+};
+type FaceName = string;
+type OrientationDirection = [number, number, number];
+type FaceBasedOrientationDescription = [
+    [
+        FaceName,
+        OrientationDirection
+    ],
+    [
+        FaceName,
+        OrientationDirection
+    ]
+];
+type BaseFaceCount = 4 | 6 | 8 | 12 | 20;
+type FaceBasedOrientationDescriptionLookup = Record<BaseFaceCount, FaceBasedOrientationDescription>;
+declare class PuzzleGeometryFullOptions {
+    verbosity: number;
+    allMoves: boolean;
+    outerBlockMoves: boolean;
+    vertexMoves: boolean;
+    addRotations: boolean;
+    moveList: string[] | null;
+    fixedOrientation: boolean;
+    fixedPieceType: null | "e" | "v" | "f";
+    orientCenters: boolean;
+    includeCornerOrbits: boolean;
+    includeCenterOrbits: boolean;
+    includeEdgeOrbits: boolean;
+    excludeOrbits: string[];
+    optimizeOrbits: boolean;
+    grayCorners: boolean;
+    grayCenters: boolean;
+    grayEdges: boolean;
+    puzzleOrientation: FaceBasedOrientationDescription | null;
+    puzzleOrientations: FaceBasedOrientationDescriptionLookup | null;
+    scrambleAmount: number;
+    constructor(options?: PuzzleGeometryOptions);
+}
+type PuzzleGeometryOptions = Partial<PuzzleGeometryFullOptions>;
+
+declare class Perm {
+    n: number;
+    p: number[];
+    constructor(a: number[]);
+    toString(): string;
+    mul(p2: Perm): Perm;
+    rmul(p2: Perm): Perm;
+    inv(): Perm;
+    compareTo(p2: Perm): number;
+    toGap(): string;
+    toMathematica(): string;
+    order(): number;
+}
+
 declare class PGOrbitDef {
     size: number;
     mod: number;
@@ -547,4 +527,24 @@ declare class KPuzzle {
     canConvertDefaultPatternToUniqueTransformation(): boolean;
 }
 
+declare class KPattern {
+    readonly kpuzzle: KPuzzle;
+    readonly patternData: KPatternData;
+    constructor(kpuzzle: KPuzzle, patternData: KPatternData);
+    toJSON(): any;
+    static fromTransformation(transformation: KTransformation): KPattern;
+    /** @deprecated */
+    apply(source: KTransformationSource): KPattern;
+    applyTransformation(transformation: KTransformation): KPattern;
+    applyMove(move: Move | string): KPattern;
+    applyAlg(alg: Alg | string): KPattern;
+    isIdentical(other: KPattern): boolean;
+    /** @deprecated */
+    experimentalToTransformation(): KTransformation | null;
+    experimentalIsSolved(options: {
+        ignorePuzzleOrientation: boolean;
+        ignoreCenterOrientation: boolean;
+    }): boolean;
+}
+
 export { KPattern as K, Perm as P, Quat as Q, type StickerDat as S, getPuzzleGeometryByDesc as a, getPuzzleGeometryByName as b, getPG3DNamedPuzzles as c, PuzzleGeometry as d, type StickerDatAxis as e, type StickerDatFace as f, getPuzzleDescriptionString as g, type StickerDatSticker as h, parseOptions as i, type PuzzleGeometryOptions as j, PGNotation as k, type PuzzleCutDescription as l, type PuzzleDescription as m, PUZZLE_CUT_TYPES as n, type PuzzleCutType as o, parsePuzzleDescription as p, PUZZLE_BASE_SHAPES as q, type PuzzleBaseShape as r, KPuzzle as s, KTransformation as t, type PuzzleDescriptionString as u, type KPuzzleDefinition as v, type KPatternData as w, type KPatternOrbitData as x, type KTransformationData as y, type KTransformationOrbitData as z };