@kids-games/core 0.1.0

package/dist/tokens/colors.js

@@ -0,0 +1,51 @@
+/**
+ * Kid-friendly color palette.
+ * Bright, warm, high-contrast colors suitable for ages 2-6.
+ * All colors meet WCAG AA contrast requirements when paired with white or dark text.
+ */
+export const COLORS = {
+    /** Primary game colors — bright and engaging */
+    primary: {
+        red: "#FF6B6B",
+        orange: "#FFA07A",
+        yellow: "#FFD93D",
+        green: "#77DD77",
+        blue: "#6CB4EE",
+        purple: "#DDA0DD",
+        pink: "#FFB6C1",
+        teal: "#4ECDC4",
+    },
+    /** Background colors — soft and easy on the eyes */
+    background: {
+        warm: "#FFF8F0",
+        cool: "#F0F8FF",
+        neutral: "#F5F5F5",
+        sky: "#E8F4FD",
+        meadow: "#F0FFF0",
+        sunset: "#FFF0E6",
+    },
+    /** Text colors */
+    text: {
+        primary: "#2D3748",
+        secondary: "#4A5568",
+        muted: "#A0AEC0",
+        onDark: "#FFFFFF",
+        onLight: "#1A202C",
+    },
+    /** Feedback colors */
+    feedback: {
+        success: "#48BB78",
+        warning: "#F6AD55",
+        error: "#FC8181",
+        info: "#63B3ED",
+    },
+    /** Persona colors */
+    persona: {
+        sunny: "#FFD93D",
+        bloop: "#6CB4EE",
+        maple: "#C4A882",
+        fizz: "#77DD77",
+        pip: "#FFB6C1",
+    },
+};
+//# sourceMappingURL=colors.js.map

package/dist/tokens/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../tokens/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,gDAAgD;IAChD,OAAO,EAAE;QACP,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;KAChB;IAED,oDAAoD;IACpD,UAAU,EAAE;QACV,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;KAClB;IAED,kBAAkB;IAClB,IAAI,EAAE;QACJ,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,SAAS;QACpB,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;KACnB;IAED,sBAAsB;IACtB,QAAQ,EAAE;QACR,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;KAChB;IAED,qBAAqB;IACrB,OAAO,EAAE;QACP,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,SAAS;KACf;CACO,CAAC"}

package/dist/tokens/index.d.ts

@@ -0,0 +1,3 @@
+export { COLORS } from "./colors";
+export { SPACING } from "./spacing";
+//# sourceMappingURL=index.d.ts.map

package/dist/tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/tokens/index.js

@@ -0,0 +1,3 @@
+export { COLORS } from "./colors";
+export { SPACING } from "./spacing";
+//# sourceMappingURL=index.js.map

package/dist/tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/tokens/spacing.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Spacing and sizing standards for kids games.
+ * Designed for small fingers (ages 2-6) on touch devices.
+ */
+export declare const SPACING: {
+    /** Touch target sizes — critical for toddler usability */
+    readonly touchTarget: {
+        /** Absolute minimum per WCAG (48px) */
+        readonly min: 48;
+        /** Recommended for toddlers (56px) */
+        readonly recommended: 56;
+        /** Large targets for primary actions (64px) */
+        readonly large: 64;
+    };
+    /** Padding scale (in px) */
+    readonly padding: {
+        readonly xs: 4;
+        readonly sm: 8;
+        readonly md: 16;
+        readonly lg: 24;
+        readonly xl: 32;
+        readonly xxl: 48;
+    };
+    /** Gap between interactive elements — enough for small fingers */
+    readonly gap: {
+        /** Minimum gap between tappable items */
+        readonly min: 8;
+        /** Comfortable gap */
+        readonly comfortable: 16;
+        /** Spacious gap */
+        readonly spacious: 24;
+    };
+    /** Border radius — rounded = friendly */
+    readonly radius: {
+        readonly sm: 8;
+        readonly md: 12;
+        readonly lg: 16;
+        readonly xl: 24;
+        readonly full: 9999;
+    };
+    /** Font sizes — large and readable for early readers */
+    readonly fontSize: {
+        /** Minimum readable text */
+        readonly body: 18;
+        /** Standard game text */
+        readonly large: 24;
+        /** Headings and prompts */
+        readonly heading: 32;
+        /** Big numbers, single letters */
+        readonly display: 48;
+        /** Hero text */
+        readonly hero: 64;
+    };
+};
+//# sourceMappingURL=spacing.d.ts.map

