clibuddy 1.0.0

package/dist/adventure/engine.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.beginAdventure = beginAdventure;
+exports.canStartAdventure = canStartAdventure;
+exports.makeChoice = makeChoice;
+exports.advanceToRoom = advanceToRoom;
+exports.advanceToNextRoom = advanceToNextRoom;
+exports.rollTreasureLoot = rollTreasureLoot;
+exports.adjustMorale = adjustMorale;
+const types_1 = require("./types");
+/** Start a new adventure */
+function beginAdventure(state, adventure) {
+    const stats = {
+        ...state.stats,
+        energy: adventure.isScene ? state.stats.energy : Math.max(0, state.stats.energy - adventure.energyCost),
+        hunger: adventure.isScene ? state.stats.hunger : Math.max(0, state.stats.hunger - adventure.hungerCost),
+    };
+    const startRoom = (0, types_1.getRoom)(adventure, adventure.startRoomId);
+    return {
+        state: { ...state, stats },
+        adventure: {
+            active: true,
+            adventureId: adventure.id,
+            currentRoomId: adventure.startRoomId,
+            roomsVisited: [adventure.startRoomId],
+            phase: "room",
+            morale: Math.max(0, Math.min(100, Math.round(state.stats.happiness))),
+            textPage: 0,
+            textFullyShown: (startRoom?.text.length ?? 0) <= 3,
+            lootCollected: [],
+            xpEarned: 0,
+            battlesWon: 0,
+            battlesLost: 0,
+            battlesFled: 0,
+            damageTaken: 0,
+            buddyReaction: startRoom?.buddyLine ?? "",
+        },
+    };
+}
+/** Check if buddy can start this adventure */
+function canStartAdventure(state, adventure) {
+    if (!state.alive)
+        return "Your buddy needs to be alive!";
+    if (state.level < adventure.levelRequired)
+        return `Requires level ${adventure.levelRequired} (you're level ${state.level})`;
+    if (!adventure.isScene) {
+        if (state.stats.energy < adventure.energyCost)
+            return `Not enough energy (need ${adventure.energyCost}, have ${Math.round(state.stats.energy)})`;
+        if (state.stats.hunger < adventure.hungerCost)
+            return `Too hungry to adventure (need ${adventure.hungerCost} hunger)`;
+    }
+    if (state.activity)
+        return "Your buddy is busy right now!";
+    return null;
+}
+/** Handle a narrative/event choice */
+function makeChoice(advState, adventure, choiceIndex) {
+    const room = (0, types_1.getRoom)(adventure, advState.currentRoomId);
+    if (!room)
+        return advState;
+    if (room.type === "narrative" && room.choices) {
+        const choice = room.choices[choiceIndex];
+        if (!choice)
+            return advState;
+        return advanceToRoom(advState, adventure, choice.nextRoomId);
+    }
+    if (room.type === "event" && room.eventChoices) {
+        const choice = room.eventChoices[choiceIndex];
+        if (!choice)
+            return advState;
+        // If event choice has a specific next room, go there; otherwise use room's default
+        const nextId = choice.nextRoomId ?? room.nextRoomId;
+        return {
+            ...advState,
+            buddyReaction: choice.outcome,
+        };
+    }
+    return advState;
+}
+/** Move to a specific room by ID */
+function advanceToRoom(advState, adventure, roomId) {
+    if (!roomId) {
+        return {
+            ...advState,
+            currentRoomId: "",
+            phase: "result",
+            xpEarned: advState.xpEarned + adventure.completionXp,
+            buddyReaction: "That was an amazing adventure!",
+        };
+    }
+    const room = (0, types_1.getRoom)(adventure, roomId);
+    if (!room) {
+        return { ...advState, phase: "result", xpEarned: advState.xpEarned + adventure.completionXp, buddyReaction: "That was an amazing adventure!" };
+    }
+    const visited = advState.roomsVisited.includes(roomId)
+        ? advState.roomsVisited
+        : [...advState.roomsVisited, roomId];
+    // Reset text paging for new room — if ≤3 lines, show all immediately
+    const LINES_PER_PAGE = 3;
+    const textFullyShown = room.text.length <= LINES_PER_PAGE;
+    const textReset = { textPage: 0, textFullyShown };
+    // If combat room, set phase to combat (caller initializes CombatState)
+    if ((room.type === "combat" || room.type === "boss") && room.enemyId) {
+        return {
+            ...advState,
+            ...textReset,
+            currentRoomId: roomId,
+            roomsVisited: visited,
+            phase: "combat",
+            buddyReaction: room.buddyLine,
+        };
+    }
+    return {
+        ...advState,
+        ...textReset,
+        currentRoomId: roomId,
+        roomsVisited: visited,
+        phase: "room",
+        buddyReaction: room.buddyLine,
+    };
+}
+/** Advance to the current room's default next room */
+function advanceToNextRoom(advState, adventure) {
+    const room = (0, types_1.getRoom)(adventure, advState.currentRoomId);
+    return advanceToRoom(advState, adventure, room?.nextRoomId);
+}
+/** Roll loot from a treasure room */
+function rollTreasureLoot(room) {
+    if (!room.lootPool || room.lootPool.length === 0)
+        return null;
+    return room.lootPool[Math.floor(Math.random() * room.lootPool.length)];
+}
+/** Adjust morale */
+function adjustMorale(advState, delta) {
+    return { ...advState, morale: Math.max(0, Math.min(100, advState.morale + delta)) };
+}
+//# sourceMappingURL=engine.js.map

