@raindrops-on-roses/number-numbers-from-seed 0.0.1

package/README.md

@@ -0,0 +1,117 @@
+# @raindrops-on-roses/numbers-from-seed
+
+`numbersFromSeed` utility from [raindrops-on-roses](https://www.npmjs.com/package/raindrops-on-roses).
+
+Generates a deterministic array of pseudo-random numbers from a seed. Using the same seed and options always produces the same sequence.
+
+## Install
+
+```sh
+npm install @raindrops-on-roses/numbers-from-seed
+```
+
+## Usage
+
+```ts
+import { numbersFromSeed } from "@raindrops-on-roses/numbers-from-seed";
+
+numbersFromSeed({
+  count: 5,
+  seed: "example",
+});
+// Deterministic sequence for this seed and configuration
+```
+
+You can control the generated range, rounding behavior, and sort direction:
+
+```ts
+numbersFromSeed({
+  count: 5,
+  seed: "example",
+  trend: "up",
+  multiplicator: 100,
+});
+// Returns the same sorted sequence every time
+
+numbersFromSeed({
+  count: 3,
+  seed: 42,
+  multiplicator: 10,
+  rounded: false,
+});
+// Returns deterministic decimal values between 0 and 10
+```
+
+## API
+
+```ts
+numbersFromSeed({
+  count,
+  seed,
+  trend,
+  multiplicator,
+  rounded,
+}: {
+  count: number;
+  seed?: string | number;
+  trend?: "up" | "down" | null;
+  multiplicator?: number;
+  rounded?: boolean;
+}): number[]
+```
+
+### Parameters
+
+- `count` - Number of values to generate.
+- `seed` - Seed used to generate the deterministic sequence.
+- `trend` - Optional sorting direction. Use `"up"` for ascending order, `"down"` for descending order, or `null` to keep the generated order.
+- `multiplicator` - Multiplier applied to each generated value. Defaults to `1`.
+- `rounded` - Whether generated values should be rounded to integers. Defaults to `true`.
+
+### Returns
+
+An array of deterministic pseudo-random numbers.
+
+Values are generated between `0` and `multiplicator`, then optionally rounded and sorted.
+
+## Deterministic output
+
+The same seed and configuration always produce the same sequence:
+
+```ts
+const first = numbersFromSeed({
+  count: 5,
+  seed: "example",
+});
+
+const second = numbersFromSeed({
+  count: 5,
+  seed: "example",
+});
+
+// first and second contain the same values in the same order
+```
+
+## With the complete library
+
+You can also install the complete `raindrops-on-roses` package:
+
+```sh
+npm install raindrops-on-roses
+```
+
+and import `numbersFromSeed` from the umbrella package:
+
+```ts
+import { numbersFromSeed } from "raindrops-on-roses";
+```
+
+## Lore
+
+> All the flowers of all the tomorrows are in the seeds of today.
+
+(Native American proverb)
+
+## Repository
+
+[graphieros/raindrops-on-roses](https://github.com/graphieros/raindrops-on-roses)

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Generates a deterministic array of pseudo-random numbers from a seed.
+ *
+ * ---
+ *
+ * Using the same seed and options produces the same sequence.
+ * Values are generated between `0` and `multiplicator`, and can optionally
+ * be rounded or sorted.
+ *
+ * @param count - Number of values to generate.
+ * @param seed - Seed used to generate the deterministic sequence.
+ * @param trend - Optional sorting direction for the generated values.
+ * @param multiplicator - Multiplier applied to each generated value. Defaults to `1`.
+ * @param rounded - Whether generated values should be rounded to integers. Defaults to `true`.
+ * @returns An array of numbers
+ *
+ * @example
+ * ```ts
+ * const numbers = numbersFromSeed({
+ *   count: 5,
+ *   seed: "example",
+ *   trend: "up",
+ *   multiplicator: 100,
+ * });
+ *
+ * // Returns the same sequence every time for this seed and config.
+ * ```
+ *
+ * ---
+ *
+ * Lore: All the flowers of all the tomorrows are in the seeds of today (Native american proverb)
+ */
+export declare function numbersFromSeed({ count, seed, trend, multiplicator, rounded, }: {
+    count: number;
+    seed?: string | number;
+    trend?: "up" | "down" | null;
+    multiplicator?: number;
+    rounded?: boolean;
+}): number[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,IAAI,EACJ,KAAY,EACZ,aAAiB,EACjB,OAAc,GACf,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,EAAE,CAwBX"}

package/dist/index.js

@@ -0,0 +1,17 @@
+//#region src/index.ts
+function e({ count: e, seed: t, trend: n = null, multiplicator: r = 1, rounded: i = !0 }) {
+	let a = String(t), o = 2166136261;
+	for (let e = 0; e < a.length; e += 1) o ^= a.charCodeAt(e), o = Math.imul(o, 16777619);
+	let s = o >>> 0, c = Array.from({ length: e }, () => {
+		s += 1831565813;
+		let e = s;
+		e = Math.imul(e ^ e >>> 15, e | 1), e ^= e + Math.imul(e ^ e >>> 7, e | 61);
+		let t = ((e ^ e >>> 14) >>> 0) / 4294967296 * r;
+		return i ? Math.round(t) : t;
+	});
+	return n === "up" ? c.sort((e, t) => e - t) : n === "down" ? c.sort((e, t) => t - e) : c;
+}
+//#endregion
+export { e as numbersFromSeed };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Generates a deterministic array of pseudo-random numbers from a seed.\n *\n * ---\n *\n * Using the same seed and options produces the same sequence.\n * Values are generated between `0` and `multiplicator`, and can optionally\n * be rounded or sorted.\n *\n * @param count - Number of values to generate.\n * @param seed - Seed used to generate the deterministic sequence.\n * @param trend - Optional sorting direction for the generated values.\n * @param multiplicator - Multiplier applied to each generated value. Defaults to `1`.\n * @param rounded - Whether generated values should be rounded to integers. Defaults to `true`.\n * @returns An array of numbers\n *\n * @example\n * ```ts\n * const numbers = numbersFromSeed({\n *   count: 5,\n *   seed: \"example\",\n *   trend: \"up\",\n *   multiplicator: 100,\n * });\n *\n * // Returns the same sequence every time for this seed and config.\n * ```\n *\n * ---\n *\n * Lore: All the flowers of all the tomorrows are in the seeds of today (Native american proverb)\n */\nexport function numbersFromSeed({\n  count,\n  seed,\n  trend = null,\n  multiplicator = 1,\n  rounded = true,\n}: {\n  count: number;\n  seed?: string | number;\n  trend?: \"up\" | \"down\" | null;\n  multiplicator?: number;\n  rounded?: boolean;\n}): number[] {\n  const seedString = String(seed);\n  let hash = 2166136261;\n  for (let i = 0; i < seedString.length; i += 1) {\n    hash ^= seedString.charCodeAt(i);\n    hash = Math.imul(hash, 16777619);\n  }\n  let state = hash >>> 0;\n  const random = () => {\n    state += 0x6d2b79f5;\n    let t = state;\n    t = Math.imul(t ^ (t >>> 15), t | 1);\n    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);\n    const res = (((t ^ (t >>> 14)) >>> 0) / 4294967296) * multiplicator;\n    return rounded ? Math.round(res) : res;\n  };\n  const numbers = Array.from({ length: count }, random);\n  if (trend === \"up\") {\n    return numbers.sort((a, b) => a - b);\n  }\n  if (trend === \"down\") {\n    return numbers.sort((a, b) => b - a);\n  }\n  return numbers;\n}\n"],"mappings":";AAgCA,SAAgB,EAAgB,EAC9B,UACA,SACA,WAAQ,MACR,mBAAgB,GAChB,aAAU,MAOC;CACX,IAAM,IAAa,OAAO,CAAI,GAC1B,IAAO;CACX,KAAK,IAAI,IAAI,GAAG,IAAI,EAAW,QAAQ,KAAK,GAE1C,AADA,KAAQ,EAAW,WAAW,CAAC,GAC/B,IAAO,KAAK,KAAK,GAAM,QAAQ;CAEjC,IAAI,IAAQ,MAAS,GASf,IAAU,MAAM,KAAK,EAAE,QAAQ,EAAM,SARtB;EACnB,KAAS;EACT,IAAI,IAAI;EAER,AADA,IAAI,KAAK,KAAK,IAAK,MAAM,IAAK,IAAI,CAAC,GACnC,KAAK,IAAI,KAAK,KAAK,IAAK,MAAM,GAAI,IAAI,EAAE;EACxC,IAAM,MAAS,IAAK,MAAM,QAAS,KAAK,aAAc;EACtD,OAAO,IAAU,KAAK,MAAM,CAAG,IAAI;CACrC,CACoD;CAOpD,OANI,MAAU,OACL,EAAQ,MAAM,GAAG,MAAM,IAAI,CAAC,IAEjC,MAAU,SACL,EAAQ,MAAM,GAAG,MAAM,IAAI,CAAC,IAE9B;AACT"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@raindrops-on-roses/number-numbers-from-seed",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/graphieros/raindrops-on-roses.git",
+    "directory": "packages/number-numbers-from-seed"
+  }
+}