@williamthorsen/toolbelt.numbers 4.3.7 → 5.0.0

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 All notable changes to this project will be documented in this file.
 
+## 5.0.0 — 2026-08-08
+
+### Features
+
+- 🚨 **Breaking:** Spawn seeded number generator of same subclass (#84)
+
+  A seeded generator spawned from a subclass now matches that subclass, so `IntSeededRng.withSeed` supplies the wrapped function integers where it previously supplied floats. Callers relying on values derived through that path must re-baseline. A detached reference such as `const { withSeed } = SeededRng` now throws.
+
+- Use underscore separator at 4 digits or more
+
+  Changes the `unicorn/numeric-separators-style` rule config so that separators are consistently used in base 10 numbers, instead of exempting numbers of 5 digits or less.
+
+### Refactoring
+
+- Fixes violations surfaced by newly active lint rules (#84)
+- Fix slug punctuation and require safe integers (#86)
+
+  - Fixes an issue where the use of certain letters as the slug separator in `slugify` would leave punctuation marks in the result.
+  - Time-unit conversions, scaling range bounds, normal-distribution interval counts, and array indices in object paths now reject values too large to represent exactly instead of silently losing precision.
+  - Seeded number generators now produce distinct sequences for seeds at or beyond 2^53, where adjacent seeds previously collapsed onto nearly identical output. A seed of that size saved before this release no longer reproduces the same output.
+
+- Fix lint
+
+### Tooling
+
+- Migrate Vitest configs to the nmr projects model (#73)
+
+  Packages no longer need to declare their own Vitest config. Test suites are now selected by a test file's name suffix rather than by choosing a config file: `*.app.test.ts` and `*.int.test.ts` route to the app and integration suites, and everything else runs as a unit test. Local development is now declared to require Node 24.16 or later.
+
+- Adopt the mechanical-syntax deferred unicorn rules (#82)
+
+  Promotes ten deferred lint rules from warnings to errors and fixes the issues surfaced by those rules. One published behavior changes as well: Converting a Map to a plain object no longer drops an entry keyed `__proto__`.
+
+- Adopt four deferred unicorn lint rules (#90)
+
+  The strict-lint severity cap of four lint rules has been raised to error: `no-array-from-fill`, `no-return-array-push`, `no-unreadable-array-destructuring`, and `prefer-math-constants`.
+
+- Use identical compiler settings for all packages (#105)
+
+  All packages now have identical compiler settings, using the settings from the `@williamthorsen/tsconfig` base config without modification.
+
+### Dependencies
+
+- Upgrade all deps to latest version
+
+## 4.3.8 — 2026-07-27
+
+### Tooling
+
+- Normalize Vitest, and lint configs
+
+### Documentation
+
+- Change license to ISC
+
 ## 4.3.7 — 2026-07-24
 
 ### Tooling

package/LICENSE

@@ -1,7 +1,7 @@
-UNLICENSED SOFTWARE
+ISC License
 
-Copyright (c) 2023-2025 William Thorsen
+Copyright (c) 2023-2026 William Thorsen
 
-All rights reserved.
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
 
-This software is provided 'as-is', without any express or implied warranty. No rights are granted to use, copy, modify, or distribute this software for any purpose. For full legal details, consult a legal expert. This notice may not be removed or altered from any distribution.
+The software is provided "as is" and the author disclaims all warranties with regard to this software including all implied warranties of merchantability and fitness. In no event shall the author be liable for any special, direct, indirect, or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.

package/README.md

@@ -2,7 +2,19 @@
 
 Utility functions for working with numbers.
 
-<!-- section:release-notes --><!-- /section:release-notes -->
+<!-- section:release-notes -->
+## Release notes — v5.0.0 (2026-08-08)
+
+### Features
+
+- 🚨 **Breaking:** Spawn seeded number generator of same subclass (#84)
+
+  A seeded generator spawned from a subclass now matches that subclass, so `IntSeededRng.withSeed` supplies the wrapped function integers where it previously supplied floats. Callers relying on values derived through that path must re-baseline. A detached reference such as `const { withSeed } = SeededRng` now throws.
+
+- Use underscore separator at 4 digits or more
+
+  Changes the `unicorn/numeric-separators-style` rule config so that separators are consistently used in base 10 numbers, instead of exempting numbers of 5 digits or less.
+<!-- /section:release-notes -->
 
 ## Installation
 

package/dist/esm/2-draft/clamp.js

@@ -2,7 +2,7 @@ export function clamp(value, { min, max }) {
     if (min !== undefined && max !== undefined && min > max) {
         throw new RangeError('Minimum value cannot be greater than maximum value');
     }
-    const minValue = min ?? Number.NEGATIVE_INFINITY;
-    const maxValue = max ?? Number.POSITIVE_INFINITY;
+    const minValue = min ?? -Infinity;
+    const maxValue = max ?? Infinity;
     return Math.max(minValue, Math.min(maxValue, value));
 }

package/dist/esm/3-candidate/scale.js

@@ -7,12 +7,12 @@ export function scale(value, toRange, fromRange = {}) {
     return toMin + (offset * toMagnitude) / fromMagnitude;
 }
 export function scaleInt(value, toRange, fromRange = {}) {
-    if (isNonInteger(toRange.min) || isNonInteger(toRange.max)) {
-        throw new RangeError('Invalid range: min and max must be integers.');
+    if (isNotSafeInteger(toRange.min) || isNotSafeInteger(toRange.max)) {
+        throw new RangeError('Invalid range: min and max must be safe integers.');
     }
     const scaled = scale(value, toRange, fromRange);
     return Math.round(scaled);
 }
-function isNonInteger(num) {
-    return num !== undefined && !Number.isInteger(num);
+function isNotSafeInteger(num) {
+    return num !== undefined && !Number.isSafeInteger(num);
 }

package/dist/esm/3-candidate/seeded-rng.d.ts

@@ -3,6 +3,10 @@ export declare class SeededRng implements SeededGenerator {
     private _seed;
     private baseSeed;
     private nIncrements;
+    constructor(seed?: Seed);
+    get maxBase(): number;
+    get rng(): () => number;
+    get seed(): number;
     static evaluateSeed(seed?: Seed): number | undefined;
     static clone<T extends ThisConstructor<typeof SeededRng>>(this: T, seed: undefined, nIncrements?: number): undefined;
     static clone<T extends ThisConstructor<typeof SeededRng>>(this: T, seed: Seed, nIncrements?: number): This<T>;
@@ -12,10 +16,6 @@ export declare class SeededRng implements SeededGenerator {
     static spawn<T extends ThisConstructor<typeof SeededRng>>(this: T, seed: Seed): This<T>;
     static spawn<T extends ThisConstructor<typeof SeededRng>>(this: T, seed: Seed | undefined): This<T> | undefined;
     static withSeed<TOptions extends object, R>(fn: (options?: OptionsWithSeed<TOptions> | OptionsWithSeed<EmptyObject>) => R, seed: Seed | undefined): (options?: TOptions) => R;
-    constructor(seed?: Seed);
-    get maxBase(): number;
-    get rng(): () => number;
-    get seed(): number;
     clone<T extends SeededRng>(this: T, nIncrements?: number): T;
     increment(nIncrements?: number): this;
     next(n?: number): number;

package/dist/esm/3-candidate/seeded-rng.js

@@ -8,6 +8,18 @@ export class SeededRng {
     _seed = 0;
     baseSeed = 0;
     nIncrements = 0;
+    constructor(seed) {
+        this.initializeSeeds(SeededRng.evaluateSeed(seed));
+    }
+    get maxBase() {
+        return IntegerSeed.max;
+    }
+    get rng() {
+        return () => this.next();
+    }
+    get seed() {
+        return this._seed;
+    }
     static evaluateSeed(seed) {
         return evaluateSeed(seed);
     }
@@ -24,23 +36,11 @@ export class SeededRng {
         return seed === undefined ? undefined : new this(seed);
     }
     static withSeed(fn, seed) {
-        const spawnedRng = SeededRng.spawn(seed);
+        const spawnedRng = this.spawn(seed);
         return function (options) {
             return fn({ ...options, seed: spawnedRng });
         };
     }
-    constructor(seed) {
-        this.initializeSeeds(SeededRng.evaluateSeed(seed));
-    }
-    get maxBase() {
-        return IntegerSeed.max;
-    }
-    get rng() {
-        return () => this.next();
-    }
-    get seed() {
-        return this._seed;
-    }
     clone(nIncrements = 0) {
         return new this.constructor(this._seed).increment(nIncrements);
     }

package/dist/esm/internal/IntegerSeed.js

@@ -12,11 +12,11 @@ export const IntegerSeed = {
 };
 function toIntegerSeed(value) {
     let integer = (() => {
-        if (Number.isInteger(value))
+        if (Number.isSafeInteger(value))
             return value;
         return Math.floor(getFakeMathRandom(value) * MAX_INTEGER);
     })();
-    integer = integer % MAX_INTEGER;
+    integer %= MAX_INTEGER;
     if (integer <= 0) {
         integer += MAX_INTEGER;
     }

package/dist/esm/internal/evaluateSeed.d.ts

@@ -1,7 +1,7 @@
 export declare function evaluateSeed(seed: Seed | undefined): number | undefined;
 export declare function checkIsRngLike(seed: Seed | undefined): seed is SeededGenerator;
 export interface SeededGenerator {
-    next(): number;
     seed: number;
+    next(): number;
 }
 export type Seed = number | SeededGenerator | (() => number);

package/dist/esm/internal/evaluateSeed.js

@@ -2,10 +2,10 @@ export function evaluateSeed(seed) {
     if (typeof seed === 'number') {
         return seed;
     }
-    else if (checkIsRngLike(seed)) {
+    if (checkIsRngLike(seed)) {
         return seed.next();
     }
-    else if (seed instanceof Function) {
+    if (typeof seed === 'function') {
         return seed();
     }
     return undefined;

package/dist/esm/internal/getFakeMathRandom.js

@@ -4,12 +4,12 @@ export function getFakeMathRandom(seed) {
     for (const char of strSeed) {
         const code = char.codePointAt(0) ?? 0;
         hash = (hash << 5) - hash + code;
-        hash = hash | 0;
+        hash |= 0;
     }
     hash += hash << 10;
     hash ^= hash >> 6;
     hash += hash << 3;
     hash ^= hash >> 11;
     hash += hash << 15;
-    return (hash & 0x7f_ff_ff_ff) / 0x7f_ff_ff_ff;
+    return (hash & 0x7fff_ffff) / 0x7fff_ffff;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/toolbelt.numbers",
-  "version": "4.3.7",
+  "version": "5.0.0",
   "description": "API",
   "keywords": [],
   "homepage": "https://github.com/williamthorsen/toolbelt/tree/main/packages/numbers#readme",
@@ -12,7 +12,7 @@
     "url": "git+https://github.com/williamthorsen/toolbelt.git",
     "directory": "packages/numbers"
   },
-  "license": "UNLICENSED",
+  "license": "ISC",
   "author": "William Thorsen <william@thorsen.dev> (https://github.com/williamthorsen)",
   "type": "module",
   "exports": {