@higher.archi/boe 1.0.3 → 1.0.5

package/src/qfacts/strategies/quasi-random.ts

@@ -0,0 +1,23 @@
+function halton(index: number, base: number): number {
+  let result = 0;
+  let f = 1 / base;
+  let i = index;
+  while (i > 0) {
+    result += f * (i % base);
+    i = Math.floor(i / base);
+    f /= base;
+  }
+  return result;
+}
+
+export function quasiRandomCollapse(amplitudes: Record<string, number>, index: number): string {
+  const roll = halton(index + 1, 2); // +1 to avoid halton(0) = 0
+
+  const keys = Object.keys(amplitudes);
+  let cumulative = 0;
+  for (const key of keys) {
+    cumulative += amplitudes[key];
+    if (roll < cumulative) return key;
+  }
+  return keys[keys.length - 1];
+}

package/src/qfacts/strategies/seeded.ts

@@ -0,0 +1,32 @@
+function createRng(seed: number): () => number {
+  let state = seed;
+  return () => {
+    state |= 0;
+    state = (state + 0x6d2b79f5) | 0;
+    let t = Math.imul(state ^ (state >>> 15), 1 | state);
+    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+function djb2Hash(str: string): number {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = ((hash << 5) + hash + str.charCodeAt(i)) | 0;
+  }
+  return hash >>> 0;
+}
+
+export function seededCollapse(amplitudes: Record<string, number>, seed: number, fieldName: string): string {
+  const fieldSeed = (seed ^ djb2Hash(fieldName)) >>> 0;
+  const rng = createRng(fieldSeed);
+  const roll = rng();
+
+  const keys = Object.keys(amplitudes);
+  let cumulative = 0;
+  for (const key of keys) {
+    cumulative += amplitudes[key];
+    if (roll < cumulative) return key;
+  }
+  return keys[keys.length - 1];
+}

package/src/qfacts/types.ts

@@ -0,0 +1,44 @@
+import type { FactInput } from '../core';
+
+export type AmplitudeValue = number | `${number}%`;
+
+export type Superposition = {
+  state: 'superposition';
+  amplitudes: Record<string, number>;
+};
+
+export type QValue = any | Superposition;
+
+export type QFactInput = {
+  id?: string;
+  type: string;
+  data: Record<string, QValue>;
+};
+
+export type CollapseStrategy = 'seeded' | 'crypto' | 'deterministic' | 'quasi-random';
+
+export type CollapseOptions = {
+  strategy?: CollapseStrategy;
+  seed?: number;
+  coerce?: boolean;
+};
+
+export type CollapseRecord = {
+  field: string;
+  selectedValue: any;
+  amplitudes: Record<string, number>;
+  strategy: CollapseStrategy;
+  seed?: number;
+};
+
+export type CollapsedFact = {
+  fact: FactInput;
+  collapseLog: CollapseRecord[];
+};
+
+export type SimulationResult<T = any> = {
+  runs: number;
+  results: T[];
+  collapseHistory: CollapseRecord[][];
+  strategy: CollapseStrategy;
+};