@studyjoyful/shared 1.0.0

package/README.md

@@ -0,0 +1,119 @@
+# @studyjoyful/shared
+
+Shared code for StudyJoyful Web and App.
+
+## 📦 Modules
+
+| Module        | Description          | Exports                                   |
+| ------------- | -------------------- | ----------------------------------------- |
+| **i18n**      | Internationalization | `resources`, `namespaces`, `defaultNS`    |
+| **constants** | Shared constants     | `EXAMPLES_BY_GRADE`, `getExamplesByGrade` |
+| **types**     | Type definitions     | `ChildGrade`, `Subject`, `Example`        |
+| **utils**     | Utility functions    | `randomSelect`, `shuffle`                 |
+
+## 🚀 Usage
+
+### Installation (yarn link)
+
+```bash
+# In this package
+cd studyjoyful-shared
+yarn link
+
+# In Web
+cd ../studyjoyful-web
+yarn link "@studyjoyful/shared"
+
+# In App
+cd ../studyjoyful-app
+yarn link "@studyjoyful/shared"
+```
+
+### App Metro Config
+
+The App requires special Metro configuration:
+
+```javascript
+// metro.config.js
+const sharedPackagePath = path.resolve(__dirname, "../studyjoyful-shared");
+
+config.watchFolders = [sharedPackagePath];
+config.resolver.nodeModulesPaths = [
+  path.resolve(__dirname, "node_modules"),
+  path.resolve(sharedPackagePath, "node_modules"),
+];
+
+const ALIASES = {
+  "@studyjoyful/shared": sharedPackagePath + "/src",
+};
+```
+
+### Import Examples
+
+```typescript
+// i18n
+import { resources, namespaces, defaultNS } from "@studyjoyful/shared";
+
+// Constants
+import { EXAMPLES_BY_GRADE, getExamplesByGrade } from "@studyjoyful/shared";
+
+// Types
+import type { ChildGrade, Subject, Example } from "@studyjoyful/shared";
+
+// Utils
+import { randomSelect, shuffle } from "@studyjoyful/shared";
+```
+
+## 📁 Structure
+
+```
+src/
+├── index.ts           # Main exports
+├── i18n/
+│   ├── index.ts
+│   └── locales/
+│       └── en/        # English translations
+│           ├── common.json
+│           ├── auth.json
+│           ├── chat.json
+│           ├── tasks.json
+│           ├── learning.json
+│           ├── profile.json
+│           ├── errors.json
+│           └── sidebar.json
+├── constants/
+│   ├── index.ts
+│   └── examples.ts    # Learning examples
+├── types/
+│   ├── index.ts
+│   ├── child.ts       # ChildGrade, Subject
+│   └── common.ts      # PaginationParams
+└── utils/
+    ├── index.ts
+    └── random.ts      # randomSelect, shuffle
+```
+
+## 🔧 Development
+
+```bash
+# Type check
+npx tsc --noEmit
+
+# After changes, test in both:
+# 1. Web (hot reload)
+# 2. App (metro refresh)
+```
+
+## 📝 Adding New Content
+
+1. Create file in appropriate module
+2. Export from module's `index.ts`
+3. Re-export from main `src/index.ts`
+4. Test in both Web and App
+
+---
+
+**Package**: `@studyjoyful/shared`  
+**Version**: 1.0.0  
+**Consumers**: studyjoyful-web, studyjoyful-app  
+**Language**: English only (Singapore market)

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@studyjoyful/shared",
+  "version": "1.0.0",
+  "description": "Shared code for StudyJoyful Web and App (i18n, constants, types, utils)",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "studyjoyful",
+    "shared",
+    "i18n",
+    "constants",
+    "types"
+  ],
+  "author": "StudyJoyful",
+  "license": "MIT",
+  "dependencies": {
+    "i18next": "^25.6.3",
+    "react-i18next": "^16.3.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "typescript": "^5.7.3"
+  }
+}
+

package/src/constants/examples.ts

