@mythxengine/engine 0.1.0

package/dist/__tests__/resolution.test.js

@@ -0,0 +1,362 @@
+/**
+ * Tests for test and combat resolution with advantage/disadvantage
+ */
+import { describe, it, expect } from "vitest";
+import { resolveTest } from "../resolution/test.js";
+import { resolveAttack } from "../resolution/combat.js";
+import { createRNG } from "../rng/index.js";
+// Test character factory
+function createTestCharacter(overrides = {}) {
+    return {
+        id: "test-char",
+        name: "Test Character",
+        abilities: { STR: 2, AGI: 1, WIT: 0, CON: 1 },
+        hp: { current: 20, max: 20 },
+        skills: [
+            { id: "combat", name: "Combat", ability: "STR", bonus: 2, description: "Fighting" },
+            { id: "stealth", name: "Stealth", ability: "AGI", bonus: 3, description: "Sneaking" },
+        ],
+        specialAbilities: [],
+        conditions: [],
+        flags: [],
+        background: "Test background",
+        personality: [],
+        psychology: { fears: [], goals: [], ambitions: [], bonds: [], flaws: [] },
+        archetypeId: "test",
+        equipment: { weapons: [], armor: null, gear: [] },
+        ...overrides,
+    };
+}
+// Test enemy factory
+function createTestEnemy(overrides = {}) {
+    return {
+        id: "test-enemy",
+        name: "Test Enemy",
+        description: "A test enemy",
+        abilities: { STR: 1, AGI: 0, WIT: -1, CON: 0 },
+        hp: { current: 15, max: 15 },
+        conditions: [],
+        attacks: [{ name: "Claw", damage: "d6", ability: "STR" }],
+        armor: 1,
+        threat: "standard",
+        ...overrides,
+    };
+}
+describe("resolveTest with advantage", () => {
+    it("returns normal advantage state by default", () => {
+        const character = createTestCharacter();
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+        });
+        expect(result.advantageState).toBe("normal");
+        expect(result.roll.advantage).toBeUndefined();
+    });
+    it("applies explicit advantage sources", () => {
+        const character = createTestCharacter();
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+            advantageSources: ["hiding in shadows"],
+        });
+        expect(result.advantageState).toBe("advantage");
+        expect(result.roll.advantage).toBeDefined();
+        expect(result.roll.advantage.type).toBe("advantage");
+    });
+    it("applies explicit disadvantage sources", () => {
+        const character = createTestCharacter();
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+            disadvantageSources: ["noisy armor"],
+        });
+        expect(result.advantageState).toBe("disadvantage");
+        expect(result.roll.advantage).toBeDefined();
+        expect(result.roll.advantage.type).toBe("disadvantage");
+    });
+    it("cancels advantage and disadvantage", () => {
+        const character = createTestCharacter();
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+            advantageSources: ["hiding in shadows"],
+            disadvantageSources: ["noisy armor"],
+        });
+        expect(result.advantageState).toBe("normal");
+        expect(result.roll.advantage).toBeUndefined();
+    });
+    it("applies advantage from conditions", () => {
+        const character = createTestCharacter({
+            conditions: [
+                {
+                    id: "blessed",
+                    name: "Blessed",
+                    description: "Advantage on all rolls",
+                    duration: 3,
+                    effects: [{ type: "GRANT_ADVANTAGE", scope: "all" }],
+                    stackable: false,
+                },
+            ],
+        });
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+        });
+        expect(result.advantageState).toBe("advantage");
+    });
+    it("applies disadvantage from conditions", () => {
+        const character = createTestCharacter({
+            conditions: [
+                {
+                    id: "cursed",
+                    name: "Cursed",
+                    description: "Disadvantage on all rolls",
+                    duration: 3,
+                    effects: [{ type: "GRANT_DISADVANTAGE", scope: "skill_tests" }],
+                    stackable: false,
+                },
+            ],
+        });
+        const rng = createRNG(42);
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+        });
+        expect(result.advantageState).toBe("disadvantage");
+    });
+    it("combines explicit and condition advantage sources", () => {
+        const character = createTestCharacter({
+            conditions: [
+                {
+                    id: "blessed",
+                    name: "Blessed",
+                    description: "Advantage",
+                    duration: 3,
+                    effects: [{ type: "GRANT_ADVANTAGE", scope: "all" }],
+                    stackable: false,
+                },
+            ],
+        });
+        const rng = createRNG(42);
+        // Condition gives advantage, explicit gives disadvantage - should cancel
+        const result = resolveTest({
+            character,
+            skill: "Stealth",
+            difficulty: 12,
+            rng,
+            disadvantageSources: ["darkness"],
+        });
+        expect(result.advantageState).toBe("normal");
+    });
+});
+describe("resolveAttack with advantage", () => {
+    const weapon = { name: "Sword", damage: "d8", ability: "STR" };
+    it("returns normal advantage state by default", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy();
+        const rng = createRNG(42);
+        const result = resolveAttack({
+            attacker,
+            defender,
+            weapon,
+            rng,
+        });
+        expect(result.advantageState).toBe("normal");
+    });
+    it("applies explicit advantage on attacks", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy();
+        const rng = createRNG(42);
+        const result = resolveAttack({
+            attacker,
+            defender,
+            weapon,
+            rng,
+            advantageSources: ["flanking"],
+        });
+        expect(result.advantageState).toBe("advantage");
+        expect(result.roll.advantage).toBeDefined();
+    });
+    it("applies advantage from attacker conditions", () => {
+        const attacker = createTestCharacter({
+            conditions: [
+                {
+                    id: "hidden",
+                    name: "Hidden",
+                    description: "Advantage on attacks",
+                    duration: "until_rest",
+                    effects: [{ type: "GRANT_ADVANTAGE", scope: "attacks" }],
+                    stackable: false,
+                },
+            ],
+        });
+        const defender = createTestEnemy();
+        const rng = createRNG(42);
+        const result = resolveAttack({
+            attacker,
+            defender,
+            weapon,
+            rng,
+        });
+        expect(result.advantageState).toBe("advantage");
+    });
+});
+describe("resolveAttack with resistance/vulnerability", () => {
+    const weapon = { name: "Fire Blade", damage: "d8", ability: "STR" };
+    it("halves damage when defender has resistance", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy({
+            conditions: [
+                {
+                    id: "fire-resist",
+                    name: "Fire Resistant",
+                    description: "Takes half fire damage",
+                    duration: "permanent",
+                    effects: [{ type: "RESISTANCE", damageType: "fire" }],
+                    stackable: false,
+                },
+            ],
+        });
+        // Need to find a seed that hits
+        let result;
+        for (let seed = 1; seed < 1000; seed++) {
+            const testRng = createRNG(seed);
+            result = resolveAttack({
+                attacker,
+                defender,
+                weapon,
+                rng: testRng,
+                damageType: "fire",
+            });
+            if (result.hit && result.damage !== undefined)
+                break;
+        }
+        expect(result.hit).toBe(true);
+        expect(result.damageModification).toBeDefined();
+        expect(result.damageModification.reason).toBe("resistance");
+        expect(result.damageModification.damageType).toBe("fire");
+        expect(result.damageModification.finalDamage).toBeLessThan(result.damageModification.originalDamage);
+    });
+    it("doubles damage when defender has vulnerability", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy({
+            conditions: [
+                {
+                    id: "fire-vuln",
+                    name: "Fire Vulnerable",
+                    description: "Takes double fire damage",
+                    duration: "permanent",
+                    effects: [{ type: "VULNERABILITY", damageType: "fire" }],
+                    stackable: false,
+                },
+            ],
+        });
+        // Find a seed that hits
+        let result;
+        for (let seed = 1; seed < 1000; seed++) {
+            const testRng = createRNG(seed);
+            result = resolveAttack({
+                attacker,
+                defender,
+                weapon,
+                rng: testRng,
+                damageType: "fire",
+            });
+            if (result.hit && result.damage !== undefined)
+                break;
+        }
+        expect(result.hit).toBe(true);
+        expect(result.damageModification).toBeDefined();
+        expect(result.damageModification.reason).toBe("vulnerability");
+        expect(result.damageModification.finalDamage).toBeGreaterThan(result.damageModification.originalDamage);
+    });
+    it("cancels resistance and vulnerability", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy({
+            conditions: [
+                {
+                    id: "fire-resist",
+                    name: "Fire Resistant",
+                    description: "Takes half fire damage",
+                    duration: "permanent",
+                    effects: [{ type: "RESISTANCE", damageType: "fire" }],
+                    stackable: false,
+                },
+                {
+                    id: "fire-vuln",
+                    name: "Cursed Vulnerability",
+                    description: "Takes double fire damage",
+                    duration: 3,
+                    effects: [{ type: "VULNERABILITY", damageType: "fire" }],
+                    stackable: false,
+                },
+            ],
+        });
+        // Find a seed that hits
+        let result;
+        for (let seed = 1; seed < 1000; seed++) {
+            const testRng = createRNG(seed);
+            result = resolveAttack({
+                attacker,
+                defender,
+                weapon,
+                rng: testRng,
+                damageType: "fire",
+            });
+            if (result.hit && result.damage !== undefined)
+                break;
+        }
+        expect(result.hit).toBe(true);
+        // When they cancel, there should be no damageModification
+        expect(result.damageModification).toBeUndefined();
+    });
+    it("does not apply resistance to different damage types", () => {
+        const attacker = createTestCharacter();
+        const defender = createTestEnemy({
+            conditions: [
+                {
+                    id: "fire-resist",
+                    name: "Fire Resistant",
+                    description: "Takes half fire damage",
+                    duration: "permanent",
+                    effects: [{ type: "RESISTANCE", damageType: "fire" }],
+                    stackable: false,
+                },
+            ],
+        });
+        // Find a seed that hits
+        let result;
+        for (let seed = 1; seed < 1000; seed++) {
+            const testRng = createRNG(seed);
+            result = resolveAttack({
+                attacker,
+                defender,
+                weapon,
+                rng: testRng,
+                damageType: "cold", // Different damage type
+            });
+            if (result.hit && result.damage !== undefined)
+                break;
+        }
+        expect(result.hit).toBe(true);
+        expect(result.damageModification).toBeUndefined();
+    });
+});
+//# sourceMappingURL=resolution.test.js.map

