@johnmorrisdotca/houseki 0.1.1 → 0.2.0

package/dist/magnetic-blocks/content-types.d.ts

@@ -0,0 +1,66 @@
+import type { Action, Colour, CreateOptions, Floor, GameState, Gem } from './types.js';
+export interface LocalizedText {
+    readonly en: string;
+    readonly ja: string;
+}
+export interface MagneticDifficultyMetrics {
+    readonly legalPlacementChoices: number;
+    readonly setupPlacementChoices: number;
+    readonly winningPlacementChoices: number;
+    readonly availableFloorChoices: number;
+    readonly witnessPlacements: number;
+    readonly witnessFloorDecisions: number;
+    readonly difficultyScore: number;
+}
+export interface MagneticCampaignLevel {
+    readonly id: string;
+    readonly number: number;
+    readonly title: LocalizedText;
+    readonly objective: LocalizedText;
+    readonly options: CreateOptions;
+    readonly witness: readonly Action[];
+    readonly witnessResult: 'won';
+    readonly metrics: MagneticDifficultyMetrics;
+    readonly marks: 1 | 2 | 3 | 4 | 5;
+    readonly tags: readonly string[];
+    readonly canonicalKey: string;
+    readonly canonicalKeyHash: string;
+    readonly score: number;
+    readonly gradingVersion: string;
+    readonly proofStatus: 'engine-witness-verified';
+    readonly reviewStatus: 'human-review-pending' | 'human-reviewed';
+    readonly counterfactual?: {
+        readonly kind: 'floor-choice' | 'floor-schedule' | 'floor-switch';
+        readonly alternative: string;
+        readonly result: 'won' | 'lost' | 'finished';
+    };
+    readonly impactEvidence?: {
+        readonly removedSupportCount: number;
+        readonly disabledImpactResult: 'won';
+    };
+}
+export interface MagneticCampaignManifest {
+    readonly count: number;
+    readonly candidateCount: number;
+    readonly generationRevision: string;
+    readonly gradingVersion: string;
+    readonly difficultyFormula: string;
+    readonly normalization: string;
+    readonly marksFormula: string;
+    readonly checksum: string;
+    readonly orderingPolicy: string;
+    readonly levels: readonly MagneticCampaignLevel[];
+}
+export interface MagneticLesson {
+    readonly id: string;
+    readonly title: LocalizedText;
+    readonly objective: LocalizedText;
+    readonly options: CreateOptions;
+    readonly witness: readonly Action[];
+    readonly instruction: readonly LocalizedText[];
+}
+export interface MagneticContentData {
+    readonly campaign: MagneticCampaignManifest;
+    readonly lessons: readonly MagneticLesson[];
+}
+export type { Action, Colour, CreateOptions, Floor, GameState, Gem };

package/dist/magnetic-blocks/content-types.js

@@ -0,0 +1 @@
+export {};

package/dist/magnetic-blocks/content.d.ts

@@ -0,0 +1,16 @@
+import type { MagneticCampaignLevel, MagneticCampaignManifest, MagneticLesson } from './content-types.js';
+import type { GameState } from './types.js';
+export declare const campaignManifest: MagneticCampaignManifest;
+export declare const levelManifest: readonly MagneticCampaignLevel[];
+/** Alias kept alongside other Houseki campaign lesson APIs. */
+export declare const tutorialManifest: readonly MagneticLesson[];
+export declare const lessonManifest: readonly MagneticLesson[];
+/** Finds a Magnetic Blocks campaign level by stable ID or one-based display number. */
+export declare function getLevel(id: string | number): MagneticCampaignLevel | undefined;
+/** Creates a fresh game with the authored rules, board, queue, and finite move budget. */
+export declare function createLevel(id: string | number): GameState;
+/** Finds one of the three bilingual rules lessons by stable ID. */
+export declare function getLesson(id: string): MagneticLesson | undefined;
+export declare const getTutorial: typeof getLesson;
+/** Creates a fresh lesson game with its authored setup and queue. */
+export declare function createLesson(id: string): GameState;

package/dist/magnetic-blocks/content.js

@@ -0,0 +1,38 @@
+import { contentData } from './content-data.js';
+import { createGame } from './engine.js';
+function deepFreeze(value) {
+    if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const child of Object.values(value))
+            deepFreeze(child);
+    }
+    return value;
+}
+export const campaignManifest = deepFreeze(contentData.campaign);
+export const levelManifest = campaignManifest.levels;
+/** Alias kept alongside other Houseki campaign lesson APIs. */
+export const tutorialManifest = deepFreeze(contentData.lessons);
+export const lessonManifest = tutorialManifest;
+/** Finds a Magnetic Blocks campaign level by stable ID or one-based display number. */
+export function getLevel(id) {
+    if (typeof id === 'number')
+        return Number.isInteger(id) ? levelManifest.find(level => level.number === id) : undefined;
+    return levelManifest.find(level => level.id === id);
+}
+/** Creates a fresh game with the authored rules, board, queue, and finite move budget. */
+export function createLevel(id) {
+    const level = getLevel(id);
+    if (!level)
+        throw new RangeError(`Unknown Magnetic Blocks level: ${String(id)}`);
+    return createGame(level.options);
+}
+/** Finds one of the three bilingual rules lessons by stable ID. */
+export function getLesson(id) { return tutorialManifest.find(lesson => lesson.id === id); }
+export const getTutorial = getLesson;
+/** Creates a fresh lesson game with its authored setup and queue. */
+export function createLesson(id) {
+    const lesson = getLesson(id);
+    if (!lesson)
+        throw new RangeError(`Unknown Magnetic Blocks lesson: ${String(id)}`);
+    return createGame(lesson.options);
+}

