clibuddy 1.0.0

package/dist/story/npcs.d.ts

@@ -0,0 +1,17 @@
+export interface NPC {
+    id: string;
+    name: string;
+    title: string;
+    art: string[];
+    /** Dialogue pools keyed by story flag milestones (checked in order, first match wins) */
+    dialogueByFlag: {
+        flag: string;
+        lines: string[];
+    }[];
+    defaultDialogue: string[];
+}
+export declare const NPCS: Record<string, NPC>;
+/** Get NPC dialogue based on current story flags */
+export declare function getNPCDialogue(npcId: string, storyFlags: string[]): string;
+export declare function getNPC(id: string): NPC | undefined;
+//# sourceMappingURL=npcs.d.ts.map

package/dist/story/npcs.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NPCS = void 0;
+exports.getNPCDialogue = getNPCDialogue;
+exports.getNPC = getNPC;
+exports.NPCS = {
+    pip: {
+        id: "pip",
+        name: "Pip",
+        title: "Merchant Mouse",
+        art: ["  (\\./) ", " (o.o) ", "  (\")(\")"],
+        dialogueByFlag: [
+            { flag: "ch8_complete", lines: [
+                    "We did it! The world is safe! ...Can I interest you in some celebratory snacks?",
+                    "I never thought a mouse like me would help save the world!",
+                    "Business is booming now that the roads are safe again!",
+                ] },
+            { flag: "ch4_complete", lines: [
+                    "That swamp was TERRIFYING. But I'd do it again. ...From a distance.",
+                    "I've been collecting some rare goods from grateful travelers!",
+                    "The Stones... someone really broke them on purpose? That's scary.",
+                ] },
+            { flag: "ch1_complete", lines: [
+                    "Oh, you're back! I've set up a little shop — take a look!",
+                    "The forest feels calmer now. Thank you for fixing the Stone!",
+                    "I found some interesting things on the road. Want to trade?",
+                    "P-please be careful out there. I worry, you know?",
+                ] },
+        ],
+        defaultDialogue: [
+            "P-please don't eat me! I'm just a merchant!",
+            "I sell things! Good things! Useful things!",
+            "The forest has been acting strange lately...",
+        ],
+    },
+    shelly: {
+        id: "shelly",
+        name: "Elder Shelly",
+        title: "Wise Tortoise",
+        art: ["  .---. ", " / o o \\", " \\_____/", "  /| |\\"],
+        dialogueByFlag: [
+            { flag: "ch8_complete", lines: [
+                    "The Harmony is restored. I've waited centuries for this day.",
+                    "You remind me of the first guardians. Perhaps even braver.",
+                    "Rest now, little one. You've earned it.",
+                ] },
+            { flag: "ch5_complete", lines: [
+                    "No more riddles. This is war. The Shadow Beast is real.",
+                    "The Stranger... I should have seen it. I should have known.",
+                    "The ruins hold the truth. Everything we need is written in stone.",
+                ] },
+            { flag: "ch2_complete", lines: [
+                    "The caves sing again! You have a gift, young one.",
+                    "There are six Stones in total. Each in a different realm.",
+                    "I sense you have questions. Patience — the answers will come.",
+                    "Would you like to hear an old story? I have many.",
+                ] },
+        ],
+        defaultDialogue: [
+            "Hmm? A visitor? It's been... decades.",
+            "All things return to the source, in time.",
+            "These crystals are weeping. Can you hear them?",
+        ],
+    },
+    blaze: {
+        id: "blaze",
+        name: "Blaze",
+        title: "Rival Phoenix",
+        art: ["  )\\*/( ", " (^><^) ", " \\=/\\=/"],
+        dialogueByFlag: [
+            { flag: "ch8_complete", lines: [
+                    "We... actually did it. Don't let it go to your head.",
+                    "I guess having friends isn't the WORST thing.",
+                    "Next time there's a world-ending crisis, call me first. I was bored.",
+                ] },
+            { flag: "ch6_complete", lines: [
+                    "Alright, I'll admit it. You're not terrible at this.",
+                    "The Shadow Beast is real. I've felt its presence. We fight together.",
+                    "Let's finish this. Together. ...Don't make it weird.",
+                ] },
+            { flag: "ch3_complete", lines: [
+                    "You beat me. ONCE. Don't get used to it.",
+                    "Maybe you're not totally useless. MAYBE.",
+                    "I'm still hunting the Stones. Stay out of my way. ...Unless you need help.",
+                ] },
+        ],
+        defaultDialogue: [
+            "You? Save the world? Please.",
+            "The Stones belong to the strong. That's ME.",
+            "Out of my way, small fry.",
+        ],
+    },
+    stranger: {
+        id: "stranger",
+        name: "???",
+        title: "The Stranger",
+        art: ["  /?\\ ", " {. .} ", "  \\?/"],
+        dialogueByFlag: [
+            { flag: "ch8_complete", lines: [
+                    "Thank you... for remembering who I was.",
+                    "The Harmony Stones shine again. I can finally rest.",
+                    "Watch over this world. It's more fragile than it looks.",
+                ] },
+            { flag: "ch7_complete", lines: [
+                    "You freed me. I didn't think it was possible.",
+                    "I was the first guardian. The Beast consumed me from within.",
+                    "I tried to warn you... I tried to protect you by pushing you away.",
+                ] },
+            { flag: "ch5_complete", lines: [
+                    "Turn back. You don't understand what you're awakening.",
+                    "The Stones were a seal. Breaking them was necessary... and terrible.",
+                    "...you remind me of someone I used to be.",
+                ] },
+        ],
+        defaultDialogue: [
+            "...",
+            "Turn back.",
+        ],
+    },
+};
+/** Get NPC dialogue based on current story flags */
+function getNPCDialogue(npcId, storyFlags) {
+    const npc = exports.NPCS[npcId];
+    if (!npc)
+        return "...";
+    // Check flags in order — first match wins (most progressed flag first)
+    for (const pool of npc.dialogueByFlag) {
+        if (storyFlags.includes(pool.flag)) {
+            return pool.lines[Math.floor(Math.random() * pool.lines.length)];
+        }
+    }
+    return npc.defaultDialogue[Math.floor(Math.random() * npc.defaultDialogue.length)];
+}
+function getNPC(id) {
+    return exports.NPCS[id];
+}
+//# sourceMappingURL=npcs.js.map

