cubing 0.59.2 → 0.60.0

package/dist/lib/cubing/{KPattern-DEaZMwD9.d.ts → PuzzleLoader-ApHCdGgn.d.ts}

@@ -1,3 +1,4 @@
+import { Tagged } from 'type-fest';
 import { Texture, Object3D, Raycaster, PerspectiveCamera, Scene, WebGLRenderer } from 'three/src/Three.js';
 
 type ExperimentalNotationType = "auto" | "LGN";
@@ -878,9 +879,28 @@ declare class KPuzzle {
     canConvertDefaultPatternToUniqueTransformation(): boolean;
 }
 
-type MillisecondTimestamp = number;
-type Duration = MillisecondTimestamp;
-type Timestamp = MillisecondTimestamp;
+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;
+}
+
+type MillisecondTimestamp = Tagged<DOMHighResTimeStamp, "MillisecondTimestamp">;
+type MillisecondDuration = Tagged<number, "MillisecondDuration">;
 declare enum Direction {
     Forwards = 1,
     Paused = 0,
@@ -904,58 +924,6 @@ interface TimeRange {
     end: MillisecondTimestamp;
 }
 
-type AnimatedLeafAlgNode = Move | Pause;
-
-interface CurrentMove {
-    move: Move;
-    direction: Direction;
-    fraction: number;
-    startTimestamp: MillisecondTimestamp;
-    endTimestamp: MillisecondTimestamp;
-}
-interface CurrentMoveInfo {
-    patternIndex: number;
-    currentMoves: CurrentMove[];
-    movesFinishing: CurrentMove[];
-    movesFinished: CurrentMove[];
-    movesStarting: CurrentMove[];
-    latestStart: number;
-    earliestEnd: number;
-}
-interface AlgIndexer {
-    getAnimLeaf(index: number): AnimatedLeafAlgNode | null;
-    indexToMoveStartTimestamp(index: number): Timestamp;
-    patternAtIndex(index: number, startPattern?: KPattern): KPattern;
-    transformationAtIndex(index: number): KTransformation;
-    numAnimatedLeaves(): number;
-    timestampToIndex(timestamp: Timestamp): number;
-    algDuration(): Duration;
-    moveDuration(index: number): number;
-    timestampToPosition?: (timestamp: Timestamp, startPattern?: KPattern) => PuzzlePosition;
-    currentMoveInfo?: (timestamp: Timestamp) => CurrentMoveInfo;
-}
-
-type FaceletMeshStickeringMask = "regular" | "dim" | "oriented" | "experimentalOriented2" | "ignored" | "invisible" | "mystery";
-type FaceletStickeringMask = {
-    mask: FaceletMeshStickeringMask;
-    hintMask?: FaceletMeshStickeringMask;
-};
-type PieceStickeringMask = {
-    facelets: (FaceletMeshStickeringMask | FaceletStickeringMask | null)[];
-};
-type OrbitStickeringMask = {
-    pieces: (PieceStickeringMask | null)[];
-};
-type StickeringMask = {
-    specialBehaviour?: "picture";
-    name?: string;
-    orbits: Record<string, OrbitStickeringMask>;
-};
-
-declare const experimentalStickerings: Record<string, {
-    groups?: Partial<Record<PuzzleID, string>>;
-}>;
-
 interface UserVisibleError {
     errors: string[];
 }
@@ -969,10 +937,11 @@ type InputRecord = Record<string, any>;
 type InputProps<T extends InputRecord> = {
     [s in keyof T]: TwistyPropParent<T[s]>;
 };
+type Generation = Tagged<number, "Generation">;
 interface SourceEventDetail<OutputType> {
     sourceProp: TwistyPropSource<OutputType, any>;
     value: Promise<OutputType>;
-    generation: number;
+    generation: Generation;
 }
 type SourceEvent<T> = CustomEvent<SourceEventDetail<T>>;
 type PromiseOrValue<T> = T | Promise<T>;
@@ -1017,6 +986,70 @@ declare abstract class TwistyPropDerived<InputTypes extends InputRecord, OutputT
     protected abstract derive(input: InputTypes): PromiseOrValue<OutputType>;
 }
 