package/dist/adventure/gear.d.ts

@@ -0,0 +1,3 @@
+import { ItemDef } from "../inventory/items";
+export declare const GEAR_ITEMS: ItemDef[];
+//# sourceMappingURL=gear.d.ts.map

package/dist/adventure/gear.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GEAR_ITEMS = void 0;
+exports.GEAR_ITEMS = [
+    // ─── Weapons ───────────────────────────────────────
+    {
+        id: "wooden_stick", name: "Wooden Stick", description: "+2 ATK",
+        rarity: "common", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 2,
+    },
+    {
+        id: "iron_sword", name: "Iron Sword", description: "+5 ATK",
+        rarity: "uncommon", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 5,
+    },
+    {
+        id: "crystal_blade", name: "Crystal Blade", description: "+8 ATK, +5% crit",
+        rarity: "rare", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 8, critBonus: 0.05,
+    },
+    {
+        id: "flame_scepter", name: "Flame Scepter", description: "+10 ATK, Fire, 15% burn on hit",
+        rarity: "epic", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 10,
+        gearElement: "fire", onHitEffect: "burn", onHitChance: 0.15, onHitPower: 3,
+    },
+    {
+        id: "frost_edge", name: "Frost Edge", description: "+10 ATK, Water, 10% freeze on hit",
+        rarity: "epic", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 10,
+        gearElement: "water", onHitEffect: "freeze", onHitChance: 0.10, onHitPower: 1,
+    },
+    {
+        id: "dragon_fang", name: "Dragon Fang", description: "+14 ATK, Fire, +10% crit, 20% burn",
+        rarity: "legendary", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 14,
+        gearElement: "fire", critBonus: 0.10, onHitEffect: "burn", onHitChance: 0.20, onHitPower: 5,
+    },
+    {
+        id: "shadow_dagger", name: "Shadow Dagger", description: "+12 ATK, Shadow, +15% dodge, 15% charm",
+        rarity: "legendary", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 12,
+        gearElement: "shadow", dodgeBonus: 0.15, onHitEffect: "charm", onHitChance: 0.15, onHitPower: 1,
+    },
+    // ─── Armor ─────────────────────────────────────────
+    {
+        id: "leaf_cloak", name: "Leaf Cloak", description: "+2 DEF",
+        rarity: "common", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 2,
+    },
+    {
+        id: "chain_mail", name: "Chain Mail", description: "+4 DEF",
+        rarity: "uncommon", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 4,
+    },
+    {
+        id: "crystal_armor", name: "Crystal Armor", description: "+7 DEF, +10 HP",
+        rarity: "rare", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 7, combatHP: 10,
+    },
+    {
+        id: "phoenix_robe", name: "Phoenix Feather Robe", description: "+8 DEF, regen 3hp/t",
+        rarity: "epic", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 8,
+        // Regen applied at combat start as a condition
+    },
+    {
+        id: "thornmail", name: "Thornmail", description: "+6 DEF, reflect 3 dmg to attackers",
+        rarity: "epic", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 6,
+        // Reflect handled in applyDamageToPlayer
+    },
+    {
+        id: "dragon_scale_armor", name: "Dragon Scale Armor", description: "+12 DEF, +20 HP, -2 flat dmg",
+        rarity: "legendary", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 12, combatHP: 20, damageReduction: 2,
+    },
+    {
+        id: "shadow_cloak", name: "Shadow Cloak", description: "+8 DEF, +15% dodge",
+        rarity: "legendary", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 8, dodgeBonus: 0.15,
+    },
+    // ─── Accessories ───────────────────────────────────
+    {
+        id: "lucky_charm", name: "Lucky Charm", description: "+10% crit",
+        rarity: "uncommon", type: "accessory", statEffect: {}, xpBonus: 0, critBonus: 0.10,
+    },
+    {
+        id: "swift_boots", name: "Swift Boots", description: "+3 SPD",
+        rarity: "uncommon", type: "accessory", statEffect: {}, xpBonus: 0, combatSPD: 3,
+    },
+    {
+        id: "mana_crystal", name: "Mana Crystal", description: "+2 starting energy",
+        rarity: "rare", type: "accessory", statEffect: {}, xpBonus: 0, energyBonus: 2,
+    },
+    {
+        id: "life_pendant", name: "Life Pendant", description: "+15 HP",
+        rarity: "rare", type: "accessory", statEffect: {}, xpBonus: 0, combatHP: 15,
+    },
+    {
+        id: "berserker_ring", name: "Berserker Ring", description: "+20% ATK when HP < 30%",
+        rarity: "epic", type: "accessory", statEffect: {}, xpBonus: 0,
+        // Berserker effect handled in combat damage calc
+    },
+    {
+        id: "guardian_shield", name: "Guardian Shield", description: "Start with 15hp shield",
+        rarity: "epic", type: "accessory", statEffect: {}, xpBonus: 0,
+    },
+    // ─── New Weapons (element coverage) ────────────────
+    {
+        id: "thorn_whip", name: "Thorn Whip", description: "+7 ATK, Nature, 15% poison",
+        rarity: "rare", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 7,
+        gearElement: "nature", onHitEffect: "poison", onHitChance: 0.15, onHitPower: 3,
+    },
+    {
+        id: "sunblade", name: "Sunblade", description: "+10 ATK, Light, 10% blind",
+        rarity: "epic", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 10,
+        gearElement: "light", onHitEffect: "blind", onHitChance: 0.10, onHitPower: 1,
+    },
+    {
+        id: "midnight_bow", name: "Midnight Bow", description: "+7 ATK, Shadow, +10% dodge",
+        rarity: "rare", type: "weapon", statEffect: {}, xpBonus: 0, combatATK: 7,
+        gearElement: "shadow", dodgeBonus: 0.10,
+    },
+    // ─── New Armor (element coverage) ──────────────────
+    {
+        id: "bark_shield", name: "Bark Shield", description: "+6 DEF, +10 HP",
+        rarity: "rare", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 6, combatHP: 10,
+    },
+    {
+        id: "coral_plate", name: "Coral Plate", description: "+9 DEF, Water",
+        rarity: "epic", type: "armor", statEffect: {}, xpBonus: 0, combatDEF: 9,
+    },
+    // ─── New Accessories ───────────────────────────────
+    {
+        id: "nature_ring", name: "Nature Ring", description: "+5% dodge",
+        rarity: "uncommon", type: "accessory", statEffect: {}, xpBonus: 0, dodgeBonus: 0.05,
+    },
+    {
+        id: "fire_amulet", name: "Fire Amulet", description: "+5% crit, Fire",
+        rarity: "rare", type: "accessory", statEffect: {}, xpBonus: 0, critBonus: 0.05, gearElement: "fire",
+    },
+    {
+        id: "dodge_cloak", name: "Dodge Cloak", description: "+12% dodge",
+        rarity: "rare", type: "accessory", statEffect: {}, xpBonus: 0, dodgeBonus: 0.12,
+    },
+    {
+        id: "vampiric_fang", name: "Vampiric Fang", description: "Heal 3 HP per attack",
+        rarity: "epic", type: "accessory", statEffect: {}, xpBonus: 0,
+        // Heal on hit handled in combat
+    },
+    {
+        id: "elementalist_orb", name: "Elementalist Orb", description: "+3 energy, +5% crit, +10 HP",
+        rarity: "legendary", type: "accessory", statEffect: {}, xpBonus: 0,
+        energyBonus: 3, critBonus: 0.05, combatHP: 10,
+    },
+    {
+        id: "thunder_bracelet", name: "Thunder Bracelet", description: "+5 SPD, 10% stun",
+        rarity: "legendary", type: "accessory", statEffect: {}, xpBonus: 0,
+        combatSPD: 5, onHitEffect: "stun", onHitChance: 0.10, onHitPower: 1,
+    },
+];
+//# sourceMappingURL=gear.js.map