package/dist/__tests__/resolution.test.js.map

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

package/dist/__tests__/rng.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rng.test.d.ts.map

package/dist/__tests__/rng.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rng.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/rng.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { createRNG, mulberry32 } from "../rng/index.js";
+describe("mulberry32", () => {
+    it("produces deterministic sequences from the same seed", () => {
+        const gen1 = mulberry32(12345);
+        const gen2 = mulberry32(12345);
+        for (let i = 0; i < 100; i++) {
+            expect(gen1()).toBe(gen2());
+        }
+    });
+    it("produces different sequences from different seeds", () => {
+        const gen1 = mulberry32(12345);
+        const gen2 = mulberry32(54321);
+        // At least one of the first 10 values should differ
+        let allSame = true;
+        for (let i = 0; i < 10; i++) {
+            if (gen1() !== gen2()) {
+                allSame = false;
+                break;
+            }
+        }
+        expect(allSame).toBe(false);
+    });
+    it("produces values in [0, 1)", () => {
+        const gen = mulberry32(42);
+        for (let i = 0; i < 1000; i++) {
+            const val = gen();
+            expect(val).toBeGreaterThanOrEqual(0);
+            expect(val).toBeLessThan(1);
+        }
+    });
+});
+describe("createRNG", () => {
+    it("creates RNG from seed", () => {
+        const rng = createRNG(12345);
+        expect(rng.getState()).toEqual({ seed: 12345, cursor: 0 });
+    });
+    it("creates RNG from state", () => {
+        const rng = createRNG({ seed: 12345, cursor: 10 });
+        expect(rng.getState()).toEqual({ seed: 12345, cursor: 10 });
+    });
+    it("advances cursor on each call", () => {
+        const rng = createRNG(12345);
+        expect(rng.getState().cursor).toBe(0);
+        rng.next();
+        expect(rng.getState().cursor).toBe(1);
+        rng.next();
+        expect(rng.getState().cursor).toBe(2);
+    });
+    it("produces deterministic integers", () => {
+        const rng1 = createRNG(12345);
+        const rng2 = createRNG(12345);
+        for (let i = 0; i < 100; i++) {
+            expect(rng1.nextInt(1, 100)).toBe(rng2.nextInt(1, 100));
+        }
+    });
+    it("nextInt produces values in range", () => {
+        const rng = createRNG(42);
+        for (let i = 0; i < 1000; i++) {
+            const val = rng.nextInt(5, 15);
+            expect(val).toBeGreaterThanOrEqual(5);
+            expect(val).toBeLessThanOrEqual(15);
+        }
+    });
+    it("pick selects from array", () => {
+        const rng = createRNG(42);
+        const items = ["a", "b", "c", "d"];
+        for (let i = 0; i < 100; i++) {
+            expect(items).toContain(rng.pick(items));
+        }
+    });
+    it("shuffle returns all elements", () => {
+        const rng = createRNG(42);
+        const items = [1, 2, 3, 4, 5];
+        const shuffled = rng.shuffle(items);
+        expect(shuffled).toHaveLength(items.length);
+        expect(shuffled.sort()).toEqual(items.sort());
+    });
+    it("restoring from state continues same sequence", () => {
+        const rng1 = createRNG(12345);
+        // Advance 10 times
+        for (let i = 0; i < 10; i++) {
+            rng1.next();
+        }
+        const state = rng1.getState();
+        const expected = rng1.next();
+        // Create new RNG from state
+        const rng2 = createRNG(state);
+        const actual = rng2.next();
+        expect(actual).toBe(expected);
+    });
+});
+//# sourceMappingURL=rng.test.js.map

