@q-ching/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jean Llorca
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @q-ching/core
+
+> Platform-agnostic I-Ching engine: entropy pool, QRNG clients, casting math, and the 64 hexagrams.
+
+The dependency-free engine behind [q-ching](https://github.com/Hylaean/q-ching#readme). It relies only on Web Crypto (`crypto.subtle`) and global `fetch`, so the *same* engine runs in the browser, in Node, and in the terminal. It powers the [`@q-ching/tui`](https://www.npmjs.com/package/@q-ching/tui) terminal app and the [`@q-ching/mcp`](https://www.npmjs.com/package/@q-ching/mcp) server.
+
+## Install
+
+```bash
+npm install @q-ching/core
+```
+
+## Cast a reading
+
+```js
+import { cast } from "@q-ching/core";
+
+const reading = await cast({ question: "What should I attend to?" });
+console.log(reading.primary.number, reading.primary.name.english);
+console.log(reading.changingPositions);     // which lines (1..6) are changing
+console.log(reading.transformed?.number);   // the hexagram it changes into, or null
+console.log(reading.seed); // reproducible: cast({ seed }) reproduces it exactly
+```
+
+## What it does
+
+A reading is cast by absorbing the querent's gesture entropy, concurrently-fetched QRNG draws (NIST beacon, ANU, RANDOM.ORG), a fresh local CSPRNG draw, and a timestamp salt into an HKDF-style `EntropyPool`, then squeezing a whitened bit stream and drawing six lines. The pool's `fingerprint()` is the shareable, auditable seed; the local CSPRNG always carries the cast, so a blocked remote source can never block or bias it.
+
+Requires Node ≥ 20 (or any modern browser).
+
+## License
+
+MIT

package/dist/casting.d.ts

@@ -0,0 +1,45 @@
+import type { CastMethod, LineValue, Reading } from './types.js';
+import { BitReader } from './util.js';
+import { type QrngConfig, type QrngResult } from './entropy/qrng.js';
+/**
+ * Coin method (three coins). Each coin: heads = 3, tails = 2. Three fair bits
+ * decide the line. With h = number of heads, value = 6 + h, giving
+ *   6 (old yin)   1/8
+ *   7 (young yang) 3/8
+ *   8 (young yin)  3/8
+ *   9 (old yang)  1/8
+ */
+declare function coinLine(reader: BitReader): LineValue;
+/**
+ * Yarrow-stalk method. The traditional stalk ritual yields an asymmetric
+ * distribution that makes changing lines rarer:
+ *   6 (old yin)    1/16
+ *   7 (young yang) 5/16
+ *   8 (young yin)  7/16
+ *   9 (old yang)   3/16
+ * Drawn from four uniform bits (0..15), since 16 is a power of two.
+ */
+declare function yarrowLine(reader: BitReader): LineValue;
+export interface CastInput {
+    /** 'coin' (default) or 'yarrow'. */
+    method?: CastMethod;
+    /** Bytes captured from a human gesture (mouse, touch, motion, keystrokes). */
+    userEntropy?: Uint8Array | number[];
+    /**
+     * Quantum entropy: pass `true` to auto-gather, a QrngConfig to configure the
+     * gather, or a pre-fetched QrngResult[] (e.g. fetched server-side).
+     */
+    qrng?: boolean | QrngConfig | QrngResult[];
+    /** Reproduce a prior cast from its seed (hex fingerprint). */
+    seed?: string;
+    /** Override the clock (mainly for tests/determinism). */
+    now?: () => number;
+}
+/**
+ * Cast a reading. Builds an entropy pool from the querent's gesture, optional
+ * quantum sources, and the local CSPRNG; squeezes a whitened stream; and draws
+ * six lines bottom -> top, deriving the primary hexagram, the changing lines,
+ * and the transformed hexagram.
+ */
+export declare function cast(input?: CastInput): Promise<Reading>;
+export { coinLine, yarrowLine };

package/dist/casting.js

@@ -0,0 +1,110 @@
+import { BitReader } from './util.js';
+import { EntropyPool } from './entropy/pool.js';
+import { gatherEntropy, localCsprng } from './entropy/qrng.js';
+import { hexagramByBits } from './hexagrams.js';
+/**
+ * Coin method (three coins). Each coin: heads = 3, tails = 2. Three fair bits
+ * decide the line. With h = number of heads, value = 6 + h, giving
+ *   6 (old yin)   1/8
+ *   7 (young yang) 3/8
+ *   8 (young yin)  3/8
+ *   9 (old yang)  1/8
+ */
+function coinLine(reader) {
+    const h = reader.readBit() + reader.readBit() + reader.readBit();
+    return (6 + h);
+}
+/**
+ * Yarrow-stalk method. The traditional stalk ritual yields an asymmetric
+ * distribution that makes changing lines rarer:
+ *   6 (old yin)    1/16
+ *   7 (young yang) 5/16
+ *   8 (young yin)  7/16
+ *   9 (old yang)   3/16
+ * Drawn from four uniform bits (0..15), since 16 is a power of two.
+ */
+function yarrowLine(reader) {
+    const v = reader.readBits(4); // 0..15, uniform
+    if (v === 0)
+        return 6; // 1/16
+    if (v <= 3)
+        return 9; // 3/16  (1,2,3)
+    if (v <= 8)
+        return 7; // 5/16  (4,5,6,7,8)
+    return 8; // 7/16  (9..15)
+}
+const BYTES_TO_GATHER = 48;
+const STREAM_BYTES = 64; // 6 lines need at most 24 bits; 64 bytes is generous headroom
+/**
+ * Cast a reading. Builds an entropy pool from the querent's gesture, optional
+ * quantum sources, and the local CSPRNG; squeezes a whitened stream; and draws
+ * six lines bottom -> top, deriving the primary hexagram, the changing lines,
+ * and the transformed hexagram.
+ */
+export async function cast(input = {}) {
+    const method = input.method ?? 'coin';
+    const now = input.now ?? (() => Date.now());
+    let pool;
+    if (input.seed) {
+        pool = EntropyPool.fromSeed(input.seed);
+    }
+    else {
+        pool = new EntropyPool();
+        if (input.userEntropy && input.userEntropy.length) {
+            pool.absorb('gesture', input.userEntropy);
+        }
+        if (input.qrng) {
+            let results;
+            if (Array.isArray(input.qrng)) {
+                results = input.qrng;
+            }
+            else {
+                const config = input.qrng === true ? {} : input.qrng;
+                results = await gatherEntropy(BYTES_TO_GATHER, config);
+            }
+            for (const r of results) {
+                if (r.ok && r.bytes && r.bytes.length)
+                    pool.absorb(`qrng:${r.source}`, r.bytes);
+            }
+        }
+        // Always fold in a fresh local CSPRNG draw and a timestamp salt.
+        pool.absorb('csprng', localCsprng(32));
+        pool.absorb('time', String(now()));
+    }
+    const stream = await pool.squeeze(STREAM_BYTES);
+    const reader = new BitReader(stream);
+    const lines = [];
+    for (let i = 0; i < 6; i++) {
+        const value = method === 'coin' ? coinLine(reader) : yarrowLine(reader);
+        lines.push({
+            position: i + 1,
+            value,
+            yang: value === 7 || value === 9,
+            changing: value === 6 || value === 9,
+        });
+    }
+    const primaryBits = lines.map((l) => (l.yang ? 1 : 0));
+    const primary = hexagramByBits(primaryBits);
+    const changingPositions = lines.filter((l) => l.changing).map((l) => l.position);
+    let transformed = null;
+    if (changingPositions.length > 0) {
+        const tBits = lines.map((l) => {
+            if (l.changing)
+                return (l.yang ? 0 : 1); // old yang -> yin, old yin -> yang
+            return (l.yang ? 1 : 0);
+        });
+        transformed = hexagramByBits(tBits);
+    }
+    return {
+        method,
+        lines,
+        primary,
+        transformed,
+        changingPositions,
+        seed: await pool.fingerprint(),
+        sources: pool.transcript,
+        createdAt: new Date(now()).toISOString(),
+    };
+}
+export { coinLine, yarrowLine };
+//# sourceMappingURL=casting.js.map

package/dist/casting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"casting.js","sourceRoot":"","sources":["../src/casting.ts"],"names":[],"mappings":"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"}

