Skip to the content

Houseki宝石

Run five native gem and stone engines, play measured challenges and lessons, and save deterministic games.

Houseki (宝石) is Japanese for a gem or precious stone. About the name

Contents

Reference · Magnetic Blocks

magneticGravityfunction

Magnetic floor removes all bonds and settles each column segment independently.

Import it

import { magneticGravity } from "@johnmorrisdotca/houseki/magnetic-blocks";

Definition

function magneticGravity(initial: readonly (Gem | null)[], width: number, height: number, mask: readonly boolean[]): readonly (Gem | null)[]

Parameters

NameTypeDescription
initialreadonly (Gem | null)[]

The row-major starting board for gravity settlement.

widthnumber

The native board width in cells.

heightnumber

The native board height in cells.

maskreadonly boolean[]

The row-major active-cell mask; false cells cannot hold gems.

Returns

readonly (Gem | null)[]

Magnetic floor removes all bonds and settles each column segment independently. Nested null values denote empty board cells, absent active pieces, unselected tools or outcomes not yet reached; optional undefined fields are absent until applicable.

Examples

import { createGame, magneticGravity } from "@johnmorrisdotca/houseki/magnetic-blocks";

const state=createGame({seed:"docs"});
console.log(magneticGravity(state.board,state.settings.width,state.settings.height,state.settings.mask).length);
200

What it prints (run when this page was built)

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/houseki 0.4.2.