package/dist/__tests__/rng.test.js.map

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

package/dist/dice/advantage.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Advantage/disadvantage rolling mechanics
+ *
+ * Implements D&D 5e-style advantage/disadvantage:
+ * - Advantage: Roll 2d20, take the higher
+ * - Disadvantage: Roll 2d20, take the lower
+ * - Any advantage + any disadvantage = normal roll (they cancel)
+ * - Multiple advantages don't stack (still just 1 advantage)
+ */
+import type { DiceResult, RollAdvantageState, AdvantageInfo, Abilities } from "@mythxengine/types";
+import type { RNG } from "../rng/rng.js";
+/**
+ * Calculate the net advantage state from sources
+ *
+ * D&D 5e rules:
+ * - Any number of advantages + any number of disadvantages = normal
+ * - Multiple advantages = just advantage (no stacking)
+ * - Multiple disadvantages = just disadvantage (no stacking)
+ */
+export declare function calculateNetAdvantage(advantageSources: string[], disadvantageSources: string[]): RollAdvantageState;
+/**
+ * Roll a d20 with advantage or disadvantage
+ *
+ * @param rng - Random number generator
+ * @param advantageState - Whether to roll with advantage, disadvantage, or normal
+ * @returns Object with the selected roll and advantage info
+ */
+export declare function rollD20WithAdvantage(rng: RNG, advantageState: RollAdvantageState): {
+    natural: number;
+    advantageInfo?: AdvantageInfo;
+};
+/**
+ * Roll a dice expression with advantage/disadvantage support
+ *
+ * Note: Advantage/disadvantage only applies to d20 rolls.
+ * For non-d20 rolls, the advantageState is ignored.
+ *
+ * @param expression - Dice expression (e.g., "d20", "2d6+3")
+ * @param rng - Random number generator
+ * @param advantageState - Whether to roll with advantage, disadvantage, or normal
+ * @param abilities - Optional abilities for ability modifiers
+ * @returns Dice result with advantage info if applicable
+ */
+export declare function rollWithAdvantage(expression: string, rng: RNG, advantageState: RollAdvantageState, abilities?: Abilities): DiceResult;
+//# sourceMappingURL=advantage.d.ts.map

