clibuddy 1.0.0

package/dist/adventure/generation/generator.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateExpedition = generateExpedition;
+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 idCounter = 0;
+function nextId(prefix) {
+    return `${prefix}_${++idCounter}`;
+}
+// ─── Difficulty Scaling ──────────────────────────────────────
+function getRoomCount(difficulty) {
+    if (difficulty <= 2)
+        return 3 + Math.floor(Math.random() * 2); // 3-4
+    if (difficulty <= 4)
+        return 4 + Math.floor(Math.random() * 2); // 4-5
+    if (difficulty <= 6)
+        return 5 + Math.floor(Math.random() * 2); // 5-6
+    if (difficulty <= 8)
+        return 6 + Math.floor(Math.random() * 2); // 6-7
+    return 7 + Math.floor(Math.random() * 2); // 7-8
+}
+function getEnemyTier(difficulty) {
+    if (difficulty <= 2)
+        return "easy";
+    if (difficulty <= 5)
+        return "medium";
+    return "hard";
+}
+function hasBoss(difficulty) {
+    return difficulty >= 5;
+}
+function getStatMultiplier(difficulty) {
+    return 1 + difficulty * 0.15;
+}
+function getLootTier(difficulty) {
+    if (difficulty <= 2)
+        return pick(["common", "uncommon"]);
+    if (difficulty <= 5)
+        return pick(["uncommon", "rare"]);
+    if (difficulty <= 8)
+        return pick(["rare", "epic"]);
+    return "epic";
+}
+function getEnergyCost(difficulty) {
+    return 10 + difficulty * 3;
+}
+function getHungerCost(difficulty) {
+    return 5 + difficulty * 2;
+}
+function getLevelRequired(difficulty) {
+    return Math.max(1, (difficulty - 1) * 2);
+}
+// ─── Scaled Enemy Creation ───────────────────────────────────
+function pickScaledEnemy(biome, difficulty) {
+    const tier = getEnemyTier(difficulty);
+    const pool = biome.enemies[tier];
+    if (pool.length === 0)
+        return biome.enemies.easy[0]; // fallback
+    return pick(pool);
+}
+function pickBoss(biome) {
+    return pick(biome.enemies.boss);
+}
+// ─── Room Type Distribution ──────────────────────────────────
+function pickRoomTypes(count, hasBossRoom) {
+    // First room is always narrative, last is boss (if applicable) or combat
+    const types = ["narrative"];
+    const middleCount = count - (hasBossRoom ? 2 : 1); // subtract entry + boss
+    const pool = [];
+    // Ensure at least one combat
+    pool.push("combat");
+    // Fill rest with weighted random
+    for (let i = 1; i < middleCount; i++) {
+        const roll = Math.random();
+        if (roll < 0.35)
+            pool.push("combat");
+        else if (roll < 0.55)
+            pool.push("narrative");
+        else if (roll < 0.70)
+            pool.push("treasure");
+        else if (roll < 0.85)
+            pool.push("event");
+        else
+            pool.push("rest");
+    }
+    // Shuffle middle rooms
+    for (let i = pool.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [pool[i], pool[j]] = [pool[j], pool[i]];
+    }
+    types.push(...pool);
+    if (hasBossRoom) {
+        types.push("boss");
+    }
+    return types;
+}
+// ─── Main Generator ──────────────────────────────────────────
+function generateExpedition(config) {
+    idCounter = 0;
+    const biome = (0, biomes_1.getBiome)(config.biomeId);
+    const { difficulty, buddyState } = config;
+    const roomCount = getRoomCount(difficulty);
+    const bossRoom = hasBoss(difficulty);
+    const roomTypes = pickRoomTypes(roomCount, bossRoom);
+    const rooms = [];
+    // Build rooms
+    for (let i = 0; i < roomTypes.length; i++) {
+        const type = roomTypes[i];
+        const roomId = nextId(type);
+        const isLast = i === roomTypes.length - 1;
+        // Next room ID (linear chain for now, narrative rooms get branching)
+        const nextRoomId = isLast ? undefined : undefined; // will be wired below
+        const room = buildRoom(type, roomId, biome, difficulty, buddyState);
+        rooms.push(room);
+    }
+    // Wire linear next-room chain
+    for (let i = 0; i < rooms.length - 1; i++) {
+        if (rooms[i].type === "narrative" && !rooms[i].choices) {
+            rooms[i].nextRoomId = rooms[i + 1].id;
+        }
+        else if (rooms[i].type !== "narrative") {
+            rooms[i].nextRoomId = rooms[i + 1].id;
+        }
+    }
+    // First room (narrative) gets branching choices
+    if (rooms.length >= 3 && rooms[0].type === "narrative") {
+        // Entry branches to rooms[1] and rooms[2], both converge later
+        const entryRoom = rooms[0];
+        const pathA = rooms[1];
+        const pathB = rooms.length > 2 ? rooms[2] : rooms[1];
+        const labels = (0, templates_1.generateChoiceLabels)(biome);
+        entryRoom.choices = [
+            { label: labels[0], nextRoomId: pathA.id },
+            { label: labels[1], nextRoomId: pathB.id },
+        ];
+        entryRoom.nextRoomId = undefined; // choices handle navigation
+        // Both paths converge at room[3] (or the next available room after the two paths)
+        if (rooms.length > 3) {
+            pathA.nextRoomId = rooms[3].id;
+            pathB.nextRoomId = rooms[3].id;
+        }
+    }
+    // Optionally add hidden room for matching species
+    if (Math.random() < 0.4 && biome.comfortSpecies.includes(buddyState.speciesId)) {
+        const hiddenId = nextId("hidden");
+        const convergeTo = rooms.length > 3 ? rooms[rooms.length - 2].id : rooms[rooms.length - 1].id;
+        const hiddenRoom = {
+            id: hiddenId,
+            type: "treasure",
+            title: "Secret Chamber",
+            text: (0, templates_1.generateHiddenRoomText)(biome, buddyState.speciesId),
+            buddyLine: "I knew I sensed something special here!",
+            nextRoomId: convergeTo,
+            lootPool: biome.loot.rare.concat(biome.loot.epic),
+            condition: { type: "species", value: buddyState.speciesId },
+        };
+        rooms.push(hiddenRoom);
+        // Add hidden room as a third choice on entry
+        if (rooms[0].choices) {
+            const speciesName = buddyState.speciesId.charAt(0).toUpperCase() + buddyState.speciesId.slice(1);
+            rooms[0].choices.push({
+                label: `[${speciesName}] Sniff out a hidden path`,
+                nextRoomId: hiddenId,
+            });
+        }
+    }
+    const completionXp = Math.round(15 * difficulty * roomCount * 0.3);
+    return {
+        id: `expedition_${Date.now()}`,
+        name: `${biome.name} Expedition`,
+        description: `Difficulty ${difficulty} — ${roomCount} rooms`,
+        difficulty,
+        levelRequired: getLevelRequired(difficulty),
+        energyCost: getEnergyCost(difficulty),
+        hungerCost: getHungerCost(difficulty),
+        rooms,
+        roomMap: (0, types_1.buildRoomMap)(rooms),
+        startRoomId: rooms[0].id,
+        completionXp,
+    };
+}
+// ─── Room Builder ────────────────────────────────────────────
+function buildRoom(type, id, biome, difficulty, buddyState) {
+    const buddyLine = (0, templates_1.generateBuddyLine)(buddyState.speciesId, biome);
+    switch (type) {
+        case "narrative":
+            return {
+                id, type, title: (0, templates_1.generateNarrativeTitle)(biome),
+                text: (0, templates_1.generateNarrativeText)(biome), buddyLine,
+                // choices wired later
+            };
+        case "combat": {
+            const enemyId = pickScaledEnemy(biome, difficulty);
+            const enemy = enemies_1.ENEMIES[enemyId];
+            return {
+                id, type, title: (0, templates_1.generateCombatTitle)(biome),
+                text: (0, templates_1.generateCombatText)(biome, enemy?.name ?? "creature"), buddyLine,
+                enemyId,
+            };
+        }
+        case "boss": {
+            const bossId = pickBoss(biome);
+            const boss = enemies_1.ENEMIES[bossId];
+            return {
+                id, type, title: `${boss?.name ?? "Boss"}'s Lair`,
+                text: (0, templates_1.generateBossText)(biome, boss?.name ?? "The Boss"), buddyLine: "Here it comes... STAY STRONG!",
+                enemyId: bossId,
+            };
+        }
+        case "treasure": {
+            const tier = getLootTier(difficulty);
+            return {
+                id, type, title: "Hidden Stash",
+                text: (0, templates_1.generateTreasureText)(biome), buddyLine,
+                lootPool: biome.loot[tier],
+            };
+        }
+        case "rest":
+            return {
+                id, type, title: "Safe Haven",
+                text: (0, templates_1.generateRestText)(biome), buddyLine: "Can we rest here? Just for a moment?",
+                healAmount: 15 + difficulty * 2,
+            };
+        case "event": {
+            const event = (0, templates_1.generateEvent)(biome);
+            return {
+                id, type, title: "Unexpected Encounter",
+                text: event.text, buddyLine,
+                eventChoices: event.choices.map((c) => ({
+                    label: c.label,
+                    outcome: c.outcome,
+                    effect: c.effect ? { itemGain: c.effect.itemGain, hp: c.effect.hp, happiness: c.effect.happiness } : undefined,
+                })),
+            };
+        }
+        default:
+            return { id, type: "narrative", title: "???", text: ["Something went wrong."], buddyLine: "Uh oh." };
+    }
+}
+//# sourceMappingURL=generator.js.map

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

