@allemandi/gacha-engine 0.1.0 → 0.2.1

package/README.md

@@ -19,9 +19,11 @@
 
 
 ## ✨ Features
-- 🔍 Determine how many rolls are needed to reach a target probability for an item
-- 📐 Estimate cumulative probabilities over multiple rolls
-- ⚡ Lightweight and fast rarity probabilities
+- 🎲 **Roll simulation**: Perform actual gacha rolls with weighted probabilities
+- 🔍 **Probability analysis**: Calculate drop rates, cumulative probabilities, and rolls needed
+- 📐 **Multi-rarity support**: Handle complex gacha systems with multiple rarity tiers
+- ⚡ **Performance optimized**: Cached calculations and efficient algorithms
+- 🛡️ **Type-safe**: Full TypeScript support with comprehensive validation
 
 ## 🛠️ Installation
 ```bash
@@ -43,38 +45,48 @@ const pools = [
   {
     rarity: 'SSR',
     items: [
-      { name: 'Ultra Sword', probability: 0.01, rateUp: true },
-      { name: 'Magic Wand', probability: 0.02 },
-      { name: 'Useless SSR Loot', probability: 0.97 }
+      { name: 'Super Hobo', weight: 0.8, rateUp: true },  // Rate-up: 0.8% of SSR pool
+      { name: 'Broke King', weight: 0.4 },                     // Standard: 0.4% of SSR pool  
+      { name: 'Cardboard Hero', weight: 0.4 },
+      { name: 'Newspaper Warmer', weight: 0.4 }
     ]
   },
   {
-    rarity: 'SR',
+    rarity: 'SR', 
     items: [
-      { name: 'Steel Shield', probability: 0.1 },
-      { name: 'Healing Potion', probability: 0.2 }
+      { name: 'Cold Salaryman', weight: 1.5, rateUp: true },           // Rate-up: 1.5% of SR pool
+      { name: 'Numb Artist', weight: 1.8 },                      // Standard 4-star rates
+      { name: 'Crying Cook', weight: 1.8 },
+      { name: 'Lonely Cat', weight: 1.8 }
     ]
   }
 ];
 
 const rarityRates = {
-  SSR: 0.05,
-  SR: 0.3,
+  SSR: 0.01,  // 1% chance for SSR (5-star)
+  SR: 0.03,   // 3% chance for SR (4-star)
 };
 
 const engine = new GachaEngine({ pools, rarityRates });
 
-const dropRate = engine.getItemDropRate('Ultra Sword');
-console.log(`Drop rate for Ultra Sword: ${dropRate}`);
+// Perform actual rolls
+const results = engine.roll(10);
+console.log(`10 rolls result: ${results.join(', ')}`);
 
-const cumulativeProb = engine.getCumulativeProbabilityForItem('Ultra Sword', 10);
-console.log(`Probability of getting Ultra Sword in 10 rolls: ${cumulativeProb}`);
+// Analyze probabilities  
+const dropRate = engine.getItemDropRate('Super Hobo');
+console.log(`Drop rate for Super Hobo: ${(dropRate * 100).toFixed(3)}%`);
+// Output: ~0.4% (0.8/2.0 * 0.01)
 
-const rollsNeeded = engine.getRollsForTargetProbability('Ultra Sword', 0.9);
-console.log(`Rolls needed for 90% chance: ${rollsNeeded}`);
+const cumulativeProb = engine.getCumulativeProbabilityForItem('Super Hobo', 300);
+console.log(`Probability of getting Super Hobo in 300 rolls: ${(cumulativeProb * 100).toFixed(1)}%`);
+
+const rollsNeeded = engine.getRollsForTargetProbability('Super Hobo', 0.5);
+console.log(`Rolls needed for 50% chance: ${rollsNeeded}`);
 
 const rateUpItems = engine.getRateUpItems();
 console.log(`Current rate-up items: ${rateUpItems.join(', ')}`);
+// Output: "Super Hobo, Cold Salaryman"
 ```
 
 **CommonJS**
@@ -84,56 +96,79 @@ const { GachaEngine } = require('@allemandi/gacha-engine');
 
 **UMD**
 ```html
- <script src="https://unpkg.com/@allemandi/gacha-engine"></script>
-  <script>
-    const engine = new window.AllemandiGachaEngine.GachaEngine({
-      pools: [
-        {
-          rarity: '5★',
-          items: [{ name: 'Rate Up Character', probability: 0.008 }]
-        }
-      ]
-    });
-
-    console.log('Rate up:', engine.getItemDropRate('Rate Up Character'));
-    // Rate up: 0.008
-  </script>
+<script src="https://unpkg.com/@allemandi/gacha-engine"></script>
+<script>
+  const engine = new AllemandiGachaEngine.GachaEngine({
+    rarityRates: { 'SSR': 0.01 },
+    pools: [
+      {
+        rarity: 'SSR',
+        items: [
+          { name: 'Park Master', weight: 0.7, rateUp: true },
+          { name: 'Trash Titan', weight: 0.3 }
+        ]
+      }
+    ]
+  });
+
+  console.log('Single roll:', engine.roll());
+  // Single roll: ['Park Master'] or ['Trash Titan']
+</script>
 ```
 
 ## 📘 API
-`new GachaEngine(config: GachaEngineConfig)`
 
-Creates a new GachaEngine instance.
+### Constructor
+`new GachaEngine(config: GachaEngineConfig)`
 
-- `config.pools`: Array of item pools, each with a rarity and list of items (each with name, probability, optional `rateUp` flag).
+Creates a new GachaEngine instance with validation.
 
-- `config.rarityRates`: Optional object mapping rarities to base probabilities.
+**Config Properties:**
+- `rarityRates` **(required)**: Object mapping rarity names to their base probabilities (must sum to ≤ 1.0)
+- `pools` **(required)**: Array of rarity pools, each containing:
+  - `rarity`: String identifier matching a key in `rarityRates`
+  - `items`: Array of items with:
+    - `name`: Unique item identifier
+    - `weight`: Relative weight within the rarity pool (higher = more likely)
+    - `rateUp?`: Optional boolean flag for rate-up items
 
 ### Methods
+
+#### Rolling
+`roll(count?: number): string[]`
+- Simulate gacha rolls and returns item names
+- `count`: Number of rolls to perform (default: 1)
+- Returns array of item names
+
+#### Analysis
 `getItemDropRate(name: string): number`
-- Returns the effective drop rate of an item by name.
+- Returns the effective drop rate (0-1) for a specific item
+- Calculated as: `(item.weight / pool.totalWeight) × rarity.baseRate`
 
 `getRarityProbability(rarity: string): number`
-- Returns the base probability assigned to a rarity pool.
+- Returns the base probability for a rarity tier
 
 `getCumulativeProbabilityForItem(name: string, rolls: number): number`