@@ -0,0 +1,215 @@
+/**
+ * ============================================
+ * Learning Examples Configuration
+ * ============================================
+ *
+ * Examples organized by grade (P1/P2/P3) and subject (Math/English).
+ * Used in chat welcome screen to provide grade-appropriate examples.
+ *
+ * Product Positioning:
+ * - Target: Parents of P1-P3 children in Singapore (6-9 years)
+ * - Subjects: Math + English
+ * - Core Value: Turn homework into 10-minute mini-game practice
+ *
+ * Display Rules:
+ * - App: 1 Math + 1 English (randomly selected)
+ * - Web: 2 Math + 2 English
+ *
+ * Guidelines:
+ * - Prompts should sound like natural parent speech (casual, concise)
+ * - Topics should match Singapore MOE curriculum
+ * - Avoid ambiguous terms (e.g., "Sight Words" needs specific words)
+ */
+
+import type { ChildGrade, Subject } from '../types';
+import { randomSelect } from '../utils';
+
+/**
+ * Example data interface
+ */
+export interface Example {
+  /** Emoji icon */
+  emoji: string;
+  /** Subject */
+  subject: Subject;
+  /** Grade label (for display) */
+  gradeHint: string;
+  /** Example title */
+  title: string;
+  /** Prompt to send to AI */
+  prompt: string;
+  /** Highlight keyword (optional) */
+  highlight?: string;
+}
+
+/**
+ * Examples organized by grade and subject
+ *
+ * Each grade has 2 examples per subject for variety.
+ * All prompts are in English (Singapore market).
+ */
+export const EXAMPLES_BY_GRADE: Record<ChildGrade, { Math: Example[]; English: Example[] }> = {
+  P1: {
+    Math: [
+      {
+        emoji: '🔢',
+        subject: 'Math',
+        gradeHint: 'P1',
+        title: 'Addition within 10',
+        prompt: 'Addition within 10, like 3+5',
+        highlight: '3+5',
+      },
+      {
+        emoji: '➖',
+        subject: 'Math',
+        gradeHint: 'P1',
+        title: 'Subtraction within 10',
+        prompt: 'Subtraction within 10, like 9-4',
+        highlight: '9-4',
+      },
+    ],
+    English: [
+      {
+        emoji: '🔤',
+        subject: 'English',
+        gradeHint: 'P1',
+        title: 'Sight Words',
+        prompt: 'Sight words: the, and, is, it',
+        highlight: 'the, and, is',
+      },
+      {
+        emoji: '📖',
+        subject: 'English',
+        gradeHint: 'P1',
+        title: 'Simple Sentences',
+        prompt: 'Simple sentences like "I like apples"',
+        highlight: 'I like apples',
+      },
+    ],
+  },
+  P2: {
+    Math: [
+      {
+        emoji: '🔢',
+        subject: 'Math',
+        gradeHint: 'P2',
+        title: 'Addition with Carrying',
+        prompt: 'Addition with carrying, like 38+25',
+        highlight: '38+25',
+      },
+      {
+        emoji: '➖',
+        subject: 'Math',
+        gradeHint: 'P2',
+        title: 'Subtraction with Borrowing',
+        prompt: 'Subtraction with borrowing, like 52-28',
+        highlight: '52-28',
+      },
+    ],
+    English: [
+      {
+        emoji: '📖',
+        subject: 'English',
+        gradeHint: 'P2',
+        title: 'Spelling Words',
+        prompt: 'Spelling: beautiful, because, different',
+        highlight: 'spelling',
+      },
+      {
+        emoji: '✏️',
+        subject: 'English',
+        gradeHint: 'P2',
+        title: 'Emotion Words',
+        prompt: 'Emotion words: happy, sad, angry',
+        highlight: 'happy, sad',
+      },
+    ],
+  },
+  P3: {
+    Math: [
+      {
+        emoji: '✖️',
+        subject: 'Math',
+        gradeHint: 'P3',
+        title: 'Times Tables',
+        prompt: '7 and 8 times tables',
+        highlight: 'times tables',
+      },
+      {
+        emoji: '➗',
+        subject: 'Math',
+        gradeHint: 'P3',
+        title: 'Division Practice',
+        prompt: 'Division like 56÷8',
+        highlight: '56÷8',
+      },
+    ],
+    English: [
+      {
+        emoji: '📝',
+        subject: 'English',
+        gradeHint: 'P3',
+        title: 'Past Tense',
+        prompt: 'Past tense verbs',
+        highlight: 'past tense',
+      },
+      {
+        emoji: '📚',
+        subject: 'English',
+        gradeHint: 'P3',
+        title: 'Reading Comprehension',
+        prompt: 'Reading comprehension practice',
+        highlight: 'reading',
+      },
+    ],
+  },
+};
+
+/**
+ * Get all examples as a flat array (for random selection)
+ */
+export function getAllExamples(): Example[] {
+  const all: Example[] = [];
+  for (const grade of Object.keys(EXAMPLES_BY_GRADE) as ChildGrade[]) {
+    all.push(...EXAMPLES_BY_GRADE[grade].Math);
+    all.push(...EXAMPLES_BY_GRADE[grade].English);
+  }
+  return all;
+}
+
+/**
+ * Get examples by grade
+ *
+ * @param grade - Child's grade (P1/P2/P3), if null select randomly from all
+ * @param mathCount - Number of Math examples (Web: 2, App: 1)
+ * @param englishCount - Number of English examples (Web: 2, App: 1)
+ * @returns Selected examples array
+ */
+export function getExamplesByGrade(
+  grade: ChildGrade | null,
+  mathCount: number,
+  englishCount: number
+): Example[] {
+  if (grade) {
+    // Has grade info, select from that grade
+    const gradeExamples = EXAMPLES_BY_GRADE[grade];
+    const mathExamples = randomSelect(gradeExamples.Math, mathCount);
+    const englishExamples = randomSelect(gradeExamples.English, englishCount);
+    return [...mathExamples, ...englishExamples];
+  }
+
+  // No grade info, randomly select from all examples
+  const allMath: Example[] = [];
+  const allEnglish: Example[] = [];
+
+  for (const g of Object.keys(EXAMPLES_BY_GRADE) as ChildGrade[]) {
+    allMath.push(...EXAMPLES_BY_GRADE[g].Math);
+    allEnglish.push(...EXAMPLES_BY_GRADE[g].English);
+  }
+
+  const mathExamples = randomSelect(allMath, mathCount);
+  const englishExamples = randomSelect(allEnglish, englishCount);
+
+  return [...mathExamples, ...englishExamples];
+}
+

package/src/constants/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared Constants
+ *
+ * Common constants and configurations used across Web and App.
+ */
+
+export * from './examples';
+

package/src/i18n/index.ts

