Add comprehensive test suite for Color Palette Generator

[austenstone]

Overview

This PR adds a comprehensive test suite for the Color Palette Generator web application introduced in PR #34.

What's Included

Test Files

• webapp/tests/test.html - Interactive test runner with 20 automated tests
• webapp/tests/README.md - Complete test documentation

Test Coverage (20 tests across 6 suites)

1. Color Generation (3 tests)

   • Validates hex color format generation
   • Ensures randomness in color generation
   • Validates color name generation

2. Palette Generation (4 tests)

   • Confirms 5 colors are generated
   • Validates palette structure (hex + name)
   • Checks DOM element creation
   • Verifies hex code display formatting

3. Color Locking (3 tests)

   • Tests lock toggle functionality
   • Validates unlock functionality
   • Ensures locked colors persist across regenerations

4. Palette Storage (4 tests)

   • Tests saving to localStorage
   • Validates saved palette structure
   • Tests loading saved palettes
   • Verifies clear functionality

5. UI Interactions (4 tests)

   • Copy indicator visibility
   • Saved palettes display/hide logic
   • Lock icon state changes
   • UI element updates

6. Hex Color Validation (2 tests)

   • Validates hex color range (0x000000 to 0xFFFFFF)
   • Ensures proper padding of hex values

Features

✅ Custom lightweight test framework
✅ Real-time visual feedback
✅ Comprehensive assertion library
✅ Async test support
✅ Auto-run on page load
✅ Summary statistics with pass/fail counts
✅ Detailed error messages
✅ No external dependencies

Running Tests

Simply open webapp/tests/test.html in a browser or run a local server:

cd webapp
python -m http.server 8000
# Navigate to http://localhost:8000/tests/test.html

Tests run automatically and can be re-run with the button.

Related PR

Tests the functionality from: #34

[austenstone]

📋 Review Summary

This PR adds a comprehensive test suite for the Color Palette Generator. The test coverage is extensive with 20 automated tests across 6 suites. The custom test framework is well-structured and provides good visual feedback.

🔍 General Feedback

• The test suite demonstrates good coverage of core functionality including color generation, palette management, locking, storage, and UI interactions
• The custom lightweight test framework is well-designed with async support and comprehensive assertions
• Documentation in the README is thorough and helpful for users running and extending the tests
• Minor improvements could be made around resource cleanup and error handling to make the test suite more robust