@johnmorrisdotca/houseki 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this package are written here, newest first, in the form
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-10-06
+
+The ten open fix tickets were each read against the code, and the ones that were real are fixed and held by new tests: Magnetic Blocks' settings and Space key, and the big-board region of Falling Triplets and Colour Chains. The other tickets were already fixed in 0.2.0, and the review tests that hold them now run in `pnpm test:demo`.
+
+### Added
+
+- `powerDropPreview` of Colour Chains returns `settledCells` as well as `finalCells`: where each stone of the pair comes to rest in the board the hard drop commits, before any clear, with the stones' stable ids. `finalCells` is where the pair locks after the rebound (the cells of the `power-drop-landed` event), and stones above a gap then fall, so a ghost drawn from `finalCells` could sit a row above where the stone ends up. The new type is `ChainsPowerDropPreview`.
+- `test/previews-match-outcomes.test.mjs` compares the previews with the boards the real actions leave, over thousands of played boards: the Shizen hard-drop preview, the gentle Place landing, Falling Triplets' landing row, and Magnetic Blocks' two actions. `e2e/review/boards-settings-and-keys.test.mjs` plays the demo's level settings, its Space key, its big-board keyboard navigation in both languages and the square cells of every size.
+
+### Fixed
+
+- Magnetic Blocks: choosing a level or lesson shows its own board size, colours, floor and impact at once, as "Fixed · 8 × 12" ("固定"), instead of the free-play choice it would not use; the rules are locked while it is chosen, and choosing Free play, or a mode, gives the player's own settings back. Before this the controls changed only on New game, then kept the level's values for good, labelled "Custom size". The board in play is not relabelled before New, and the free choices are remembered between visits.
+- Magnetic Blocks: in a campaign level or lesson the Space key did a hard drop while the ghost and the Place button showed a gentle land. The two leave different boards on about one in seven positions of the campaign. Space now does what the game's mode offers, as the ghost shows.
+- Magnetic Blocks keeps its checkpoint within 350 ms of a change during continuous play; every move used to postpone the save until the player stopped.
+- Falling Triplets: a board too big for the screen is a focusable, labelled region like the other two, with a position readout; its arrow keys scroll it and no longer move the triplet.
+- Falling Triplets, Colour Chains and Magnetic Blocks: "Top", "Bottom" and the position readout are in Japanese when the page is, and the region is named for the board it holds, not for its scroll position. A board that fits is no longer a tab stop.
+
 ## [0.2.1] - 2026-10-06
 
 Nothing that was exported has changed. The README is the family's one layout, in full.
@@ -66,7 +83,9 @@ Nothing that was exported has changed. The README is the family's one layout, in
 - An experimental Magnetic Blocks engine with bonded squares, magnetic floor schedules, a Floor Switch and impact drops.
 - Typed entry points, a generated API reference, an MIT licence and reproducible package checks.
 
-[Unreleased]: https://github.com/johnmorrisdotca/houseki/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/johnmorrisdotca/houseki/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/johnmorrisdotca/houseki/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/johnmorrisdotca/houseki/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/johnmorrisdotca/houseki/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/johnmorrisdotca/houseki/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/johnmorrisdotca/houseki/releases/tag/v0.1.0

package/README.md