package/dist/engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engine.test.js

@@ -0,0 +1,74 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { cast } from './casting.js';
+import { EntropyPool } from './entropy/pool.js';
+import { HEXAGRAMS, hexagramByBits, hexagramByNumber, validateHexagrams } from './hexagrams.js';
+import { BitReader } from './util.js';
+import { coinLine, yarrowLine } from './casting.js';
+test('dataset passes deterministic structural validation', () => {
+    const result = validateHexagrams();
+    assert.equal(result.ok, true, result.errors.join('\n'));
+    assert.equal(HEXAGRAMS.length, 64);
+});
+test('every hexagram has complete prose', () => {
+    for (const h of HEXAGRAMS) {
+        assert.ok(h.judgment.length > 10, `#${h.number} judgment`);
+        assert.ok(h.image.length > 10, `#${h.number} image`);
+        assert.ok(h.gloss.length > 2, `#${h.number} gloss`);
+        assert.equal(h.lineTexts.length, 6, `#${h.number} lineTexts`);
+        for (const lt of h.lineTexts)
+            assert.ok(lt.length > 3, `#${h.number} line text`);
+    }
+});
+test('hexagram 1 is Qian (all yang), 2 is Kun (all yin)', () => {
+    assert.equal(hexagramByNumber(1).bits.join(''), '111111');
+    assert.equal(hexagramByNumber(2).bits.join(''), '000000');
+    assert.equal(hexagramByBits([1, 1, 1, 1, 1, 1]).number, 1);
+    assert.equal(hexagramByBits([0, 0, 0, 0, 0, 0]).number, 2);
+});
+test('a seed reproduces an identical reading', async () => {
+    const a = await cast({ userEntropy: [1, 2, 3, 4, 5], now: () => 1000 });
+    const b = await cast({ seed: a.seed, now: () => 1000 });
+    assert.equal(a.primary.number, b.primary.number);
+    assert.equal(a.transformed?.number ?? null, b.transformed?.number ?? null);
+    assert.deepEqual(a.lines.map((l) => l.value), b.lines.map((l) => l.value));
+});
+test('coin distribution ~ 1/8, 3/8, 3/8, 1/8', async () => {
+    const counts = { 6: 0, 7: 0, 8: 0, 9: 0 };
+    const N = 200_000;
+    // deterministic uniform bytes from the pool, expanded large
+    const stream = await EntropyPool.fromSeed('00'.repeat(32)).squeeze(Math.ceil((N * 3) / 8) + 64);
+    const reader = new BitReader(stream);
+    for (let i = 0; i < N; i++)
+        counts[coinLine(reader)]++;
+    assert.ok(Math.abs(counts[6] / N - 1 / 8) < 0.01, `6: ${counts[6] / N}`);
+    assert.ok(Math.abs(counts[7] / N - 3 / 8) < 0.01, `7: ${counts[7] / N}`);
+    assert.ok(Math.abs(counts[8] / N - 3 / 8) < 0.01, `8: ${counts[8] / N}`);
+    assert.ok(Math.abs(counts[9] / N - 1 / 8) < 0.01, `9: ${counts[9] / N}`);
+});
+test('yarrow distribution ~ 1/16, 5/16, 7/16, 3/16', async () => {
+    const counts = { 6: 0, 7: 0, 8: 0, 9: 0 };
+    const N = 200_000;
+    const stream = await EntropyPool.fromSeed('a5'.repeat(32)).squeeze(Math.ceil((N * 4) / 8) + 64);
+    const reader = new BitReader(stream);
+    for (let i = 0; i < N; i++)
+        counts[yarrowLine(reader)]++;
+    assert.ok(Math.abs(counts[6] / N - 1 / 16) < 0.01, `6: ${counts[6] / N}`);
+    assert.ok(Math.abs(counts[7] / N - 5 / 16) < 0.01, `7: ${counts[7] / N}`);
+    assert.ok(Math.abs(counts[8] / N - 7 / 16) < 0.01, `8: ${counts[8] / N}`);
+    assert.ok(Math.abs(counts[9] / N - 3 / 16) < 0.01, `9: ${counts[9] / N}`);
+});
+test('changing lines produce a distinct transformed hexagram', async () => {
+    // search seeds for a cast with changing lines
+    let found = false;
+    for (let i = 0; i < 50 && !found; i++) {
+        const r = await cast({ userEntropy: [i], now: () => i });
+        if (r.changingPositions.length > 0) {
+            assert.ok(r.transformed, 'should have transformed hexagram');
+            assert.notEqual(r.transformed.number, r.primary.number);
+            found = true;
+        }
+    }
+    assert.ok(found, 'expected at least one changing-line cast in 50 tries');
+});
+//# sourceMappingURL=engine.test.js.map

