@bendyline/squisq 0.1.2 → 1.0.1

package/dist/chunk-3E5F2XMR.js

@@ -0,0 +1,129 @@
+// src/timing/narrationTiming.ts
+var NUMBER_SPEAKING_MULTIPLIER = 1.3;
+var COMMA_PAUSE_PENALTY = 0.3;
+var DEFAULT_WORDS_PER_SECOND = 2.5;
+function estimateSpokenWordCount(token) {
+  const cleaned = token.replace(/,/g, "");
+  const num = parseFloat(cleaned);
+  if (isNaN(num) || !isFinite(num)) {
+    return 1;
+  }
+  return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;
+}
+function estimateNumberWordCount(cleaned, num) {
+  if (cleaned.includes(".")) {
+    const [whole, decimal] = cleaned.split(".");
+    const wholeNum = parseFloat(whole) || 0;
+    return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;
+  }
+  const absNum = Math.abs(num);
+  let words = num < 0 ? 1 : 0;
+  if (absNum === 0) return 1;
+  if (absNum >= 1e3 && absNum <= 2099 && Number.isInteger(absNum)) {
+    const yearStr = absNum.toString();
+    if (yearStr.length === 4) {
+      const firstTwo = parseInt(yearStr.slice(0, 2));
+      const lastTwo = parseInt(yearStr.slice(2));
+      if (firstTwo >= 10 && firstTwo <= 19) {
+        words += 1;
+      } else if (firstTwo >= 20 && firstTwo <= 99) {
+        words += firstTwo % 10 === 0 ? 1 : 2;
+      } else {
+        words += 2;
+      }
+      if (lastTwo === 0) {
+        if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {
+          words += 1;
+        }
+      } else if (lastTwo >= 1 && lastTwo <= 9) {
+        words += 2;
+      } else if (lastTwo >= 10 && lastTwo <= 19) {
+        words += 1;
+      } else {
+        words += lastTwo % 10 === 0 ? 1 : 2;
+      }
+      return Math.max(words, 2);
+    }
+  }
+  let remaining = absNum;
+  if (remaining >= 1e9) {
+    const billions = Math.floor(remaining / 1e9);
+    words += estimateNumberWordCount(String(billions), billions);
+    words += 1;
+    remaining %= 1e9;
+  }
+  if (remaining >= 1e6) {
+    const millions = Math.floor(remaining / 1e6);
+    words += estimateNumberWordCount(String(millions), millions);
+    words += 1;
+    remaining %= 1e6;
+  }
+  if (remaining >= 1e3) {
+    const thousands = Math.floor(remaining / 1e3);
+    words += estimateNumberWordCount(String(thousands), thousands);
+    words += 1;
+    remaining %= 1e3;
+  }
+  if (remaining >= 100) {
+    words += 2;
+    remaining %= 100;
+  }
+  if (remaining >= 1) {
+    if (remaining >= 20) {
+      words += remaining % 10 === 0 ? 1 : 2;
+    } else {
+      words += 1;
+    }
+  }
+  return Math.max(words, 1);
+}
+function countSpokenWords(text) {
+  const tokens = text.split(/\s+/).filter((w) => w.length > 0);
+  let count = 0;
+  for (const token of tokens) {
+    const stripped = token.replace(/^[.,!?;:'"()[\]{}]+|[.,!?;:'"()[\]{}]+$/g, "");
+    count += estimateSpokenWordCount(stripped);
+    let punctuationCommaCount = 0;
+    for (let i = 0; i < token.length; i++) {
+      if (token[i] === ",") {
+        const prev = i > 0 ? token[i - 1] : "";
+        const next = i < token.length - 1 ? token[i + 1] : "";
+        const prevIsDigit = prev >= "0" && prev <= "9";
+        const nextIsDigit = next >= "0" && next <= "9";
+        if (!(prevIsDigit && nextIsDigit)) {
+          punctuationCommaCount++;
+        }
+      }
+    }
+    count += punctuationCommaCount * COMMA_PAUSE_PENALTY;
+  }
+  return count;
+}
+function estimateTimeFromText(text, charOffset, totalDuration) {
+  const textBefore = text.slice(0, charOffset);
+  const spokenWordsBefore = countSpokenWords(textBefore);
+  const totalSpokenWords = countSpokenWords(text);
+  if (totalSpokenWords === 0) return 0;
+  return spokenWordsBefore / totalSpokenWords * totalDuration;
+}
+function calculatePrefixDuration(prefix, wordsPerSecond = DEFAULT_WORDS_PER_SECOND) {
+  if (!prefix) return 0;
+  const words = prefix.split(/\s+/).filter((w) => w.length > 0);
+  const newlineCount = (prefix.match(/\n\n/g) || []).length;
+  const pauseTime = newlineCount * 0.5;
+  return words.length / wordsPerSecond + pauseTime;
+}
+function estimateNarrationDuration(text, wordsPerSecond = DEFAULT_WORDS_PER_SECOND) {
+  const spokenWords = countSpokenWords(text);
+  return spokenWords / wordsPerSecond;
+}
+
+export {
+  DEFAULT_WORDS_PER_SECOND,
+  estimateSpokenWordCount,
+  countSpokenWords,
+  estimateTimeFromText,
+  calculatePrefixDuration,
+  estimateNarrationDuration
+};
+//# sourceMappingURL=chunk-3E5F2XMR.js.map

package/dist/chunk-3E5F2XMR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timing/narrationTiming.ts"],"sourcesContent":["/**\n * Narration timing estimation.\n *\n * Estimates how long text takes to speak aloud, accounting for:\n * - Numbers spoken as multiple words (e.g., \"1910\" → \"nineteen ten\")\n * - Pauses at commas\n * - Year pronunciation conventions (1000–2099)\n *\n * Ported from qualla-internal's AudioTiming.ts (pure functions, no Node.js deps).\n */\n\n/** Numbers are spoken more slowly than regular words (1.3× multiplier). */\nconst NUMBER_SPEAKING_MULTIPLIER = 1.3;\n\n/** Comma pause in \"word equivalents\" — speakers pause ~0.3 words at commas. */\nconst COMMA_PAUSE_PENALTY = 0.3;\n\n/** Default speaking rate in words per second (~150 WPM). */\nexport const DEFAULT_WORDS_PER_SECOND = 2.5;\n\n/**\n * Estimate how many \"spoken word equivalents\" a single token represents.\n * Numbers get expanded (e.g., \"175,000\" → ~5 words × 1.3 multiplier).\n */\nexport function estimateSpokenWordCount(token: string): number {\n  const cleaned = token.replace(/,/g, '');\n  const num = parseFloat(cleaned);\n\n  if (isNaN(num) || !isFinite(num)) {\n    return 1; // Not a number — count as 1 word\n  }\n\n  return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;\n}\n\n/**\n * Raw word count for a number (before the speaking multiplier).\n */\nfunction estimateNumberWordCount(cleaned: string, num: number): number {\n  // Handle decimals: \"3.14\" → words(\"3\") + \"point\" + 2 digits\n  if (cleaned.includes('.')) {\n    const [whole, decimal] = cleaned.split('.');\n    const wholeNum = parseFloat(whole) || 0;\n    return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;\n  }\n\n  const absNum = Math.abs(num);\n  let words = num < 0 ? 1 : 0; // \"negative\" / \"minus\"\n\n  if (absNum === 0) return 1; // \"zero\"\n\n  // Years (1000–2099) are spoken as two two-digit groups:\n  // \"1910\" → \"nineteen ten\", \"2024\" → \"twenty twenty-four\"\n  if (absNum >= 1000 && absNum <= 2099 && Number.isInteger(absNum)) {\n    const yearStr = absNum.toString();\n    if (yearStr.length === 4) {\n      const firstTwo = parseInt(yearStr.slice(0, 2));\n      const lastTwo = parseInt(yearStr.slice(2));\n\n      // First part\n      if (firstTwo >= 10 && firstTwo <= 19) {\n        words += 1;\n      } else if (firstTwo >= 20 && firstTwo <= 99) {\n        words += firstTwo % 10 === 0 ? 1 : 2;\n      } else {\n        words += 2; // \"two thousand\"\n      }\n\n      // Second part\n      if (lastTwo === 0) {\n        if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {\n          words += 1; // \"hundred\"\n        }\n      } else if (lastTwo >= 1 && lastTwo <= 9) {\n        words += 2; // \"oh five\"\n      } else if (lastTwo >= 10 && lastTwo <= 19) {\n        words += 1;\n      } else {\n        words += lastTwo % 10 === 0 ? 1 : 2;\n      }\n\n      return Math.max(words, 2);\n    }\n  }\n\n  // General number handling — each magnitude group adds words\n  let remaining = absNum;\n\n  if (remaining >= 1_000_000_000) {\n    const billions = Math.floor(remaining / 1_000_000_000);\n    words += estimateNumberWordCount(String(billions), billions);\n    words += 1; // \"billion\"\n    remaining %= 1_000_000_000;\n  }\n\n  if (remaining >= 1_000_000) {\n    const millions = Math.floor(remaining / 1_000_000);\n    words += estimateNumberWordCount(String(millions), millions);\n    words += 1; // \"million\"\n    remaining %= 1_000_000;\n  }\n\n  if (remaining >= 1_000) {\n    const thousands = Math.floor(remaining / 1_000);\n    words += estimateNumberWordCount(String(thousands), thousands);\n    words += 1; // \"thousand\"\n    remaining %= 1_000;\n  }\n\n  if (remaining >= 100) {\n    words += 2; // digit + \"hundred\"\n    remaining %= 100;\n  }\n\n  if (remaining >= 1) {\n    if (remaining >= 20) {\n      words += remaining % 10 === 0 ? 1 : 2;\n    } else {\n      words += 1; // 1–19\n    }\n  }\n\n  return Math.max(words, 1);\n}\n\n/**\n * Count \"spoken word equivalents\" in a block of text,\n * expanding numbers and adding comma pauses.\n */\nexport function countSpokenWords(text: string): number {\n  const tokens = text.split(/\\s+/).filter((w) => w.length > 0);\n  let count = 0;\n\n  for (const token of tokens) {\n    // Strip punctuation only at token boundaries so internal punctuation\n    // (e.g., decimals like \"3.14\" or digit-grouping commas \"1,000\") is preserved.\n    const stripped = token.replace(/^[.,!?;:'\"()[\\]{}]+|[.,!?;:'\"()[\\]{}]+$/g, '');\n    count += estimateSpokenWordCount(stripped);\n\n    // Count only punctuation commas for pauses: exclude digit-grouping commas\n    // (i.e., commas with digits on both sides, like in \"1,234\").\n    let punctuationCommaCount = 0;\n    for (let i = 0; i < token.length; i++) {\n      if (token[i] === ',') {\n        const prev = i > 0 ? token[i - 1] : '';\n        const next = i < token.length - 1 ? token[i + 1] : '';\n        const prevIsDigit = prev >= '0' && prev <= '9';\n        const nextIsDigit = next >= '0' && next <= '9';\n        if (!(prevIsDigit && nextIsDigit)) {\n          punctuationCommaCount++;\n        }\n      }\n    }\n    count += punctuationCommaCount * COMMA_PAUSE_PENALTY;\n  }\n\n  return count;\n}\n\n/**\n * Estimate audio time at a character offset using word-proportion mapping.\n *\n * Given the full source text and a character position, returns the\n * estimated time (in seconds) at which that position would be spoken.\n *\n * @param text - Full source text\n * @param charOffset - Character offset to estimate timing for\n * @param totalDuration - Total audio duration in seconds\n * @returns Estimated time in seconds\n */\nexport function estimateTimeFromText(\n  text: string,\n  charOffset: number,\n  totalDuration: number,\n): number {\n  const textBefore = text.slice(0, charOffset);\n  const spokenWordsBefore = countSpokenWords(textBefore);\n  const totalSpokenWords = countSpokenWords(text);\n\n  if (totalSpokenWords === 0) return 0;\n  return (spokenWordsBefore / totalSpokenWords) * totalDuration;\n}\n\n/**\n * Estimate how long a spoken prefix adds to audio duration.\n *\n * When audio includes a spoken title or header before the main content,\n * this calculates the extra duration to offset timing calculations.\n *\n * @param prefix - Prefix text (e.g., an article title spoken before the body)\n * @param wordsPerSecond - Speaking rate (default: 2.5)\n * @returns Estimated duration in seconds\n */\nexport function calculatePrefixDuration(\n  prefix: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  if (!prefix) return 0;\n\n  const words = prefix.split(/\\s+/).filter((w) => w.length > 0);\n  const newlineCount = (prefix.match(/\\n\\n/g) || []).length;\n  const pauseTime = newlineCount * 0.5;\n\n  return words.length / wordsPerSecond + pauseTime;\n}\n\n/**\n * Estimate narration duration for a block of text.\n *\n * @param text - The text to estimate\n * @param wordsPerSecond - Speaking rate (default: 2.5, i.e. ~150 WPM)\n * @returns Duration in seconds\n */\nexport function estimateNarrationDuration(\n  text: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  const spokenWords = countSpokenWords(text);\n  return spokenWords / wordsPerSecond;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-6YJPI6VI.js

@@ -0,0 +1,35 @@
+import {
+  DEFAULT_WORDS_PER_SECOND,
+  countSpokenWords
+} from "./chunk-3E5F2XMR.js";
+
+// src/timing/readingTime.ts
+var DEFAULT_READING_WPM = 200;
+function estimateReadingTime(text, options) {
+  const configuredWpm = options?.wordsPerMinute;
+  const wpm = typeof configuredWpm === "number" && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;
+  const words = text.split(/\s+/).filter((w) => w.length > 0).length;
+  const minutes = words / wpm;
+  return {
+    words,
+    minutes,
+    seconds: Math.round(minutes * 60)
+  };
+}
+function estimateNarrationTime(text, options) {
+  const providedWps = options?.wordsPerSecond;
+  const wps = typeof providedWps === "number" && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;
+  const spokenWords = countSpokenWords(text);
+  const totalSeconds = spokenWords / wps;
+  return {
+    spokenWords,
+    minutes: totalSeconds / 60,
+    seconds: Math.round(totalSeconds)
+  };
+}
+
+export {
+  estimateReadingTime,
+  estimateNarrationTime
+};
+//# sourceMappingURL=chunk-6YJPI6VI.js.map

package/dist/chunk-6YJPI6VI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timing/readingTime.ts"],"sourcesContent":["/**\n * Reading time estimation.\n *\n * Estimates how long it takes to read text silently vs. narrate it aloud.\n * Uses configurable words-per-minute rates.\n */\n\nimport { countSpokenWords, DEFAULT_WORDS_PER_SECOND } from './narrationTiming.js';\n\n/** Default silent reading rate (adults average ~200–250 WPM). */\nconst DEFAULT_READING_WPM = 200;\n\n/** Result of a reading-time estimate. */\nexport interface ReadingTimeEstimate {\n  /** Number of words (plain word count, not spoken equivalents). */\n  words: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for reading-time estimation. */\nexport interface ReadingTimeOptions {\n  /** Words per minute for silent reading (default: 200). */\n  wordsPerMinute?: number;\n}\n\n/**\n * Estimate silent reading time for a block of text.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Word count + time estimate\n */\nexport function estimateReadingTime(\n  text: string,\n  options?: ReadingTimeOptions,\n): ReadingTimeEstimate {\n  const configuredWpm = options?.wordsPerMinute;\n  const wpm =\n    typeof configuredWpm === 'number' && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;\n  const words = text.split(/\\s+/).filter((w) => w.length > 0).length;\n  const minutes = words / wpm;\n\n  return {\n    words,\n    minutes,\n    seconds: Math.round(minutes * 60),\n  };\n}\n\n/** Result of a narration-time estimate. */\nexport interface NarrationTimeEstimate {\n  /** Spoken word equivalents (numbers expanded, comma pauses added). */\n  spokenWords: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for narration-time estimation. */\nexport interface NarrationTimeOptions {\n  /** Words per second for narration (default: 2.5 ≈ 150 WPM). */\n  wordsPerSecond?: number;\n}\n\n/**\n * Estimate narration (spoken) time for a block of text.\n *\n * Unlike silent reading, this accounts for numbers being spoken as\n * multiple words and pauses at commas.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Spoken word equivalents + time estimate\n */\nexport function estimateNarrationTime(\n  text: string,\n  options?: NarrationTimeOptions,\n): NarrationTimeEstimate {\n  const providedWps = options?.wordsPerSecond;\n  const wps =\n    typeof providedWps === 'number' && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;\n  const spokenWords = countSpokenWords(text);\n  const totalSeconds = spokenWords / wps;\n\n  return {\n    spokenWords,\n    minutes: totalSeconds / 60,\n    seconds: Math.round(totalSeconds),\n  };\n}\n"],"mappings":";;;;;;AAUA,IAAM,sBAAsB;AAyBrB,SAAS,oBACd,MACA,SACqB;AACrB,QAAM,gBAAgB,SAAS;AAC/B,QAAM,MACJ,OAAO,kBAAkB,YAAY,gBAAgB,IAAI,gBAAgB;AAC3E,QAAM,QAAQ,KAAK,MAAM,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;AAC5D,QAAM,UAAU,QAAQ;AAExB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,SAAS,KAAK,MAAM,UAAU,EAAE;AAAA,EAClC;AACF;AA4BO,SAAS,sBACd,MACA,SACuB;AACvB,QAAM,cAAc,SAAS;AAC7B,QAAM,MACJ,OAAO,gBAAgB,YAAY,cAAc,IAAI,cAAc;AACrE,QAAM,cAAc,iBAAiB,IAAI;AACzC,QAAM,eAAe,cAAc;AAEnC,SAAO;AAAA,IACL;AAAA,IACA,SAAS,eAAe;AAAA,IACxB,SAAS,KAAK,MAAM,YAAY;AAAA,EAClC;AACF;","names":[]}

package/dist/chunk-FVTQSNR7.js

@@ -0,0 +1,100 @@
+// src/random/SeededRandom.ts
+var SeededRandom = class _SeededRandom {
+  constructor(seed) {
+    this.state = seed >>> 0;
+    if (this.state === 0) {
+      this.state = 3735928559;
+    }
+  }
+  /** Random float in [0, 1). */
+  next() {
+    let t = this.state += 1831565813;
+    t = Math.imul(t ^ t >>> 15, t | 1);
+    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  }
+  /** Random integer in [0, max). */
+  nextInt(max) {
+    return Math.floor(this.next() * max);
+  }
+  /** Random integer in [min, max). */
+  nextIntRange(min, max) {
+    return min + Math.floor(this.next() * (max - min));
+  }
+  /** Random boolean with given probability of `true` (default 0.5). */
+  nextBool(probability = 0.5) {
+    return this.next() < probability;
+  }
+  /** Pick a random element, or `undefined` if array is empty. */
+  pick(array) {
+    if (array.length === 0) return void 0;
+    return array[this.nextInt(array.length)];
+  }
+  /** Pick a random element; throws if empty. */
+  pickRequired(array) {
+    if (array.length === 0) {
+      throw new Error("Cannot pick from empty array");
+    }
+    return array[this.nextInt(array.length)];
+  }
+  /** Pick `count` unique random elements (fewer if array is smaller). */
+  pickMultiple(array, count) {
+    if (count >= array.length) {
+      return this.shuffle([...array]);
+    }
+    const result = [];
+    const available = [...array];
+    for (let i = 0; i < count && available.length > 0; i++) {
+      const index = this.nextInt(available.length);
+      result.push(available[index]);
+      available.splice(index, 1);
+    }
+    return result;
+  }
+  /** Fisher-Yates shuffle **in place**. Returns the same array. */
+  shuffle(array) {
+    for (let i = array.length - 1; i > 0; i--) {
+      const j = this.nextInt(i + 1);
+      [array[i], array[j]] = [array[j], array[i]];
+    }
+    return array;
+  }
+  /** Return a **new** shuffled copy. */
+  shuffled(array) {
+    return this.shuffle([...array]);
+  }
+  /** Weighted random selection. Returns `undefined` if items is empty. */
+  pickWeighted(items) {
+    if (items.length === 0) return void 0;
+    const totalWeight = items.reduce((sum, { weight }) => sum + weight, 0);
+    if (totalWeight <= 0) return items[0]?.item;
+    let random = this.next() * totalWeight;
+    for (const { item, weight } of items) {
+      random -= weight;
+      if (random <= 0) return item;
+    }
+    return items[items.length - 1]?.item;
+  }
+  /** Current internal state (for debugging / serialization). */
+  getState() {
+    return this.state;
+  }
+  /** Create an independent sub-stream keyed by a modifier. */
+  derive(modifier) {
+    const hash = typeof modifier === "string" ? hashString(modifier) : modifier >>> 0;
+    return new _SeededRandom(this.state ^ hash);
+  }
+};
+function hashString(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    hash = (hash << 5) + hash ^ str.charCodeAt(i);
+  }
+  return hash >>> 0;
+}
+
+export {
+  SeededRandom,
+  hashString
+};
+//# sourceMappingURL=chunk-FVTQSNR7.js.map

package/dist/chunk-FVTQSNR7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/random/SeededRandom.ts"],"sourcesContent":["/**\n * Seeded pseudo-random number generator (Mulberry32 algorithm).\n *\n * Provides deterministic, reproducible randomness from an integer seed.\n * Useful for consistent slideshow generation, shuffling, and selection.\n *\n * ```ts\n * const rng = new SeededRandom(42);\n * rng.next();            // 0.0–1.0\n * rng.nextInt(10);       // 0–9\n * rng.pick(['a', 'b']);  // 'a' or 'b'\n * ```\n */\nexport class SeededRandom {\n  private state: number;\n\n  constructor(seed: number) {\n    this.state = seed >>> 0;\n    if (this.state === 0) {\n      this.state = 0xdeadbeef;\n    }\n  }\n\n  /** Random float in [0, 1). */\n  next(): number {\n    let t = (this.state += 0x6d2b79f5);\n    t = Math.imul(t ^ (t >>> 15), t | 1);\n    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);\n    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n  }\n\n  /** Random integer in [0, max). */\n  nextInt(max: number): number {\n    return Math.floor(this.next() * max);\n  }\n\n  /** Random integer in [min, max). */\n  nextIntRange(min: number, max: number): number {\n    return min + Math.floor(this.next() * (max - min));\n  }\n\n  /** Random boolean with given probability of `true` (default 0.5). */\n  nextBool(probability: number = 0.5): boolean {\n    return this.next() < probability;\n  }\n\n  /** Pick a random element, or `undefined` if array is empty. */\n  pick<T>(array: T[]): T | undefined {\n    if (array.length === 0) return undefined;\n    return array[this.nextInt(array.length)];\n  }\n\n  /** Pick a random element; throws if empty. */\n  pickRequired<T>(array: T[]): T {\n    if (array.length === 0) {\n      throw new Error('Cannot pick from empty array');\n    }\n    return array[this.nextInt(array.length)];\n  }\n\n  /** Pick `count` unique random elements (fewer if array is smaller). */\n  pickMultiple<T>(array: T[], count: number): T[] {\n    if (count >= array.length) {\n      return this.shuffle([...array]);\n    }\n    const result: T[] = [];\n    const available = [...array];\n    for (let i = 0; i < count && available.length > 0; i++) {\n      const index = this.nextInt(available.length);\n      result.push(available[index]);\n      available.splice(index, 1);\n    }\n    return result;\n  }\n\n  /** Fisher-Yates shuffle **in place**. Returns the same array. */\n  shuffle<T>(array: T[]): T[] {\n    for (let i = array.length - 1; i > 0; i--) {\n      const j = this.nextInt(i + 1);\n      [array[i], array[j]] = [array[j], array[i]];\n    }\n    return array;\n  }\n\n  /** Return a **new** shuffled copy. */\n  shuffled<T>(array: readonly T[]): T[] {\n    return this.shuffle([...array]);\n  }\n\n  /** Weighted random selection. Returns `undefined` if items is empty. */\n  pickWeighted<T>(items: { item: T; weight: number }[]): T | undefined {\n    if (items.length === 0) return undefined;\n\n    const totalWeight = items.reduce((sum, { weight }) => sum + weight, 0);\n    if (totalWeight <= 0) return items[0]?.item;\n\n    let random = this.next() * totalWeight;\n    for (const { item, weight } of items) {\n      random -= weight;\n      if (random <= 0) return item;\n    }\n    return items[items.length - 1]?.item;\n  }\n\n  /** Current internal state (for debugging / serialization). */\n  getState(): number {\n    return this.state;\n  }\n\n  /** Create an independent sub-stream keyed by a modifier. */\n  derive(modifier: string | number): SeededRandom {\n    const hash = typeof modifier === 'string' ? hashString(modifier) : modifier >>> 0;\n    return new SeededRandom(this.state ^ hash);\n  }\n}\n\n/**\n * Simple string → 32-bit hash (djb2 algorithm).\n * Useful for turning a document ID into a numeric seed.\n */\nexport function hashString(str: string): number {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash) ^ str.charCodeAt(i);\n  }\n  return hash >>> 0;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-V543AI2F.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-V543AI2F.js.map

package/dist/chunk-V543AI2F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}