@mythxengine/engine 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Proto Labs AI
+
+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/dist/__tests__/advantage.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for advantage/disadvantage mechanics
+ */
+export {};
+//# sourceMappingURL=advantage.test.d.ts.map

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

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

package/dist/__tests__/advantage.test.js

@@ -0,0 +1,126 @@
+/**
+ * Tests for advantage/disadvantage mechanics
+ */
+import { describe, it, expect } from "vitest";
+import { calculateNetAdvantage, rollD20WithAdvantage, rollWithAdvantage, } from "../dice/advantage.js";
+import { createRNG } from "../rng/index.js";
+describe("calculateNetAdvantage", () => {
+    it("returns normal when no sources", () => {
+        expect(calculateNetAdvantage([], [])).toBe("normal");
+    });
+    it("returns advantage when only advantage sources", () => {
+        expect(calculateNetAdvantage(["flanking"], [])).toBe("advantage");
+        expect(calculateNetAdvantage(["flanking", "high ground"], [])).toBe("advantage");
+    });
+    it("returns disadvantage when only disadvantage sources", () => {
+        expect(calculateNetAdvantage([], ["darkness"])).toBe("disadvantage");
+        expect(calculateNetAdvantage([], ["darkness", "wounded"])).toBe("disadvantage");
+    });
+    it("cancels advantage and disadvantage to normal", () => {
+        expect(calculateNetAdvantage(["flanking"], ["darkness"])).toBe("normal");
+        expect(calculateNetAdvantage(["flanking", "high ground"], ["darkness"])).toBe("normal");
+        expect(calculateNetAdvantage(["flanking"], ["darkness", "wounded"])).toBe("normal");
+    });
+});
+describe("rollD20WithAdvantage", () => {
+    it("returns single roll for normal state", () => {
+        const rng = createRNG(12345);
+        const result = rollD20WithAdvantage(rng, "normal");
+        expect(result.natural).toBeGreaterThanOrEqual(1);
+        expect(result.natural).toBeLessThanOrEqual(20);
+        expect(result.advantageInfo).toBeUndefined();
+    });
+    it("returns two rolls and selects higher for advantage", () => {
+        const rng = createRNG(42);
+        const result = rollD20WithAdvantage(rng, "advantage");
+        expect(result.advantageInfo).toBeDefined();
+        expect(result.advantageInfo.type).toBe("advantage");
+        expect(result.advantageInfo.selected).toBe("higher");
+        expect(result.advantageInfo.bothRolls).toHaveLength(2);
+        const [roll1, roll2] = result.advantageInfo.bothRolls;
+        expect(result.natural).toBe(Math.max(roll1, roll2));
+    });
+    it("returns two rolls and selects lower for disadvantage", () => {
+        const rng = createRNG(42);
+        const result = rollD20WithAdvantage(rng, "disadvantage");
+        expect(result.advantageInfo).toBeDefined();
+        expect(result.advantageInfo.type).toBe("disadvantage");
+        expect(result.advantageInfo.selected).toBe("lower");
+        expect(result.advantageInfo.bothRolls).toHaveLength(2);
+        const [roll1, roll2] = result.advantageInfo.bothRolls;
+        expect(result.natural).toBe(Math.min(roll1, roll2));
+    });
+    it("is deterministic with same seed", () => {
+        const rng1 = createRNG(12345);
+        const rng2 = createRNG(12345);
+        const result1 = rollD20WithAdvantage(rng1, "advantage");
+        const result2 = rollD20WithAdvantage(rng2, "advantage");
+        expect(result1.natural).toBe(result2.natural);
+        expect(result1.advantageInfo.bothRolls).toEqual(result2.advantageInfo.bothRolls);
+    });
+});
+describe("rollWithAdvantage", () => {
+    it("applies advantage to d20 rolls", () => {
+        const rng = createRNG(42);
+        const result = rollWithAdvantage("d20", rng, "advantage");
+        expect(result.advantage).toBeDefined();
+        expect(result.advantage.type).toBe("advantage");
+        expect(result.rolls).toHaveLength(1);
+        expect(result.rolls[0]).toBe(result.natural);
+    });
+    it("ignores advantage for non-d20 rolls", () => {
+        const rng = createRNG(42);
+        const result = rollWithAdvantage("2d6+3", rng, "advantage");
+        expect(result.advantage).toBeUndefined();
+        expect(result.rolls).toHaveLength(2);
+    });
+    it("ignores advantage for multiple d20 rolls", () => {
+        const rng = createRNG(42);
+        const result = rollWithAdvantage("2d20", rng, "advantage");
+        expect(result.advantage).toBeUndefined();
+        expect(result.rolls).toHaveLength(2);
+    });
+    it("includes modifier in total", () => {
+        const rng = createRNG(42);
+        const result = rollWithAdvantage("d20+5", rng, "normal");
+        expect(result.modifier).toBe(5);
+        expect(result.total).toBe(result.natural + 5);
+    });
+    it("detects critical success on nat 20", () => {
+        // Find a seed that gives a nat 20
+        let rng = createRNG(1);
+        let result;
+        for (let seed = 1; seed < 10000; seed++) {
+            rng = createRNG(seed);
+            result = rollWithAdvantage("d20", rng, "normal");
+            if (result.natural === 20)
+                break;
+        }
+        expect(result.natural).toBe(20);
+        expect(result.critical).toBe("success");
+    });
+    it("detects critical failure on nat 1", () => {
+        // Find a seed that gives a nat 1
+        let rng = createRNG(1);
+        let result;
+        for (let seed = 1; seed < 10000; seed++) {
+            rng = createRNG(seed);
+            result = rollWithAdvantage("d20", rng, "normal");
+            if (result.natural === 1)
+                break;
+        }
+        expect(result.natural).toBe(1);
+        expect(result.critical).toBe("failure");
+    });
+});
+describe("advantage integration with abilities", () => {
+    it("applies ability modifier to roll with advantage", () => {
+        const rng = createRNG(42);
+        const abilities = { STR: 2, AGI: 1, WIT: 0, CON: -1 };
+        const result = rollWithAdvantage("d20+STR", rng, "advantage", abilities);
+        expect(result.modifier).toBe(2);
+        expect(result.total).toBe(result.natural + 2);
+        expect(result.advantage).toBeDefined();
+    });
+});
+//# sourceMappingURL=advantage.test.js.map

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

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

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

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

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

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