package/dist/engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.test.js","sourceRoot":"","sources":["../src/engine.test.ts"],"names":[],"mappings":"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"}

package/dist/entropy/gesture.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A platform-agnostic accumulator for human "gesture" entropy: pointer moves,
+ * touch paths, device-motion samples, keystroke timings — anything the
+ * querent's body does while they hold their question in mind.
+ *
+ * It does not try to estimate entropy precisely; it simply captures the raw
+ * float bytes of each sample. The EntropyPool hashes everything afterward, so
+ * over-capture is harmless and a few genuinely unpredictable bits (the timing
+ * jitter of a human hand) are what matter.
+ */
+export declare class GestureEntropy {
+    private buf;
+    private _count;
+    /** Number of samples captured. */
+    get count(): number;
+    private pushFloat;
+    /** Record a pointer/touch sample at (x, y) with a high-resolution timestamp. */
+    push(x: number, y: number, t: number): this;
+    /** Record a single scalar (e.g. an accelerometer axis or a key interval). */
+    pushScalar(v: number): this;
+    /** The captured bytes. */
+    get bytes(): Uint8Array;
+    /** A coarse 0..1 sense of "how much" the querent has stirred — for UI meters. */
+    get fill(): number;
+    reset(): void;
+}

package/dist/entropy/gesture.js