@@ -0,0 +1,37 @@
+/**
+ * i18n Module
+ *
+ * Centralized translations for StudyJoyful Web and App.
+ * English only (Singapore market).
+ */
+
+import en from './locales/en';
+
+// All available namespaces
+export const namespaces = [
+  'common',
+  'auth',
+  'chat',
+  'tasks',
+  'learning',
+  'profile',
+  'errors',
+  'sidebar',
+] as const;
+
+export type Namespace = (typeof namespaces)[number];
+
+// Resources object for i18next
+export const resources = {
+  en,
+} as const;
+
+// Default namespace
+export const defaultNS = 'common';
+
+// Default language
+export const defaultLanguage = 'en';
+
+// Re-export locale content
+export { en };
+

package/src/i18n/locales/en/auth.json

@@ -0,0 +1,80 @@
+{
+  "signIn": {
+    "title": "StudyJoyful",
+    "subtitle": "Joyful Learning Starts Here",
+    "welcomeBack": "Welcome Back",
+    "continueWith": "Sign in to continue using StudyJoyful",
+    "email": "Email Address",
+    "emailPlaceholder": "your@email.com",
+    "sendCode": "Send Verification Code",
+    "or": "or",
+    "withGoogle": "Sign in with Google",
+    "verificationCode": "Verification Code",
+    "codeSentTo": "Sent to {{email}}",
+    "codePlaceholder": "Enter 6-digit code",
+    "verifyAndSignIn": "Verify & Sign In",
+    "back": "← Back",
+    "noAccount": "Don't have an account?",
+    "signUpNow": "Sign Up"
+  },
+  "signUp": {
+    "title": "Create Account",
+    "subtitle": "Start Your Smart Learning Journey",
+    "email": "Email Address",
+    "emailPlaceholder": "your@email.com",
+    "sendCode": "Send Verification Code",
+    "or": "or",
+    "withGoogle": "Sign up with Google",
+    "verificationCode": "Verification Code",
+    "codeSentTo": "Sent to {{email}}",
+    "codePlaceholder": "Enter 6-digit code",
+    "verifyAndSignUp": "Verify & Sign Up",
+    "back": "← Back",
+    "hasAccount": "Already have an account?",
+    "signInNow": "Sign In",
+    "termsAgreement": "By creating an account, you agree to our",
+    "termsOfService": "Terms of Service",
+    "and": "and",
+    "privacyPolicy": "Privacy Policy"
+  },
+  "errors": {
+    "signInFailed": "Sign In Failed",
+    "signUpFailed": "Sign Up Failed",
+    "checkEmail": "Please check if the email address is correct",
+    "emailAlreadyRegistered": "This email may already be registered, please try signing in",
+    "verificationFailed": "Verification Failed",
+    "tryAgain": "Please try again",
+    "incorrectCode": "Incorrect Code",
+    "checkCode": "Please check if the code is correct",
+    "codeExpired": "Code Expired",
+    "resendCode": "Please go back and resend the code",
+    "retryOrResend": "Please retry or resend the code",
+    "googleSignInFailed": "Google sign in failed, please retry",
+    "googleSignUpFailed": "Google sign up failed, please retry",
+    "additionalInfoRequired": "Additional Information Required",
+    "checkClerkConfig": "Please check your Clerk Dashboard settings, or use Google sign in"
+  },
+  "accountNotFound": {
+    "title": "Account Not Found",
+    "description": "This email is not registered yet. Would you like to sign up?",
+    "cancel": "Cancel",
+    "goSignUp": "Sign Up"
+  },
+  "devLogin": {
+    "button": "🔧 Quick Login (Dev)",
+    "logging": "Logging in...",
+    "badge": "Dev Mode",
+    "hint": "Skip OAuth, for development only"
+  },
+  "loading": {
+    "checkingAuth": "Checking login status...",
+    "loadingUser": "Loading user info...",
+    "retrying": "Retrying..."
+  },
+  "guard": {
+    "networkError": "Network Connection Failed",
+    "networkErrorDesc": "Please check your network and try again",
+    "loadError": "Failed to Load",
+    "loadErrorDesc": "Unable to load user info, please try again later"
+  }
+}

package/src/i18n/locales/en/chat.json