package/dist/story/progress.d.ts

@@ -0,0 +1,26 @@
+import { BuddyState } from "../buddy/types";
+import { QuestChapter, QuestChain, QuestProgress, SavedAdventureState } from "./types";
+import { AdventureState } from "../adventure/types";
+/** Complete a chapter: add to completed list, set story flag, award rewards */
+export declare function completeChapter(state: BuddyState, chapter: QuestChapter): BuddyState;
+/** Set active quest */
+export declare function setActiveQuest(state: BuddyState, chainId: string, chapterId: string): BuddyState;
+/** Add a lore fragment */
+export declare function addLoreFragment(state: BuddyState, fragmentId: string): BuddyState;
+/** Add gold */
+export declare function addGold(state: BuddyState, amount: number): BuddyState;
+/** Spend gold (returns null if insufficient) */
+export declare function spendGold(state: BuddyState, amount: number): BuddyState | null;
+/** Get the next available chapter in a chain */
+export declare function getNextChapter(chain: QuestChain, progress: QuestProgress): QuestChapter | null;
+/** Get chain completion percentage */
+export declare function getChainProgress(chain: QuestChain, progress: QuestProgress): number;
+/** Save mid-adventure progress for quest resumption */
+export declare function saveQuestAdventure(state: BuddyState, adventure: AdventureState): BuddyState;
+/** Clear saved adventure state */
+export declare function clearSavedAdventure(state: BuddyState): BuddyState;
+/** Check if there's a saved adventure to resume */
+export declare function hasSavedAdventure(state: BuddyState): boolean;
+/** Restore AdventureState from saved data */
+export declare function restoreAdventureState(saved: SavedAdventureState): AdventureState;
+//# sourceMappingURL=progress.d.ts.map