package/dist/__tests__/dice.test.js

@@ -0,0 +1,150 @@
+import { describe, it, expect } from "vitest";
+import { parseDice, isValidDiceExpression, rollDice, rollDie, rollNd } from "../dice/index.js";
+import { createRNG } from "../rng/index.js";
+describe("parseDice", () => {
+    it("parses simple d20", () => {
+        expect(parseDice("d20")).toEqual({
+            count: 1,
+            sides: 20,
+            modifier: 0,
+            ability: undefined,
+        });
+    });
+    it("parses 2d6", () => {
+        expect(parseDice("2d6")).toEqual({
+            count: 2,
+            sides: 6,
+            modifier: 0,
+            ability: undefined,
+        });
+    });
+    it("parses d8+3", () => {
+        expect(parseDice("d8+3")).toEqual({
+            count: 1,
+            sides: 8,
+            modifier: 3,
+            ability: undefined,
+        });
+    });
+    it("parses 1d6-2", () => {
+        expect(parseDice("1d6-2")).toEqual({
+            count: 1,
+            sides: 6,
+            modifier: -2,
+            ability: undefined,
+        });
+    });
+    it("parses d20+STR", () => {
+        expect(parseDice("d20+STR")).toEqual({
+            count: 1,
+            sides: 20,
+            modifier: 0,
+            ability: "STR",
+        });
+    });
+    it("is case insensitive for abilities", () => {
+        expect(parseDice("d20+str").ability).toBe("STR");
+        expect(parseDice("d20+Agi").ability).toBe("AGI");
+    });
+    it("throws on invalid expression", () => {
+        expect(() => parseDice("invalid")).toThrow();
+        expect(() => parseDice("d")).toThrow();
+        expect(() => parseDice("2d")).toThrow();
+    });
+    it("throws on out of range values", () => {
+        expect(() => parseDice("0d6")).toThrow();
+        expect(() => parseDice("101d6")).toThrow();
+        expect(() => parseDice("1d0")).toThrow();
+        expect(() => parseDice("1d101")).toThrow();
+    });
+});
+describe("isValidDiceExpression", () => {
+    it("returns true for valid expressions", () => {
+        expect(isValidDiceExpression("d20")).toBe(true);
+        expect(isValidDiceExpression("2d6+3")).toBe(true);
+        expect(isValidDiceExpression("1d8-1")).toBe(true);
+        expect(isValidDiceExpression("d20+STR")).toBe(true);
+    });
+    it("returns false for invalid expressions", () => {
+        expect(isValidDiceExpression("invalid")).toBe(false);
+        expect(isValidDiceExpression("")).toBe(false);
+        expect(isValidDiceExpression("0d6")).toBe(false);
+    });
+});
+describe("rollDice", () => {
+    it("produces deterministic results with same RNG state", () => {
+        const rng1 = createRNG(12345);
+        const rng2 = createRNG(12345);
+        const result1 = rollDice("2d6+3", rng1);
+        const result2 = rollDice("2d6+3", rng2);
+        expect(result1).toEqual(result2);
+    });
+    it("returns correct structure", () => {
+        const rng = createRNG(42);
+        const result = rollDice("2d6+3", rng);
+        expect(result.expression).toBe("2d6+3");
+        expect(result.rolls).toHaveLength(2);
+        expect(result.modifier).toBe(3);
+        expect(result.natural).toBe(result.rolls[0] + result.rolls[1]);
+        expect(result.total).toBe(result.natural + result.modifier);
+    });
+    it("rolls are within die range", () => {
+        const rng = createRNG(42);
+        for (let i = 0; i < 100; i++) {
+            const result = rollDice("1d6", rng);
+            expect(result.rolls[0]).toBeGreaterThanOrEqual(1);
+            expect(result.rolls[0]).toBeLessThanOrEqual(6);
+        }
+    });
+    it("applies ability modifier", () => {
+        const rng = createRNG(42);
+        const abilities = { STR: 2, AGI: 1, WIT: 0, CON: -1 };
+        const result = rollDice("d20+STR", rng, abilities);
+        expect(result.modifier).toBe(2);
+    });
+    it("detects critical success on natural 20", () => {
+        // Find a seed that produces a natural 20
+        for (let seed = 0; seed < 10000; seed++) {
+            const rng = createRNG(seed);
+            const result = rollDice("d20", rng);
+            if (result.natural === 20) {
+                expect(result.critical).toBe("success");
+                return;
+            }
+        }
+        // If we get here, we didn't find a nat 20 (extremely unlikely)
+        expect(true).toBe(false);
+    });
+    it("detects critical failure on natural 1", () => {
+        // Find a seed that produces a natural 1
+        for (let seed = 0; seed < 10000; seed++) {
+            const rng = createRNG(seed);
+            const result = rollDice("d20", rng);
+            if (result.natural === 1) {
+                expect(result.critical).toBe("failure");
+                return;
+            }
+        }
+        expect(true).toBe(false);
+    });
+});
+describe("rollDie", () => {
+    it("returns values in range", () => {
+        const rng = createRNG(42);
+        for (let i = 0; i < 100; i++) {
+            const result = rollDie(6, rng);
+            expect(result).toBeGreaterThanOrEqual(1);
+            expect(result).toBeLessThanOrEqual(6);
+        }
+    });
+});
+describe("rollNd", () => {
+    it("sums multiple dice", () => {
+        const rng = createRNG(42);
+        const result = rollNd(3, 6, rng);
+        // 3d6 should be between 3 and 18
+        expect(result).toBeGreaterThanOrEqual(3);
+        expect(result).toBeLessThanOrEqual(18);
+    });
+});
+//# sourceMappingURL=dice.test.js.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Tests for test and combat resolution with advantage/disadvantage
+ */
+export {};
+//# sourceMappingURL=resolution.test.d.ts.map

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

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