rpg-event-generator 4.0.0 → 5.0.0

package/dist/core/GeneratorCore.d.ts

@@ -1,7 +1,8 @@
+import { SeededRandom } from '../utils/random';
 import { Event, PlayerContext } from '../types';
 import { IGeneratorCore } from '../interfaces';
 export interface GeneratorOptions {
-    chance?: Chance.Chance;
+    rng?: SeededRandom;
     debug?: boolean;
 }
 export interface TrainingDataOptions {
@@ -17,66 +18,26 @@ export interface TrainingDataOptions {
     texts?: string[];
 }
 export declare class GeneratorCore implements IGeneratorCore {
-    private chance;
+    private rng;
     private contextAnalyzer;
     private options;
     private customTitles;
     private customDescriptions;
     private customChoices;
     constructor(options?: GeneratorOptions);
-    /**
-     * Generate a complete event - CLEAN AND SIMPLE
-     */
     generateEvent(playerContext?: PlayerContext): Event;
-    /**
-     * Generate multiple events
-     */
     generateEvents(playerContext?: PlayerContext, count?: number): Event[];
-    /**
-     * Add training data - allows users to extend the generator with custom content
-     * Supports both simple text training and structured custom content
-     */
     addTrainingData(data: string[] | TrainingDataOptions, theme?: string): void;
-    /**
-     * Process raw training texts for backward compatibility
-     */
+    /** @deprecated No-op for backward compatibility; use structured addTrainingData. */
     private processRawTrainingTexts;
-    /**
-     * Add contextual enhancements to descriptions
-     */
     private addContextualEnhancements;
-    /**
-     * Generate unique event ID
-     */
     private generateEventId;
-    /**
-     * Select appropriate event type
-     */
     private selectEventType;
-    /**
-     * Calculate event difficulty
-     */
     private calculateDifficulty;
-    /**
-     * Generate event title - SIMPLE LOOKUP
-     */
     private generateTitle;
-    /**
-     * Generate event description - SIMPLE AND RELIABLE
-     * Direct mapping from event type to meaningful descriptions
-     */
     private generateDescription;
-    /**
-     * Generate event choices - SIMPLE VERSION
-     */
     private generateChoices;
-    /**
-     * Generate effect for a choice
-     */
     private generateChoiceEffect;
-    /**
-     * Generate tags
-     */
     private generateTags;
 }
 //# sourceMappingURL=GeneratorCore.d.ts.map

package/dist/core/GeneratorCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GeneratorCore.d.ts","sourceRoot":"","sources":["../../src/core/GeneratorCore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAmC,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC3C,YAAY,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,OAAO,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAmB;IAElC,OAAO,CAAC,YAAY,CAAyD;IAC7E,OAAO,CAAC,kBAAkB,CAAyD;IACnF,OAAO,CAAC,aAAa,CAAyD;gBAElE,OAAO,GAAE,gBAAqB;IAM1C;;OAEG;IACH,aAAa,CAAC,aAAa,GAAE,aAAkB,GAAG,KAAK;IAwBvD;;OAEG;IACH,cAAc,CAAC,aAAa,GAAE,aAAkB,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,EAAE;IAQ7E;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI;IA+BtF;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAI/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2JjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA8arB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAgqB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IA8kBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,YAAY;CAiBrB"}
+{"version":3,"file":"GeneratorCore.d.ts","sourceRoot":"","sources":["../../src/core/GeneratorCore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,aAAa,EAAmC,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC3C,YAAY,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,OAAO,CAAC,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAmB;IAElC,OAAO,CAAC,YAAY,CAAyD;IAC7E,OAAO,CAAC,kBAAkB,CAAyD;IACnF,OAAO,CAAC,aAAa,CAAyD;gBAElE,OAAO,GAAE,gBAAqB;IAM1C,aAAa,CAAC,aAAa,GAAE,aAAkB,GAAG,KAAK;IAwBvD,cAAc,CAAC,aAAa,GAAE,aAAkB,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,EAAE;IAQ7E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI;IA+BtF,oFAAoF;IACpF,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,yBAAyB;IA2JjC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,aAAa;IA6arB,OAAO,CAAC,mBAAmB;IA8pB3B,OAAO,CAAC,eAAe;IA6kBvB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,YAAY;CAiBrB"}

package/dist/core/GeneratorCore.js

@@ -1,9 +1,8 @@
 "use strict";
-// RPG Event Generator v4.0.0 - COMPLETE REBUILD
-// Simple, reliable event generation with guaranteed coherent descriptions
+// GeneratorCore - RPG event generation (v4)
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GeneratorCore = void 0;
-const chance_1 = require("chance");
+const random_1 = require("../utils/random");
 const ContextAnalyzer_1 = require("./ContextAnalyzer");
 class GeneratorCore {
     constructor(options = {}) {
@@ -11,12 +10,9 @@ class GeneratorCore {
         this.customDescriptions = {};
         this.customChoices = {};
         this.options = options;
-        this.chance = options.chance || new chance_1.Chance();
+        this.rng = options.rng || new random_1.SeededRandom();
         this.contextAnalyzer = new ContextAnalyzer_1.ContextAnalyzer();
     }
-    /**
-     * Generate a complete event - CLEAN AND SIMPLE
-     */
     generateEvent(playerContext = {}) {
         const analyzedContext = this.contextAnalyzer.analyzeContext(playerContext);
         const id = this.generateEventId();
@@ -36,9 +32,6 @@ class GeneratorCore {
             tags: this.generateTags(type, analyzedContext)
         };
     }
-    /**
-     * Generate multiple events
-     */
     generateEvents(playerContext = {}, count = 1) {
         const events = [];
         for (let i = 0; i < count; i++) {
@@ -46,10 +39,6 @@ class GeneratorCore {
         }
         return events;
     }
-    /**
-     * Add training data - allows users to extend the generator with custom content
-     * Supports both simple text training and structured custom content
-     */
     addTrainingData(data, theme = 'default') {
         if (typeof data === 'object' && !Array.isArray(data)) {
             const options = data;
@@ -77,18 +66,15 @@ class GeneratorCore {
             this.processRawTrainingTexts(data, theme);
         }
     }
-    /**
-     * Process raw training texts for backward compatibility
-     */
+    /** @deprecated No-op for backward compatibility; use structured addTrainingData. */
     processRawTrainingTexts(texts, theme) {
-        console.log(`Received ${texts.length} training texts for theme '${theme}' - processing not yet implemented`);
+        if (this.options.debug) {
+            console.warn(`[GeneratorCore] Raw training texts are not supported in v4.0.0. Use structured content (titles, descriptions, choices) instead. Received ${texts.length} texts for theme '${theme}' which will be ignored.`);
+        }
     }
-    /**
-     * Add contextual enhancements to descriptions
-     */
     addContextualEnhancements(description, context) {
         const contextEnhancements = [];
-        if (context.location && this.chance.bool({ likelihood: 70 })) {
+        if (context.location && this.rng.bool({ likelihood: 70 })) {
             const locationPrefixes = [
                 `In the ${context.location}, `,
                 `Deep within the ${context.location}, `,
@@ -101,9 +87,9 @@ class GeneratorCore {
                 `At the center of the ${context.location}, `,
                 `Surrounded by the ${context.location}, `
             ];
-            contextEnhancements.push(this.chance.pickone(locationPrefixes));
+            contextEnhancements.push(this.rng.pickone(locationPrefixes));
         }
-        if (context.weather && this.chance.bool({ likelihood: 60 })) {
+        if (context.weather && this.rng.bool({ likelihood: 60 })) {
             const weatherPrefixes = {
                 sunny: [
                     'Under the brilliant sun, ',
@@ -149,9 +135,9 @@ class GeneratorCore {
                 ]
             };
             const weatherOptions = weatherPrefixes[context.weather] || ['In this weather, '];
-            contextEnhancements.push(this.chance.pickone(weatherOptions));
+            contextEnhancements.push(this.rng.pickone(weatherOptions));
         }
-        if (context.timeOfDay && this.chance.bool({ likelihood: 50 })) {
+        if (context.timeOfDay && this.rng.bool({ likelihood: 50 })) {
             const timePrefixes = {
                 dawn: [
                     'At the break of dawn, ',
@@ -203,9 +189,9 @@ class GeneratorCore {
                 ]
             };
             const timeOptions = timePrefixes[context.timeOfDay] || ['At this hour, '];
-            contextEnhancements.push(this.chance.pickone(timeOptions));
+            contextEnhancements.push(this.rng.pickone(timeOptions));
         }
-        if ((context.class || context.race) && this.chance.bool({ likelihood: 40 })) {
+        if ((context.class || context.race) && this.rng.bool({ likelihood: 40 })) {
             if (context.class) {
                 const classContexts = {
                     fighter: ['As a warrior, ', 'In your martial tradition, ', 'Drawing on your combat experience, '],
@@ -215,7 +201,7 @@ class GeneratorCore {
                     necromancer: ['With your deathly arts, ', 'Through your necrotic knowledge, ', 'Using your dark magic, ']
                 };
                 const classOptions = classContexts[context.class] || [`As a ${context.class}, `];
-                contextEnhancements.push(this.chance.pickone(classOptions));
+                contextEnhancements.push(this.rng.pickone(classOptions));
             }
             else if (context.race) {
                 const raceContexts = {
@@ -226,34 +212,25 @@ class GeneratorCore {
                     orc: ['With orcish fury, ', 'Using orcish strength, ', 'Through orcish determination, ']
                 };
                 const raceOptions = raceContexts[context.race] || [`As a ${context.race}, `];
-                contextEnhancements.push(this.chance.pickone(raceOptions));
+                contextEnhancements.push(this.rng.pickone(raceOptions));
             }
         }
         if (contextEnhancements.length > 0) {
-            const selectedEnhancement = this.chance.pickone(contextEnhancements);
+            const selectedEnhancement = this.rng.pickone(contextEnhancements);
             description = selectedEnhancement + description.charAt(0).toLowerCase() + description.slice(1);
         }
         return description;
     }
-    /**
-     * Generate unique event ID
-     */
     generateEventId() {
         return `event_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     }
-    /**
-     * Select appropriate event type
-     */
     selectEventType(context) {
         const types = [
             'ADVENTURE', 'COMBAT', 'ECONOMIC', 'EXPLORATION', 'GUILD', 'MAGIC', 'MYSTERY',
             'POLITICAL', 'QUEST', 'SOCIAL', 'SPELLCASTING', 'SUPERNATURAL', 'TECHNOLOGICAL', 'UNDERWORLD'
         ];
-        return this.chance.pickone(types);
+        return this.rng.pickone(types);
     }
-    /**
-     * Calculate event difficulty
-     */
     calculateDifficulty(context) {
         const powerLevel = context.powerLevel || 50;
         if (powerLevel <= 25)
@@ -264,16 +241,12 @@ class GeneratorCore {
             return 'hard';
         return 'legendary';
     }
-    /**
-     * Generate event title - SIMPLE LOOKUP
-     */
     generateTitle(type, context) {
-        // Check all available themes for custom titles, prioritizing 'default'
         const themesToCheck = ['default', ...Object.keys(this.customTitles).filter(k => k !== 'default')];
         for (const theme of themesToCheck) {
             const customThemeTitles = this.customTitles[theme];
             if (customThemeTitles && customThemeTitles[type] && customThemeTitles[type].length > 0) {
-                return this.chance.pickone(customThemeTitles[type]);
+                return this.rng.pickone(customThemeTitles[type]);
             }
         }
         const titles = {
@@ -691,19 +664,14 @@ class GeneratorCore {
             ]
         };
         const typeTitles = titles[type] || ['Unexpected Event', 'Strange Occurrence', 'Curious Situation', 'Interesting Development'];
-        return this.chance.pickone(typeTitles);
+        return this.rng.pickone(typeTitles);
     }
-    /**
-     * Generate event description - SIMPLE AND RELIABLE
-     * Direct mapping from event type to meaningful descriptions
-     */
     generateDescription(title, type, context) {
-        // Check all available themes for custom descriptions, prioritizing 'default'
         const themesToCheck = ['default', ...Object.keys(this.customDescriptions).filter(k => k !== 'default')];
         for (const theme of themesToCheck) {
             const customThemeDescriptions = this.customDescriptions[theme];
             if (customThemeDescriptions && customThemeDescriptions[type] && customThemeDescriptions[type].length > 0) {
-                let description = this.chance.pickone(customThemeDescriptions[type]);
+                let description = this.rng.pickone(customThemeDescriptions[type]);
                 description = this.addContextualEnhancements(description, context);
                 description = description.trim();
                 if (!/[.!?]$/.test(description)) {
@@ -1346,7 +1314,7 @@ class GeneratorCore {
             'You face circumstances that require decisive action.',
             'A meaningful opportunity or challenge appears before you.'
         ];
-        let description = this.chance.pickone(typeDescriptions);
+        let description = this.rng.pickone(typeDescriptions);
         description = this.addContextualEnhancements(description, context);
         description = description.trim();
         if (!/[.!?]$/.test(description)) {
@@ -1354,18 +1322,14 @@ class GeneratorCore {
         }
         return description;
     }
-    /**
-     * Generate event choices - SIMPLE VERSION
-     */
     generateChoices(type, difficulty, context) {
-        // Check all available themes for custom choices, prioritizing 'default'
         const themesToCheck = ['default', ...Object.keys(this.customChoices).filter(k => k !== 'default')];
         for (const theme of themesToCheck) {
             const customThemeChoices = this.customChoices[theme];
             if (customThemeChoices && customThemeChoices[type] && customThemeChoices[type].length > 0) {
                 const texts = customThemeChoices[type];
                 const choiceCount = Math.min(4, texts.length);
-                const selectedTexts = this.chance.pickset(texts, choiceCount);
+                const selectedTexts = this.rng.pickset(texts, choiceCount);
                 return selectedTexts.map((text, index) => ({
                     text,
                     effect: this.generateChoiceEffect(type, difficulty, index)
@@ -1820,7 +1784,7 @@ class GeneratorCore {
                 'Test security', 'Probe defenses', 'Check vulnerabilities', 'Assess weaknesses',
                 'Create diversion', 'Cause distraction', 'Generate confusion', 'Produce chaos',
                 'Escape pursuit', 'Evade capture', 'Shake followers', 'Lose tails',
-                'Blend into crowd', 'Disappear in masses', 'Vanity in groups', 'Hide among people',
+                'Blend into crowd', 'Disappear in masses', 'Vanish in groups', 'Hide among people',
                 'Use terrain', 'Leverage environment', 'Exploit surroundings', 'Utilize landscape',
                 'Time action', 'Coordinate timing', 'Synchronize effort', 'Align execution',
                 'Adapt to situation', 'Adjust plan', 'Modify approach', 'Change strategy',
@@ -1935,27 +1899,21 @@ class GeneratorCore {
         };
         const texts = choiceTexts[type] || ['Accept', 'Decline', 'Investigate', 'Wait'];
         const choiceCount = Math.min(4, texts.length);
-        const selectedTexts = this.chance.pickset(texts, choiceCount);
+        const selectedTexts = this.rng.pickset(texts, choiceCount);
         return selectedTexts.map((text, index) => ({
             text,
             effect: this.generateChoiceEffect(type, difficulty, index)
         }));
     }
-    /**
-     * Generate effect for a choice
-     */
     generateChoiceEffect(type, difficulty, index) {
         const effects = [
-            { gold: this.chance.integer({ min: -10, max: 50 }) },
-            { health: this.chance.integer({ min: -5, max: 10 }) },
-            { experience: this.chance.integer({ min: 0, max: 20 }) },
-            { reputation: this.chance.integer({ min: -2, max: 5 }) }
+            { gold: this.rng.integer({ min: -10, max: 50 }) },
+            { health: this.rng.integer({ min: -5, max: 10 }) },
+            { experience: this.rng.integer({ min: 0, max: 20 }) },
+            { reputation: this.rng.integer({ min: -2, max: 5 }) }
         ];
         return effects[index % effects.length] || {};
     }
-    /**
-     * Generate tags
-     */
     generateTags(type, context) {
         const tags = [type.toLowerCase()];
         if (context.wealthTier && context.wealthTier !== 'moderate') {