-- Returns the probability of obtaining the specified item at least once within the given number of rolls.
+- Calculates probability of getting the item at least once in N rolls
+- Uses formula: `1 - (1 - dropRate)^rolls`
 
 `getRollsForTargetProbability(name: string, targetProbability: number): number`
-- Returns the minimum number of rolls needed to reach or exceed the target probability for the specified item.
+- Returns minimum rolls needed to reach target probability for an item
+- Returns `Infinity` if item has zero drop rate
 
+#### Utility
 `getRateUpItems(): string[]`
-- Returns a list of all item names currently marked as rate-up.
+- Returns names of all items marked with `rateUp: true`
 
-`getAllItemDropRates(): { name: string; dropRate: number; rarity: string }[]`
-- Returns an array of all items with their calculated drop rates and rarities.
+`getAllItemDropRates(): Array<{name: string, dropRate: number, rarity: string}>`
+- Returns complete list of all items with their calculated drop rates and rarities
 
 ## 🧪 Tests
 
 > Available in the GitHub repo only.
 
 ```bash
-# Run the test suite with Jest
+# Run the test suite with Vitest
 yarn test
 # or
 npm test

package/dist/gacha-engine.d.ts

@@ -0,0 +1,21 @@
+import { GachaEngineConfig } from './types';
+export declare class GachaEngine {
+    private pools;
+    private rarityRates;
+    private dropRateCache;
+    constructor({ rarityRates, pools }: GachaEngineConfig);
+    private validateConfig;
+    getItemDropRate(name: string): number;
+    getRarityProbability(rarity: string): number;
+    getCumulativeProbabilityForItem(name: string, rolls: number): number;
+    getRollsForTargetProbability(name: string, targetProbability: number): number;
+    getRateUpItems(): string[];
+    getAllItemDropRates(): {
+        name: string;
+        dropRate: number;
+        rarity: string;
+    }[];
+    roll(count?: number): string[];
+    private selectRarity;
+    private selectItemFromPool;
+}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-function t(t,r){(null==r||r>t.length)&&(r=t.length);for(var e=0,n=Array(r);e<r;e++)n[e]=t[e];return n}exports.GachaEngine=/*#__PURE__*/function(){function r(t){var r=t.rarityRates,e=void 0===r?{}:r,n=t.pools;this.pools=void 0,this.rarityRates=void 0,this.pools=n,this.rarityRates=e}var e=r.prototype;return e.getItemDropRate=function(r){for(var e,n=function(r){var e="undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(e)return(e=e.call(r)).next.bind(e);if(Array.isArray(r)||(e=function(r,e){if(r){if("string"==typeof r)return t(r,e);var n={}.toString.call(r).slice(8,-1);return"Object"===n&&r.constructor&&(n=r.constructor.name),"Map"===n||"Set"===n?Array.from(r):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?t(r,e):void 0}}(r))){e&&(r=e);var n=0;return function(){return n>=r.length?{done:!0}:{done:!1,value:r[n++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}(this.pools);!(e=n()).done;){var o=e.value,i=o.items.find(function(t){return t.name===r});if(i){var a,u=o.items.reduce(function(t,r){return t+r.probability},0),l=null!=(a=this.rarityRates[o.rarity])?a:u;return i.probability/u*l}}throw new Error('Item "'+r+'" not found')},e.getRarityProbability=function(t){var r,e=this.pools.find(function(r){return r.rarity===t});if(!e)throw new Error('Rarity "'+t+'" not found');var n=e.items.reduce(function(t,r){return t+r.probability},0);return null!=(r=this.rarityRates[t])?r:n},e.getCumulativeProbabilityForItem=function(t,r){var e=this.getItemDropRate(t);return 1-Math.pow(1-e,r)},e.getRollsForTargetProbability=function(t,r){var e=this.getItemDropRate(t);return e<=0?Infinity:Math.ceil(Math.log(1-r)/Math.log(1-e))},e.getRateUpItems=function(){return this.pools.flatMap(function(t){return t.items.filter(function(t){return t.rateUp}).map(function(t){return t.name})})},e.getAllItemDropRates=function(){var t=this;return this.pools.flatMap(function(r){return r.items.map(function(e){return{name:e.name,dropRate:t.getItemDropRate(e.name),rarity:r.rarity}})})},r}();
+function t(t,r){(null==r||r>t.length)&&(r=t.length);for(var e=0,n=Array(r);e<r;e++)n[e]=t[e];return n}function r(r,e){var n="undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(n)return(n=n.call(r)).next.bind(n);if(Array.isArray(r)||(n=function(r,e){if(r){if("string"==typeof r)return t(r,e);var n={}.toString.call(r).slice(8,-1);return"Object"===n&&r.constructor&&(n=r.constructor.name),"Map"===n||"Set"===n?Array.from(r):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?t(r,e):void 0}}(r))||e&&r&&"number"==typeof r.length){n&&(r=n);var i=0;return function(){return i>=r.length?{done:!0}:{done:!1,value:r[i++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}exports.GachaEngine=/*#__PURE__*/function(){function t(t){var r=t.rarityRates,e=t.pools;this.pools=void 0,this.rarityRates=void 0,this.dropRateCache=new Map,this.pools=e,this.rarityRates=r,this.validateConfig()}var e=t.prototype;return e.validateConfig=function(){var t=new Set(Object.keys(this.rarityRates)),e=new Set(this.pools.map(function(t){return t.rarity})),n=[].concat(e).filter(function(r){return!t.has(r)});if(n.length>0)throw new Error("Missing rarity rates for: "+n.join(", "));for(var i,o=r(this.pools);!(i=o()).done;){var a=i.value;if(0===a.items.length)throw new Error('Rarity "'+a.rarity+'" has no items');if(a.items.reduce(function(t,r){return t+r.weight},0)<=0)throw new Error('Rarity "'+a.rarity+'" has zero total weight')}},e.getItemDropRate=function(t){if(this.dropRateCache.has(t))return this.dropRateCache.get(t);for(var e,n=r(this.pools);!(e=n()).done;){var i=e.value,o=i.items.find(function(r){return r.name===t});if(o){var a=i.items.reduce(function(t,r){return t+r.weight},0),s=o.weight/a*this.rarityRates[i.rarity];return this.dropRateCache.set(t,s),s}}throw new Error('Item "'+t+'" not found')},e.getRarityProbability=function(t){if(!this.rarityRates[t])throw new Error('Rarity "'+t+'" not found');return this.rarityRates[t]},e.getCumulativeProbabilityForItem=function(t,r){var e=this.getItemDropRate(t);return 1-Math.pow(1-e,r)},e.getRollsForTargetProbability=function(t,r){var e=this.getItemDropRate(t);return e<=0?Infinity:Math.ceil(Math.log(1-r)/Math.log(1-e))},e.getRateUpItems=function(){return this.pools.flatMap(function(t){return t.items.filter(function(t){return t.rateUp}).map(function(t){return t.name})})},e.getAllItemDropRates=function(){var t=this;return this.pools.flatMap(function(r){return r.items.map(function(e){return{name:e.name,dropRate:t.getItemDropRate(e.name),rarity:r.rarity}})})},e.roll=function(t){var r=this;void 0===t&&(t=1);for(var e=[],n=function(){var t=r.selectRarity(),n=r.pools.find(function(r){return r.rarity===t}),i=r.selectItemFromPool(n);e.push(i.name)},i=0;i<t;i++)n();return e},e.selectRarity=function(){for(var t=Math.random(),r=0,e=0,n=Object.entries(this.rarityRates);e<n.length;e++){var i=n[e];if(t<=(r+=i[1]))return i[0]}return Object.keys(this.rarityRates)[0]},e.selectItemFromPool=function(t){for(var e,n=t.items.reduce(function(t,r){return t+r.weight},0),i=Math.random()*n,o=0,a=r(t.items);!(e=a()).done;){var s=e.value;if(i<=(o+=s.weight))return s}return t.items[0]},t}();
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/gacha-engine.ts"],"sourcesContent":["import { RarityInput, GachaEngineConfig } from './types';\n\nexport class GachaEngine {\n    private pools: RarityInput[];\n    private rarityRates: Record<string, number>;\n    private dropRateCache = new Map<string, number>();\n\n    constructor({ rarityRates, pools }: GachaEngineConfig) {\n        this.pools = pools;\n        this.rarityRates = rarityRates;\n        this.validateConfig();\n    }\n\n    private validateConfig(): void {\n        const configuredRarities = new Set(Object.keys(this.rarityRates));\n        const usedRarities = new Set(this.pools.map(p => p.rarity));\n        const missing = [...usedRarities].filter(r => !configuredRarities.has(r));\n        if (missing.length > 0) {\n            throw new Error(`Missing rarity rates for: ${missing.join(', ')}`);\n        }\n\n        for (const pool of this.pools) {\n            if (pool.items.length === 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has no items`);\n            }\n            const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n            if (totalWeight <= 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has zero total weight`);\n            }\n        }\n    }\n\n    getItemDropRate(name: string): number {\n        if (this.dropRateCache.has(name)) {\n            return this.dropRateCache.get(name)!;\n        }\n\n        for (const pool of this.pools) {\n            const item = pool.items.find(i => i.name === name);\n            if (item) {\n                const totalPoolWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n                const baseRarityRate = this.rarityRates[pool.rarity];\n                const rate = (item.weight / totalPoolWeight) * baseRarityRate;\n                this.dropRateCache.set(name, rate);\n                return rate;\n            }\n        }\n        throw new Error(`Item \"${name}\" not found`);\n    }\n\n    getRarityProbability(rarity: string): number {\n        if (!this.rarityRates[rarity]) {\n            throw new Error(`Rarity \"${rarity}\" not found`);\n        }\n        return this.rarityRates[rarity];\n    }\n\n    getCumulativeProbabilityForItem(name: string, rolls: number): number {\n        const rate = this.getItemDropRate(name);\n        return 1 - Math.pow(1 - rate, rolls);\n    }\n\n    getRollsForTargetProbability(name: string, targetProbability: number): number {\n        const rate = this.getItemDropRate(name);\n        if (rate <= 0) return Infinity;\n        return Math.ceil(Math.log(1 - targetProbability) / Math.log(1 - rate));\n    }\n\n    getRateUpItems(): string[] {\n        return this.pools.flatMap(p =>\n            p.items.filter(i => i.rateUp).map(i => i.name)\n        );\n    }\n\n    getAllItemDropRates(): { name: string; dropRate: number; rarity: string }[] {\n        return this.pools.flatMap(p =>\n            p.items.map(i => ({\n                name: i.name,\n                dropRate: this.getItemDropRate(i.name),\n                rarity: p.rarity\n            }))\n        );\n    }\n\n    roll(count: number = 1): string[] {\n        const results: string[] = [];\n        for (let i = 0; i < count; i++) {\n            const rarity = this.selectRarity();\n            const pool = this.pools.find(p => p.rarity === rarity)!;\n            const item = this.selectItemFromPool(pool);\n            results.push(item.name);\n        }\n        return results;\n    }\n\n    private selectRarity(): string {\n        const rand = Math.random();\n        let cumulative = 0;\n        for (const [rarity, rate] of Object.entries(this.rarityRates)) {\n            cumulative += rate;\n            if (rand <= cumulative) return rarity;\n        }\n        return Object.keys(this.rarityRates)[0];\n    }\n\n    private selectItemFromPool(pool: RarityInput): { name: string; weight: number } {\n        const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n        const rand = Math.random() * totalWeight;\n        let cumulative = 0;\n        for (const item of pool.items) {\n            cumulative += item.weight;\n            if (rand <= cumulative) return item;\n        }\n        return pool.items[0];\n    }\n}"],"names":["GachaEngine","_ref","rarityRates","pools","this","dropRateCache","Map","validateConfig","_proto","prototype","configuredRarities","Set","Object","keys","usedRarities","map","p","rarity","missing","concat","filter","r","has","length","Error","join","_iterator","_step","_createForOfIteratorHelperLoose","done","pool","value","items","reduce","sum","i","weight","getItemDropRate","name","get","_iterator2","_step2","item","find","totalPoolWeight","rate","set","getRarityProbability","getCumulativeProbabilityForItem","rolls","Math","pow","getRollsForTargetProbability","targetProbability","Infinity","ceil","log","getRateUpItems","flatMap","rateUp","getAllItemDropRates","_this","dropRate","roll","count","_this2","results","_loop","selectRarity","selectItemFromPool","push","rand","random","cumulative","_i","_Object$entries","entries","_Object$entries$_i","_step3","totalWeight","_iterator3"],"mappings":"q0BAEwB,WAKpB,SAAAA,EAAAC,GAAqD,IAAvCC,EAAWD,EAAXC,YAAaC,EAAKF,EAALE,MAAKC,KAJxBD,WAAK,EAAAC,KACLF,iBAAW,EAAAE,KACXC,cAAgB,IAAIC,IAGxBF,KAAKD,MAAQA,EACbC,KAAKF,YAAcA,EACnBE,KAAKG,gBACT,CAAC,IAAAC,EAAAR,EAAAS,UAuGA,OAvGAD,EAEOD,eAAA,WACJ,IAAMG,EAAqB,IAAIC,IAAIC,OAAOC,KAAKT,KAAKF,cAC9CY,EAAe,IAAIH,IAAIP,KAAKD,MAAMY,IAAI,SAAAC,GAAC,OAAIA,EAAEC,MAAM,IACnDC,EAAU,GAAAC,OAAIL,GAAcM,OAAO,SAAAC,GAAK,OAACX,EAAmBY,IAAID,EAAE,GACxE,GAAIH,EAAQK,OAAS,EACjB,MAAM,IAAIC,MAAmCN,6BAAAA,EAAQO,KAAK,OAG9D,IAAAC,IAA6BC,EAA7BD,EAAAE,EAAmBxB,KAAKD,SAAKwB,EAAAD,KAAAG,MAAE,CAApB,IAAAC,EAAIH,EAAAI,MACX,GAA0B,IAAtBD,EAAKE,MAAMT,OACX,MAAM,IAAIC,MAAK,WAAYM,EAAKb,OAAM,kBAG1C,GADoBa,EAAKE,MAAMC,OAAO,SAACC,EAAKC,GAAC,OAAKD,EAAMC,EAAEC,MAAM,EAAE,IAC/C,EACf,MAAU,IAAAZ,MAAK,WAAYM,EAAKb,OAA+B,0BAEvE,CACJ,EAACT,EAED6B,gBAAA,SAAgBC,GACZ,GAAIlC,KAAKC,cAAciB,IAAIgB,GACvB,OAAOlC,KAAKC,cAAckC,IAAID,GAGlC,IAAAE,IAA6BC,EAA7BD,EAAAZ,EAAmBxB,KAAKD,SAAKsC,EAAAD,KAAAX,MAAE,CAApB,IAAAC,EAAIW,EAAAV,MACLW,EAAOZ,EAAKE,MAAMW,KAAK,SAAAR,GAAC,OAAIA,EAAEG,OAASA,CAAI,GACjD,GAAII,EAAM,CACN,IAAME,EAAkBd,EAAKE,MAAMC,OAAO,SAACC,EAAKC,GAAM,OAAAD,EAAMC,EAAEC,MAAM,EAAE,GAEhES,EAAQH,EAAKN,OAASQ,EADLxC,KAAKF,YAAY4B,EAAKb,QAG7C,OADAb,KAAKC,cAAcyC,IAAIR,EAAMO,GACtBA,CACX,CACJ,CACA,MAAM,IAAIrB,MAAec,SAAAA,gBAC7B,EAAC9B,EAEDuC,qBAAA,SAAqB9B,GACjB,IAAKb,KAAKF,YAAYe,GAClB,MAAU,IAAAO,MAAK,WAAYP,EAAmB,eAElD,OAAWb,KAACF,YAAYe,EAC5B,EAACT,EAEDwC,gCAAA,SAAgCV,EAAcW,GAC1C,IAAMJ,EAAOzC,KAAKiC,gBAAgBC,GAClC,OAAQ,EAAGY,KAAKC,IAAI,EAAIN,EAAMI,EAClC,EAACzC,EAED4C,6BAAA,SAA6Bd,EAAce,GACvC,IAAMR,EAAOzC,KAAKiC,gBAAgBC,GAClC,OAAIO,GAAQ,EAAUS,SACfJ,KAAKK,KAAKL,KAAKM,IAAI,EAAIH,GAAqBH,KAAKM,IAAI,EAAIX,GACpE,EAACrC,EAEDiD,eAAA,WACI,OAAOrD,KAAKD,MAAMuD,QAAQ,SAAA1C,GAAC,OACvBA,EAAEgB,MAAMZ,OAAO,SAAAe,GAAK,OAAAA,EAAEwB,MAAM,GAAE5C,IAAI,SAAAoB,GAAK,OAAAA,EAAEG,IAAI,EAAC,EAEtD,EAAC9B,EAEDoD,oBAAA,WAAmBC,IAAAA,EACfzD,KAAA,YAAYD,MAAMuD,QAAQ,SAAA1C,GACtB,OAAAA,EAAEgB,MAAMjB,IAAI,SAAAoB,GAAM,MAAA,CACdG,KAAMH,EAAEG,KACRwB,SAAUD,EAAKxB,gBAAgBF,EAAEG,MACjCrB,OAAQD,EAAEC,OACb,EAAE,EAEX,EAACT,EAEDuD,KAAA,SAAKC,GAAiBC,IAAAA,gBAAjBD,IAAAA,EAAgB,GAEjB,IADA,IAAME,EAAoB,GAAGC,EAAA,WAEzB,IAAMlD,EAASgD,EAAKG,eACdtC,EAAOmC,EAAK9D,MAAMwC,KAAK,SAAA3B,GAAC,OAAIA,EAAEC,SAAWA,CAAM,GAC/CyB,EAAOuB,EAAKI,mBAAmBvC,GACrCoC,EAAQI,KAAK5B,EAAKJ,KACtB,EALSH,EAAI,EAAGA,EAAI6B,EAAO7B,IAAGgC,IAM9B,OAAOD,CACX,EAAC1D,EAEO4D,aAAA,WAGJ,IAFA,IAAMG,EAAOrB,KAAKsB,SACdC,EAAa,EACjBC,EAAAC,EAAAA,EAA6B/D,OAAOgE,QAAQxE,KAAKF,aAAYwE,EAAAC,EAAApD,OAAAmD,IAAE,CAA1D,IAAAG,EAAAF,EAAAD,GAED,GAAIH,IADJE,GADoBI,EAAA,IAEI,OAFVA,EAAA,EAGlB,CACA,OAAOjE,OAAOC,KAAKT,KAAKF,aAAa,EACzC,EAACM,EAEO6D,mBAAA,SAAmBvC,GAIvB,IAHA,IAG6BgD,EAHvBC,EAAcjD,EAAKE,MAAMC,OAAO,SAACC,EAAKC,GAAC,OAAKD,EAAMC,EAAEC,MAAM,EAAE,GAC5DmC,EAAOrB,KAAKsB,SAAWO,EACzBN,EAAa,EACjBO,EAAApD,EAAmBE,EAAKE,SAAK8C,EAAAE,KAAAnD,MAAE,CAAA,IAApBa,EAAIoC,EAAA/C,MAEX,GAAIwC,IADJE,GAAc/B,EAAKN,QACK,OAAOM,CACnC,CACA,OAAOZ,EAAKE,MAAM,EACtB,EAAChC,CAAA,CAhHmB"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './gacha-engine';
+export * from './types';

