Track src modules; stop ignoring .odin files

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 20:07:47 +02:00
1 parent 33d55357cf
commit 59d8c16b29
@@ -0,0 +1,77 @@
+# HanjaKanaMun - Project Plan
+
+## Overview
+Odin + raylib multilingual memory card game for learning Japanese (Hiragana/Katakana), Korean (Hangul), and Thai scripts.
+
+## Current Status
+
+### Completed
+- [x] Created AGENTS.md project plan
+- [x] Created src/ directory structure with subdirectories (themes, card, memory, screens, assets)
+- [x] Separated themes into themes/themes.odin (colors, constants)
+- [x] Separated card logic into card/card.odin (Card struct, rendering, click detection)
+- [x] Separated memory game into memory/memory.odin (game state, logic)
+- [x] Separated screens into screens/screens.odin (UI screens, buttons)
+- [x] Added font loading in assets/assets.odin
+- [x] Fixed card positioning (removed -40 offset that pushed cards off screen)
+- [x] Fixed card selection (now allows selection in both WAITING and FIRST states)
+- [x] Added flip animations for cards (visual feedback when flipping)
+- [x] Improved visual styling (rounded corners, theme colors)
+
+### In Progress
+- [ ] Fix Japanese font rendering (TTF loading fails in raylib with "Failed to process TTF font data")
+
+### Pending
+- [ ] Add keyboard support for card selection (1-9, A-L, etc.)
+- [ ] Add proper Japanese font that works with raylib
+- [ ] Add Korean and Thai language support
+- [ ] Add more animations (win screen, transitions)
+- [ ] Add sound effects
+- [ ] Add score tracking and high scores
+- [ ] Add difficulty levels
+- [ ] Test all changes work together
+
+## Known Issues
+1. **Font rendering**: Japanese characters show as "?" - raylib's TTF loader fails with CJK fonts. Current workaround: using default font with romanji characters (A, I, U, etc.)
+2. **Keyboard support**: Not yet implemented
+
+## File Structure
+```
+HanjaKanaMun/
+├── AGENTS.md              # Project plan (this file)
+├── README.md              # Project overview
+├── odin.json              # Odin config
+├── main.odin              # Entry point only
+├── src/
+│   ├── themes/
+│   │   └── themes.odin     # Color themes, styling constants
+│   ├── card/
+│   │   └── card.odin       # Card struct and rendering
+│   ├── memory/
+│   │   └── memory.odin     # Memory game logic
+│   ├── screens/
+│   │   └── screens.odin    # Screen management (main menu, language screens)
+│   └── assets/
+│       └── assets.odin     # Font loading, resource management
+└── assets/                # Font files, images (future)
+    └── DroidSansJapanese.ttf
+```
+
+## Next Steps
+1. **Font rendering**: Try alternative approaches:
+   - Use raylib's LoadFontFromImage to create font from bitmap
+   - Use pre-converted font files
+   - Use system fonts via platform-specific APIs
+   - Use a different font format that raylib supports
+
+2. **Keyboard support**: Add number/letter keys to select cards
+
+3. **Testing**: Verify all current changes work together
+
+## Notes
+- NO rm -rf or starting over
+- Make small, incremental changes
+- Test after each change
+- Keep existing functionality working
+- All code is now properly separated into modules
+- Game is playable with mouse (romanji characters display correctly)