poke-crucible 0.1.0

package/dist/pilot/pilot.js

@@ -0,0 +1,290 @@
+/**
+ * The Pilot — one competent Gen 3 heuristic policy, identical on both sides
+ * (ADR 0002). Given the omniscient battle state and the current request, it
+ * returns a Showdown choice string.
+ *
+ * Competence is layered as an ordered decision tree; each layer only fires when
+ * the earlier, higher-priority ones decline:
+ *   1. secure a KO we can safely land          (max-damage core)
+ *   2. pivot out of a losing matchup           (matchup switching)
+ *   3. heal when worn down and safe            (recovery / stall)
+ *   4. lay Spikes / spin them away             (hazards)
+ *   5. spread status on a fresh target         (Toxic / paralysis / burn)
+ *   6. set up when the foe can't pressure us   (Dragon Dance, Calm Mind, ...)
+ *   7. otherwise hit as hard as possible       (max-damage fallback)
+ *
+ * Per ADR 0002 / the PRD, the Pilot is never asserted move-by-move: its
+ * competence is judged only through outcome thresholds at the `evaluate` seam.
+ */
+import { BattleStreams } from '@pkmn/sim';
+import { bestDamageFraction, estimateDamageFraction, resolveMove, } from './damage.js';
+// --- Move classifications -------------------------------------------------
+const RECOVERY = new Set([
+    'recover', 'softboiled', 'milkdrink', 'slackoff', 'moonlight', 'morningsun',
+    'synthesis', 'rest', 'wish',
+]);
+const SPIKES = 'spikes';
+const RAPID_SPIN = 'rapidspin';
+const TOXIC = 'toxic';
+const PARALYZE = new Set(['thunderwave', 'stunspore', 'glare']);
+const BURN = new Set(['willowisp']);
+const PHAZE = new Set(['roar', 'whirlwind']);
+/** Setup moves → the offensive stat they raise and the boost level to stop at. */
+const SETUP = {
+    swordsdance: { stat: 'atk', cap: 2 },
+    dragondance: { stat: 'atk', cap: 2 },
+    bulkup: { stat: 'atk', cap: 2 },
+    curse: { stat: 'atk', cap: 2 },
+    calmmind: { stat: 'spa', cap: 3 },
+    agility: { stat: 'spe', cap: 2 },
+};
+// --- Small state helpers --------------------------------------------------
+function hpFraction(p) {
+    return p.maxhp > 0 ? p.hp / p.maxhp : 0;
+}
+function effectiveSpeed(p) {
+    let spe = p.getStat('spe');
+    if (p.status === 'par')
+        spe = Math.floor(spe * 0.25);
+    return spe;
+}
+function spikesLayers(side) {
+    const cond = side.sideConditions?.['spikes'];
+    if (!cond)
+        return 0;
+    return typeof cond.layers === 'number' ? cond.layers : 1;
+}
+/** Find the live battle Pokemon matching a request slot (Species Clause ⇒ unique). */
+function battleMon(team, rp) {
+    const species = (rp.details.split(',')[0] ?? '').trim();
+    return team.find((m) => m && m.species && m.species.name === species) ?? null;
+}
+function isFainted(rp) {
+    return rp.condition.includes('fnt');
+}
+/** Moves that are actually choosable this turn (present, not disabled, PP left). */
+function usableMoves(battle, me, active) {
+    const out = [];
+    active.moves.forEach((rm, i) => {
+        if (rm.disabled)
+            return;
+        if (typeof rm.pp === 'number' && rm.pp <= 0)
+            return;
+        const name = me.set?.moves?.[i] ?? rm.move ?? rm.id;
+        out.push({ index: i, move: resolveMove(battle, name) });
+    });
+    return out;
+}
+// --- Status legality (heuristic, Gen 3) -----------------------------------
+function canToxic(foe) {
+    return (!foe.types.includes('Steel') &&
+        !foe.types.includes('Poison') &&
+        foe.ability !== 'immunity');
+}
+function canParalyze(battle, moveId, foe) {
+    if (foe.ability === 'limber')
+        return false;
+    // Thunder Wave respects Electric-type immunity (Ground is immune); powders don't hit Grass? (Grass isn't immune in gen 3).
+    if (moveId === 'thunderwave' && !battle.dex.getImmunity('Electric', foe.types))
+        return false;
+    return true;
+}
+function canBurn(foe) {
+    return !foe.types.includes('Fire') && foe.ability !== 'waterveil';
+}
+/**
+ * Best Pokemon to bring in against `foe`: the one that takes the least from the
+ * foe's hardest hit, lightly favouring candidates that threaten back.
+ * `requireOffense` filters to candidates that can actually dent the foe.
+ */
+function bestSwitch(battle, sideID, request, foe, requireOffense = false) {
+    const myIdx = sideID === 'p1' ? 0 : 1;
+    const team = battle.sides[myIdx]?.pokemon ?? [];
+    let best = null;
+    let bestValue = -Infinity;
+    request.side.pokemon.forEach((rp, i) => {
+        if (rp.active || isFainted(rp))
+            return;
+        const c = battleMon(team, rp);
+        if (!c)
+            return;
+        const foeDamage = bestDamageFraction(battle, foe, c);
+        const myDamage = bestDamageFraction(battle, c, foe);
+        if (requireOffense && myDamage < 0.12)
+            return;
+        // Favour candidates that take the least from the foe's hardest hit, with a
+        // small bonus for those that threaten back.
+        const value = -foeDamage + 0.3 * Math.min(myDamage, 1);
+        if (value > bestValue) {
+            bestValue = value;
+            best = { choiceIndex: i + 1, foeDamage };
+        }
+    });
+    return best;
+}
+// --- The decision ---------------------------------------------------------
+function defaultMove(active) {
+    const i = active.moves.findIndex((m) => !m.disabled && (m.pp === undefined || m.pp > 0));
+    return i >= 0 ? `move ${i + 1}` : 'move 1';
+}
+/** The first alive benched Pokemon, as a `switch N` choice (or `pass`). */
+function firstAliveSwitch(request) {
+    const i = request.side.pokemon.findIndex((p) => !p.active && !isFainted(p));
+    return i >= 0 ? `switch ${i + 1}` : 'pass';
+}
+export function chooseAction(battle, sideID, request) {
+    const myIdx = sideID === 'p1' ? 0 : 1;
+    const mySide = battle.sides[myIdx];
+    const foeSide = battle.sides[1 - myIdx];
+    const me = mySide?.active?.[0];
+    const foe = foeSide?.active?.[0];
+    // Forced to send in a new Pokemon (ours fainted / was dragged out).
+    if (request.forceSwitch?.[0]) {
+        if (foe) {
+            const sw = bestSwitch(battle, sideID, request, foe);
+            if (sw)
+                return `switch ${sw.choiceIndex}`;
+        }
+        return firstAliveSwitch(request);
+    }
+    const active = request.active?.[0];
+    if (!active)
+        return 'default'; // team preview (none in gen 3) or nothing to do
+    if (!me || !foe || !mySide || !foeSide)
+        return defaultMove(active);
+    const usable = usableMoves(battle, me, active);
+    const damaging = usable
+        .map((u) => ({ ...u, frac: estimateDamageFraction(battle, me, foe, u.move) }))
+        .filter((u) => u.frac > 0)
+        .sort((a, b) => b.frac * b.move.accuracy - a.frac * a.move.accuracy);
+    const best = damaging[0];
+    const myHp = hpFraction(me);
+    const foeHp = hpFraction(foe);
+    const foeThreat = bestDamageFraction(battle, foe, me);
+    const iAmFaster = effectiveSpeed(me) > effectiveSpeed(foe);
+    const myKO = best ? best.frac >= foeHp : false;
+    const foeKO = foeThreat >= myHp;
+    const safe = !foeKO || (iAmFaster && myKO);
+    const trapped = active.trapped || active.maybeTrapped;
+    const canSwitch = !trapped && request.side.pokemon.some((p) => !p.active && !isFainted(p));
+    // 1) Secure a KO we can safely land.
+    if (best && myKO && (iAmFaster || !foeKO))
+        return `move ${best.index + 1}`;
+    // 2) Losing matchup: the foe threatens to KO us and we can't KO first — pivot
+    //    to a teammate that walls it better.
+    if (canSwitch && foeKO && !(myKO && iAmFaster)) {
+        const sw = bestSwitch(battle, sideID, request, foe);
+        if (sw && sw.foeDamage < foeThreat * 0.85 && sw.foeDamage < 0.6) {
+            return `switch ${sw.choiceIndex}`;
+        }
+    }
+    const foeBoosted = foe.boosts.atk > 0 || foe.boosts.spa > 0 || foe.boosts.spe > 0;
+    const foeHasSub = !!foe.volatiles && 'substitute' in foe.volatiles;
+    const strongHit = !!best && best.frac >= 0.45;
+    // 3) Phaze a Pokemon setting up on us — undo its boosts and rack Spikes chip.
+    if (foeBoosted && (iAmFaster || !foeKO)) {
+        const phaze = usable.find((u) => PHAZE.has(u.move.id));
+        if (phaze)
+            return `move ${phaze.index + 1}`;
+    }
+    // 4) Defensive utility — the heart of competent stall. A wall stays in on a
+    //    foe it can't hurt (as long as it's safe) and does something useful:
+    //    heal, lay Spikes, cripple with burn/Toxic/paralysis, spin hazards away.
+    if (safe) {
+        if (myHp < 0.55) {
+            const rec = usable.find((u) => RECOVERY.has(u.move.id));
+            if (rec)
+                return `move ${rec.index + 1}`;
+        }
+        const spikes = usable.find((u) => u.move.id === SPIKES);
+        if (spikes && spikesLayers(foeSide) < 3)
+            return `move ${spikes.index + 1}`;
+        // Status is worth a turn only when we can't just beat the foe down.
+        if (!strongHit && foe.status === '' && !foeHasSub) {
+            const foePhysical = foe.getStat('atk') >= foe.getStat('spa');
+            if (foePhysical) {
+                const wisp = usable.find((u) => BURN.has(u.move.id) && canBurn(foe));
+                if (wisp)
+                    return `move ${wisp.index + 1}`;
+            }
+            if (foeHp > 0.5) {
+                const toxic = usable.find((u) => u.move.id === TOXIC);
+                if (toxic && canToxic(foe))
+                    return `move ${toxic.index + 1}`;
+            }
+            if (!iAmFaster) {
+                const para = usable.find((u) => PARALYZE.has(u.move.id) && canParalyze(battle, u.move.id, foe));
+                if (para)
+                    return `move ${para.index + 1}`;
+            }
+        }
+        const spin = usable.find((u) => u.move.id === RAPID_SPIN);
+        if (spin && spikesLayers(mySide) > 0)
+            return `move ${spin.index + 1}`;
+        // 5) Set up while the foe can't pressure us.
+        if (foeThreat < 0.35 && foeHp > 0.6) {
+            const setup = usable.find((u) => {
+                const s = SETUP[u.move.id];
+                return s && me.boosts[s.stat] < s.cap;
+            });
+            if (setup)
+                return `move ${setup.index + 1}`;
+        }
+    }
+    // 6) Otherwise, hit as hard as possible.
+    if (best && best.frac >= 0.06)
+        return `move ${best.index + 1}`;
+    // 7) We can't meaningfully damage the foe. If safe with nothing useful left,
+    //    pivot to a teammate that threatens it; else make the best move we have.
+    if (canSwitch) {
+        const sw = bestSwitch(battle, sideID, request, foe, /*requireOffense*/ true);
+        if (sw && sw.foeDamage < 0.85)
+            return `switch ${sw.choiceIndex}`;
+    }
+    if (best)
+        return `move ${best.index + 1}`;
+    if (usable[0])
+        return `move ${usable[0].index + 1}`;
+    return defaultMove(active);
+}
+/**
+ * A player that drives one side of a BattleStream with the heuristic Pilot.
+ * It reads the shared omniscient {@link Battle} through `getBattle` (both sides
+ * see the same information, so the contest stays fair).
+ */
+export class PilotPlayer extends BattleStreams.BattlePlayer {
+    getBattle;
+    sideID;
+    /** Guards against re-entrant recovery within a single stuck decision. */
+    recovering = false;
+    constructor(playerStream, getBattle, sideID) {
+        super(playerStream);
+        this.getBattle = getBattle;
+        this.sideID = sideID;
+    }
+    receiveRequest(request) {
+        this.recovering = false; // a fresh request clears any prior recovery
+        if (request?.wait)
+            return; // opponent must act; nothing for us to choose
+        const battle = this.getBattle();
+        if (!battle) {
+            this.choose('default');
+            return;
+        }
+        this.choose(chooseAction(battle, this.sideID, request));
+    }
+    /**
+     * Safety net: if the heuristic ever produces an illegal choice (e.g. an
+     * uncertain trap it mis-read), fall back to the safest legal action instead
+     * of aborting the whole evaluation. Any other error still propagates.
+     */
+    receiveError(error) {
+        if (!this.recovering && /\[(Invalid|Unavailable) choice\]/.test(error.message)) {
+            this.recovering = true;
+            this.choose('default');
+            return;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=pilot.js.map

package/dist/pilot/pilot.js.map

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

package/dist/ranking.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Ranking / aggregation. Strength is a win-rate under the Pilot; each row also
+ * carries a 95% Wilson confidence interval so callers don't over-read a
+ * difference that's within noise. Elo/Glicko is deferred (out of scope).
+ */
+import type { MatchupResult, StrengthRow } from './types.js';
+/**
+ * Wilson score interval for a binomial proportion. `successes` may be
+ * fractional (ties count as half a win); `n` is the battle count.
+ */
+export declare function wilsonInterval(successes: number, n: number, z?: number): [number, number];
+/** Fractional successes for a matchup: full for wins, half for ties. */
+export declare function successes(m: {
+    wins: number;
+    battles: number;
+    winRate: number;
+}): number;
+/**
+ * Build a Strength row for one Team from its per-opponent matchups. Overall
+ * Strength is total successes over total battles (a raw win-rate), which for
+ * equal battle counts per matchup equals the mean of the per-matchup win-rates.
+ */
+export declare function buildStrengthRow(team: string, matchups: MatchupResult[]): StrengthRow;
+/** Sort strongest first; ties broken by name so the order is deterministic. */
+export declare function rankRows(rows: StrengthRow[]): StrengthRow[];

package/dist/ranking.js

@@ -0,0 +1,40 @@
+/**
+ * Wilson score interval for a binomial proportion. `successes` may be
+ * fractional (ties count as half a win); `n` is the battle count.
+ */
+export function wilsonInterval(successes, n, z = 1.96) {
+    if (n <= 0)
+        return [0, 0];
+    const p = successes / n;
+    const z2 = z * z;
+    const denom = 1 + z2 / n;
+    const center = (p + z2 / (2 * n)) / denom;
+    const margin = (z * Math.sqrt((p * (1 - p) + z2 / (4 * n)) / n)) / denom;
+    return [Math.max(0, center - margin), Math.min(1, center + margin)];
+}
+/** Fractional successes for a matchup: full for wins, half for ties. */
+export function successes(m) {
+    return m.winRate * m.battles;
+}
+/**
+ * Build a Strength row for one Team from its per-opponent matchups. Overall
+ * Strength is total successes over total battles (a raw win-rate), which for
+ * equal battle counts per matchup equals the mean of the per-matchup win-rates.
+ */
+export function buildStrengthRow(team, matchups) {
+    const battles = matchups.reduce((s, m) => s + m.battles, 0);
+    const succ = matchups.reduce((s, m) => s + successes(m), 0);
+    const strength = battles > 0 ? succ / battles : 0;
+    return {
+        team,
+        strength,
+        battles,
+        ci95: wilsonInterval(succ, battles),
+        matchups,
+    };
+}
+/** Sort strongest first; ties broken by name so the order is deterministic. */
+export function rankRows(rows) {
+    return [...rows].sort((a, b) => b.strength - a.strength || a.team.localeCompare(b.team));
+}
+//# sourceMappingURL=ranking.js.map

package/dist/ranking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.js","sourceRoot":"","sources":["../src/ranking.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,CAAS,EAAE,CAAC,GAAG,IAAI;IACnE,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,CAAqD;IAC7E,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAyB;IACtE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,OAAO;QACP,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC;QACnC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,IAAmB;IAC1C,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/seed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Deterministic seed derivation. A single master seed (a string) threads through
+ * the whole run; every Battle gets a sub-seed derived from the master plus the
+ * pairing and battle indices, so a fixed master reproduces identical results
+ * regardless of iteration order.
+ */
+/** `@pkmn/sim`'s PRNG seed: four 16-bit words. */
+export type PRNGSeed = [number, number, number, number];
+/**
+ * Derive a reproducible 4-word PRNG seed from the master seed and any number of
+ * integer indices (e.g. team index, opponent index, battle index).
+ */
+export declare function deriveSeed(master: string, ...ints: number[]): PRNGSeed;

package/dist/seed.js

@@ -0,0 +1,42 @@
+/**
+ * Deterministic seed derivation. A single master seed (a string) threads through
+ * the whole run; every Battle gets a sub-seed derived from the master plus the
+ * pairing and battle indices, so a fixed master reproduces identical results
+ * regardless of iteration order.
+ */
+function fnv1a(master, ints) {
+    let h = 2166136261 >>> 0;
+    const mix = (x) => {
+        h ^= x & 0xff;
+        h = Math.imul(h, 16777619) >>> 0;
+        h ^= (x >>> 8) & 0xff;
+        h = Math.imul(h, 16777619) >>> 0;
+        h ^= (x >>> 16) & 0xff;
+        h = Math.imul(h, 16777619) >>> 0;
+        h ^= (x >>> 24) & 0xff;
+        h = Math.imul(h, 16777619) >>> 0;
+    };
+    for (let i = 0; i < master.length; i++)
+        mix(master.charCodeAt(i));
+    mix(0x9e3779b1);
+    for (const n of ints)
+        mix(n >>> 0);
+    return h >>> 0;
+}
+/**
+ * Derive a reproducible 4-word PRNG seed from the master seed and any number of
+ * integer indices (e.g. team index, opponent index, battle index).
+ */
+export function deriveSeed(master, ...ints) {
+    let s = fnv1a(master, ints);
+    // mulberry32 stepped four times → four independent 16-bit words.
+    const next = () => {
+        s = (s + 0x6d2b79f5) >>> 0;
+        let t = s;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return (t ^ (t >>> 14)) >>> 0;
+    };
+    return [next() % 65536, next() % 65536, next() % 65536, next() % 65536];
+}
+//# sourceMappingURL=seed.js.map

package/dist/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,SAAS,KAAK,CAAC,MAAc,EAAE,IAAc;IAC3C,IAAI,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE;QACxB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACd,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;QACtB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,UAAU,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,GAAG,IAAc;IAC1D,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,iEAAiE;IACjE,MAAM,IAAI,GAAG,GAAW,EAAE;QACxB,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/team.d.ts

@@ -0,0 +1,29 @@
+import type { PokemonSet } from '@pkmn/sim';
+import { type Submission, type ValidationError } from './types.js';
+export type Team = PokemonSet[];
+/** A submission that parsed and passed Gen 3 OU legality. */
+export interface LegalTeam {
+    name: string;
+    team: Team;
+    /** The packed form fed to the sim's `>player` command. */
+    packed: string;
+}
+/**
+ * Split a raw paste that may hold several Teams (Showdown's multi-team export
+ * uses `=== [format] name ===` header lines) into one {@link Submission} each.
+ * A paste with no header markers is treated as a single unnamed Team.
+ */
+export declare function splitSubmissions(raw: string): Submission[];
+/** Normalize the flexible `teams` input of {@link EvaluateInput} into Submissions. */
+export declare function toSubmissions(input: string | Array<string | Submission>): Submission[];
+export interface ParseOutcome {
+    legal: LegalTeam[];
+    errors: ValidationError[];
+}
+/**
+ * Parse and legality-check a batch of submissions. Never throws for team
+ * content problems: unparseable or illegal Teams become {@link ValidationError}s.
+ */
+export declare function parseAndValidate(submissions: Submission[]): ParseOutcome;
+/** Round-trip a single paste through parse + serialize (used by tests/tools). */
+export declare function reserialize(paste: string): string;

package/dist/team.js

@@ -0,0 +1,100 @@
+/**
+ * Team I/O — parse and serialize Showdown paste text and validate legality as
+ * Gen 3 OU. Illegal Teams surface as {@link ValidationError} values rather than
+ * throwing, so the `evaluate` seam can report them instead of crashing.
+ */
+import { Teams, TeamValidator } from '@pkmn/sim';
+import { FORMAT } from './types.js';
+// One shared validator; constructing it parses the whole gen-3 ruleset.
+const validator = new TeamValidator(FORMAT);
+/**
+ * Split a raw paste that may hold several Teams (Showdown's multi-team export
+ * uses `=== [format] name ===` header lines) into one {@link Submission} each.
+ * A paste with no header markers is treated as a single unnamed Team.
+ */
+export function splitSubmissions(raw) {
+    const headerRe = /^===\s*(?:\[[^\]]*\]\s*)?(.*?)\s*===\s*$/;
+    const lines = raw.replace(/\r\n/g, '\n').split('\n');
+    const hasHeaders = lines.some((l) => headerRe.test(l.trim()));
+    if (!hasHeaders) {
+        const paste = raw.trim();
+        return paste ? [{ name: '', paste }] : [];
+    }
+    const out = [];
+    let name = '';
+    let buf = [];
+    const flush = () => {
+        const paste = buf.join('\n').trim();
+        if (paste)
+            out.push({ name, paste });
+        buf = [];
+    };
+    for (const line of lines) {
+        const m = headerRe.exec(line.trim());
+        if (m) {
+            flush();
+            name = (m[1] ?? '').trim();
+        }
+        else {
+            buf.push(line);
+        }
+    }
+    flush();
+    return out;
+}
+/** Normalize the flexible `teams` input of {@link EvaluateInput} into Submissions. */
+export function toSubmissions(input) {
+    if (typeof input === 'string')
+        return splitSubmissions(input);
+    const out = [];
+    for (const entry of input) {
+        if (typeof entry === 'string')
+            out.push(...splitSubmissions(entry));
+        else
+            out.push(entry);
+    }
+    return out;
+}
+/** A fallback display name derived from a parsed Team's lead species. */
+function defaultName(team, index) {
+    const lead = team[0];
+    const species = lead?.species || lead?.name;
+    return species ? `${species} team` : `Team ${index + 1}`;
+}
+/**
+ * Parse and legality-check a batch of submissions. Never throws for team
+ * content problems: unparseable or illegal Teams become {@link ValidationError}s.
+ */
+export function parseAndValidate(submissions) {
+    const legal = [];
+    const errors = [];
+    submissions.forEach((sub, i) => {
+        let team;
+        try {
+            team = Teams.import(sub.paste);
+        }
+        catch (e) {
+            team = null;
+        }
+        const name = sub.name || (team ? defaultName(team, i) : `Team ${i + 1}`);
+        if (!team || team.length === 0) {
+            errors.push({ team: name, problems: ['Could not parse any Pokémon from the paste.'] });
+            return;
+        }
+        const problems = validator.validateTeam(team);
+        if (problems && problems.length > 0) {
+            errors.push({ team: name, problems });
+            return;
+        }
+        legal.push({ name, team, packed: Teams.pack(team) });
+    });
+    return { legal, errors };
+}
+/** Round-trip a single paste through parse + serialize (used by tests/tools). */
+export function reserialize(paste) {
+    const team = Teams.import(paste);
+    if (!team)
+        throw new Error('unparseable team');
+    return Teams.export(team);
+}
+//# sourceMappingURL=team.js.map

package/dist/team.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Public result contract for the evaluation harness.
+ *
+ * This is the structure the Slice-2 Critic will read, so it is the stable
+ * shape callers depend on. See the PRD "Results contract".
+ */
+export declare const FORMAT: "gen3ou";
+export type Mode = 'gauntlet' | 'round-robin';
+/** A team the user submitted for evaluation, as Showdown paste text. */
+export interface Submission {
+    /** Display name for reports (defaults to the lead species when omitted). */
+    name: string;
+    /** Standard Showdown export/paste text for one Team. */
+    paste: string;
+}
+/** Opposition configuration: what the submitted Teams are measured against. */
+export type Opposition = {
+    mode: 'gauntlet';
+    gauntletVersion?: string;
+} | {
+    mode: 'round-robin';
+};
+export interface EvaluateInput {
+    /**
+     * Submitted Teams. Either an array of pastes / {name,paste} entries, or a
+     * single string containing one or more Teams (multi-team `=== name ===`
+     * markers are split apart).
+     */
+    teams: string | Array<string | Submission>;
+    opposition: Opposition;
+    /** Battles run per Team-vs-opponent pairing (sides swapped 50/50). */
+    battlesPerPairing?: number;
+    /** Master seed; identical seed + teams + config reproduces identical results. */
+    seed?: string;
+}
+/** A submitted Team that failed Gen 3 OU legality, named so the user can fix it. */
+export interface ValidationError {
+    team: string;
+    problems: string[];
+}
+/** Win-rate of a submitted Team against one specific opponent. */
+export interface MatchupResult {
+    /** Opponent name — a Gauntlet member or a peer Team. */
+    opponent: string;
+    /** Archetype label of the opponent (Gauntlet members only). */
+    archetype?: string;
+    /** Battles won outright. */
+    wins: number;
+    /** Battles that ended in a tie (counted as half a win in `winRate`). */
+    ties: number;
+    battles: number;
+    /** (wins + ties/2) / battles, in [0, 1]. */
+    winRate: number;
+}
+/** One row of the Strength ranking. */
+export interface StrengthRow {
+    team: string;
+    /** Overall Strength: win-rate under the Pilot, in [0, 1]. */
+    strength: number;
+    battles: number;
+    /** 95% Wilson confidence interval on the overall win-rate. */
+    ci95: [number, number];
+    /** Per-opponent breakdown. */
+    matchups: MatchupResult[];
+}
+/** The full structured result returned from the single `evaluate` seam. */
+export interface EvaluationResult {
+    mode: Mode;
+    seed: string;
+    /** Present in gauntlet mode; records which Gauntlet version produced the result. */
+    gauntletVersion?: string;
+    battlesPerPairing: number;
+    /** Strength rows, sorted strongest first. */
+    ranking: StrengthRow[];
+    /** Submitted Teams that were illegal and therefore not run. */
+    errors: ValidationError[];
+}