@@ -753,7 +753,7 @@ Ideas, bug reports and pull requests are welcome in the [issues](https://github.
 
 ## Changes
 
-Every release is written up in [CHANGELOG.md](./CHANGELOG.md). The latest release, 0.2.1, adds no code: it is this README in full, with pictures of every game, examples that are run on every change, examples for React, Vue, Svelte and Angular, and an Accessibility section.
+Every release is written up in [CHANGELOG.md](./CHANGELOG.md). The latest release, 0.3.0, makes Magnetic Blocks show a level's fixed rules as soon as the level is chosen and give free play its own choices back, makes Space do what the ghost showed, lets a big board be scrolled from the keyboard on all three falling players, and adds `settledCells` to the Shizen hard-drop preview.
 
 ## Licence
 

package/dist/colour-chains/engine.d.ts

@@ -1,5 +1,4 @@
-import type { PowerDropPreview } from '../nature/types.js';
-import type { Action, Colour, CreateOptions, GameState, GameStatus, Gem, Landing, Settings, Transition } from './types.js';
+import type { Action, ChainsPowerDropPreview, Colour, CreateOptions, GameState, GameStatus, Gem, Landing, Settings, Transition } from './types.js';
 export { StoneChainsOptionsError } from './validation.js';
 /** Applies one immutable accepted action and records its logical-tick position. */
 export declare function applyAction(state: GameState, action: Action): Transition;
@@ -9,8 +8,15 @@ export declare function advanceTicks(state: GameState, ticks: number): Transitio
 export declare function legalActions(state: GameState): readonly Action[];
 /** Returns the exact independent landing cells for the current rigid pair without consuming random values. */
 export declare function landingCells(state: GameState): Landing | null;
-/** Returns the Shizen hard-drop landing and one-step rebound preview without changing state. */
-export declare function powerDropPreview(state: GameState): PowerDropPreview | null;
+/**
+ * Returns the Shizen hard-drop landing and one-step rebound preview without changing state.
+ *
+ * `finalCells` is where the pair locks after any rebound, the cells of the `power-drop-landed` event. Stones above a
+ * gap then fall, so `settledCells` is where each stone of the pair comes to rest in the board the hard drop commits,
+ * before any clear: draw a ghost from it. Both carry the pair's stable stone ids, and both are checked against
+ * `applyAction` with a `hard-drop` over many played boards.
+ */
+export declare function powerDropPreview(state: GameState): ChainsPowerDropPreview | null;
 /** Returns score, mode, chain and completion fields derived from state. */
 export declare function statusOf(state: GameState): GameStatus;
 /** Creates a base challenge state with a previously validated visible board and pair queue. @internal */

package/dist/colour-chains/engine.js

@@ -457,11 +457,26 @@ export function landingCells(state) {
     const settled = compactBoard(board, state.settings.width, state.settings.height + HIDDEN);
     return pair.gems.map(gem => { const index = settled.findIndex(cell => cell?.id === gem.id); return { x: index % state.settings.width, y: Math.floor(index / state.settings.width) - HIDDEN }; });
 }
-/** Returns the Shizen hard-drop landing and one-step rebound preview without changing state. */
+/**
+ * Returns the Shizen hard-drop landing and one-step rebound preview without changing state.
+ *
+ * `finalCells` is where the pair locks after any rebound, the cells of the `power-drop-landed` event. Stones above a
+ * gap then fall, so `settledCells` is where each stone of the pair comes to rest in the board the hard drop commits,
+ * before any clear: draw a ghost from it. Both carry the pair's stable stone ids, and both are checked against
+ * `applyAction` with a `hard-drop` over many played boards.
+ */
 export function powerDropPreview(state) {
     if (!state.settings.nature || state.settings.mode === 'relaxed' || !state.active)
         return null;
-    return rebound(state, state.active)?.preview ?? null;
+    const preview = rebound(state, state.active)?.preview;
+    if (!preview)
+        return null;
+    const dropped = applyAction(state, { kind: 'hard-drop' });
+    const board = dropped.accepted ? (dropped.state.gravityBoard ?? dropped.state.board) : null;
+    const settledCells = board
+        ? state.active.gems.flatMap(gem => { const index = board.findIndex(cell => cell?.id === gem.id); return index < 0 ? [] : [{ ...(preview.finalCells.find(cell => cell.id === gem.id) ?? { id: gem.id, kind: 'stone', colour: gem.colour }), x: index % state.settings.width, y: Math.floor(index / state.settings.width) - HIDDEN }]; })
+        : preview.finalCells;
+    return Object.freeze({ ...preview, settledCells: Object.freeze(settledCells) });
 }
 /** Returns score, mode, chain and completion fields derived from state. */
 export function statusOf(state) { return { mode: state.settings.mode, phase: state.phase, score: state.score, maxChain: state.maxChain, allClears: state.allClears, completedPairs: state.completedPairs, assisted: state.assisted, ...(state.reason ? { reason: state.reason } : {}) }; }

package/dist/colour-chains/types.d.ts

@@ -1,3 +1,4 @@
+import type { NaturePieceCell, PowerDropPreview } from '../nature/types.js';
 /** A gem colour used by Colour Chains. */
 export type Colour = 'red' | 'blue' | 'green' | 'gold' | 'purple' | 'teal';
 /** A settled or active stone with a stable run-local identity. */
@@ -193,3 +194,7 @@ export interface GameStatus {
 }
 /** Destination cells for the two independently settled ghost stones. */
 export type Landing = readonly [Cell, Cell];
+/** The 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`). */
+export interface ChainsPowerDropPreview extends PowerDropPreview {
+    readonly settledCells: readonly NaturePieceCell[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/houseki",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Houseki 宝石: five original gem and stone puzzle engines, 450 graded challenges, bilingual lessons, deterministic saves, magnetic floors, Shizen and Arashi campaigns. TypeScript. Zero dependencies.",
   "keywords": [
     "puzzle",
@@ -108,10 +108,10 @@
     "check": "pnpm lint && pnpm typecheck && pnpm test",
     "prepublishOnly": "pnpm check && pnpm build",
     "site": "pnpm build && node scripts/site.mjs",
-    "test:demo": "pnpm site && playwright test && node --test --test-concurrency=2 e2e/review/appearance-api.test.mjs e2e/review/endings.test.mjs e2e/review/full-board-recovery.test.mjs e2e/review/nature-previews.test.mjs e2e/review/responsive.test.mjs",
+    "test:demo": "pnpm site && playwright test && node --test --test-concurrency=2 e2e/review/appearance-api.test.mjs e2e/review/boards-settings-and-keys.test.mjs e2e/review/endings.test.mjs e2e/review/full-board-recovery.test.mjs e2e/review/nature-previews.test.mjs e2e/review/responsive.test.mjs",
     "screenshots:readme": "pnpm site && node scripts/readme-pictures.mjs",
     "test:readme": "pnpm build && node scripts/check-readme-examples.mjs",
-    "test:review": "pnpm site && node --test --test-concurrency=2 e2e/review/appearance-api.test.mjs e2e/review/endings.test.mjs e2e/review/full-board-recovery.test.mjs e2e/review/nature-previews.test.mjs e2e/review/responsive.test.mjs"
+    "test:review": "pnpm site && node --test --test-concurrency=2 e2e/review/appearance-api.test.mjs e2e/review/boards-settings-and-keys.test.mjs e2e/review/endings.test.mjs e2e/review/full-board-recovery.test.mjs e2e/review/nature-previews.test.mjs e2e/review/responsive.test.mjs"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",