package/dist/adventure/generation/biomes.d.ts

@@ -0,0 +1,30 @@
+export interface Biome {
+    id: string;
+    name: string;
+    /** Enemy IDs available in this biome, by tier */
+    enemies: {
+        easy: string[];
+        medium: string[];
+        hard: string[];
+        boss: string[];
+    };
+    /** Loot pools by rarity tier */
+    loot: {
+        common: string[];
+        uncommon: string[];
+        rare: string[];
+        epic: string[];
+    };
+    /** Flavor text pools */
+    nouns: string[];
+    adjectives: string[];
+    landmarks: string[];
+    hidingSpots: string[];
+    directions: string[];
+    /** Buddy species comfort lines — species that feel at home here */
+    comfortSpecies: string[];
+}
+export declare const BIOMES: Record<string, Biome>;
+export declare function getBiome(id: string): Biome | undefined;
+export declare function getAllBiomeIds(): string[];
+//# sourceMappingURL=biomes.d.ts.map

package/dist/adventure/generation/biomes.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BIOMES = void 0;
+exports.getBiome = getBiome;
+exports.getAllBiomeIds = getAllBiomeIds;
+exports.BIOMES = {
+    forest: {
+        id: "forest", name: "Forest",
+        enemies: { easy: ["squirrel", "mushroom"], medium: ["shadowfox", "crow", "vinecreeper"], hard: ["stormwolf"], boss: ["marshking"] },
+        loot: { common: ["berry", "herb", "stick", "wooden_stick", "leather_cap", "sandals"], uncommon: ["fish", "ball", "iron_sword", "leaf_cloak", "iron_helm", "leather_boots"], rare: ["cake", "crystal_blade", "chain_mail", "thorn_whip", "crystal_crown", "wind_runners"], epic: ["flame_scepter", "phoenix_robe", "sunblade", "shadow_steps"] },
+        nouns: ["forest", "woods", "grove", "thicket", "glade", "canopy", "clearing", "dell", "copse", "woodland"],
+        adjectives: ["sun-dappled", "misty", "ancient", "overgrown", "quiet", "verdant", "whispering", "wild", "fragrant", "twilit"],
+        landmarks: ["old oak tree", "mossy stone", "babbling brook", "fallen log", "ring of mushrooms", "fox den", "berry bush", "tree stump", "vine curtain"],
+        hidingSpots: ["the bushes", "behind a tree", "the undergrowth", "a hollow log", "thick ferns", "a bird's nest", "tangled roots", "a flower patch"],
+        directions: ["a shady path", "a sun-lit trail", "a narrow deer path", "a moss-covered passage", "through the ferns", "along the stream", "under low branches", "past the berry thicket"],
+        comfortSpecies: ["rabbit", "fox"],
+    },
+    caves: {
+        id: "caves", name: "Crystal Caves",
+        enemies: { easy: ["mushroom", "snail"], medium: ["golem", "crow", "rustknight"], hard: ["golem", "lavabeetle", "crystalbasilisk"], boss: ["crystalguardian"] },
+        loot: { common: ["herb", "wooden_stick"], uncommon: ["potion", "iron_sword", "chain_mail"], rare: ["crystal_blade", "crystal_armor", "midnight_bow"], epic: ["flame_scepter", "dragon_fang", "sunblade"] },
+        nouns: ["cavern", "tunnel", "grotto", "chamber", "crevice", "mine shaft", "chasm", "alcove", "passage", "vault"],
+        adjectives: ["glowing", "dark", "crystalline", "echoing", "damp", "deep", "narrow", "sparkling", "cold", "silent"],
+        landmarks: ["crystal cluster", "underground pool", "stalactite formation", "glowing vein", "ancient carving", "mineral deposit", "dripping ceiling", "crystal arch", "phosphorescent moss"],
+        hidingSpots: ["the shadows", "behind a stalagmite", "a dark alcove", "a crack in the wall", "under a ledge", "in a shallow pool", "behind crystal pillars", "a narrow fissure"],
+        directions: ["a narrow crystal tunnel", "a wide cavern", "a descending slope", "a flooded passage", "through a crystal archway", "down a spiral path", "along an underground river", "past glowing mushrooms"],
+        comfortSpecies: ["frog", "dragon"],
+    },
+    mountains: {
+        id: "mountains", name: "Windy Peaks",
+        enemies: { easy: ["squirrel", "flamesprite"], medium: ["crow", "shadowfox", "emberfox"], hard: ["stormwolf", "lavabeetle", "crystalbasilisk"], boss: ["crystalguardian"] },
+        loot: { common: ["berry", "herb"], uncommon: ["potion", "chain_mail", "swift_boots"], rare: ["crystal_armor", "elixir", "dodge_cloak"], epic: ["dragon_fang", "dragon_scale_armor"] },
+        nouns: ["peak", "ridge", "cliff", "plateau", "pass", "summit", "crag", "ledge", "slope", "mountain"],
+        adjectives: ["windswept", "frozen", "steep", "treacherous", "snow-covered", "jagged", "towering", "icy", "barren", "majestic"],
+        landmarks: ["cairn of stones", "frozen waterfall", "eagle's nest", "mountain shrine", "wind-carved rock", "ice cave mouth", "abandoned camp", "prayer flags", "lookout point"],
+        hidingSpots: ["the mist", "behind a boulder", "a snow drift", "a rocky overhang", "a crevasse", "swirling clouds", "an ice formation", "behind a cairn"],
+        directions: ["a steep climb", "a rocky path", "a sheltered ravine", "a windy ridge", "across a rope bridge", "up a narrow ledge", "through a snow field", "along a goat trail"],
+        comfortSpecies: ["owl", "phoenix"],
+    },
+    swamp: {
+        id: "swamp", name: "Shadow Marsh",
+        enemies: { easy: ["snail", "mushroom", "puddleslime"], medium: ["shadowfox", "vinecreeper"], hard: ["stormwolf", "bogwitch"], boss: ["marshking"] },
+        loot: { common: ["herb", "stick"], uncommon: ["potion", "fish"], rare: ["elixir", "crystal_blade", "thorn_whip"], epic: ["phoenix_robe", "flame_scepter", "coral_plate"] },
+        nouns: ["marsh", "bog", "swamp", "fen", "wetland", "mire", "bayou", "quagmire", "morass", "lagoon"],
+        adjectives: ["murky", "foggy", "dank", "eerie", "bubbling", "stagnant", "slimy", "haunted", "oppressive", "dark"],
+        landmarks: ["dead tree", "lily pad cluster", "gas vent", "sunken ruins", "rotting dock", "will-o-wisp", "hanging moss", "frog choir spot", "ancient bridge"],
+        hidingSpots: ["the fog", "under the water", "behind reeds", "the murk", "beneath lily pads", "in the mud", "behind a dead tree", "thick marsh grass"],
+        directions: ["a rickety boardwalk", "through shallow muck", "along the bank", "over mossy stones", "past bubbling mud", "through cattails", "across stepping stones", "under drooping willows"],
+        comfortSpecies: ["frog"],
+    },
+    ruins: {
+        id: "ruins", name: "Ancient Ruins",
+        enemies: { easy: ["mushroom", "flamesprite"], medium: ["golem", "crow", "rustknight"], hard: ["golem", "stormwolf", "crystalbasilisk"], boss: ["crystalguardian"] },
+        loot: { common: ["herb", "wooden_stick"], uncommon: ["iron_sword", "chain_mail", "potion"], rare: ["crystal_blade", "crystal_armor", "midnight_bow"], epic: ["dragon_fang", "dragon_scale_armor", "sunblade"] },
+        nouns: ["ruins", "temple", "hall", "corridor", "chamber", "sanctum", "crypt", "gallery", "courtyard", "archive"],
+        adjectives: ["crumbling", "ancient", "vine-covered", "mysterious", "silent", "forgotten", "sacred", "dusty", "ornate", "eerie"],
+        landmarks: ["broken statue", "faded mural", "altar", "collapsed pillar", "sealed door", "mosaic floor", "empty fountain", "stone throne", "inscription wall"],
+        hidingSpots: ["the rubble", "behind a pillar", "in the shadows", "a collapsed archway", "an empty alcove", "behind a statue", "under debris", "a dark doorway"],
+        directions: ["a dusty corridor", "through a cracked door", "down worn steps", "past fallen columns", "through an archway", "along a mosaic path", "into a side chamber", "up a spiral staircase"],
+        comfortSpecies: ["owl", "cat"],
+    },
+    volcano: {
+        id: "volcano", name: "Molten Core",
+        enemies: { easy: ["mushroom", "flamesprite"], medium: ["golem", "emberfox"], hard: ["lavabeetle", "stormwolf"], boss: ["crystalguardian", "infernodrake"] },
+        loot: { common: ["herb", "sandals"], uncommon: ["potion", "iron_sword", "fire_amulet", "iron_helm"], rare: ["flame_scepter", "elixir", "shadow_hood"], epic: ["dragon_fang", "dragon_scale_armor", "phoenix_crest", "flame_treads", "dragon_helm", "dragon_greaves"] },
+        nouns: ["volcano", "caldera", "lava tube", "vent", "magma chamber", "crater", "furnace", "forge", "inferno", "core"],
+        adjectives: ["scorching", "glowing", "smoldering", "blazing", "sulfurous", "molten", "blistering", "incandescent", "ashen", "fiery"],
+        landmarks: ["lava flow", "obsidian formation", "fire geyser", "molten pool", "charred skeleton", "cooled lava bridge", "fire crystal", "volcanic vent", "magma spring"],
+        hidingSpots: ["the heat haze", "behind cooled lava", "an obsidian wall", "a vent plume", "ash clouds", "a lava tube", "behind a fire crystal", "a smoldering crater"],
+        directions: ["across a lava bridge", "through a cooled tunnel", "along the crater rim", "past a fire geyser", "over hardened magma", "through an ash field", "along the caldera edge", "into the furnace depths"],
+        comfortSpecies: ["phoenix", "dragon"],
+    },
+    shadowrealm: {
+        id: "shadowrealm", name: "Shadow Realm",
+        enemies: { easy: ["shadowfox", "crow"], medium: ["shadowfox", "crow", "rustknight"], hard: ["crystalbasilisk", "bogwitch", "stormwolf"], boss: ["thestranger"] },
+        loot: { common: ["herb", "stick"], uncommon: ["potion", "midnight_bow"], rare: ["shadow_hood", "shadow_steps", "elixir"], epic: ["shadow_dagger", "shadow_cloak"] },
+        nouns: ["void", "rift", "abyss", "expanse", "fracture", "echo", "mirage", "hollow", "emptiness", "chasm"],
+        adjectives: ["twisted", "inverted", "dark", "warped", "shifting", "hollow", "silent", "wrong", "familiar yet alien", "dreamlike"],
+        landmarks: ["shadow tree", "mirrored stone", "dark fountain", "twisted archway", "fading memory", "corrupted crystal", "echo of a bridge", "phantom campfire"],
+        hidingSpots: ["the darkness", "a ripple in reality", "behind your own shadow", "inside a memory", "the void between spaces", "a crack in the world"],
+        directions: ["into the shifting dark", "toward a familiar echo", "through a warped doorway", "along a path that wasn't there before", "following a faint light"],
+        comfortSpecies: ["cat"],
+    },
+    thecore: {
+        id: "thecore", name: "The Core",
+        enemies: { easy: ["flamesprite", "puddleslime"], medium: ["emberfox", "golem", "vinecreeper"], hard: ["lavabeetle", "crystalbasilisk", "stormwolf"], boss: ["shadowbeast"] },
+        loot: { common: ["herb", "berry"], uncommon: ["potion", "iron_sword"], rare: ["elixir", "crystal_blade"], epic: ["dragon_fang", "dragon_scale_armor", "elementalist_orb"] },
+        nouns: ["core", "nexus", "convergence", "heart", "origin", "source", "wellspring", "singularity", "foundation", "center"],
+        adjectives: ["primordial", "blinding", "pulsing", "overwhelming", "raw", "elemental", "ancient", "pure", "infinite", "resonating"],
+        landmarks: ["elemental vortex", "stone circle", "pillar of light", "pool of all colors", "the original seal", "six stone fragments", "throne of the guardian"],
+        hidingSpots: ["swirling energy", "behind a pillar of light", "within the elements", "between the Stones", "the eye of the storm"],
+        directions: ["toward the light", "through the elemental storm", "past the broken seal", "into the heart of everything", "following all six elements"],
+        comfortSpecies: [],
+    },
+};
+function getBiome(id) {
+    return exports.BIOMES[id];
+}
+function getAllBiomeIds() {
+    return Object.keys(exports.BIOMES);
+}
+//# sourceMappingURL=biomes.js.map

