Initial commit: 3D solar eclipse predictor

Single-file Three.js visualization of every solar eclipse 2001-2030.
NASA Five Millennium Canon catalog drives prev/next stepper; central
path computed live via Meeus + truncated ELP-2000. 17 cartoon 3D
landmarks at famous sites with hover tooltips. Year-jump input.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: mf4633

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+Thumbs.db
+*.log
+.vscode/
+.idea/
+node_modules/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Flynn
+
+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.

README.md

@@ -0,0 +1,42 @@
+# Eclipse Predictor
+
+Single-file 3D solar eclipse visualizer. Step through every solar eclipse from 2001 to 2030 (43 events from NASA's Five Millennium Canon) and watch the path of totality sweep across a Three.js Earth.
+
+**Live demo**: open `index.html` in any modern browser, or visit the deployed copy at <https://boardgaminghub.com/EclipsePredictor.html>.
+
+![screenshot placeholder](https://via.placeholder.com/800x400?text=Eclipse+Predictor)
+
+## What it does
+
+- **Catalog as source of truth** — 43 NASA-confirmed solar eclipses (date + type + location) drive the prev/next stepper
+- **Live path computation** — Sun position from Meeus *Astronomical Algorithms* ch. 25, Moon position from a 30-term truncated ELP-2000 model, Besselian elements derived from sub-solar/sub-lunar geometry, central path traced where the shadow axis pierces Earth's surface
+- **3D landmarks** — 17 cartoon-styled monuments (Eiffel Tower, Pyramids, Sphinx, Sydney Opera House, Statue of Liberty, Big Ben, Taj Mahal, Mt. Fuji, Christ the Redeemer, Stonehenge, Easter Island Moai, Colosseum, Burj Khalifa, Petra, Chichen Itza, Angkor Wat, Mt. Kilimanjaro) at correct lat/lon with hover tooltips
+- **Year jump** — type a year to jump to the nearest cataloged eclipse
+- **Day/night terminator** — Earth's lit and shaded sides at the eclipse instant
+- **Penumbra outline** — rough partial-eclipse extent at greatest eclipse
+
+## Controls
+
+| | |
+|---|---|
+| `←` / `→` | Previous / next eclipse |
+| `JUMP TO` field | Type year + Enter to jump |
+| `PLAY` | Auto-advance every ~2 seconds |
+| Drag | Rotate globe |
+| Scroll | Zoom |
+| Hover landmark | Show name |
+| `?` | Help modal |
+
+## Accuracy
+
+Catalog dates and types match NASA's [Five Millennium Canon of Solar Eclipses](https://eclipse.gsfc.nasa.gov). Computed paths are accurate to roughly **±100 km** — fine for visualization, **not** for chasing totality. For mission-critical predictions go to <https://eclipse.gsfc.nasa.gov>.
+
+## Stack
+
+- Single HTML file, no build step
+- [Three.js r128](https://threejs.org) (CDN)
+- [world-atlas](https://github.com/topojson/world-atlas) coastlines (CDN, ~80 KB TopoJSON, decoded inline)
+
+## License
+
+MIT — see [LICENSE](LICENSE).