package/dist/index.module.js

@@ -0,0 +1,2 @@
+function t(t,r){(null==r||r>t.length)&&(r=t.length);for(var e=0,n=Array(r);e<r;e++)n[e]=t[e];return n}function r(r,e){var n="undefined"!=typeof Symbol&&r[Symbol.iterator]||r["@@iterator"];if(n)return(n=n.call(r)).next.bind(n);if(Array.isArray(r)||(n=function(r,e){if(r){if("string"==typeof r)return t(r,e);var n={}.toString.call(r).slice(8,-1);return"Object"===n&&r.constructor&&(n=r.constructor.name),"Map"===n||"Set"===n?Array.from(r):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?t(r,e):void 0}}(r))||e&&r&&"number"==typeof r.length){n&&(r=n);var i=0;return function(){return i>=r.length?{done:!0}:{done:!1,value:r[i++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}var e=/*#__PURE__*/function(){function t(t){var r=t.rarityRates,e=t.pools;this.pools=void 0,this.rarityRates=void 0,this.dropRateCache=new Map,this.pools=e,this.rarityRates=r,this.validateConfig()}var e=t.prototype;return e.validateConfig=function(){var t=new Set(Object.keys(this.rarityRates)),e=new Set(this.pools.map(function(t){return t.rarity})),n=[].concat(e).filter(function(r){return!t.has(r)});if(n.length>0)throw new Error("Missing rarity rates for: "+n.join(", "));for(var i,o=r(this.pools);!(i=o()).done;){var a=i.value;if(0===a.items.length)throw new Error('Rarity "'+a.rarity+'" has no items');if(a.items.reduce(function(t,r){return t+r.weight},0)<=0)throw new Error('Rarity "'+a.rarity+'" has zero total weight')}},e.getItemDropRate=function(t){if(this.dropRateCache.has(t))return this.dropRateCache.get(t);for(var e,n=r(this.pools);!(e=n()).done;){var i=e.value,o=i.items.find(function(r){return r.name===t});if(o){var a=i.items.reduce(function(t,r){return t+r.weight},0),s=o.weight/a*this.rarityRates[i.rarity];return this.dropRateCache.set(t,s),s}}throw new Error('Item "'+t+'" not found')},e.getRarityProbability=function(t){if(!this.rarityRates[t])throw new Error('Rarity "'+t+'" not found');return this.rarityRates[t]},e.getCumulativeProbabilityForItem=function(t,r){var e=this.getItemDropRate(t);return 1-Math.pow(1-e,r)},e.getRollsForTargetProbability=function(t,r){var e=this.getItemDropRate(t);return e<=0?Infinity:Math.ceil(Math.log(1-r)/Math.log(1-e))},e.getRateUpItems=function(){return this.pools.flatMap(function(t){return t.items.filter(function(t){return t.rateUp}).map(function(t){return t.name})})},e.getAllItemDropRates=function(){var t=this;return this.pools.flatMap(function(r){return r.items.map(function(e){return{name:e.name,dropRate:t.getItemDropRate(e.name),rarity:r.rarity}})})},e.roll=function(t){var r=this;void 0===t&&(t=1);for(var e=[],n=function(){var t=r.selectRarity(),n=r.pools.find(function(r){return r.rarity===t}),i=r.selectItemFromPool(n);e.push(i.name)},i=0;i<t;i++)n();return e},e.selectRarity=function(){for(var t=Math.random(),r=0,e=0,n=Object.entries(this.rarityRates);e<n.length;e++){var i=n[e];if(t<=(r+=i[1]))return i[0]}return Object.keys(this.rarityRates)[0]},e.selectItemFromPool=function(t){for(var e,n=t.items.reduce(function(t,r){return t+r.weight},0),i=Math.random()*n,o=0,a=r(t.items);!(e=a()).done;){var s=e.value;if(i<=(o+=s.weight))return s}return t.items[0]},t}();export{e as GachaEngine};
+//# sourceMappingURL=index.module.js.map

package/dist/index.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.module.js","sources":["../src/gacha-engine.ts"],"sourcesContent":["import { RarityInput, GachaEngineConfig } from './types';\n\nexport class GachaEngine {\n    private pools: RarityInput[];\n    private rarityRates: Record<string, number>;\n    private dropRateCache = new Map<string, number>();\n\n    constructor({ rarityRates, pools }: GachaEngineConfig) {\n        this.pools = pools;\n        this.rarityRates = rarityRates;\n        this.validateConfig();\n    }\n\n    private validateConfig(): void {\n        const configuredRarities = new Set(Object.keys(this.rarityRates));\n        const usedRarities = new Set(this.pools.map(p => p.rarity));\n        const missing = [...usedRarities].filter(r => !configuredRarities.has(r));\n        if (missing.length > 0) {\n            throw new Error(`Missing rarity rates for: ${missing.join(', ')}`);\n        }\n\n        for (const pool of this.pools) {\n            if (pool.items.length === 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has no items`);\n            }\n            const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n            if (totalWeight <= 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has zero total weight`);\n            }\n        }\n    }\n\n    getItemDropRate(name: string): number {\n        if (this.dropRateCache.has(name)) {\n            return this.dropRateCache.get(name)!;\n        }\n\n        for (const pool of this.pools) {\n            const item = pool.items.find(i => i.name === name);\n            if (item) {\n                const totalPoolWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n                const baseRarityRate = this.rarityRates[pool.rarity];\n                const rate = (item.weight / totalPoolWeight) * baseRarityRate;\n                this.dropRateCache.set(name, rate);\n                return rate;\n            }\n        }\n        throw new Error(`Item \"${name}\" not found`);\n    }\n\n    getRarityProbability(rarity: string): number {\n        if (!this.rarityRates[rarity]) {\n            throw new Error(`Rarity \"${rarity}\" not found`);\n        }\n        return this.rarityRates[rarity];\n    }\n\n    getCumulativeProbabilityForItem(name: string, rolls: number): number {\n        const rate = this.getItemDropRate(name);\n        return 1 - Math.pow(1 - rate, rolls);\n    }\n\n    getRollsForTargetProbability(name: string, targetProbability: number): number {\n        const rate = this.getItemDropRate(name);\n        if (rate <= 0) return Infinity;\n        return Math.ceil(Math.log(1 - targetProbability) / Math.log(1 - rate));\n    }\n\n    getRateUpItems(): string[] {\n        return this.pools.flatMap(p =>\n            p.items.filter(i => i.rateUp).map(i => i.name)\n        );\n    }\n\n    getAllItemDropRates(): { name: string; dropRate: number; rarity: string }[] {\n        return this.pools.flatMap(p =>\n            p.items.map(i => ({\n                name: i.name,\n                dropRate: this.getItemDropRate(i.name),\n                rarity: p.rarity\n            }))\n        );\n    }\n\n    roll(count: number = 1): string[] {\n        const results: string[] = [];\n        for (let i = 0; i < count; i++) {\n            const rarity = this.selectRarity();\n            const pool = this.pools.find(p => p.rarity === rarity)!;\n            const item = this.selectItemFromPool(pool);\n            results.push(item.name);\n        }\n        return results;\n    }\n\n    private selectRarity(): string {\n        const rand = Math.random();\n        let cumulative = 0;\n        for (const [rarity, rate] of Object.entries(this.rarityRates)) {\n            cumulative += rate;\n            if (rand <= cumulative) return rarity;\n        }\n        return Object.keys(this.rarityRates)[0];\n    }\n\n    private selectItemFromPool(pool: RarityInput): { name: string; weight: number } {\n        const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n        const rand = Math.random() * totalWeight;\n        let cumulative = 0;\n        for (const item of pool.items) {\n            cumulative += item.weight;\n            if (rand <= cumulative) return item;\n        }\n        return pool.items[0];\n    }\n}"],"names":["GachaEngine","_ref","rarityRates","pools","this","dropRateCache","Map","validateConfig","_proto","prototype","configuredRarities","Set","Object","keys","usedRarities","map","p","rarity","missing","concat","filter","r","has","length","Error","join","_iterator","_step","_createForOfIteratorHelperLoose","done","pool","value","items","reduce","sum","i","weight","getItemDropRate","name","get","_iterator2","_step2","item","find","totalPoolWeight","rate","set","getRarityProbability","getCumulativeProbabilityForItem","rolls","Math","pow","getRollsForTargetProbability","targetProbability","Infinity","ceil","log","getRateUpItems","flatMap","rateUp","getAllItemDropRates","_this","dropRate","roll","count","_this2","results","_loop","selectRarity","selectItemFromPool","push","rand","random","cumulative","_i","_Object$entries","entries","_Object$entries$_i","_step3","totalWeight","_iterator3"],"mappings":"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"}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+!function(t,r){"object"==typeof exports&&"undefined"!=typeof module?r(exports):"function"==typeof define&&define.amd?define(["exports"],r):r((t||self).AllemandiGachaEngine={})}(this,function(t){function r(t,r){(null==r||r>t.length)&&(r=t.length);for(var e=0,n=Array(r);e<r;e++)n[e]=t[e];return n}function e(t,e){var n="undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(n)return(n=n.call(t)).next.bind(n);if(Array.isArray(t)||(n=function(t,e){if(t){if("string"==typeof t)return r(t,e);var n={}.toString.call(t).slice(8,-1);return"Object"===n&&t.constructor&&(n=t.constructor.name),"Map"===n||"Set"===n?Array.from(t):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?r(t,e):void 0}}(t))||e&&t&&"number"==typeof t.length){n&&(t=n);var i=0;return function(){return i>=t.length?{done:!0}:{done:!1,value:t[i++]}}}throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}t.GachaEngine=/*#__PURE__*/function(){function t(t){var r=t.rarityRates,e=t.pools;this.pools=void 0,this.rarityRates=void 0,this.dropRateCache=new Map,this.pools=e,this.rarityRates=r,this.validateConfig()}var r=t.prototype;return r.validateConfig=function(){var t=new Set(Object.keys(this.rarityRates)),r=new Set(this.pools.map(function(t){return t.rarity})),n=[].concat(r).filter(function(r){return!t.has(r)});if(n.length>0)throw new Error("Missing rarity rates for: "+n.join(", "));for(var i,o=e(this.pools);!(i=o()).done;){var a=i.value;if(0===a.items.length)throw new Error('Rarity "'+a.rarity+'" has no items');if(a.items.reduce(function(t,r){return t+r.weight},0)<=0)throw new Error('Rarity "'+a.rarity+'" has zero total weight')}},r.getItemDropRate=function(t){if(this.dropRateCache.has(t))return this.dropRateCache.get(t);for(var r,n=e(this.pools);!(r=n()).done;){var i=r.value,o=i.items.find(function(r){return r.name===t});if(o){var a=i.items.reduce(function(t,r){return t+r.weight},0),s=o.weight/a*this.rarityRates[i.rarity];return this.dropRateCache.set(t,s),s}}throw new Error('Item "'+t+'" not found')},r.getRarityProbability=function(t){if(!this.rarityRates[t])throw new Error('Rarity "'+t+'" not found');return this.rarityRates[t]},r.getCumulativeProbabilityForItem=function(t,r){var e=this.getItemDropRate(t);return 1-Math.pow(1-e,r)},r.getRollsForTargetProbability=function(t,r){var e=this.getItemDropRate(t);return e<=0?Infinity:Math.ceil(Math.log(1-r)/Math.log(1-e))},r.getRateUpItems=function(){return this.pools.flatMap(function(t){return t.items.filter(function(t){return t.rateUp}).map(function(t){return t.name})})},r.getAllItemDropRates=function(){var t=this;return this.pools.flatMap(function(r){return r.items.map(function(e){return{name:e.name,dropRate:t.getItemDropRate(e.name),rarity:r.rarity}})})},r.roll=function(t){var r=this;void 0===t&&(t=1);for(var e=[],n=function(){var t=r.selectRarity(),n=r.pools.find(function(r){return r.rarity===t}),i=r.selectItemFromPool(n);e.push(i.name)},i=0;i<t;i++)n();return e},r.selectRarity=function(){for(var t=Math.random(),r=0,e=0,n=Object.entries(this.rarityRates);e<n.length;e++){var i=n[e];if(t<=(r+=i[1]))return i[0]}return Object.keys(this.rarityRates)[0]},r.selectItemFromPool=function(t){for(var r,n=t.items.reduce(function(t,r){return t+r.weight},0),i=Math.random()*n,o=0,a=e(t.items);!(r=a()).done;){var s=r.value;if(i<=(o+=s.weight))return s}return t.items[0]},t}()});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/gacha-engine.ts"],"sourcesContent":["import { RarityInput, GachaEngineConfig } from './types';\n\nexport class GachaEngine {\n    private pools: RarityInput[];\n    private rarityRates: Record<string, number>;\n    private dropRateCache = new Map<string, number>();\n\n    constructor({ rarityRates, pools }: GachaEngineConfig) {\n        this.pools = pools;\n        this.rarityRates = rarityRates;\n        this.validateConfig();\n    }\n\n    private validateConfig(): void {\n        const configuredRarities = new Set(Object.keys(this.rarityRates));\n        const usedRarities = new Set(this.pools.map(p => p.rarity));\n        const missing = [...usedRarities].filter(r => !configuredRarities.has(r));\n        if (missing.length > 0) {\n            throw new Error(`Missing rarity rates for: ${missing.join(', ')}`);\n        }\n\n        for (const pool of this.pools) {\n            if (pool.items.length === 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has no items`);\n            }\n            const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n            if (totalWeight <= 0) {\n                throw new Error(`Rarity \"${pool.rarity}\" has zero total weight`);\n            }\n        }\n    }\n\n    getItemDropRate(name: string): number {\n        if (this.dropRateCache.has(name)) {\n            return this.dropRateCache.get(name)!;\n        }\n\n        for (const pool of this.pools) {\n            const item = pool.items.find(i => i.name === name);\n            if (item) {\n                const totalPoolWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n                const baseRarityRate = this.rarityRates[pool.rarity];\n                const rate = (item.weight / totalPoolWeight) * baseRarityRate;\n                this.dropRateCache.set(name, rate);\n                return rate;\n            }\n        }\n        throw new Error(`Item \"${name}\" not found`);\n    }\n\n    getRarityProbability(rarity: string): number {\n        if (!this.rarityRates[rarity]) {\n            throw new Error(`Rarity \"${rarity}\" not found`);\n        }\n        return this.rarityRates[rarity];\n    }\n\n    getCumulativeProbabilityForItem(name: string, rolls: number): number {\n        const rate = this.getItemDropRate(name);\n        return 1 - Math.pow(1 - rate, rolls);\n    }\n\n    getRollsForTargetProbability(name: string, targetProbability: number): number {\n        const rate = this.getItemDropRate(name);\n        if (rate <= 0) return Infinity;\n        return Math.ceil(Math.log(1 - targetProbability) / Math.log(1 - rate));\n    }\n\n    getRateUpItems(): string[] {\n        return this.pools.flatMap(p =>\n            p.items.filter(i => i.rateUp).map(i => i.name)\n        );\n    }\n\n    getAllItemDropRates(): { name: string; dropRate: number; rarity: string }[] {\n        return this.pools.flatMap(p =>\n            p.items.map(i => ({\n                name: i.name,\n                dropRate: this.getItemDropRate(i.name),\n                rarity: p.rarity\n            }))\n        );\n    }\n\n    roll(count: number = 1): string[] {\n        const results: string[] = [];\n        for (let i = 0; i < count; i++) {\n            const rarity = this.selectRarity();\n            const pool = this.pools.find(p => p.rarity === rarity)!;\n            const item = this.selectItemFromPool(pool);\n            results.push(item.name);\n        }\n        return results;\n    }\n\n    private selectRarity(): string {\n        const rand = Math.random();\n        let cumulative = 0;\n        for (const [rarity, rate] of Object.entries(this.rarityRates)) {\n            cumulative += rate;\n            if (rand <= cumulative) return rarity;\n        }\n        return Object.keys(this.rarityRates)[0];\n    }\n\n    private selectItemFromPool(pool: RarityInput): { name: string; weight: number } {\n        const totalWeight = pool.items.reduce((sum, i) => sum + i.weight, 0);\n        const rand = Math.random() * totalWeight;\n        let cumulative = 0;\n        for (const item of pool.items) {\n            cumulative += item.weight;\n            if (rand <= cumulative) return item;\n        }\n        return pool.items[0];\n    }\n}"],"names":["GachaEngine","_ref","rarityRates","pools","this","dropRateCache","Map","validateConfig","_proto","prototype","configuredRarities","Set","Object","keys","usedRarities","map","p","rarity","missing","concat","filter","r","has","length","Error","join","_iterator","_step","_createForOfIteratorHelperLoose","done","pool","value","items","reduce","sum","i","weight","getItemDropRate","name","get","_iterator2","_step2","item","find","totalPoolWeight","rate","set","getRarityProbability","getCumulativeProbabilityForItem","rolls","Math","pow","getRollsForTargetProbability","targetProbability","Infinity","ceil","log","getRateUpItems","flatMap","rateUp","getAllItemDropRates","_this","dropRate","roll","count","_this2","results","_loop","selectRarity","selectItemFromPool","push","rand","random","cumulative","_i","_Object$entries","entries","_Object$entries$_i","_step3","totalWeight","_iterator3"],"mappings":"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"}

package/{src/types.ts → dist/types.d.ts}

@@ -1,16 +1,13 @@
-
 export interface RarityInput {
     rarity: string;
     items: GachaItem[];
 }
-
 export interface GachaItem {
     name: string;
-    probability: number;
+    weight: number;
     rateUp?: boolean;
 }
-
 export interface GachaEngineConfig {
-    rarityRates?: Record<string, number>;
+    rarityRates: Record<string, number>;
     pools: RarityInput[];
 }

package/package.json

@@ -1,12 +1,27 @@
 {
     "name": "@allemandi/gacha-engine",
-    "version": "0.1.0",
+    "version": "0.2.1",
     "description": "Practical, type-safe toolkit for simulating and understanding gacha rates and rate-ups.",
     "main": "dist/index.cjs",
     "module": "dist/index.module.js",
     "types": "./dist/index.d.ts",
     "unpkg": "dist/index.umd.js",
     "source": "src/index.ts",
+     "exports": {
+        "import": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.module.js"
+        },
+        "require": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.cjs"
+        }
+    },
+      "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
     "repository": "https://github.com/allemandi/gacha-engine.git",
     "author": "allemandi <69766017+allemandi@users.noreply.github.com>",
     "license": "MIT",

package/.github/workflows/ci.yml

@@ -1,42 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    branches:
-      - main
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 18
-          cache: 'yarn'
-      - run: yarn install --frozen-lockfile
-      - run: yarn lint
-
-  test:
-    needs: lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 18
-          cache: 'yarn'
-      - run: yarn install --frozen-lockfile
-      - run: yarn test
-
-  build:
-    needs: test
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 18
-          cache: 'yarn'
-      - run: yarn install --frozen-lockfile
-      - run: yarn build

package/.github/workflows/publish.yml

@@ -1,26 +0,0 @@
-name: Publish to NPM
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org/'
-          cache: 'yarn'
-
-      - run: yarn install --frozen-lockfile
-      - run: yarn build
-      
-      - run: yarn publish --non-interactive --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/eslint.config.mjs

@@ -1,34 +0,0 @@
-import { defineConfig } from "eslint/config";
-import typescriptEslint from "@typescript-eslint/eslint-plugin";
-import tsParser from "@typescript-eslint/parser";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import js from "@eslint/js";
-import { FlatCompat } from "@eslint/eslintrc";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const compat = new FlatCompat({
-    baseDirectory: __dirname,
-    recommendedConfig: js.configs.recommended,
-    allConfig: js.configs.all
-});
-
-export default defineConfig([{
-    
-    ignores: ["dist/**"],
-
-    extends: compat.extends("eslint:recommended", "plugin:@typescript-eslint/recommended"),
-
-    plugins: {
-        "@typescript-eslint": typescriptEslint,
-    },
-
-    languageOptions: {
-        parser: tsParser,
-        ecmaVersion: 2020,
-        sourceType: "module",
-    },
-
-    rules: {},
-}]);

package/src/gacha-engine.ts

@@ -1,58 +0,0 @@
-import { RarityInput, GachaEngineConfig } from './types';
-export class GachaEngine {
-    private pools: RarityInput[];
-    private rarityRates: Record<string, number>;
-
-    constructor({ rarityRates = {}, pools }: GachaEngineConfig) {
-        this.pools = pools;
-        this.rarityRates = rarityRates;
-    }
-
-    getItemDropRate(name: string): number {
-        for (const pool of this.pools) {
-            const item = pool.items.find(i => i.name === name);
-            if (item) {
-                const totalPoolProb = pool.items.reduce((sum, i) => sum + i.probability, 0);
-                const baseRarityRate = this.rarityRates[pool.rarity] ?? totalPoolProb;
-                return (item.probability / totalPoolProb) * baseRarityRate;
-            }
-        }
-        throw new Error(`Item "${name}" not found`);
-    }
-
-    getRarityProbability(rarity: string): number {
-        const pool = this.pools.find(p => p.rarity === rarity);
-        if (!pool) throw new Error(`Rarity "${rarity}" not found`);
-
-        const totalProb = pool.items.reduce((sum, i) => sum + i.probability, 0);
-        const baseRate = this.rarityRates[rarity] ?? totalProb;
-        return baseRate;
-    }
-
-    getCumulativeProbabilityForItem(name: string, rolls: number): number {
-        const rate = this.getItemDropRate(name);
-        return 1 - Math.pow(1 - rate, rolls);
-    }
-
-    getRollsForTargetProbability(name: string, targetProbability: number): number {
-        const rate = this.getItemDropRate(name);
-        if (rate <= 0) return Infinity;
-        return Math.ceil(Math.log(1 - targetProbability) / Math.log(1 - rate));
-    }
-
-    getRateUpItems(): string[] {
-        return this.pools.flatMap(p =>
-            p.items.filter(i => i.rateUp).map(i => i.name)
-        );
-    }
-
-    getAllItemDropRates(): { name: string; dropRate: number; rarity: string }[] {
-        return this.pools.flatMap(p =>
-            p.items.map(i => ({
-                name: i.name,
-                dropRate: this.getItemDropRate(i.name),
-                rarity: p.rarity
-            }))
-        );
-    }
-}

package/src/index.ts

@@ -1 +0,0 @@
-export { GachaEngine } from "./gacha-engine";

package/test/index.test.ts

@@ -1,111 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { GachaEngine } from '../src/gacha-engine';
-import type { RarityInput, GachaEngineConfig } from '../src/types';
-
-const mockPools: RarityInput[] = [
-    {
-        rarity: 'common',
-        items: [
-            { name: 'ItemA', probability: 0.5 },
-            { name: 'ItemB', probability: 0.5 },
-        ],
-    },
-    {
-        rarity: 'rare',
-        items: [
-            { name: 'ItemC', probability: 0.7 },
-            { name: 'ItemD', probability: 0.3, rateUp: true },
-        ],
-    },
-];
-
-const config: GachaEngineConfig = {
-    rarityRates: {
-        common: 0.8,
-        rare: 0.2,
-    },
-    pools: mockPools,
-};
-
-describe('GachaEngine', () => {
-    const engine = new GachaEngine(config);
-
-    describe('getItemDropRate', () => {
-        it('should return correct drop rate using rarityRates', () => {
-            expect(engine.getItemDropRate('ItemA')).toBeCloseTo(0.4); // 0.5 * 0.8
-            expect(engine.getItemDropRate('ItemD')).toBeCloseTo(0.06); // 0.3 * 0.2
-        });
-
-        it('throws if item does not exist', () => {
-            expect(() => engine.getItemDropRate('Unknown')).toThrow('Item "Unknown" not found');
-        });
-    });
-
-    describe('getRarityProbability', () => {
-        it('should return correct base rarity rate', () => {
-            expect(engine.getRarityProbability('common')).toBe(0.8);
-            expect(engine.getRarityProbability('rare')).toBe(0.2);
-        });
-
-        it('throws if rarity not found', () => {
-            expect(() => engine.getRarityProbability('epic')).toThrow('Rarity "epic" not found');
-        });
-    });
-
-    describe('getCumulativeProbabilityForItem', () => {
-        it('should calculate cumulative probability correctly', () => {
-            const dropRate = engine.getItemDropRate('ItemA'); // 0.4
-            const rolls = 3;
-            const expected = 1 - Math.pow(1 - dropRate, rolls);
-            expect(engine.getCumulativeProbabilityForItem('ItemA', rolls)).toBeCloseTo(expected);
-        });
-    });
-
-    describe('getRollsForTargetProbability', () => {
-        it('should calculate rolls to reach target probability', () => {
-            const target = 0.9;
-            const rate = engine.getItemDropRate('ItemA'); // 0.4
-            const expected = Math.ceil(Math.log(1 - target) / Math.log(1 - rate));
-            expect(engine.getRollsForTargetProbability('ItemA', target)).toBe(expected);
-        });
-
-        it('returns Infinity if drop rate is zero', () => {
-            const zeroRateEngine = new GachaEngine({
-                pools: [{
-                    rarity: 'none',
-                    items: [
-                        { name: 'NeverDrops', probability: 0 },
-                        { name: 'Other', probability: 1 },
-                    ],
-                }],
-            });
-
-            expect(zeroRateEngine.getRollsForTargetProbability('NeverDrops', 0.5)).toBe(Infinity);
-        });
-    });
-
-    describe('getRateUpItems', () => {
-        it('returns only rate-up item names', () => {
-            expect(engine.getRateUpItems()).toEqual(['ItemD']);
-        });
-
-        it('returns empty array if no rate-up items', () => {
-            const noRateUpEngine = new GachaEngine({
-                pools: [{
-                    rarity: 'common',
-                    items: [{ name: 'NoRateUp', probability: 1 }],
-                }],
-            });
-            expect(noRateUpEngine.getRateUpItems()).toEqual([]);
-        });
-    });
-
-    describe('getAllItemDropRates', () => {
-        it('returns all items with correct drop rates and rarities', () => {
-            const results = engine.getAllItemDropRates();
-            expect(results).toContainEqual({ name: 'ItemA', dropRate: 0.4, rarity: 'common' });
-            expect(results).toContainEqual({ name: 'ItemD', dropRate: 0.06, rarity: 'rare' });
-            expect(results).toHaveLength(4);
-        });
-    });
-});

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "Node",
-    "declaration": true,
-    "outDir": "dist",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src"],
-  "exclude": ["node_modules", "dist", "test"]
-}

package/vitest.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node'
-  }
-})