package/dist/story/progress.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completeChapter = completeChapter;
+exports.setActiveQuest = setActiveQuest;
+exports.addLoreFragment = addLoreFragment;
+exports.addGold = addGold;
+exports.spendGold = spendGold;
+exports.getNextChapter = getNextChapter;
+exports.getChainProgress = getChainProgress;
+exports.saveQuestAdventure = saveQuestAdventure;
+exports.clearSavedAdventure = clearSavedAdventure;
+exports.hasSavedAdventure = hasSavedAdventure;
+exports.restoreAdventureState = restoreAdventureState;
+/** Complete a chapter: add to completed list, set story flag, award rewards */
+function completeChapter(state, chapter) {
+    const progress = { ...state.questProgress };
+    // Add to completed
+    if (!progress.completedChapters.includes(chapter.id)) {
+        progress.completedChapters = [...progress.completedChapters, chapter.id];
+    }
+    // Set story flag
+    if (chapter.storyFlag && !progress.storyFlags.includes(chapter.storyFlag)) {
+        progress.storyFlags = [...progress.storyFlags, chapter.storyFlag];
+    }
+    // Clear active quest if this was it
+    if (progress.activeChapter === chapter.id) {
+        progress.activeChapter = undefined;
+        progress.activeChain = undefined;
+    }
+    // Award gold
+    progress.gold += chapter.rewards.gold;
+    // Award XP
+    let xp = state.xp + chapter.rewards.xp;
+    // Award items
+    let inventory = state.inventory;
+    if (chapter.rewards.items) {
+        for (const itemId of chapter.rewards.items) {
+            const existing = inventory.find((s) => s.itemId === itemId);
+            if (!existing) {
+                inventory = [...inventory, { itemId, count: 1 }];
+            }
+        }
+    }
+    // Award title
+    let titles = state.titles;
+    if (chapter.rewards.titleId && !titles.includes(chapter.rewards.titleId)) {
+        titles = [...titles, chapter.rewards.titleId];
+    }
+    return {
+        ...state,
+        questProgress: progress,
+        xp,
+        inventory,
+        titles,
+    };
+}
+/** Set active quest */
+function setActiveQuest(state, chainId, chapterId) {
+    return {
+        ...state,
+        questProgress: {
+            ...state.questProgress,
+            activeChain: chainId,
+            activeChapter: chapterId,
+        },
+    };
+}
+/** Add a lore fragment */
+function addLoreFragment(state, fragmentId) {
+    if (state.questProgress.loreFragments.includes(fragmentId))
+        return state;
+    return {
+        ...state,
+        questProgress: {
+            ...state.questProgress,
+            loreFragments: [...state.questProgress.loreFragments, fragmentId],
+        },
+    };
+}
+/** Add gold */
+function addGold(state, amount) {
+    return {
+        ...state,
+        questProgress: {
+            ...state.questProgress,
+            gold: state.questProgress.gold + amount,
+        },
+    };
+}
+/** Spend gold (returns null if insufficient) */
+function spendGold(state, amount) {
+    if (state.questProgress.gold < amount)
+        return null;
+    return {
+        ...state,
+        questProgress: {
+            ...state.questProgress,
+            gold: state.questProgress.gold - amount,
+        },
+    };
+}
+/** Get the next available chapter in a chain */
+function getNextChapter(chain, progress) {
+    for (const chapter of chain.chapters) {
+        if (!progress.completedChapters.includes(chapter.id)) {
+            // Check prerequisites
+            const allPrereqsMet = chapter.prerequisites.every((p) => progress.completedChapters.includes(p));
+            if (allPrereqsMet)
+                return chapter;
+        }
+    }
+    return null;
+}
+/** Get chain completion percentage */
+function getChainProgress(chain, progress) {
+    const completed = chain.chapters.filter((c) => progress.completedChapters.includes(c.id)).length;
+    return Math.round((completed / chain.chapters.length) * 100);
+}
+/** Save mid-adventure progress for quest resumption */
+function saveQuestAdventure(state, adventure) {
+    const saved = {
+        adventureId: adventure.adventureId,
+        currentRoomId: adventure.currentRoomId,
+        roomsVisited: adventure.roomsVisited,
+        morale: adventure.morale,
+        lootCollected: adventure.lootCollected,
+        xpEarned: adventure.xpEarned,
+        battlesWon: adventure.battlesWon,
+        battlesFled: adventure.battlesFled,
+        damageTaken: adventure.damageTaken,
+    };
+    return {
+        ...state,
+        questProgress: { ...state.questProgress, savedAdventure: saved },
+    };
+}
+/** Clear saved adventure state */
+function clearSavedAdventure(state) {
+    return {
+        ...state,
+        questProgress: { ...state.questProgress, savedAdventure: undefined },
+    };
+}
+/** Check if there's a saved adventure to resume */
+function hasSavedAdventure(state) {
+    return !!state.questProgress.savedAdventure;
+}
+/** Restore AdventureState from saved data */
+function restoreAdventureState(saved) {
+    return {
+        active: true,
+        adventureId: saved.adventureId,
+        currentRoomId: saved.currentRoomId,
+        roomsVisited: saved.roomsVisited,
+        phase: "room",
+        morale: saved.morale,
+        textPage: 0,
+        textFullyShown: false,
+        lootCollected: saved.lootCollected,
+        xpEarned: saved.xpEarned,
+        battlesWon: saved.battlesWon,
+        battlesLost: 0,
+        battlesFled: saved.battlesFled,
+        damageTaken: saved.damageTaken,
+        buddyReaction: "Right where we left off!",
+    };
+}
+//# sourceMappingURL=progress.js.map