package/dist/dice/advantage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advantage.d.ts","sourceRoot":"","sources":["../../src/dice/advantage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGzC;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,mBAAmB,EAAE,MAAM,EAAE,GAC5B,kBAAkB,CAkBpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,kBAAkB,GACjC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,CAoBpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,GAAG,EACR,cAAc,EAAE,kBAAkB,EAClC,SAAS,CAAC,EAAE,SAAS,GACpB,UAAU,CAkDZ"}

package/dist/dice/advantage.js

@@ -0,0 +1,118 @@
+/**
+ * Advantage/disadvantage rolling mechanics
+ *
+ * Implements D&D 5e-style advantage/disadvantage:
+ * - Advantage: Roll 2d20, take the higher
+ * - Disadvantage: Roll 2d20, take the lower
+ * - Any advantage + any disadvantage = normal roll (they cancel)
+ * - Multiple advantages don't stack (still just 1 advantage)
+ */
+import { parseDice } from "./parser.js";
+/**
+ * Calculate the net advantage state from sources
+ *
+ * D&D 5e rules:
+ * - Any number of advantages + any number of disadvantages = normal
+ * - Multiple advantages = just advantage (no stacking)
+ * - Multiple disadvantages = just disadvantage (no stacking)
+ */
+export function calculateNetAdvantage(advantageSources, disadvantageSources) {
+    const hasAdvantage = advantageSources.length > 0;
+    const hasDisadvantage = disadvantageSources.length > 0;
+    if (hasAdvantage && hasDisadvantage) {
+        // They cancel out
+        return "normal";
+    }
+    if (hasAdvantage) {
+        return "advantage";
+    }
+    if (hasDisadvantage) {
+        return "disadvantage";
+    }
+    return "normal";
+}
+/**
+ * Roll a d20 with advantage or disadvantage
+ *
+ * @param rng - Random number generator
+ * @param advantageState - Whether to roll with advantage, disadvantage, or normal
+ * @returns Object with the selected roll and advantage info
+ */
+export function rollD20WithAdvantage(rng, advantageState) {
+    if (advantageState === "normal") {
+        return { natural: rng.nextInt(1, 20) };
+    }
+    // Roll two d20s
+    const roll1 = rng.nextInt(1, 20);
+    const roll2 = rng.nextInt(1, 20);
+    const isAdvantage = advantageState === "advantage";
+    const selected = isAdvantage ? Math.max(roll1, roll2) : Math.min(roll1, roll2);
+    return {
+        natural: selected,
+        advantageInfo: {
+            type: advantageState,
+            bothRolls: [roll1, roll2],
+            selected: isAdvantage ? "higher" : "lower",
+        },
+    };
+}
+/**
+ * Roll a dice expression with advantage/disadvantage support
+ *
+ * Note: Advantage/disadvantage only applies to d20 rolls.
+ * For non-d20 rolls, the advantageState is ignored.
+ *
+ * @param expression - Dice expression (e.g., "d20", "2d6+3")
+ * @param rng - Random number generator
+ * @param advantageState - Whether to roll with advantage, disadvantage, or normal
+ * @param abilities - Optional abilities for ability modifiers
+ * @returns Dice result with advantage info if applicable
+ */
+export function rollWithAdvantage(expression, rng, advantageState, abilities) {
+    const parsed = parseDice(expression);
+    // Advantage/disadvantage only applies to single d20 rolls
+    const isD20Roll = parsed.count === 1 && parsed.sides === 20;
+    let rolls;
+    let natural;
+    let advantageInfo;
+    if (isD20Roll && advantageState !== "normal") {
+        // Roll with advantage/disadvantage
+        const result = rollD20WithAdvantage(rng, advantageState);
+        natural = result.natural;
+        advantageInfo = result.advantageInfo;
+        rolls = [natural];
+    }
+    else {
+        // Normal roll
+        rolls = [];
+        for (let i = 0; i < parsed.count; i++) {
+            rolls.push(rng.nextInt(1, parsed.sides));
+        }
+        natural = rolls.reduce((sum, roll) => sum + roll, 0);
+    }
+    // Calculate modifier (including ability if specified)
+    let modifier = parsed.modifier;
+    if (parsed.ability && abilities) {
+        modifier += abilities[parsed.ability];
+    }
+    // Calculate total
+    const total = natural + modifier;
+    // Check for critical (only on d20)
+    let critical;
+    if (isD20Roll) {
+        if (natural === 20)
+            critical = "success";
+        if (natural === 1)
+            critical = "failure";
+    }
+    return {
+        expression,
+        rolls,
+        modifier,
+        total,
+        natural,
+        critical,
+        advantage: advantageInfo,
+    };
+}
+//# sourceMappingURL=advantage.js.map

package/dist/dice/advantage.js.map

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