playlist-data-engine 1.1.0

package/dist/core/generation/EnemyEquipmentGenerator.d.ts

@@ -0,0 +1,151 @@
+/**
+ * EnemyEquipmentGenerator - Generates equipment for enemies
+ *
+ * Provides equipment generation for enemy characters based on:
+ * - Archetype (brute, archer, support)
+ * - Rarity tier (common, uncommon, elite, boss)
+ * - Deterministic seeded selection
+ *
+ * Equipment selection rules:
+ * - Brute: Heavy weapons (greataxe, longsword), heavy armor (scale mail, chain mail)
+ * - Archer: Ranged weapons (longbow, crossbow), light armor (leather), backup dagger
+ * - Support: Quarterstaff or mace, light armor with shield option
+ *
+ * Higher rarity enemies receive better equipment from their archetype pool.
+ *
+ * @example
+ * ```typescript
+ * // Generate equipment for an elite brute
+ * const equipment = EnemyEquipmentGenerator.generate({
+ *   archetype: 'brute',
+ *   rarity: 'elite',
+ *   seed: 'elite-brute-equipment'
+ * });
+ * // Returns: { weapon: greataxe, armor: chain_mail, shield: shield }
+ * ```
+ */
+import type { EnemyArchetype, EnemyRarity, EquipmentConfig, EquipmentTemplate } from '../types/Enemy.js';
+/**
+ * Enemy equipment generation options
+ */
+export interface EnemyEquipmentGenerationOptions {
+    /** Enemy archetype for equipment selection */
+    archetype: EnemyArchetype;
+    /** Enemy rarity tier for equipment quality */
+    rarity: EnemyRarity;
+    /** Seed for deterministic selection */
+    seed: string;
+    /** Whether to include a shield (for applicable archetypes) */
+    includeShield?: boolean;
+}
+/**
+ * EnemyEquipmentGenerator - Static class for enemy equipment generation
+ *
+ * Generates equipment configurations for enemy characters.
+ * All selection is deterministic based on the provided seed.
+ */
+export declare class EnemyEquipmentGenerator {
+    /**
+     * Weapon priority by archetype and rarity
+     *
+     * Defines preferred weapons for each archetype at different rarity tiers.
+     * Higher priority weapons are selected first.
+     */
+    private static readonly WEAPON_PRIORITY;
+    /**
+     * Armor priority by archetype and rarity
+     *
+     * Defines preferred armor for each archetype at different rarity tiers.
+     */
+    private static readonly ARMOR_PRIORITY;
+    /**
+     * Shield chance by rarity
+     *
+     * Chance (0-1) that an enemy gets a shield if their archetype supports it.
+     * Higher rarity enemies are more likely to have shields.
+     */
+    private static readonly SHIELD_CHANCE;
+    /**
+     * Generate equipment for an enemy
+     *
+     * Selects appropriate weapons, armor, and shields based on archetype and rarity.
+     * Uses deterministic selection from the provided seed.
+     *
+     * @param options - Equipment generation options
+     * @returns Equipment configuration with weapon, armor, and optional shield
+     *
+     * @example
+     * ```typescript
+     * const equipment = EnemyEquipmentGenerator.generate({
+     *   archetype: 'brute',
+     *   rarity: 'elite',
+     *   seed: 'elite-orc-1'
+     * });
+     * // Returns: { weapon: {...}, armor: {...}, shield: {...} }
+     * ```
+     */
+    static generate(options: EnemyEquipmentGenerationOptions): EquipmentConfig;
+    /**
+     * Select a weapon based on archetype and rarity
+     *
+     * Uses priority lists with seeded randomness for deterministic selection.
+     *
+     * @param archetype - Enemy archetype
+     * @param rarity - Enemy rarity tier
+     * @param rng - Seeded RNG
+     * @returns Selected weapon template
+     */
+    private static selectWeapon;
+    /**
+     * Select armor based on archetype and rarity
+     *
+     * Uses priority lists with seeded randomness for deterministic selection.
+     *
+     * @param archetype - Enemy archetype
+     * @param rarity - Enemy rarity tier
+     * @param rng - Seeded RNG
+     * @returns Selected armor template
+     */
+    private static selectArmor;
+    /**
+     * Select a shield based on archetype and rarity
+     *
+     * @param archetype - Enemy archetype
+     * @param rarity - Enemy rarity tier
+     * @returns Selected shield template
+     */
+    private static selectShield;
+    /**
+     * Check if an archetype can use a shield
+     *
+     * Archers typically don't use shields (need two hands for bows).
+     * Brutes and supports can use shields.
+     *
+     * @param archetype - Enemy archetype to check
+     * @returns true if the archetype can use shields
+     */
+    private static canUseShield;
+    /**
+     * Get the actual equipment name from the mapping
+     *
+     * Maps template ID to the actual equipment name in DEFAULT_EQUIPMENT.
+     *
+     * @param templateId - Equipment template ID
+     * @returns Actual equipment name from DEFAULT_EQUIPMENT
+     */
+    static getEquipmentName(templateId: string): string;
+    /**
+     * Get all equipment templates
+     *
+     * @returns Array of all equipment templates
+     */
+    static getAllTemplates(): EquipmentTemplate[];
+    /**
+     * Get equipment template by ID
+     *
+     * @param id - Template ID
+     * @returns Equipment template or undefined
+     */
+    static getTemplateById(id: string): EquipmentTemplate | undefined;
+}
+//# sourceMappingURL=EnemyEquipmentGenerator.d.ts.map

package/dist/core/generation/EnemyEquipmentGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnemyEquipmentGenerator.d.ts","sourceRoot":"","sources":["../../../src/core/generation/EnemyEquipmentGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AASzG;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC5C,8CAA8C;IAC9C,SAAS,EAAE,cAAc,CAAC;IAE1B,8CAA8C;IAC9C,MAAM,EAAE,WAAW,CAAC;IAEpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAChC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAmBrC;IAEF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAmBpC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAKnC;IAEF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,eAAe;IA2B1E;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA4B3B;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IA4B1B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAgB3B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAK3B;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAInD;;;;OAIG;IACH,MAAM,CAAC,eAAe,IAAI,iBAAiB,EAAE;IAI7C;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;CAGpE"}