CHANGELOG 8.X

-import { uniformIntDistribution, xoroshiro128plus } from 'pure-rand';
+import { uniformInt } from 'pure-rand/distribution/uniformInt';
+import { xoroshiro128plus } from 'pure-rand/generator/xoroshiro128plus';

rng is now the first argument — All functions now take the generator as the first parameter:

-uniformIntDistribution(1, 6, rng);
+uniformInt(rng, 1, 6);

Functions mutate rng in-place by default — The old "pure" functions (returning [value, nextRng] tuples) have been removed. Functions now directly return the generated value and mutate the generator. To get the old pure behavior, wrap with purify:

-const [value, nextRng] = uniformIntDistribution(1, 6, rng);
+import { purify } from 'pure-rand/utils/purify';
+const pureUniformInt = purify(uniformInt);
+const [value, nextRng] = pureUniformInt(rng, 1, 6);

Renamed distributions — Pure distribution names have been shortened:

7.x	8.0
`unsafeUniformIntDistribution`	`uniformInt`
`unsafeUniformBigIntDistribution`	`uniformBigInt`
`uniformIntDistribution`	`purify(uniformInt)`
`uniformBigIntDistribution`	`purify(uniformBigInt)`
`uniformArrayIntDistribution` / `unsafeUniformArrayIntDistribution`	(removed)

fromState moved to dedicated exports — Restoring a generator from its state now uses a separate function:

-import prand from 'pure-rand';
-const rng = prand.xoroshiro128plus.fromState(state);
+import { xoroshiro128plusFromState } from 'pure-rand/generator/xoroshiro128plus';
+const rng = xoroshiro128plusFromState(state);

Dedicated JumpableRandomGenerator type — Generators supporting jump() now implement a separate JumpableRandomGenerator interface (extends RandomGenerator). If you need generators with jump() method, update the type:

-import type { RandomGenerator } from 'pure-rand/types/RandomGenerator';
+import type { JumpableRandomGenerator } from 'pure-rand/types/JumpableRandomGenerator';

Breaking Changes

1838e5e 💥 Drop uniformArrayInt (#868)
09b403a 💥 Introduce dedicated Jumpable type (#864)
6b5dd37 💥 Move fromState in dedicated export (#848)
67cb28c 💥 Make unsafe the default (#846)
a51c7df 💥 Drop pure versions, rename others (#833)
423e6d6 💥 Drop main entry point (#832)
a766210 💥 Move rng as first argument (#831)

Features

5c3c618 ⚡️ Drop useless array access in mersenne (#894)
34406f8 ✨ Add jump to congruential32 (#882)
b0262ca ⚡️ Faster uniformInt on large ranges (#869)
bd76869 ✨ Add purify utils
c651a0d ⚡ Slightly faster UniformArrayIntDistribution (#763)
7a07f86 ⚡ Slightly faster UniformBigIntDistribution (#764)
bd0d721 ⚡ Slightly faster UniformIntDistribution

Fixes

abe1b84 📝 Replace Twitter share badge with Bluesky in README (#900)
950e5ca 👷 Rework formatting of bundle report (#903)
484a59e 🔨 Add Claude settings with pnpm hooks and post-edit automation (#896)
dbe3a36 👷 Add OTP authentication to npm package publishing (#897)
59e7eea 👷 Add main branch bundle comparison to size reports (#890)
b2c6036 📝 Extract comparison section from README into separate document (#880)
10da9d1 🔧 Pinning Claude action to 1.0.51 (#888)
e90191a 🔧 Restrict Claude Code to dubzzz (#887)
bc2ba70 🔧 Add Claude Code GitHub Actions workflow (#886)
2249bc7 📝 Fix GitHub Actions badge in README (#881)
33052bc 🚚 Rename generator files to match generator function names (#876)
b44c246 🔥 Drop useless .npmignore (#878)
6781423 🔥 Drop unwantingly committed file (#877)
7467833 👷 Add diff column to package size comment tables (#875)
f3a95ea 👷 Merge per-file size tables into single combined table in PR comment (#874)
797bfbd 👷 Add package size reporting on PRs with 🗜️ emoji (#873)
958aba8 ✅ Publish coverage (#872)
969beaf ✅ Only check on last LTS and latest (#871)
38c3eb8 ✅ Add checks of bundle integrity against Node 12.17 (#870)
e53608f 👷 Send bench results on PR (#860)
00ebe83 ✅ Rework bench on distributions (#859)
762eb02 🔧 Explicitely list all exports (#856)
7d19082 👷 End CI jobs with a terminal job (#855)
f5770fb ✅ Benchmark checks in CI (#853)
0787104 ✅ Collocate tests with sources (#852)
aedace9 ♻️ Consider full bigint support (#851)
5cfb9c8 🔧 Switch to "isolatedDeclarations" (#850)
c0cdfaa ✅ Replace assert by expect (#849)
2cfdaad 🔧 Modern config for TypeScript (#847)
eb9a7e8 👷 Setup publint in CI (#844)
0b4affc 👷 Add package preview in CI (#843)
c1dd44f 🔧 Simpler exports in package.json (#840)
366172b 👷 Check no dedupe in CI (#842)
c11afd9 🔧 Drop useless deps (#841)
56d4098 👷 Drop legacy build scripts (#836)
9a9ed2e 👷 Adopt longer term build script (#834)
3745f0f ✅ Cover more versions of node (#829)
5f95bf1 📝 Drop Snyk badge (#830)
fc6e12e 👷 Strictly lock deps in GH Actions (#828)
8eccd3b 👷 Run tests against self (no build) (#827)
f87f382 👷 Move to rolldown (#824)
be1bac5 ♻️ Rewrite without static (#825)
f2fde1c 👷 Move to oxfmt (#823)
3ff5ccb 👷 Move to pnpm (#821)
3785897 ✅ Move to Vitest (#820)
43afceb ✅ Add legacy checks for jump (#762)
2571c6d ✅ Add legacy checks for array distributions (#761)
cccf4c4 ✅ Add legacy checks for other generators (#760)