@williamthorsen/toolbelt.numbers 5.0.0 → 6.0.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## 6.0.0 — 2026-08-12
+
+### Features
+
+- 🚨 **Breaking:** Rename get* functions by return kind and verb specificity (#119)
+
+  Renames thirteen functions across various packages to align with a consistent naming pattern.
+
+### Refactoring
+
+- Stop shipping test-only and dead support modules (#117)
+
+  Fixes an issue where `@williamthorsen/toolbelt.numbers`, `@williamthorsen/toolbelt.objects`, and `@williamthorsen/toolbelt.strings` each shipped a module that was never importable.
+
+- Align stray modules with layout and TypeScript conventions (#118)
+
+  Aligns all packages with code-layout and annotation conventions, ending a handful of long-standing exceptions. Documentation has been updated to make the conventions clear.
+
 ## 5.0.0 — 2026-08-08
 
 ### Features

package/README.md

@@ -3,17 +3,13 @@
 Utility functions for working with numbers.
 
 <!-- section:release-notes -->
-## Release notes — v5.0.0 (2026-08-08)
+## Release notes — v6.0.0 (2026-08-12)
 
 ### Features
 
-- 🚨 **Breaking:** Spawn seeded number generator of same subclass (#84)
+- 🚨 **Breaking:** Rename get* functions by return kind and verb specificity (#119)
 
-  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.
+  Renames thirteen functions across various packages to align with a consistent naming pattern.
 <!-- /section:release-notes -->
 
 ## Installation

package/dist/esm/1-proposed/makeRng.js

@@ -1,5 +1,5 @@
+import { computeFakeMathRandom } from "../internal/computeFakeMathRandom.js";
 import { evaluateSeed } from "../internal/evaluateSeed.js";
-import { getFakeMathRandom } from "../internal/getFakeMathRandom.js";
 export function makeRng(seed) {
     const inputSeed = evaluateSeed(seed);
     if (inputSeed === undefined) {
@@ -8,6 +8,6 @@ export function makeRng(seed) {
     let base = inputSeed;
     return function random() {
         base = (base + 1) % Number.MAX_SAFE_INTEGER;
-        return getFakeMathRandom(base);
+        return computeFakeMathRandom(base);
     };
 }

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

@@ -1,9 +1,9 @@
+import { computeFakeMathRandom } from "../internal/computeFakeMathRandom.js";
 import { evaluateSeed } from "../internal/evaluateSeed.js";
-import { getFakeMathRandom } from "../internal/getFakeMathRandom.js";
 import { scale } from "./scale.js";
 export function generateRandom(options = {}) {
     const { min = 0, max = 1 } = options;
     const seed = evaluateSeed(options.seed);
-    const randomNumber = seed === undefined ? Math.random() : getFakeMathRandom(seed);
+    const randomNumber = seed === undefined ? Math.random() : computeFakeMathRandom(seed);
     return scale(randomNumber, { min, max });
 }

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

@@ -1,5 +1,5 @@
+import { computeFakeMathRandom } from "../internal/computeFakeMathRandom.js";
 import { checkIsRngLike, evaluateSeed } from "../internal/evaluateSeed.js";
-import { getFakeMathRandom } from "../internal/getFakeMathRandom.js";
 import { IntegerSeed } from "../internal/IntegerSeed.js";
 import { wrapSum } from "../internal/wrapSum.js";
 import { pickInteger } from "./pickInteger.js";
@@ -69,7 +69,7 @@ export class SeededRng {
         return scaleInt(value, { min: 1, max: IntegerSeed.max }, { min: 1, max: this.maxBase });
     }
     generateValue() {
-        return getFakeMathRandom(this._seed);
+        return computeFakeMathRandom(this._seed);
     }
     initializeSeeds(baseSeed) {
         this.baseSeed = wrapSum(this.maxBase, IntegerSeed.toInt(baseSeed));
@@ -78,11 +78,11 @@ export class SeededRng {
 }
 export class IntSeededRng extends SeededRng {
     generateValue() {
-        return pickInteger({ min: 1, max: Number.MAX_SAFE_INTEGER, seed: getFakeMathRandom(this.seed) });
+        return pickInteger({ min: 1, max: Number.MAX_SAFE_INTEGER, seed: computeFakeMathRandom(this.seed) });
     }
 }
 export class Int32SeededRng extends SeededRng {
     generateValue() {
-        return pickInteger({ min: 1, max: 2 ** 32 - 1, seed: getFakeMathRandom(this.seed) });
+        return pickInteger({ min: 1, max: 2 ** 32 - 1, seed: computeFakeMathRandom(this.seed) });
     }
 }

package/dist/esm/internal/IntegerSeed.js

@@ -1,4 +1,4 @@
-import { getFakeMathRandom } from "./getFakeMathRandom.js";
+import { computeFakeMathRandom } from "./computeFakeMathRandom.js";
 const MAX_INTEGER = 2 ** 31 - 1;
 export const IntegerSeed = {
     max: MAX_INTEGER,
@@ -14,7 +14,7 @@ function toIntegerSeed(value) {
     let integer = (() => {
         if (Number.isSafeInteger(value))
             return value;
-        return Math.floor(getFakeMathRandom(value) * MAX_INTEGER);
+        return Math.floor(computeFakeMathRandom(value) * MAX_INTEGER);
     })();
     integer %= MAX_INTEGER;
     if (integer <= 0) {

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

@@ -0,0 +1 @@
+export declare function computeFakeMathRandom(seed: number): number;

package/dist/esm/internal/{getFakeMathRandom.js → computeFakeMathRandom.js}

@@ -1,4 +1,4 @@
-export function getFakeMathRandom(seed) {
+export function computeFakeMathRandom(seed) {
     const strSeed = seed.toString().replace('.', '');
     let hash = 0;
     for (const char of strSeed) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/toolbelt.numbers",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "API",
   "keywords": [],
   "homepage": "https://github.com/williamthorsen/toolbelt/tree/main/packages/numbers#readme",

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

@@ -1,2 +0,0 @@
-export type FunctionOrValue<T> = T | (() => T);
-export declare function evaluate<T>(input: FunctionOrValue<T>): T;

package/dist/esm/internal/evaluate.js

@@ -1,6 +0,0 @@
-function isFunction(value) {
-    return typeof value === 'function';
-}
-export function evaluate(input) {
-    return isFunction(input) ? input() : input;
-}

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

@@ -1 +0,0 @@
-export declare function getFakeMathRandom(seed: number): number;