@discretion/core 0.1.0

package/dist/src/gazetteer/index.js

@@ -0,0 +1,117 @@
+/**
+ * Stage 2b — GAZETTEER lookup.
+ *
+ * SPEC.md: "Bundled compressed lookup sets, checked in parallel with the
+ * model … Gazetteer hit alone is medium confidence; gazetteer plus model
+ * agreement is high."
+ *
+ * The bundled sets are Bloom filters (see `@discretion/data`'s
+ * gazetteers.ts for why). Two consequences shape this module:
+ *
+ *   • A filter can report a false POSITIVE and never a false negative. So a
+ *     hit is corroboration, never proof — which is exactly the weight SPEC.md
+ *     assigns it — while a miss is conclusive.
+ *   • The hash here must match the builder's byte for byte, so it is written
+ *     out explicitly rather than pulled from a library that might change.
+ */
+import { GAZETTEERS } from '@discretion/data';
+const GAZETTEER_TYPES = ['PERSON', 'ORG', 'LOCATION'];
+export function isGazetteerType(type) {
+    return GAZETTEER_TYPES.includes(type);
+}
+/**
+ * Fold a value for lookup: lowercase, then strip combining marks.
+ *
+ * Identical to the trigger matcher's folding, and to the builder's. Case fold
+ * precedes mark stripping so Turkish dotted capital I resolves correctly.
+ */
+function fold(value) {
+    return value.toLowerCase().normalize('NFD').replace(/\p{M}+/gu, '').normalize('NFC').trim();
+}
+/** FNV-1a with two seeds, then double hashing. Must match the builder. */
+function hashPair(value) {
+    let a = 0x811c9dc5;
+    let b = 0x01000193;
+    for (let i = 0; i < value.length; i += 1) {
+        const c = value.charCodeAt(i);
+        a = Math.imul(a ^ c, 0x01000193) >>> 0;
+        b = Math.imul(b ^ (c + 0x9e3779b9), 0x85ebca6b) >>> 0;
+    }
+    return [a >>> 0, (b || 1) >>> 0];
+}
+function decode(base64) {
+    // atob is available in browsers and in Node 16+, and keeps core free of
+    // Node-only APIs (`Buffer`), which its eslint config bans.
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+class BloomSet {
+    filter;
+    bytes;
+    constructor(filter) {
+        this.filter = filter;
+        this.bytes = decode(filter.base64);
+    }
+    has(folded) {
+        const [h1, h2] = hashPair(folded);
+        for (let i = 0; i < this.filter.k; i += 1) {
+            const bit = ((h1 + Math.imul(i, h2)) >>> 0) % this.filter.bits;
+            if ((this.bytes[bit >>> 3] & (1 << (bit & 7))) === 0)
+                return false;
+        }
+        return true;
+    }
+}
+/**
+ * Filters are decoded on first use and cached.
+ *
+ * Decoding all three eagerly costs about 2 MB of base64 work at import time,
+ * which a consumer that never runs Stage 2b should not pay.
+ */
+const decoded = new Map();
+function setFor(type) {
+    const cached = decoded.get(type);
+    if (cached !== undefined)
+        return cached;
+    const built = new BloomSet(GAZETTEERS[type]);
+    decoded.set(type, built);
+    return built;
+}
+/** Longest multi-word span the gazetteer will consider as a single name. */
+const MAX_WORDS = 5;
+/**
+ * Look a value up as `type`.
+ *
+ * A person's full name is rarely a single gazetteer entry — the sets hold
+ * given names and family names separately — so a multi-word value is checked
+ * whole first, then word by word. `matchedWords` lets the caller weigh
+ * "every word is a known name" differently from "one word out of four is".
+ */
+export function lookupGazetteer(value, type) {
+    const folded = fold(value);
+    if (folded.length < 2)
+        return undefined;
+    const set = setFor(type);
+    const words = folded.split(/\s+/).filter((w) => w.length >= 2);
+    if (words.length === 0 || words.length > MAX_WORDS)
+        return undefined;
+    if (set.has(folded)) {
+        return { type, whole: true, matchedWords: words.length, totalWords: words.length };
+    }
+    const matchedWords = words.filter((w) => set.has(w)).length;
+    if (matchedWords === 0)
+        return undefined;
+    return { type, whole: false, matchedWords, totalWords: words.length };
+}
+/** Entry counts per set, for reporting and for BENCHMARKS.md. */
+export function gazetteerSizes() {
+    return {
+        PERSON: GAZETTEERS.PERSON.entries,
+        ORG: GAZETTEERS.ORG.entries,
+        LOCATION: GAZETTEERS.LOCATION.entries,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/gazetteer/index.js.map

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

package/dist/src/generate/bankcodes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Valid-value generators for the national bank-code family.
+ *
+ * US routing numbers carry the ABA checksum, so their property test runs the
+ * full mutation half. The rest are structure-only formats (stated in each
+ * detector); their properties assert validation without mutation.
+ */
+/** An ABA-checksummed routing number with a valid FRB prefix. */
+export declare function generateValidRouting(seed: number): string;
+/** A UK sort code in 00-00-00 notation (no checksum exists). */
+export declare function generateValidSortCode(seed: number): string;
+/** A Canadian transit number with a known institution. */
+export declare function generateValidTransit(seed: number): string;
+/** An Australian BSB in XXX-XXX notation (no checksum exists). */
+export declare function generateValidBsb(seed: number): string;
+/** An IFSC with the mandatory zero and at least one digit in the branch. */
+export declare function generateValidIfsc(seed: number): string;
+/** A labeled Brazilian agência, sometimes with its display check digit. */
+export declare function generateValidAgencia(seed: number): string;
+//# sourceMappingURL=bankcodes.d.ts.map

package/dist/src/generate/bankcodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bankcodes.d.ts","sourceRoot":"","sources":["../../../src/generate/bankcodes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAKD,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD;AAID,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAID,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/src/generate/bankcodes.js

@@ -0,0 +1,71 @@
+/**
+ * Valid-value generators for the national bank-code family.
+ *
+ * US routing numbers carry the ABA checksum, so their property test runs the
+ * full mutation half. The rest are structure-only formats (stated in each
+ * detector); their properties assert validation without mutation.
+ */
+import { abaCheckDigit } from '../checksums/index.js';
+import { mulberry32 } from './prng.js';
+function pick(rng, items) {
+    return items[Math.floor(rng() * items.length)];
+}
+function int(rng, min, max) {
+    return min + Math.floor(rng() * (max - min + 1));
+}
+function digits(rng, count) {
+    let out = '';
+    for (let i = 0; i < count; i++)
+        out += String(int(rng, 0, 9));
+    return out;
+}
+/** Valid Federal Reserve prefixes (mirrors the detector's rule). */
+const FRB_PREFIXES = [
+    ...Array.from({ length: 12 }, (_, i) => i + 1),
+    ...Array.from({ length: 12 }, (_, i) => i + 21),
+    ...Array.from({ length: 12 }, (_, i) => i + 61),
+    80,
+];
+/** An ABA-checksummed routing number with a valid FRB prefix. */
+export function generateValidRouting(seed) {
+    const rng = mulberry32(seed);
+    const prefix = String(pick(rng, FRB_PREFIXES)).padStart(2, '0');
+    const payload = prefix + digits(rng, 6);
+    return `${payload}${abaCheckDigit(payload)}`;
+}
+/** A UK sort code in 00-00-00 notation (no checksum exists). */
+export function generateValidSortCode(seed) {
+    const rng = mulberry32(seed);
+    return `${digits(rng, 2)}-${digits(rng, 2)}-${digits(rng, 2)}`;
+}
+/** Institution numbers mirrored from the detector's Payments Canada table. */
+const CA_INSTITUTIONS = ['001', '002', '003', '004', '006', '010', '016', '030', '219', '614', '623', '809', '815', '837'];
+/** A Canadian transit number with a known institution. */
+export function generateValidTransit(seed) {
+    const rng = mulberry32(seed);
+    return `${digits(rng, 5)}-${pick(rng, CA_INSTITUTIONS)}`;
+}
+/** An Australian BSB in XXX-XXX notation (no checksum exists). */
+export function generateValidBsb(seed) {
+    const rng = mulberry32(seed);
+    return `${digits(rng, 3)}-${digits(rng, 3)}`;
+}
+const LETTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+/** An IFSC with the mandatory zero and at least one digit in the branch. */
+export function generateValidIfsc(seed) {
+    const rng = mulberry32(seed);
+    let bank = '';
+    for (let i = 0; i < 4; i++)
+        bank += LETTERS[int(rng, 0, 25)];
+    // Branch: mostly numeric, as issued in practice; always ≥1 digit.
+    return `${bank}0${digits(rng, 6)}`;
+}
+const AGENCIA_LABELS = ['ag.', 'Ag.', 'agência', 'Agência', 'agencia', 'ag'];
+/** A labeled Brazilian agência, sometimes with its display check digit. */
+export function generateValidAgencia(seed) {
+    const rng = mulberry32(seed);
+    const label = pick(rng, AGENCIA_LABELS);
+    const check = rng() < 0.4 ? `-${int(rng, 0, 9)}` : '';
+    return `${label} ${digits(rng, 4)}${check}`;
+}
+//# sourceMappingURL=bankcodes.js.map

package/dist/src/generate/bankcodes.js.map

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

package/dist/src/generate/contact.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Valid-value generators for the contact & network family.
+ *
+ * Deterministic by seed, never call the validators they feed (no
+ * circularity), and are reused by M3's corpus generator. None of these
+ * formats carries a checksum, so the paired property tests assert
+ * "generated value always validates" without the single-character-mutation
+ * half — a mutated email or IP is usually still a valid email or IP.
+ */
+/** A structurally valid, non-reserved-domain email address. */
+export declare function generateValidEmail(seed: number): string;
+/**
+ * Known-valid E.164 numbers across plans and regions. Sources: numbers in
+ * ranges reserved for fiction/drama (UK Ofcom 7946 09xx, US 555-01xx) and
+ * carrier example shapes that satisfy libphonenumber's full-metadata
+ * isValid(). The pool is itself pinned by a test, so a metadata update that
+ * invalidates an entry fails loudly there rather than silently in the
+ * property test.
+ */
+export declare const VALID_E164_POOL: readonly string[];
+/** A valid phone number, formatted variably (E.164, spaced, punctuated). */
+export declare function generateValidPhone(seed: number): string;
+/** A valid IPv4 address (octets 1–254 to stay clear of edge constants). */
+export declare function generateValidIpv4(seed: number): string;
+/** A valid IPv6 address, sometimes zero-compressed, never unspecified. */
+export declare function generateValidIpv6(seed: number): string;
+/** A valid MAC in colon, hyphen, or Cisco notation. Never all-00/all-ff. */
+export declare function generateValidMac(seed: number): string;
+/** A URL that genuinely carries a credential (userinfo or query form). */
+export declare function generateValidCredentialUrl(seed: number): string;
+//# sourceMappingURL=contact.d.ts.map

package/dist/src/generate/contact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.d.ts","sourceRoot":"","sources":["../../../src/generate/contact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyBH,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAa5C,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAMD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AAMD,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD;AAWD,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/D"}

package/dist/src/generate/contact.js

@@ -0,0 +1,139 @@
+/**
+ * Valid-value generators for the contact & network family.
+ *
+ * Deterministic by seed, never call the validators they feed (no
+ * circularity), and are reused by M3's corpus generator. None of these
+ * formats carries a checksum, so the paired property tests assert
+ * "generated value always validates" without the single-character-mutation
+ * half — a mutated email or IP is usually still a valid email or IP.
+ */
+import { mulberry32 } from './prng.js';
+function pick(rng, items) {
+    return items[Math.floor(rng() * items.length)];
+}
+function int(rng, min, max) {
+    return min + Math.floor(rng() * (max - min + 1));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Email
+// ─────────────────────────────────────────────────────────────────────────────
+const LOCALS = [
+    'john.doe', 'jane_doe', 'a', 'user+tag', 'dev-ops', "o'brien", 'x.y.z',
+    'müller', 'björn.b', 'test123', 'first.middle.last', '_service',
+];
+const DOMAINS = [
+    'gmail.com', 'yandex.ru', 'firma.de', 'corp.co.uk', 'startup.io',
+    'münchen.de', 'xn--bcher-kva.de', 'sub.domain.net', 'a-b.org', 'q2.dev',
+];
+/** A structurally valid, non-reserved-domain email address. */
+export function generateValidEmail(seed) {
+    const rng = mulberry32(seed);
+    return `${pick(rng, LOCALS)}@${pick(rng, DOMAINS)}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Phone
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Known-valid E.164 numbers across plans and regions. Sources: numbers in
+ * ranges reserved for fiction/drama (UK Ofcom 7946 09xx, US 555-01xx) and
+ * carrier example shapes that satisfy libphonenumber's full-metadata
+ * isValid(). The pool is itself pinned by a test, so a metadata update that
+ * invalidates an entry fails loudly there rather than silently in the
+ * property test.
+ */
+export const VALID_E164_POOL = [
+    '+12125550123', // US, NANP fictional range
+    '+14155550198', // US
+    '+442079460958', // UK, Ofcom drama range (London)
+    '+447911123456', // UK mobile
+    '+905321234567', // TR mobile
+    '+4915123456789', // DE mobile
+    '+33612345678', // FR mobile
+    '+61412345678', // AU mobile
+    '+819012345678', // JP mobile
+    '+558121345678', // BR
+    '+8613912345678', // CN mobile
+    '+918527012345', // IN mobile
+];
+/** A valid phone number, formatted variably (E.164, spaced, punctuated). */
+export function generateValidPhone(seed) {
+    const rng = mulberry32(seed);
+    const e164 = pick(rng, VALID_E164_POOL);
+    const style = int(rng, 0, 2);
+    if (style === 0)
+        return e164;
+    const cc = e164.slice(0, e164.length - 10 >= 2 ? e164.length - 10 : 3);
+    const rest = e164.slice(cc.length);
+    if (style === 1) {
+        // Space-grouped: +90 532 123 45 67 style.
+        const parts = [];
+        for (let i = 0; i < rest.length; i += 3)
+            parts.push(rest.slice(i, i + 3));
+        return `${cc} ${parts.join(' ')}`;
+    }
+    // Hyphen-grouped.
+    const mid = Math.floor(rest.length / 2);
+    return `${cc} ${rest.slice(0, mid)}-${rest.slice(mid)}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// IP addresses
+// ─────────────────────────────────────────────────────────────────────────────
+/** A valid IPv4 address (octets 1–254 to stay clear of edge constants). */
+export function generateValidIpv4(seed) {
+    const rng = mulberry32(seed);
+    return [int(rng, 1, 223), int(rng, 0, 254), int(rng, 0, 254), int(rng, 1, 254)].join('.');
+}
+/** A valid IPv6 address, sometimes zero-compressed, never unspecified. */
+export function generateValidIpv6(seed) {
+    const rng = mulberry32(seed);
+    const groups = [];
+    for (let i = 0; i < 8; i++)
+        groups.push(int(rng, 0, 0xffff));
+    if (groups[0] === 0)
+        groups[0] = 0x2001; // never all-zero / leading-zero edge
+    // Half the time, zero a run and write it compressed.
+    if (rng() < 0.5) {
+        const start = int(rng, 2, 5);
+        const len = int(rng, 2, 3);
+        for (let i = start; i < Math.min(start + len, 8); i++)
+            groups[i] = 0;
+        const hex = groups.map((g) => g.toString(16));
+        return `${hex.slice(0, start).join(':')}::${hex.slice(Math.min(start + len, 8)).join(':')}`;
+    }
+    return groups.map((g) => g.toString(16)).join(':');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// MAC
+// ─────────────────────────────────────────────────────────────────────────────
+/** A valid MAC in colon, hyphen, or Cisco notation. Never all-00/all-ff. */
+export function generateValidMac(seed) {
+    const rng = mulberry32(seed);
+    const bytes = [];
+    for (let i = 0; i < 6; i++)
+        bytes.push(int(rng, 0, 255));
+    bytes[2] = int(rng, 1, 254); // guarantees neither all-zero nor all-ff
+    const hex = bytes.map((b) => b.toString(16).padStart(2, '0'));
+    const style = int(rng, 0, 2);
+    if (style === 0)
+        return hex.join(':');
+    if (style === 1)
+        return hex.join('-').toUpperCase();
+    const h = hex.join('');
+    return `${h.slice(0, 4)}.${h.slice(4, 8)}.${h.slice(8, 12)}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// URL with credentials
+// ─────────────────────────────────────────────────────────────────────────────
+const CRED_USERS = ['admin', 'deploy', 'svc-backup', 'root', 'ci'];
+const CRED_PASSWORDS = ['hunter2secret', 'P4ssw0rd!x', 'tOk3n-v4lue-9', 's3cr3t_key_77'];
+const CRED_HOSTS = ['db.internal.corp', 'api.prod.net', 'cache.svc.local', 'build.ci.dev'];
+const CRED_PARAMS = ['token', 'api_key', 'access_token', 'client_secret'];
+/** A URL that genuinely carries a credential (userinfo or query form). */
+export function generateValidCredentialUrl(seed) {
+    const rng = mulberry32(seed);
+    if (rng() < 0.5) {
+        return `https://${pick(rng, CRED_USERS)}:${pick(rng, CRED_PASSWORDS)}@${pick(rng, CRED_HOSTS)}/app`;
+    }
+    return `https://${pick(rng, CRED_HOSTS)}/v1/data?${pick(rng, CRED_PARAMS)}=Ab9${Math.floor(rng() * 1e12).toString(36)}xQ7tk`;
+}
+//# sourceMappingURL=contact.js.map

package/dist/src/generate/contact.js.map

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

package/dist/src/generate/crypto.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Valid-value generators for the crypto wallet family.
+ *
+ * Built from the SAME primitives the validators verify with — the
+ * primitives are pinned to published vectors in crypto-primitives.test.ts,
+ * so this is synthesis, not circularity. Chains with real checksums (BTC,
+ * ETH mixed-case, LTC, TRX, XMR) get the mutation half of the property
+ * standard; SOL and DOT are structural formats and skip it (stated in the
+ * tests).
+ */
+/** A checksummed Bitcoin address: P2PKH, P2SH, segwit v0, or taproot. */
+export declare function generateValidBtc(seed: number): string;
+/** An EIP-55 checksummed Ethereum address. */
+export declare function generateValidEth(seed: number): string;
+/** A checksummed Litecoin address (L/M base58check or ltc1 segwit v0). */
+export declare function generateValidLtc(seed: number): string;
+/** A checksummed Tron address. */
+export declare function generateValidTrx(seed: number): string;
+/** A checksummed Monero address (standard or subaddress). */
+export declare function generateValidXmr(seed: number): string;
+/** A structurally valid Solana address (32-byte key; no checksum exists). */
+export declare function generateValidSol(seed: number): string;
+/** A checksummed Cardano Shelley address. */
+export declare function generateValidAda(seed: number): string;
+/** A structurally valid Polkadot SS58 envelope (checksum bytes arbitrary). */
+export declare function generateValidDot(seed: number): string;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/src/generate/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/generate/crypto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/src/generate/crypto.js

@@ -0,0 +1,88 @@
+/**
+ * Valid-value generators for the crypto wallet family.
+ *
+ * Built from the SAME primitives the validators verify with — the
+ * primitives are pinned to published vectors in crypto-primitives.test.ts,
+ * so this is synthesis, not circularity. Chains with real checksums (BTC,
+ * ETH mixed-case, LTC, TRX, XMR) get the mutation half of the property
+ * standard; SOL and DOT are structural formats and skip it (stated in the
+ * tests).
+ */
+import { keccak256 } from '../crypto/keccak256.js';
+import { base58CheckEncode, base58Encode } from '../encoding/base58.js';
+import { bech32Encode, convertBits } from '../encoding/bech32.js';
+import { moneroBase58Encode } from '../encoding/base58monero.js';
+import { toEip55 } from '../detect/detectors/crypto/eth.js';
+import { mulberry32 } from './prng.js';
+function randomBytes(rng, count) {
+    const out = new Uint8Array(count);
+    for (let i = 0; i < count; i++)
+        out[i] = Math.floor(rng() * 256);
+    return out;
+}
+/** A checksummed Bitcoin address: P2PKH, P2SH, segwit v0, or taproot. */
+export function generateValidBtc(seed) {
+    const rng = mulberry32(seed);
+    const kind = Math.floor(rng() * 4);
+    if (kind === 0)
+        return base58CheckEncode(0x00, randomBytes(rng, 20));
+    if (kind === 1)
+        return base58CheckEncode(0x05, randomBytes(rng, 20));
+    if (kind === 2) {
+        const program = randomBytes(rng, rng() < 0.5 ? 20 : 32);
+        return bech32Encode('bc', [0, ...convertBits([...program], 8, 5, true)], 'bech32');
+    }
+    const program = randomBytes(rng, 32);
+    return bech32Encode('bc', [1, ...convertBits([...program], 8, 5, true)], 'bech32m');
+}
+/** An EIP-55 checksummed Ethereum address. */
+export function generateValidEth(seed) {
+    const rng = mulberry32(seed);
+    const hexLower = [...randomBytes(rng, 20)].map((b) => b.toString(16).padStart(2, '0')).join('');
+    return `0x${toEip55(hexLower)}`;
+}
+/** A checksummed Litecoin address (L/M base58check or ltc1 segwit v0). */
+export function generateValidLtc(seed) {
+    const rng = mulberry32(seed);
+    const kind = Math.floor(rng() * 3);
+    if (kind === 0)
+        return base58CheckEncode(0x30, randomBytes(rng, 20));
+    if (kind === 1)
+        return base58CheckEncode(0x32, randomBytes(rng, 20));
+    const program = randomBytes(rng, rng() < 0.5 ? 20 : 32);
+    return bech32Encode('ltc', [0, ...convertBits([...program], 8, 5, true)], 'bech32');
+}
+/** A checksummed Tron address. */
+export function generateValidTrx(seed) {
+    const rng = mulberry32(seed);
+    return base58CheckEncode(0x41, randomBytes(rng, 20));
+}
+/** A checksummed Monero address (standard or subaddress). */
+export function generateValidXmr(seed) {
+    const rng = mulberry32(seed);
+    const network = rng() < 0.5 ? 0x12 : 0x2a;
+    const body = Uint8Array.from([network, ...randomBytes(rng, 64)]);
+    const checksum = keccak256(body).slice(0, 4);
+    return moneroBase58Encode(Uint8Array.from([...body, ...checksum]));
+}
+/** A structurally valid Solana address (32-byte key; no checksum exists). */
+export function generateValidSol(seed) {
+    const rng = mulberry32(seed);
+    const bytes = randomBytes(rng, 32);
+    if (bytes.every((b) => b === 0))
+        bytes[0] = 1; // avoid the system program
+    return base58Encode(bytes);
+}
+/** A checksummed Cardano Shelley address. */
+export function generateValidAda(seed) {
+    const rng = mulberry32(seed);
+    // 57 payload bytes ≈ a real Shelley base address envelope.
+    const data = convertBits([...randomBytes(rng, 57)], 8, 5, true);
+    return bech32Encode('addr', data, 'bech32');
+}
+/** A structurally valid Polkadot SS58 envelope (checksum bytes arbitrary). */
+export function generateValidDot(seed) {
+    const rng = mulberry32(seed);
+    return base58Encode(Uint8Array.from([0x00, ...randomBytes(rng, 34)]));
+}
+//# sourceMappingURL=crypto.js.map

package/dist/src/generate/crypto.js.map

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

package/dist/src/generate/documents.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Valid-value generators for the documents & health family.
+ *
+ * The MRZ generator is the important one: it assembles a TD3 (or TD1) zone
+ * and computes every ICAO check digit with the shared library, exactly the
+ * way M3's corpus generator will synthesize labeled passports. MRZ, VIN,
+ * NPI and SNOMED carry real checksums → full mutation properties. UK DVLA
+ * and lab results are structural.
+ */
+/** A TD3 passport MRZ (two 44-char lines) with every check digit correct. */
+export declare function generateValidTd3(seed: number): string;
+/** A TD1 identity-card MRZ (three 30-char lines), all check digits correct. */
+export declare function generateValidTd1(seed: number): string;
+/** A VIN whose ISO 3779 check digit is correct. */
+export declare function generateValidVin(seed: number): string;
+/** An NPI with the 80840-prefixed Luhn check digit correct. */
+export declare function generateValidNpi(seed: number): string;
+/** A UK DVLA licence number obeying the date rules. */
+export declare function generateValidDvla(seed: number): string;
+/** A SNOMED SCTID: defined partition pair, closed with Verhoeff. */
+export declare function generateValidSctid(seed: number): string;
+/** A lab-result phrase: value, unit, bracketed reference range. */
+export declare function generateValidLabResult(seed: number): string;
+//# sourceMappingURL=documents.d.ts.map

package/dist/src/generate/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/generate/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBrD;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBrD;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO3D"}