@@ -0,0 +1,52 @@
+/**
+ * A platform-agnostic accumulator for human "gesture" entropy: pointer moves,
+ * touch paths, device-motion samples, keystroke timings — anything the
+ * querent's body does while they hold their question in mind.
+ *
+ * It does not try to estimate entropy precisely; it simply captures the raw
+ * float bytes of each sample. The EntropyPool hashes everything afterward, so
+ * over-capture is harmless and a few genuinely unpredictable bits (the timing
+ * jitter of a human hand) are what matter.
+ */
+export class GestureEntropy {
+    buf = [];
+    _count = 0;
+    /** Number of samples captured. */
+    get count() {
+        return this._count;
+    }
+    pushFloat(v) {
+        if (!Number.isFinite(v))
+            v = 0;
+        const dv = new DataView(new ArrayBuffer(4));
+        dv.setFloat32(0, v, true);
+        this.buf.push(dv.getUint8(0), dv.getUint8(1), dv.getUint8(2), dv.getUint8(3));
+    }
+    /** Record a pointer/touch sample at (x, y) with a high-resolution timestamp. */
+    push(x, y, t) {
+        this.pushFloat(x);
+        this.pushFloat(y);
+        this.pushFloat(t);
+        this._count += 1;
+        return this;
+    }
+    /** Record a single scalar (e.g. an accelerometer axis or a key interval). */
+    pushScalar(v) {
+        this.pushFloat(v);
+        this._count += 1;
+        return this;
+    }
+    /** The captured bytes. */
+    get bytes() {
+        return Uint8Array.from(this.buf);
+    }
+    /** A coarse 0..1 sense of "how much" the querent has stirred — for UI meters. */
+    get fill() {
+        return Math.min(1, this._count / 96);
+    }
+    reset() {
+        this.buf = [];
+        this._count = 0;
+    }
+}
+//# sourceMappingURL=gesture.js.map

