cubing 0.63.2 → 0.63.3

package/dist/bin/chunks/{chunk-52ODPET6.js → chunk-OI3YIXMQ.js}

@@ -4,10 +4,10 @@
 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.63.2"
+  "0.63.3"
 );
 
 export {
   packageVersion
 };
-//# sourceMappingURL=chunk-52ODPET6.js.map
+//# sourceMappingURL=chunk-OI3YIXMQ.js.map

package/dist/bin/order.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-52ODPET6.js";
+} from "./chunks/chunk-OI3YIXMQ.js";
 
 // src/bin/order.ts
 import { basename } from "node:path";

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-52ODPET6.js";
+} from "./chunks/chunk-OI3YIXMQ.js";
 
 // src/bin/puzzle-geometry-bin.ts
 import { basename } from "node:path";

package/dist/bin/scramble.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-52ODPET6.js";
+} from "./chunks/chunk-OI3YIXMQ.js";
 
 // src/bin/scramble.ts
 import { basename } from "node:path";

package/dist/lib/cubing/{PuzzleLoader-R-puDLmC.d.ts → PuzzleLoader-Bp8zngUn.d.ts}

@@ -1508,6 +1508,11 @@ declare class HintFaceletProp extends SimpleTwistyPropSource<HintFaceletStyleWit
     getDefaultValue(): HintFaceletStyleWithAuto;
 }
 