package/dist/adventure/generation/endless.d.ts

@@ -0,0 +1,18 @@
+import { BuddyState } from "../../buddy/types";
+import { AdventureDef, RoomDef } from "../types";
+/** Generate a single room for the Endless Depths at a given depth */
+export declare function generateEndlessRoom(depth: number, buddyState: BuddyState): RoomDef;
+/** Create the initial Endless Depths adventure (just 1 room to start) */
+export declare function createEndlessAdventure(buddyState: BuddyState): AdventureDef;
+/** Add the next room to an Endless Depths adventure */
+export declare function addEndlessRoom(adventure: AdventureDef, depth: number, buddyState: BuddyState): {
+    adventure: AdventureDef;
+    roomId: string;
+};
+/** Get enemy stat scaling for Endless Depths */
+export declare function scaleEndlessEnemy(baseHp: number, baseAtk: number, baseDef: number, depth: number): {
+    hp: number;
+    atk: number;
+    def: number;
+};
+//# sourceMappingURL=endless.d.ts.map

package/dist/adventure/generation/endless.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEndlessRoom = generateEndlessRoom;
+exports.createEndlessAdventure = createEndlessAdventure;
+exports.addEndlessRoom = addEndlessRoom;
+exports.scaleEndlessEnemy = scaleEndlessEnemy;
+const types_1 = require("../types");
+const biomes_1 = require("./biomes");
+const enemies_1 = require("../combat/enemies");
+const templates_1 = require("./templates");
+function pick(arr) {
+    return arr[Math.floor(Math.random() * arr.length)];
+}
+let endlessRoomCounter = 0;
+/** Get difficulty scaling for a given depth */
+function depthDifficulty(depth) {
+    // Starts at ~2, scales up every 3 rooms
+    return Math.min(15, 2 + Math.floor(depth / 3));
+}
+/** Pick a biome for this depth (rotates) */
+function depthBiome(depth) {
+    const ids = (0, biomes_1.getAllBiomeIds)();
+    const biome = biomes_1.BIOMES[ids[depth % ids.length]];
+    return biome;
+}
+/** Get enemy tier for depth */
+function depthEnemyTier(depth) {
+    if (depth <= 3)
+        return "easy";
+    if (depth <= 8)
+        return "medium";
+    return "hard";
+}
+/** Pick room type based on depth */
+function pickRoomType(depth) {
+    // Boss every 5 rooms
+    if (depth > 0 && depth % 5 === 0)
+        return "boss";
+    const roll = Math.random();
+    if (roll < 0.55)
+        return "combat";
+    if (roll < 0.70)
+        return "treasure";
+    if (roll < 0.82)
+        return "event";
+    return "rest"; // rare rest
+}
+/** Generate a single room for the Endless Depths at a given depth */
+function generateEndlessRoom(depth, buddyState) {
+    endlessRoomCounter++;
+    const biome = depthBiome(depth);
+    const diff = depthDifficulty(depth);
+    const roomType = pickRoomType(depth);
+    const roomId = `endless_${endlessRoomCounter}`;
+    const buddyLine = (0, templates_1.generateBuddyLine)(buddyState.speciesId, biome);
+    switch (roomType) {
+        case "combat": {
+            const tier = depthEnemyTier(depth);
+            const pool = biome.enemies[tier];
+            const enemyId = pool.length > 0 ? pick(pool) : "squirrel";
+            const enemy = enemies_1.ENEMIES[enemyId];
+            return {
+                id: roomId, type: "combat",
+                title: `Depth ${depth + 1} — ${(0, templates_1.generateCombatTitle)(biome)}`,
+                text: (0, templates_1.generateCombatText)(biome, enemy?.name ?? "creature"),
+                buddyLine,
+                enemyId,
+            };
+        }
+        case "boss": {
+            const bossPool = biome.enemies.boss;
+            const bossId = bossPool.length > 0 ? pick(bossPool) : "marshking";
+            const boss = enemies_1.ENEMIES[bossId];
+            return {
+                id: roomId, type: "boss",
+                title: `Depth ${depth + 1} — BOSS`,
+                text: (0, templates_1.generateBossText)(biome, boss?.name ?? "The Boss"),
+                buddyLine: "This feels like a big one... STAY STRONG!",
+                enemyId: bossId,
+            };
+        }
+        case "treasure": {
+            const tier = diff <= 4 ? "uncommon" : diff <= 7 ? "rare" : "epic";
+            return {
+                id: roomId, type: "treasure",
+                title: `Depth ${depth + 1} — Stash`,
+                text: (0, templates_1.generateTreasureText)(biome),
+                buddyLine,
+                lootPool: biome.loot[tier],
+            };
+        }
+        case "rest": {
+            const healAmount = 10 + Math.floor(diff * 1.5);
+            return {
+                id: roomId, type: "rest",
+                title: `Depth ${depth + 1} — Safe Haven`,
+                text: (0, templates_1.generateRestText)(biome),
+                buddyLine: "Quick break... don't get too comfortable.",
+                healAmount,
+            };
+        }
+        case "event": {
+            const event = (0, templates_1.generateEvent)(biome);
+            return {
+                id: roomId, type: "event",
+                title: `Depth ${depth + 1} — Encounter`,
+                text: event.text,
+                buddyLine,
+                eventChoices: event.choices.map((c) => ({
+                    label: c.label,
+                    outcome: c.outcome,
+                    effect: c.effect,
+                })),
+            };
+        }
+    }
+}
+/** Create the initial Endless Depths adventure (just 1 room to start) */
+function createEndlessAdventure(buddyState) {
+    endlessRoomCounter = 0;
+    const firstRoom = generateEndlessRoom(0, buddyState);
+    return {
+        id: "endless_depths",
+        name: "The Endless Depths",
+        description: "How deep can you go?",
+        difficulty: 99,
+        levelRequired: 5,
+        energyCost: 20,
+        hungerCost: 15,
+        rooms: [firstRoom],
+        roomMap: (0, types_1.buildRoomMap)([firstRoom]),
+        startRoomId: firstRoom.id,
+        completionXp: 0, // XP awarded per room, not on completion
+    };
+}
+/** Add the next room to an Endless Depths adventure */
+function addEndlessRoom(adventure, depth, buddyState) {
+    const room = generateEndlessRoom(depth, buddyState);
+    const rooms = [...adventure.rooms, room];
+    return {
+        adventure: { ...adventure, rooms, roomMap: (0, types_1.buildRoomMap)(rooms) },
+        roomId: room.id,
+    };
+}
+/** Get enemy stat scaling for Endless Depths */
+function scaleEndlessEnemy(baseHp, baseAtk, baseDef, depth) {
+    const mult = 1 + depth * 0.12;
+    return {
+        hp: Math.floor(baseHp * mult),
+        atk: Math.floor(baseAtk * mult),
+        def: Math.floor(baseDef * mult),
+    };
+}
+//# sourceMappingURL=endless.js.map

package/dist/adventure/generation/generator.d.ts

@@ -0,0 +1,9 @@
+import { BuddyState } from "../../buddy/types";
+import { AdventureDef } from "../types";
+export interface ExpeditionConfig {
+    difficulty: number;
+    biomeId: string;
+    buddyState: BuddyState;
+}
+export declare function generateExpedition(config: ExpeditionConfig): AdventureDef;
+//# sourceMappingURL=generator.d.ts.map