@johnmorrisdotca/houseki 0.1.1 → 0.2.1

package/dist/colour-chains/challenge.js

@@ -61,7 +61,7 @@ function solveWitness(start, witness) {
 export function createChallenge(options) {
     if (!options || typeof options !== 'object' || Array.isArray(options))
         throw new StoneChainsOptionsError('invalid-challenge', 'Challenge options must be an object');
-    const allowed = ['id', 'width', 'height', 'colourCount', 'seed', 'board', 'queue', 'goal', 'witness'];
+    const allowed = ['id', 'width', 'height', 'colourCount', 'seed', 'board', 'queue', 'magneticQueue', 'nature', 'weather', 'goal', 'witness'];
     if (Object.keys(options).some(key => !allowed.includes(key)))
         throw new StoneChainsOptionsError('unknown-challenge-option', 'Challenge options contain unsupported fields');
     if (typeof options.id !== 'string' || !/^[a-z0-9][a-z0-9._-]{0,63}$/.test(options.id))
@@ -75,6 +75,14 @@ export function createChallenge(options) {
     const seed = options.seed ?? `challenge:${options.id}`;
     if (typeof seed !== 'string' || seed.length < 1 || seed.length > 200)
         throw new StoneChainsOptionsError('invalid-seed', 'Seed must contain 1–200 characters');
+    if (options.nature !== undefined && typeof options.nature !== 'boolean')
+        throw new StoneChainsOptionsError('invalid-nature-option', 'nature must be a boolean');
+    if (options.weather !== undefined && options.weather !== 'frequent' && options.weather !== 'rare')
+        throw new StoneChainsOptionsError('invalid-weather-option', 'weather must be frequent or rare');
+    if (options.weather !== undefined && options.nature !== true)
+        throw new StoneChainsOptionsError('weather-requires-nature', 'Arashi weather requires nature:true');
+    if (options.magneticQueue !== undefined && options.nature !== true)
+        throw new StoneChainsOptionsError('magnetic-queue-requires-nature', 'Magnetic queue flags require nature:true');
     if (!Array.isArray(options.board) || options.board.length !== width * height)
         throw new StoneChainsOptionsError('invalid-challenge-board', 'Challenge board must contain width × height visible cells');
     if (!Array.isArray(options.queue) || options.queue.length < 2 || options.queue.length > 12)
@@ -84,10 +92,10 @@ export function createChallenge(options) {
     const board = options.board.map((gem, index) => {
         if (gem === null)
             return null;
-        if (!gem || typeof gem !== 'object' || Array.isArray(gem) || Object.keys(gem).some(key => key !== 'id' && key !== 'colour') || !Number.isSafeInteger(gem.id) || gem.id < 1 || gem.id > 0x7fff_ffff || ids.has(gem.id) || !allowedColours.includes(gem.colour))
+        if (!gem || typeof gem !== 'object' || Array.isArray(gem) || Object.keys(gem).some(key => key !== 'id' && key !== 'colour' && key !== 'magnetic') || !Number.isSafeInteger(gem.id) || gem.id < 1 || gem.id > 0x7fff_ffff || ids.has(gem.id) || !allowedColours.includes(gem.colour) || gem.magnetic !== undefined && (gem.magnetic !== true || options.nature !== true))
             throw new StoneChainsOptionsError('invalid-challenge-gem', `Invalid challenge gem at cell ${index}`);
         ids.add(gem.id);
-        return Object.freeze({ id: gem.id, colour: gem.colour });
+        return Object.freeze({ id: gem.id, colour: gem.colour, ...(gem.magnetic ? { magnetic: true } : {}) });
     });
     for (let x = 0; x < width; x++) {
         let gap = false;
@@ -103,6 +111,12 @@ export function createChallenge(options) {
             throw new StoneChainsOptionsError('invalid-challenge-pair', `Invalid queue pair ${index + 1}`);
         return Object.freeze([pair[0], pair[1]]);
     });
+    let magneticQueue;
+    if (options.magneticQueue !== undefined) {
+        if (!Array.isArray(options.magneticQueue) || options.magneticQueue.length !== queue.length || options.magneticQueue.some(pair => !Array.isArray(pair) || pair.length !== 2 || pair.some(flag => typeof flag !== 'boolean')))
+            throw new StoneChainsOptionsError('invalid-magnetic-queue', 'Magnetic queue must contain one pair of boolean flags per finite queue pair');
+        magneticQueue = Object.freeze(options.magneticQueue.map(pair => Object.freeze([pair[0], pair[1]])));
+    }
     const goal = validateChallengeGoal(options.goal, ids);
     if (!Array.isArray(options.witness) || options.witness.length < 1 || options.witness.length > queue.length)
         throw new StoneChainsOptionsError('invalid-witness', 'A challenge requires a complete witness of 1–12 pair placements');
@@ -111,7 +125,7 @@ export function createChallenge(options) {
             throw new StoneChainsOptionsError('invalid-witness-step', `Invalid witness placement ${index + 1}`);
         return Object.freeze({ pivotX: step.pivotX, orientation: step.orientation });
     });
-    const settings = Object.freeze({ mode: 'challenge', width, height, colourCount, seed, challengeId: options.id, goal, initialBoard: Object.freeze(board), queue: Object.freeze(queue), witness: Object.freeze(witness) });
+    const settings = Object.freeze({ mode: 'challenge', width, height, colourCount, seed, challengeId: options.id, goal, initialBoard: Object.freeze(board), queue: Object.freeze(queue), ...(magneticQueue ? { magneticQueue } : {}), ...(options.nature ? { nature: true } : {}), ...(options.weather ? { weather: options.weather } : {}), witness: Object.freeze(witness) });
     const state = initialChallengeState(settings, settings.initialBoard, settings.queue);
     const solved = solveWitness(state, witness);
     if (solved.phase !== 'won' || stable(solved.settings) !== stable(settings))