+type HintFaceletsElevationRequest = "auto" | number;
+declare class HintFaceletsElevationProp extends SimpleTwistyPropSource<"auto" | number> {
+    getDefaultValue(): "auto" | number;
+}
+
 type InitialHintFaceletsAnimation = "auto" | "always" | "none";
 declare class InitialHintFaceletsAnimationProp extends SimpleTwistyPropSource<InitialHintFaceletsAnimation> {
     getDefaultValue(): InitialHintFaceletsAnimation;
@@ -1619,6 +1624,7 @@ declare class TwistySceneModel {
     hintFacelet: HintFaceletProp;
     hintStickerSpriteURL: URLProp;
     initialHintFaceletsAnimation: InitialHintFaceletsAnimationProp;
+    hintFaceletsElevation: HintFaceletsElevationProp;
     latitudeLimit: LatitudeLimitProp;
     movePressInput: MovePressInputProp;
     movePressCancelOptions: MovePressCancelOptions;
@@ -1983,6 +1989,8 @@ declare abstract class TwistyPlayerSettable extends ManagedCustomElement {
     get fullscreenElement(): never;
     set experimentalInitialHintFaceletsAnimation(anim: InitialHintFaceletsAnimation);
     get experimentalInitialHintFaceletsAnimation(): never;
+    set experimentalHintFaceletsElevation(elevation: "auto" | number);
+    get experimentalHintFaceletsElevation(): never;
     set experimentalDragInput(dragInputMode: DragInputMode);
     get experimentalDragInput(): never;
     experimentalGet: ExperimentalGetters;
@@ -2041,6 +2049,8 @@ interface TwistyPlayerConfig {
     controlPanel?: ControlPanelThemeWithAuto;
     backView?: BackViewLayoutWithAuto;
     experimentalInitialHintFaceletsAnimation?: InitialHintFaceletsAnimation;
+    experimentalFaceletScale?: FaceletScale;
+    experimentalHintFaceletsElevation?: HintFaceletsElevationRequest;
     viewerLink?: ViewerLinkPageWithAuto;
     experimentalMovePressInput?: MovePressInput;
     experimentalDragInput?: DragInputMode;

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-R-puDLmC.js';
-export { a1 as AlgBranch, a2 as AppendCancelOptions, a3 as ExperimentalNotationType, a4 as ExperimentalParsed, a5 as ExperimentalSerializationOptions, a6 as GroupingModifications, a7 as MoveModifications, w as PuzzleSpecificSimplifyOptions, a8 as QuantumMove, a9 as SimplifyOptions } from '../PuzzleLoader-R-puDLmC.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-Bp8zngUn.js';
+export { a1 as AlgBranch, a2 as AppendCancelOptions, a3 as ExperimentalNotationType, a4 as ExperimentalParsed, a5 as ExperimentalSerializationOptions, a6 as GroupingModifications, a7 as MoveModifications, w as PuzzleSpecificSimplifyOptions, a8 as QuantumMove, a9 as SimplifyOptions } from '../PuzzleLoader-Bp8zngUn.js';
 import 'type-fest';
 import 'three/src/Three.js';
 

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

@@ -1,5 +1,5 @@
-import { A as AlgLeafEvent, O as OrientationEvent } from '../events-IfSwQLYm.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-R-puDLmC.js';
+import { A as AlgLeafEvent, O as OrientationEvent } from '../events-CewDA1aS.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-Bp8zngUn.js';
 import 'type-fest';
 import 'three/src/Three.js';
 

package/dist/lib/cubing/chunks/chunk-44CFF24P.js

@@ -0,0 +1,239 @@
+import {
+  PortableWorker,
+  wrap
+} from "./chunk-FTE3QI5X.js";
+import {
+  exposeAPI
+} from "./chunk-7GUL3OBQ.js";
+import {
+  Alg
+} from "./chunk-O6HEZXGY.js";
+
+// src/cubing/search/worker-workarounds/index.ts
+function searchWorkerURLImportMetaResolve() {
+  return import.meta.resolve("./search-worker-entry.js");
+}
+function searchWorkerURLNewURLImportMetaURL() {
+  return new URL("./search-worker-entry.js", import.meta.url);
+}
+async function searchWorkerURLEsbuildWorkaround() {
+  exposeAPI.expose = false;
+  return (await import("./search-worker-entry.js")).WORKER_ENTRY_FILE_URL;
+}
+
+// src/cubing/search/instantiator.ts
+function wrapAPI(worker) {
+  return wrap(worker);
+}
+async function instantiateModuleWorker(workerEntryFileURL) {
+  return new Promise(async (resolve, reject) => {
+    try {
+      const worker = new PortableWorker(workerEntryFileURL);
+      const onFirstMessage = (messageData) => {
+        if (messageData === "comlink-exposed") {
+          resolve(wrapAPI(worker));
+        } else {
+          reject(
+            new Error(`wrong module instantiation message ${messageData}`)
+          );
+        }
+      };
+      const onError = (e) => {
+        reject(e);
+      };
+      if ("once" in worker) {
+        worker.once("message", onFirstMessage);
+      } else {
+        worker.addEventListener("error", onError, {
+          once: true
+        });
+        worker.addEventListener(
+          "message",
+          (e) => onFirstMessage(e.data),
+          {
+            once: true
+          }
+        );
+      }
+    } catch (e) {
+      reject(e);
+    }
+  });
+}
+var allWorkerAPIPromises = [];
+async function instantiateWorkerAPI() {
+  const workerAPIPromise = instantiateWorkerImplementation();
+  allWorkerAPIPromises.push(workerAPIPromise);
+  const insideAPI = await workerAPIPromise;
+  insideAPI.setDebugMeasurePerf(searchOutsideDebugGlobals.logPerf);
+  insideAPI.setScramblePrefetchLevel(
+    searchOutsideDebugGlobals.scramblePrefetchLevel
+  );
+  return workerAPIPromise;
+}
+async function instantiateWorkerImplementation() {
+  if (globalThis.location?.protocol === "file:") {
+    console.warn(
+      "This current web page is loaded from the local filesystem (a URL that starts with `file://`). In this situation, `cubing.js` may be unable to generate scrambles or perform searches in some browsers. See: https://js.cubing.net/cubing/scramble/#file-server-required"
+    );
+  }
+  function failed(methodDescription) {
+    return `Module worker instantiation${methodDescription ? ` ${methodDescription}` : ""} failed`;
+  }
+  const importMetaResolveStrategy = [
+    async () => instantiateModuleWorker(searchWorkerURLImportMetaResolve()),
+    "using `import.meta.resolve(\u2026)",
+    null
+  ];
+  const esbuildWorkaroundStrategy = [
+    async () => instantiateModuleWorker(await searchWorkerURLEsbuildWorkaround()),
+    "using the `esbuild` workaround",
+    // TODO: we will hopefully discontinue the `esbuild` workaround at some
+    // point, but `esbuild` has been stuck for 3 years on this issue. Because
+    // `esbuild` and Vite (which uses `esbuild`) are now dominating the
+    // ecosystem, this just causes a warning for a lot of devs/users that they
+    // can't do anything about. As frustrating as the situation is, the
+    // workaround is semantically fine (even if it's convoluted) and is
+    // preserved by `esbuild`-based flows in practice. So we suppress the
+    // warning in the medium-term but maintain long-term hope that we can
+    // remove it (and the other fallbacks as well).
+    null
+  ];
+  const newURLStrategy = [
+    async () => instantiateModuleWorker(searchWorkerURLNewURLImportMetaURL()),
+    "using `new URL(\u2026, import.meta.url)`",
+    "will"
+  ];
+  const fallbackOrder = searchOutsideDebugGlobals.prioritizeEsbuildWorkaroundForWorkerInstantiation ? [esbuildWorkaroundStrategy, importMetaResolveStrategy, newURLStrategy] : [importMetaResolveStrategy, esbuildWorkaroundStrategy, newURLStrategy];
+  for (const [fn, description, warnOnSuccess] of fallbackOrder) {
+    try {
+      const worker = await fn();
+      if (warnOnSuccess) {
+        if (searchOutsideDebugGlobals.showWorkerInstantiationWarnings) {
+          console.warn(
+            `Module worker instantiation required ${description}. \`cubing.js\` ${warnOnSuccess} not support this fallback in the future.`
+          );
+        }
+      }
+      return worker;
+    } catch {
+    }
+  }
+  throw new Error(`${failed()}. There are no more fallbacks available.`);
+}
+
+// src/cubing/search/outside.ts
+var cachedWorkerInstance;
+function getCachedWorkerInstance() {
+  return cachedWorkerInstance ??= instantiateWorkerAPI();
+}
+async function mapToAllWorkers(f) {
+  await Promise.all(
+    allWorkerAPIPromises.map(async (worker) => {
+      f(await worker);
+    })
+  );
+}
+async function randomScrambleForEvent(eventID) {
+  const worker = searchOutsideDebugGlobals.forceNewWorkerForEveryScramble ? await instantiateWorkerAPI() : await getCachedWorkerInstance();
+  const scrambleString = await worker.randomScrambleStringForEvent(eventID);
+  return Alg.fromString(scrambleString);
+}
+async function deriveScrambleForEvent(derivationSeedHex, derivationSaltHierarchy, eventID) {
+  if (!searchOutsideDebugGlobals.allowDerivedScrambles) {
+    throw new Error("Derived scrambles are not allowed.");
+  }
+  const worker = searchOutsideDebugGlobals.forceNewWorkerForEveryScramble ? await instantiateWorkerAPI() : await getCachedWorkerInstance();
+  const scrambleString = await worker.deriveScrambleStringForEvent(
+    derivationSeedHex,
+    derivationSaltHierarchy,
+    eventID
+  );
+  return Alg.fromString(scrambleString);
+}
+async function experimentalSolve3x3x3IgnoringCenters(pattern) {
+  const cwi = await getCachedWorkerInstance();
+  return Alg.fromString(await cwi.solve333ToString(pattern.patternData));
+}
+async function experimentalSolve2x2x2(pattern) {
+  const cwi = await getCachedWorkerInstance();
+  return Alg.fromString(await cwi.solve222ToString(pattern.patternData));
+}
+async function solveSkewb(pattern) {
+  const cwi = await getCachedWorkerInstance();
+  return Alg.fromString(await cwi.solveSkewbToString(pattern.patternData));
+}
+async function solvePyraminx(pattern) {
+  const cwi = await getCachedWorkerInstance();
+  return Alg.fromString(await cwi.solvePyraminxToString(pattern.patternData));
+}
+async function solveMegaminx(pattern) {
+  const cwi = await getCachedWorkerInstance();
+  return Alg.fromString(await cwi.solveMegaminxToString(pattern.patternData));
+}
+async function solveTwips(kpuzzle, pattern, options) {
+  const { targetPattern, ...otherOptions } = options ?? {};
+  const apiOptions = otherOptions;
+  if (targetPattern) {
+    apiOptions.targetPattern = targetPattern.patternData;
+  }
+  const { ...def } = kpuzzle.definition;
+  delete def.experimentalIsPatternSolved;
+  const dedicatedWorker = await instantiateWorkerAPI();
+  try {
+    return Alg.fromString(
+      // TODO: unnecessary because we terminate the worker?
+      await dedicatedWorker.solveTwipsToString(
+        def,
+        pattern.patternData,
+        apiOptions
+      )
+    );
+  } finally {
+    console.log("Search ended, terminating dedicated `twips` worker.");
+  }
+}
+var searchOutsideDebugGlobals = {
+  logPerf: true,
+  scramblePrefetchLevel: "auto",
+  forceNewWorkerForEveryScramble: false,
+  showWorkerInstantiationWarnings: true,
+  prioritizeEsbuildWorkaroundForWorkerInstantiation: false,
+  allowDerivedScrambles: false
+};
+function setSearchDebug(options) {
+  const { logPerf, scramblePrefetchLevel } = options;
+  if (typeof logPerf !== "undefined") {
+    searchOutsideDebugGlobals.logPerf = logPerf;
+    void mapToAllWorkers((worker) => worker.setDebugMeasurePerf(logPerf));
+  }
+  if (typeof scramblePrefetchLevel !== "undefined") {
+    searchOutsideDebugGlobals.scramblePrefetchLevel = scramblePrefetchLevel;
+    void mapToAllWorkers(
+      (worker) => worker.setScramblePrefetchLevel(scramblePrefetchLevel)
+    );
+  }
+  for (const booleanField of [
+    "forceNewWorkerForEveryScramble",
+    "showWorkerInstantiationWarnings",
+    "prioritizeEsbuildWorkaroundForWorkerInstantiation",
+    "allowDerivedScrambles"
+  ]) {
+    if (booleanField in options) {
+      searchOutsideDebugGlobals[booleanField] = options[booleanField] ?? searchOutsideDebugGlobals[booleanField];
+    }
+  }
+}
+
+export {
+  randomScrambleForEvent,
+  deriveScrambleForEvent,
+  experimentalSolve3x3x3IgnoringCenters,
+  experimentalSolve2x2x2,
+  solveSkewb,
+  solvePyraminx,
+  solveMegaminx,
+  solveTwips,
+  setSearchDebug
+};
+//# sourceMappingURL=chunk-44CFF24P.js.map

package/dist/lib/cubing/chunks/chunk-44CFF24P.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cubing/search/worker-workarounds/index.ts", "../../../../src/cubing/search/instantiator.ts", "../../../../src/cubing/search/outside.ts"],
+  "sourcesContent": ["import { exposeAPI } from \"./worker-guard\";\n\nexport function searchWorkerURLImportMetaResolve(): 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  return import.meta.resolve(\"./search-worker-entry.js\");\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(\"./search-worker-entry.js\", import.meta.url);\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.js\")).WORKER_ENTRY_FILE_URL;\n}\n\nexport function instantiateSearchWorkerURLNewURLImportMetaURL(): Worker {\n  return new Worker(new URL(\"./search-worker-entry.js\", import.meta.url), {\n    type: \"module\",\n  });\n}\n", "import type { Worker as NodeWorker } from \"node:worker_threads\";\nimport { PortableWorker, wrap } from \"../vendor/apache/comlink-everywhere\";\nimport type { WorkerAPI } from \"./inside/api\";\nimport { searchOutsideDebugGlobals } from \"./outside\";\nimport {\n  searchWorkerURLEsbuildWorkaround,\n  searchWorkerURLImportMetaResolve,\n  searchWorkerURLNewURLImportMetaURL,\n} from \"./worker-workarounds\";\n\nfunction wrapAPI(worker: Worker | NodeWorker): WorkerAPI {\n  return wrap<WorkerAPI>(worker);\n}\n\nasync function instantiateModuleWorker(\n  workerEntryFileURL: string | URL,\n): Promise<WorkerAPI> {\n  // biome-ignore lint/suspicious/noAsyncPromiseExecutor: TODO\n  return new Promise<WorkerAPI>(async (resolve, reject) => {\n    try {\n      const worker = new PortableWorker(workerEntryFileURL);\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(wrapAPI(worker));\n        } else {\n          reject(\n            new Error(`wrong module instantiation message ${messageData}`),\n          );\n        }\n      };\n\n      const onError = (e: ErrorEvent) => {\n        reject(e);\n      };\n\n      if (\"once\" in worker /* hack to detect `node` */) {\n        // We have to use `once` so the `unref()` from `comlink-everywhere` allows the process to quit as expected.\n        worker.once(\"message\", onFirstMessage);\n      } else {\n        worker.addEventListener(\"error\", onError, {\n          once: true,\n        });\n        worker.addEventListener(\n          \"message\",\n          (e: MessageEvent) => onFirstMessage(e.data),\n          {\n            once: true,\n          },\n        );\n      }\n    } catch (e) {\n      reject(e);\n    }\n  });\n}\n\nexport const allWorkerAPIPromises: Promise<WorkerAPI>[] = [];\n\nexport async function instantiateWorkerAPI(): Promise<WorkerAPI> {\n  const workerAPIPromise = instantiateWorkerImplementation();\n  allWorkerAPIPromises.push(workerAPIPromise);\n  const insideAPI = await workerAPIPromise;\n  insideAPI.setDebugMeasurePerf(searchOutsideDebugGlobals.logPerf);\n  insideAPI.setScramblePrefetchLevel(\n    searchOutsideDebugGlobals.scramblePrefetchLevel,\n  );\n  return workerAPIPromise;\n}\n\ntype FallbackStrategyInfo = [\n  fn: () => Promise<WorkerAPI>,\n  description: string,\n  warnOnSuccess: null | string,\n];\n\nasync function instantiateWorkerImplementation(): Promise<WorkerAPI> {\n  if (globalThis.location?.protocol === \"file:\") {\n    console.warn(\n      \"This current web page is loaded from the local filesystem (a URL that starts with `file://`). In this situation, `cubing.js` may be unable to generate scrambles or perform searches in some browsers. See: https://js.cubing.net/cubing/scramble/#file-server-required\",\n    );\n  }\n\n  function failed(methodDescription?: string) {\n    return `Module worker instantiation${\n      methodDescription ? ` ${methodDescription}` : \"\"\n    } failed`;\n  }\n\n  const importMetaResolveStrategy: FallbackStrategyInfo = [\n    async () => instantiateModuleWorker(searchWorkerURLImportMetaResolve()),\n    \"using `import.meta.resolve(\u2026)\",\n    null,\n  ];\n  const esbuildWorkaroundStrategy: FallbackStrategyInfo = [\n    async () =>\n      instantiateModuleWorker(await searchWorkerURLEsbuildWorkaround()),\n    \"using the `esbuild` workaround\",\n    // TODO: we will hopefully discontinue the `esbuild` workaround at some\n    // point, but `esbuild` has been stuck for 3 years on this issue. Because\n    // `esbuild` and Vite (which uses `esbuild`) are now dominating the\n    // ecosystem, this just causes a warning for a lot of devs/users that they\n    // can't do anything about. As frustrating as the situation is, the\n    // workaround is semantically fine (even if it's convoluted) and is\n    // preserved by `esbuild`-based flows in practice. So we suppress the\n    // warning in the medium-term but maintain long-term hope that we can\n    // remove it (and the other fallbacks as well).\n    null,\n  ];\n  const newURLStrategy: FallbackStrategyInfo = [\n    async () => instantiateModuleWorker(searchWorkerURLNewURLImportMetaURL()),\n    \"using `new URL(\u2026, import.meta.url)`\",\n    \"will\",\n  ];\n\n  const fallbackOrder: FallbackStrategyInfo[] =\n    searchOutsideDebugGlobals.prioritizeEsbuildWorkaroundForWorkerInstantiation\n      ? [esbuildWorkaroundStrategy, importMetaResolveStrategy, newURLStrategy]\n      : [importMetaResolveStrategy, esbuildWorkaroundStrategy, newURLStrategy];\n\n  for (const [fn, description, warnOnSuccess] of fallbackOrder) {\n    try {\n      const worker = await fn();\n      if (warnOnSuccess) {\n        if (searchOutsideDebugGlobals.showWorkerInstantiationWarnings) {\n          console.warn(\n            `Module worker instantiation required ${description}. \\`cubing.js\\` ${warnOnSuccess} not support this fallback in the future.`,\n          );\n        }\n      }\n      return worker;\n    } catch {\n      // if (searchOutsideDebugGlobals.showWorkerInstantiationWarnings) {\n      //   console.warn(`${failed(description)}, falling back.`);\n      // }\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 { KPattern } from \"../kpuzzle/KPattern\";\nimport type { PrefetchLevel, WorkerAPI } from \"./inside/api\";\nimport type { TwipsOptions } from \"./inside/solve/twips\";\nimport { allWorkerAPIPromises, instantiateWorkerAPI } from \"./instantiator\";\n\nlet cachedWorkerInstance: Promise<WorkerAPI> | undefined;\nfunction getCachedWorkerInstance(): Promise<WorkerAPI> {\n  return (cachedWorkerInstance ??= instantiateWorkerAPI());\n}\n\nexport async function mapToAllWorkers(\n  f: (worker: WorkerAPI) => void,\n): Promise<void> {\n  await Promise.all(\n    allWorkerAPIPromises.map(async (worker) => {\n      f(await worker);\n    }),\n  );\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 \"333oh\":\n      _preInitializationHintForEvent(\"333\");\n      return;\n  }\n  void (async () => {\n    await (await getCachedWorkerInstance()).initialize(eventID);\n  })();\n}\n\nexport async function randomScrambleForEvent(eventID: string): Promise<Alg> {\n  const worker = searchOutsideDebugGlobals.forceNewWorkerForEveryScramble\n    ? await instantiateWorkerAPI()\n    : await getCachedWorkerInstance();\n  const scrambleString = await worker.randomScrambleStringForEvent(eventID);\n\n  return Alg.fromString(scrambleString);\n}\n\nexport async function deriveScrambleForEvent(\n  derivationSeedHex: string,\n  derivationSaltHierarchy: string[],\n  eventID: string,\n): Promise<Alg> {\n  if (!searchOutsideDebugGlobals.allowDerivedScrambles) {\n    throw new Error(\"Derived scrambles are not allowed.\");\n  }\n  const worker = searchOutsideDebugGlobals.forceNewWorkerForEveryScramble\n    ? await instantiateWorkerAPI()\n    : await getCachedWorkerInstance();\n  const scrambleString = await worker.deriveScrambleStringForEvent(\n    derivationSeedHex,\n    derivationSaltHierarchy,\n    eventID,\n  );\n  return Alg.fromString(scrambleString);\n}\n\nexport async function experimentalSolve3x3x3IgnoringCenters(\n  pattern: KPattern,\n): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.solve333ToString(pattern.patternData));\n}\n\nexport async function experimentalSolve2x2x2(pattern: KPattern): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.solve222ToString(pattern.patternData));\n}\n\nexport async function solveSkewb(pattern: KPattern): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.solveSkewbToString(pattern.patternData));\n}\n\nexport async function solvePyraminx(pattern: KPattern): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.solvePyraminxToString(pattern.patternData));\n}\n\nexport async function solveMegaminx(pattern: KPattern): Promise<Alg> {\n  const cwi = await getCachedWorkerInstance();\n  return Alg.fromString(await cwi.solveMegaminxToString(pattern.patternData));\n}\n\nexport interface SolveTwipsOptions {\n  generatorMoves?: string[];\n  targetPattern?: KPattern;\n  minDepth?: number;\n  maxDepth?: number;\n}\n\nexport async function solveTwips(\n  kpuzzle: KPuzzle,\n  pattern: KPattern,\n  options?: SolveTwipsOptions,\n): Promise<Alg> {\n  const { targetPattern, ...otherOptions } = options ?? {};\n  const apiOptions: TwipsOptions = otherOptions;\n  if (targetPattern) {\n    apiOptions.targetPattern = targetPattern.patternData;\n  }\n  const { ...def } = kpuzzle.definition;\n  delete def.experimentalIsPatternSolved;\n  // delete def.derivedMoves;\n  const dedicatedWorker = await instantiateWorkerAPI();\n  try {\n    return Alg.fromString(\n      // TODO: unnecessary because we terminate the worker?\n      await dedicatedWorker.solveTwipsToString(\n        def,\n        pattern.patternData,\n        apiOptions,\n      ),\n    );\n  } finally {\n    console.log(\"Search ended, terminating dedicated `twips` worker.\");\n    // TODO: support re-using the same worker for multiple searches..\n    // dedicatedWorker.terminate?.(); // TODO\n  }\n}\n\ninterface SearchOutsideDebugGlobals {\n  logPerf: boolean;\n  scramblePrefetchLevel: `${PrefetchLevel}`;\n  forceNewWorkerForEveryScramble: boolean;\n  showWorkerInstantiationWarnings: boolean;\n  // This can prevent a request to `search-worker-entry.js` when it doesn't exist, if the library semantics have been mangled by `esbuild`.\n  prioritizeEsbuildWorkaroundForWorkerInstantiation: boolean;\n  allowDerivedScrambles: boolean;\n}\n\nexport const searchOutsideDebugGlobals: SearchOutsideDebugGlobals = {\n  logPerf: true,\n  scramblePrefetchLevel: \"auto\",\n  forceNewWorkerForEveryScramble: false,\n  showWorkerInstantiationWarnings: true,\n  prioritizeEsbuildWorkaroundForWorkerInstantiation: false,\n  allowDerivedScrambles: false,\n};\n\nexport function setSearchDebug(\n  options: Partial<SearchOutsideDebugGlobals>,\n): void {\n  const { logPerf, scramblePrefetchLevel } = options;\n  if (typeof logPerf !== \"undefined\") {\n    searchOutsideDebugGlobals.logPerf = logPerf;\n    void mapToAllWorkers((worker) => worker.setDebugMeasurePerf(logPerf));\n  }\n  if (typeof scramblePrefetchLevel !== \"undefined\") {\n    searchOutsideDebugGlobals.scramblePrefetchLevel = scramblePrefetchLevel;\n    void mapToAllWorkers((worker) =>\n      worker.setScramblePrefetchLevel(scramblePrefetchLevel as PrefetchLevel),\n    );\n  }\n  for (const booleanField of [\n    \"forceNewWorkerForEveryScramble\",\n    \"showWorkerInstantiationWarnings\",\n    \"prioritizeEsbuildWorkaroundForWorkerInstantiation\",\n    \"allowDerivedScrambles\",\n  ] as const) {\n    if (booleanField in options) {\n      searchOutsideDebugGlobals[booleanField] =\n        options[booleanField] ?? searchOutsideDebugGlobals[booleanField];\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}