clibuddy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zippy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# CLIBuddy
+
+A tamagotchi-style virtual pet that lives in your terminal. Feed it, play with it, take it on adventures, fight bosses, and watch it grow.
+
+```
+   /\_/\
+  ( o.o )   < Hi! I'm your buddy!
+   > ^ <
+```
+
+## Install
+
+```bash
+npm install -g clibuddy
+```
+
+Or try without installing:
+
+```bash
+npx clibuddy
+```
+
+## What is this?
+
+CLIBuddy is a full-screen terminal game where you raise an ASCII art companion. Your buddy has needs (hunger, happiness, health, energy), gains XP, levels up, earns titles, finds items, and goes on adventures with a full story campaign.
+
+**Features:**
+- 7 species to roll (Common to Legendary rarity)
+- Deep turn-based combat with elements, skills, combos, and boss phases
+- 8-chapter hand-crafted story with 4 recurring NPCs and ~141 rooms
+- 6 minigames
+- 32 gear items with passive effects
+- 50 earnable titles
+- Procedural dungeon expeditions with 6 biomes
+- Idle events, dialogue, and item discovery
+- Persistent save file (your buddy remembers you)
+
+## Controls
+
+- Type `/` to open the command palette
+- Arrow keys to navigate, Enter to select
+- All gameplay happens through commands: `/feed`, `/play`, `/sleep`, `/adventure`, etc.
+- Type `/help` for a full command list
+
+## Requirements
+
+- Node.js 18+
+- A terminal that supports ANSI escape codes (most modern terminals)
+
+## Update
+
+```bash
+npm update -g clibuddy
+```
+
+Or type `/update` inside the game.
+
+## License
+
+MIT

package/dist/adventure/adventureUI.d.ts

@@ -0,0 +1,24 @@
+import { BuddyState } from "../buddy/types";
+import { AdventureDef, AdventureState } from "./types";
+import { QuestChain } from "../story/types";
+export interface AdventureMenuState {
+    active: boolean;
+    tab: "story" | "expedition" | "endless";
+    selectedIndex: number;
+    expeditionDifficulty: number;
+    expeditionBiomeIndex: number;
+    questChains: QuestChain[];
+    selectedChainIndex: number;
+}
+export declare function createAdventureMenu(): AdventureMenuState;
+export declare function openAdventureMenu(questChains?: QuestChain[]): AdventureMenuState;
+export declare function switchTab(menu: AdventureMenuState): AdventureMenuState;
+export declare function moveAdventureSelection(menu: AdventureMenuState, delta: number): AdventureMenuState;
+/** Switch between quest chains with left/right */
+export declare function changeQuestChain(menu: AdventureMenuState, delta: number): AdventureMenuState;
+export declare function changeExpeditionBiome(menu: AdventureMenuState, delta: number): AdventureMenuState;
+export declare function getSelectedBiomeId(menu: AdventureMenuState): string;
+export declare function renderAdventureMenu(menu: AdventureMenuState, state: BuddyState): string[];
+export declare function renderRoom(advState: AdventureState, adventure: AdventureDef, buddyName: string): string;
+export declare function renderResult(advState: AdventureState, adventure: AdventureDef, buddyName: string): string;
+//# sourceMappingURL=adventureUI.d.ts.map

