Commit Graph
204 Commits
Author SHA1 Message Date
tiennm99 ff85264326 feat(03-02): add score display HTML overlay
- Added div with id=\"score-display\" in top-right corner
- Semi-transparent background (rgba(26, 26, 70, 0.9))
- Large bold font (24px) with light text color (#eaeaea)
- Initial text shows \"Score: 0\"
- Positioned above canvas with z-index: 100
2026-03-11 04:41:00 +00:00
tiennm99 1099f83a5c feat(03-02): add clearTiles method to GridManager
- Added clearTiles method that marks tiles as cleared
- Emits tile:cleared event for each cleared tile
- Calls deselectAll() after clearing tiles
- Enables CORE-05 (connected tiles disappear) and CORE-07 (cleared tiles become passable)
2026-03-11 04:40:30 +00:00
tiennm99 18180ada33 feat(03-02): implement MatchEngine validation pipeline
- Implemented MatchEngine class with validateMatch method
- Multi-stage validation: type check → position check → pathfinding
- Type check happens before expensive pathfinding (fail-fast optimization)
- Returns MatchResult with valid flag, reason, path, turns, and score
- All 8 test cases covering all validation branches
- Score calculated using Scoring.calculate

Test coverage:
- Different tile types → valid=false, reason='different-type'
- Same tile ID → valid=false, reason='same-tile'
- Valid 0-turn path → valid=true, turns=0, score=150
- Valid 1-turn path → valid=true, turns=1, score=125
- Valid 2-turn path → valid=true, turns=2, score=100
- 3+ turn path → valid=false, reason='too-many-turns'
- No path (blocked) → valid=false, reason='no-path'
- Score calculation correct for valid matches
2026-03-11 04:40:00 +00:00
tiennm99 b4287c55a8 test(03-02): add failing test for Scoring system
- Created test suite with 5 test cases for score calculation
- Tests cover base score (100), 0-turn bonus (150), 1-turn bonus (125)
- Tests verify default to base score for invalid turn counts
- Tests verify integer scores (no floating point)
2026-03-11 04:39:00 +00:00
tiennm99 2bcb6e5603 docs(03-01): complete Path-Finding Algorithm plan
- Created SUMMARY.md with implementation details
- Updated STATE.md with progress, decisions, and metrics
- Updated ROADMAP.md with plan progress (1/3 complete)
- Marked CORE-04 requirement as complete
- Duration: 3 minutes
- Tasks: 2 (type definitions, BFS implementation)
- Files: 3 created/modified (PathFinder.ts, PathFinder.test.ts, types/index.ts)
- Test coverage: 15 test cases
- Deviations: Fixed npm cache and rollup dependency issue (Rule 3)
2026-03-11 04:37:00 +00:00
tiennm99 80cd74aec4 feat(03-01): implement BFS pathfinding with turn counting
- Created PathFinder class with static findPath method
- Implements BFS algorithm with turn tracking (max 2 turns default)
- Direction encoding: -1=none/start, 0=up, 1=right, 2=down, 3=left
- Visited state tracking using 'row,col,direction' keys to avoid cycles
- Turn counting: only direction changes count, first move doesn't count
- Boundary checking using CONFIG.grid.rows and CONFIG.grid.cols
- Passable tile check: only cleared tiles are traversable
- Returns PathNode with path array and turn count, or null if no path
- Added 10 comprehensive test cases covering:
  * 0-turn paths (direct horizontal/vertical)
  * 1-turn L-shaped paths
  * 2-turn Z-shaped paths
  * 3+ turn rejection
  * Blocked path detection
  * Path inclusion of start/end positions
  * Correct turn counting behavior
2026-03-11 04:36:00 +00:00
tiennm99 d683099ab7 test(03-01): add PathNode and MatchResult type definitions
- Added PathNode interface for BFS state tracking (row, col, direction, turns, path)
- Added MatchResult interface for match validation results (valid, reason, path, turns)
- Created test file with type import tests
- Direction encoding: -1=none/start, 0=up, 1=right, 2=down, 3=left
2026-03-11 04:35:00 +00:00
tiennm99 82c9610c60 chore: update .gitignore and add Phase 2 artifacts
- Add shell configs, IDE files, and local configs to .gitignore
- Add Phase 2 planning artifacts (CONTEXT, RESEARCH, VERIFICATION)
- Add GridManager test suite
2026-03-11 03:09:45 +00:00
tiennm99 1d307e027b docs(02-03): complete 02-03 plan summary and state updates
- Create 02-03-SUMMARY.md with implementation details
- Update STATE.md with Phase 2 complete status
- Update ROADMAP.md to mark Phase 2 as complete
- Record all task commits and decisions

Phase 2 (Grid and Input) is now 100% complete with all 4 plans finished.
2026-03-11 02:58:19 +00:00
tiennm99 64980fb653 feat(02-03): add debounced canvas resize handler
- Add resizeTimeout field for debounce timer
- Add handleResize() method with 150ms debounce
- Add window resize event listener
- Recalculate canvas size on resize
- Trigger renderer.render() after resize

Implements Task 3 of plan 02-03
2026-03-11 02:56:33 +00:00
tiennm99 b34e5571aa feat(02-03): add mouse and touch event listeners with coordinate-to-tile mapping
- Add setupInputListeners() public method
- Add handleClick and handleTouch event handlers
- Add handleInput() method for coordinate translation
- Implement getBoundingClientRect() for accurate hit detection
- Account for device pixel ratio in coordinate calculations
- Map canvas coordinates to tile grid position
- Call gridManager.selectTile() for valid tiles

Implements Task 2 of plan 02-03
2026-03-11 02:56:11 +00:00
tiennm99 f9984d83ad feat(02-03): integrate GridManager and Renderer into Game class
- Add GridManager and Renderer imports
- Add gridManager and renderer fields to Game class
- Initialize GridManager and create grid in constructor
- Initialize Renderer with canvas reference
- Delegate render() to renderer.render()
- Add tilesSelected event listener for logging

Implements Task 1 of plan 02-03
2026-03-11 02:55:44 +00:00
tiennm99 5eb72dc502 docs(02-02): complete Renderer plan summary
- Created comprehensive SUMMARY.md documenting Renderer implementation
- Updated STATE.md with position, decisions, and metrics (86% progress)
- Updated ROADMAP.md with plan 02 completion (3 of 4 plans complete)
- Recorded 3 key decisions about GridManager, animations, and centering

**Key Deviations Documented:**
- GridManager created as blocking dependency (Rule 3)
- Added resetFadeAnimation(), setCanvas(), getSelectionAlpha() methods (Rule 2)
- Sandbox issues prevented test execution (manual verification performed)

**Metrics:**
- Duration: 7 minutes
- Tasks: 1 (TDD with RED phase complete)
- Files: 4 created/modified
- Commit: e93ef9c (implementation)
2026-03-11 02:52:46 +00:00
tiennm99 fe63451eb2 feat(02-02): implement Renderer class with tile and selection rendering
- Created Renderer class with tile rendering, selection highlighting, and fade-in animations
- Created GridManager class with tile array and selection state management (blocking dependency)
- Added tilesSelected event to GameEvents interface
- Created comprehensive test suite for Renderer with 9 test cases

**Renderer Features:**
- Renders all non-cleared tiles from GridManager at correct positions
- Centers grid horizontally and vertically within canvas
- Displays emoji characters centered within tile bounds
- Selection highlights with border (3px) and background tint (30% opacity)
- Fade-in animation over ~100ms using performance.now()
- Uses CONFIG.tile.size, gap, cornerRadius for positioning
- Respects CONFIG.colors for styling

**GridManager Features:**
- Manages 2D tile array (10x16 grid = 160 tiles)
- Selection state tracking with toggle behavior (0-2 tiles)
- selectTile() with toggle deselect and cleared tile filtering
- Emits tilesSelected event when 2 tiles selected
- getTileAt() for coordinate-based tile access

**Note:** Tests created but not runnable due to sandbox file system restrictions
preventing npm install. Implementation verified manually against plan requirements.
2026-03-11 02:51:11 +00:00
tiennm99 9a7aa816a4 fix(02): add Wave 0 test infrastructure and update dependencies
- Create Plan 02-00 (Wave 0) with test file stubs for Nyquist compliance
- Update Plans 02-01, 02-02, 02-03 to depend on 02-00
- Fix wave numbers: 02-01 and 02-02 remain in Wave 1, 02-03 stays in Wave 2
- Update VALIDATION.md: mark nyquist_compliant: true, wave_0_complete: true

Resolves checker issues:
- Nyquist Compliance: Wave 0 test files now exist
- All TDD tasks have test stubs to run against
2026-03-11 02:41:44 +00:00
tiennm99 1803410946 docs(01): complete phase execution 2026-03-11 00:29:01 +07:00
tiennm99 a9a02de4b9 docs(01-03): complete game integration plan
- Phase 1 Core Foundation complete
- Game class orchestrates loop, events, and canvas
- main.ts entry point with DOMContentLoaded initialization
- Configuration validation tests added
- Fixed browser compatibility with custom EventEmitter
2026-03-11 00:25:11 +07:00
tiennm99 c5436d2200 chore: add standard gitignore entries for Vite/TypeScript project 2026-03-11 00:13:10 +07:00
tiennm99 29633ec85a fix(01-02): replace Node EventEmitter with browser-compatible implementation
Node's 'events' module doesn't work in browsers. Replaced with custom
Map-based implementation that provides the same API but works in both
Node.js and browser environments.

All 98 tests still pass.
2026-03-11 00:09:45 +07:00
tiennm99 f0ceb38a1a feat(01-03): wire main.ts entry point with Game class
- Update main.ts to import and instantiate Game class
- Wait for DOMContentLoaded before initializing
- Add error event listener on game.events
- Add tick event listener (commented debug logging)
- Log initialization message to console
- Add main.test.ts with entry point tests (4 tests)
2026-03-11 00:00:32 +07:00
tiennm99 122160f4d1 feat(01-03): add Game class orchestrator with TDD
- Create Game class that orchestrates canvas, game loop, and events
- Game constructor initializes canvas, context, loop, and events
- Game.start() starts the loop and emits 'game:start' event
- Game.render() clears canvas with background color
- Handle device pixel ratio for sharp rendering
- Add comprehensive tests (15 tests) for Game class
2026-03-10 23:58:18 +07:00
tiennm99 eedb3b3ed9 docs(01-02): complete core infrastructure plan
- SUMMARY.md created with full execution details
- STATE.md updated: plan 2 of 3, 11% progress
- ROADMAP.md updated: 01-02 marked complete
- All 79 tests passing, TypeScript compiles clean
2026-03-10 23:54:29 +07:00
tiennm99 b011b918b3 refactor(01-02): fix TypeScript type issues in tests
- Changed EventEmitter generic constraint to `object` for interface compatibility
- Fixed GameLoop test closure variable narrowing issue by using array
2026-03-10 23:51:35 +07:00
tiennm99 b5c49230e1 feat(01-02): implement Tile model class
- Implements Tile interface from types/index.ts
- Constructor with id, type, position
- emoji getter returns CONFIG.emojis[type]
- isAdjacent() checks orthogonal adjacency
- cleared property defaults to false
2026-03-10 23:49:16 +07:00
tiennm99 50fd0b5109 test(01-02): add failing tests for Tile model class
- Tests for constructor with id, type, position
- Tests for emoji getter returning correct emoji
- Tests for isAdjacent() method with various positions
- Tests for readonly properties and cleared default
2026-03-10 23:48:48 +07:00
tiennm99 d853acac20 feat(01-02): implement TypedEventEmitter class
- Generic class wrapping Node's EventEmitter
- Type-safe on(), emit(), off() methods
- Added once() and removeAllListeners() methods
- Returns this for method chaining
2026-03-10 23:47:55 +07:00
tiennm99 70f76015c4 test(01-02): add failing tests for TypedEventEmitter class
- Tests for on(), emit(), off() methods
- Tests for multiple listeners and chaining
- Tests for type safety with typed payloads
- Tests for error handling and once() method
- Tests for removeAllListeners()
2026-03-10 23:47:24 +07:00
tiennm99 a40d2653f0 test(01-02): add failing tests for GameLoop class
- Tests for start(), stop(), isRunning(), getRafId()
- Tests for update callback with deltaTime
- Tests for delta time accumulation
- Tests for loop lifecycle (start/stop multiple times)
2026-03-10 23:46:34 +07:00
tiennm99 1a2458ca3f docs(01-01): complete project scaffolding plan
- Add SUMMARY.md with execution details
- Update STATE.md with progress and decisions
- Update ROADMAP.md with plan completion
- Mark CORE-01 as complete in REQUIREMENTS.md
2026-03-10 23:43:56 +07:00
tiennm99 ae702a3da1 feat(01-01): create shared type definitions
- Add src/types/index.ts with type definitions
- Define TilePosition interface (row, col)
- Define Tile interface (id, type, position, cleared)
- Define GameEvents interface for type-safe event handling
- Add comprehensive tests for all type definitions
2026-03-10 23:40:44 +07:00
tiennm99 e90bab3b4a feat(01-01): create game configuration constants
- Add src/config.ts with CONFIG object
- Define grid settings (10 rows, 16 cols, 160 tiles)
- Define tile settings (size, gap, corner radius)
- Define 16 nature-themed emojis
- Define color palette for game elements
- Add comprehensive tests for all config values
2026-03-10 23:39:15 +07:00
tiennm99 bf06827318 feat(01-01): create Vite project with TypeScript and Canvas
- Initialize Vite project with vanilla-ts configuration
- Add TypeScript with strict mode enabled
- Configure Vitest for testing
- Create index.html with Canvas element
- Add main.ts entry point with canvas setup
- Add setup tests for project dependencies
2026-03-10 23:38:14 +07:00
tiennm99 d30a1c5180 docs(01): create Phase 1 Core Foundation plans 2026-03-10 23:31:02 +07:00
tiennm99 7a0d675209 docs(01): add research and validation strategy 2026-03-10 23:23:07 +07:00
tiennm99 92a5f2dd73 docs(01-core-foundation): add phase research document 2026-03-10 23:21:54 +07:00
tiennm99 b4a7e4e671 docs(state): record phase 1 context session 2026-03-10 23:15:01 +07:00
tiennm99 6b43f65952 docs(01): capture phase context 2026-03-10 23:14:46 +07:00
tiennm99 8518b3cf0b docs: create roadmap (6 phases) 2026-03-10 23:04:58 +07:00
tiennm99 22d2c1f63a docs: define v1 requirements 2026-03-10 22:58:47 +07:00
tiennm99 0e8fa8fb84 docs: complete project research for Pikachu Match tile-matching game
- STACK.md: Recommended Vite + TypeScript + Canvas minimal approach
- FEATURES.md: Core matching mechanics and table stakes features
- ARCHITECTURE.md: Layered architecture with state machine pattern
- PITFALLS.md: Critical pitfalls (path-finding, board generation, dead-end detection)
- SUMMARY.md: Synthesized findings with 6-phase roadmap suggestions
2026-03-10 22:56:01 +07:00
tiennm99 b6b5600b2c chore: add project config 2026-03-10 22:33:08 +07:00
tiennm99 991124ec02 docs: initialize project 2026-03-10 22:28:35 +07:00
tiennm99 9b8d4cdee3 chore: install GSD (get-shit-done) Claude Code integration
Add GSD framework configuration including agents, commands, hooks,
and settings for spec-driven development workflow.
2026-03-10 22:16:07 +07:00
tiennm99 f54c500278 docs(gsd-module): add GSD Module 3 course structure and lesson content
- Expand README with full setup instructions, file structure, and testing notes
- Add lesson modules for 3.1–3.5 covering What is GSD through Verify & Beyond
- Add course-structure.json, PROJECT_BRIEF.md, and .claude/ commands
2026-03-08 21:13:56 +07:00
Tien Nguyen MinhandGitHub 3bf103f107 Initial commit 2026-03-08 21:11:57 +07:00
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
0ab2a54975 build(deps-dev): bump webpack-dev-server from 4.15.2 to 5.2.1 (#1)
Bumps [webpack-dev-server](https://github.com/webpack/webpack-dev-server) from 4.15.2 to 5.2.1.
- [Release notes](https://github.com/webpack/webpack-dev-server/releases)
- [Changelog](https://github.com/webpack/webpack-dev-server/blob/master/CHANGELOG.md)
- [Commits](https://github.com/webpack/webpack-dev-server/compare/v4.15.2...v5.2.1)

---
updated-dependencies:
- dependency-name: webpack-dev-server
  dependency-version: 5.2.1
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-05-23 19:17:42 +07:00
tiennm99 20381387b4 fix: build error 2025-05-14 18:29:23 +07:00
tiennm99 6cd8c7c284 feat: init 2025-05-14 18:10:57 +07:00
Tien Nguyen MinhandGitHub 8ab5066716 Initial commit 2025-05-14 18:10:14 +07:00
tiennm99 ba62030f05 docs: fix remaining stale host name in README link text 2026-08-18 14:23:24 +07:00