package/dist/magnetic-blocks/engine.js

@@ -38,8 +38,10 @@ function completeGoal(state) {
 function spawn(state) {
     if (completeGoal(state))
         return [{ ...state, phase: 'won', active: null, reason: 'goal-complete' }, [{ type: 'run-ended', result: 'won', reason: 'goal-complete', score: state.score }]];
-    if (state.placements >= state.settings.pieceLimit || !state.queue.length)
-        return [{ ...state, phase: 'finished', active: null, reason: 'queue-exhausted' }, [{ type: 'run-ended', result: 'finished', reason: 'queue-exhausted', score: state.score }]];
+    if (state.placements >= state.settings.pieceLimit || !state.queue.length) {
+        const result = state.settings.goal ? 'lost' : 'finished';
+        return [{ ...state, phase: result, active: null, reason: 'queue-exhausted' }, [{ type: 'run-ended', result, reason: 'queue-exhausted', score: state.score }]];
+    }
     const [colours, ...rest] = state.queue, gems = colours.map((colour, index) => ({ id: state.nextId + index, colour }));
     const block = freezeBlock({ x: Math.floor(state.settings.width / 2) - 1, y: 0, orientation: 0, gems, descent: 0, lockTicks: 0, lockResets: 0, lockStarted: false });
     const floor = floorAt(state.settings.schedule, state.placements + 1);

package/dist/magnetic-blocks.d.ts

@@ -1,5 +1,7 @@
 export { MagneticBlocksOptionsError } from './magnetic-blocks/validation.js';
 export { createGame, applyAction, advanceTicks, legalActions, statusOf } from './magnetic-blocks/engine.js';
 export { encodeGame, decodeGame, restartGame } from './magnetic-blocks/persistence.js';
+export { campaignManifest, levelManifest, tutorialManifest, lessonManifest, getLevel, createLevel, getLesson, getTutorial, createLesson } from './magnetic-blocks/content.js';
 export { blockCells, canPlace, landingY, matchGroups, removeIds, calmGravity, magneticGravity, settle, impactSupportIds, blockBonds, MARK_TICKS, REMOVE_TICKS, GRAVITY_TICKS } from './magnetic-blocks/physics.js';
 export type { Action, Block, Bond, Colour, CreateOptions, Floor, FloorSchedule, GameEvent, GameState, GameStatus, Gem, Goal, Mode, Phase, RecordedAction, Settings, Transition } from './magnetic-blocks/types.js';
+export type { LocalizedText, MagneticCampaignLevel, MagneticCampaignManifest, MagneticDifficultyMetrics, MagneticLesson } from './magnetic-blocks/content-types.js';

package/dist/magnetic-blocks.js

@@ -1,4 +1,5 @@
 export { MagneticBlocksOptionsError } from './magnetic-blocks/validation.js';
 export { createGame, applyAction, advanceTicks, legalActions, statusOf } from './magnetic-blocks/engine.js';
 export { encodeGame, decodeGame, restartGame } from './magnetic-blocks/persistence.js';
+export { campaignManifest, levelManifest, tutorialManifest, lessonManifest, getLevel, createLevel, getLesson, getTutorial, createLesson } from './magnetic-blocks/content.js';
 export { blockCells, canPlace, landingY, matchGroups, removeIds, calmGravity, magneticGravity, settle, impactSupportIds, blockBonds, MARK_TICKS, REMOVE_TICKS, GRAVITY_TICKS } from './magnetic-blocks/physics.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@johnmorrisdotca/houseki",
-  "version": "0.1.1",
-  "description": "Houseki \u5b9d\u77f3: four original gem and stone puzzle games, Falling Triplets, Colour Chains, Stone Collapse and Gem Swap, as immutable seeded engines with 300 graded levels, plus experimental Magnetic Blocks. English and Japanese. Zero dependencies.",
+  "version": "0.2.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",
     "puzzle-game",
@@ -28,7 +28,10 @@
     "zero-dependencies",
     "browser",
     "node",
-    "itsutsu"
+    "itsutsu",
+    "shizen",
+    "arashi",
+    "campaign"
   ],
   "homepage": "https://johnmorrisdotca.github.io/houseki/",
   "repository": {