package/dist/entropy/gesture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.js","sourceRoot":"","sources":["../../src/entropy/gesture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACjB,GAAG,GAAa,EAAE,CAAC;IACnB,MAAM,GAAG,CAAC,CAAC;IAEnB,kCAAkC;IAClC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,CAAS;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QAClC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6EAA6E;IAC7E,UAAU,CAAC,CAAS;QAClB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0BAA0B;IAC1B,IAAI,KAAK;QACP,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,iFAAiF;IACjF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;CACF"}

package/dist/entropy/pool.d.ts

@@ -0,0 +1,29 @@
+import type { EntropySourceRecord } from '../types.js';
+/**
+ * An entropy pool that absorbs bytes from many labelled sources (a human
+ * gesture, one or more quantum RNGs, a local CSPRNG) and squeezes a
+ * whitened, uniform byte stream out of them.
+ *
+ * Design: extract-then-expand, HKDF-style.
+ *   PRK        = SHA-256( source_1 || source_2 || ... )      (the "seed")
+ *   output_i   = SHA-256( PRK || counter_i )                 (the expansion)
+ *
+ * No single source can bias the result, a dead QRNG can't block a cast, and
+ * the PRK is exposed as a hex `fingerprint()` so a reading is fully
+ * reproducible from its seed — the basis for shareable, auditable casts.
+ */
+export declare class EntropyPool {
+    private chunks;
+    private _prk;
+    /** Absorb bytes from a source. Chainable. */
+    absorb(label: string, data: Uint8Array | number[] | string): this;
+    /** A transcript of what contributed entropy and how much. */
+    get transcript(): EntropySourceRecord[];
+    private prk;
+    /** The reproducible seed: hex of the extracted pseudo-random key. */
+    fingerprint(): Promise<string>;
+    /** Produce `numBytes` of uniform output, deterministic for a given PRK. */
+    squeeze(numBytes: number): Promise<Uint8Array>;
+    /** Reconstruct a pool from a previously emitted seed (hex of the PRK). */
+    static fromSeed(seedHex: string): EntropyPool;
+}

package/dist/entropy/pool.js

