Skip to the content

Kyuubuキューブ

Turn CSS 3D cubes by touch, keys or notation, reproduce a scramble from a seed, and follow a solve one named step at a time.

Kyuubu (キューブ) is the Japanese spelling of cube. About the name

Contents

Reference · Cuboid drawing

CuboidViewOptionstype

Everything a cuboid on the screen can be told when it is made. Only dims is needed.

Import it

import type { CuboidViewOptions } from "@johnmorrisdotca/kyuubu/cuboid/draw";

Definition

type CuboidViewOptions = {
    dims: CuboidDims;
    state?: string;
    colours?: Partial<Record<CubeFace, string>>;
    plastic?: string;
    theme?: CubeTheme;
    rounded?: boolean;
    locale?: KyuubuLanguage;
    interactive?: boolean;
    keyboard?: "focus" | "page" | "none";
    turnMs?: number;
    commitAngle?: number;
    yaw?: number;
    pitch?: number;
    fill?: number;
    onTurn?: (move: CuboidMove, state: string) => void;
    onLook?: (yaw: number, pitch: number) => void;
    label?: string;
};

Members

NameTypeDescription
dimsCuboidDims

The puzzle's width, height and depth: each 1 to 7, and not 1×1×1.

state (optional)string | undefined

The stickers, one letter each (solvedCuboid); solved when left out.

colours (optional)Partial<Record<"U" | "R" | "F" | "D" | "L" | "B", string>> | undefined

Colours for the six faces, by the letter a solved face carries. A face left out takes its CSS custom property (--kyuubu-up and the rest), and the standard colour where that is not set.

plastic (optional)string | undefined

The colour of the plastic between stickers and inside the puzzle. Left out, it is --kyuubu-plastic, and #111 where that is not set.

theme (optional)CubeTheme | undefined

A whole look at once: colours, plastic and the shape of a sticker. colours and plastic given beside it win.

rounded (optional)boolean | undefined

Whether the puzzle's corners are rounded, like the plastic of a real one: true when left out.

locale (optional)KyuubuLanguage | undefined

The language of the puzzle's accessible name: English or Japanese. Left out, it follows the page's lang.

interactive (optional)boolean | undefined

Whether a person can turn it. A look-only puzzle still turns when asked (turn). True when left out.

keyboard (optional)"focus" | "page" | "none" | undefined

Where the keys are listened for: the puzzle itself once it has focus (the default), the whole page, or nowhere.

turnMs (optional)number | undefined

How long a quarter turn takes, in milliseconds, when it is made by a key, by notation or from code: 160 when left out. A device that asks for reduced motion gets no animation, whatever this says.

commitAngle (optional)number | undefined

The point of no return of a dragged layer that turns by quarters, in degrees: 30 when left out. From 5 to 85.

yaw (optional)number | undefined

How the puzzle is first seen: turned about its up axis, in degrees.

pitch (optional)number | undefined

How the puzzle is first seen: tipped towards the viewer, in degrees.

fill (optional)number | undefined

How much of the space the puzzle fills, 0 to 1.

onTurn (optional)((move: CuboidMove, state: string) => void) | undefined

A turn a person made, with the stickers once it is done.

onLook (optional)((yaw: number, pitch: number) => void) | undefined

Every time the view is turned, for anything that wants to keep it.

label (optional)string | undefined

What a screen reader calls the puzzle. Left out, it is "A 2×3×3 cuboid" in the puzzle's language.

Examples

import type { CuboidViewOptions } from "@johnmorrisdotca/kyuubu/cuboid/draw";


const value: CuboidViewOptions = { dims: [2, 3, 3], interactive: true, keyboard: "focus" };
console.log(value.dims);
[ 2, 3, 3 ]

What it prints (run when this page was built)

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/kyuubu 1.14.1.