@mythxengine/engine 0.1.0

package/dist/rules/custom-test.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Custom Test Resolution
+ *
+ * Resolves custom tests defined in world pack rules (panic checks, sanity rolls, etc.)
+ */
+import type { CustomTestDefinition, CustomTestResult } from "@mythxengine/types";
+import type { RNG } from "../rng/rng.js";
+import type { RulesContext } from "./context.js";
+export interface CustomTestOptions {
+    /** The custom test definition to use */
+    test: CustomTestDefinition;
+    /** Character's ability values */
+    abilities: Record<string, number>;
+    /** RNG instance */
+    rng: RNG;
+    /** Rules context */
+    ctx: RulesContext;
+    /** Optional additional modifiers */
+    modifiers?: number;
+}
+/**
+ * Resolve a custom test
+ */
+export declare function resolveCustomTest(options: CustomTestOptions): CustomTestResult;
+/**
+ * Find a custom test by ID in rules context
+ */
+export declare function findCustomTest(ctx: RulesContext, testId: string): CustomTestDefinition | undefined;
+/**
+ * Find custom tests that match a trigger
+ */
+export declare function findCustomTestsByTrigger(ctx: RulesContext, trigger: string): CustomTestDefinition[];
+//# sourceMappingURL=custom-test.d.ts.map

package/dist/rules/custom-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-test.d.ts","sourceRoot":"","sources":["../../src/rules/custom-test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAIpB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mBAAmB;IACnB,GAAG,EAAE,GAAG,CAAC;IACT,oBAAoB;IACpB,GAAG,EAAE,YAAY,CAAC;IAClB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoHD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAkF9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,GACb,oBAAoB,GAAG,SAAS,CAElC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,oBAAoB,EAAE,CAExB"}

package/dist/rules/custom-test.js

