Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+preview.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,10 +1,74 @@
 ---
 title: Aquatic World
-emoji: 📉
-colorFrom: green
-colorTo: yellow
+emoji: 🌊
+colorFrom: blue
+colorTo: green
 sdk: static
 pinned: false
+license: mit
+short_description: A dense procedural ocean rendered from scratch in WebGL2
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Aquatic World
+
+![Aquatic World](preview.png)
+
+A dense, real-time, procedurally generated ocean world, rendered from scratch in
+raw WebGL2. No engine, no assets, no dependencies — every wave, cloud, fish,
+coral head and caustic is computed by code. It is one self-contained HTML file.
+
+## Controls
+
+- **Drag** to look, **W A S D** to move, **Space / Q** for up and down, **Shift** to sprint
+- **1–6** presets (Dawn, Noon, Golden Hour, Squall, Midnight, Deep Dive)
+- **F** cycles camera mode, **Tab** toggles the control panel, **H** toggles the HUD
+- **P** pause, **R** reset the camera
+- Scroll to change movement speed, or orbit radius in orbit mode
+
+Dive with the **Deep Dive** preset, or switch to **dive** mode and let it sink.
+The world runs from the sunlit surface down to about 140 m.
+
+## What is actually being rendered
+
+The water is the point, and it is simulated rather than faked:
+
+- **Ray-marched volumetric ocean.** Analysts ray intersection against a displaced
+  height field, refined with a bracketed Newton solve, then a bounded march through
+  the medium integrating per-channel extinction and in-scattering (Beer–Lambert
+  with a Henyey–Greenstein phase function).
+- **Caustics from the Jacobian.** Sunlight focusing through the wave field is
+  computed as 1/|det J| of the surface mapping, which produces the sharp bright
+  filaments and dark cells real caustics have, animating coherently with the waves.
+- **Snell's window.** Looking up from shallow water shows the bright refracted disc
+  of sky, ringed by total internal reflection carrying the mirrored world below.
+- **Planar reflections** rendered from a mirrored camera, blended with the analytic
+  sky, with depth-correct refraction that will not smear the seabed onto objects
+  standing out of the water.
+- **Subsurface scattering** through wave crests, foam that breaks up with distance,
+  and sub-pixel sun glitter.
+- **Depth is chromatic.** Red is extinguished roughly ten times faster than blue, so
+  the seabed fades from orange to grey-blue as you descend — the cheapest and most
+  convincing depth cue there is.
+- Cloud shadows drift across the swell, aligned with the clouds casting them.
+
+The world holds ~900 fish in 28 boid schools across four species, jellyfish that
+pulse and migrate, kelp forests that sway with the current, coral, sponges,
+anemones and boulders on a procedural seabed, drifting plankton lit by forward
+scattering, bubble columns, bioluminescence below 60 m, and whales, mantas and
+turtles for scale.
+
+## Architecture
+
+Built by a swarm of parallel agents against a frozen interface contract, then
+verified by rendering frames headlessly on a real GPU and inspecting the pixels.
+The single file here is the concatenation of 36 modules: a core runtime
+(render-target management, a shader-chunk assembler with chunk-relative error
+reporting, automatic uniform upload) and the content modules on top of it.
+
+`AW.snap(hours, opts)` puts the world into a reproducible state for a given time
+of day and camera, which is what the render-verification harness drives.
+
+## Notes
+
+Targets 60 fps at 1600×900 on integrated graphics. Quality can be lowered in the
+control panel. A WebGL2-capable browser is required.