clibuddy 1.0.0

package/dist/rendering/overlayUI.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOverlay = createOverlay;
+exports.openOverlay = openOverlay;
+exports.scrollOverlay = scrollOverlay;
+exports.renderTitlesOverlay = renderTitlesOverlay;
+exports.renderNotificationsOverlay = renderNotificationsOverlay;
+exports.getSettingEntries = getSettingEntries;
+exports.renderSettingsOverlay = renderSettingsOverlay;
+exports.renderGearOverlay = renderGearOverlay;
+exports.renderCombatInfoOverlay = renderCombatInfoOverlay;
+exports.renderShopOverlay = renderShopOverlay;
+const titles_1 = require("../buddy/titles");
+const combat_1 = require("../adventure/combat/combat");
+const items_1 = require("../inventory/items");
+const shop_1 = require("../story/shop");
+const listUtils_1 = require("./listUtils");
+const screen_1 = require("./screen");
+function createOverlay() {
+    return { type: null, scrollIndex: 0 };
+}
+function openOverlay(type) {
+    return { type, scrollIndex: 0 };
+}
+function scrollOverlay(overlay, delta, maxItems) {
+    return { ...overlay, scrollIndex: (0, listUtils_1.moveListIndex)(overlay.scrollIndex, delta, maxItems, false) };
+}
+function formatTimeAgo(timestamp) {
+    const seconds = Math.floor((Date.now() - timestamp) / 1000);
+    if (seconds < 60)
+        return "just now";
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+function renderTitlesOverlay(state, overlay) {
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Titles${screen_1.ansi.reset}  ${screen_1.ansi.dim}(${state.titles.length}/${titles_1.TITLE_RULES.length} earned)  Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    for (let i = 0; i < titles_1.TITLE_RULES.length; i++) {
+        const rule = titles_1.TITLE_RULES[i];
+        const earned = state.titles.includes(rule.id);
+        const active = state.activeTitle === rule.id;
+        const selected = i === overlay.scrollIndex;
+        const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+        if (earned) {
+            const tag = active ? ` ${screen_1.ansi.colors.cyan}[equipped]${screen_1.ansi.reset}` : "";
+            lines.push(`  ${pointer} ${screen_1.ansi.colors.green}✓${screen_1.ansi.reset} ${screen_1.ansi.bold}${rule.label}${screen_1.ansi.reset}${tag}`);
+        }
+        else {
+            lines.push(`  ${pointer} ${screen_1.ansi.dim}✗ ??? — ${rule.hint}${screen_1.ansi.reset}`);
+        }
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Enter to equip selected title${screen_1.ansi.reset}`);
+    return lines;
+}
+function renderNotificationsOverlay(notifications, overlay) {
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Notifications${screen_1.ansi.reset}  ${screen_1.ansi.dim}(${notifications.length})  Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    if (notifications.length === 0) {
+        lines.push(`  ${screen_1.ansi.dim}  No notifications.${screen_1.ansi.reset}`);
+    }
+    else {
+        // Show newest first
+        const reversed = [...notifications].reverse();
+        for (let i = 0; i < reversed.length; i++) {
+            const notif = reversed[i];
+            const selected = i === overlay.scrollIndex;
+            const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+            const timeAgo = formatTimeAgo(notif.timestamp);
+            lines.push(`  ${pointer} ${notif.message}`);
+            lines.push(`    ${screen_1.ansi.dim}${timeAgo}${screen_1.ansi.reset}`);
+        }
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Enter to clear all${screen_1.ansi.reset}`);
+    return lines;
+}
+const SETTING_ENTRIES = [
+    { key: "sound", name: "Sound", description: "Terminal bell on events" },
+];
+function getSettingEntries() {
+    return SETTING_ENTRIES;
+}
+function renderSettingsOverlay(settings, overlay) {
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Settings${screen_1.ansi.reset}  ${screen_1.ansi.dim}Enter to toggle, Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    for (let i = 0; i < SETTING_ENTRIES.length; i++) {
+        const entry = SETTING_ENTRIES[i];
+        const value = settings[entry.key];
+        const selected = i === overlay.scrollIndex;
+        const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+        const toggle = value
+            ? `${screen_1.ansi.colors.green}[ON] ${screen_1.ansi.reset}`
+            : `${screen_1.ansi.colors.red}[OFF]${screen_1.ansi.reset}`;
+        lines.push(`  ${pointer} ${toggle} ${screen_1.ansi.bold}${entry.name}${screen_1.ansi.reset}  ${screen_1.ansi.dim}${entry.description}${screen_1.ansi.reset}`);
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    return lines;
+}
+function renderGearOverlay(state) {
+    const s = state.adventureStats;
+    const weapon = s.equippedWeapon ? (0, items_1.getItem)(s.equippedWeapon) : null;
+    const armor = s.equippedArmor ? (0, items_1.getItem)(s.equippedArmor) : null;
+    const helmet = s.equippedHelmet ? (0, items_1.getItem)(s.equippedHelmet) : null;
+    const boots = s.equippedBoots ? (0, items_1.getItem)(s.equippedBoots) : null;
+    const accessory = s.equippedAccessory ? (0, items_1.getItem)(s.equippedAccessory) : null;
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Equipped Gear${screen_1.ansi.reset}  ${screen_1.ansi.dim}Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ⚔ Weapon:  ${weapon ? `${weapon.name} (+${weapon.combatATK} ATK)${weapon.gearElement ? ` [${weapon.gearElement}]` : ""}` : `${screen_1.ansi.dim}None${screen_1.ansi.reset}`}`);
+    if (weapon?.onHitEffect)
+        lines.push(`    ${screen_1.ansi.dim}${Math.round((weapon.onHitChance ?? 0) * 100)}% ${weapon.onHitEffect} on hit${screen_1.ansi.reset}`);
+    lines.push(`  🛡 Armor:   ${armor ? `${armor.name} (+${armor.combatDEF} DEF)` : `${screen_1.ansi.dim}None${screen_1.ansi.reset}`}`);
+    if (armor?.combatHP)
+        lines.push(`    ${screen_1.ansi.dim}+${armor.combatHP} HP${screen_1.ansi.reset}`);
+    lines.push(`  🪖 Helmet:  ${helmet ? `${helmet.name} (${helmet.description})` : `${screen_1.ansi.dim}None${screen_1.ansi.reset}`}`);
+    lines.push(`  👢 Boots:   ${boots ? `${boots.name} (${boots.description})` : `${screen_1.ansi.dim}None${screen_1.ansi.reset}`}`);
+    lines.push(`  💍 Acc:     ${accessory ? `${accessory.name} (${accessory.description})` : `${screen_1.ansi.dim}None${screen_1.ansi.reset}`}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Equip gear from /inventory${screen_1.ansi.reset}`);
+    return lines;
+}
+function renderCombatInfoOverlay(state) {
+    const stats = (0, combat_1.deriveCombatStats)(state);
+    const { equippedWeapon, equippedArmor } = state.adventureStats;
+    const weapon = equippedWeapon ? (0, items_1.getItem)(equippedWeapon) : null;
+    const armor = equippedArmor ? (0, items_1.getItem)(equippedArmor) : null;
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Combat Stats${screen_1.ansi.reset}  ${screen_1.ansi.dim}Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  HP:    ${screen_1.ansi.colors.green}${stats.maxHp}${screen_1.ansi.reset}`);
+    lines.push(`  ATK:   ${screen_1.ansi.colors.red}${stats.atk}${screen_1.ansi.reset}${weapon ? ` (base + ${weapon.combatATK} from ${weapon.name})` : ""}`);
+    lines.push(`  DEF:   ${screen_1.ansi.colors.blue}${stats.def}${screen_1.ansi.reset}${armor ? ` (base + ${armor.combatDEF} from ${armor.name})` : ""}`);
+    lines.push(`  SPD:   ${stats.spd}`);
+    lines.push(`  Dodge: ${Math.round(stats.dodgeChance * 100)}%`);
+    lines.push("");
+    lines.push(`  ${screen_1.ansi.dim}Adventures: ${state.adventureStats.adventuresCompleted} | Battles won: ${state.adventureStats.battlesWon}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Bosses defeated: ${state.adventureStats.bossesDefeated} | Perfect runs: ${state.adventureStats.perfectAdventures}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    return lines;
+}
+function renderShopOverlay(state, overlay) {
+    const lines = [];
+    const gold = state.questProgress.gold;
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Pip's Shop${screen_1.ansi.reset}  ${screen_1.ansi.colors.yellow}Gold: ${gold}${screen_1.ansi.reset}  ${screen_1.ansi.dim}Esc to close${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    for (let i = 0; i < shop_1.SHOP_ITEMS.length; i++) {
+        const shopItem = shop_1.SHOP_ITEMS[i];
+        const item = (0, items_1.getItem)(shopItem.itemId);
+        if (!item)
+            continue;
+        const selected = i === overlay.scrollIndex;
+        const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+        const canAfford = gold >= shopItem.price;
+        const priceColor = canAfford ? screen_1.ansi.colors.yellow : screen_1.ansi.colors.red;
+        const rarityColor = items_1.ITEM_RARITY_COLORS[item.rarity] ?? "";
+        if (selected) {
+            lines.push(`  ${pointer} ${rarityColor}${item.name}${screen_1.ansi.reset}  ${priceColor}${shopItem.price}g${screen_1.ansi.reset}`);
+            lines.push(`    ${screen_1.ansi.dim}${item.description}${screen_1.ansi.reset}`);
+        }
+        else {
+            lines.push(`  ${pointer} ${screen_1.ansi.dim}${item.name}  ${shopItem.price}g${screen_1.ansi.reset}`);
+        }
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Enter to buy${screen_1.ansi.reset}`);
+    return lines;
+}
+//# sourceMappingURL=overlayUI.js.map

package/dist/rendering/scene.d.ts

@@ -0,0 +1,8 @@
+import { SceneItem } from "./items";
+/**
+ * Compose a scene by placing buddy art and an optional item
+ * into a fixed-width character buffer.
+ * Returns an array of lines ready to render.
+ */
+export declare function composeScene(buddyArt: string[], item: SceneItem | null, groundLine?: boolean): string[];
+//# sourceMappingURL=scene.d.ts.map

package/dist/rendering/scene.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeScene = composeScene;
+const SCENE_WIDTH = 50;
+/**
+ * Compose a scene by placing buddy art and an optional item
+ * into a fixed-width character buffer.
+ * Returns an array of lines ready to render.
+ */
+function composeScene(buddyArt, item, groundLine = true) {
+    if (!item) {
+        // No item — just center the buddy with optional ground line
+        const lines = buddyArt.map((line) => centerPad(line, SCENE_WIDTH));
+        if (groundLine) {
+            lines.push(centerPad("─".repeat(Math.max(...buddyArt.map(visibleLength)) + 4), SCENE_WIDTH));
+        }
+        return lines;
+    }
+    if (item.position === "below") {
+        return composeBuddyAboveItem(buddyArt, item);
+    }
+    // "right" or "left" — side by side
+    return composeSideBySide(buddyArt, item);
+}
+function composeBuddyAboveItem(buddyArt, item) {
+    const lines = [];
+    // Center buddy above the item
+    for (const line of buddyArt) {
+        lines.push(centerPad(line, SCENE_WIDTH));
+    }
+    // Item below
+    for (const line of item.art) {
+        lines.push(centerPad(line, SCENE_WIDTH));
+    }
+    return lines;
+}
+function composeSideBySide(buddyArt, item) {
+    const itemArt = item.art;
+    const gap = "  ";
+    // Determine heights and vertical alignment (bottom-align)
+    const maxHeight = Math.max(buddyArt.length, itemArt.length);
+    // Pad shorter array from the top
+    const paddedBuddy = topPad(buddyArt, maxHeight);
+    const paddedItem = topPad(itemArt, maxHeight);
+    const buddyWidth = Math.max(...buddyArt.map(visibleLength));
+    const lines = [];
+    for (let i = 0; i < maxHeight; i++) {
+        const bLine = rightPad(paddedBuddy[i], buddyWidth);
+        const iLine = paddedItem[i];
+        if (item.position === "right") {
+            lines.push(centerPad(bLine + gap + iLine, SCENE_WIDTH));
+        }
+        else {
+            lines.push(centerPad(iLine + gap + bLine, SCENE_WIDTH));
+        }
+    }
+    // Ground line
+    const totalWidth = buddyWidth + gap.length + Math.max(...itemArt.map(visibleLength));
+    lines.push(centerPad("─".repeat(totalWidth + 2), SCENE_WIDTH));
+    return lines;
+}
+/** Pad array from top with empty strings to reach target length */
+function topPad(arr, targetLen) {
+    const padding = targetLen - arr.length;
+    if (padding <= 0)
+        return arr;
+    return [...Array(padding).fill(""), ...arr];
+}
+/** Visible length of a string (excluding ANSI escape codes) */
+function visibleLength(str) {
+    // Strip ANSI codes
+    return str.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+/** Right-pad a string with spaces to target visible width */
+function rightPad(str, targetWidth) {
+    const pad = targetWidth - visibleLength(str);
+    return pad > 0 ? str + " ".repeat(pad) : str;
+}
+/** Center a string within target width */
+function centerPad(str, targetWidth) {
+    const len = visibleLength(str);
+    if (len >= targetWidth)
+        return str;
+    const leftPad = Math.floor((targetWidth - len) / 2);
+    return " ".repeat(leftPad) + str;
+}
+//# sourceMappingURL=scene.js.map

package/dist/rendering/screen.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Full-screen terminal renderer.
+ * Owns the entire terminal — clears and redraws each frame.
+ * No scrolling, no message spam.
+ */
+export declare const ansi: {
+    clearScreen: string;
+    hideCursor: string;
+    showCursor: string;
+    moveTo: (row: number, col: number) => string;
+    eraseDown: string;
+    bold: string;
+    dim: string;
+    reset: string;
+    colors: {
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        gray: string;
+    };
+};
+export declare class Screen {
+    private regions;
+    private footer;
+    private inputLine;
+    private width;
+    private height;
+    constructor();
+    /** Replace all content and redraw */
+    draw(content: string, footer?: string): void;
+    /** Update just the input line at the bottom without full redraw */
+    drawInputLine(input: string): void;
+    /** Draw an overlay (command palette) over the bottom portion of the screen */
+    drawOverlay(lines: string[], inputLine: string): void;
+    getWidth(): number;
+    getHeight(): number;
+    cleanup(): void;
+}
+//# sourceMappingURL=screen.d.ts.map

package/dist/rendering/screen.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Full-screen terminal renderer.
+ * Owns the entire terminal — clears and redraws each frame.
+ * No scrolling, no message spam.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Screen = exports.ansi = void 0;
+const ESC = "\x1b";
+exports.ansi = {
+    clearScreen: `${ESC}[2J${ESC}[H`,
+    hideCursor: `${ESC}[?25l`,
+    showCursor: `${ESC}[?25h`,
+    moveTo: (row, col) => `${ESC}[${row};${col}H`,
+    eraseDown: `${ESC}[J`,
+    bold: `${ESC}[1m`,
+    dim: `${ESC}[2m`,
+    reset: `${ESC}[0m`,
+    colors: {
+        red: `${ESC}[31m`,
+        green: `${ESC}[32m`,
+        yellow: `${ESC}[33m`,
+        blue: `${ESC}[34m`,
+        magenta: `${ESC}[35m`,
+        cyan: `${ESC}[36m`,
+        white: `${ESC}[37m`,
+        gray: `${ESC}[90m`,
+    },
+};
+class Screen {
+    regions = [];
+    footer = "";
+    inputLine = "";
+    width;
+    height;
+    constructor() {
+        this.width = process.stdout.columns || 80;
+        this.height = process.stdout.rows || 24;
+        process.stdout.on("resize", () => {
+            this.width = process.stdout.columns || 80;
+            this.height = process.stdout.rows || 24;
+        });
+    }
+    /** Replace all content and redraw */
+    draw(content, footer) {
+        const out = process.stdout;
+        out.write(exports.ansi.hideCursor);
+        out.write(exports.ansi.clearScreen);
+        out.write(content);
+        if (footer) {
+            // Draw footer at bottom
+            out.write(exports.ansi.moveTo(this.height - 1, 1));
+            out.write(footer);
+        }
+        // Position cursor at input line
+        out.write(exports.ansi.moveTo(this.height, 1));
+        out.write(exports.ansi.eraseDown);
+        out.write(this.inputLine);
+        out.write(exports.ansi.showCursor);
+    }
+    /** Update just the input line at the bottom without full redraw */
+    drawInputLine(input) {
+        this.inputLine = input;
+        const out = process.stdout;
+        out.write(exports.ansi.moveTo(this.height, 1));
+        out.write("\x1b[2K"); // erase line
+        out.write(input);
+    }
+    /** Draw an overlay (command palette) over the bottom portion of the screen */
+    drawOverlay(lines, inputLine) {
+        const out = process.stdout;
+        const startRow = this.height - lines.length - 1;
+        // Draw overlay lines
+        for (let i = 0; i < lines.length; i++) {
+            out.write(exports.ansi.moveTo(startRow + i, 1));
+            out.write("\x1b[2K"); // erase line
+            out.write(lines[i]);
+        }
+        // Draw input line at bottom
+        out.write(exports.ansi.moveTo(this.height, 1));
+        out.write("\x1b[2K");
+        out.write(inputLine);
+        out.write(exports.ansi.showCursor);
+    }
+    getWidth() {
+        return this.width;
+    }
+    getHeight() {
+        return this.height;
+    }
+    cleanup() {
+        process.stdout.write(exports.ansi.showCursor);
+        process.stdout.write(exports.ansi.clearScreen);
+    }
+}
+exports.Screen = Screen;
+//# sourceMappingURL=screen.js.map

package/dist/sound/sound.d.ts

@@ -0,0 +1,11 @@
+export declare function soundLevelUp(): void;
+export declare function soundTitleEarned(): void;
+export declare function soundItemFound(): void;
+export declare function soundDeath(): void;
+export declare function soundRareRoll(): void;
+export declare function soundGameEnd(): void;
+export declare function soundBattleWin(): void;
+export declare function soundBossEncounter(): void;
+export declare function soundAdventureComplete(): void;
+export declare function soundCombo(): void;
+//# sourceMappingURL=sound.d.ts.map

package/dist/sound/sound.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.soundLevelUp = soundLevelUp;
+exports.soundTitleEarned = soundTitleEarned;
+exports.soundItemFound = soundItemFound;
+exports.soundDeath = soundDeath;
+exports.soundRareRoll = soundRareRoll;
+exports.soundGameEnd = soundGameEnd;
+exports.soundBattleWin = soundBattleWin;
+exports.soundBossEncounter = soundBossEncounter;
+exports.soundAdventureComplete = soundAdventureComplete;
+exports.soundCombo = soundCombo;
+const settings_1 = require("../state/settings");
+function bell() {
+    if ((0, settings_1.getSettings)().sound) {
+        process.stdout.write("\x07");
+    }
+}
+function doubleBell() {
+    if ((0, settings_1.getSettings)().sound) {
+        process.stdout.write("\x07");
+        setTimeout(() => process.stdout.write("\x07"), 200);
+    }
+}
+function soundLevelUp() {
+    bell();
+}
+function soundTitleEarned() {
+    bell();
+}
+function soundItemFound() {
+    bell();
+}
+function soundDeath() {
+    doubleBell();
+}
+function soundRareRoll() {
+    doubleBell();
+}
+function soundGameEnd() {
+    bell();
+}
+function soundBattleWin() {
+    bell();
+}
+function soundBossEncounter() {
+    doubleBell();
+}
+function soundAdventureComplete() {
+    doubleBell();
+}
+function soundCombo() {
+    bell();
+}
+//# sourceMappingURL=sound.js.map

package/dist/state/save.d.ts

@@ -0,0 +1,5 @@
+import { BuddyState } from "../buddy/types";
+export declare function saveState(state: BuddyState): void;
+export declare function loadState(): BuddyState | null;
+export declare function deleteState(): void;
+//# sourceMappingURL=save.d.ts.map

package/dist/state/save.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveState = saveState;
+exports.loadState = loadState;
+exports.deleteState = deleteState;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const types_1 = require("../story/types");
+const STATE_DIR = path.join(os.homedir(), ".clibuddy");
+const STATE_FILE = path.join(STATE_DIR, "state.json");
+function ensureDir() {
+    if (!fs.existsSync(STATE_DIR)) {
+        fs.mkdirSync(STATE_DIR, { recursive: true });
+    }
+}
+function saveState(state) {
+    ensureDir();
+    fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2), "utf-8");
+}
+function loadState() {
+    if (!fs.existsSync(STATE_FILE))
+        return null;
+    try {
+        const raw = fs.readFileSync(STATE_FILE, "utf-8");
+        const state = JSON.parse(raw);
+        // Backfill new fields for old save files
+        if (!state.titles)
+            state.titles = [];
+        if (!state.actionCounts)
+            state.actionCounts = { feeds: 0, plays: 0, sleeps: 0, heals: 0, revives: 0, pets: 0, minigamesWon: 0, itemsFound: 0, combosTriggered: 0 };
+        // Backfill new action count fields
+        if (state.actionCounts.pets === undefined)
+            state.actionCounts.pets = 0;
+        if (state.actionCounts.minigamesWon === undefined)
+            state.actionCounts.minigamesWon = 0;
+        if (state.actionCounts.itemsFound === undefined)
+            state.actionCounts.itemsFound = 0;
+        if (state.actionCounts.combosTriggered === undefined)
+            state.actionCounts.combosTriggered = 0;
+        if (!state.inventory)
+            state.inventory = [];
+        if (!state.notifications)
+            state.notifications = [];
+        // Migrate old string[] notifications to Notification[]
+        if (state.notifications.length > 0 && typeof state.notifications[0] === "string") {
+            state.notifications = state.notifications.map((msg) => ({ message: msg, timestamp: Date.now() }));
+        }
+        if (!state.adventureStats)
+            state.adventureStats = {
+                adventuresCompleted: 0, battlesWon: 0, battlesLost: 0,
+                battlesFled: 0, bossesDefeated: 0, totalDamageDealt: 0, perfectAdventures: 0,
+            };
+        if (!state.questProgress)
+            state.questProgress = (0, types_1.createDefaultQuestProgress)();
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+function deleteState() {
+    if (fs.existsSync(STATE_FILE)) {
+        fs.unlinkSync(STATE_FILE);
+    }
+}
+//# sourceMappingURL=save.js.map

package/dist/state/settings.d.ts

@@ -0,0 +1,7 @@
+export interface Settings {
+    sound: boolean;
+}
+export declare function loadSettings(): Settings;
+export declare function saveSettings(settings: Settings): void;
+export declare function getSettings(): Settings;
+//# sourceMappingURL=settings.d.ts.map