@@ -0,0 +1,134 @@
+{
+  "welcome": {
+    "title": "What to practice today?",
+    "subtitle": "Just tell me the topic — practice ready in seconds",
+    "tipsTitle": "💡 Good to know",
+    "tips": {
+      "tip1": "Upload a homework photo for instant analysis",
+      "tip2": "Customize: 3-10 questions, easier or harder",
+      "tip3": "Each session takes about 10 minutes"
+    },
+    "uploadHint": "Supports photo upload",
+    "examplesTitle": "Try these examples",
+    "gradeExamples": "Examples for {{grade}}"
+  },
+  "input": {
+    "placeholder": {
+      "default": "Type homework topic or upload photo...",
+      "complete": "Task complete ✅",
+      "streaming": "AI generating...",
+      "continue": "Continue conversation..."
+    },
+    "imageCompressing": "Compressing image...",
+    "imageSelected": "Image selected",
+    "uploadImage": "Upload image (auto-compress)",
+    "send": "Send (Enter)",
+    "processing": "Processing...",
+    "voiceComingSoon": "Voice input (coming soon)",
+    "sendHint": "Enter to send, Shift + Enter for new line",
+    "dragDropHint": " · Supports drag & drop or paste images",
+    "analyzeImage": "Please analyze this image"
+  },
+  "recovery": {
+    "title": "Unfinished Conversation Found",
+    "description": "You have an incomplete task creation in progress. Would you like to continue?",
+    "continue": "Continue",
+    "discard": "Start Over",
+    "discarding": "Clearing..."
+  },
+  "status": {
+    "idle": "New",
+    "clarify_profile": "Gathering Info",
+    "clarify_content": "Understanding Request",
+    "ready": "Ready to Create",
+    "generating": "Generating",
+    "generatingContent": "Generating learning content...",
+    "complete": "Complete",
+    "reject": "Cancelled",
+    "error": "Error"
+  },
+  "progress": {
+    "lesson": "Lesson",
+    "lessonActive": "Generating lesson",
+    "lessonsReady": "Lessons ready",
+    "question": "Question",
+    "questionActive": "Generating questions",
+    "questionsReady": "Questions ready",
+    "validating": "Validating",
+    "validatingActive": "Validating questions",
+    "validatingProgress": "Validating {{current}}/{{total}}",
+    "validatingItem": "Validating #{{current}}",
+    "correcting": "Optimizing",
+    "correctingActive": "Optimizing questions",
+    "correctingProgress": "Optimizing {{current}}/{{total}}",
+    "correctingProgressWithAttempt": "Optimizing {{current}}/{{total}} (attempt {{attempt}})",
+    "correctingItem": "Optimizing #{{current}}",
+    "correctingItemWithAttempt": "Optimizing #{{current}} (attempt {{attempt}})"
+  },
+  "taskDraft": {
+    "completed": "Task Generated",
+    "draft": "Task Draft",
+    "subject": "Subject",
+    "topic": "Topic",
+    "goal": "Goal",
+    "grade": "Grade",
+    "previewContent": "Preview Content"
+  },
+  "taskCreated": {
+    "title": "Task Created! 🎉",
+    "subtitle": "Your learning task is ready",
+    "startLearning": "Start Learning",
+    "preview": "Preview Content",
+    "share": "Share with Child",
+    "createAnother": "Create Another Task",
+    "lesson": "Lesson",
+    "sections": "{{count}} sections",
+    "exercise": "Exercise",
+    "questions": "{{count}} questions",
+    "shareSuccess": "Link copied to clipboard",
+    "shareFailed": "Copy failed, please copy manually",
+    "noShareLink": "No share link available"
+  },
+  "history": {
+    "title": "Recent Conversations",
+    "empty": "No conversations yet",
+    "loadFailed": "Failed to load",
+    "retryLoad": "Tap to retry",
+    "new": "New",
+    "deleteTitle": "Delete Conversation",
+    "deleteConfirm": "Delete \"{{title}}\"? This cannot be undone.",
+    "deleting": "Deleting...",
+    "messages": "{{count}} messages",
+    "viewTask": "View Task",
+    "taskGenerated": "Task Generated"
+  },
+  "abandon": {
+    "title": "Create new chat?",
+    "description": "Current conversation is incomplete. After creating a new chat, you can find this conversation in the history on the left.",
+    "stay": "Continue current",
+    "leave": "New chat"
+  },
+  "loading": {
+    "checking": "Loading...",
+    "history": "Loading conversation...",
+    "failed": "Failed to Load",
+    "expired": "Conversation Expired",
+    "backToNew": "Back to New Conversation"
+  },
+  "header": {
+    "newTask": "StudyJoyful",
+    "creating": "Creating Task"
+  },
+  "time": {
+    "justNow": "Just now",
+    "minutesAgo": "{{count}} min ago",
+    "hoursAgo": "{{count}} hours ago",
+    "daysAgo": "{{count}} days ago"
+  },
+  "math": {
+    "renderError": "Formula render error:"
+  },
+  "errors": {
+    "imageProcessingFailed": "Image Processing Failed"
+  }
+}

package/src/i18n/locales/en/common.json

@@ -0,0 +1,39 @@
+{
+  "loading": "Loading...",
+  "loadingContent": "Loading learning content...",
+  "error": "Error",
+  "success": "Success",
+  "retry": "Retry",
+  "cancel": "Cancel",
+  "save": "Save",
+  "delete": "Delete",
+  "edit": "Edit",
+  "close": "Close",
+  "confirm": "Confirm",
+  "back": "Back",
+  "next": "Next",
+  "done": "Done",
+  "submit": "Submit",
+  "continue": "Continue",
+  "skip": "Skip",
+  "search": "Search",
+  "refresh": "Refresh",
+  "viewAll": "View All",
+  "noData": "No data",
+  "copiedToClipboard": "Copied to clipboard",
+  "today": "Today",
+  "yesterday": "Yesterday",
+  "daysAgo": "{{count}} days ago",
+  "share": "Share",
+  "settings": "Settings",
+  "createTask": "Create Learning Task",
+  "imageSelect": {
+    "title": "Select Image",
+    "takePhoto": "📷 Take Photo",
+    "chooseFromGallery": "🖼️ Choose from Gallery"
+  },
+  "imagePreview": {
+    "selected": "1 image selected"
+  }
+}
+

package/src/i18n/locales/en/errors.json