+interface AnimationTimelineLeaf {
+    animLeaf: AlgLeaf;
+    start: MillisecondTimestamp;
+    end: MillisecondTimestamp;
+}
+type AnimationTimelineLeaves = AnimationTimelineLeaf[];
+declare class AnimationTimelineLeavesRequestProp extends SimpleTwistyPropSource<AnimationTimelineLeaf[] | null> {
+    getDefaultValue(): AnimationTimelineLeaf[] | null;
+}
+
+type AnimatedLeafAlgNode = Move | Pause;
+
+interface CurrentMove {
+    move: Move;
+    direction: Direction;
+    fraction: number;
+    startTimestamp: MillisecondTimestamp;
+    endTimestamp: MillisecondTimestamp;
+}
+interface CurrentMoveInfo {
+    patternIndex: number;
+    currentMoves: CurrentMove[];
+    movesFinishing: CurrentMove[];
+    movesFinished: CurrentMove[];
+    movesStarting: CurrentMove[];
+    latestStart: number;
+    earliestEnd: number;
+}
+type LeafIndex = Tagged<number, "LeafIndex">;
+type LeafCount = Tagged<number, "LeafCount">;
+interface AlgIndexer {
+    getAnimLeaf(index: LeafIndex): AnimatedLeafAlgNode | null;
+    indexToMoveStartTimestamp(index: LeafIndex): MillisecondTimestamp;
+    patternAtIndex(index: LeafIndex, startPattern?: KPattern): KPattern;
+    transformationAtIndex(index: LeafIndex): KTransformation;
+    numAnimatedLeaves(): LeafCount;
+    timestampToIndex(timestamp: MillisecondTimestamp): LeafIndex;
+    algDuration(): MillisecondDuration;
+    moveDuration(index: LeafIndex): MillisecondDuration;
+    timestampToPosition?: (timestamp: MillisecondTimestamp, startPattern?: KPattern) => PuzzlePosition;
+    currentMoveInfo?: (timestamp: MillisecondTimestamp) => CurrentMoveInfo;
+}
+
+type FaceletMeshStickeringMask = "regular" | "dim" | "oriented" | "experimentalOriented2" | "ignored" | "invisible" | "mystery";
+type FaceletStickeringMask = {
+    mask: FaceletMeshStickeringMask;
+    hintMask?: FaceletMeshStickeringMask;
+};
+type PieceStickeringMask = {
+    facelets: (FaceletMeshStickeringMask | FaceletStickeringMask | null)[];
+};
+type OrbitStickeringMask = {
+    pieces: (PieceStickeringMask | null)[];
+};
+type StickeringMask = {
+    specialBehaviour?: "picture";
+    name?: string;
+    orbits: Record<string, OrbitStickeringMask>;
+};
+
+declare const experimentalStickerings: Record<string, {
+    groups?: Partial<Record<PuzzleID, string>>;
+}>;
+
 declare const puzzleIDs: {
     "3x3x3": boolean;
     custom: boolean;
@@ -1172,21 +1205,11 @@ declare class AnchorTransformationProp extends TwistyPropDerived<AnchorTransform
     derive(inputs: AnchorTransformationPropInputs): KTransformation;
 }
 
-interface AnimationTimelineLeaf {
-    animLeaf: AlgLeaf;
-    start: number;
-    end: number;
-}
-type AnimationTimelineLeaves = AnimationTimelineLeaf[];
-declare class AnimationTimelineLeavesRequestProp extends SimpleTwistyPropSource<AnimationTimelineLeaf[] | null> {
-    getDefaultValue(): AnimationTimelineLeaf[] | null;
-}
-
 interface CurrentLeavesSimplifiedPropInputs {
     currentMoveInfo: CurrentMoveInfo;
 }
 interface CurrentLeavesSimplified {
-    patternIndex: number;
+    patternIndex: LeafIndex;
     movesFinishing: Move[];
     movesFinished: Move[];
 }