package/dist/tokens/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../tokens/spacing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO;IAClB,0DAA0D;;QAExD,uCAAuC;;QAEvC,sCAAsC;;QAEtC,+CAA+C;;;IAIjD,4BAA4B;;;;;;;;;IAU5B,kEAAkE;;QAEhE,yCAAyC;;QAEzC,sBAAsB;;QAEtB,mBAAmB;;;IAIrB,yCAAyC;;;;;;;;IASzC,wDAAwD;;QAEtD,4BAA4B;;QAE5B,yBAAyB;;QAEzB,2BAA2B;;QAE3B,kCAAkC;;QAElC,gBAAgB;;;CAGV,CAAC"}

package/dist/tokens/spacing.js

@@ -0,0 +1,55 @@
+/**
+ * Spacing and sizing standards for kids games.
+ * Designed for small fingers (ages 2-6) on touch devices.
+ */
+export const SPACING = {
+    /** Touch target sizes — critical for toddler usability */
+    touchTarget: {
+        /** Absolute minimum per WCAG (48px) */
+        min: 48,
+        /** Recommended for toddlers (56px) */
+        recommended: 56,
+        /** Large targets for primary actions (64px) */
+        large: 64,
+    },
+    /** Padding scale (in px) */
+    padding: {
+        xs: 4,
+        sm: 8,
+        md: 16,
+        lg: 24,
+        xl: 32,
+        xxl: 48,
+    },
+    /** Gap between interactive elements — enough for small fingers */
+    gap: {
+        /** Minimum gap between tappable items */
+        min: 8,
+        /** Comfortable gap */
+        comfortable: 16,
+        /** Spacious gap */
+        spacious: 24,
+    },
+    /** Border radius — rounded = friendly */
+    radius: {
+        sm: 8,
+        md: 12,
+        lg: 16,
+        xl: 24,
+        full: 9999,
+    },
+    /** Font sizes — large and readable for early readers */
+    fontSize: {
+        /** Minimum readable text */
+        body: 18,
+        /** Standard game text */
+        large: 24,
+        /** Headings and prompts */
+        heading: 32,
+        /** Big numbers, single letters */
+        display: 48,
+        /** Hero text */
+        hero: 64,
+    },
+};
+//# sourceMappingURL=spacing.js.map

package/dist/tokens/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../tokens/spacing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,0DAA0D;IAC1D,WAAW,EAAE;QACX,uCAAuC;QACvC,GAAG,EAAE,EAAE;QACP,sCAAsC;QACtC,WAAW,EAAE,EAAE;QACf,+CAA+C;QAC/C,KAAK,EAAE,EAAE;KACV;IAED,4BAA4B;IAC5B,OAAO,EAAE;QACP,EAAE,EAAE,CAAC;QACL,EAAE,EAAE,CAAC;QACL,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,GAAG,EAAE,EAAE;KACR;IAED,kEAAkE;IAClE,GAAG,EAAE;QACH,yCAAyC;QACzC,GAAG,EAAE,CAAC;QACN,sBAAsB;QACtB,WAAW,EAAE,EAAE;QACf,mBAAmB;QACnB,QAAQ,EAAE,EAAE;KACb;IAED,yCAAyC;IACzC,MAAM,EAAE;QACN,EAAE,EAAE,CAAC;QACL,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,IAAI,EAAE,IAAI;KACX;IAED,wDAAwD;IACxD,QAAQ,EAAE;QACR,4BAA4B;QAC5B,IAAI,EAAE,EAAE;QACR,yBAAyB;QACzB,KAAK,EAAE,EAAE;QACT,2BAA2B;QAC3B,OAAO,EAAE,EAAE;QACX,kCAAkC;QAClC,OAAO,EAAE,EAAE;QACX,gBAAgB;QAChB,IAAI,EAAE,EAAE;KACT;CACO,CAAC"}