package/dist/story/seasonal.d.ts

@@ -0,0 +1,6 @@
+import { QuestChain } from "./types";
+/** Winter Frost Festival — sample seasonal quest */
+export declare const WINTER_FROST: QuestChain;
+/** Get seasonal quests active right now */
+export declare function getSeasonalQuests(): QuestChain[];
+//# sourceMappingURL=seasonal.d.ts.map

package/dist/story/seasonal.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WINTER_FROST = void 0;
+exports.getSeasonalQuests = getSeasonalQuests;
+const types_1 = require("../adventure/types");
+function makeAdventure(def) {
+    return { ...def, roomMap: (0, types_1.buildRoomMap)(def.rooms) };
+}
+/** Winter Frost Festival — sample seasonal quest */
+exports.WINTER_FROST = {
+    id: "winter_frost",
+    name: "Winter Frost Festival",
+    description: "A magical winter celebration! Ice enemies, snow, and holiday cheer.",
+    type: "seasonal",
+    chapters: [
+        {
+            id: "winter_1", name: "Frozen Festivities",
+            description: "The Frost Festival has arrived! But something is freezing the decorations...",
+            prerequisites: [], levelRequired: 3,
+            storyFlag: "winter_1_complete",
+            rewards: { xp: 60, gold: 40, items: ["golden_apple"] },
+            acts: [{ id: "act1", name: "Festival", type: "dungeon", buildAdventure: () => makeAdventure({
+                        id: "winter_1", name: "Frozen Festivities",
+                        description: "The Frost Festival is under threat!", difficulty: "medium",
+                        levelRequired: 3, energyCost: 15, hungerCost: 10, completionXp: 60,
+                        startRoomId: "w1_start",
+                        rooms: [
+                            { id: "w1_start", type: "narrative", title: "The Festival Grounds",
+                                text: [
+                                    "Snowflakes drift gently over a festive clearing.",
+                                    "Lanterns, garlands, and a massive ice sculpture of a buddy!",
+                                    "But the decorations are frozen solid. The hot cocoa is ICE.",
+                                    "Something is making this winter TOO cold.",
+                                ],
+                                buddyLine: "Brrr! This isn't normal cold... something magical is happening!",
+                                choices: [
+                                    { label: "Follow the frost trail", nextRoomId: "w1_combat" },
+                                    { label: "Ask the festival-goers", nextRoomId: "w1_event" },
+                                ],
+                            },
+                            { id: "w1_event", type: "event", title: "Festival Stall",
+                                text: ["A shivering frog runs a hot cocoa stand.", "\"F-f-free cocoa if you stop this c-c-cold!\""],
+                                buddyLine: "Deal!",
+                                nextRoomId: "w1_combat",
+                                eventChoices: [
+                                    { label: "Take the cocoa", outcome: "The cocoa warms you from the inside! Delicious!", effect: { hp: 15, happiness: 10 } },
+                                    { label: "Save it for later", outcome: "\"Suit yourself!\" the frog says, teeth chattering." },
+                                ],
+                            },
+                            { id: "w1_combat", type: "combat", title: "Ice Path",
+                                text: ["The frost trail leads to a clearing. An ice-coated snail blocks the way!"],
+                                buddyLine: "Even the snails are frozen!", enemyId: "snail", nextRoomId: "w1_boss",
+                            },
+                            { id: "w1_boss", type: "boss", title: "The Frost Crystal",
+                                text: [
+                                    "A massive frost crystal pulses at the center of the clearing.",
+                                    "It's not alive — but the corrupted golem guarding it IS.",
+                                    "Defeat the guardian to shatter the frost crystal and save the festival!",
+                                ],
+                                buddyLine: "For hot cocoa! I mean — for the FESTIVAL!",
+                                enemyId: "golem",
+                            },
+                        ],
+                    }) }],
+        },
+    ],
+};
+const SEASONAL_WINDOWS = [
+    { chain: exports.WINTER_FROST, startMonth: 12, startDay: 15, endMonth: 1, endDay: 5 },
+    // Future: { chain: HALLOWEEN, startMonth: 10, startDay: 20, endMonth: 11, endDay: 5 },
+];
+function isDateInWindow(now, window) {
+    const month = now.getMonth() + 1; // 0-indexed → 1-indexed
+    const day = now.getDate();
+    // Handle windows that cross year boundary (Dec → Jan)
+    if (window.startMonth > window.endMonth) {
+        return (month > window.startMonth || (month === window.startMonth && day >= window.startDay)) ||
+            (month < window.endMonth || (month === window.endMonth && day <= window.endDay));
+    }
+    // Normal window within same year
+    if (month > window.startMonth && month < window.endMonth)
+        return true;
+    if (month === window.startMonth && day >= window.startDay)
+        return true;
+    if (month === window.endMonth && day <= window.endDay)
+        return true;
+    return false;
+}
+/** Get seasonal quests active right now */
+function getSeasonalQuests() {
+    const now = new Date();
+    return SEASONAL_WINDOWS
+        .filter((w) => isDateInWindow(now, w))
+        .map((w) => w.chain);
+}
+//# sourceMappingURL=seasonal.js.map

