cubing 0.21.0-pre8 → 0.21.2

package/src/cubing/twisty/model/{depth-3 → props/puzzle/state}/PuzzleAlgProp.ts

@@ -1,7 +1,7 @@
-import { Alg } from "../../../alg";
-import { KPuzzle, KPuzzleDefinition } from "../../../kpuzzle";
-import { AlgIssues, AlgWithIssues } from "../depth-0/AlgProp";
-import { TwistyPropDerived } from "../TwistyProp";
+import { Alg } from "../../../../../alg";
+import { KPuzzle, KPuzzleDefinition } from "../../../../../kpuzzle";
+import { AlgIssues, AlgWithIssues } from "./AlgProp";
+import { TwistyPropDerived } from "../../TwistyProp";
 
 export class PuzzleAlgProp extends TwistyPropDerived<
   { algWithIssues: AlgWithIssues; puzzleDef: KPuzzleDefinition },

package/src/cubing/twisty/model/{depth-0 → props/puzzle/state}/SetupAnchorProp.ts

@@ -1,5 +1,5 @@
-import type { SetupToLocation } from "../../old/dom/TwistyPlayerConfig";
-import { SimpleTwistyPropSource } from "../TwistyProp";
+import type { SetupToLocation } from "../../../../old/dom/TwistyPlayerConfig";
+import { SimpleTwistyPropSource } from "../../TwistyProp";
 
 export class SetupAnchorProp extends SimpleTwistyPropSource<SetupToLocation> {
   getDefaultValue(): SetupToLocation {

package/src/cubing/twisty/model/{depth-2 → props/puzzle/structure}/PuzzleDefProp.ts

@@ -1,6 +1,6 @@
-import type { KPuzzleDefinition } from "../../../kpuzzle";
-import type { PuzzleLoader } from "../../../puzzles";
-import { TwistyPropDerived } from "../TwistyProp";
+import type { KPuzzleDefinition } from "../../../../../kpuzzle";
+import type { PuzzleLoader } from "../../../../../puzzles";
+import { TwistyPropDerived } from "../../TwistyProp";
 
 export class PuzzleDefProp extends TwistyPropDerived<
   { puzzleLoader: PuzzleLoader },

package/src/cubing/twisty/model/{depth-0 → props/puzzle/structure}/PuzzleDescriptionProp.ts

@@ -1,5 +1,9 @@
-import type { PuzzleDescriptionString } from "../../../puzzle-geometry/PGPuzzles";
-import { NoValueType, NO_VALUE, SimpleTwistyPropSource } from "../TwistyProp";
+import type { PuzzleDescriptionString } from "../../../../../puzzle-geometry/PGPuzzles";
+import {
+  NoValueType,
+  NO_VALUE,
+  SimpleTwistyPropSource,
+} from "../../TwistyProp";
 
 export class PGPuzzleDescriptionStringProp extends SimpleTwistyPropSource<
   PuzzleDescriptionString | NoValueType

package/src/cubing/twisty/model/{depth-2 → props/puzzle/structure}/PuzzleIDProp.ts

@@ -1,6 +1,6 @@
-import type { PuzzleLoader } from "../../../puzzles";
-import type { PuzzleID } from "../../old/dom/TwistyPlayerConfig";
-import { TwistyPropDerived } from "../TwistyProp";
+import type { PuzzleLoader } from "../../../../../puzzles";
+import type { PuzzleID } from "../../../../old/dom/TwistyPlayerConfig";
+import { TwistyPropDerived } from "../../TwistyProp";
 
 export class PuzzleIDProp extends TwistyPropDerived<
   { puzzleLoader: PuzzleLoader },

package/src/cubing/twisty/model/{depth-0 → props/puzzle/structure}/PuzzleIDRequestProp.ts

@@ -1,5 +1,9 @@
-import type { PuzzleID } from "../../old/dom/TwistyPlayerConfig";
-import { NoValueType, NO_VALUE, SimpleTwistyPropSource } from "../TwistyProp";
+import type { PuzzleID } from "../../../../old/dom/TwistyPlayerConfig";
+import {
+  NoValueType,
+  NO_VALUE,
+  SimpleTwistyPropSource,
+} from "../../TwistyProp";
 
 // TODO: Ideally we'd use `null` to mean "no value", but `null` has a special meaning
 // for `TwistyProp` and might mess with caching.

package/src/cubing/twisty/model/{depth-1 → props/puzzle/structure}/PuzzleLoaderProp.ts

@@ -1,12 +1,12 @@
-import type { PuzzleDescriptionString } from "../../../puzzle-geometry/PGPuzzles";
+import type { PuzzleDescriptionString } from "../../../../../puzzle-geometry/PGPuzzles";
 import {
   cube3x3x3,
   experimentalCustomPGPuzzleLoader,
   PuzzleLoader,
   puzzles,
-} from "../../../puzzles";
-import type { PuzzleID } from "../../old/dom/TwistyPlayerConfig";
-import { NoValueType, NO_VALUE, TwistyPropDerived } from "../TwistyProp";
+} from "../../../../../puzzles";
+import type { PuzzleID } from "../../../../old/dom/TwistyPlayerConfig";
+import { NoValueType, NO_VALUE, TwistyPropDerived } from "../../TwistyProp";
 8;
 interface PuzzleLoaderPropInputs {
   puzzleIDRequest: PuzzleID | NoValueType;
@@ -19,7 +19,13 @@ export class PuzzleLoaderProp extends TwistyPropDerived<
 > {
   derive(inputs: PuzzleLoaderPropInputs): PuzzleLoader {
     if (inputs.puzzleIDRequest && inputs.puzzleIDRequest !== NO_VALUE) {
-      return puzzles[inputs.puzzleIDRequest];
+      const puzzleLoader = puzzles[inputs.puzzleIDRequest];
+      if (!puzzleLoader) {
+        this.userVisibleErrorTracker!.set({
+          errors: [`Invalid puzzle ID: ${inputs.puzzleIDRequest}`],
+        });
+      }
+      return puzzleLoader;
     }
     if (
       inputs.puzzleDescriptionRequest &&

package/src/cubing/twisty/model/{depth-8 → props/timeline}/CoarseTimelineInfoProp.ts

@@ -1,6 +1,6 @@
-import type { ButtonCommand } from "../../views/control-panel/TwistyButtonsV2";
-import type { PlayingInfo } from "../depth-0/PlayingInfoProp";
-import type { DetailedTimelineInfo } from "../depth-7/DetailedTimelineInfoProp";
+import type { ButtonCommand } from "../../../views/control-panel/TwistyButtonsV2";
+import type { PlayingInfo } from "./PlayingInfoProp";
+import type { DetailedTimelineInfo } from "./DetailedTimelineInfoProp";
 import { TwistyPropDerived } from "../TwistyProp";
 
 interface ButtonAppearance {

package/src/cubing/twisty/model/{depth-7 → props/timeline}/DetailedTimelineInfoProp.ts

@@ -1,7 +1,7 @@
-import type { TimeRange } from "../../old/animation/cursor/AlgCursor";
-import type { MillisecondTimestamp } from "../../old/animation/cursor/CursorTypes";
-import type { SetupToLocation } from "../../old/dom/TwistyPlayerConfig";
-import type { TimestampRequest } from "../depth-0/TimestampRequestProp";
+import type { TimeRange } from "../../../old/animation/cursor/AlgCursor";
+import type { MillisecondTimestamp } from "../../../old/animation/cursor/CursorTypes";
+import type { SetupToLocation } from "../../../old/dom/TwistyPlayerConfig";
+import type { TimestampRequest } from "./TimestampRequestProp";
 import { TwistyPropDerived } from "../TwistyProp";
 
 interface DetailedTimelineInfoInputs {

package/src/cubing/twisty/model/{depth-0 → props/timeline}/PlayingInfoProp.ts

@@ -1,7 +1,7 @@
 import {
   BoundaryType,
   Direction,
-} from "../../old/animation/cursor/CursorTypes";
+} from "../../../old/animation/cursor/CursorTypes";
 import { TwistyPropSource } from "../TwistyProp";
 
 export type SimpleDirection = Direction.Forwards | Direction.Backwards;

package/src/cubing/twisty/model/{depth-0 → props/timeline}/TimestampRequestProp.ts

@@ -1,4 +1,4 @@
-import type { MillisecondTimestamp } from "../../old/animation/cursor/CursorTypes";
+import type { MillisecondTimestamp } from "../../../old/animation/cursor/CursorTypes";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 const smartTimestamps = {

package/src/cubing/twisty/model/{depth-0 → props/viewer}/BackViewProp.ts

@@ -1,4 +1,4 @@
-import type { BackViewLayout } from "../../old/dom/viewers/TwistyViewerWrapper";
+import type { BackViewLayout } from "../../../old/dom/viewers/TwistyViewerWrapper";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 export type BackViewLayoutWithAuto = BackViewLayout | "auto";

package/src/cubing/twisty/model/{depth-0 → props/viewer}/BackgroundProp.ts

@@ -1,4 +1,4 @@
-import type { BackgroundTheme } from "../../old/dom/TwistyPlayerConfig";
+import type { BackgroundTheme } from "../../../old/dom/TwistyPlayerConfig";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 export type BackgroundThemeWithAuto = BackgroundTheme | "auto";

package/src/cubing/twisty/model/{depth-9 → props/viewer}/ButtonAppearanceProp.ts

@@ -1,7 +1,7 @@
-import type { ButtonCommand } from "../../views/control-panel/TwistyButtonsV2";
-import { fullscreenEnabled } from "../../views/control-panel/webkit-fullscreen";
-import type { ViewerLinkPageWithAuto } from "../depth-0/ViewerLinkProp";
-import type { CoarseTimelineInfo as CoarseTimelineInfo } from "../depth-8/CoarseTimelineInfoProp";
+import type { ButtonCommand } from "../../../views/control-panel/TwistyButtonsV2";
+import { fullscreenEnabled } from "../../../views/control-panel/webkit-fullscreen";
+import type { ViewerLinkPageWithAuto } from "./ViewerLinkProp";
+import type { CoarseTimelineInfo as CoarseTimelineInfo } from "../timeline/CoarseTimelineInfoProp";
 import { TwistyPropDerived } from "../TwistyProp";
 
 export const buttonIcons = [

package/src/cubing/twisty/model/{depth-0 → props/viewer}/ControlPanelProp.ts

@@ -1,4 +1,4 @@
-import type { ControlsLocation } from "../../old/dom/TwistyPlayerConfig";
+import type { ControlsLocation } from "../../../old/dom/TwistyPlayerConfig";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 export type ControlPanelThemeWithAuto = ControlsLocation | "auto";

package/src/cubing/twisty/model/{depth-4 → props/viewer}/OrbitCoordinatesProp.ts

@@ -1,15 +1,15 @@
 import {
   defaultCameraOrbitCoordinates,
   PuzzleID,
-} from "../../old/dom/TwistyPlayerConfig";
+} from "../../../old/dom/TwistyPlayerConfig";
 import {
   CoordinateDegrees,
   orbitCoordinatesEqual,
   OrbitCoordinatesRequest,
   OrbitCoordinatesV2,
-} from "../depth-0/OrbitCoordinatesRequestProp";
+} from "./OrbitCoordinatesRequestProp";
 import { TwistyPropDerived } from "../TwistyProp";
-import type { VisualizationStrategy } from "../depth-3/VisualizationStrategyProp";
+import type { VisualizationStrategy } from "./VisualizationStrategyProp";
 
 interface OrbitCoordinatesPropInputs {
   orbitCoordinatesRequest: OrbitCoordinatesRequest;

package/src/cubing/twisty/model/{depth-0 → props/viewer}/OrbitCoordinatesRequestProp.ts

@@ -1,4 +1,4 @@
-import { mod } from "../helpers";
+import { mod } from "../../helpers";
 import { TwistyPropSource } from "../TwistyProp";
 
 export type CoordinateDegrees = number;

package/src/cubing/twisty/model/{depth-6 → props/viewer}/TimeRangeProp.ts

@@ -1,5 +1,5 @@
-import type { TimeRange } from "../../old/animation/cursor/AlgCursor";
-import type { AlgIndexer } from "../../old/animation/indexer/AlgIndexer";
+import type { TimeRange } from "../../../old/animation/cursor/AlgCursor";
+import type { AlgIndexer } from "../../../old/animation/indexer/AlgIndexer";
 import { TwistyPropDerived } from "../TwistyProp";
 
 export class TimeRangeProp extends TwistyPropDerived<

package/src/cubing/twisty/model/{depth-0 → props/viewer}/ViewerLinkProp.ts

@@ -1,4 +1,4 @@
-import type { ViewerLinkPage } from "../../old/dom/TwistyPlayerConfig";
+import type { ViewerLinkPage } from "../../../old/dom/TwistyPlayerConfig";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 export type ViewerLinkPageWithAuto = ViewerLinkPage | "auto";

package/src/cubing/twisty/model/{depth-0 → props/viewer}/VisualizationProp.ts

@@ -1,4 +1,4 @@
-import type { VisualizationFormat } from "../../old/dom/TwistyPlayerConfig";
+import type { VisualizationFormat } from "../../../old/dom/TwistyPlayerConfig";
 import { SimpleTwistyPropSource } from "../TwistyProp";
 
 export type VisualizationFormatWithAuto = VisualizationFormat | "auto";

package/src/cubing/twisty/model/{depth-3 → props/viewer}/VisualizationStrategyProp.ts

@@ -1,5 +1,5 @@
-import type { PuzzleID } from "../../old/dom/TwistyPlayerConfig";
-import type { VisualizationFormatWithAuto } from "../depth-0/VisualizationProp";
+import type { PuzzleID } from "../../../old/dom/TwistyPlayerConfig";
+import type { VisualizationFormatWithAuto } from "./VisualizationProp";
 import { TwistyPropDerived } from "../TwistyProp";
 
 type VisualizationStrategyPropInputs = {

package/src/cubing/twisty/old/animation/indexer/AlgIndexer.ts

@@ -41,6 +41,7 @@ export function currentMoveArrayEquals(
 
 export interface CurrentMoveInfo {
   stateIndex: number;
+  // Note: some moves may not be part of the alg!
   currentMoves: CurrentMove[];
   // Moves that are reaching a fraction of 1 at this exact timestamp.
   movesFinishing: CurrentMove[];

package/src/cubing/twisty/old/dom/TwistyPlayer.css.ts

@@ -47,4 +47,24 @@ twisty-scrubber {
   width: 100%;
   height: 100%;
 }
+
+.error-elem {
+  width: 100%;
+  height: 100%;
+  display: none;
+  place-content: center;
+  font-family: sans-serif;
+  box-shadow: inset 0 0 2em rgb(255, 0, 0);
+  color: red;
+  text-shadow: 0 0 0.2em white;
+  background: rgba(255, 255, 255, 0.25);
+}
+
+.wrapper.error .visualization-wrapper {
+  display: none;
+}
+
+.wrapper.error .error-elem {
+  display: grid;
+}
 `);

package/src/cubing/twisty/old/dom/TwistyPlayerConfig.ts

@@ -1,6 +1,6 @@
 import { Vector3 } from "three";
 import type { Alg } from "../../../alg";
-import type { VisualizationStrategy } from "../../model/depth-3/VisualizationStrategyProp";
+import type { VisualizationStrategy } from "../../model/props/viewer/VisualizationStrategyProp";
 import { DEGREES_PER_RADIAN } from "../../views/3D/TAU";
 import {
   AlgAttribute,
@@ -151,6 +151,7 @@ export const experimentalStickerings = {
   "experimental-fto-sc": true,
   "experimental-fto-l2c": true,
   "experimental-fto-lbt": true,
+  "experimental-fto-l3t": true,
   "experimental-global-custom-1": true,
   "experimental-global-custom-2": true,
 };

package/src/cubing/twisty/old/dom/viewers/Twisty3DCanvas.ts

@@ -7,7 +7,7 @@ import { twisty3DCanvasCSS } from "./Twisty3DCanvas.css";
 import { OrbitCoordinates, TwistyOrbitControls } from "./TwistyOrbitControls";
 import type { TwistyViewerElement } from "./TwistyViewerElement";
 import { customElementsShim } from "../element/node-custom-element-shims";
-import { Stats } from "../../../../vendor/three/examples/jsm/libs/stats.module";
+import { Stats } from "../../../../vendor/three/examples/jsm/libs/stats.modified.module";
 import type { CameraLatitudeLimits } from "../TwistyPlayerConfig";
 
 let SHOW_STATS = false;
@@ -15,14 +15,7 @@ let SHOW_STATS = false;
 export function experimentalShowRenderStats(show: boolean): void {
   SHOW_STATS = show;
 }
-let shareAllNewRenderers: boolean = false;
-
-// WARNING: The current shared renderer implementation is not every efficient.
-// Avoid using for players that are likely to have dimensions approaching 1 megapixel or higher.
-// TODO: use a dedicated renderer while fullscreen?
-export function experimentalSetShareAllNewRenderers(share: boolean): void {
-  shareAllNewRenderers = share;
-}
+const shareAllNewRenderers: boolean = false;
 
 let sharedRenderer: WebGLRenderer | null = null;
 
@@ -72,7 +65,7 @@ export class Twisty3DCanvas
     this.scene = scene!;
     this.scene?.addRenderTarget(this); // TODO
     if (SHOW_STATS) {
-      this.stats = Stats();
+      this.stats = new Stats();
       this.stats.dom.style.position = "absolute";
       this.addElement(this.stats.dom);
     }

package/src/cubing/twisty/views/2D/Twisty2DPuzzle.ts

@@ -15,7 +15,7 @@ import { RenderScheduler } from "../../old/animation/RenderScheduler";
 import { ManagedCustomElement } from "../../old/dom/element/ManagedCustomElement";
 import { customElementsShim } from "../../old/dom/element/node-custom-element-shims";
 import type { TwistyPlayerModel } from "../../model/TwistyPlayerModel";
-import { FreshListenerManager } from "../../model/TwistyProp";
+import { FreshListenerManager } from "../../model/props/TwistyProp";
 import type {
   ExperimentalStickering,
   PuzzleID,
@@ -101,7 +101,7 @@ export class Twisty2DPuzzle
       }
     } catch (e) {
       console.warn(
-        "Bad position. Pre-emptively disconnecting:",
+        "Bad position (this doesn't necessarily mean something is wrong). Pre-emptively disconnecting:",
         this.puzzleLoader?.id,
         e,
       );

package/src/cubing/twisty/views/2D/Twisty2DPuzzleWrapper.ts

@@ -1,7 +1,7 @@
 import type { PuzzleLoader } from "../../../puzzles";
 import type { ExperimentalStickering } from "../../../twisty";
 import type { TwistyPlayerModel } from "../../model/TwistyPlayerModel";
-import { FreshListenerManager } from "../../model/TwistyProp";
+import { FreshListenerManager } from "../../model/props/TwistyProp";
 import type { Schedulable } from "../../old/animation/RenderScheduler";
 import { Twisty2DPuzzle } from "./Twisty2DPuzzle";
 

package/src/cubing/twisty/views/2D/Twisty2DSceneWrapper.ts

@@ -2,7 +2,7 @@ import type { Scene as ThreeScene } from "three";
 import type { PuzzleLoader } from "../../../puzzles";
 import { THREEJS } from "../../heavy-code-imports/3d";
 import type { TwistyPlayerModel } from "../../model/TwistyPlayerModel";
-import { FreshListenerManager } from "../../model/TwistyProp";
+import { FreshListenerManager } from "../../model/props/TwistyProp";
 import type { Schedulable } from "../../old/animation/RenderScheduler";
 import { ManagedCustomElement } from "../../old/dom/element/ManagedCustomElement";
 import { customElementsShim } from "../../old/dom/element/node-custom-element-shims";

package/src/cubing/twisty/views/3D/RendererPool.ts

@@ -0,0 +1,53 @@
+// TODO: https://stackoverflow.com/a/40443642
+
+// let shareAllNewRenderers: boolean = false;
+
+// // WARNING: The current shared renderer implementation is not every efficient.
+// // Avoid using for players that are likely to have dimensions approaching 1 megapixel or higher.
+// // TODO: use a dedicated renderer while fullscreen?
+// export function experimentalSetShareAllNewRenderers(share: boolean): void {
+//   shareAllNewRenderers = share;
+// }
+
+// const sharedRenderer: WebGLRenderer | null = null;
+
+import { THREEJS } from "../../heavy-code-imports/3d";
+import type { Camera, Scene, WebGLRenderer } from "three";
+import { pixelRatio } from "../../old/dom/viewers/canvas";
+
+const renderers: Promise<WebGLRenderer>[] = [];
+
+// let haveSet = false;
+export async function renderPooled(
+  width: number,
+  height: number,
+  canvas: HTMLCanvasElement,
+  scene: Scene,
+  camera: Camera,
+): Promise<void> {
+  if (width === 0 || height === 0) {
+    return;
+  }
+  // At most one in the pool for now.
+  if (renderers.length === 0) {
+    renderers.push(newRenderer());
+  }
+  const renderer = await renderers[0];
+  // TODO: scissoring
+  renderer.setSize(width, height); // TODO: is it faster if we cache values and only call this when necessary?
+  renderer.render(scene, camera);
+
+  const context = canvas.getContext("2d")!;
+  context.clearRect(0, 0, canvas.width, canvas.height);
+  context.drawImage(renderer.domElement, 0, 0);
+}
+
+export async function newRenderer(): Promise<WebGLRenderer> {
+  const rendererConstructor = (await THREEJS).WebGLRenderer;
+  const renderer = new rendererConstructor({
+    antialias: true,
+    alpha: true,
+  });
+  renderer.setPixelRatio(pixelRatio());
+  return renderer;
+}

package/src/cubing/twisty/views/3D/Twisty3DPuzzleWrapper.ts

@@ -3,10 +3,10 @@ import { experimentalCubeAppearance, PuzzleLoader } from "../../../puzzles";
 import type { ExperimentalStickering } from "../../../twisty";
 import { proxy3D } from "../../heavy-code-imports/3d";
 import type { Cube3D, PG3D } from "../../heavy-code-imports/dynamic-entries/3d";
-import type { HintFaceletStyleWithAuto } from "../../model/depth-0/HintFaceletProp";
-import type { VisualizationStrategy } from "../../model/depth-3/VisualizationStrategyProp";
+import type { HintFaceletStyleWithAuto } from "../../model/props/puzzle/display/HintFaceletProp";
+import type { VisualizationStrategy } from "../../model/props/viewer/VisualizationStrategyProp";
 import type { TwistyPlayerModel } from "../../model/TwistyPlayerModel";
-import { FreshListenerManager } from "../../model/TwistyProp";
+import { FreshListenerManager } from "../../model/props/TwistyProp";
 import type { PuzzlePosition } from "../../old/animation/cursor/CursorTypes";
 import type { Schedulable } from "../../old/animation/RenderScheduler";
 import type { Twisty3DPuzzle } from "./puzzles/Twisty3DPuzzle";
@@ -38,11 +38,12 @@ export class Twisty3DPuzzleWrapper implements Schedulable {
           (await this.twisty3DPuzzle()).onPositionChange(position);
           this.scheduleRender();
         } catch (e) {
-          console.warn(
-            "Bad position. Pre-emptively disconnecting:",
-            this.puzzleLoader.id,
-            e,
-          );
+          // TODO
+          // console.warn(
+          //   "Bad position (this doesn't necessarily mean something is wrong). Pre-emptively disconnecting:",
+          //   this.puzzleLoader.id,
+          //   e,
+          // );
           this.disconnect();
         }
       },

package/src/cubing/twisty/views/3D/Twisty3DSceneWrapper.ts

@@ -1,11 +1,11 @@
 import type { Scene as ThreeScene } from "three";
 import type { PuzzleLoader } from "../../../puzzles";
 import { THREEJS } from "../../heavy-code-imports/3d";
-import type { BackViewLayoutWithAuto } from "../../model/depth-0/BackViewProp";
-import type { VisualizationStrategy } from "../../model/depth-3/VisualizationStrategyProp";
+import type { BackViewLayoutWithAuto } from "../../model/props/viewer/BackViewProp";
+import type { VisualizationStrategy } from "../../model/props/viewer/VisualizationStrategyProp";
 import { StaleDropper } from "../../model/PromiseFreshener";
 import type { TwistyPlayerModel } from "../../model/TwistyPlayerModel";
-import { FreshListenerManager } from "../../model/TwistyProp";
+import { FreshListenerManager } from "../../model/props/TwistyProp";
 import type { Schedulable } from "../../old/animation/RenderScheduler";
 import { ClassListManager } from "../../old/dom/element/ClassListManager";
 import { ManagedCustomElement } from "../../old/dom/element/ManagedCustomElement";
@@ -97,6 +97,10 @@ export class Twisty3DSceneWrapper
     this.#currentTwisty3DPuzzleWrapper?.disconnect();
   }
 
+  experimentalVantages(): Iterable<Twisty3DVantage> {
+    return this.#vantages.values();
+  }
+
   scheduleRender(): void {
     for (const vantage of this.#vantages) {
       vantage.scheduleRender();