package/dist/voice/hooks.d.ts

@@ -0,0 +1,52 @@
+import { type KidsAudioContextType } from "./provider";
+import type { PersonaId, CelebrationLevel } from "./types";
+/**
+ * Main voice hook — access all audio playback functions.
+ *
+ * ```tsx
+ * const { playPhrase, playSequence, muted, toggleMute } = useVoice();
+ * await playPhrase("number-5", "bloop");
+ * ```
+ */
+export declare function useVoice(): KidsAudioContextType;
+/**
+ * Get a specific persona's configuration.
+ *
+ * ```tsx
+ * const sunny = usePersona("sunny");
+ * console.log(sunny.name); // "Sunny"
+ * ```
+ */
+export declare function usePersona(id: PersonaId): import("./types").Persona;
+/**
+ * Synthesized sound effects (no audio files needed).
+ * Delegates to sfx/synth.ts — single source of truth for all sound synthesis.
+ *
+ * ```tsx
+ * const { playTap, playPop, playCelebrationChime } = useSoundEffects();
+ * ```
+ */
+export declare function useSoundEffects(): {
+    playTap: () => void;
+    playPop: () => void;
+    playCelebrationChime: () => void;
+    playCorrect: () => void;
+    playIncorrect: () => void;
+    playWhoosh: () => void;
+};
+/**
+ * Celebration hook — triggers audio + returns phrase ID for visual overlay.
+ *
+ * ```tsx
+ * const { celebrate } = useCelebrate("sunny");
+ * const result = celebrate("medium"); // plays chime + returns a celebration phrase ID
+ * ```
+ */
+export declare function useCelebrate(defaultPersona?: PersonaId): {
+    celebrate: (level: CelebrationLevel, personaId?: PersonaId) => Promise<{
+        level: CelebrationLevel;
+        phraseId: string;
+        persona: PersonaId;
+    }>;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/voice/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../voice/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGzE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,QAAQ,IAAI,oBAAoB,CAQ/C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,6BAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe;;;;;;;EAuB9B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,cAAc,GAAE,SAAmB;uBAK9C,gBAAgB,cAAc,SAAS;;;;;EAsBxD"}

package/dist/voice/hooks.js

@@ -0,0 +1,91 @@
+"use client";
+import { useContext, useCallback, useMemo } from "react";
+import { KidsAudioContext } from "./provider";
+import { PERSONAS, getRandomPhrase } from "./personas";
+import * as sfxLib from "../sfx/synth";
+/**
+ * Main voice hook — access all audio playback functions.
+ *
+ * ```tsx
+ * const { playPhrase, playSequence, muted, toggleMute } = useVoice();
+ * await playPhrase("number-5", "bloop");
+ * ```
+ */
+export function useVoice() {
+    const ctx = useContext(KidsAudioContext);
+    if (!ctx.player && typeof window !== "undefined") {
+        console.warn("useVoice() called outside <KidsAudioProvider>. Wrap your app in <KidsAudioProvider>.");
+    }
+    return ctx;
+}
+/**
+ * Get a specific persona's configuration.
+ *
+ * ```tsx
+ * const sunny = usePersona("sunny");
+ * console.log(sunny.name); // "Sunny"
+ * ```
+ */
+export function usePersona(id) {
+    return useMemo(() => PERSONAS[id], [id]);
+}
+/**
+ * Synthesized sound effects (no audio files needed).
+ * Delegates to sfx/synth.ts — single source of truth for all sound synthesis.
+ *
+ * ```tsx
+ * const { playTap, playPop, playCelebrationChime } = useSoundEffects();
+ * ```
+ */
+export function useSoundEffects() {
+    const { player, muted } = useContext(KidsAudioContext);
+    const guardedCall = useCallback((fn) => {
+        if (muted || !player)
+            return;
+        try {
+            fn(player.getContext());
+        }
+        catch {
+            // Audio context not available
+        }
+    }, [player, muted]);
+    const playTap = useCallback(() => guardedCall(sfxLib.playTap), [guardedCall]);
+    const playPop = useCallback(() => guardedCall(sfxLib.playPop), [guardedCall]);
+    const playCelebrationChime = useCallback(() => guardedCall(sfxLib.playCelebrationChime), [guardedCall]);
+    const playCorrect = useCallback(() => guardedCall(sfxLib.playCorrect), [guardedCall]);
+    const playIncorrect = useCallback(() => guardedCall(sfxLib.playIncorrect), [guardedCall]);
+    const playWhoosh = useCallback(() => guardedCall(sfxLib.playWhoosh), [guardedCall]);
+    return { playTap, playPop, playCelebrationChime, playCorrect, playIncorrect, playWhoosh };
+}
+/**
+ * Celebration hook — triggers audio + returns phrase ID for visual overlay.
+ *
+ * ```tsx
+ * const { celebrate } = useCelebrate("sunny");
+ * const result = celebrate("medium"); // plays chime + returns a celebration phrase ID
+ * ```
+ */
+export function useCelebrate(defaultPersona = "sunny") {
+    const { playPhrase } = useContext(KidsAudioContext);
+    const sfx = useSoundEffects();
+    const celebrate = useCallback(async (level, personaId) => {
+        const persona = personaId ?? defaultPersona;
+        const phraseId = getRandomPhrase(persona, "celebration");
+        if (level === "small") {
+            sfx.playCorrect();
+        }
+        else if (level === "medium") {
+            sfx.playCelebrationChime();
+            await new Promise((r) => setTimeout(r, 600));
+            await playPhrase(phraseId, persona);
+        }
+        else {
+            sfx.playCelebrationChime();
+            await new Promise((r) => setTimeout(r, 800));
+            await playPhrase(phraseId, persona);
+        }
+        return { level, phraseId, persona };
+    }, [defaultPersona, playPhrase, sfx]);
+    return { celebrate };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/voice/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../voice/hooks.ts"],"names":[],"mappings":"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"}

package/dist/voice/index.d.ts

@@ -0,0 +1,6 @@
+export type { OpenAIVoice, PersonaId, Persona, VoiceScriptLine, VoiceScript, AudioState, AudioProviderConfig, CelebrationLevel, } from "./types";
+export { PERSONAS, getPersona, getRandomPhrase } from "./personas";
+export { AudioPlayer } from "./player";
+export { KidsAudioProvider } from "./provider";
+export { useVoice, usePersona, useSoundEffects, useCelebrate, } from "./hooks";
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../voice/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EACf,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/voice/index.js

@@ -0,0 +1,5 @@
+export { PERSONAS, getPersona, getRandomPhrase } from "./personas";
+export { AudioPlayer } from "./player";
+export { KidsAudioProvider } from "./provider";
+export { useVoice, usePersona, useSoundEffects, useCelebrate, } from "./hooks";
+//# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../voice/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/voice/personas.d.ts

@@ -0,0 +1,7 @@
+import type { Persona, PersonaId } from "./types";
+export declare const PERSONAS: Record<PersonaId, Persona>;
+/** Get a persona by ID */
+export declare function getPersona(id: PersonaId): Persona;
+/** Get a random phrase ID from a persona's phrase pool */
+export declare function getRandomPhrase(personaId: PersonaId, pool: "celebration" | "encouragement" | "tryAgain"): string;
+//# sourceMappingURL=personas.d.ts.map

package/dist/voice/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../voice/personas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAmI/C,CAAC;AAEF,0BAA0B;AAC1B,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAEjD;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,UAAU,GACjD,MAAM,CASR"}

package/dist/voice/personas.js

@@ -0,0 +1,143 @@
+export const PERSONAS = {
+    sunny: {
+        id: "sunny",
+        name: "Sunny",
+        role: "Encouraging guide / lead teacher",
+        description: "Warm, patient, enthusiastic. The lead teacher voice that guides kids through activities.",
+        openaiVoice: "shimmer",
+        speed: 0.9,
+        fallback: { rate: 0.85, pitch: 1.15, preferFemale: true },
+        celebrationPhrases: [
+            "celebrate-sunny-woohoo",
+            "celebrate-sunny-amazing",
+            "celebrate-sunny-wonderful",
+            "celebrate-sunny-star",
+        ],
+        encouragementPhrases: [
+            "encourage-sunny-letsgo",
+            "encourage-sunny-youcan",
+            "encourage-sunny-tryit",
+            "encourage-sunny-believe",
+        ],
+        tryAgainPhrases: [
+            "tryagain-sunny-oops",
+            "tryagain-sunny-almost",
+            "tryagain-sunny-onemore",
+        ],
+    },
+    bloop: {
+        id: "bloop",
+        name: "Bloop",
+        role: "Silly sidekick / celebrations",
+        description: "Goofy, excited, makes funny sounds. Comic relief and celebration specialist.",
+        openaiVoice: "fable",
+        speed: 1.0,
+        fallback: { rate: 0.95, pitch: 1.25, preferFemale: false },
+        celebrationPhrases: [
+            "celebrate-bloop-youdid",
+            "celebrate-bloop-wow",
+            "celebrate-bloop-incredible",
+            "celebrate-bloop-bloop",
+        ],
+        encouragementPhrases: [
+            "encourage-bloop-cmon",
+            "encourage-bloop-gogogo",
+            "encourage-bloop-ready",
+        ],
+        tryAgainPhrases: [
+            "tryagain-bloop-uhoh",
+            "tryagain-bloop-oopsie",
+            "tryagain-bloop-again",
+        ],
+    },
+    maple: {
+        id: "maple",
+        name: "Maple",
+        role: "Calm narrator / phonics teacher",
+        description: "Gentle, storytelling tone. For quieter learning moments and phonics instruction.",
+        openaiVoice: "nova",
+        speed: 0.85,
+        fallback: { rate: 0.8, pitch: 1.1, preferFemale: true },
+        celebrationPhrases: [
+            "celebrate-maple-beautiful",
+            "celebrate-maple-welldone",
+            "celebrate-maple-lovely",
+            "celebrate-maple-proud",
+        ],
+        encouragementPhrases: [
+            "encourage-maple-listen",
+            "encourage-maple-gently",
+            "encourage-maple-take-time",
+        ],
+        tryAgainPhrases: [
+            "tryagain-maple-okay",
+            "tryagain-maple-close",
+            "tryagain-maple-try",
+        ],
+    },
+    fizz: {
+        id: "fizz",
+        name: "Fizz",
+        role: "Curious explorer / question-asker",
+        description: "Energetic, always wondering 'what happens if...?' Great for discovery and experimentation.",
+        openaiVoice: "echo",
+        speed: 0.95,
+        fallback: { rate: 0.9, pitch: 1.2, preferFemale: false },
+        celebrationPhrases: [
+            "celebrate-fizz-knew",
+            "celebrate-fizz-cool",
+            "celebrate-fizz-look",
+            "celebrate-fizz-whoa",
+        ],
+        encouragementPhrases: [
+            "encourage-fizz-wonder",
+            "encourage-fizz-whathappens",
+            "encourage-fizz-trythis",
+        ],
+        tryAgainPhrases: [
+            "tryagain-fizz-hmm",
+            "tryagain-fizz-interesting",
+            "tryagain-fizz-whatif",
+        ],
+    },
+    pip: {
+        id: "pip",
+        name: "Pip",
+        role: "Gentle cheerleader / hype friend",
+        description: "Softer than Bloop but still excited. Great for encouragement without being over-the-top.",
+        openaiVoice: "alloy",
+        speed: 0.9,
+        fallback: { rate: 0.85, pitch: 1.15, preferFemale: true },
+        celebrationPhrases: [
+            "celebrate-pip-yay",
+            "celebrate-pip-hooray",
+            "celebrate-pip-great",
+            "celebrate-pip-fantastic",
+        ],
+        encouragementPhrases: [
+            "encourage-pip-youcan",
+            "encourage-pip-together",
+            "encourage-pip-believe",
+        ],
+        tryAgainPhrases: [
+            "tryagain-pip-okay",
+            "tryagain-pip-gotthis",
+            "tryagain-pip-onemore",
+        ],
+    },
+};
+/** Get a persona by ID */
+export function getPersona(id) {
+    return PERSONAS[id];
+}
+/** Get a random phrase ID from a persona's phrase pool */
+export function getRandomPhrase(personaId, pool) {
+    const persona = PERSONAS[personaId];
+    const phrases = pool === "celebration"
+        ? persona.celebrationPhrases
+        : pool === "encouragement"
+            ? persona.encouragementPhrases
+            : persona.tryAgainPhrases;
+    return phrases[Math.floor(Math.random() * phrases.length)];
+}
+//# sourceMappingURL=personas.js.map

package/dist/voice/personas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.js","sourceRoot":"","sources":["../../voice/personas.ts"],"names":[],"mappings":"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"}

package/dist/voice/player.d.ts

@@ -0,0 +1,54 @@
+import type { PersonaId } from "./types";
+/**
+ * AudioPlayer — plays pre-generated .mp3 files from public/audio/.
+ * No runtime API calls. All audio is static files served by the app.
+ */
+export declare class AudioPlayer {
+    private audioElement;
+    private audioContext;
+    private muted;
+    private volume;
+    private cancelFlag;
+    private audioBasePath;
+    private storagePrefix;
+    private unlocked;
+    private cachedVoices;
+    constructor(storagePrefix: string, audioBasePath: string);
+    /** Must be called from a user interaction to unlock audio on mobile browsers */
+    unlock(): void;
+    private getAudioElement;
+    private getAudioContext;
+    /** Get the Web Audio context for SFX synthesis */
+    getContext(): AudioContext;
+    /**
+     * Play a pre-generated phrase by ID.
+     * Resolves to the audio file at: {audioBasePath}/{personaId}/{phraseId}.mp3
+     */
+    playPhrase(phraseId: string, personaId: PersonaId): Promise<void>;
+    /**
+     * Play a sequence of phrases with pauses between them.
+     * Useful for Letter Land's "A... ah... Apple" pattern.
+     */
+    playSequence(phrases: Array<{
+        id: string;
+        persona: PersonaId;
+    }>, pauseMs?: number): Promise<void>;
+    /** Play an audio file by URL */
+    private playAudioFile;
+    /** Fallback: speak text using Web Speech API with persona voice settings */
+    speakDynamic(text: string, personaId: PersonaId): Promise<void>;
+    /** Cancel any in-progress audio playback */
+    cancel(): void;
+    /** Set muted state */
+    setMuted(muted: boolean): void;
+    /** Get muted state */
+    isMuted(): boolean;
+    /** Set volume (0.0 to 1.0) */
+    setVolume(vol: number): void;
+    /** Get volume */
+    getVolume(): number;
+    private pause;
+    /** Clean up resources */
+    destroy(): void;
+}
+//# sourceMappingURL=player.d.ts.map

package/dist/voice/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../voice/player.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8B;gBAEtC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAmBxD,gFAAgF;IAChF,MAAM,IAAI,IAAI;IAmBd,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,eAAe;IAavB,kDAAkD;IAClD,UAAU,IAAI,YAAY;IAI1B;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvE;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC,EAClD,OAAO,SAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAYhB,gCAAgC;IAChC,OAAO,CAAC,aAAa;IA2CrB,4EAA4E;IACtE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrE,4CAA4C;IAC5C,MAAM,IAAI,IAAI;IAed,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAU9B,sBAAsB;IACtB,OAAO,IAAI,OAAO;IAIlB,8BAA8B;IAC9B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAU5B,iBAAiB;IACjB,SAAS,IAAI,MAAM;IAInB,OAAO,CAAC,KAAK;IAIb,yBAAyB;IACzB,OAAO,IAAI,IAAI;CAQhB"}