@@ -2118,7 +2141,7 @@ type Parsed<T extends Alg | AlgNode> = T & ParserIndexed;
 
 type AnimatedLeafAlgNodeInfo = {
     leaf: Parsed<AnimatedLeafAlgNode>;
-    idx: number;
+    idx: LeafIndex;
 };
 type OrderedLeafTokens = AnimatedLeafAlgNodeInfo[];
 
@@ -2223,7 +2246,7 @@ declare global {
 }
 
 interface DataDown {
-    earliestMoveIndex: number;
+    earliestMoveIndex: LeafIndex;
     twistyAlgViewer: TwistyAlgViewer;
     direction: IterationDirection;
 }
@@ -2264,7 +2287,7 @@ declare class TwistyAlgViewer extends HTMLElementShim {
     private setAlg;
     get twistyPlayer(): TwistyPlayer | null;
     set twistyPlayer(twistyPlayer: TwistyPlayer | null);
-    jumpToIndex(index: number, offsetIntoMove: boolean): Promise<void>;
+    jumpToIndex(index: LeafIndex, offsetIntoMove: boolean): Promise<void>;
     protected attributeChangedCallback(attributeName: string, _oldValue: string, newValue: string): Promise<void>;
     static get observedAttributes(): string[];
 }
@@ -2319,24 +2342,4 @@ interface PuzzleLoader {
     algTransformData?: AlgTransformData;
 }
 
-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 { Pause as $, type AlgLeaf as A, KTransformation as B, type MillisecondTimestamp as C, type Duration as D, type ExperimentalStickering as E, type BackViewLayout as F, backViewLayouts as G, TwistyAlgEditor as H, TwistyAlgViewer as I, type TwistyPlayerConfig as J, KPattern as K, TwistyPlayer as L, Move as M, NO_VALUE as N, TwizzleLink as O, Perm as P, Quat as Q, type AlgNode as R, type StickerDat as S, type Timestamp as T, type AppendOptions as U, type VisualizationFormat as V, Grouping as W, LineComment as X, Commutator as Y, Conjugate as Z, Newline as _, type PuzzleGeometryOptions as a, type KeyMapping as a0, type AlgBranch as a1, type GroupingModifications as a2, type MoveModifications as a3, type Parsed as a4, type ExperimentalNotationType as a5, type ExperimentalSerializationOptions as a6, type AppendCancelOptions as a7, type SimplifyOptions as a8, QuantumMove as a9, type KPatternData as aa, type KPatternOrbitData as ab, type KPuzzleDefinition as ac, type KTransformationData as ad, type KTransformationOrbitData as ae, type StickerDatAxis as b, type StickerDatFace as c, type StickerDatSticker as d, getPuzzleDescriptionString as e, getPuzzleGeometryByDesc as f, getPG3DNamedPuzzles as g, getPuzzleGeometryByName as h, PGNotation as i, PUZZLE_BASE_SHAPES as j, PUZZLE_CUT_TYPES as k, type PuzzleBaseShape as l, type PuzzleCutDescription as m, type PuzzleCutType as n, type PuzzleDescription as o, parseOptions as p, PuzzleGeometry as q, parsePuzzleDescription as r, Alg as s, type PuzzleLoader as t, type PuzzleID as u, KPuzzle as v, type StickeringMask as w, type PuzzleSpecificSimplifyOptions as x, type AlgTransformData as y, type AlgIndexer as z };
+export { Newline as $, type AlgLeaf as A, type MillisecondTimestamp as B, type LeafIndex as C, KTransformation as D, type ExperimentalStickering as E, type MillisecondDuration as F, type BackViewLayout as G, backViewLayouts as H, TwistyAlgViewer as I, type TwistyPlayerConfig as J, KPattern as K, type LeafCount as L, Move as M, NO_VALUE as N, TwistyPlayer as O, Perm as P, Quat as Q, TwizzleLink as R, type StickerDat as S, TwistyAlgEditor as T, type AlgNode as U, type VisualizationFormat as V, type AppendOptions as W, Grouping as X, LineComment as Y, Commutator as Z, Conjugate as _, type PuzzleGeometryOptions as a, Pause as a0, type KeyMapping as a1, type AlgBranch as a2, type GroupingModifications as a3, type MoveModifications as a4, type Parsed as a5, type ExperimentalNotationType as a6, type ExperimentalSerializationOptions as a7, type AppendCancelOptions as a8, type SimplifyOptions as a9, QuantumMove as aa, type KPatternData as ab, type KPatternOrbitData as ac, type KPuzzleDefinition as ad, type KTransformationData as ae, type KTransformationOrbitData as af, type StickerDatAxis as b, type StickerDatFace as c, type StickerDatSticker as d, getPuzzleDescriptionString as e, getPuzzleGeometryByDesc as f, getPG3DNamedPuzzles as g, getPuzzleGeometryByName as h, PGNotation as i, PUZZLE_BASE_SHAPES as j, PUZZLE_CUT_TYPES as k, type PuzzleBaseShape as l, type PuzzleCutDescription as m, type PuzzleCutType as n, type PuzzleDescription as o, parseOptions as p, PuzzleGeometry as q, parsePuzzleDescription as r, Alg as s, type PuzzleLoader as t, type PuzzleID as u, KPuzzle as v, type StickeringMask as w, type PuzzleSpecificSimplifyOptions as x, type AlgTransformData as y, type AlgIndexer as z };

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

