SolidMountOptionstype

A PLAYABLE MAZE OVER A SOLID IN ANY PAGE: mountSolid(host, { recipe }) draws a cube, a globe or a solid of triangles with a maze over the whole of its surface, and plays it by touch and mouse.

The solid is looked at from outside, and only the side facing you is drawn. You draw by pressing the start (or the end of your line) and dragging along the passages: the line follows the cells, cannot cross a wall, and drawing back shortens it, exactly as in a flat maze, because it is the very game (game.ts) played on a different graph. You turn the solid by dragging anywhere that is not the end of your line (on the solid or off it), with two fingers (which also pinch to zoom and twist), by the arrow buttons or keys, and by Face me, which brings the end of your line round to face you. And when your line nears the edge of the side you can see, the solid turns by itself, gently, to keep the end of the line in view (edgeTurn, on unless turned off), so a line can be drawn across an edge from one face to the next without letting go.

What it keeps and tells is a flat board's: mazeGame(), run() and restore() (the line as steps, and the stones after a ~), the events meikyuu-move, meikyuu-solve and meikyuu-stones, the data attributes on the host, stones laid beside the line, undo, restart and hints. None of it knows how the solid is turned: the answer is a list of cells.

It paints on a canvas (the solid is redrawn whole at each turn, in a few dozen strokes), so it needs a page, and nothing it draws can be selected. The handle is also on the host, as host.meikyuuSolid.

import type { SolidMountOptions } from "@johnmorrisdotca/meikyuu/3d/play";

type SolidMountOptions = MazeLook & {
    recipe: string | SolidRecipe;
    tap?: boolean;
    hints?: boolean;
    banner?: boolean;
    controls?: boolean;
    zoom?: boolean;
    edgeTurn?: boolean;
    turnMode?: boolean;
    sound?: boolean;
    stones?: StoneOption;
    draw?: boolean;
    still?: boolean;
    gutter?: number;
    reserve?: number;
    language?: MeikyuuLanguage;
    onMove?: (detail: SolidEventDetail) => void;
    onSolve?: (detail: SolidEventDetail) => void;
    onStones?: (detail: SolidEventDetail) => void;
};

import type { MazeRecipe } from "@johnmorrisdotca/meikyuu";
import type { SolidRecipe } from "@johnmorrisdotca/meikyuu/3d";
import type { SolidMountOptions } from "@johnmorrisdotca/meikyuu/3d/play";

const recipe: MazeRecipe = {shape:"square",w:5,h:5,algorithm:"backtracker",mode:"to-goal",seed:42};
const solidRecipe: SolidRecipe = {kind:"cube",n:2,algorithm:"backtracker",seed:42};
const value: SolidMountOptions = {recipe:solidRecipe,language:"en"};
console.log(value);

{
  recipe: { kind: 'cube', n: 2, algorithm: 'backtracker', seed: 42 },
  language: 'en'
}