cubing 0.65.1 → 0.66.0

package/dist/bin/chunks/{chunk-PDPPBQ4O.js → chunk-VTD7RU7S.js}

@@ -4,10 +4,10 @@
 var packageVersion = (
   // biome-ignore lint/suspicious/noTsIgnore: This comment is still present in the compiled file, where an error is *not* expected.
   /** @ts-ignore Populated by `esbuild` at compile time. */
-  "0.65.1"
+  "0.66.0"
 );
 
 export {
   packageVersion
 };
-//# sourceMappingURL=chunk-PDPPBQ4O.js.map
+//# sourceMappingURL=chunk-VTD7RU7S.js.map

package/dist/bin/order.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S node --
 import {
   packageVersion
-} from "./chunks/chunk-PDPPBQ4O.js";
+} from "./chunks/chunk-VTD7RU7S.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-PDPPBQ4O.js";
+} from "./chunks/chunk-VTD7RU7S.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-PDPPBQ4O.js";
+} from "./chunks/chunk-VTD7RU7S.js";
 
 // src/bin/scramble.ts
 import { basename } from "node:path";

package/dist/bin/svg.js

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

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

@@ -1,2 +1,2 @@
-import { At as Move, Ct as AlgLeaf, Dt as Grouping, Et as LineComment, Ft as ExperimentalNotationType, It as ExperimentalSerializationOptions, Mt as QuantumMove, Nt as Conjugate, Ot as GroupingModifications, Pt as Commutator, St as AlgBranch, Tt as Newline, _t as experimentalAppendMove, a as functionFromTraversal, bt as SimplifyOptions, f as Parsed, ft as experimentalIs, gt as Alg, ht as AlgBuilder, i as TraversalUp, jt as MoveModifications, kt as Pause, mt as setAlgDebug, n as experimentalAlgCubingNetLink, o as keyToMove, pt as Example, r as TraversalDownUp, t as AlgCubingNetOptions, vt as AppendCancelOptions, wt as AlgNode, xt as Unit, yt as PuzzleSpecificSimplifyOptions } from "../index-DVoQwgPC.js";
-export { Alg, AlgBranch, AlgBuilder, AlgCubingNetOptions, AlgLeaf, AlgNode, AppendCancelOptions, Commutator, Conjugate, Example, ExperimentalNotationType, Parsed as ExperimentalParsed, ExperimentalSerializationOptions, Grouping, GroupingModifications, LineComment, Move, MoveModifications, Newline, Pause, PuzzleSpecificSimplifyOptions, QuantumMove, SimplifyOptions, TraversalDownUp, TraversalUp, Unit, experimentalAlgCubingNetLink, experimentalAppendMove, experimentalIs, functionFromTraversal, keyToMove, setAlgDebug };
+import { At as Pause, Ct as AlgNode, Dt as MoveModifications, Et as Move, Ft as ExperimentalNotationType, It as ExperimentalSerializationOptions, Mt as LineComment, Nt as Conjugate, Ot as QuantumMove, Pt as Commutator, St as AlgLeaf, Tt as GroupingModifications, _t as experimentalAppendMove, a as functionFromTraversal, bt as SimplifyOptions, f as Parsed, ft as experimentalIs, gt as Alg, ht as AlgBuilder, i as TraversalUp, jt as Newline, kt as Unit, mt as setAlgDebug, n as experimentalAlgCubingNetLink, o as keyToMove, pt as Example, r as TraversalDownUp, t as AlgCubingNetOptions, vt as AppendCancelOptions, wt as Grouping, xt as AlgBranch, yt as PuzzleSpecificSimplifyOptions } from "../index-B2nOJwLe.js";
+export { Alg, type AlgBranch, AlgBuilder, type AlgCubingNetOptions, type AlgLeaf, type AlgNode, type AppendCancelOptions, Commutator, Conjugate, Example, type ExperimentalNotationType, type Parsed as ExperimentalParsed, type ExperimentalSerializationOptions, Grouping, type GroupingModifications, LineComment, Move, type MoveModifications, Newline, Pause, type PuzzleSpecificSimplifyOptions, QuantumMove, type SimplifyOptions, TraversalDownUp, TraversalUp, Unit, experimentalAlgCubingNetLink, experimentalAppendMove, experimentalIs, functionFromTraversal, keyToMove, setAlgDebug };

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

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

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

