@kids-games/core 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matt Atencio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,282 @@
+# @kids-games/core
+
+Shared framework for [Kids Corner](https://kids.mattatencio.com) educational games (ages 2-6). Provides voice personas with pre-generated TTS audio, sound effects, celebration animations, reusable React components, and design tokens.
+
+## Installation
+
+```bash
+npm install @kids-games/core
+```
+
+Peer dependencies (install if not already present):
+
+```bash
+npm install react@^19 react-dom@^19
+```
+
+## Modules
+
+The package is split into five independently importable modules:
+
+| Module | Import | Description |
+|--------|--------|-------------|
+| **Voice** | `@kids-games/core/voice` | Persona system, audio playback, React provider & hooks |
+| **SFX** | `@kids-games/core/sfx` | Synthesized sound effects via Web Audio API |
+| **Celebrations** | `@kids-games/core/celebrations` | Confetti particle system with physics |
+| **Components** | `@kids-games/core/components` | Ready-to-use React UI components |
+| **Tokens** | `@kids-games/core/tokens` | Design tokens (colors, spacing, touch targets) |
+
+---
+
+## Voice
+
+Five kid-friendly personas, each mapped to an OpenAI TTS voice with a Web Speech API fallback:
+
+| Persona | Voice | Character |
+|---------|-------|-----------|
+| Sunny | shimmer | Warm, encouraging guide |
+| Bloop | fable | Silly, playful buddy |
+| Maple | nova | Calm, nurturing mentor |
+| Fizz | echo | Energetic, excited hype |
+| Pip | alloy | Gentle, curious explorer |
+
+### Provider setup
+
+Wrap your app (or game layout) with `KidsAudioProvider`:
+
+```tsx
+import { KidsAudioProvider } from "@kids-games/core/voice";
+
+export default function Layout({ children }) {
+  return (
+    <KidsAudioProvider storagePrefix="color-mixer" audioBasePath="/audio">
+      {children}
+    </KidsAudioProvider>
+  );
+}
+```
+
+### Hooks
+
+```tsx
+import { useVoice, usePersona, useSoundEffects, useCelebrate } from "@kids-games/core/voice";
+
+function GameScreen() {
+  const { playPhrase, muted, toggleMute } = useVoice();
+  const persona = usePersona("sunny");
+  const { playCorrect, playIncorrect } = useSoundEffects();
+  const celebrate = useCelebrate("sunny");
+
+  const handleAnswer = (correct: boolean) => {
+    if (correct) {
+      playCorrect();
+      celebrate("big");
+      playPhrase("well-done", "sunny");
+    } else {
+      playIncorrect();
+      playPhrase("try-again", "sunny");
+    }
+  };
+
+  return <button onClick={() => handleAnswer(true)}>Answer</button>;
+}
+```
+
+### Persona data
+
+```tsx
+import { PERSONAS, getPersona, getRandomPhrase } from "@kids-games/core/voice";
+
+const sunny = getPersona("sunny");
+// { name: "Sunny", openaiVoice: "shimmer", ... }
+
+const phrase = getRandomPhrase("sunny", "celebration");
+// Random celebration phrase from Sunny's pool
+```
+
+---
+
+## SFX
+
+Synthesized sound effects using the Web Audio API. No audio files needed.
+
+```tsx
+import { playTap, playPop, playCorrect, playIncorrect, playWhoosh, playCelebrationChime } from "@kids-games/core/sfx";
+
+// All functions take an AudioContext
+const ctx = new AudioContext();
+playTap(ctx);
+playPop(ctx);
+playCorrect(ctx);
+playIncorrect(ctx);
+playWhoosh(ctx);
+playCelebrationChime(ctx);
+```
+
+When using with the voice module, get the context from the provider:
+
+```tsx
+const { getContext } = useVoice();
+playTap(getContext());
+```
+
+---
+
+## Celebrations
+
+Confetti particle system with three intensity levels.
+
+```tsx
+import { createConfettiBurst, tickConfetti } from "@kids-games/core/celebrations";
+import { CELEBRATION_CONFIGS } from "@kids-games/core/celebrations";
+import type { CelebrationLevel } from "@kids-games/core/components";
+
+// Create particles
+const config = CELEBRATION_CONFIGS["big"]; // small | medium | big
+let particles = createConfettiBurst(config.particleCount);
+
+// Animation loop
+function animate() {
+  particles = tickConfetti(particles);
+  // render particles...
+  if (particles.length > 0) requestAnimationFrame(animate);
+}
+animate();
+```
+
+Or use the ready-made component (see Components below).
+
+---
+
+## Components
+
+### CelebrationOverlay
+
+Full-screen confetti overlay with auto-dismiss.
+
+```tsx
+import { CelebrationOverlay } from "@kids-games/core/components";
+
+<CelebrationOverlay
+  level="big"        // "small" | "medium" | "big" | null
+  text="Great job!"  // optional overlay text
+  onComplete={() => setLevel(null)}
+/>
+```
+
+### MuteButton
+
+Floating mute/unmute toggle. Requires `KidsAudioProvider` as an ancestor.
+
+```tsx
+import { MuteButton } from "@kids-games/core/components";
+
+<MuteButton size={48} className="custom-class" />
+```
+
+### PersonaPicker
+
+Tappable persona cards with localStorage persistence.
+
+```tsx
+import { PersonaPicker } from "@kids-games/core/components";
+
+<PersonaPicker
+  availablePersonas={["sunny", "bloop", "maple"]}
+  onSelect={(id) => setActivePersona(id)}
+  storageKey="my-game-persona"
+/>
+```
+
+---
+
+## Tokens
+
+Design tokens optimized for children ages 2-6.
+
+### Colors
+
+```tsx
+import { COLORS } from "@kids-games/core/tokens";
+
+COLORS.primary.red      // "#FF6B6B"
+COLORS.background.warm  // "#FFF8E7"
+COLORS.feedback.success // "#4CAF50"
+COLORS.persona.sunny    // "#FFD93D"
+```
+
+### Spacing
+
+```tsx
+import { SPACING } from "@kids-games/core/tokens";
+
+SPACING.touchTarget.min          // 48 (WCAG minimum)
+SPACING.touchTarget.recommended  // 56 (toddler-friendly)
+SPACING.touchTarget.large        // 64 (primary actions)
+SPACING.padding.md               // 16
+SPACING.gap.comfortable          // 16
+SPACING.radius.lg                // 16
+SPACING.fontSize.lg              // 24
+```
+
+---
+
+## Generating Voice Audio
+
+Each game defines its dialogue in a `voice-script.json` file. The generation script converts these to MP3 files using the OpenAI TTS API.
+
+### 1. Create a voice script
+
+```json
+{
+  "lines": [
+    { "id": "welcome", "text": "Welcome to Color Mixer!", "persona": "sunny" },
+    { "id": "try-again", "text": "Oops, let's try that again!", "persona": "bloop" },
+    { "id": "well-done", "text": "Amazing job, you did it!", "persona": "sunny" }
+  ]
+}
+```
+
+Save this as `voice-script.json` in your game's root directory.
+
+### 2. Generate audio files
+
+```bash
+OPENAI_API_KEY=sk-... npx tsx node_modules/@kids-games/core/scripts/generate-audio.ts ./
+```
+
+Or from the monorepo root:
+
+```bash
+OPENAI_API_KEY=sk-... npx tsx _core/scripts/generate-audio.ts ./my-game/
+```
+
+This creates `public/audio/<persona>/<id>.mp3` files. Use `--force` to regenerate existing files.
+
+### 3. Reference in your provider
+
+```tsx
+<KidsAudioProvider storagePrefix="my-game" audioBasePath="/audio">
+```
+
+The player resolves audio as `{audioBasePath}/{persona}/{phraseId}.mp3`.
+
+---
+
+## TypeScript
+
+All exports are fully typed. Key types:
+
+```tsx
+import type {
+  PersonaId,       // "sunny" | "bloop" | "maple" | "fizz" | "pip"
+  Persona,         // Full persona config object
+  CelebrationLevel // "small" | "medium" | "big"
+} from "@kids-games/core/voice";
+```
+
+---
+
+## License
+
+[MIT](./LICENSE)

package/dist/components/PersonaPicker.d.ts

@@ -8,9 +8,18 @@ interface PersonaPickerProps {
     storageKey?: string;
 }
 /**
- * Simple character selector for kids. Shows available personas as tappable cards.
- * Persists selection to localStorage if storageKey provided.
- * Reports initial selection to parent on mount.
+ * Persona selector for kids games. Displays available personas as large, tappable
+ * cards with emoji avatars and color coding. Persists the user's choice to
+ * localStorage and reports the initial selection on mount.
+ *
+ * @example
+ * ```tsx
+ * <PersonaPicker
+ *   availablePersonas={["sunny", "bloop", "maple"]}
+ *   onSelect={(id) => setActivePersona(id)}
+ *   storageKey="color-mixer-persona"
+ * />
+ * ```
  */
 export declare function PersonaPicker({ availablePersonas, onSelect, storageKey, }: PersonaPickerProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/PersonaPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersonaPicker.d.ts","sourceRoot":"","sources":["../../components/PersonaPicker.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,UAAU,kBAAkB;IAC1B,gDAAgD;IAChD,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC/B,qFAAqF;IACrF,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC5B,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,EAAE,kBAAkB,2CAgEpB"}
+{"version":3,"file":"PersonaPicker.d.ts","sourceRoot":"","sources":["../../components/PersonaPicker.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,UAAU,kBAAkB;IAC1B,gDAAgD;IAChD,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC/B,qFAAqF;IACrF,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,EAC5B,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,EAAE,kBAAkB,2CAgEpB"}

package/dist/components/PersonaPicker.js

@@ -18,9 +18,18 @@ const PERSONA_COLORS = {
     pip: "#FFB6C1",
 };
 /**
- * Simple character selector for kids. Shows available personas as tappable cards.
- * Persists selection to localStorage if storageKey provided.
- * Reports initial selection to parent on mount.
+ * Persona selector for kids games. Displays available personas as large, tappable
+ * cards with emoji avatars and color coding. Persists the user's choice to
+ * localStorage and reports the initial selection on mount.
+ *
+ * @example
+ * ```tsx
+ * <PersonaPicker
+ *   availablePersonas={["sunny", "bloop", "maple"]}
+ *   onSelect={(id) => setActivePersona(id)}
+ *   storageKey="color-mixer-persona"
+ * />
+ * ```
  */
 export function PersonaPicker({ availablePersonas, onSelect, storageKey, }) {
     const [selected, setSelected] = useState(availablePersonas[0]);

package/dist/components/PersonaPicker.js.map

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

package/dist/components/index.d.ts

@@ -1,4 +1,5 @@
 export { MuteButton } from "./MuteButton";
 export { CelebrationOverlay } from "./CelebrationOverlay";
 export { PersonaPicker } from "./PersonaPicker";
+export type { CelebrationLevel } from "../voice/types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kids-games/core",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Shared framework for Kids Corner games — voice personas, audio playback, celebrations, UI components, and design tokens",
   "type": "module",
   "license": "MIT",