@sdxc/random 0.0.0-pre.1 → 2026.10.6

package/README.md

@@ -115,22 +115,30 @@ A `Random` with `seed`, `derive(label)` and `state()`.
 
 ## Pattern: A Reproducible Fuzz Run
 
-Draw a fresh seed per run unless one is supplied, and print it, so a failing run replays from that number.
+Draw a fresh seed per run unless one is supplied, and name the suite after it, so a failure reports the number that replays it.
 
 ```typescript
 import { createRandom, systemSeed } from "@sdxc/random";
-
-let seed = Number(process.env.FUZZ_SEED) || systemSeed();
-console.info(`fuzz seed: ${seed}`);
-
-let random = createRandom(seed);
-let cases = Array.from({ length: 1000 }, () => ({
-	minute: random.int(0, 59),
-	hour: random.int(0, 23),
-	weekday: random.pick(["MON", "TUE", "WED", "THU", "FRI"]),
-}));
+import { describe, expect, test } from "vitest";
+
+const SEED = Number(process.env.FUZZ_SEED) || systemSeed();
+
+describe(`cron parsing (FUZZ_SEED=${SEED})`, () => {
+	test("every generated expression parses", () => {
+		let random = createRandom(SEED);
+
+		for (let index = 0; index < 1000; index++) {
+			let minute = random.int(0, 59);
+			let hour = random.int(0, 23);
+			let weekday = random.pick(["MON", "TUE", "WED", "THU", "FRI"]);
+			expect(parseCron(`${minute} ${hour} * * ${weekday}`).success).toBe(true);
+		}
+	});
+});
 ```
 
+`parseCron` is the function under test.
+
 ## Pattern: Persisting A Simulation
 
 Store each stream's state next to the world it shaped, and validate it on load, since a save file is untrusted input.
@@ -150,14 +158,18 @@ function save(): string {
 	return JSON.stringify({ turn, random: random.state() });
 }
 
-function load(text: string) {
+function load(text: string): boolean {
 	let parsed = s.parseSafe(SAVE_SCHEMA, JSON.parse(text));
-	if (!parsed.success) throw new Error("Corrupt save file");
+	if (!parsed.success) return false;
+
 	turn = parsed.value.turn;
 	random = restoreRandom(parsed.value.random);
+	return true;
 }
 ```
 
+A save that fails the schema leaves the running game as it was, and `load` answers `false` so the caller can say the file was unreadable.
+
 ## Versioning
 
 Releases are dated rather than semantic. A version is the UTC date it was published, written `YYYY.M.D`, so `2026.9.4` is the release from 4 September 2026. At most one release goes out per day.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sdxc/random",
-	"version": "0.0.0-pre.1",
+	"version": "2026.10.6",
 	"description": "Seeded and system random streams with integer, float, pick and shuffle draws, and resumable state",
 	"license": "MIT",
 	"type": "module",
@@ -16,7 +16,7 @@
 			"optional": true
 		}
 	},
-	"gitHead": "47e70835fe3943a13cf37f07c3dfb8203aba1c35",
+	"gitHead": "b1067eb20fc47ec51ff8c4de47d07dc3f9c00466",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -24,5 +24,14 @@
 		"type": "git",
 		"url": "git+https://github.com/sergiodxa/monorepo.git",
 		"directory": "packages/random"
+	},
+	"homepage": "https://sdxc.sergiodxa.com/api/random",
+	"author": {
+		"name": "Sergio Xalambrí",
+		"url": "https://sergiodxa.com"
+	},
+	"funding": {
+		"type": "github",
+		"url": "https://github.com/sponsors/sergiodxa"
 	}
 }