@@ -1,5 +1,6 @@
-import { R as AlgNode, s 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 '../KPattern-DEaZMwD9.js';
-export { a1 as AlgBranch, a7 as AppendCancelOptions, a5 as ExperimentalNotationType, a4 as ExperimentalParsed, a6 as ExperimentalSerializationOptions, a2 as GroupingModifications, a3 as MoveModifications, x as PuzzleSpecificSimplifyOptions, a9 as QuantumMove, a8 as SimplifyOptions } from '../KPattern-DEaZMwD9.js';
+import { U as AlgNode, s as Alg, M as Move, W as AppendOptions, X as Grouping, Y as LineComment, Z as Commutator, _ as Conjugate, $ as Newline, a0 as Pause, a1 as KeyMapping, A as AlgLeaf } from '../PuzzleLoader-ApHCdGgn.js';
+export { a2 as AlgBranch, a8 as AppendCancelOptions, a6 as ExperimentalNotationType, a5 as ExperimentalParsed, a7 as ExperimentalSerializationOptions, a3 as GroupingModifications, a4 as MoveModifications, x as PuzzleSpecificSimplifyOptions, aa as QuantumMove, a9 as SimplifyOptions } from '../PuzzleLoader-ApHCdGgn.js';
+import 'type-fest';
 import 'three/src/Three.js';
 
 /** @deprecated */

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

@@ -1,6 +1,7 @@
-import { u as PuzzleID, t as PuzzleLoader, a0 as KeyMapping, K as KPattern, s as Alg, M as Move } from '../KPattern-DEaZMwD9.js';
-import { B as BluetoothPuzzle } from '../bluetooth-puzzle-CweI5h6j.js';
-export { A as MoveEvent, O as OrientationEvent } from '../bluetooth-puzzle-CweI5h6j.js';
+import { u as PuzzleID, t as PuzzleLoader, a1 as KeyMapping, K as KPattern, s as Alg, M as Move, B as MillisecondTimestamp } from '../PuzzleLoader-ApHCdGgn.js';
+import { B as BluetoothPuzzle } from '../bluetooth-puzzle-CN0X1-Rm.js';
+export { A as MoveEvent, O as OrientationEvent } from '../bluetooth-puzzle-CN0X1-Rm.js';
+import 'type-fest';
 import 'three/src/Three.js';
 
 declare function enableDebugLogging(enable: boolean): void;
@@ -142,8 +143,8 @@ declare class GanTimer extends EventTarget {
     poll(): Promise<void>;
     onDisconnect(): void;
     getTimeCharacteristic(): Promise<Uint8Array<ArrayBufferLike>>;
-    getTime(): Promise<number>;
-    decodeTimeMs(bytes: Uint8Array): number;
+    getTime(): Promise<MillisecondTimestamp>;
+    decodeTimeMs(bytes: Uint8Array): MillisecondTimestamp;
     startPolling(): void;
     stopPolling(): void;
 }