@johnmorrisdotca/houseki 0.2.1 → 0.4.0

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

@@ -14,6 +14,21 @@ export interface ChainDifficultyMetrics {
     readonly seededPlayoutVariablePrefixLength?: number;
     /** Number of later witnessed placements held fixed in each seeded playout. */
     readonly seededPlayoutFixedSuffixLength?: number;
+    readonly seededPlayoutPlacements?: number;
+    readonly fullPlanSuccessRate?: number;
+    readonly witnessedPlanPlacements?: number;
+    readonly singleStepDeviationProbes?: number;
+    readonly singleStepDeviationWins?: number;
+    readonly singleStepDeviationDeadEnds?: number;
+    readonly branchingDecisionPoints?: number;
+    readonly forcedSafeSteps?: number;
+    readonly forcedSafeShare?: number;
+    readonly branchingShare?: number;
+    readonly consequentialDecisionShare?: number;
+    readonly setupDeviationProbes?: number;
+    readonly setupDeviationLosses?: number;
+    readonly setupDeviationLossShare?: number;
+    readonly verifiedSetupDependencyShare?: number;
     readonly seededPlayoutSuccesses: number;
     readonly seededPlayoutSuccessRate: number;
     readonly setupPairsBeforePayoff: number;
@@ -21,7 +36,27 @@ export interface ChainDifficultyMetrics {
     readonly verifiedSetupDependencies: number;
     /** Number of pre-payoff steps checked by exhaustive single-step deviations. */
     readonly setupDependencyProbeSteps?: number;
+    /** A verified alternate far-side first placement followed by the witnessed recovery pair. */
+    readonly verifiedWrongFirstRecovery?: number;
+    readonly goalTargets?: number;
+    /** Number of distinct target-color components or explicitly required chain waves. */
+    readonly goalDependencyCount?: number;
+    readonly occupiedCells?: number;
+    readonly usableCells?: number;
+    readonly boardCoverage?: number;
+    readonly goalCoordinationShare?: number;
+    readonly cascadeShare?: number;
+    readonly weatherEventCount?: number;
+    readonly weatherDependency?: number;
+    readonly mechanicOffCounterfactualWon?: boolean;
+    readonly mechanicOffCounterfactualKind?: 'nature' | 'magnetism' | 'weather';
+    readonly mechanicOffCounterfactualPhase?: string;
+    readonly rawDifficultyScore?: number;
     readonly requiredChainDepth: number;
+    /** Highest chain observed in the exact authored witness. */
+    readonly witnessedChainDepth?: number;
+    /** Highest chain seen in the bounded random-play sample; not a requirement claim. */
+    readonly observedPotentialChainDepth?: number;
     readonly requiredRotations: number;
     readonly requiredWallKicks: number;
     readonly splitLandingDependencies: number;
@@ -52,12 +87,16 @@ export interface ChainCampaignLevel {
     readonly gradingVersion: string;
     readonly proofStatus: 'engine-witness-verified';
     readonly reviewStatus: 'human-review-pending' | 'human-reviewed';
+    readonly band?: 'entry' | 'easy' | 'intermediate' | 'hard' | 'expert';
+    readonly rawDifficultyScore?: number;
+    readonly normalizationCategory?: string;
 }
 export interface NatureChainCampaignLevel extends ChainCampaignLevel {
     readonly objective: LocalizedText;
     readonly nature: true;
     readonly weather?: 'frequent';
     readonly magneticQueue?: readonly (readonly [boolean, boolean])[];
+    readonly weatherTrace?: readonly Readonly<Record<string, unknown>>[];
 }
 export interface ChainCampaignManifest {
     readonly count: number;
@@ -72,8 +111,15 @@ export interface ChainCampaignManifest {
     readonly checksum: string;
     readonly levels: readonly ChainCampaignLevel[];
 }
+export interface NatureCampaignBand {
+    readonly id: 'entry' | 'easy' | 'intermediate' | 'hard' | 'expert';
+    readonly count: number;
+    readonly first: number;
+    readonly last: number;
+}
 export interface NatureChainCampaignManifest extends Omit<ChainCampaignManifest, 'levels'> {
     readonly levels: readonly NatureChainCampaignLevel[];
+    readonly bands?: readonly NatureCampaignBand[];
 }
 export interface ChainTutorialStep {
     readonly instruction: LocalizedText;

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/dist/colour-chains.d.ts

@@ -5,4 +5,4 @@ export { createChallenge } from './colour-chains/challenge.js';
 export { restartGame, encodeGame, decodeGame } from './colour-chains/persistence.js';
 export { createInputScheduler, setHeldInput, queueInputEdge, releaseAllInput, actionsForTick, applyScheduledActions, processInputTick } from './colour-chains/input.js';
 export { campaignManifest, levelManifest, tutorialManifest, getLevel, createLevel, getTutorial, shizenCampaignManifest, shizenLevelManifest, getShizenLevel, createShizenLevel, arashiCampaignManifest, arashiLevelManifest, getArashiLevel, createArashiLevel } from './colour-chains/content.js';
-export type { LocalizedText, ChainDifficultyMetrics, ChainCampaignLevel, ChainCampaignManifest, NatureChainCampaignLevel, NatureChainCampaignManifest, ChainTutorialStep, ChainTutorialDefinition, ChainContentData } from './colour-chains/content-types.js';
+export type { LocalizedText, ChainDifficultyMetrics, ChainCampaignLevel, ChainCampaignManifest, NatureChainCampaignLevel, NatureChainCampaignManifest, NatureCampaignBand, ChainTutorialStep, ChainTutorialDefinition, ChainContentData } from './colour-chains/content-types.js';