package/dist/story/shop.d.ts

@@ -0,0 +1,7 @@
+export interface ShopItem {
+    itemId: string;
+    price: number;
+}
+/** Pip's shop inventory — available after Ch1 */
+export declare const SHOP_ITEMS: ShopItem[];
+//# sourceMappingURL=shop.d.ts.map

package/dist/story/shop.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHOP_ITEMS = void 0;
+/** Pip's shop inventory — available after Ch1 */
+exports.SHOP_ITEMS = [
+    // Basic consumables
+    { itemId: "berry", price: 10 },
+    { itemId: "fish", price: 25 },
+    { itemId: "cake", price: 50 },
+    { itemId: "herb", price: 10 },
+    { itemId: "potion", price: 30 },
+    { itemId: "elixir", price: 60 },
+    { itemId: "stick", price: 10 },
+    { itemId: "ball", price: 25 },
+    // Premium consumables
+    { itemId: "golden_apple", price: 80 },
+    { itemId: "dragon_steak", price: 90 },
+    { itemId: "phoenix_tears", price: 100 },
+    // Basic gear
+    { itemId: "wooden_stick", price: 30 },
+    { itemId: "leaf_cloak", price: 30 },
+    { itemId: "leather_cap", price: 25 },
+    { itemId: "sandals", price: 20 },
+    { itemId: "lucky_charm", price: 40 },
+];
+//# sourceMappingURL=shop.js.map

package/dist/story/sideQuests.d.ts

@@ -0,0 +1,4 @@
+import { QuestChain } from "./types";
+/** Get all available side quest chains based on story progress */
+export declare function getSideQuestChains(completedChapters: string[]): QuestChain[];
+//# sourceMappingURL=sideQuests.d.ts.map

