![\"npm](\"https://img.shields.io/npm/v/js-randomness-predictor.svg?logo=npm&color=cb0000\")
\n \n\n \n \n \n
\n Live Demo \n · \n How Does It Work?\n
\n\n---\n\n# Quick Start\n\nAlways use the predictor that matches the environment where the original sequence was generated.\n\n```js\nimport JSRandomnessPredictor from \"js-randomness-predictor\";\n\nconst predictor = JSRandomnessPredictor.node();\nconst nextPrediction = await predictor.predictNext();\n\nconsole.log(nextPrediction);\n```\n\n# Installation\n\n## Node\n\n```bash\nnpm i js-randomness-predictor\nyarn add js-randomness-predictor\npnpm add js-randomness-predictor\n```\n\n## Bun\n\n```bash\nbun add js-randomness-predictor\n```\n\n## Deno\n\n```bash\ndeno add npm:js-randomness-predictor\n```\n\n# Usage\n\n## ESM\n\n```js\nimport JSRandomnessPredictor from \"js-randomness-predictor\";\n```\n\n## CJS\n\n```js\nconst JSRandomnessPredictor = require(\"js-randomness-predictor\");\n```\n\n## Deno\n\n```js\nimport JSRandomnessPredictor from \"npm:js-randomness-predictor\";\n```\n\n## Browser\n\nBrowser usage requires additional setup: [browser usage guide](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/BROWSER_USAGE.md).\n\n# Predictors\n\n| Runtime | Auto Generate Sequence | Sequence Length | [Known Issues](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md) |\n| ------------------- | ---------------------- | :-------------: | :-----------------------------------------------------------------------------------------------------------: |\n| [Node](#node-1) | ✅ | 5 | [Link](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md#node) |\n| [Bun](#bun-1) | ✅ Native Bun only | 6 | [Link](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md#bun) |\n| [Deno](#deno-2) | ✅ Native Deno only | 4 | - |\n| [Chrome](#chrome) | ❌ | 4 | [Link](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md#chrome) |\n| [Firefox](#firefox) | ❌ | 4 | [Link](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md#firefox) |\n| [Safari](#safari) | ❌ | 6 | [Link](https://github.com/matthewoestreich/js-randomness-predictor/blob/main/.github/KNOWN_ISSUES.md#safari) |\n\n## Node\n\n**Generate a sequence automatically**:\n\n```js\nconst predictor = JSRandomnessPredictor.node();\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n**Provide your own sequence**:\n\n```js\nconst sequence = Array.from({ length: 5 }, Math.random);\nconst predictor = JSRandomnessPredictor.node(sequence);\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n## Bun\n\n- If running natively in Bun, a sequence can be generated automatically.\n- If using the Bun predictor outside of Bun, you must provide a sequence that was originally generated in Bun.\n\n```js\nconst predictor = JSRandomnessPredictor.bun();\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n**Provide your own sequence**:\n\n```js\nconst sequence = [Math.random(), Math.random(), Math.random(), Math.random(), Math.random(), Math.random()];\nconst predictor = JSRandomnessPredictor.bun(sequence);\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n## Deno\n\n- If running natively in Deno, a sequence can be generated automatically.\n- If using the Deno predictor outside of Deno, you must provide a sequence that was originally generated in Deno.\n\n```js\nconst predictor = JSRandomnessPredictor.deno();\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n**Provide your own sequence**:\n\n```js\nconst sequence = Array.from({ length: 4 }, Math.random);\nconst predictor = JSRandomnessPredictor.deno(sequence);\nconst prediction = await predictor.predictNext();\nconst isAccurate = prediction === Math.random();\n```\n\n## Chrome\n\n```js\nconst predictor = JSRandomnessPredictor.chrome(sequence);\nconst prediction = await predictor.predictNext();\n```\n\n## Firefox\n\n```js\nconst predictor = JSRandomnessPredictor.firefox(sequence);\nconst prediction = await predictor.predictNext();\n```\n\n## Safari\n\n```js\nconst predictor = JSRandomnessPredictor.safari(sequence);\nconst prediction = await predictor.predictNext();\n```\n\n# Command Line Interface\n\n## Installation\n\n#### Global\n\n```bash\n# Install globally (system wide)\nnpm i -g js-randomness-predictor\n\n# Use from anywhere\njs-randomness-predictor [options]\n```\n\n#### Local\n\n```bash\n# Add as a local project dependency\nnpm i js-randomness-predictor\n\n# Manually 'path' to CLI\nnode_modules/.bin/js-randomness-predictor [options]\n```\n\n## Basic Usage\n\n```bash\n# Options\njs-randomness-predictor\n -e