@@ -0,0 +1,71 @@
+{
+  "network": {
+    "offline": "You're offline",
+    "offlineDesc": "Check your internet connection and try again",
+    "noConnection": "No network connection, please check and retry",
+    "timeout": "Request timed out",
+    "timeoutDesc": "The server is taking too long. Please try again."
+  },
+  "server": {
+    "unavailable": "Server Unavailable",
+    "unavailableDesc": "We're experiencing issues. Please try again later.",
+    "maintenance": "Under Maintenance",
+    "maintenanceDesc": "We'll be back shortly. Thank you for your patience."
+  },
+  "auth": {
+    "sessionExpired": "Session Expired",
+    "sessionExpiredDesc": "Please sign in again to continue.",
+    "unauthorized": "Access Denied"
+  },
+  "validation": {
+    "required": "This field is required",
+    "invalidEmail": "Invalid email address",
+    "tooShort": "Must be at least {{min}} characters",
+    "tooLong": "Must be at most {{max}} characters"
+  },
+  "generic": {
+    "title": "Something went wrong",
+    "description": "An unexpected error occurred. Please try again.",
+    "retry": "Retry",
+    "tryAgain": "Try Again",
+    "goBack": "Go Back",
+    "goHome": "Go to Home"
+  },
+  "request": {
+    "failed": "Request failed",
+    "failedWithStatus": "Request failed ({{status}})",
+    "connectionFailed": "Connection failed, please retry",
+    "noResponseBody": "No response body"
+  },
+  "image": {
+    "processingFailed": "Image processing failed",
+    "selectFailed": "Failed to select image, please retry",
+    "cameraFailed": "Failed to take photo, please retry",
+    "permissionGallery": "Gallery permission required to select images",
+    "permissionCamera": "Camera permission required to take photos",
+    "tooLarge": "Image still too large after compression",
+    "invalidType": "Please select an image file",
+    "maxCountExceeded": "Maximum {{count}} images allowed",
+    "placeholder": "[Image]"
+  },
+  "codes": {
+    "AUTH_001": "Please sign in first",
+    "AUTH_002": "Session expired, please sign in again",
+    "AUTH_003": "Invalid credentials",
+    "NETWORK_OFFLINE": "No internet connection",
+    "AI_001": "AI service temporarily unavailable",
+    "AI_002": "Too many requests, please try again later",
+    "SYS_001": "Server error, please try again later",
+    "SYS_002": "Resource not found",
+    "SYS_003": "Validation error",
+    "SYS_004": "Bad request",
+    "SYS_005": "Request timed out, please check network and retry",
+    "SYS_006": "Service temporarily unavailable, please try again later",
+    "AUTH_004": "Access denied",
+    "AI_003": "AI service unavailable, please try again later",
+    "AI_004": "Too many requests, please try again later",
+    "ORCH_001": "Conversation not found",
+    "ORCH_003": "Conversation expired, please start a new one"
+  }
+}
+

package/src/i18n/locales/en/index.ts

@@ -0,0 +1,26 @@
+/**
+ * English translations - aggregates all namespaces
+ */
+
+import common from './common.json';
+import auth from './auth.json';
+import chat from './chat.json';
+import tasks from './tasks.json';
+import learning from './learning.json';
+import profile from './profile.json';
+import errors from './errors.json';
+import sidebar from './sidebar.json';
+
+export const en = {
+  common,
+  auth,
+  chat,
+  tasks,
+  learning,
+  profile,
+  errors,
+  sidebar,
+};
+
+export default en;
+

package/src/i18n/locales/en/learning.json

@@ -0,0 +1,58 @@
+{
+  "webview": {
+    "title": "Learning",
+    "loading": "Loading learning content...",
+    "loadFailed": "Unable to Load",
+    "loadFailedDesc": "Please check your internet connection and try again.",
+    "retry": "Retry",
+    "openExternal": "Open in Browser",
+    "close": "Close"
+  },
+  "lesson": {
+    "title": "Lesson",
+    "section": "Section {{current}} of {{total}}",
+    "next": "Next",
+    "previous": "Previous",
+    "startExercises": "Start Exercises"
+  },
+  "exercise": {
+    "title": "Exercise",
+    "question": "Question {{current}} of {{total}}",
+    "hint": "Show Hint",
+    "submit": "Submit",
+    "next": "Next Question",
+    "finish": "Finish"
+  },
+  "feedback": {
+    "correct": "Correct! 🎉",
+    "incorrect": "Not quite right",
+    "tryAgain": "Try again",
+    "showAnswer": "Show Answer",
+    "explanation": "Explanation"
+  },
+  "progress": {
+    "title": "Progress",
+    "questionsLeft": "{{count}} questions left",
+    "almostDone": "Almost done!",
+    "lastQuestion": "Last question!"
+  },
+  "celebration": {
+    "title": "Great job! 🌟",
+    "subtitle": "You completed all exercises",
+    "score": "Your score: {{score}}%",
+    "perfect": "Perfect score!",
+    "viewReport": "View Report",
+    "backToTasks": "Back to Tasks",
+    "shareResult": "Share Result"
+  },
+  "streak": {
+    "title": "{{count}} in a row! 🔥",
+    "keep": "Keep going!"
+  },
+  "difficulty": {
+    "easy": "Easy",
+    "medium": "Medium",
+    "challenge": "Challenge"
+  }
+}
+

package/src/i18n/locales/en/profile.json

