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

Troubleshooting & FAQ

Troubleshooting & FAQ

Find out why a view is blank, why a read returns null or throws, and what is stored or sent.

The view is blank

Give its host a size and positioning context. Check that the browser imported the view entry and, for a custom element, its definition entry. An engine-only import does not register elements. Use Mount a cube as the smallest setup.

A parser returns null

parseMove/parseMoves refuse unrecognized notation or nonexistent layers. decodeCubeMoves refuses an invalid code. For a position and reason, use parseSolve. Cuboid parsers also refuse quarter turns of a rectangular slice; readCuboidMoves tells you which token and why. parseCuboidDims refuses unsupported dimensions. readSolveLink accepts supported alg.cubing.net links rather than arbitrary URLs.

Other null and undefined results

solveSteps returns null outside 2×2 and 3×3. moveName and cuboidMoveName return null for unsupported standard forms. Drag picks wait with null while the gesture is too short or ambiguous; release helpers return null when no turn commits. Movement descriptions and hints refuse combinations that are not one movement; rotation arrows can have null face/arrow when no side is sufficiently visible. cubeWidthPx returns null when no explicit width or scale gives one, leaving the host in control.

fromJSON and fromText return null for an unreadable export. JSON reconstructs records and ignores supplied derived state; invalid records may be omitted. famousSolve and cuboidPreset return undefined for unknown keys; paceFromAttribute returns undefined for the default pace. An unplanned player's plan/status is null and its fault explains the problem. An unmounted React ref is null. Element string properties return null for absent attributes.

A valid replay is unfinished

A planned replay can have solved: false. This preserves a reconstruction as supplied; it is different from ok: false, which refuses invalid input. Likewise, checking sticker counts does not prove a state is physically reachable.

A cuboid turn throws

The low-level engine expects a legal move. Check cuboidMoveLegal or parse with the cuboid's dimensions first. Invalid turns throw RangeError; they are not silently converted to half turns.

Does the package store or upload a solve?

The engine and builder do not upload records. The builder stores settings in its address. Host applications choose any history storage themselves. Exported files are made locally.

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