cubing 0.36.2 → 0.37.0-pre1

package/dist/esm/alg/index.js

@@ -18,7 +18,7 @@ import {
   functionFromTraversal,
   keyToMove,
   setAlgDebug
-} from "../chunk-2OZSC5I6.js";
+} from "../chunk-TM7SKFJD.js";
 export {
   Alg,
   AlgBuilder,

package/dist/esm/bluetooth/index.js

@@ -1,23 +1,23 @@
 import {
   binaryComponentsToReid3x3x3,
   twizzleBinaryToBinaryComponents
-} from "../chunk-IKK6NEES.js";
+} from "../chunk-L7WY7BIO.js";
 import {
   cube3x3x3,
   puzzles
-} from "../chunk-KPYYHLXC.js";
+} from "../chunk-GGJSIUGA.js";
 import {
   experimental3x3x3KPuzzle
-} from "../chunk-QWQ3WKAJ.js";
+} from "../chunk-L4PH24KU.js";
 import {
   KState
-} from "../chunk-UIGRNWPE.js";
+} from "../chunk-RSF22LKP.js";
 import {
   Alg,
   Move,
   experimentalAppendMove,
   keyToMove
-} from "../chunk-2OZSC5I6.js";
+} from "../chunk-TM7SKFJD.js";
 
 // src/cubing/bluetooth/debug.ts
 var DEBUG_LOGGING_ENABLED = false;

package/dist/esm/{chunk-CS3NN22U.js → chunk-6XZN5QCJ.js}

@@ -1,15 +1,15 @@
 import {
   insideAPI
-} from "./chunk-Z4KB5H3Q.js";
+} from "./chunk-TNBM5BTH.js";
 import {
   exposeAPI
-} from "./chunk-RHC3DIN3.js";
+} from "./chunk-7QE2OVHX.js";
 import {
   node_adapter_default
 } from "./chunk-ZYCJIZDN.js";
 import {
   Alg
-} from "./chunk-2OZSC5I6.js";
+} from "./chunk-TM7SKFJD.js";
 
 // src/cubing/search/inside/solve/puzzles/clock.ts
 import { randomUIntBelow } from "random-uint-below";
@@ -107,21 +107,27 @@ async function constructWorker(source, options) {
   return worker;
 }
 
