Actiontype
A native player action accepted or rejected according to the current phase and rules.
Every export of every entry point, each with its own page. This page keeps the addresses the old one-page reference had.
@johnmorrisdotca/houseki/falling-tripletsActiontypeA native player action accepted or rejected according to the current phase and rules.
actionsForTickfunctionResolves canonical actions in the design's per-tick order.
advanceTicksfunctionAdvances fixed 60 Hz game ticks.
applyActionfunctionApplies and records one immutable action; rejected actions preserve state identity.
CampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
campaignManifestconstantThe frozen native campaign manifest with its ordering, revisions, checksum and measured levels.
CampaignManifesttypeThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
ChallengeGoaltypeA native authored challenge objective; its discriminant selects target, chain, empty-board or score requirements.
ChallengeGoalChaintypeA Falling Triplets objective requiring at least the supplied chain depth.
ChallengeGoalEmptytypeA Falling Triplets objective requiring an empty board.
ChallengeGoalTargetstypeA Falling Triplets objective requiring the supplied stable target ids to be cleared.
ChallengeHinttypeOne witnessed Falling Triplets placement with a column and cycle orientation.
ChallengeOptionstypeAuthored challenge inputs including the starting board, finite goal and supplied witness.
ChallengeSettingstypeThe fixed Falling Triplets challenge settings with the original board and finite triplet queue.
ColourtypeA gem colour ID.
compactBoardfunctionCompacts each column downward while preserving the top-to-bottom order of survivors.
createChallengefunctionCreates a challenge after validating its authored board, finite queue, goal, and witness.
createGamefunctionCreates a deterministic empty game with an active piece and three-piece preview.
createInputSchedulerfunctionCreates an empty fixed-tick input scheduler state.
createLevelfunctionConstruct a fresh validated challenge state for a stable level ID or display number.
CreateOptionstypeCreation settings for this native engine; dimensions, mode, seed and optional mechanics are validated together.
decodeGamefunctionReplays and validates a bounded save, then verifies its checkpoint against the derived state.
DifficultyMetricstypeThe bounded engine measurements used to grade this campaign; they do not claim human difficulty.
encodeGamefunctionEncodes the authoritative settings, action recording, and derived checkpoint.
findMatchesfunctionFinds the union of every maximal horizontal, vertical, and diagonal run of at least three.
GameEventtypeAn event emitted by one native transition; type selects the event’s additional fields.
GameStatetypeThe immutable authoritative native game state, including its board, random state and recording.
GemtypeA settled or active gem with a stable run-local identity.
getLevelfunctionFind a level by stable content ID or its current one-based display number.
getTutorialfunctionFind a lesson by its persistent ID.
landingYfunctionReturns the exact landing row for the current rigid triplet.
legalActionsfunctionLists the core actions currently available to the player.
levelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
LocalizedTexttypeOne authored text in English and Japanese.
ModetypeThe native game mode; authored challenges have fixed setup and queue rules.
nextIntfunctionDraws an unbiased integer and updated state using rejection sampling.
nextUint32functionAdvances the reference xorshift32 source.
PhasetypeThe native falling, resolution, pause and ending phases.
PiecetypeThe native falling triplet with stable gem ids, orientation, descent and lock counters.
queueInputEdgefunctionQueues a one-shot cycle, drop, or pause edge for the next logical tick.
RecordedActiontypeOne accepted canonical action and its logical tick position.
releaseAllActionsfunctionReleases every held action after blur, pause, or pointer cancellation.
restartGamefunctionRecreates the same authored mode, seed, and challenge configuration from its original setup.
seedStatefunctionHashes a string seed with UTF-8 FNV-1a and returns a nonzero uint32 state.
setHeldActionfunctionStarts or releases one held action; opposite lateral holds cancel during scheduling.
SettingstypeValidated settings fixed at native game creation.
statusOffunctionReturns a plain status summary suitable for UI labels.
TransitiontypeThe resulting native state, emitted events and acceptance decision; rejected actions preserve the input.
TriplettypeThree ordered gem colours composing one falling triplet.
TutorialDefinitiontypeOne bilingual native lesson with its authored setup, teaching steps and winning witness.
tutorialManifestconstantThe frozen native bilingual lessons and their authored teaching steps.
TutorialSteptypeOne bilingual native lesson instruction and the corresponding action or tick step.
WavetypeOne simultaneous native match wave, its cleared cells and chain score.
@johnmorrisdotca/houseki/colour-chainsActiontypeA native player action accepted or rejected according to the current phase and rules.
actionsForTickfunctionResolves this tick's inputs in lateral, rotation, drop, soft-drop, pause order.
advanceTicksfunctionAdvances deterministic 60 Hz simulation and resolution; Relaxed and Challenges do not force a falling clock.
applyActionfunctionApplies one immutable accepted action and records its logical-tick position.
applyScheduledActionsfunctionApplies a scheduler batch until the pair locks or the run pauses; accepted actions are recorded by the engine.
arashiCampaignManifestconstantThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
arashiLevelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
campaignManifestconstantThe frozen native campaign manifest with its ordering, revisions, checksum and measured levels.
CelltypeA visible or hidden board coordinate.
ChainCampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
ChainCampaignManifesttypeThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
ChainContentDatatypeThe stored native Colour Chains campaign, lessons and optional Shizen/Arashi campaigns.
ChainDifficultyMetricstypeThe bounded engine measurements used to grade this campaign; they do not claim human difficulty.
ChainsPowerDropPreviewtypeThe Shizen hard-drop preview: the one-step rebound and where the pair locks (finalCells), and where each stone of the pair comes to rest once the committed drop's gravity has run (settledCells).
ChainTutorialDefinitiontypeOne bilingual native lesson with its authored setup, teaching steps and winning witness.
ChainTutorialSteptypeOne bilingual native lesson instruction and the corresponding action or tick step.
ChallengeGemtypeAuthored challenge layouts can include explicit Shizen-marked stones.
ChallengeGoaltypeChallenge objective; target IDs refer to the visible starting board.
ChallengeOptionstypeAuthored challenge inputs including the starting board, finite goal and supplied witness.
ColourtypeA gem colour used by Colour Chains.
createArashiLevelfunctionCreate a validated native Arashi challenge using its stored setup and winning witness.
createChallengefunctionValidates and creates a finite witnessed challenge.
createGamefunctionCreates a deterministic seeded game with one active pair and three previews.
createInputSchedulerfunctionCreates an empty held-input scheduler.
createLevelfunctionCreate a fresh engine-validated challenge from a stable content ID or display number.
CreateOptionstypeCreation settings for this native engine; dimensions, mode, seed and optional mechanics are validated together.
createShizenLevelfunctionCreate a validated native Shizen challenge using its stored setup and winning witness.
decodeGamefunctionReconstructs a bounded action replay and rejects any checkpoint that differs from replay.
encodeGamefunctionEncodes canonical initial settings, accepted ordinal actions and a derived checkpoint.
GameEventtypeA domain event emitted by one transition.
GameStatetypeAn immutable Colour Chains rules state.
GameStatustypeCompact player status derived from the current state.
GemtypeA settled or active stone with a stable run-local identity.
getArashiLevelfunctionFind a native Arashi challenge by stable id or one-based display number.
getLevelfunctionFind a campaign challenge by stable content ID or its current one-based number.
getShizenLevelfunctionFind a native Shizen challenge by stable id or one-based display number.
getTutorialfunctionFind a persistent interactive lesson by its stable ID.
HeldControltypeA lateral or soft-drop control which the input scheduler can repeat.
InputCommandtypeA native held-control change or one-shot edge command for Colour Chains.
LandingtypeDestination cells for the two independently settled ghost stones.
landingCellsfunctionReturns the exact independent landing cells for the current rigid pair without consuming random values.
legalActionsfunctionLists only actions accepted by the current game state.
levelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
LocalizedTexttypeOne authored text in English and Japanese.
ModetypeThe native game mode; authored challenges have fixed setup and queue rules.
NatureCampaignBandtypeAn inclusive one-based range in a measured native nature-campaign difficulty band.
NatureChainCampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
NatureChainCampaignManifesttypeThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
OrientationtypeThe pivot-to-satellite direction, in clockwise order.
PairtypeThe active rigid pair.
PhasetypeObservable game phases.
PlayActiontypeOne native Colour Chains player command, including pause and hint commands.
powerDropPreviewfunctionReturns the Shizen hard-drop landing and one-step rebound preview without changing state.
PresettypeSupported well presets.
processInputTickfunctionApplies a complete deterministic held-input and simulation tick, releasing controls on lock or resolution.
queueInputEdgefunctionQueues a one-shot rotation, drop, Place, pause or resume edge for the next logical tick.
RecordedActiontypeA native action recording with the logical position needed for deterministic replay.
releaseAllInputfunctionReleases every held or queued control after focus loss, lock, resolution or pause.
restartGamefunctionRestarts the same seed/date or original witnessed challenge board and queue.
setHeldInputfunctionStarts or releases one held control.
SettingstypeRun settings fixed at game creation.
shizenCampaignManifestconstantThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
shizenLevelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
statusOffunctionReturns score, mode, chain and completion fields derived from state.
StoneChainsOptionsErrorclassTyped setup and authored challenge error.
TransitiontypeA deterministic transition; rejected actions retain the exact input state.
tutorialManifestconstantThe frozen native bilingual lessons and their authored teaching steps.
WavetypeA scored simultaneous match wave.
WeatherScheduletypeThe native frequent or rare weather schedule for Colour Chains.
WitnessSteptypeOne witnessed Colour Chains pair placement using pivot column and orientation.
@johnmorrisdotca/houseki/tsumikiActiontypeOne move: a piece from the tray, placed with its top left on a cell.
ActionResulttypeWhat an applied action came to: whether it was taken, the state after it, and what happened.
advanceTicksfunctionAdvances nothing: a placement is whole the moment it is made.
applyActionfunctionPlays one move: a piece is laid, every full row and column clears together, and the tray fills when it is empty.
BlocktypeOne filled cell: its run-local identity, its colour, and whether it is a stone a challenge asks to be cleared.
BlockColourtypeA colour used by a placed block.
BOARD_SIDEconstantThe board's side: eight cells each way.
canPlacefunctionWhether a piece from the tray can go with its top left on this cell, for a host to draw a ghost.
ChallengeGoaltypeWhat a challenge asks for: a score, a number of lines, or every stone cleared.
ChallengeOptionstypeAn authored game: its identity, seed, goal and the stones it starts with.
createChallengefunctionMakes an authored game from its seed, goal and stones.
createGamefunctionMakes a free game or a Daily: a Daily's seed is its date, so one date is one game for everybody.
createLevelfunctionMakes a level's game; throws for a level that does not exist.
CreateOptionstypeThe options a free game or a Daily is made from.
createTutorialfunctionMakes a lesson's game; throws for a lesson that does not exist.
decodeGamefunctionReads a save by playing it again from the start, so a save cannot claim what its moves do not do.
encodeGamefunctionA game as text: what it was and the moves made, never the score or the board, which a replay works out.
GameEventtypeWhat a move made happen, for a host to draw or sound.
GameModetypeThe free, daily or authored game mode.
GamePhasetypeWhere a game stands: waiting for a placement, won, lost, or finished with a score.
GameSettingstypeHow a game was set up, the whole of what a replay needs but the moves.
GameStatetypeThe whole of a game, returned new by every move: nothing in it is changed in place.
GameStatustypeA game's figures as a host would show them.
getLevelfunctionLooks a level up by its id or its display number; null where there is none.
getTutorialfunctionLooks a lesson up by its id; null where there is none.
legalActionsfunctionEvery placement allowed now, a bot's or a test's whole view of what can be done.
levelManifestconstantThe frozen graded levels, in order; array indices start at zero and display numbers at one.
LocalizedTexttypeWords in both languages.
PiecetypeA shape in the tray: its name, its colour, and its cells as row and column from its own top left.
restartGamefunctionThe same game from its start, with the same settings.
statusOffunctionA game's figures: its phase, its score, its lines and how far along its goal it is.
TsumikiLeveltypeOne graded level: its seed, goal and stones, and a line of moves the engine has been shown to win with.
TsumikiTutorialtypeOne bilingual lesson, with the game it is played on and a line of moves that wins it.
TsumikiTutorialSteptypeOne step of a lesson.
tutorialManifestconstantThe frozen bilingual lessons.
@johnmorrisdotca/houseki/stone-collapseActiontypeA native player action accepted or rejected according to the current phase and rules.
advanceTicksfunctionAdvances the observable 7/6/9 tick removal and gravity stages, bounded to 3600 ticks.
applyActionfunctionApplies a selection, confirmation, or cancellation without mutating its input.
BoardPresettypeA named native board geometry; custom dimensions remain a separate option.
BoardShapetypeA native shaped active-cell layout applied to the row-major board.
campaignManifestconstantThe frozen native campaign manifest with its ordering, revisions, checksum and measured levels.
ChallengeDefinitiontypeA validated Stone Collapse authored setup and stable-id group witness.
ChallengeGoaltypeA native authored challenge objective; its discriminant selects target, chain, empty-board or score requirements.
ChallengeOptionstypeAuthored challenge inputs including the starting board, finite goal and supplied witness.
CollapseCampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
CollapseCampaignManifesttypeThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
CollapseDifficultyMetricstypeThe bounded engine measurements used to grade this campaign; they do not claim human difficulty.
CollapseTutorialDefinitiontypeOne bilingual native lesson with its authored setup, teaching steps and winning witness.
CollapseTutorialSteptypeOne bilingual native lesson instruction and the corresponding action or tick step.
createChallengefunctionCreates a fixed witnessed challenge after validating its board, objective, move budget, and every witness group.
createGamefunctionCreates a seeded full board; an all-singleton draw retries before using a checked adjacent pair.
createLevelfunctionConstruct a fresh engine-validated challenge from a content ID or display number.
CreateOptionstypeCreation settings for this native engine; dimensions, mode, seed and optional mechanics are validated together.
decodeGamefunctionReconstructs and validates a bounded replay before accepting its checkpoint.
encodeGamefunctionEncodes the canonical initial configuration, accepted replay actions, and a derived checkpoint.
GameEventtypeAn event emitted by one native transition; type selects the event’s additional fields.
GameModetypeThe native free, timed, daily or authored-challenge game mode.
GamePhasetypeThe native ready, resolution and ending phases.
GameStatetypeThe immutable authoritative native game state, including its board, random state and recording.
GameStatustypeA compact native status derived from the authoritative state for a host’s labels.
getLevelfunctionFind a challenge by its persistent content ID or current one-based display number.
getTutorialfunctionFind a persistent interactive lesson by its stable ID.
legalActionsfunctionLists every selection and confirmation currently accepted by the rules.
levelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
LocalizedTexttypeOne authored text in English and Japanese.
RecordedActiontypeA native action recording with the logical position needed for deterministic replay.
requestHintfunctionSelects the next supplied witness group only while the run still matches its path; accepted hints mark the run assisted.
restartGamefunctionStarts a fresh attempt from the identical seeded board or preserved challenge definition.
SettingstypeValidated settings fixed at native game creation.
statusOffunctionReturns the stable public game status and the remaining-stone count.
StonetypeA stone keeps its run-local identity as it falls or changes column.
StoneCollapseOptionsErrorclassTyped public-settings validation error.
StoneColourtypeA colour used by a stone.
StoredTooltypeA stored Stone Collapse tool selected from the native Bomb and Pick tray.
ToolInventorytypeThe native remaining counts of stored tools.
TransitiontypeThe resulting native state, emitted events and acceptance decision; rejected actions preserve the input.
tutorialManifestconstantThe frozen native bilingual lessons and their authored teaching steps.
undofunctionRestores the full pre-move state in Relaxed or Challenge practice and permanently marks the attempt assisted.
UndoFrametypeData sufficient to restore the complete game immediately before a committed move.
@johnmorrisdotca/houseki/gem-swapActiontypeA native player action accepted or rejected according to the current phase and rules.
advanceTicksfunctionAdvances deterministic resolution ticks; wall-clock time is supplied separately by the host.
advanceTimefunctionAdds explicit host-measured elapsed time.
applyActionfunctionApplies one recorded player action.
BlackHolePortaltypeA Gem Swap portal’s cell, remaining capacity, move lifetime and consumed stable ids.
BoardPresettypeA named native board geometry; custom dimensions remain a separate option.
BoardShapetypeA native shaped active-cell layout applied to the row-major board.
CAMPAIGN_CHECKSUMconstantThe stored Gem Swap campaign content fingerprint.
CAMPAIGN_COUNTconstantThe number of stored Gem Swap campaign challenges.
CancelToolActiontypeClears the current Gem Swap tool preview.
ChallengeRulestypeGem Swap authored goals, optional move budget and seal layout.
ConfirmToolActiontypeCommits the currently selected Gem Swap tool and target.
createGamefunctionCreates a deterministic stable board with at least one legal normal swap.
CreateOptionstypeCreation settings for this native engine; dimensions, mode, seed and optional mechanics are validated together.
decodeGamefunctionValidates and reconstructs a state by replay; serialized board snapshots are never trusted.
encodeGamefunctionEncodes the initial rules plus accepted actions and logical inputs in canonical JSON.
GameEventtypeAn event emitted by one native transition; type selects the event’s additional fields.
GameModetypeThe native free, timed, daily or authored-challenge game mode.
GameOutcometypeThe terminal outcome; null means the run has no terminal outcome yet.
GamePhasetypeThe native ready, resolution and ending phases.
GameStatetypeThe immutable authoritative native game state, including its board, random state and recording.
GameStatustypeA compact native status derived from the authoritative state for a host’s labels.
GemtypeA gem has a stable identity and stored colour until it is cleared.
GEM_SWAP_CAMPAIGNconstantThe frozen measured Gem Swap challenges with stable ids, setups, witnesses and review status.
GEM_SWAP_LESSONSconstantThe frozen bilingual Gem Swap lessons with setup, teaching steps and witnesses.
GemColourtypeA colour used by a normal gem.
GemSwapCampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
GemSwapLessontypeOne bilingual native lesson with its authored setup, teaching steps and winning witness.
GemSwapLessonSteptypeOne bilingual native lesson instruction and the corresponding action or tick step.
GemSwapOptionsErrorclassTyped error for invalid settings or a board that cannot be generated safely.
GemSwapReviewStatustypeThe existing campaign’s human-review-pending status; an engine witness is not human review.
GENERATION_REVISIONconstantThe stored Gem Swap campaign generation revision.
GoaltypeThe native authored goal; its discriminant selects the required collection or clearing condition.
GRADING_VERSIONconstantThe measurement/normalization revision used to grade Gem Swap challenges.
GRADING_WEIGHTSconstantThe bounded Gem Swap metric weights used in the recorded grading formula.
HintActiontypeRequests a native Gem Swap hint and marks assisted play.
hintGamefunctionReturns a deterministic legal swap hint and permanently marks the run assisted.
legalActionsfunctionLists all legal swaps that would be accepted from the current stable state.
OrdinaryToolKindtypeA Gem Swap stored tool excluding the separately charged Black Hole.
PlannedSpecialtypeThe native Gem Swap cell and special kind planned for the end of a clear wave.
ReplayErrorclassA typed rejection of a malformed, unsupported or inconsistent native replay.
ReplayOperationtypeOne native Gem Swap action, fixed-tick advance or elapsed-time replay operation.
ReshuffleActiontypeRequests a native Gem Swap recovery shuffle.
reshuffleGamefunctionShuffles existing gem records in Relaxed play, preserving their colour and special counts.
restartGamefunctionStarts the exact initial ruleset and seed again, discarding all run progress.
SAMPLE_BUDGETconstantThe fixed number of seeded playout samples used in the stored Gem Swap grading.
SealtypeA Gem Swap row-major seal cell and its remaining layers.
SelectToolActiontypeSelects a stored Gem Swap tool without committing its target.
SettingstypeValidated settings fixed at native game creation.
SpecialKindtypeA Gem Swap beam, bomb or colour-burst special retained at its chosen anchor.
statusOffunctionDerive the native phase, score, legal-move count, tools and goal/timer progress for host labels.
SwapActiontypeSwaps two row-major cell addresses.
TargetToolActiontypePreviews a selected Gem Swap tool on one row-major cell.
ToolInventorytypeThe native remaining counts of stored tools.
ToolKindtypeA Gem Swap stored tool or advanced Black Hole selection.
TransitiontypeThe resulting native state, emitted events and acceptance decision; rejected actions preserve the input.
UndoActiontypeRequests restoration of the prior Gem Swap move.
undoGamefunctionRestores the last committed swap in Relaxed or Challenge play and marks assistance.
validateChallengeWitnessfunctionChecks a complete authored witness through the public deterministic rules API.
@johnmorrisdotca/houseki/natureapplyEarthquakefunctionCommit one bounded environmental resolution; matching, gravity and score remain the host game's job.
applyLightningfunctionCommit one lightning strike.
applyMagneticPulsefunctionApply one attraction pulse.
applyPowerDropfunctionCommit a previewed landing as one immutable operation.
AttractionPairPreviewtypeA pure attraction decision including the paired ids, axis, gap, midpoint and moves.
createNatureStatefunctionCreate a validated seeded native environment grid with fixed masks and mechanic switches.
EarthquakeKindtypeThe native fault, jumble or combined earthquake mode.
EarthquakeOptionstypeThe earthquake mode and optional enabled flag.
EnvironmentEventtypeA committed earthquake or lightning event with its native preview fields.
EnvironmentPreviewtypeA native earthquake or lightning preview before it is committed.
EnvironmentScheduletypeA periodic, one-turn or authored list of environment trigger turns.
EnvironmentTransitiontypeThe committed environment state, event list and pure preview.
FaultPreviewtypeA pure earthquake fault path, removed ids and resulting occupants/passability mask.
HorizontalDirectiontypeThe native left or right direction used for rebound decisions.
isEnvironmentTurnScheduledfunctionPure one-based schedule lookup: frequent is every second turn; rare is every eighth turn.
JumblePreviewtypeA pure eligible-patch shuffle and resulting occupants; reason explains when no patch exists.
LightningOptionstypeLightning enablement and explicit columns or a bounded column count.
LightningPreviewtypeA pure selected-column removal and resulting occupants/random state.
MagneticPreviewtypeA pure magnetic-pulse result; no input state or random source is consumed.
MarkingOptionstypeThe probability and optional count/anchor bounds used to mark magnetic stones.
markMagneticStonesfunctionDeterministically assign magnetic markings to settled stones without changing their IDs or colours.
NatureEntitytypeStable board occupant.
NatureErrorCodetypeStable native validation codes for grid, cell, marking and power-drop failures.
NatureEventtypeAn emitted native magnetic marking, attraction or power-drop event.
NatureMovetypeOne native stable-id move between two board coordinates.
NatureOptionstypeThe native grid dimensions, passability mask, occupants, seed and magnetic/rebound settings.
NatureOptionsErrorclassA typed native grid, cell, marking or power-drop validation error.
NaturePieceCelltypeA falling native stone with its cell coordinates and stable id.
NatureRulestypeThe fixed native magnetic and rebound rule switches.
NatureStatetypeThe immutable native environment state with stable ids, seeded random state and placement count.
NatureTransitiontypeThe native environment result, emitted events and optional pure preview.
PowerDropPreviewtypeThe pure normal landing, rebound attempts and final lock cells with resulting random state.
PowerDropRequesttypeThe native piece cells, pivot id and host-selected power/rebound options.
previewEarthquakefunctionPreview an earthquake, with Combined always fracturing before its one jumble attempt.
previewFaultfunctionPreview a bounded top-to-bottom fracture.
previewJumblefunctionPreview one seeded, nontrivial stone permutation inside a fully active connected rectangle no larger than 3×3.
previewLightningfunctionPreview seeded or explicitly selected columns; a mask gap or obstacle blocks the strike below it.
previewMagneticPulsefunctionPreview one bounded deterministic attraction pulse without mutating the state.
previewPowerDropfunctionPreview a single normal landing and, for a power drop, at most one validated one-cell rebound.
QuarterTurntypeA counterclockwise, unchanged or clockwise quarter-turn chosen by the host.
ReboundAttemptPreviewtypeOne tested rebound direction and quarter-turn with its collision-validity result.
ReboundDirectionModetypeWhether rebound prefers recent input/alternation or the seeded random source.
@johnmorrisdotca/houseki/magnetic-blocksActiontypeA native player action accepted or rejected according to the current phase and rules.
advanceTicksfunctionAdvances fixed 60 Hz time, resolving phases in all modes and falling/locking only in Arcade.
applyActionfunctionApplies one movement, rotation, floor-switch or placement action without mutation.
BlocktypeThe native active 2×2 block, orientation and fixed-tick descent/lock counters.
blockBondsfunctionList the native stable-id bonds connecting adjacent gems in the active block.
blockCellsfunctionReturns stable-gem addresses after rotating the square block around its centre.
BondtypeAn undirected stable-id connection between two gems in a magnetic block.
calmGravityfunctionSettles bonded connected components one cell per deterministic bottom/ID priority step.
campaignManifestconstantThe frozen native campaign manifest with its ordering, revisions, checksum and measured levels.
canPlacefunctionTest whether the whole native block fits passable empty board cells.
ColourtypeA standard gem colour used by a magnetic block.
createGamefunctionCreates an immutable seeded 2×2-block game with a fixed queue and explicit floor schedule.
createLessonfunctionCreates a fresh lesson game with its authored setup and queue.
createLevelfunctionCreates a fresh game with the authored rules, board, queue, and finite move budget.
CreateOptionstypeCreation settings for this native engine; dimensions, mode, seed and optional mechanics are validated together.
decodeGamefunctionReplays bounded canonical input and verifies every saved checkpoint field.
encodeGamefunctionEncodes canonical settings, accepted tick-stamped actions and a verified replay checkpoint.
FloortypeThe native calm or magnetic floor used when settling blocks.
FloorScheduletypeA fixed, periodic or authored schedule selecting the floor for committed block placements.
GameEventtypeAn event emitted by one native transition; type selects the event’s additional fields.
GameStatetypeThe immutable authoritative native game state, including its board, random state and recording.
GameStatustypeA compact native status derived from the authoritative state for a host’s labels.
GemtypeA native gem with a stable run-local id and colour.
getLessonfunctionFinds one of the three bilingual rules lessons by stable ID.
getLevelfunctionFinds a Magnetic Blocks campaign level by stable ID or one-based display number.
getTutorialfunctionFind a magnetic-block lesson by stable id; returns undefined when no lesson has that id.
GoaltypeThe native authored goal; its discriminant selects the required collection or clearing condition.
GRAVITY_TICKSconstantFixed 60 Hz ticks in the magnetic-block gravity phase.
impactSupportIdsfunctionCollects the occupied one-cell support layer under both block columns at first contact.
landingYfunctionFind the last legal block row before downward collision.
legalActionsfunctionLists accepted controls for the current falling or resolution phase.
lessonManifestconstantThe frozen native bilingual lessons and their authored teaching steps.
levelManifestconstantThe frozen ordered native levels; array indices start at zero and display numbers start at one.
LocalizedTexttypeOne authored text in English and Japanese.
MagneticBlocksOptionsErrorclassA typed native magnetic-block setup validation error.
MagneticCampaignLeveltypeOne authored native challenge with its stable id, setup, winning witness, measurements and review status.
MagneticCampaignManifesttypeThe ordered native campaign, its generation/grading revisions, checksum and measured levels.
MagneticDifficultyMetricstypeThe bounded engine measurements used to grade this campaign; they do not claim human difficulty.
magneticGravityfunctionMagnetic floor removes all bonds and settles each column segment independently.
MagneticLessontypeOne bilingual native lesson with its authored setup, teaching steps and winning witness.
MARK_TICKSconstantThe fixed 60 Hz ticks showing the magnetic-block match mark phase.
matchGroupsfunctionComputes deterministic orthogonal colour components of at least four gems.
ModetypeThe native game mode; authored challenges have fixed setup and queue rules.
PhasetypeThe native falling, resolution, pause and ending phases.
RecordedActiontypeA native action recording with the logical position needed for deterministic replay.
REMOVE_TICKSconstantFixed 60 Hz ticks in the magnetic-block removal phase.
removeIdsfunctionRemove the selected native cell indices and discard bonds whose endpoint gems were removed.
restartGamefunctionRestarts the same seed, custom starting board, fixed queue, rules and floor options.
SettingstypeValidated settings fixed at native game creation.
settlefunctionSettle surviving gems with the chosen floor rule and retain valid stable-id bonds.
statusOffunctionReturns a compact immutable status including current and upcoming floor state.
TransitiontypeThe resulting native state, emitted events and acceptance decision; rejected actions preserve the input.
tutorialManifestconstantAlias kept alongside other Houseki campaign lesson APIs.
@johnmorrisdotca/housekicolourChainsnamespacefallingTripletsnamespacegemSwapnamespacemagneticBlocksnamespacenaturenamespacestoneCollapsenamespacetsumikinamespace