@@ -0,0 +1,25 @@
+import { Biome } from "./biomes";
+export declare function generateNarrativeText(biome: Biome): string[];
+export declare function generateNarrativeTitle(biome: Biome): string;
+export declare function generateChoiceLabels(biome: Biome): string[];
+export declare function generateCombatText(biome: Biome, enemyName: string): string[];
+export declare function generateCombatTitle(biome: Biome): string;
+export declare function generateTreasureText(biome: Biome): string[];
+export declare function generateRestText(biome: Biome): string[];
+export interface EventTemplate {
+    text: string[];
+    choices: {
+        label: string;
+        outcome: string;
+        effect?: {
+            itemGain?: string;
+            hp?: number;
+            happiness?: number;
+        };
+    }[];
+}
+export declare function generateEvent(biome: Biome): EventTemplate;
+export declare function generateBuddyLine(speciesId: string, biome: Biome): string;
+export declare function generateBossText(biome: Biome, bossName: string): string[];
+export declare function generateHiddenRoomText(biome: Biome, speciesId: string): string[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/adventure/generation/templates.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateNarrativeText = generateNarrativeText;
+exports.generateNarrativeTitle = generateNarrativeTitle;
+exports.generateChoiceLabels = generateChoiceLabels;
+exports.generateCombatText = generateCombatText;
+exports.generateCombatTitle = generateCombatTitle;
+exports.generateTreasureText = generateTreasureText;
+exports.generateRestText = generateRestText;
+exports.generateEvent = generateEvent;
+exports.generateBuddyLine = generateBuddyLine;
+exports.generateBossText = generateBossText;
+exports.generateHiddenRoomText = generateHiddenRoomText;
+function pick(arr) {
+    return arr[Math.floor(Math.random() * arr.length)];
+}
+// ─── Narrative Room Templates ────────────────────────────────
+function generateNarrativeText(biome) {
+    const templates = [
+        [`The ${pick(biome.adjectives)} ${pick(biome.nouns)} stretches before you.`, `Two paths diverge ahead — ${pick(biome.directions)} and ${pick(biome.directions)}.`],
+        [`You reach a ${pick(biome.landmarks)}. The air feels ${pick(biome.adjectives)}.`, `Something rustles in ${pick(biome.hidingSpots)}.`],
+        [`The path narrows as you enter a ${pick(biome.adjectives)} ${pick(biome.nouns)}.`, `You can go ${pick(biome.directions)} or ${pick(biome.directions)}.`],
+        [`A ${pick(biome.landmarks)} marks a crossroads.`, `The ${pick(biome.nouns)} feels ${pick(biome.adjectives)} here.`],
+        [`Your footsteps echo in the ${pick(biome.adjectives)} ${pick(biome.nouns)}.`, `Ahead, the path splits around a ${pick(biome.landmarks)}.`],
+        [`The ${pick(biome.nouns)} opens up to reveal a ${pick(biome.landmarks)}.`, `The air is ${pick(biome.adjectives)}. Which way?`],
+        [`Deeper into the ${pick(biome.nouns)}, you hear sounds from ${pick(biome.hidingSpots)}.`, `The path branches — ${pick(biome.directions)} looks safe, ${pick(biome.directions)} looks... interesting.`],
+        [`You stand at the edge of a ${pick(biome.adjectives)} ${pick(biome.nouns)}.`, `A ${pick(biome.landmarks)} marks two possible routes.`],
+        [`Shadows dance across a ${pick(biome.landmarks)}.`, `The ${pick(biome.nouns)} seems to whisper. Two paths await.`],
+    ];
+    return pick(templates);
+}
+function generateNarrativeTitle(biome) {
+    const titles = [
+        `The ${capitalize(pick(biome.adjectives))} ${capitalize(pick(biome.nouns))}`,
+        `${capitalize(pick(biome.landmarks))}`,
+        `A Fork in the ${capitalize(pick(biome.nouns))}`,
+        `The ${capitalize(pick(biome.adjectives))} Path`,
+    ];
+    return pick(titles);
+}
+function generateChoiceLabels(biome) {
+    return [
+        `Go ${pick(biome.directions)}`,
+        `Head ${pick(biome.directions)}`,
+    ];
+}
+// ─── Combat Room Templates ───────────────────────────────────
+function generateCombatText(biome, enemyName) {
+    const templates = [
+        [`A ${enemyName} leaps out from ${pick(biome.hidingSpots)}!`],
+        [`You stumble into a ${pick(biome.adjectives)} clearing. A ${enemyName} blocks the way!`],
+        [`Something moves in ${pick(biome.hidingSpots)}... it's a ${enemyName}!`],
+        [`The ${pick(biome.nouns)} grows ${pick(biome.adjectives)}. A ${enemyName} appears!`],
+    ];
+    return pick(templates);
+}
+function generateCombatTitle(biome) {
+    return `${capitalize(pick(biome.adjectives))} Encounter`;
+}
+// ─── Treasure Room Templates ─────────────────────────────────
+function generateTreasureText(biome) {
+    const templates = [
+        [`Behind a ${pick(biome.landmarks)}, something glints...`],
+        [`Your buddy digs near ${pick(biome.hidingSpots)} and finds something!`],
+        [`Hidden in the ${pick(biome.adjectives)} ${pick(biome.nouns)}, a stash awaits!`],
+        [`A ${pick(biome.landmarks)} conceals a small cache of treasure.`],
+    ];
+    return pick(templates);
+}
+// ─── Rest Room Templates ─────────────────────────────────────
+function generateRestText(biome) {
+    const templates = [
+        [`A peaceful spot near a ${pick(biome.landmarks)}. The ${pick(biome.nouns)} is quiet here.`],
+        [`A sheltered ${pick(biome.nouns)} offers respite. You could rest here...`],
+        [`The ${pick(biome.adjectives)} atmosphere fades. This feels safe.`],
+    ];
+    return pick(templates);
+}
+function generateEvent(biome) {
+    const events = [
+        {
+            text: [`A small creature peeks out from ${pick(biome.hidingSpots)}.`, `It seems to want to trade...`],
+            choices: [
+                { label: "Offer a Berry", outcome: "It hands you something shiny in return!", effect: { itemGain: pick(biome.loot.uncommon) } },
+                { label: "Wave and move on", outcome: "The creature waves goodbye." },
+            ],
+        },
+        {
+            text: [`You find a strange ${pick(biome.adjectives)} chest near a ${pick(biome.landmarks)}.`, `It could be a trap... or treasure.`],
+            choices: [
+                { label: "Open it carefully", outcome: "Inside — a useful item!", effect: { itemGain: pick(biome.loot.rare) } },
+                { label: "Leave it alone", outcome: "Better safe than sorry. You move on." },
+                { label: "Kick it open", outcome: "A puff of gas! You feel woozy.", effect: { hp: -10 } },
+            ],
+        },
+        {
+            text: [`A warm glow emanates from a ${pick(biome.landmarks)}.`, `It feels... magical.`],
+            choices: [
+                { label: "Touch the glow", outcome: "A warm feeling washes over you!", effect: { hp: 15, happiness: 5 } },
+                { label: "Back away cautiously", outcome: "The glow fades. Nothing happens." },
+            ],
+        },
+        {
+            text: [`A weary traveler rests by the path.`, `"Care to share some food? I'll make it worth your while."`],
+            choices: [
+                { label: "Share some food", outcome: "\"Thank you! Take this.\"", effect: { itemGain: pick(biome.loot.uncommon) } },
+                { label: "Apologize and decline", outcome: "The traveler nods and rests." },
+            ],
+        },
+        {
+            text: [`A wise-looking creature sits near a ${pick(biome.landmarks)}.`, `"Answer my riddle and I'll reward you!"`],
+            choices: [
+                { label: "Accept the riddle", outcome: "You answer wisely! A reward appears.", effect: { itemGain: pick(biome.loot.rare) } },
+                { label: "Politely refuse", outcome: "The creature nods knowingly." },
+            ],
+        },
+        {
+            text: [`A small animal is trapped under a ${pick(biome.adjectives)} rock near ${pick(biome.hidingSpots)}.`, `It whimpers for help...`],
+            choices: [
+                { label: "Help free it", outcome: "It scurries free! It drops something as thanks.", effect: { itemGain: pick(biome.loot.uncommon), happiness: 5 } },
+                { label: "It might be a trap...", outcome: "You move on cautiously." },
+            ],
+        },
+        {
+            text: [`A glowing rune is etched into a ${pick(biome.landmarks)}.`, `It pulses with ${pick(biome.adjectives)} energy.`],
+            choices: [
+                { label: "Touch the rune", outcome: "Power surges through you!", effect: { hp: 20 } },
+                { label: "Study it from afar", outcome: "You learn something, but feel nothing change." },
+                { label: "Smash it", outcome: "The rune explodes! Ow!", effect: { hp: -15 } },
+            ],
+        },
+        {
+            text: [`Someone left a campfire burning near ${pick(biome.hidingSpots)}.`, `There's a pack nearby...`],
+            choices: [
+                { label: "Warm up and rest", outcome: "The warmth is soothing.", effect: { hp: 10, happiness: 5 } },
+                { label: "Search the pack", outcome: "You find something useful!", effect: { itemGain: pick(biome.loot.uncommon) } },
+                { label: "Leave it — not yours", outcome: "You move on with a clear conscience." },
+            ],
+        },
+    ];
+    return pick(events);
+}
+// ─── Buddy Dialogue Templates ────────────────────────────────
+const SPECIES_ADVENTURE_LINES = {
+    rabbit: [
+        "My ears are twitching... something's nearby!", "I can hop right over this!",
+        "This place smells like carrots... no wait, danger.", "Want me to scout ahead? I'm fast!",
+        "*nose wiggles* I sense trouble...", "I could dig us an escape route!",
+        "My lucky foot says... this way!",
+    ],
+    cat: [
+        "I sense prey ahead.", "*sniffs the air* Interesting...", "I'll lead. Stay behind me.",
+        "*tail flicks* Something moved.", "I've hunted worse than this.",
+        "Do NOT touch me right now. I'm focused.", "This reminds me of my afternoon prowl.",
+    ],
+    frog: [
+        "Ribbit! I mean... let's go!", "The moisture here is nice.", "*tongue flick* Just checking.",
+        "I can sense vibrations... something big!", "Hop hop hop! Keep up!",
+        "If it gets wet, that's MY territory.", "My skin is tingling... that's either danger or humidity.",
+    ],
+    owl: [
+        "I can see far ahead from here.", "Hoo goes there?", "Knowledge awaits in every corner.",
+        "I've read about places like this...", "*head rotates* Scanning for threats.",
+        "Logically, the left path is safer.", "My wisdom says proceed with caution.",
+    ],
+    fox: [
+        "I smell adventure!", "My instincts say... this way!", "Stay sharp, I'll sniff out danger.",
+        "There's a shortcut here, I can feel it!", "Trust the nose!",
+        "*tail swish* I've got a plan.", "Foxes always find the best paths.",
+    ],
+    phoenix: [
+        "My flames light the way!", "*feathers glow* I feel strong here.", "Even if we fall, we rise again!",
+        "The fire within me burns brighter here!", "Nothing can stop eternal flame!",
+        "I sense ancient power nearby...", "*sparks fly from wings* Let's GO!",
+    ],
+    dragon: [
+        "I smell treasure nearby!", "*tiny roar* I'm not scared!", "My scales will protect us!",
+        "Is that gold? I think I smell gold!", "*puffs smoke confidently*",
+        "I'm basically a fortress. With legs.", "Anything that glows is mine. That's the rule.",
+    ],
+};
+const GENERIC_BUDDY_LINES = [
+    "Which way should we go?",
+    "This looks interesting...",
+    "Stay close!",
+    "I've got a good feeling about this!",
+    "Let's be careful here...",
+    "Ooh, what's over there?",
+    "I wonder what we'll find!",
+    "This is exciting!",
+    "I trust your instincts!",
+    "Lead the way, I've got your back!",
+    "Something tells me this will be worth it.",
+];
+function generateBuddyLine(speciesId, biome) {
+    // 50% species-specific, 50% generic
+    if (Math.random() < 0.5) {
+        const speciesLines = SPECIES_ADVENTURE_LINES[speciesId];
+        if (speciesLines)
+            return pick(speciesLines);
+    }
+    // Comfort bonus line
+    if (biome.comfortSpecies.includes(speciesId) && Math.random() < 0.3) {
+        return "I feel right at home here!";
+    }
+    return pick(GENERIC_BUDDY_LINES);
+}
+// ─── Boss Room Templates ─────────────────────────────────────
+function generateBossText(biome, bossName) {
+    const templates = [
+        [`The ${pick(biome.nouns)} trembles. Something massive approaches...`, `${bossName} emerges!`],
+        [`A deafening sound echoes through the ${pick(biome.nouns)}.`, `${bossName} blocks your path — there's no going back!`],
+        [`The air grows heavy. ${bossName} rises from ${pick(biome.hidingSpots)}!`],
+    ];
+    return pick(templates);
+}
+// ─── Hidden Room Templates ───────────────────────────────────
+function generateHiddenRoomText(biome, speciesId) {
+    const speciesName = speciesId.charAt(0).toUpperCase() + speciesId.slice(1);
+    return [
+        `Your ${speciesName} senses notice something others would miss...`,
+        `A hidden passage reveals itself in the ${pick(biome.adjectives)} ${pick(biome.nouns)}!`,
+    ];
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=templates.js.map

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