-// src/cubing/search/inside/search-worker-ts-entry-path-getter.ts
-exposeAPI.expose = false;
-async function getWorkerEntryFileURL() {
-  return (await import("./search-worker-ts-entry-7OR7E6EC.js")).WORKER_ENTRY_FILE_URL;
+// src/cubing/search/worker-workarounds/index.ts
+async function searchWorkerURLImportMetaResolve() {
+  return import.meta.resolve(
+    "./search/worker-workarounds/search-worker-entry.js"
+  );
+}
+function searchWorkerURLNewURLImportMetaURL() {
+  return new URL(
+    "./search/worker-workarounds/search-worker-entry.js",
+    import.meta.url
+  );
+}
+async function searchWorkerURLEsbuildWorkaround() {
+  exposeAPI.expose = false;
+  return (await import("./search/worker-workarounds/search-worker-entry.js")).WORKER_ENTRY_FILE_URL;
 }
 
 // src/cubing/search/instantiator.ts
-var MODULE_WORKER_TIMEOUT_MILLISECONDS = 5e3;
-async function instantiateModuleWorker() {
+async function instantiateModuleWorker(workerEntryFileURL) {
   return new Promise(async (resolve, reject) => {
-    const timeoutID = setTimeout(() => {
-      reject(new Error("module instantiation timeout"));
-    }, MODULE_WORKER_TIMEOUT_MILLISECONDS);
     try {
-      const workerEntryFileURL = await getWorkerEntryFileURL();
       if (!workerEntryFileURL) {
         reject(new Error("Could not get worker entry file URL."));
       }
@@ -141,13 +147,10 @@ async function instantiateModuleWorker() {
         type: "module"
       });
       const onError = (e) => {
-        if (e.message?.startsWith("SyntaxError")) {
-          reject(e);
-        }
+        reject(e);
       };
       const onFirstMessage = (messageData) => {
         if (messageData === "comlink-exposed") {
-          clearTimeout(timeoutID);
           resolve(wrapWithTerminate(worker));
         } else {
           reject(
@@ -175,11 +178,6 @@ function wrapWithTerminate(worker) {
   const terminate = worker.terminate.bind(worker);
   return { insideAPI: insideAPI2, outsideAPI: { terminate } };
 }
-async function instantiateClassicWorker() {
-  const { workerSource } = await import("./search-worker-inside-generated-string-EFAMJBWG.js");
-  const worker = await constructWorker(workerSource, { eval: true });
-  return wrapWithTerminate(worker);
-}
 var allInsideOutsideAPIPromises = [];
 async function instantiateWorker() {
   const insideOutsideAPIPromise = instantiateWorkerImplementation();
@@ -197,25 +195,34 @@ async function mapToAllWorkers(f) {
 }
 async function instantiateWorkerImplementation() {
   if (searchOutsideDebugGlobals.forceStringWorker) {
-    console.warn(
-      "Using the `forceStringWorker` workaround for search worker instantiation. This will require downloading significantly more code than necessary, but the functionality will be the same."
-    );
-    return instantiateClassicWorker();
+    console.warn("The `forceStringWorker` workaround is no longer supported.");
   }
-  try {
-    return await instantiateModuleWorker();
-  } catch (e) {
-    const commonErrorPrefix = "Could not instantiate module worker (this may happen in Firefox, or when using Parcel).";
-    if (searchOutsideDebugGlobals.disableStringWorker) {
-      console.error(
-        `${commonErrorPrefix} Fallback to string worker is disabled.`,
-        e
-      );
-      throw new Error("Module worker instantiation failed.");
+  function failed(methodDescription) {
+    return `Module worker instantiation${methodDescription ? ` ${methodDescription}` : ""} failed`;
+  }
+  const fallbackOrder = [
+    [searchWorkerURLImportMetaResolve, "using `import.meta.resolve(\u2026)", false],
+    [
+      searchWorkerURLNewURLImportMetaURL,
+      "using `new URL(\u2026, import.meta.url)`",
+      true
+    ],
+    [searchWorkerURLEsbuildWorkaround, "using the `esbuild` workaround", true]
+  ];
+  for (const [fn, description, warnOnSuccess] of fallbackOrder) {
+    try {
+      const worker = await instantiateModuleWorker(await fn());
+      if (warnOnSuccess) {
+        console.warn(
+          `Module worker instantiation required ${description}. \`cubing.js\` will not support this fallback in the future.`
+        );
+      }
+      return worker;
+    } catch {
+      console.warn(`${failed(description)}, falling back.`);
     }
-    console.warn(`${commonErrorPrefix} Falling back to string worker.`, e);
-    return instantiateClassicWorker();
   }
+  throw new Error(`${failed()}. There are no more fallbacks available.`);
 }
 
 // src/cubing/search/outside.ts
@@ -330,4 +337,4 @@ export {
   solveTwsearch,
   setDebug
 };
-//# sourceMappingURL=chunk-CS3NN22U.js.map
+//# sourceMappingURL=chunk-6XZN5QCJ.js.map

package/dist/esm/chunk-6XZN5QCJ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cubing/search/inside/solve/puzzles/clock.ts", "../../src/cubing/search/inside/solve/puzzles/wca-minx.ts", "../../src/cubing/vendor/apache/comlink-everywhere/outside/index.ts", "../../src/cubing/search/worker-workarounds/index.ts", "../../src/cubing/search/instantiator.ts", "../../src/cubing/search/outside.ts"],
+  "sourcesContent": ["import { randomUIntBelow } from \"random-uint-below\";\n\nconst pins = [\"UR\", \"DR\", \"DL\", \"UL\"];\nconst backMoves = [\"U\", \"R\", \"D\", \"L\", \"ALL\"];\nconst frontMoves = pins.concat(backMoves);\n\nexport function randomClockScrambleString(): string {\n  let filteringMoveCount = 0;\n\n  function randomSuffix() {\n    const amount = randomUIntBelow(12);\n    if (amount !== 0) {\n      filteringMoveCount++;\n    }\n    if (amount <= 6) {\n      return `${amount}+`;\n    } else {\n      return `${12 - amount}-`;\n    }\n  }\n\n  const moves = [];\n  function side(families: string[]): void {\n    for (const family of families) {\n      moves.push(`${family}${randomSuffix()}`);\n    }\n  }\n\n  side(frontMoves);\n  moves.push(\"y2\");\n  side(backMoves);\n\n  // https://www.worldcubeassociation.org/regulations/#4b3\n  if (filteringMoveCount < 2) {\n    return randomClockScrambleString();\n  }\n\n  for (const pin of pins) {\n    if (randomUIntBelow(2) === 0) {\n      moves.push(pin);\n    }\n  }\n  return moves.join(\" \");\n}\n", "import { randomUIntBelow } from \"random-uint-below\";\n\nconst suffixes = [\"++\", \"--\"];\n\nexport function randomMegaminxScrambleString(): string {\n  function rdPair(): string {\n    return `R${suffixes[randomUIntBelow(2)]} D${suffixes[randomUIntBelow(2)]}`;\n  }\n\n  function randomU(): string {\n    return `U${[\"\", \"'\"][randomUIntBelow(2)]}`;\n  }\n\n  function row(): string {\n    const chunks = [];\n    for (let i = 0; i < 5; i++) {\n      chunks.push(rdPair());\n    }\n    chunks.push(randomU());\n    return chunks.join(\" \");\n  }\n\n  const chunks = [];\n  for (let i = 0; i < 6; i++) {\n    chunks.push(row());\n  }\n  return chunks.join(\"\\n\");\n}\n", "import nodeEndpoint from \"../node-adapter\";\n\nexport { wrap } from \"comlink\";\n// Mangled so that bundlers don't try to inline the source.\n\nconst worker_threads_mangled = \"node:w-orker-_threa-ds\";\nconst worker_threads_unmangled = () => worker_threads_mangled.replace(/-/g, \"\");\n\nconst useNodeWorkarounds =\n  typeof globalThis.Worker === \"undefined\" &&\n  typeof (globalThis as any).WorkerNavigator === \"undefined\";\n\nasync function nodeWorker(\n  source: string | URL,\n  options?: { eval?: boolean },\n): Promise<Worker> {\n  const { Worker: NodeWorker } = await import(\n    /* @vite-ignore */ worker_threads_unmangled()\n  );\n  const worker = new NodeWorker(source, options);\n  worker.unref();\n  return nodeEndpoint(worker);\n}\n\nexport async function constructWorker(\n  source: string | URL,\n  options?: { eval?: boolean; type?: WorkerType },\n): Promise<Worker> {\n  let worker;\n  if (useNodeWorkarounds) {\n    return nodeWorker(source, { eval: options?.eval });\n  } else {\n    if (options?.eval) {\n      const blob = new Blob([source as string], {\n        type: \"application/javascript\",\n      });\n      source = URL.createObjectURL(blob);\n    }\n    worker = new globalThis.Worker(source, {\n      type: options ? options.type : undefined, // TODO: Is it safe to use `options?.type`?\n    });\n  }\n  return worker;\n}\n", "import { exposeAPI } from \"./worker-guard\";\n\nexport async function searchWorkerURLImportMetaResolve(): Promise<string> {\n  // Note:\n  // - We have to hardcode the expected path of the entry file in the ESM build, due to lack of `esbuild` support: https://github.com/evanw/esbuild/issues/2866\n  //   - This URL is based on the assumption that the code from this file ends up in a shared chunk in the `esm` build. This is not guaranteed by `esbuild`, but it consistently happens for our codebase.\n  // - We inline the value (instead of using a constant), to maximize compatibility for hardcoded syntax detection in bundlers.\n  // - `import.meta.resolve(\u2026)` returns a sync result in every environment except `bun`: https://loadeverything.net/#compatibility-dashboard\n  //   - We assume that it's `async`, just in case.\n  // @ts-ignore\n  return import.meta.resolve(\n    \"./search/worker-workarounds/search-worker-entry.js\",\n  );\n}\n\nexport function searchWorkerURLNewURLImportMetaURL(): URL {\n  // Note:\n  // - We have to hardcode the expected path of the entry file in the ESM build, due to lack of `esbuild` support: https://github.com/evanw/esbuild/issues/795\n  //   - This URL is based on the assumption that the code from this file ends up in a shared chunk in the `esm` build. This is not guaranteed by `esbuild`, but it consistently happens for our codebase.\n  // - We inline the value (instead of using a constant), to maximize compatibility for hardcoded syntax detection in bundlers.\n  return new URL(\n    \"./search/worker-workarounds/search-worker-entry.js\",\n    import.meta.url,\n  );\n}\n\n// Workaround for `esbuild`: https://github.com/evanw/esbuild/issues/312#issuecomment-1092195778\nexport async function searchWorkerURLEsbuildWorkaround(): Promise<string> {\n  exposeAPI.expose = false;\n  return (await import(\"./search-worker-entry\")).WORKER_ENTRY_FILE_URL;\n}\n", "import {\n  constructWorker,\n  wrap,\n} from \"../vendor/apache/comlink-everywhere/outside\";\nimport { insideAPI, type WorkerInsideAPI } from \"./inside/api\";\nimport { searchOutsideDebugGlobals } from \"./outside\";\nimport {\n  searchWorkerURLEsbuildWorkaround,\n  searchWorkerURLImportMetaResolve,\n  searchWorkerURLNewURLImportMetaURL,\n} from \"./worker-workarounds\";\n\nexport interface WorkerOutsideAPI {\n  terminate: () => void; // `node` can return a `Promise` with an exit code, but we match the web worker API.\n}\nexport interface InsideOutsideAPI {\n  insideAPI: WorkerInsideAPI;\n  outsideAPI: WorkerOutsideAPI;\n}\n\nexport async function instantiateModuleWorker(\n  workerEntryFileURL: string | URL,\n): Promise<InsideOutsideAPI> {\n  // rome-ignore lint/suspicious/noAsyncPromiseExecutor: TODO\n  return new Promise<InsideOutsideAPI>(async (resolve, reject) => {\n    try {\n      if (!workerEntryFileURL) {\n        reject(new Error(\"Could not get worker entry file URL.\"));\n      }\n      let url: string | URL;\n      if (globalThis.Worker) {\n        // Standard browser-like environment.\n        const importSrc = `import ${JSON.stringify(\n          workerEntryFileURL.toString(),\n        )};`;\n        const blob = new Blob([importSrc], {\n          type: \"text/javascript\",\n        });\n        url = URL.createObjectURL(blob);\n      } else {\n        // We need to keep the original entry file URL, but we have to wrap it in the `URL` class.\n        url = new URL(workerEntryFileURL);\n      }\n\n      const worker = (await constructWorker(url, {\n        type: \"module\",\n      })) as Worker & {\n        nodeWorker?: import(\"worker_threads\").Worker;\n      };\n\n      const onError = (e: ErrorEvent) => {\n        reject(e);\n      };\n\n      // TODO: Remove this once we can remove the workarounds for lack of `import.meta.resolve(\u2026)` support.\n      const onFirstMessage = (messageData: string) => {\n        if (messageData === \"comlink-exposed\") {\n          // We need to clear the timeout so that we don't prevent `node` from exiting in the meantime.\n          resolve(wrapWithTerminate(worker));\n        } else {\n          reject(\n            new Error(`wrong module instantiation message ${messageData}`),\n          );\n        }\n      };\n\n      if (worker.nodeWorker) {\n        // We have to use `once` so the `unref()` from `comlink-everywhere` allows the process to quit as expected.\n        worker.nodeWorker.once(\"message\", onFirstMessage);\n      } else {\n        worker.addEventListener(\"error\", onError, {\n          once: true,\n        });\n        worker.addEventListener(\"message\", (e) => onFirstMessage(e.data), {\n          once: true,\n        });\n      }\n    } catch (e) {\n      reject(e);\n    }\n  });\n}\n\nfunction wrapWithTerminate(worker: Worker): InsideOutsideAPI {\n  const insideAPI = wrap<WorkerInsideAPI>(worker);\n  const terminate = worker.terminate.bind(worker);\n  return { insideAPI, outsideAPI: { terminate } };\n}\n\nexport const allInsideOutsideAPIPromises: Promise<InsideOutsideAPI>[] = [];\n\nexport async function instantiateWorker(): Promise<InsideOutsideAPI> {\n  const insideOutsideAPIPromise = instantiateWorkerImplementation();\n  allInsideOutsideAPIPromises.push(insideOutsideAPIPromise);\n  insideAPI.setDebugMeasurePerf(searchOutsideDebugGlobals.logPerf);\n  insideAPI.setScramblePrefetchLevel(\n    searchOutsideDebugGlobals.scramblePrefetchLevel,\n  );\n  return insideOutsideAPIPromise;\n}\n\nexport async function mapToAllWorkers(\n  f: (worker: InsideOutsideAPI) => void,\n): Promise<void> {\n  await Promise.all(\n    allInsideOutsideAPIPromises.map((worker) => worker.then(f)),\n  );\n}\n\nasync function instantiateWorkerImplementation(): Promise<InsideOutsideAPI> {\n  if (searchOutsideDebugGlobals.forceStringWorker) {\n    console.warn(\"The `forceStringWorker` workaround is no longer supported.\");\n  }\n\n  function failed(methodDescription?: string) {\n    return `Module worker instantiation${\n      methodDescription ? ` ${methodDescription}` : \"\"\n    } failed`;\n  }\n\n  const fallbackOrder: [\n    fn: () => string | URL | Promise<string>,\n    description: string,\n    warnOnSuccess: boolean,\n  ][] = [\n    [searchWorkerURLImportMetaResolve, \"using `import.meta.resolve(\u2026)\", false],\n    [\n      searchWorkerURLNewURLImportMetaURL,\n      \"using `new URL(\u2026, import.meta.url)`\",\n      true,\n    ],\n    [searchWorkerURLEsbuildWorkaround, \"using the `esbuild` workaround\", true],\n  ];\n\n  for (const [fn, description, warnOnSuccess] of fallbackOrder) {\n    try {\n      const worker = await instantiateModuleWorker(await fn());\n      if (warnOnSuccess) {\n        console.warn(\n          `Module worker instantiation required ${description}. \\`cubing.js\\` will not support this fallback in the future.`,\n        );\n      }\n      return worker;\n    } catch {\n      console.warn(`${failed(description)}, falling back.`);\n    }\n  }\n\n  throw new Error(`${failed()}. There are no more fallbacks available.`);\n}\n", "import { Alg } from \"../alg\";\nimport type { KPuzzle } from \"../kpuzzle\";\n// import { preInitialize222 } from \"../implementations/2x2x2\";\nimport type { KState } from \"../kpuzzle/KState\";\nimport type { PrefetchLevel } from \"./inside/api\";\nimport { randomClockScrambleString } from \"./inside/solve/puzzles/clock\"; // TODO: don't reach into `inside` code.\nimport { randomMegaminxScrambleString } from \"./inside/solve/puzzles/wca-minx\"; // TODO: don't reach into `inside` code.\nimport type { TwsearchOptions } from \"./inside/solve/twsearch\";\nimport {\n  type InsideOutsideAPI,\n  instantiateWorker,\n  mapToAllWorkers,\n} from \"./instantiator\";\n\nlet cachedWorkerInstance: Promise<InsideOutsideAPI> | null = null;\nasync function getCachedWorkerInstance(): Promise<InsideOutsideAPI> {\n  return await (cachedWorkerInstance ??= instantiateWorker());\n}\n\n// Pre-initialize the scrambler for the given event. (Otherwise, an event is\n// initialized the first time you ask for a scramble for that event.)\n//\n// Some typical numbers for a fast computer:\n// - 3x3x3 initialization: 200ms\n// - Each 3x3x3 scramble: 50ms\n// - 4x4x4 initialization: 2500ms\n// - Each 4x4x4 scramble: 300ms to 800ms\n//\n// It is safe to immediately call for a scramble\n// any time after starting pre-initialization, or to call for them without\n// pre-initializing. Pre-initializing essentially gives the scramble worker a\n// head start in case a scramble doesn't get requested immediately.\n//\n// Note that events cannot be pre-initialized in parallel. Attempting to\n// pre-initialize multiple events will initialize them consecutively. Scrambles\n// for a given event cannot be computed while another event is being initialized.\nexport function _preInitializationHintForEvent(\n  eventID: string,\n  // callback?: () => void\n): void {\n  switch (eventID) {\n    case \"clock\":\n    case \"minx\":\n      return;\n    case \"333oh\":\n      _preInitializationHintForEvent(\"333\");\n      return;\n  }\n  (async () => {\n    await (await getCachedWorkerInstance()).insideAPI.initialize(eventID);\n  })();\n}\n\nexport async function randomScrambleForEvent(eventID: string): Promise<Alg> {\n  switch (eventID) {\n    case \"clock\":\n      return Alg.fromString(await randomClockScrambleString());\n    case \"minx\":\n      return Alg.fromString(await randomMegaminxScrambleString());\n  }\n  const prom = _randomScrambleStringForEvent(eventID);\n  const wat = await prom;\n  return Alg.fromString(wat);\n}\n\nexport async function _randomScrambleStringForEvent(\n  eventID: string,\n): Promise<string> {\n  if (searchOutsideDebugGlobals.forceNewWorkerForEveryScramble) {\n  }\n  const worker = searchOutsideDebugGlobals.forceNewWorkerForEveryScramble\n    ? await instantiateWorker()\n    : await getCachedWorkerInstance();\n  return worker.insideAPI.randomScrambleStringForEvent(eventID);\n}\n\nexport async function randomScrambleStringForEvent(\n  eventID: string,\n): Promise<string> {\n  switch (eventID) {\n    case \"clock\":\n      return randomClockScrambleString();\n    case \"minx\":\n      return randomMegaminxScrambleString();\n  }\n  return await _randomScrambleStringForEvent(eventID);\n}\n\nexport async function experimentalSolve3x3x3IgnoringCenters(\n  state: KState,\n): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.insideAPI.solve333ToString(state.stateData));\n}\n\nexport async function experimentalSolve2x2x2(state: KState): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.insideAPI.solve222ToString(state.stateData));\n}\n\nexport async function solveSkewb(state: KState): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(\n    await cwi.insideAPI.solveSkewbToString(state.stateData),\n  );\n}\n\nexport async function solvePyraminx(state: KState): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(\n    await cwi.insideAPI.solvePyraminxToString(state.stateData),\n  );\n}\n\nexport async function solveMegaminx(state: KState): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(\n    await cwi.insideAPI.solveMegaminxToString(state.stateData),\n  );\n}\n\nexport interface SolveTwsearchOptions {\n  moveSubset?: string[];\n  startState?: KState;\n  minDepth?: number;\n}\n\nexport async function solveTwsearch(\n  kpuzzle: KPuzzle,\n  state: KState,\n  options?: SolveTwsearchOptions,\n): Promise<Alg> {\n  const { startState, ...otherOptions } = options ?? {};\n  const apiOptions: TwsearchOptions = otherOptions;\n  if (startState) {\n    apiOptions.startState =\n      startState.experimentalToTransformation()!.transformationData;\n  }\n  const { ...def } = kpuzzle.definition;\n  delete def.experimentalIsStateSolved;\n  // delete def.experimentalDerivedMoves;\n  const dedicatedWorker = await instantiateWorker();\n  try {\n    return Alg.fromString(\n      await dedicatedWorker.insideAPI.solveTwsearchToString(\n        def,\n        state.stateData,\n        apiOptions,\n      ),\n    );\n  } finally {\n    console.log(\"Search ended, terminating dedicated `twsearch` worker.\");\n    // TODO: support re-using the same worker for multiple searches..\n    await dedicatedWorker.outsideAPI.terminate();\n  }\n}\n\ninterface SearchOutsideDebugGlobals {\n  logPerf: boolean;\n  scramblePrefetchLevel: `${PrefetchLevel}`;\n  forceStringWorker: boolean;\n  disableStringWorker: boolean;\n  forceNewWorkerForEveryScramble: boolean;\n}\nexport const searchOutsideDebugGlobals: SearchOutsideDebugGlobals = {\n  logPerf: false,\n  scramblePrefetchLevel: \"auto\",\n  forceStringWorker: false,\n  disableStringWorker: false,\n  forceNewWorkerForEveryScramble: false,\n};\n\nexport function setDebug(options: Partial<SearchOutsideDebugGlobals>): void {\n  const { logPerf, scramblePrefetchLevel } = options;\n  if (typeof logPerf !== \"undefined\") {\n    searchOutsideDebugGlobals.logPerf = logPerf;\n    mapToAllWorkers((worker) => worker.insideAPI.setDebugMeasurePerf(logPerf));\n  }\n  if (typeof scramblePrefetchLevel !== \"undefined\") {\n    searchOutsideDebugGlobals.scramblePrefetchLevel = scramblePrefetchLevel;\n    mapToAllWorkers((worker) =>\n      worker.insideAPI.setScramblePrefetchLevel(\n        scramblePrefetchLevel as PrefetchLevel,\n      ),\n    );\n  }\n  if (\"forceStringWorker\" in options) {\n    searchOutsideDebugGlobals.forceStringWorker = !!options.forceStringWorker;\n  }\n  if (\"disableStringWorker\" in options) {\n    searchOutsideDebugGlobals.disableStringWorker =\n      !!options.disableStringWorker;\n  }\n  if (\"forceNewWorkerForEveryScramble\" in options) {\n    searchOutsideDebugGlobals.forceNewWorkerForEveryScramble =\n      !!options.forceNewWorkerForEveryScramble;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["randomUIntBelow", "chunks", "insideAPI"]
+}

package/dist/esm/{chunk-BT4N5EGX.js → chunk-7MSAVSVG.js}

@@ -1,6 +1,6 @@
 import {
   from
-} from "./chunk-QWQ3WKAJ.js";
+} from "./chunk-L4PH24KU.js";
 
 // src/cubing/twisty/debug.ts
 var twistyDebugGlobals = {
@@ -541,7 +541,7 @@ var StatsPanel = class {
 // src/cubing/twisty/heavy-code-imports/3d.ts
 var cachedConstructorProxy = null;
 async function proxy3D() {
-  return cachedConstructorProxy ?? (cachedConstructorProxy = import("./twisty-dynamic-3d-XRLWOI7Y.js"));
+  return cachedConstructorProxy ?? (cachedConstructorProxy = import("./twisty-dynamic-3d-JRADYLKK.js"));
 }
 var THREEJS = from(
   async () => (await proxy3D()).T3I
@@ -1175,4 +1175,4 @@ export {
   proxy3D,
   THREEJS
 };
-//# sourceMappingURL=chunk-BT4N5EGX.js.map
+//# sourceMappingURL=chunk-7MSAVSVG.js.map

package/dist/esm/chunk-7QE2OVHX.js

@@ -0,0 +1,9 @@
+// src/cubing/search/worker-workarounds/worker-guard.ts
+var exposeAPI = {
+  expose: true
+};
+
+export {
+  exposeAPI
+};
+//# sourceMappingURL=chunk-7QE2OVHX.js.map

package/dist/esm/{chunk-RHC3DIN3.js.map → chunk-7QE2OVHX.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/cubing/search/inside/worker-guard.ts"],
+  "sources": ["../../src/cubing/search/worker-workarounds/worker-guard.ts"],
   "sourcesContent": ["export const exposeAPI: { expose: boolean } = {\n  expose: true,\n};\n"],
   "mappings": ";AAAO,IAAM,YAAiC;AAAA,EAC5C,QAAQ;AACV;",
   "names": []

package/dist/esm/{chunk-KPYYHLXC.js → chunk-GGJSIUGA.js}

@@ -11,14 +11,14 @@ import {
   experimental3x3x3KPuzzle,
   from,
   getCached
-} from "./chunk-QWQ3WKAJ.js";
+} from "./chunk-L4PH24KU.js";
 import {
   KPuzzle
-} from "./chunk-UIGRNWPE.js";
+} from "./chunk-RSF22LKP.js";
 import {
   Move,
   QuantumMove
-} from "./chunk-2OZSC5I6.js";
+} from "./chunk-TM7SKFJD.js";
 
 // src/cubing/puzzles/events.ts
 var wcaEvents = {
@@ -660,4 +660,4 @@ export {
   cube3x3x3,
   puzzles
 };
-//# sourceMappingURL=chunk-KPYYHLXC.js.map
+//# sourceMappingURL=chunk-GGJSIUGA.js.map

package/dist/esm/{chunk-QWQ3WKAJ.js → chunk-L4PH24KU.js}

@@ -1,11 +1,11 @@
 import {
   KPuzzle,
   KState
-} from "./chunk-UIGRNWPE.js";
+} from "./chunk-RSF22LKP.js";
 import {
   Alg,
   Move
-} from "./chunk-2OZSC5I6.js";
+} from "./chunk-TM7SKFJD.js";
 
 // src/cubing/puzzles/stickerings/mask.ts
 function getFaceletStickeringMask(stickeringMask, orbitName, pieceIdx, faceletIdx, hint) {
@@ -1230,4 +1230,4 @@ export {
   customPGPuzzleLoader,
   experimental3x3x3KPuzzle
 };
-//# sourceMappingURL=chunk-QWQ3WKAJ.js.map
+//# sourceMappingURL=chunk-L4PH24KU.js.map

package/dist/esm/{chunk-IKK6NEES.js → chunk-L7WY7BIO.js}

@@ -3,10 +3,10 @@ import {
   normalize3x3x3Orientation,
   puzzleOrientation3x3x3Cache,
   puzzleOrientation3x3x3Idx
-} from "./chunk-QWQ3WKAJ.js";
+} from "./chunk-L4PH24KU.js";
 import {
   KState
-} from "./chunk-UIGRNWPE.js";
+} from "./chunk-RSF22LKP.js";
 
 // src/cubing/protocol/binary/orbit-indexing.ts
 function identityPermutation(numElems) {
@@ -251,4 +251,4 @@ export {
   bufferToSpacedHex,
   spacedHexToBuffer
 };
-//# sourceMappingURL=chunk-IKK6NEES.js.map
+//# sourceMappingURL=chunk-L7WY7BIO.js.map

package/dist/esm/{chunk-EODSL4J7.js → chunk-O64NYJ3S.js}

@@ -1,17 +1,17 @@
 import {
   puzzles
-} from "./chunk-KPYYHLXC.js";
+} from "./chunk-GGJSIUGA.js";
 import {
   from
-} from "./chunk-QWQ3WKAJ.js";
+} from "./chunk-L4PH24KU.js";
 import {
   KState
-} from "./chunk-UIGRNWPE.js";
+} from "./chunk-RSF22LKP.js";
 import {
   Alg,
   AlgBuilder,
   Move
-} from "./chunk-2OZSC5I6.js";
+} from "./chunk-TM7SKFJD.js";
 
 // src/cubing/search/inside/solve/puzzles/3x3x3/index.ts
 import { randomChoice as randomChoice2 } from "random-uint-below";
@@ -612,4 +612,4 @@ export {
   random333OrientedScramble,
   random333FewestMovesScramble
 };
-//# sourceMappingURL=chunk-EODSL4J7.js.map
+//# sourceMappingURL=chunk-O64NYJ3S.js.map

package/dist/esm/{chunk-UIGRNWPE.js → chunk-RSF22LKP.js}

@@ -3,7 +3,7 @@ import {
   Move,
   TraversalDownUp,
   functionFromTraversal
-} from "./chunk-2OZSC5I6.js";
+} from "./chunk-TM7SKFJD.js";
 
 // src/cubing/kpuzzle/combine.ts
 function combineTransformationData(definition, transformationData1, transformationData2) {
@@ -601,4 +601,4 @@ export {
   KTransformation,
   KPuzzle
 };
-//# sourceMappingURL=chunk-UIGRNWPE.js.map
+//# sourceMappingURL=chunk-RSF22LKP.js.map

package/dist/esm/{chunk-2OZSC5I6.js → chunk-TM7SKFJD.js}

@@ -1047,7 +1047,7 @@ var AppendOptionsHelper = class {
 function areSameDirection(direction, move2) {
   return direction * Math.sign(move2.amount) >= 0;
 }
-function offsetMod(x, positiveMod, offset) {
+function offsetMod(x, positiveMod, offset = 0) {
   return ((x - offset) % positiveMod + positiveMod) % positiveMod + offset;
 }
 function experimentalAppendMove(alg, addedMove, options) {
@@ -1835,10 +1835,11 @@ export {
   TraversalDownUp,
   TraversalUp,
   functionFromTraversal,
+  offsetMod,
   experimentalAppendMove,
   Alg,
   Example,
   keyToMove,
   experimentalAlgCubingNetLink
 };
-//# sourceMappingURL=chunk-2OZSC5I6.js.map
+//# sourceMappingURL=chunk-TM7SKFJD.js.map