@@ -0,0 +1,164 @@
+/**
+ * Custom Test Resolution
+ *
+ * Resolves custom tests defined in world pack rules (panic checks, sanity rolls, etc.)
+ */
+import { parseFormula } from "@mythxengine/types";
+import { rollDice } from "../dice/roller.js";
+import { checkCriticalSuccess, checkCriticalFailure } from "./context.js";
+/**
+ * Calculate the difficulty target for a custom test
+ */
+function calculateDifficulty(test, abilities) {
+    const { roll } = test;
+    // Fixed difficulty
+    if (roll.difficulty !== undefined) {
+        return roll.difficulty;
+    }
+    // Dynamic difficulty from formula
+    if (roll.difficultyFormula) {
+        const formula = parseFormula(roll.difficultyFormula);
+        return Math.floor(formula(abilities));
+    }
+    // Roll-under: target is the ability value
+    if (roll.underAbility) {
+        return abilities[roll.underAbility] ?? 10;
+    }
+    // Default to standard difficulty
+    return 12;
+}
+/**
+ * Determine success for a custom test
+ */
+function determineSuccess(test, roll, total, target, isCritSuccess, isCritFail, ctx) {
+    const isRollUnder = test.roll.underAbility !== undefined;
+    const mechanics = ctx.rules.mechanics;
+    // Critical success always succeeds (unless rules say otherwise)
+    if (isCritSuccess && mechanics.criticals.autoSuccess) {
+        return true;
+    }
+    // Critical failure always fails (unless rules say otherwise)
+    if (isCritFail && mechanics.criticals.autoFailure) {
+        return false;
+    }
+    // Roll-under: succeed if roll is <= target
+    if (isRollUnder) {
+        return roll <= target;
+    }
+    // Roll-over: succeed if total >= target
+    return total >= target;
+}
+/**
+ * Get the appropriate outcome based on result
+ */
+function getOutcome(test, success, isCritical) {
+    const { outcomes } = test;
+    if (success) {
+        if (isCritical && outcomes.criticalSuccess) {
+            return outcomes.criticalSuccess;
+        }
+        return outcomes.success;
+    }
+    else {
+        if (isCritical && outcomes.criticalFailure) {
+            return outcomes.criticalFailure;
+        }
+        return outcomes.failure;
+    }
+}
+/**
+ * Roll on an outcome table
+ */
+function rollOnTable(table, abilities, rng) {
+    const diceResult = rollDice(table.dice, rng);
+    let roll = diceResult.total;
+    // Add ability modifier if specified
+    if (table.addAbility && abilities[table.addAbility] !== undefined) {
+        roll += abilities[table.addAbility];
+    }
+    // Find matching entry
+    const entry = table.entries.find((e) => roll >= e.range[0] && roll <= e.range[1]);
+    if (!entry) {
+        return undefined;
+    }
+    return { roll, entry };
+}
+/**
+ * Resolve a custom test
+ */
+export function resolveCustomTest(options) {
+    const { test, abilities, rng, ctx, modifiers = 0 } = options;
+    const { roll: rollConfig } = test;
+    // Roll the dice
+    const diceResult = rollDice(rollConfig.dice, rng);
+    const natural = diceResult.total;
+    // Calculate modifier from ability
+    let abilityMod = 0;
+    if (rollConfig.ability) {
+        abilityMod = abilities[rollConfig.ability] ?? 0;
+    }
+    const totalMod = abilityMod + modifiers;
+    const total = natural + totalMod;
+    // Calculate target
+    const target = calculateDifficulty(test, abilities);
+    // Check for criticals
+    const isCritSuccess = checkCriticalSuccess(ctx, natural);
+    const isCritFail = checkCriticalFailure(ctx, natural);
+    const isCritical = isCritSuccess || isCritFail;
+    // Determine success
+    const success = determineSuccess(test, natural, total, target, isCritSuccess, isCritFail, ctx);
+    // Get the outcome
+    const outcome = getOutcome(test, success, isCritical);
+    // Collect effects
+    const effects = [];
+    // Table roll result
+    let tableRoll;
+    if (outcome) {
+        // Add direct effects
+        if (outcome.effects) {
+            effects.push(...outcome.effects);
+        }
+        // Roll on table if present
+        if (outcome.table) {
+            const tableResult = rollOnTable(outcome.table, abilities, rng);
+            if (tableResult) {
+                tableRoll = {
+                    dice: outcome.table.dice,
+                    roll: tableResult.roll,
+                    entry: tableResult.entry,
+                };
+                if (tableResult.entry.effects) {
+                    effects.push(...tableResult.entry.effects);
+                }
+            }
+        }
+    }
+    return {
+        testId: test.id,
+        roll: {
+            dice: rollConfig.dice,
+            natural,
+            modifier: totalMod,
+            total,
+        },
+        target,
+        success,
+        critical: isCritical,
+        outcome: outcome ?? { description: "No outcome defined" },
+        tableRoll,
+        effects,
+    };
+}
+/**
+ * Find a custom test by ID in rules context
+ */
+export function findCustomTest(ctx, testId) {
+    return ctx.rules.customTestMap.get(testId);
+}
+/**
+ * Find custom tests that match a trigger
+ */
+export function findCustomTestsByTrigger(ctx, trigger) {
+    return ctx.rules.customTests.filter((t) => t.triggers.includes(trigger));
+}
+//# sourceMappingURL=custom-test.js.map

package/dist/rules/custom-test.js.map

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

package/dist/rules/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rules module exports
+ */
+export * from "./context.js";
+export * from "./custom-test.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/rules/index.js

@@ -0,0 +1,6 @@
+/**
+ * Rules module exports
+ */
+export * from "./context.js";
+export * from "./custom-test.js";
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mythxengine/engine",
+  "version": "0.1.0",
+  "description": "Pure game mechanics engine for MythX RPG (dice, combat, RNG)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "rpg",
+    "tabletop",
+    "dice",
+    "combat",
+    "game-engine"
+  ],
+  "author": "Proto Labs AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/proto-labs-ai/rpg-claude-plugin.git",
+    "directory": "packages/engine"
+  },
+  "bugs": {
+    "url": "https://github.com/proto-labs-ai/rpg-claude-plugin/issues"
+  },
+  "homepage": "https://github.com/proto-labs-ai/rpg-claude-plugin#readme",
+  "dependencies": {
+    "@mythxengine/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}