package/dist/adventure/adventureUI.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdventureMenu = createAdventureMenu;
+exports.openAdventureMenu = openAdventureMenu;
+exports.switchTab = switchTab;
+exports.moveAdventureSelection = moveAdventureSelection;
+exports.changeQuestChain = changeQuestChain;
+exports.changeExpeditionBiome = changeExpeditionBiome;
+exports.getSelectedBiomeId = getSelectedBiomeId;
+exports.renderAdventureMenu = renderAdventureMenu;
+exports.renderRoom = renderRoom;
+exports.renderResult = renderResult;
+const types_1 = require("./types");
+const biomes_1 = require("./generation/biomes");
+const types_2 = require("../story/types");
+const npcs_1 = require("../story/npcs");
+const listUtils_1 = require("../rendering/listUtils");
+const screen_1 = require("../rendering/screen");
+function createAdventureMenu() {
+    return { active: false, tab: "story", selectedIndex: 0, expeditionDifficulty: 1, expeditionBiomeIndex: 0, questChains: [], selectedChainIndex: 0 };
+}
+function openAdventureMenu(questChains = []) {
+    return { active: true, tab: "story", selectedIndex: 0, expeditionDifficulty: 1, expeditionBiomeIndex: 0, questChains, selectedChainIndex: 0 };
+}
+function switchTab(menu) {
+    const tabs = ["story", "expedition", "endless"];
+    const idx = (tabs.indexOf(menu.tab) + 1) % tabs.length;
+    return { ...menu, tab: tabs[idx], selectedIndex: 0 };
+}
+function moveAdventureSelection(menu, delta) {
+    if (menu.tab === "story") {
+        const chain = menu.questChains[menu.selectedChainIndex];
+        if (!chain)
+            return menu;
+        return { ...menu, selectedIndex: (0, listUtils_1.moveListIndex)(menu.selectedIndex, delta, chain.chapters.length) };
+    }
+    else {
+        const next = Math.max(1, Math.min(10, menu.expeditionDifficulty + delta));
+        return { ...menu, expeditionDifficulty: next };
+    }
+}
+/** Switch between quest chains with left/right */
+function changeQuestChain(menu, delta) {
+    if (menu.questChains.length === 0)
+        return menu;
+    const next = (0, listUtils_1.moveListIndex)(menu.selectedChainIndex, delta, menu.questChains.length);
+    return { ...menu, selectedChainIndex: next, selectedIndex: 0 };
+}
+function changeExpeditionBiome(menu, delta) {
+    const biomeIds = (0, biomes_1.getAllBiomeIds)();
+    let next = menu.expeditionBiomeIndex + delta;
+    if (next < 0)
+        next = biomeIds.length - 1;
+    if (next >= biomeIds.length)
+        next = 0;
+    return { ...menu, expeditionBiomeIndex: next };
+}
+function getSelectedBiomeId(menu) {
+    return (0, biomes_1.getAllBiomeIds)()[menu.expeditionBiomeIndex];
+}
+const DIFFICULTY_COLORS = {
+    easy: screen_1.ansi.colors.green,
+    medium: screen_1.ansi.colors.yellow,
+    hard: screen_1.ansi.colors.red,
+    boss: screen_1.ansi.colors.magenta,
+};
+const DIFF_LABELS = {
+    1: "Peaceful Stroll", 2: "Gentle Walk", 3: "Challenging Trek",
+    4: "Tough Hike", 5: "Dangerous Quest", 6: "Heroic Mission",
+    7: "Perilous Journey", 8: "Epic Expedition", 9: "Legendary Quest",
+    10: "Nightmare Run",
+};
+function renderAdventureMenu(menu, state) {
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    // Tab bar
+    const storyTab = menu.tab === "story" ? `${screen_1.ansi.bold}${screen_1.ansi.colors.yellow}[Story]${screen_1.ansi.reset}` : `${screen_1.ansi.dim}[Story]${screen_1.ansi.reset}`;
+    const expTab = menu.tab === "expedition" ? `${screen_1.ansi.bold}${screen_1.ansi.colors.cyan}[Expedition]${screen_1.ansi.reset}` : `${screen_1.ansi.dim}[Expedition]${screen_1.ansi.reset}`;
+    const endTab = menu.tab === "endless" ? `${screen_1.ansi.bold}${screen_1.ansi.colors.magenta}[Endless]${screen_1.ansi.reset}` : `${screen_1.ansi.dim}[Endless]${screen_1.ansi.reset}`;
+    lines.push(`  ${storyTab}  ${expTab}  ${endTab}  ${screen_1.ansi.dim}Tab${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    if (menu.tab === "story") {
+        renderQuestsTab(lines, menu, state);
+    }
+    else if (menu.tab === "expedition") {
+        renderExpeditionTab(lines, menu, state);
+    }
+    else {
+        renderEndlessTab(lines, state);
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    return lines;
+}
+function renderQuestsTab(lines, menu, state) {
+    if (menu.questChains.length === 0) {
+        lines.push(`  ${screen_1.ansi.dim}No quest chains available yet.${screen_1.ansi.reset}`);
+        lines.push(`  ${screen_1.ansi.dim}Check the Story tab for adventures!${screen_1.ansi.reset}`);
+        return;
+    }
+    const progress = state.questProgress;
+    const chain = menu.questChains[menu.selectedChainIndex];
+    if (!chain)
+        return;
+    // Chain selector (left/right)
+    const chainLabel = chain.type === "main" ? `${screen_1.ansi.colors.yellow}★${screen_1.ansi.reset}` : chain.type === "seasonal" ? `${screen_1.ansi.colors.cyan}❄${screen_1.ansi.reset}` : `${screen_1.ansi.dim}○${screen_1.ansi.reset}`;
+    lines.push(`  ${chainLabel} ${screen_1.ansi.bold}${chain.name}${screen_1.ansi.reset}  ${screen_1.ansi.dim}(${menu.selectedChainIndex + 1}/${menu.questChains.length})  ←→ to switch${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${chain.description}${screen_1.ansi.reset}`);
+    lines.push("");
+    // Chapter list
+    for (let i = 0; i < chain.chapters.length; i++) {
+        const chapter = chain.chapters[i];
+        const completed = (0, types_2.isChapterComplete)(chapter.id, progress);
+        const blockReason = (0, types_2.canStartChapter)(chapter, progress, state.level);
+        const selected = i === menu.selectedIndex;
+        const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+        if (completed) {
+            lines.push(`  ${pointer} ${screen_1.ansi.colors.green}✓${screen_1.ansi.reset} ${screen_1.ansi.dim}${chapter.name}${screen_1.ansi.reset}`);
+        }
+        else if (!blockReason) {
+            // Available
+            if (selected) {
+                lines.push(`  ${pointer} ${screen_1.ansi.bold}${chapter.name}${screen_1.ansi.reset}  ${screen_1.ansi.dim}Lv${chapter.levelRequired}${screen_1.ansi.reset}`);
+                lines.push(`    ${screen_1.ansi.dim}${chapter.description}${screen_1.ansi.reset}`);
+                lines.push(`    ${screen_1.ansi.dim}Rewards: ${chapter.rewards.xp} XP, ${chapter.rewards.gold} gold${chapter.rewards.titleId ? ", new title" : ""}${screen_1.ansi.reset}`);
+            }
+            else {
+                lines.push(`  ${pointer} ${chapter.name}  ${screen_1.ansi.dim}Lv${chapter.levelRequired}${screen_1.ansi.reset}`);
+            }
+        }
+        else {
+            // Locked
+            lines.push(`  ${pointer} ${screen_1.ansi.dim}🔒 ${chapter.name} — ${blockReason}${screen_1.ansi.reset}`);
+        }
+    }
+    lines.push(`  ${screen_1.ansi.dim}Enter to start, Esc to close${screen_1.ansi.reset}`);
+}
+function renderExpeditionTab(lines, menu, state) {
+    const diff = menu.expeditionDifficulty;
+    const biomeIds = (0, biomes_1.getAllBiomeIds)();
+    const biomeId = biomeIds[menu.expeditionBiomeIndex];
+    const biome = biomes_1.BIOMES[biomeId];
+    const label = DIFF_LABELS[diff] ?? `Level ${diff}`;
+    const roomCount = diff <= 2 ? "3-4" : diff <= 4 ? "4-5" : diff <= 6 ? "5-6" : diff <= 8 ? "6-7" : "7-8";
+    const hasBoss = diff >= 5;
+    const diffColor = diff <= 2 ? screen_1.ansi.colors.green : diff <= 5 ? screen_1.ansi.colors.yellow : diff <= 8 ? screen_1.ansi.colors.red : screen_1.ansi.colors.magenta;
+    lines.push(`  ${screen_1.ansi.bold}Difficulty:${screen_1.ansi.reset} ${diffColor}${diff}${screen_1.ansi.reset} — ${label}  ${screen_1.ansi.dim}↑↓${screen_1.ansi.reset}`);
+    lines.push(`    ${screen_1.ansi.dim}${roomCount} rooms${hasBoss ? ", boss fight" : ""}, Lv${Math.max(1, (diff - 1) * 2)}+ required${screen_1.ansi.reset}`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.bold}Biome:${screen_1.ansi.reset} ${biome?.name ?? biomeId}  ${screen_1.ansi.dim}←→ to change${screen_1.ansi.reset}`);
+    lines.push("");
+    const energyCost = 10 + diff * 3;
+    const hungerCost = 5 + diff * 2;
+    lines.push(`  ${screen_1.ansi.dim}Cost: ${energyCost} energy, ${hungerCost} hunger${screen_1.ansi.reset}`);
+    const canGo = state.level >= Math.max(1, (diff - 1) * 2) && state.stats.energy >= energyCost && state.stats.hunger >= hungerCost;
+    if (canGo) {
+        lines.push(`  ${screen_1.ansi.colors.green}Ready to embark!${screen_1.ansi.reset}`);
+    }
+    else {
+        lines.push(`  ${screen_1.ansi.colors.red}Not ready — check level/energy/hunger${screen_1.ansi.reset}`);
+    }
+    lines.push(`  ${screen_1.ansi.dim}Enter to generate & start, Esc to close${screen_1.ansi.reset}`);
+}
+function renderEndlessTab(lines, state) {
+    lines.push(`  ${screen_1.ansi.bold}${screen_1.ansi.colors.magenta}The Endless Depths${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}How deep can you go? One life, escalating difficulty.${screen_1.ansi.reset}`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.dim}• Rooms get harder every 3 depths${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}• Boss every 5 depths${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}• HP carries between rooms${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}• Biome rotates each room${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}• Defeat = run over${screen_1.ansi.reset}`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.dim}Requires: Level 5+, 20 energy, 15 hunger${screen_1.ansi.reset}`);
+    const canGo = state.level >= 5 && state.stats.energy >= 20 && state.stats.hunger >= 15;
+    if (canGo) {
+        lines.push(`  ${screen_1.ansi.colors.green}Ready to descend!${screen_1.ansi.reset}`);
+    }
+    else {
+        lines.push(`  ${screen_1.ansi.colors.red}Not ready — check level/energy/hunger${screen_1.ansi.reset}`);
+    }
+    lines.push(`  ${screen_1.ansi.dim}Enter to begin your descent${screen_1.ansi.reset}`);
+}
+// ─── Adventure Room Rendering ────────────────────────────────
+function renderRoom(advState, adventure, buddyName) {
+    const room = (0, types_1.getRoom)(adventure, advState.currentRoomId);
+    if (!room)
+        return "  Room not found!";
+    const progress = (0, types_1.getRoomProgress)(advState);
+    const lines = [];
+    lines.push("");
+    if (adventure.isScene || adventure.hideRoomCounter) {
+        lines.push(`  ${screen_1.ansi.bold}${adventure.name}${screen_1.ansi.reset}`);
+    }
+    else {
+        lines.push(`  ${screen_1.ansi.bold}${adventure.name}${screen_1.ansi.reset}  ${screen_1.ansi.dim}Room ${progress}/${adventure.rooms.length}${screen_1.ansi.reset}  ${screen_1.ansi.dim}Morale: ${advState.morale}%${screen_1.ansi.reset}`);
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(44)}${screen_1.ansi.reset}`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.bold}${room.title}${screen_1.ansi.reset}`);
+    lines.push("");
+    // Show NPC ASCII art if present
+    if (room.npcsPresent && room.npcsPresent.length > 0) {
+        for (const npcId of room.npcsPresent) {
+            const npc = (0, npcs_1.getNPC)(npcId);
+            if (npc) {
+                lines.push(`  ${screen_1.ansi.dim}${npc.name} the ${npc.title}${screen_1.ansi.reset}`);
+                for (const artLine of npc.art) {
+                    lines.push(`    ${screen_1.ansi.colors.cyan}${artLine}${screen_1.ansi.reset}`);
+                }
+                lines.push("");
+            }
+        }
+    }
+    // Paged text display — show LINES_PER_PAGE lines per page
+    const LINES_PER_PAGE = 3;
+    const totalPages = Math.ceil(room.text.length / LINES_PER_PAGE);
+    const currentPage = advState.textPage;
+    const textFullyShown = advState.textFullyShown || currentPage >= totalPages - 1;
+    // Show text up to current page
+    const linesToShow = Math.min(room.text.length, (currentPage + 1) * LINES_PER_PAGE);
+    for (let i = 0; i < linesToShow; i++) {
+        lines.push(`  ${room.text[i]}`);
+    }
+    lines.push("");
+    if (!textFullyShown) {
+        // More text to show — prompt to continue reading
+        lines.push(`  ${screen_1.ansi.dim}▼ Press Enter to continue reading... (${currentPage + 1}/${totalPages})${screen_1.ansi.reset}`);
+    }
+    else {
+        // All text shown — show buddy line + choices
+        lines.push(`  ${buddyName}: "${advState.buddyReaction}"`);
+        lines.push("");
+        if (room.type === "narrative" && room.choices) {
+            for (let i = 0; i < room.choices.length; i++) {
+                lines.push(`  [${i + 1}] ${room.choices[i].label}`);
+            }
+        }
+        else if (room.type === "event" && room.eventChoices) {
+            // Check if event was already resolved
+            const alreadyResolved = room.eventChoices.some((c) => c.outcome === advState.buddyReaction);
+            if (alreadyResolved) {
+                lines.push(`  ${screen_1.ansi.dim}Press Enter to continue...${screen_1.ansi.reset}`);
+            }
+            else {
+                for (let i = 0; i < room.eventChoices.length; i++) {
+                    lines.push(`  [${i + 1}] ${room.eventChoices[i].label}`);
+                }
+            }
+        }
+        else if (room.type === "treasure") {
+            lines.push(`  ${screen_1.ansi.dim}Press Enter to search...${screen_1.ansi.reset}`);
+        }
+        else if (room.type === "rest") {
+            lines.push(`  [1] Rest here (+${room.healAmount} HP)`);
+            lines.push(`  [2] Keep moving`);
+        }
+        else {
+            lines.push(`  ${screen_1.ansi.dim}Press Enter to continue...${screen_1.ansi.reset}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// ─── Result Screen ───────────────────────────────────────────
+function renderResult(advState, adventure, buddyName) {
+    const lines = [];
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.bold}${screen_1.ansi.colors.green}Adventure Complete!${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(44)}${screen_1.ansi.reset}`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.bold}${adventure.name}${screen_1.ansi.reset} — Cleared!`);
+    lines.push("");
+    lines.push(`  Battles: ${advState.battlesWon} won, ${advState.battlesLost} lost, ${advState.battlesFled} fled`);
+    if (advState.lootCollected.length > 0) {
+        const lootNames = advState.lootCollected.map((id) => id.replace(/_/g, " "));
+        lines.push(`  Loot: ${lootNames.join(", ")}`);
+    }
+    lines.push(`  XP earned: ${screen_1.ansi.bold}${advState.xpEarned}${screen_1.ansi.reset}`);
+    lines.push(`  Final morale: ${advState.morale}%`);
+    if (advState.damageTaken === 0 && advState.battlesWon > 0) {
+        lines.push(`  ${screen_1.ansi.colors.yellow}★ PERFECT — No damage taken!${screen_1.ansi.reset}`);
+    }
+    lines.push("");
+    lines.push(`  ${buddyName}: "${advState.buddyReaction}"`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.dim}Press Enter to return...${screen_1.ansi.reset}`);
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=adventureUI.js.map

package/dist/adventure/adventures.d.ts

@@ -0,0 +1,4 @@
+import { AdventureDef } from "./types";
+export declare const ADVENTURES: AdventureDef[];
+export declare function getAdventure(id: string): AdventureDef | undefined;
+//# sourceMappingURL=adventures.d.ts.map

package/dist/adventure/adventures.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADVENTURES = void 0;
+exports.getAdventure = getAdventure;
+const types_1 = require("./types");
+function makeAdventure(def) {
+    return { ...def, roomMap: (0, types_1.buildRoomMap)(def.rooms) };
+}
+exports.ADVENTURES = [
+    makeAdventure({
+        id: "rustling_woods",
+        name: "The Rustling Woods",
+        description: "A gentle forest with small critters. Perfect for beginners!",
+        difficulty: "easy",
+        levelRequired: 1,
+        energyCost: 15,
+        hungerCost: 10,
+        completionXp: 30,
+        startRoomId: "rw_entry",
+        rooms: [
+            {
+                id: "rw_entry", type: "narrative", title: "Forest Entrance",
+                text: ["Sunlight filters through the canopy.", "A worn path splits into two directions.", "You hear chirping to the left and rustling to the right."],
+                buddyLine: "Ooh, an adventure! Which way?",
+                choices: [
+                    { label: "Follow the chirping (left)", nextRoomId: "rw_clearing" },
+                    { label: "Investigate the rustling (right)", nextRoomId: "rw_thicket" },
+                ],
+            },
+            {
+                id: "rw_clearing", type: "combat", title: "Friendly Clearing",
+                text: ["You enter a sunny clearing. A squirrel spots you and gets defensive!"],
+                buddyLine: "It's just a squirrel... a very angry squirrel!",
+                enemyId: "squirrel",
+                nextRoomId: "rw_treasure",
+            },
+            {
+                id: "rw_thicket", type: "combat", title: "Dense Thicket",
+                text: ["You push through thick bushes. A bouncing mushroom blocks the path!"],
+                buddyLine: "Is that mushroom... alive?!",
+                enemyId: "mushroom",
+                nextRoomId: "rw_treasure",
+            },
+            {
+                id: "rw_treasure", type: "treasure", title: "Hidden Hollow",
+                text: ["Behind some fallen leaves, you find a small stash!"],
+                buddyLine: "Ooh, shiny! Finders keepers!",
+                lootPool: ["berry", "herb", "wooden_stick", "leaf_cloak"],
+            },
+        ],
+    }),
+    makeAdventure({
+        id: "crystal_caves",
+        name: "The Crystal Caves",
+        description: "Underground caverns with glowing crystals and tricky foes.",
+        difficulty: "medium",
+        levelRequired: 3,
+        energyCost: 20,
+        hungerCost: 15,
+        completionXp: 50,
+        startRoomId: "cc_entry",
+        rooms: [
+            {
+                id: "cc_entry", type: "narrative", title: "Cave Mouth",
+                text: ["A cave entrance glimmers with faint blue light.", "The air is cool and damp. Two tunnels branch ahead."],
+                buddyLine: "It's pretty in here... and a little spooky.",
+                choices: [
+                    { label: "Take the narrow crystal tunnel", nextRoomId: "cc_crystal" },
+                    { label: "Wade through the shallow stream", nextRoomId: "cc_stream" },
+                ],
+            },
+            {
+                id: "cc_crystal", type: "combat", title: "Crystal Chamber",
+                text: ["Crystals hum as you enter. A golem awakens from the wall!"],
+                buddyLine: "That rock is MOVING!",
+                enemyId: "golem",
+                nextRoomId: "cc_pool",
+            },
+            {
+                id: "cc_stream", type: "combat", title: "Underground Stream",
+                text: ["A crow perches on a stalactite, eyeing you menacingly."],
+                buddyLine: "How did a crow get down here?!",
+                enemyId: "crow",
+                nextRoomId: "cc_pool",
+            },
+            {
+                id: "cc_pool", type: "rest", title: "Glowing Pool",
+                text: ["A warm pool glows softly. It looks healing..."],
+                buddyLine: "Can we rest here? Just for a moment?",
+                healAmount: 20,
+                nextRoomId: "cc_treasure",
+            },
+            {
+                id: "cc_treasure", type: "treasure", title: "Crystal Cache",
+                text: ["Deep in the cave, crystals surround a gleaming prize!"],
+                buddyLine: "Jackpot!",
+                lootPool: ["iron_sword", "chain_mail", "potion", "fish"],
+            },
+        ],
+    }),
+    makeAdventure({
+        id: "windy_peaks",
+        name: "The Windy Peaks",
+        description: "A treacherous mountain path with fierce creatures and rare gear.",
+        difficulty: "hard",
+        levelRequired: 6,
+        energyCost: 25,
+        hungerCost: 20,
+        completionXp: 75,
+        startRoomId: "wp_entry",
+        rooms: [
+            {
+                id: "wp_entry", type: "narrative", title: "Mountain Base",
+                text: ["The wind howls as you begin the ascent.", "A steep path goes straight up. A cave offers shelter to the side."],
+                buddyLine: "It's cold up here! But we're tough, right?",
+                choices: [
+                    { label: "Climb the steep path", nextRoomId: "wp_ridge" },
+                    { label: "Explore the mountain cave", nextRoomId: "wp_vent" },
+                ],
+            },
+            {
+                id: "wp_ridge", type: "combat", title: "Windswept Ridge",
+                text: ["A storm wolf emerges from the blizzard, teeth bared!"],
+                buddyLine: "That's a BIG wolf!",
+                enemyId: "stormwolf",
+                nextRoomId: "wp_hermit",
+            },
+            {
+                id: "wp_vent", type: "combat", title: "Volcanic Vent",
+                text: ["The cave gets hotter. A glowing beetle blocks the way!"],
+                buddyLine: "Is it just me or is it really hot in here?!",
+                enemyId: "lavabeetle",
+                nextRoomId: "wp_hermit",
+            },
+            {
+                id: "wp_hermit", type: "event", title: "Mountain Hermit",
+                text: ["An old traveler sits by a small fire.", "\"Trade you something useful for a Berry?\""],
+                buddyLine: "Can we trust them?",
+                nextRoomId: "wp_treasure",
+                eventChoices: [
+                    { label: "Trade a Berry", outcome: "The hermit hands you a gleaming blade!", effect: { itemGain: "crystal_blade" } },
+                    { label: "Politely decline", outcome: "The hermit nods and waves you on." },
+                ],
+            },
+            {
+                id: "wp_treasure", type: "treasure", title: "Summit Stash",
+                text: ["At the peak, tucked under a rock — treasure!"],
+                buddyLine: "We made it to the top! And there's LOOT!",
+                lootPool: ["crystal_blade", "crystal_armor", "elixir", "cake"],
+            },
+        ],
+    }),
+    makeAdventure({
+        id: "shadow_marsh",
+        name: "The Shadow Marsh",
+        description: "A dark swamp with a terrible boss lurking in the depths.",
+        difficulty: "boss",
+        levelRequired: 10,
+        energyCost: 30,
+        hungerCost: 25,
+        completionXp: 100,
+        startRoomId: "sm_entry",
+        rooms: [
+            {
+                id: "sm_entry", type: "narrative", title: "Marsh Edge",
+                text: ["The ground turns soft and spongy. Fog rolls in.", "Something is watching from the murky water."],
+                buddyLine: "I don't like this place...",
+                choices: [
+                    { label: "Stick to the boardwalk", nextRoomId: "sm_fog" },
+                    { label: "Wade through the shallow muck", nextRoomId: "sm_murk" },
+                ],
+            },
+            {
+                id: "sm_fog", type: "combat", title: "Foggy Path",
+                text: ["A shadow moves through the fog — it's a fox, but darker and meaner!"],
+                buddyLine: "That's no friendly fox!",
+                enemyId: "shadowfox",
+                nextRoomId: "sm_rest",
+            },
+            {
+                id: "sm_murk", type: "combat", title: "Murky Depths",
+                text: ["Something slithers underfoot. A giant snail rises from the muck!"],
+                buddyLine: "That snail is HUGE!",
+                enemyId: "snail",
+                nextRoomId: "sm_rest",
+            },
+            {
+                id: "sm_rest", type: "rest", title: "Dry Island",
+                text: ["A small dry patch in the swamp. Fireflies dance around it."],
+                buddyLine: "Let's catch our breath before the big fight...",
+                healAmount: 30,
+                nextRoomId: "sm_boss",
+            },
+            {
+                id: "sm_boss", type: "boss", title: "The Marsh King's Lair",
+                text: ["The water bubbles. The ground trembles.", "A massive figure rises from the swamp..."],
+                buddyLine: "Here it comes... STAY STRONG!",
+                enemyId: "marshking",
+            },
+        ],
+    }),
+];
+function getAdventure(id) {
+    return exports.ADVENTURES.find((a) => a.id === id);
+}
+//# sourceMappingURL=adventures.js.map

package/dist/adventure/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