clibuddy 1.0.0

package/dist/adventure/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("./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/skills.d.ts

@@ -0,0 +1,6 @@
+import { SkillDef } from "./types";
+export declare const SKILLS: SkillDef[];
+/** Get skills available to a species at a given level */
+export declare function getAvailableSkills(speciesId: string, level: number): SkillDef[];
+export declare function getSkill(id: string): SkillDef | undefined;
+//# sourceMappingURL=skills.d.ts.map

package/dist/adventure/skills.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILLS = void 0;
+exports.getAvailableSkills = getAvailableSkills;
+exports.getSkill = getSkill;
+exports.SKILLS = [
+    // ─── Universal ─────────────────────────────────────────────
+    {
+        id: "focus", name: "Focus", description: "+50% ATK next turn",
+        speciesId: "all", levelRequired: 1, energyCost: 1,
+        effect: { type: "buff", stat: "atk", amount: 0.5, turns: 1 },
+        useLine: "concentrates deeply...",
+    },
+    // ─── Rabbit ────────────────────────────────────────────────
+    {
+        id: "quick_hop", name: "Quick Hop", description: "+30% dodge for 2 turns",
+        speciesId: "rabbit", levelRequired: 3, energyCost: 1,
+        effect: { type: "buff", stat: "dodge", amount: 0.3, turns: 2 },
+        useLine: "hops around frantically!",
+    },
+    {
+        id: "burrow", name: "Burrow", description: "Enemy skips next turn",
+        speciesId: "rabbit", levelRequired: 6, energyCost: 2,
+        effect: { type: "skip_enemy_turn" },
+        useLine: "digs underground and vanishes!",
+    },
+    {
+        id: "natures_blessing", name: "Nature's Blessing", description: "Regen 5 HP/turn for 3 turns",
+        speciesId: "rabbit", levelRequired: 10, energyCost: 2, element: "nature",
+        effect: { type: "buff", stat: "def", amount: 0, turns: 3 }, // handled specially by ID in combat.ts
+        useLine: "channels the power of nature!",
+    },
+    {
+        id: "earthquake", name: "Earthquake", description: "1.5x Nature dmg + stun",
+        speciesId: "rabbit", levelRequired: 15, energyCost: 3, element: "nature",
+        effect: { type: "damage", multiplier: 1.5 },
+        useLine: "stomps the ground with tremendous force!",
+    },
+    // ─── Cat ───────────────────────────────────────────────────
+    {
+        id: "pounce", name: "Pounce", description: "1.5x damage",
+        speciesId: "cat", levelRequired: 3, energyCost: 1,
+        effect: { type: "damage", multiplier: 1.5 },
+        useLine: "leaps through the air!",
+    },
+    {
+        id: "shadow_step", name: "Shadow Step", description: "+40% dodge 3 turns + next crit",
+        speciesId: "cat", levelRequired: 6, energyCost: 2, element: "shadow",
+        effect: { type: "buff", stat: "dodge", amount: 0.4, turns: 3 },
+        useLine: "melts into the shadows!",
+    },
+    {
+        id: "nine_lives", name: "Nine Lives", description: "Survive one KO with 1 HP",
+        speciesId: "cat", levelRequired: 10, energyCost: 3,
+        effect: { type: "revive", hpPercent: 0.01 },
+        useLine: "'s eyes flash — not done yet!",
+    },
+    {
+        id: "shadow_strike", name: "Shadow Strike", description: "2x Shadow dmg + charm 1t",
+        speciesId: "cat", levelRequired: 15, energyCost: 3, element: "shadow",
+        effect: { type: "damage", multiplier: 2.0 },
+        useLine: "strikes from the darkness!",
+    },
+    // ─── Frog ──────────────────────────────────────────────────
+    {
+        id: "tongue_lash", name: "Tongue Lash", description: "1.3x, ignores DEF",
+        speciesId: "frog", levelRequired: 3, energyCost: 1,
+        effect: { type: "damage", multiplier: 1.3, ignoreDefense: true },
+        useLine: "'s tongue snaps out!",
+    },
+    {
+        id: "toxic_splash", name: "Toxic Splash", description: "Poison: 4 dmg/turn for 3 turns",
+        speciesId: "frog", levelRequired: 6, energyCost: 2, element: "nature",
+        effect: { type: "poison", damagePerTurn: 4, turns: 3 },
+        useLine: "sprays a toxic mist!",
+    },
+    {
+        id: "aqua_shield", name: "Aqua Shield", description: "Shield absorbs 20 damage",
+        speciesId: "frog", levelRequired: 10, energyCost: 2, element: "water",
+        effect: { type: "buff", stat: "def", amount: 0, turns: 1 }, // handled specially
+        useLine: "conjures a water barrier!",
+    },
+    {
+        id: "tidal_wave", name: "Tidal Wave", description: "2x Water dmg + freeze 1t",
+        speciesId: "frog", levelRequired: 15, energyCost: 3, element: "water",
+        effect: { type: "damage", multiplier: 2.0 },
+        useLine: "summons a massive wave!",
+    },
+    // ─── Owl ───────────────────────────────────────────────────
+    {
+        id: "keen_eye", name: "Keen Eye", description: "+25% crit for 3 turns",
+        speciesId: "owl", levelRequired: 3, energyCost: 1,
+        effect: { type: "buff", stat: "crit", amount: 0.25, turns: 3 },
+        useLine: "'s eyes narrow with focus...",
+    },
+    {
+        id: "screech", name: "Screech", description: "-30% enemy ATK for 3 turns",
+        speciesId: "owl", levelRequired: 6, energyCost: 2,
+        effect: { type: "debuff", stat: "atk", amount: 0.3, turns: 3 },
+        useLine: "lets out a piercing screech!",
+    },
+    {
+        id: "illuminate", name: "Illuminate", description: "Blind enemy for 2 turns",
+        speciesId: "owl", levelRequired: 10, energyCost: 2, element: "light",
+        effect: { type: "stun", turns: 0 }, // handled specially — applies blind condition
+        useLine: "emits a blinding flash!",
+    },
+    {
+        id: "piercing_gaze", name: "Piercing Gaze", description: "2.5x Light dmg + -50% DEF 2t",
+        speciesId: "owl", levelRequired: 15, energyCost: 4, element: "light",
+        effect: { type: "damage", multiplier: 2.5 },
+        useLine: "focuses an intense beam of light!",
+    },
+    // ─── Fox ───────────────────────────────────────────────────
+    {
+        id: "trick", name: "Trick", description: "Stun enemy 1 turn",
+        speciesId: "fox", levelRequired: 3, energyCost: 1,
+        effect: { type: "stun", turns: 1 },
+        useLine: "pulls a clever feint!",
+    },
+    {
+        id: "cunning_strike", name: "Cunning Strike", description: "2x dmg if HP > 50%",
+        speciesId: "fox", levelRequired: 6, energyCost: 2,
+        effect: { type: "damage", multiplier: 2.0 },
+        useLine: "strikes with cunning precision!",
+    },
+    {
+        id: "shadow_cloak", name: "Shadow Cloak", description: "+50% dodge 2t, stealth",
+        speciesId: "fox", levelRequired: 10, energyCost: 2, element: "shadow",
+        effect: { type: "buff", stat: "dodge", amount: 0.5, turns: 2 },
+        useLine: "vanishes into thin air!",
+    },
+    {
+        id: "outfox", name: "Outfox", description: "2x Nature dmg + charm 1t",
+        speciesId: "fox", levelRequired: 15, energyCost: 3, element: "nature",
+        effect: { type: "damage", multiplier: 2.0 },
+        useLine: "outwits the enemy completely!",
+    },
+    // ─── Phoenix ───────────────────────────────────────────────
+    {
+        id: "flame_burst", name: "Flame Burst", description: "1.6x Fire damage",
+        speciesId: "phoenix", levelRequired: 3, energyCost: 1, element: "fire",
+        effect: { type: "damage", multiplier: 1.6 },
+        useLine: "erupts in flames!",
+    },
+    {
+        id: "inferno", name: "Inferno", description: "1.4x Fire + burn 5/t 3t",
+        speciesId: "phoenix", levelRequired: 6, energyCost: 2, element: "fire",
+        effect: { type: "damage", multiplier: 1.4 },
+        useLine: "unleashes a raging inferno!",
+    },
+    {
+        id: "rebirth", name: "Rebirth", description: "Revive with 30% HP once",
+        speciesId: "phoenix", levelRequired: 10, energyCost: 3,
+        effect: { type: "revive", hpPercent: 0.3 },
+        useLine: "bursts into ashes... and rises reborn!",
+    },
+    {
+        id: "supernova", name: "Supernova", description: "2.5x Fire + burn all",
+        speciesId: "phoenix", levelRequired: 15, energyCost: 4, element: "fire",
+        effect: { type: "damage", multiplier: 2.5 },
+        useLine: "explodes in a blinding supernova!",
+    },
+    // ─── Dragon ────────────────────────────────────────────────
+    {
+        id: "fire_breath", name: "Fire Breath", description: "1.8x Fire damage",
+        speciesId: "dragon", levelRequired: 3, energyCost: 1, element: "fire",
+        effect: { type: "damage", multiplier: 1.8 },
+        useLine: "unleashes a stream of fire!",
+    },
+    {
+        id: "scale_shield", name: "Scale Shield", description: "+50% DEF for 3 turns",
+        speciesId: "dragon", levelRequired: 6, energyCost: 2,
+        effect: { type: "buff", stat: "def", amount: 0.5, turns: 3 },
+        useLine: "'s scales harden and gleam!",
+    },
+    {
+        id: "dragons_roar", name: "Dragon's Roar", description: "-40% enemy ATK 2 turns",
+        speciesId: "dragon", levelRequired: 10, energyCost: 2,
+        effect: { type: "debuff", stat: "atk", amount: 0.4, turns: 2 },
+        useLine: "lets out an earth-shaking roar!",
+    },
+    {
+        id: "apocalypse", name: "Apocalypse", description: "3x Fire dmg (devastating)",
+        speciesId: "dragon", levelRequired: 15, energyCost: 4, element: "fire",
+        effect: { type: "damage", multiplier: 3.0 },
+        useLine: "rains fire from above!",
+    },
+];
+/** Get skills available to a species at a given level */
+function getAvailableSkills(speciesId, level) {
+    return exports.SKILLS.filter((s) => (s.speciesId === speciesId || s.speciesId === "all") && level >= s.levelRequired);
+}
+function getSkill(id) {
+    return exports.SKILLS.find((s) => s.id === id);
+}
+//# sourceMappingURL=skills.js.map

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