@@ -0,0 +1,134 @@
+{
+  "title": "Profile",
+  "loading": "Loading...",
+  "user": {
+    "greeting": "Hello, {{name}}!",
+    "defaultName": "User",
+    "parent": "Parent",
+    "myAccount": "My Account",
+    "joinedOn": "Joined {{date}}",
+    "editName": "Edit Name",
+    "editNameTitle": "Edit Nickname",
+    "nickname": "Nickname",
+    "namePlaceholder": "Enter your name",
+    "nicknameHint": "This is the name displayed in the app",
+    "nameUpdated": "Name updated",
+    "updateFailed": "Update failed, please try again",
+    "saveSuccess": "Saved successfully",
+    "nicknameUpdated": "Nickname updated",
+    "save": "Save",
+    "saving": "Saving...",
+    "logout": "Log Out",
+    "logoutTitle": "Log Out",
+    "logoutConfirm": "Are you sure you want to log out?",
+    "logoutConfirmDesc": "You will need to log in again to continue using the app.",
+    "cancel": "Cancel",
+    "loggingOut": "Logging out...",
+    "pleaseEnterNickname": "Please enter a nickname"
+  },
+  "child": {
+    "title": "Child Profile",
+    "profile": "Child Profile",
+    "current": "Current",
+    "switch": "Switch",
+    "add": "Add",
+    "addChild": "Add Child",
+    "create": "Create Child Profile",
+    "createChild": "Create",
+    "creating": "Creating...",
+    "createSuccess": "Created successfully",
+    "createSuccessDesc": "Child profile has been created",
+    "createFailed": "Creation failed",
+    "addPrompt": "Tap to add a child profile",
+    "noProfileYet": "No child profile yet",
+    "addMoreHint": "You can add more child profiles in your profile",
+    "manage": "Manage",
+    "manageTitle": "Manage Child Profiles",
+    "edit": "Edit Profile",
+    "editChild": "Edit Child Profile",
+    "editTitle": "Edit Child Profile",
+    "delete": "Remove",
+    "deleting": "Removing...",
+    "deleteConfirm": "Remove {{name}}'s profile? Learning history will be preserved.",
+    "deleteConfirmTitle": "Confirm Removal",
+    "deleteConfirmDesc": "Are you sure you want to remove {{name}}'s profile? This action cannot be undone.",
+    "deleteConfirmName": "Are you sure you want to remove \"{{name}}\"'s profile?",
+    "deleteSuccess": "Profile removed",
+    "deleteFailed": "Failed to remove",
+    "setDefault": "Set as Default",
+    "setDefaultSuccess": "Set {{name}} as default",
+    "setDefaultFailed": "Failed to set default, please retry",
+    "switchSuccess": "Switched successfully",
+    "switchSuccessDesc": "Current child has been changed",
+    "switchFailed": "Failed to switch",
+    "noProfiles": "No child profiles yet",
+    "maxReached": "Maximum {{count}} child profiles allowed",
+    "taskCount": "{{count}} tasks",
+    "nickname": "Child's Nickname",
+    "nicknamePlaceholder": "Enter nickname",
+    "nicknameRequired": "Please enter the child's nickname",
+    "grade": "Grade",
+    "gradeLabel": "Grade",
+    "avatar": "Avatar",
+    "selectAvatar": "Select Avatar",
+    "save": "Save Changes",
+    "saveSuccess": "Saved successfully",
+    "saveFailed": "Failed to save",
+    "saving": "Saving...",
+    "updateSuccess": "Update successful",
+    "updateFailed": "Update failed",
+    "loading": "Loading..."
+  },
+  "grades": {
+    "P1": "Primary 1",
+    "P2": "Primary 2",
+    "P3": "Primary 3"
+  },
+  "stats": {
+    "title": "Learning Stats",
+    "tasks": "Tasks",
+    "total": "Total",
+    "completed": "Completed",
+    "days": "Days",
+    "learningDays": "Learning Days",
+    "tasksCompleted": "Tasks Completed",
+    "questionsAnswered": "Questions Answered",
+    "averageScore": "Average Score",
+    "streak": "Current Streak"
+  },
+  "settings": {
+    "title": "Settings",
+    "sound": "Sound Effects",
+    "music": "Background Music",
+    "notifications": "Notifications",
+    "help": "Help & Feedback",
+    "about": "About StudyJoyful",
+    "aboutTitle": "About StudyJoyful",
+    "version": "v{{version}}",
+    "versionLabel": "Version",
+    "poweredBy": "Powered by AquilaAI Lab",
+    "copyright": "© 2024 {{company}}",
+    "terms": "Terms of Service",
+    "privacy": "Privacy Policy"
+  },
+  "emailCopied": {
+    "title": "Email Copied",
+    "description": "Please contact us via email",
+    "ok": "OK"
+  },
+  "onboarding": {
+    "title": "Let's get to know your child",
+    "description": "We'll create learning content tailored to their grade and pace",
+    "nickname": "Child's Nickname",
+    "nicknamePlaceholder": "e.g. Lucas, Mia",
+    "nicknameRequired": "Please enter a nickname",
+    "grade": "Grade",
+    "avatar": "Choose Avatar",
+    "creating": "Creating...",
+    "startLearning": "Start Learning",
+    "createSuccess": "Created successfully!",
+    "createFailed": "Creation failed",
+    "footer": "You can modify this information anytime in your profile"
+  }
+}
+

package/src/i18n/locales/en/sidebar.json

