@venn-lang/data 0.1.0

package/src/rng/shared-rng.ts

@@ -0,0 +1,15 @@
+import { mulberry32 } from "./mulberry32.js";
+import type { Rng } from "./rng.types.js";
+
+/** The fixed seed. A constant seed is what makes every generated value reproducible. */
+const SEED = 1;
+
+let shared: Rng = mulberry32(SEED);
+
+/** The module-level deterministic PRNG shared by every generator in this package. */
+export const rng: Rng = () => shared();
+
+/** Reset the shared PRNG to its seed so the same stream can be drawn again. Used by tests. */
+export function resetRng(): void {
+  shared = mulberry32(SEED);
+}

package/src/rng/shuffle.ts

@@ -0,0 +1,17 @@
+import type { Rng } from "./rng.types.js";
+
+/**
+ * Fisher-Yates shuffle driven by the given PRNG.
+ *
+ * @returns A new array holding the same elements in a new order. `items` is untouched.
+ */
+export function shuffleWith(items: readonly unknown[], rng: Rng): unknown[] {
+  const out = [...items];
+  for (let i = out.length - 1; i > 0; i -= 1) {
+    const j = Math.floor(rng() * (i + 1));
+    const tmp = out[i];
+    out[i] = out[j];
+    out[j] = tmp;
+  }
+  return out;
+}

package/src/types.ts

@@ -0,0 +1,14 @@
+import { type TypeSpec, t } from "@venn-lang/types";
+
+/**
+ * The named types `@venn-lang/data` publishes to scripts, keyed by their bare name.
+ *
+ * Hand-mirrored from `csv/csv.types.ts`: the two must agree, so change them together.
+ */
+export const dataTypeDefs: Readonly<Record<string, TypeSpec>> = {
+  /**
+   * One parsed CSV record. The keys come from the file's header line, so they
+   * cannot be named here. Only the cell type is knowable, and it is always a string.
+   */
+  Row: t.map(t.string),
+};