@@ -0,0 +1,70 @@
+import { concatBytes, fromHex, sha256, toBytes, toHex } from '../util.js';
+/**
+ * An entropy pool that absorbs bytes from many labelled sources (a human
+ * gesture, one or more quantum RNGs, a local CSPRNG) and squeezes a
+ * whitened, uniform byte stream out of them.
+ *
+ * Design: extract-then-expand, HKDF-style.
+ *   PRK        = SHA-256( source_1 || source_2 || ... )      (the "seed")
+ *   output_i   = SHA-256( PRK || counter_i )                 (the expansion)
+ *
+ * No single source can bias the result, a dead QRNG can't block a cast, and
+ * the PRK is exposed as a hex `fingerprint()` so a reading is fully
+ * reproducible from its seed — the basis for shareable, auditable casts.
+ */
+export class EntropyPool {
+    chunks = [];
+    _prk = null;
+    /** Absorb bytes from a source. Chainable. */
+    absorb(label, data) {
+        if (this._prk) {
+            throw new Error('Cannot absorb into a pool created from a fixed seed.');
+        }
+        const bytes = toBytes(data);
+        if (bytes.length > 0)
+            this.chunks.push({ label, bytes });
+        return this;
+    }
+    /** A transcript of what contributed entropy and how much. */
+    get transcript() {
+        if (this._prk)
+            return [{ label: 'seed', bytes: this._prk.length }];
+        return this.chunks.map((c) => ({ label: c.label, bytes: c.bytes.length }));
+    }
+    async prk() {
+        if (this._prk)
+            return this._prk;
+        const all = concatBytes(this.chunks.map((c) => c.bytes));
+        this._prk = await sha256(all);
+        return this._prk;
+    }
+    /** The reproducible seed: hex of the extracted pseudo-random key. */
+    async fingerprint() {
+        return toHex(await this.prk());
+    }
+    /** Produce `numBytes` of uniform output, deterministic for a given PRK. */
+    async squeeze(numBytes) {
+        const prk = await this.prk();
+        const out = new Uint8Array(numBytes);
+        let off = 0;
+        let counter = 0;
+        while (off < numBytes) {
+            const input = new Uint8Array(prk.length + 4);
+            input.set(prk, 0);
+            new DataView(input.buffer).setUint32(prk.length, counter, false);
+            counter += 1;
+            const block = await sha256(input);
+            const take = Math.min(block.length, numBytes - off);
+            out.set(block.subarray(0, take), off);
+            off += take;
+        }
+        return out;
+    }
+    /** Reconstruct a pool from a previously emitted seed (hex of the PRK). */
+    static fromSeed(seedHex) {
+        const pool = new EntropyPool();
+        pool._prk = fromHex(seedHex);
+        return pool;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/entropy/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/entropy/pool.ts"],"names":[],"mappings":"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"}

package/dist/entropy/qrng.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Quantum / true random number sources.
+ *
+ * Honest note: a local CSPRNG is already statistically perfect for casting an
+ * oracle. The quantum sources are here for *meaning* — your hexagram drawn
+ * from vacuum fluctuations and an atmospheric hiss — and for transparency, not
+ * because they are "more random". Every gather always folds in the local
+ * CSPRNG so a cast can never be blocked or biased by a flaky remote API.
+ */
+export type QrngSourceName = 'nist' | 'anu' | 'random.org' | 'csprng';
+export interface QrngResult {
+    source: QrngSourceName;
+    ok: boolean;
+    bytes: Uint8Array | null;
+    detail?: string;
+}
+export interface QrngConfig {
+    /** Which sources to attempt. Default: ['nist', 'csprng']. csprng is always included. */
+    sources?: QrngSourceName[];
+    anuApiKey?: string;
+    randomOrgApiKey?: string;
+    /** Inject a fetch implementation (defaults to global fetch). */
+    fetchImpl?: typeof fetch;
+    /** Per-request timeout in ms (default 6000). */
+    timeoutMs?: number;
+}
+export declare function localCsprng(numBytes: number): Uint8Array;
+/**
+ * NIST Randomness Beacon (v2). Public, keyless, quantum-seeded. Publishes a
+ * 512-bit value every 60s — the same for everyone in a given minute, which is
+ * its own kind of poetry: the cosmic pulse at the moment you asked.
+ */
+export declare function fetchNistBeacon(numBytes: number, config?: QrngConfig): Promise<QrngResult>;
+/**
+ * ANU Quantum Random Numbers — vacuum fluctuations. The classic public
+ * endpoint is now rate-limited and may require an API key; we pass one if
+ * provided and fail gracefully otherwise.
+ */
+export declare function fetchAnu(numBytes: number, config?: QrngConfig): Promise<QrngResult>;
+/** RANDOM.ORG atmospheric noise (JSON-RPC v4). Requires an API key. */
+export declare function fetchRandomOrg(numBytes: number, config?: QrngConfig): Promise<QrngResult>;
+/**
+ * Attempt every configured source concurrently and always include the local
+ * CSPRNG. Returns one result per attempted source (failures included, so the
+ * UI can show what answered the call).
+ */
+export declare function gatherEntropy(numBytes: number, config?: QrngConfig): Promise<QrngResult[]>;