@@ -0,0 +1,64 @@
+{
+  "menu": {
+    "home": "StudyJoyful",
+    "tasks": "My Tasks",
+    "admin": "Admin",
+    "settings": "Settings"
+  },
+  "status": {
+    "idle": "New",
+    "clarify_profile": "Gathering Info",
+    "clarify_content": "In Progress",
+    "ready": "Ready",
+    "generating": "Generating",
+    "complete": "Complete",
+    "reject": "Cancelled",
+    "error": "Error"
+  },
+  "statusShort": {
+    "idle": "New",
+    "clarify_profile": "Info",
+    "clarify_content": "Chat",
+    "ready": "Ready",
+    "generating": "Gen...",
+    "complete": "Done",
+    "reject": "Cancelled",
+    "error": "Error"
+  },
+  "time": {
+    "yesterday": "Yesterday",
+    "weekdays": ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+  },
+  "history": {
+    "title": "Recent Conversations",
+    "empty": "No conversations yet",
+    "messages": "{{count}} messages",
+    "new": "New",
+    "newConversation": "New Conversation"
+  },
+  "actions": {
+    "refresh": "Refresh",
+    "retry": "Tap to retry",
+    "viewTask": "View Task",
+    "expand": "Expand sidebar",
+    "collapse": "Collapse sidebar",
+    "reload": "Reload",
+    "delete": "Delete"
+  },
+  "loading": "Loading...",
+  "error": {
+    "failed": "Failed to load"
+  },
+  "delete": {
+    "title": "Delete Conversation",
+    "description": "Delete \"{{title}}\"? This cannot be undone.",
+    "confirm": "Delete",
+    "deleting": "Deleting...",
+    "cancel": "Cancel",
+    "failed": "Delete failed"
+  },
+  "fallback": {
+    "brandSlogan": "Joyful Learning Starts Here",
+    "defaultUser": "User"
+  }
+}

package/src/i18n/locales/en/tasks.json

@@ -0,0 +1,109 @@
+{
+  "title": "My Tasks",
+  "subtitle": "{{count}} learning tasks",
+  "loading": "Loading tasks...",
+  "loadingMore": "Loading more...",
+  "noMore": "No more tasks",
+  "error": "Failed to load tasks",
+  "retry": "Retry",
+  "empty": {
+    "title": "No learning tasks yet",
+    "titleFiltered": "No {{subject}} tasks yet",
+    "description": "Start a new conversation to create your first learning task!",
+    "action": "Create Task"
+  },
+  "card": {
+    "questions": "{{completed}}/{{total}} Questions",
+    "progress": "{{completed}}/{{total}} completed",
+    "notStarted": "Not started",
+    "inProgress": "In progress",
+    "completed": "Completed",
+    "viewReport": "View Report"
+  },
+  "preview": {
+    "title": "Content Preview",
+    "lessonCard": "Lesson Card",
+    "exercises": "Exercises",
+    "sections": "{{count}} sections",
+    "startLearning": "Start Learning",
+    "share": "Share Task",
+    "shareSuccess": "Link copied!",
+    "noShareLink": "No share link available",
+    "report": "View Report",
+    "loading": "Loading...",
+    "loadFailed": "Failed to Load",
+    "retry": "Retry"
+  },
+  "report": {
+    "title": "Learning Report",
+    "loading": "Loading report...",
+    "loadFailed": "Failed to Load",
+    "loadFailedDesc": "Unable to load report",
+    "back": "Back",
+    "tryAgain": "Try Again",
+    "score": "Score",
+    "totalScore": "Total Score",
+    "correct": "Correct",
+    "wrong": "Wrong",
+    "correctCount": "{{count}} correct",
+    "wrongCount": "{{count}} wrong",
+    "firstTryCorrect": "First Try Correct",
+    "totalRetries": "Total Retries",
+    "avgRetries": "avg {{count}}/question",
+    "totalQuestions": "{{count}} total",
+    "questionsCount": "{{count}} questions",
+    "questionDetails": "Question Details",
+    "retryCount": "Retried {{count}} times",
+    "correctAnswer": "Correct Answer:",
+    "suggestion": "Learning Suggestion",
+    "empty": {
+      "title": "No Results Yet",
+      "description": "Your child hasn't completed this task yet. Results will appear here after completion."
+    },
+    "suggestions": {
+      "excellent": "Excellent! Your child has mastered \"{{topic}}\" well. Ready for more challenging content!",
+      "good": "Good job! Your child understands \"{{topic}}\" but has room to improve. Consider reviewing mistakes.",
+      "needsPractice": "Your child may need more practice with \"{{topic}}\". Try reviewing the lesson first, then practice again.",
+      "excellentTitle": "🎉 Excellent!",
+      "excellentContent": "Your child has mastered \"{{topic}}\" very well, with {{count}} questions passed on first try! Ready for more challenging content.",
+      "goodTitle": "👍 Good job!",
+      "goodContent": "Your child has a good grasp of \"{{topic}}\". {{count}} questions need review - consider practicing those.",
+      "keepGoingTitle": "💪 Keep going!",
+      "keepGoingContent": "Your child is learning \"{{topic}}\". Try reviewing the lesson card first, then practice the {{count}} questions that need work.",
+      "needMoreTitle": "📚 More practice needed",
+      "needMoreContent": "\"{{topic}}\" is still new to your child. Start by carefully studying the lesson card, then try the exercises again."
+    },
+    "performance": {
+      "excellent": "Excellent",
+      "good": "Good",
+      "keepGoing": "Keep Going"
+    },
+    "status": {
+      "firstTryPass": "First try pass",
+      "passedAfterRetry": "Passed after {{count}} retries",
+      "needsReview": "Needs review"
+    },
+    "stats": {
+      "masteryRate": "First Try Rate",
+      "total": "Total",
+      "totalQuestions": "{{count}} total",
+      "firstTryCount": "{{count}} first try",
+      "needReviewCount": "{{count}} need review",
+      "firstTryDescription": "Passed on first attempt",
+      "needReviewDescription": "Retried or incorrect",
+      "allFirstTry": "All passed on first try!"
+    }
+  },
+  "filter": {
+    "all": "All",
+    "math": "Math",
+    "english": "English",
+    "inProgress": "In Progress",
+    "completed": "Completed"
+  },
+  "sort": {
+    "newest": "Newest",
+    "oldest": "Oldest"
+  }
+}
+