package/dist/story/sideQuests.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSideQuestChains = getSideQuestChains;
+const types_1 = require("../adventure/types");
+function makeAdventure(def) {
+    return { ...def, roomMap: (0, types_1.buildRoomMap)(def.rooms) };
+}
+// ─── Pip's Lost Shipment (unlocks after Ch1) ─────────────────
+const PIPS_SHIPMENT = {
+    id: "pips_shipment",
+    name: "Pip's Lost Shipment",
+    description: "Help Pip recover his stolen merchant goods from forest bandits.",
+    type: "side",
+    chapters: [
+        {
+            id: "pip_s1", name: "The Missing Cart",
+            description: "Pip's cart was stolen by mischievous squirrels. Track them down!",
+            prerequisites: ["ch1_whispers"], levelRequired: 2,
+            storyFlag: "pip_s1_complete",
+            rewards: { xp: 30, gold: 20, items: ["berry", "fish"] },
+            acts: [{ id: "act1", name: "Quest", type: "dungeon", buildAdventure: () => makeAdventure({
+                        id: "pip_s1", name: "The Missing Cart", description: "Find Pip's stolen goods.",
+                        difficulty: "easy", levelRequired: 2, energyCost: 10, hungerCost: 8, completionXp: 30,
+                        startRoomId: "ps1_start",
+                        rooms: [
+                            { id: "ps1_start", type: "narrative", title: "Pip's Plea",
+                                text: ["Pip wrings his tiny paws. \"They took EVERYTHING! My berries, my fish, my favorite cheese!\"", "Squirrel tracks lead deeper into the woods."],
+                                buddyLine: "Don't worry, Pip. We'll get your stuff back.",
+                                choices: [{ label: "Follow the tracks", nextRoomId: "ps1_combat" }],
+                            },
+                            { id: "ps1_combat", type: "combat", title: "Squirrel Bandits",
+                                text: ["Three squirrels chatter angrily around Pip's overturned cart!"],
+                                buddyLine: "Hey! Give that back!", enemyId: "squirrel", nextRoomId: "ps1_end",
+                            },
+                            { id: "ps1_end", type: "treasure", title: "Recovered Goods",
+                                text: ["Pip's cart is battered but intact. Most of the goods are still here!"],
+                                buddyLine: "Pip is going to be SO happy!", lootPool: ["berry", "fish", "herb", "cake"],
+                            },
+                        ],
+                    }) }],
+        },
+        {
+            id: "pip_s2", name: "Bandit Boss",
+            description: "The squirrel bandits have a leader. Deal with it for good.",
+            prerequisites: ["pip_s1"], levelRequired: 3,
+            storyFlag: "pip_s2_complete",
+            rewards: { xp: 50, gold: 35 },
+            acts: [{ id: "act1", name: "Quest", type: "dungeon", buildAdventure: () => makeAdventure({
+                        id: "pip_s2", name: "Bandit Boss", description: "Confront the bandit leader.",
+                        difficulty: "medium", levelRequired: 3, energyCost: 15, hungerCost: 10, completionXp: 50,
+                        startRoomId: "ps2_start",
+                        rooms: [
+                            { id: "ps2_start", type: "narrative", title: "Deeper Trail",
+                                text: ["The bandit squirrels aren't random — they have a hideout.", "Pip: \"They keep coming back! There must be a leader!\""],
+                                buddyLine: "Let's end this once and for all.",
+                                choices: [{ label: "Raid the hideout", nextRoomId: "ps2_combat" }],
+                            },
+                            { id: "ps2_combat", type: "combat", title: "The Bandit Den",
+                                text: ["A particularly large mushroom stands guard at the den entrance."],
+                                buddyLine: "That's one tough bouncer!", enemyId: "mushroom", nextRoomId: "ps2_boss",
+                            },
+                            { id: "ps2_boss", type: "combat", title: "Bandit King",
+                                text: ["The bandit leader — a storm wolf with a crown of stolen jewelry!"],
+                                buddyLine: "All that stolen loot... give it back!", enemyId: "stormwolf",
+                            },
+                        ],
+                    }) }],
+        },
+    ],
+};
+// ─── Shelly's Memories (unlocks after Ch2) ───────────────────
+const SHELLYS_MEMORIES = {
+    id: "shellys_memories",
+    name: "Shelly's Memories",
+    description: "Help Elder Shelly recover lost lore fragments from the deep caves.",
+    type: "side",
+    chapters: [
+        {
+            id: "shelly_s1", name: "Lost Tablets",
+            description: "Ancient stone tablets are scattered in the caves. Find them for Shelly.",
+            prerequisites: ["ch2_echoes"], levelRequired: 4,
+            storyFlag: "shelly_s1_complete",
+            rewards: { xp: 40, gold: 30 },
+            acts: [{ id: "act1", name: "Quest", type: "dungeon", buildAdventure: () => makeAdventure({
+                        id: "shelly_s1", name: "Lost Tablets", description: "Recover ancient lore.",
+                        difficulty: "medium", levelRequired: 4, energyCost: 15, hungerCost: 10, completionXp: 40,
+                        startRoomId: "ss1_start",
+                        rooms: [
+                            { id: "ss1_start", type: "narrative", title: "Shelly's Request",
+                                text: ["\"There are tablets deeper than even I can reach,\" Shelly says.", "\"They contain the history of the Stones' creation. Please find them.\""],
+                                buddyLine: "For knowledge! And for Shelly!",
+                                choices: [{ label: "Descend into the depths", nextRoomId: "ss1_combat" }],
+                            },
+                            { id: "ss1_combat", type: "combat", title: "Crystal Guardians",
+                                text: ["Automated crystal guardians still protect the old archives."],
+                                buddyLine: "They're ancient security systems!", enemyId: "golem", nextRoomId: "ss1_find",
+                            },
+                            { id: "ss1_find", type: "treasure", title: "The Lost Archive",
+                                text: ["Stone tablets covered in ancient writing. Shelly will be thrilled!"],
+                                buddyLine: "These must be thousands of years old...",
+                                lootPool: ["crystal_crown", "potion", "mana_crystal"],
+                            },
+                        ],
+                    }) }],
+        },
+    ],
+};
+// ─── Blaze's Challenge (unlocks after Ch3) ───────────────────
+const BLAZES_CHALLENGE = {
+    id: "blazes_challenge",
+    name: "Blaze's Challenge",
+    description: "Blaze keeps showing up for rematches. Prove yourself!",
+    type: "side",
+    chapters: [
+        {
+            id: "blaze_s1", name: "Round Two",
+            description: "Blaze wants a rematch. No Harmony Stone on the line — just pride.",
+            prerequisites: ["ch3_storm"], levelRequired: 6,
+            storyFlag: "blaze_s1_complete",
+            rewards: { xp: 60, gold: 45, items: ["flame_scepter"] },
+            acts: [{ id: "act1", name: "Quest", type: "dungeon", buildAdventure: () => makeAdventure({
+                        id: "blaze_s1", name: "Round Two", description: "Rematch with Blaze.",
+                        difficulty: "hard", levelRequired: 6, energyCost: 20, hungerCost: 15, completionXp: 60,
+                        startRoomId: "bs1_start",
+                        rooms: [
+                            { id: "bs1_start", type: "narrative", title: "The Challenge",
+                                text: ["A letter arrives, written in scorch marks:", "\"Same place. Sunrise. No excuses. — Blaze\""],
+                                buddyLine: "This guy just doesn't quit, does he?",
+                                choices: [{ label: "Accept the challenge", nextRoomId: "bs1_boss" }],
+                            },
+                            { id: "bs1_boss", type: "boss", title: "Blaze: Round Two",
+                                text: ["Blaze lands with a dramatic burst of flame.", "\"You got lucky last time. Let's see if it was a fluke.\""],
+                                buddyLine: "Bring it on, firebird!", enemyId: "infernodrake",
+                            },
+                        ],
+                    }) }],
+        },
+    ],
+};
+/** Get all available side quest chains based on story progress */
+function getSideQuestChains(completedChapters) {
+    const chains = [];
+    if (completedChapters.includes("ch1_whispers"))
+        chains.push(PIPS_SHIPMENT);
+    if (completedChapters.includes("ch2_echoes"))
+        chains.push(SHELLYS_MEMORIES);
+    if (completedChapters.includes("ch3_storm"))
+        chains.push(BLAZES_CHALLENGE);
+    return chains;
+}
+//# sourceMappingURL=sideQuests.js.map