@@ -1,10 +1,9 @@
 /// <reference types="web-bluetooth" />
 
-import { At as Move, D as PuzzleID, I as MillisecondTimestamp, R as KPattern, c as PuzzleLoader, gt as Alg, s as KeyMapping } from "../index-DVoQwgPC.js";
-import { a as OrientationEvent, i as AlgLeafEvent } from "../index-DO__MgsX.js";
-
+import { D as PuzzleID, Et as Move, I as MillisecondTimestamp, R as KPattern, c as PuzzleLoader, gt as Alg, s as KeyMapping } from "../index-B2nOJwLe.js";
+import { a as OrientationEvent, i as AlgLeafEvent } from "../index-Bfranlt_.js";
 //#region ../src/cubing/bluetooth/debug.d.ts
-declare function enableDebugLogging(enable: boolean): void;
+export declare function enableDebugLogging(enable: boolean): void;
 //#endregion
 //#region ../src/cubing/bluetooth/transformer.d.ts
 interface StreamTransformer {
@@ -30,7 +29,7 @@ declare abstract class BluetoothPuzzle extends EventTarget {
 //#endregion
 //#region ../src/cubing/bluetooth/keyboard.d.ts
 /** @category Keyboard Puzzles */
-declare class KeyboardPuzzle extends BluetoothPuzzle {
+export declare class KeyboardPuzzle extends BluetoothPuzzle {
   private keyMappingAndPatternPromise;
   listener: EventListener;
   private target;
@@ -42,7 +41,7 @@ declare class KeyboardPuzzle extends BluetoothPuzzle {
   private onKeyDown;
 }
 /** @category Keyboard Puzzles */
-declare function debugKeyboardConnect(target?: any, puzzle?: PuzzleID | PuzzleLoader): Promise<KeyboardPuzzle>;
+export declare function debugKeyboardConnect(target?: any, puzzle?: PuzzleID | PuzzleLoader): Promise<KeyboardPuzzle>;
 //#endregion
 //#region ../src/cubing/bluetooth/connect/index.d.ts
 /******** connect() ********/
@@ -52,11 +51,11 @@ interface BluetoothConnectOptions {
 //#endregion
 //#region ../src/cubing/bluetooth/smart-puzzle/connect.d.ts
 /** @category Smart Puzzles */
-declare function connectSmartPuzzle(options?: BluetoothConnectOptions): Promise<BluetoothPuzzle>;
+export declare function connectSmartPuzzle(options?: BluetoothConnectOptions): Promise<BluetoothPuzzle>;
 //#endregion
 //#region ../src/cubing/bluetooth/smart-puzzle/gan.d.ts
 /** @category Smart Puzzles */
-declare class GanCube extends BluetoothPuzzle {
+export declare class GanCube extends BluetoothPuzzle {
   static connect(server: BluetoothRemoteGATTServer): Promise<GanCube>;
   INTERVAL_MS: number;
   private intervalHandle;
@@ -89,7 +88,7 @@ declare class GanCube extends BluetoothPuzzle {
 //#endregion
 //#region ../src/cubing/bluetooth/smart-puzzle/giiker.d.ts
 /** @category Smart Puzzles */
-declare class GiiKERCube extends BluetoothPuzzle {
+export declare class GiiKERCube extends BluetoothPuzzle {
   static connect(server: BluetoothRemoteGATTServer): Promise<GiiKERCube>;
   private server;
   private cubeCharacteristic;
@@ -106,7 +105,7 @@ declare class GiiKERCube extends BluetoothPuzzle {
 //#endregion
 //#region ../src/cubing/bluetooth/smart-puzzle/gocube.d.ts
 /** @category Smart Puzzles */
-declare class GoCube extends BluetoothPuzzle {
+export declare class GoCube extends BluetoothPuzzle {
   static connect(server: BluetoothRemoteGATTServer): Promise<GoCube>;
   private recorded;
   private homeQuatInverse;
@@ -159,7 +158,7 @@ declare class GanRobot extends EventTarget {
 /** @category Robots */
 type BluetoothRobot = GanRobot;
 /** @category Robots */
-declare function connectSmartRobot(options?: BluetoothConnectOptions): Promise<BluetoothRobot>;
+export declare function connectSmartRobot(options?: BluetoothConnectOptions): Promise<BluetoothRobot>;
 //#endregion
 //#region ../src/cubing/bluetooth/smart-timer/GanTimer.d.ts
 /** @category Timers */
@@ -184,6 +183,6 @@ declare class GanTimer extends EventTarget {
 /** @category Timers */
 type BluetoothTimer = GanTimer;
 /** @category Timers */
-declare function connectSmartTimer(options?: BluetoothConnectOptions): Promise<BluetoothTimer>;
+export declare function connectSmartTimer(options?: BluetoothConnectOptions): Promise<BluetoothTimer>;
 //#endregion
-export { type BluetoothPuzzle, type BluetoothRobot, type BluetoothTimer, GanCube, GiiKERCube, GoCube, KeyboardPuzzle, type AlgLeafEvent as MoveEvent, type OrientationEvent, connectSmartPuzzle, connectSmartRobot, connectSmartTimer, debugKeyboardConnect, enableDebugLogging };
+export type { BluetoothPuzzle, BluetoothRobot, BluetoothTimer, AlgLeafEvent as MoveEvent, OrientationEvent };

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

@@ -1,23 +1,23 @@
 import {
   binaryComponentsToReid3x3x3,
   twizzleBinaryToBinaryComponents
-} from "../chunks/chunk-O2QJENHE.js";
+} from "../chunks/chunk-6RZGNWLS.js";
 import {
   puzzles
-} from "../chunks/chunk-KHUP3BPA.js";
+} from "../chunks/chunk-XAOXLHYH.js";
 import {
   cube3x3x3,
   experimental3x3x3KPuzzle
-} from "../chunks/chunk-5LBACZOM.js";
+} from "../chunks/chunk-JL5REGXZ.js";
 import {
   KPattern
-} from "../chunks/chunk-THRYJMRP.js";
+} from "../chunks/chunk-L6OQRJJX.js";
 import {
   Alg,
   Move,
   experimentalAppendMove,
   keyToMove
-} from "../chunks/chunk-YFNXHRNE.js";
+} from "../chunks/chunk-CFZLXDM6.js";
 
 // src/cubing/bluetooth/debug.ts
 var DEBUG_LOGGING_ENABLED = false;

package/dist/lib/cubing/chunks/{big-puzzle-orientation-G75BXW2W.js → big-puzzle-orientation-KCHMEEM7.js}

@@ -1,7 +1,7 @@
 import {
   Alg,
   Grouping
-} from "./chunk-YFNXHRNE.js";
+} from "./chunk-CFZLXDM6.js";
 
 // src/cubing/puzzles/implementations/dynamic/big-cubes/big-puzzle-orientation.ts
 function puzzleOrientationBigCubeIdx(pattern) {
@@ -65,4 +65,4 @@ export {
   puzzleOrientationBigCubeCache,
   puzzleOrientationBigCubeIdx
 };
-//# sourceMappingURL=big-puzzle-orientation-G75BXW2W.js.map
+//# sourceMappingURL=big-puzzle-orientation-KCHMEEM7.js.map

package/dist/lib/cubing/chunks/{chunk-GO2SL6SC.js → chunk-4KLW7Y6J.js}

@@ -1,6 +1,6 @@
 import {
   LazyPromise
-} from "./chunk-5LBACZOM.js";
+} from "./chunk-JL5REGXZ.js";
 
 // src/cubing/twisty/debug.ts
 var twistyDebugGlobals = {
@@ -531,7 +531,7 @@ var StatsPanel = class {
 
 // src/cubing/twisty/heavy-code-imports/3d.ts
 var bulk3DCode = new LazyPromise(
-  () => import("./twisty-dynamic-3d-A2G22YLA.js")
+  () => import("./twisty-dynamic-3d-SFR3X64P.js")
 );
 
 // src/cubing/twisty/views/canvas.ts
@@ -1192,4 +1192,4 @@ export {
   Twisty3DVantage,
   bulk3DCode
 };
-//# sourceMappingURL=chunk-GO2SL6SC.js.map
+//# sourceMappingURL=chunk-4KLW7Y6J.js.map

package/dist/lib/cubing/chunks/{chunk-O2QJENHE.js → chunk-6RZGNWLS.js}

@@ -3,10 +3,10 @@ import {
   normalize3x3x3Orientation,
   puzzleOrientation3x3x3Cache,
   puzzleOrientation3x3x3Idx
-} from "./chunk-5LBACZOM.js";
+} from "./chunk-JL5REGXZ.js";
 import {
   KPattern
-} from "./chunk-THRYJMRP.js";
+} from "./chunk-L6OQRJJX.js";
 
 // src/cubing/protocol/binary/orbit-indexing.ts
 function identityPermutation(numElems) {
@@ -262,4 +262,4 @@ export {
   bufferToSpacedHex,
   spacedHexToBuffer
 };
-//# sourceMappingURL=chunk-O2QJENHE.js.map
+//# sourceMappingURL=chunk-6RZGNWLS.js.map

package/dist/lib/cubing/chunks/{chunk-4ADGSRLK.js → chunk-CAQY24I5.js}

@@ -1,17 +1,17 @@
 import {
   puzzles
-} from "./chunk-KHUP3BPA.js";
+} from "./chunk-XAOXLHYH.js";
 import {
   LazyPromise
-} from "./chunk-5LBACZOM.js";
+} from "./chunk-JL5REGXZ.js";
 import {
   KPattern
-} from "./chunk-THRYJMRP.js";
+} from "./chunk-L6OQRJJX.js";
 import {
   Alg,
   AlgBuilder,
   Move
-} from "./chunk-YFNXHRNE.js";
+} from "./chunk-CFZLXDM6.js";
 
 // src/cubing/search/inside/solve/puzzles/3x3x3/index.ts
 import { randomChoice as randomChoice2 } from "random-uint-below";
@@ -1068,4 +1068,4 @@ export {
    * SPDX-License-Identifier: Apache-2.0
    *)
 */
-//# sourceMappingURL=chunk-4ADGSRLK.js.map
+//# sourceMappingURL=chunk-CAQY24I5.js.map

package/dist/lib/cubing/chunks/{chunk-YFNXHRNE.js → chunk-CFZLXDM6.js}

@@ -20,7 +20,7 @@ var AlgCommon = class extends Comparable {
     }
   }
   get log() {
-    return console.log.bind(console, this, this.toString());
+    return console.log.bind(console, this);
   }
 };
 
@@ -162,11 +162,6 @@ var Conjugate = class _Conjugate extends AlgCommon {
   }
 };
 
-// src/cubing/alg/limits.ts
-var MAX_INT = 2147483647;
-var MAX_INT_DESCRIPTION = "2^31 - 1";
-var MIN_INT = -2147483648;
-
 // src/cubing/alg/AlgBuilder.ts
 var AlgBuilder = class {
   #algNodes = [];
@@ -662,15 +657,46 @@ var AlgParser = class {
   }
 };
 
-// src/cubing/alg/warnOnce.ts
-var warned = /* @__PURE__ */ new Set();
-function warnOnce(s) {
-  if (!warned.has(s)) {
-    console.warn(s);
-    warned.add(s);
-  }
+// src/cubing/alg/inspect.ts
+var NODEJS_UTIL_INSPECT_CUSTOM = /* @__PURE__ */ Symbol.for(
+  "nodejs.util.inspect.custom"
+);
+var NODE_DEFAULT_STRING_COLOR = "green";
+var DE_EMPHASIZED = "gray";
+function formatForCustomInspect(className, soleParameterQuotedString, annotation) {
+  const { styleText } = globalThis.process.getBuiltinModule("node:util");
+  const annotationPart = (() => {
+    if (annotation) {
+      return ` ${styleText(DE_EMPHASIZED, "/* with parse data */")}`;
+    }
+    return "";
+  })();
+  return `${className}(${styleText(NODE_DEFAULT_STRING_COLOR, soleParameterQuotedString)}${annotationPart})`;
+}
+function formatForCustomInspectWithParseDataAnnotation(className, soleParameterQuotedString, value) {
+  const annotation = (() => {
+    if (startCharIndexKey in value || endCharIndexKey in value) {
+      if (startCharIndexKey in value !== endCharIndexKey in value) {
+        console.warn(
+          "Encountered an alg with start char info but no end char info. `cubing.js` should never produce this by itself."
+        );
+      }
+      return "with parse data";
+    }
+    return "";
+  })();
+  return formatForCustomInspect(
+    className,
+    soleParameterQuotedString,
+    annotation
+  );
 }
 
+// src/cubing/alg/limits.ts
+var MAX_INT = 2147483647;
+var MAX_INT_DESCRIPTION = "2^31 - 1";
+var MIN_INT = -2147483648;
+
 // src/cubing/alg/alg-nodes/QuantumWithAmount.ts
 var QuantumWithAmount = class {
   quantum;
@@ -846,11 +872,6 @@ var Move = class _Move extends AlgCommon {
     return this.#quantumWithAmount.amount;
   }
   /** @deprecated */
-  get type() {
-    warnOnce("deprecated: type");
-    return "blockMove";
-  }
-  /** @deprecated */
   get family() {
     return this.#quantumWithAmount.quantum.family ?? void 0;
   }
@@ -892,6 +913,13 @@ var Move = class _Move extends AlgCommon {
   //     outerLayer: this.outerLayer,
   //   };
   // }
+  [NODEJS_UTIL_INSPECT_CUSTOM]() {
+    return formatForCustomInspectWithParseDataAnnotation(
+      "Move",
+      JSON.stringify(this.toString()),
+      this
+    );
+  }
 };
 
 // src/cubing/alg/alg-nodes/containers/Grouping.ts
@@ -1523,11 +1551,6 @@ var Alg = class _Alg extends AlgCommon {
   experimentalNumChildAlgNodes() {
     return Array.from(this.#algNodes).length;
   }
-  /** @deprecated */
-  get type() {
-    warnOnce("deprecated: type");
-    return "sequence";
-  }
   /**
    * Converts the Alg to a string:
    *
@@ -1613,6 +1636,17 @@ var Alg = class _Alg extends AlgCommon {
   simplify(options) {
     return this.experimentalSimplify(options);
   }
+  [NODEJS_UTIL_INSPECT_CUSTOM]() {
+    const string = (() => {
+      const asString = this.toString();
+      if (asString.includes("\n")) {
+        return `\`${asString.replaceAll(/(`\$)/g, "\\$1")}\``;
+      } else {
+        return JSON.stringify(asString);
+      }
+    })();
+    return formatForCustomInspectWithParseDataAnnotation("Alg", string, this);
+  }
 };
 function spaceBetween(u1, u2) {
   if (u1.is(Newline) || u2.is(Newline)) {
@@ -1879,4 +1913,4 @@ export {
   keyToMove,
   experimentalAlgCubingNetLink
 };
-//# sourceMappingURL=chunk-YFNXHRNE.js.map
+//# sourceMappingURL=chunk-CFZLXDM6.js.map