package/src/i18n/locales/index.ts

@@ -0,0 +1,14 @@
+/**
+ * All locales aggregated for i18next resources
+ */
+
+import { en } from './en';
+
+export const resources = {
+  en: en,
+} as const;
+
+export { en };
+
+export default resources;
+

package/src/index.ts

@@ -0,0 +1,45 @@
+/**
+ * @studyjoyful/shared
+ *
+ * Shared code for StudyJoyful Web and App.
+ *
+ * Modules:
+ * - i18n: Internationalization (translations, resources)
+ * - constants: Shared constants (examples, etc.)
+ * - types: Common type definitions
+ * - utils: Utility functions
+ */
+
+// i18n exports
+export {
+  resources,
+  namespaces,
+  defaultNS,
+  defaultLanguage,
+  en,
+  type Namespace,
+} from './i18n';
+
+// Constants exports
+export {
+  EXAMPLES_BY_GRADE,
+  getAllExamples,
+  getExamplesByGrade,
+  type Example,
+} from './constants';
+
+// Types exports
+export {
+  type ChildGrade,
+  type Subject,
+  type AvatarId,
+  type ChildProfile,
+  ALL_GRADES,
+  ALL_SUBJECTS,
+  GRADE_LABELS,
+  type PaginationParams,
+  type PaginationMeta,
+} from './types';
+
+// Utils exports
+export { randomSelect, shuffle } from './utils';

package/src/types/child.ts

@@ -0,0 +1,56 @@
+/**
+ * Child Profile Types
+ *
+ * Types related to child profiles and grades.
+ * Used in both Web and App for consistent typing.
+ */
+
+/**
+ * Singapore primary school grades (P1-P6)
+ * Product currently focuses on P1-P3 (ages 6-9)
+ */
+export type ChildGrade = 'P1' | 'P2' | 'P3';
+
+/**
+ * Available subjects
+ * Product focuses on Math and English only
+ */
+export type Subject = 'Math' | 'English';
+
+/**
+ * Avatar identifiers (1-20)
+ */
+export type AvatarId = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20;
+
+/**
+ * Child profile interface
+ */
+export interface ChildProfile {
+  id: string;
+  name: string;
+  grade: ChildGrade;
+  avatarId: AvatarId;
+  isDefault: boolean;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * All supported grades for iteration
+ */
+export const ALL_GRADES: ChildGrade[] = ['P1', 'P2', 'P3'];
+
+/**
+ * All supported subjects for iteration
+ */
+export const ALL_SUBJECTS: Subject[] = ['Math', 'English'];
+
+/**
+ * Grade display labels
+ */
+export const GRADE_LABELS: Record<ChildGrade, string> = {
+  P1: 'Primary 1',
+  P2: 'Primary 2',
+  P3: 'Primary 3',
+};
+

package/src/types/common.ts

@@ -0,0 +1,28 @@
+/**
+ * Common Types
+ *
+ * General-purpose type definitions.
+ */
+
+/**
+ * Generic pagination parameters
+ */
+export interface PaginationParams {
+  page?: number;
+  pageSize?: number;
+  sortBy?: string;
+  sortOrder?: 'asc' | 'desc';
+}
+
+/**
+ * Generic pagination metadata
+ */
+export interface PaginationMeta {
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+}
+

package/src/types/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared Types
+ *
+ * Common type definitions used across Web and App.
+ */
+
+export * from './child';
+export * from './common';
+

package/src/utils/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared Utilities
+ *
+ * Common utility functions used across Web and App.
+ */
+
+export * from './random';
+

package/src/utils/random.ts

@@ -0,0 +1,34 @@
+/**
+ * Random Utilities
+ *
+ * Functions for random selection and shuffling.
+ */
+
+/**
+ * Randomly select n elements from array
+ *
+ * @param arr - Source array
+ * @param count - Number of elements to select
+ * @returns New array with randomly selected elements
+ */
+export function randomSelect<T>(arr: T[], count: number): T[] {
+  if (count >= arr.length) return [...arr];
+  const shuffled = [...arr].sort(() => Math.random() - 0.5);
+  return shuffled.slice(0, count);
+}
+
+/**
+ * Shuffle array (Fisher-Yates algorithm)
+ *
+ * @param arr - Source array
+ * @returns New shuffled array
+ */
+export function shuffle<T>(arr: T[]): T[] {
+  const result = [...arr];
+  for (let i = result.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [result[i], result[j]] = [result[j], result[i]];
+  }
+  return result;
+}
+