@johnmorrisdotca/houseki 0.0.0-stage → 0.1.0

package/dist/stone-collapse/content-types.d.ts

@@ -0,0 +1,77 @@
+import type { ChallengeGoal, Stone, StoneColour } from './types.js';
+export interface LocalizedText {
+    readonly en: string;
+    readonly ja: string;
+}
+export interface CollapseDifficultyMetrics {
+    readonly seededPlayoutSamples: number;
+    readonly seededPlayoutSuccesses: number;
+    readonly seededPlayoutSuccessRate: number;
+    readonly legalGroupChoices: number;
+    readonly witnessedDecisionCount: number;
+    readonly sampledOrderFailureShare: number;
+    readonly forcedSafeGroupShare: number;
+    readonly averageGroupChoices: number;
+    readonly witnessMoves: number;
+    readonly moveBudgetSlack: number;
+}
+export interface CollapseCampaignLevel {
+    readonly id: string;
+    readonly number: number;
+    readonly title: LocalizedText;
+    readonly canonicalKeyHash: string;
+    readonly width: number;
+    readonly height: number;
+    readonly colourCount: 4;
+    readonly mask?: readonly boolean[];
+    readonly seed: string;
+    readonly board: readonly (Stone | null)[];
+    readonly goal: ChallengeGoal;
+    readonly moveLimit: number;
+    readonly witness: readonly (readonly number[])[];
+    readonly tags: readonly string[];
+    readonly rawMetrics: CollapseDifficultyMetrics;
+    readonly score: number;
+    readonly marks: 1 | 2 | 3 | 4 | 5;
+    readonly gradingVersion: string;
+    readonly proofStatus: 'engine-witness-verified';
+    readonly reviewStatus: 'human-review-pending';
+}
+export interface CollapseCampaignManifest {
+    readonly count: number;
+    readonly candidatePoolCount: number;
+    readonly generationRevision: string;
+    readonly gradingVersion: string;
+    readonly category: string;
+    readonly curationPolicy: string;
+    readonly orderingPolicy: string;
+    readonly grading: Readonly<Record<string, unknown>>;
+    readonly sampleBudget: number;
+    readonly checksum: string;
+    readonly levels: readonly CollapseCampaignLevel[];
+}
+export interface CollapseTutorialStep {
+    readonly instruction: LocalizedText;
+    readonly action: string;
+}
+export interface CollapseTutorialDefinition {
+    readonly id: string;
+    readonly title: LocalizedText;
+    readonly objective: LocalizedText;
+    readonly setup: {
+        readonly width: number;
+        readonly height: number;
+        readonly colourCount: 4;
+        readonly board: readonly (Stone | null)[];
+        readonly goal: ChallengeGoal;
+        readonly moveLimit?: number;
+        readonly witness: readonly (readonly number[])[];
+    };
+    readonly steps: readonly CollapseTutorialStep[];
+    readonly tags: readonly string[];
+}
+export interface CollapseContentData {
+    readonly campaign: CollapseCampaignManifest;
+    readonly tutorials: readonly CollapseTutorialDefinition[];
+}
+export type { ChallengeGoal, Stone, StoneColour };

package/dist/stone-collapse/content-types.js

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

package/dist/stone-collapse/content.d.ts

@@ -0,0 +1,11 @@
+import type { CollapseCampaignLevel, CollapseCampaignManifest, CollapseTutorialDefinition } from './content-types.js';
+import type { GameState } from './types.js';
+export declare const campaignManifest: CollapseCampaignManifest;
+export declare const levelManifest: readonly CollapseCampaignLevel[];
+export declare const tutorialManifest: readonly CollapseTutorialDefinition[];
+/** Find a challenge by its persistent content ID or current one-based display number. */
+export declare function getLevel(id: string | number): CollapseCampaignLevel | undefined;
+/** Construct a fresh engine-validated challenge from a content ID or display number. */
+export declare function createLevel(id: string | number): GameState;
+/** Find a persistent interactive lesson by its stable ID. */
+export declare function getTutorial(id: string): CollapseTutorialDefinition | undefined;

package/dist/stone-collapse/content.js

@@ -0,0 +1,28 @@
+import { contentData } from './content-data.js';
+import { createChallenge } 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;
+export const tutorialManifest = deepFreeze(contentData.tutorials);
+/** Find a challenge by its persistent content ID or current 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);
+}
+/** Construct a fresh engine-validated challenge from a content ID or display number. */
+export function createLevel(id) {
+    const level = getLevel(id);
+    if (!level)
+        throw new RangeError(`Unknown Stone Collapse level: ${String(id)}`);
+    return createChallenge({ id: level.id, seed: level.seed, width: level.width, height: level.height, colourCount: level.colourCount, ...(level.mask ? { mask: level.mask } : {}), initialBoard: level.board, goal: level.goal, moveLimit: level.moveLimit, witness: level.witness });
+}
+/** Find a persistent interactive lesson by its stable ID. */
+export function getTutorial(id) { return tutorialManifest.find(tutorial => tutorial.id === id); }

package/dist/stone-collapse/engine.d.ts

@@ -0,0 +1,19 @@
+import type { Action, ChallengeOptions, CreateOptions, GameState, GameStatus, Stone, Transition } from './types.js';
+/** @internal Constructs the generator's bounded valid-pair fallback for direct invariant checks. */
+export declare function fallbackBoard(mask: readonly boolean[], width: number, height: number, colourCount: number): readonly (Stone | null)[];
+/** Creates a seeded full board; an all-singleton draw retries before using a checked adjacent pair. */
+export declare function createGame(options?: CreateOptions): GameState;
+/** Creates a fixed witnessed challenge after validating its board, objective, move budget, and every witness group. */
+export declare function createChallenge(options: ChallengeOptions): GameState;
+/** Applies a selection, confirmation, or cancellation without mutating its input. */
+export declare function applyAction(state: GameState, action: Action): Transition;
+/** Selects the next supplied witness group only while the run still matches its path; accepted hints mark the run assisted. */
+export declare function requestHint(state: GameState): Transition;
+/** Restores the full pre-move state in Relaxed or Challenge practice and permanently marks the attempt assisted. */
+export declare function undo(state: GameState): Transition;
+/** Advances the observable 7/6/9 tick removal and gravity stages, bounded to 3600 ticks. */
+export declare function advanceTicks(state: GameState, ticks: number): Transition;
+/** Lists every selection and confirmation currently accepted by the rules. */
+export declare function legalActions(state: GameState): readonly Action[];
+/** Returns the stable public game status and the remaining-stone count. */
+export declare function statusOf(state: GameState): GameStatus;