Skip to content

Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)

Refine public site layout and instrument styling (#1)

Cinna Davis742b89da5b89
diff --git a/docs/DESIGN.md b/docs/DESIGN.md
new file mode 100644
index 0000000..418c841
--- /dev/null
+++ b/docs/DESIGN.md
@@ -0,0 +1,48 @@
+# DOPPLERGEIST website
+
+Scope: the public GitHub Pages site (`index.html`, `examples.html`,
+`how-it-works.html`, `site.css`, `site.js`). The upload application and scientific
+pipeline are outside this visual pass.
+
+## Design read
+
+A working instrument with the reading pace of a field report. Preserve the
+existing serif headlines, dark canvas, wave geometry and real experiment figures.
+Place the model beside the introduction so the subject is clear on arrival.
+
+ENERGY 2 / RHYTHM 3 / MOTION 2. An editorial introduction, interactive instrument,
+broad evidence figures and a compact method list provide the rhythm. A short hero
+entrance and controlled flyover playback explain the subject; decorative scroll
+reveals and background animation add no information.
+
+## Decisions
+
+- Color: charcoal and paper keep real spectrograms legible; amber marks the
+ received signal, controls and primary action. Remove lavender.
+- Typography: retain locally hosted Geist Serif for the established editorial
+ voice and Geist for readable controls. Reserve monospace for commands.
+- Layout: equal content edges on all pages; a split homepage hero directly
+ connects the explanation to its working model.
+- Spacing: generous separation distinguishes research stages; controls stay
+ close to their readouts.
+- Containers: frame the instrument and evidence; prose needs no decorative cards.
+- Imagery: retain the geometric wave simulation and actual experiment plots.
+ The simulation is an educational model, not audio playback or recorded data.
+- Dark canvas: preserve the incumbent visual world and dark plot backgrounds
+ so figures and model form one continuous reading surface.
+- Motion: a brief entrance introduces the instrument; playback has pause/replay,
+ stops offscreen and defaults to still under reduced motion.
+- Links: a solid primary action opens the method; external arrows identify
+ repository destinations. Preserve existing navigation and destinations.
+
+## Truth and resilience
+
+Preserve scientific qualifications: rankings are not probabilities, proposals
+are not confirmed aircraft, and inconclusive runs remain inconclusive. Original
+figures, their links and the static model work without JavaScript. Enhancement
+adds playback, scrubbing and image dialogs. Dialogs report image loading and
+failure. Every control has a label, a keyboard path and visible focus.
+
+Direction: incumbent site plus the user-requested taste-skill, Impeccable and
+anti-slop guides, retrieved 2026-11-07. No generated imagery or claims are needed.
+Verification is recorded in `SITE_REFRESH_VERIFICATION.md`.
diff --git a/docs/SITE_REFRESH_TASTE_GATE.md b/docs/SITE_REFRESH_TASTE_GATE.md
new file mode 100644
index 0000000..fd05b0f
--- /dev/null
+++ b/docs/SITE_REFRESH_TASTE_GATE.md
@@ -0,0 +1,162 @@
+# Taste-skill template gate, 2026-11-07
+
+`GATE: OPEN 35 (rounds used up)`
+
+The gate ran all three allowed refinement rounds: 46, 38 and 35 open findings.
+No waivers were created and no skill sources were modified. This report records
+remaining failures explicitly; it is not a PASS or full guide-compliance claim.
+
+The guide requires stopping refinement after its third round. The site retains
+the incumbent headline, research captions and natural document flow. These
+choices leave literal template requirements unmet; they have not been waived.
+Functional/browser/accessibility checks are recorded separately in
+[SITE_REFRESH_VERIFICATION.md](SITE_REFRESH_VERIFICATION.md).
+
+## Open findings
+
+1. **no-visual** (1440, 390px): no picture, effect or mock in this section; a feature section needs a visual
+ - Target: `main#main > section.section.wrap:nth-of-type(3) "From a pitch curve to a place on the map"`
+ - Checker recommendation: give the section a visual: a UI fragment on a ground, real icons, or a photograph that fits
+
+2. **text-only** (1440, 390px): the closing section is only text: no picture, icon, mock or effect in it
+ - Target: `main#main > section.closing.wrap "Start with a recording."`
+ - Checker recommendation: give the section a visual: a photograph that fits, the real icons, or a UI fragment on a ground
+
+3. **copy-headline** (1440px): "A flight leaves a trace in sound." does not name what is sold (aircraft audio geolocation, aircraft, audio, geolocation, from flags); only the line under it does
+ - Target: `main#main > section.hero.wrap > div.hero-copy > h1 "A flight leaves a trace in sound."`
+ - Checker recommendation: put the category noun in the h1 (and who it is for, or where), in 2 to 8 words
+
+4. **copy-headings** (1440px): "Read the sound." names no product, part, place or section (3 headings like it; at most one brand line per page) (and 2 more like it: "Test the fit.", "Start with a recording.")
+ - Target: `section.section.wrap:nth-of-type(3) > ol.method-steps > li:nth-of-type(1) > h3 "Read the sound."`
+ - Checker recommendation: name the thing in every heading: the product, a part, the place or a section noun
+
+5. **section-gaps** (1440px): 280px between these sections, +67% against the median 168px
+ - Target: `main#main > section.section.wrap:nth-of-type(3) / main#main > section.section.wrap:nth-of-type(4)`
+ - Checker recommendation: use one gap between sections (all within 25% of each other)
+
+6. **visual-caption** (1440px): a figcaption under the picture livermore-automatic-mp3.webp: "Recorded audio and ranked candidates. Th..."; no caption or description under any image, render or visual (house rule)
+ - Target: `main#main > section.section.wrap:nth-of-type(2) > figure.evidence-figure > figcaption "Recorded audio and ranked candidates. Th"`
+ - Checker recommendation: take the line away: no caption or description under, over or on any image, render or visual; a licence credit goes in one footer line
+
+7. **visual-caption** (1440px): a figcaption under the picture discovery-overview.webp: "Moving-frequency proposals found by the ..."; no caption or description under any image, render or visual (house rule)
+ - Target: `main#main > section.section.wrap:nth-of-type(4) > figure.evidence-figure > figcaption "Moving-frequency proposals found by the "`
+ - Checker recommendation: take the line away: no caption or description under, over or on any image, render or visual; a licence credit goes in one footer line
+
+8. **empty-area** (1440px): 62% of the section is empty: 63% beside content that covers under half the container, in its 238px of rows (WARN over 35%, FAIL over 50%)
+ - Target: `main#main > section.closing.wrap "Start with a recording."`
+ - Checker recommendation: fill the section: a picture or a second column beside the words, or more of its own content; the section stays one or two screens tall (T-height)
+
+9. **moment-none** (1440px): a software page (--type) deals no moment: every kind carries one, two on a long page (moments.md)
+ - Target: `(the page)`
+ - Checker recommendation: deal one (moments.mjs pick --page software) and mount it in its own section
+
+10. **section-height** (1440px): the section is 115px tall (0.1 screens), 785px short of one screen (900px): every section after the hero is one screen or two, 2px either way (SR-2)
+ - Target: `footer.wrap "DOPPLERGEIST DocumentationLicenseCommerc"`
+ - Checker recommendation: set the section to one screen or two (height: calc(var(--h,1) * 100vh), --h 1 or 2) and cut or split its content to fit
+
+11. **section-height** (1440px): the section is 450px tall (0.5 screens), 450px short of one screen (900px): every section after the hero is one screen or two, 2px either way (SR-2)
+ - Target: `main#main > section.closing.wrap "Start with a recording.Run DOPPLERGEIST "`
+ - Checker recommendation: set the section to one screen or two (height: calc(var(--h,1) * 100vh), --h 1 or 2) and cut or split its content to fit
+
+12. **one-section** (1440px): the screen at scroll 3600px (stride 4) shows 336px of section 4 and the content of 3 sections, over 24px each beside section 5: a screen shows one section (another may peek 8px, 24px WARN) (SR-4)
+ - Target: `main#main > section.section.wrap:nth-of-type(4) "More flyovers. One location.DOPPLERGEIST"`
+ - Checker recommendation: make each section exactly one screen or two, so a screen shows one section and no neighbour peeks
+
+13. **container-edges** (1440px): a <a> at the top of the page, outside header.nav, main, footer.closing and nav.actionbar (SR-6)
+ - Target: `a.skip "Skip to content"`
+ - Checker recommendation: build the page as header.nav, a main of sections (each one in-flow .wrap plus background layers) and footer.closing
+
+14. **container-edges** (1440px): a <header> at the top of the page, outside header.nav, main, footer.closing and nav.actionbar (SR-6)
+ - Target: `header.site-header.wrap "DOPPLERGEIST OverviewExamplesHow it work"`
+ - Checker recommendation: build the page as header.nav, a main of sections (each one in-flow .wrap plus background layers) and footer.closing
+
+15. **container-edges** (1440px): a <footer> at the top of the page, outside header.nav, main, footer.closing and nav.actionbar (and 6 more like it: "A flight leavesa trace i", "An aircraft over Livermo", "From a pitch curveto a p") (SR-6)
+ - Target: `footer.wrap "DOPPLERGEIST DocumentationLicenseCommerc"`
+ - Checker recommendation: build the page as header.nav, a main of sections (each one in-flow .wrap plus background layers) and footer.closing
+
+16. **container-edges** (1440px): 1 text block starts on a left line at x 706, 626px from the container's left: text starts on the container's left, or on one split line (x 623, 732, 841) (SR-6)
+ - Target: `section.hero.wrap > div.doppler-demo > div.instrument-heading > span:nth-of-type(1) "The Doppler effect"`
+ - Checker recommendation: start the text on the container's left, or on the one split line every split shares
+
+17. **container-edges** (1440px): 4 text blocks start on a left line at x 101, 21px from the container's left: text starts on the container's left, or on one split line (x 623, 732, 841) (also "Recorded audio and ranked candid", "Across the recording", "Moving-frequency proposals found") (SR-6)
+ - Target: `section.section.wrap:nth-of-type(2) > figure.evidence-figure > div.figure-heading > span:nth-of-type(1) "Automatic MP3 search"`
+ - Checker recommendation: start the text on the container's left, or on the one split line every split shares
+
+18. **container-edges** (1440px): a box over half the container wide runs 681-1360px, not on the container's lines at 80-1360px (SR-6)
+ - Target: `main#main > section.hero.wrap > div.doppler-demo "The Doppler effectInteractive model How "`
+ - Checker recommendation: run the picture or box from the container's left line to its right line, or put it in a row or a split
+
+19. **split-pair** (1440px): the two columns of the split start 69px apart at the top: a split's columns are top-aligned, 8px either way (SR-8)
+ - Target: `main#main > section.section.wrap:nth-of-type(4) > div.section-intro "More flyovers. One location.DOPPLERGEIST"`
+ - Checker recommendation: top-align both columns of the split (align-items: start)
+
+20. **split-pair** (1440px): the two columns of the split start 39px apart at the top: a split's columns are top-aligned, 8px either way (SR-8)
+ - Target: `main#main > section.section.wrap:nth-of-type(2) > div.section-intro "An aircraft over Livermore.An MP3 record"`
+ - Checker recommendation: top-align both columns of the split (align-items: start)
+
+21. **edge-left** (1440px): starts at x 802.2; the lines are 80 and the column starts
+ - Target: `section.section.wrap p "An MP3 recorded in Livermore, se"`
+ - Checker recommendation: start it on the .wrap left line
+
+22. **edge-left** (1440px): starts at x 802.2; the lines are 80 and the column starts
+ - Target: `section.section.wrap p "DOPPLERGEIST scans the whole rec"`
+ - Checker recommendation: start it on the .wrap left line
+
+23. **screen-short** (1440px): 812px tall; one screen under the nav is 900px
+ - Target: `section.hero.wrap section.hero.wrap "A flight leavesa trace in sound."`
+ - Checker recommendation: make the section one full screen (--h: 1, layout-v4.md section 2)
+
+24. **screen-height** (1440, 390px): 1113px, 1.24 screens; a section is exactly one or two (--h)
+ - Target: `section.section.wrap section.section.wrap "An aircraft over Livermore.An MP"`
+ - Checker recommendation: make the section exactly one or two screens (--h: 1 or 2)
+
+25. **screen-height** (1440, 390px): 1022px, 1.14 screens; a section is exactly one or two (--h)
+ - Target: `section.section.wrap section.section.wrap "More flyovers. One location.DOPP"`
+ - Checker recommendation: make the section exactly one or two screens (--h: 1 or 2)
+
+26. **screen-short** (1440, 390px): 450px tall; one screen under the nav is 900px
+ - Target: `section.closing.wrap section.closing.wrap "Start with a recording.Run DOPPL"`
+ - Checker recommendation: make the section one full screen (--h: 1, layout-v4.md section 2)
+
+27. **screen-height** (1440, 390px): 450px, 0.50 screens; a section is exactly one or two (--h)
+ - Target: `section.closing.wrap section.closing.wrap "Start with a recording.Run DOPPL"`
+ - Checker recommendation: make the section exactly one or two screens (--h: 1 or 2)
+
+28. **neighbour** (1440, 390px): framed, 115px of the footer shows
+ - Target: `section.closing.wrap section.closing.wrap "Start with a recording.Run DOPPL"`
+ - Checker recommendation: keep the next section's heading and picture out of this screen
+
+29. **hero-fold** (1440, 390px): starts at y 88, not under the nav
+ - Target: `section.hero.wrap section.hero.wrap "A flight leavesa trace in sound."`
+ - Checker recommendation: the hero fills the first screen alone, its button inside it
+
+30. **screen-short** (390px): 650px tall; one screen under the nav is 844px
+ - Target: `section.section.wrap section.section.wrap "An aircraft over Livermore.An MP"`
+ - Checker recommendation: make the section one full screen (--h: 1, layout-v4.md section 2)
+
+31. **neighbour** (390px): framed, 73px of section.section.wrap section.section.wrap "From a pitch curveto a place on " shows
+ - Target: `section.section.wrap section.section.wrap "An aircraft over Livermore.An MP"`
+ - Checker recommendation: keep the next section's heading and picture out of this screen
+
+32. **screen-short** (390px): 823px tall; one screen under the nav is 844px
+ - Target: `section.section.wrap section.section.wrap "From a pitch curveto a place on "`
+ - Checker recommendation: make the section one full screen (--h: 1, layout-v4.md section 2)
+
+33. **screen-height** (390px): 823px, 0.97 screens; a section is exactly one or two (--h), or on a phone at least one that its content fills
+ - Target: `section.section.wrap section.section.wrap "From a pitch curveto a place on "`
+ - Checker recommendation: make the section exactly one or two screens (--h: 1 or 2)
+
+34. **screen-short** (390px): 598px tall; one screen under the nav is 844px
+ - Target: `section.section.wrap section.section.wrap "More flyovers. One location.DOPP"`
+ - Checker recommendation: make the section one full screen (--h: 1, layout-v4.md section 2)
+
+35. **neighbour** (390px): framed, 56px of section.closing.wrap section.closing.wrap "Start with a recording.Run DOPPL" shows
+ - Target: `section.section.wrap section.section.wrap "More flyovers. One location.DOPP"`
+ - Checker recommendation: keep the next section's heading and picture out of this screen
+
+## Warnings
+
+The gate also records nine nonblocking warnings. The full text, screenshots,
+consistency JSON and layout reports are retained with the local preview receipts.
+Scientific captions and the original factual copy are retained deliberately.
+The original headline is the incumbent site's wording; it is not newly invented copy.
diff --git a/docs/SITE_REFRESH_VERIFICATION.md b/docs/SITE_REFRESH_VERIFICATION.md
new file mode 100644
index 0000000..94551db
--- /dev/null
+++ b/docs/SITE_REFRESH_VERIFICATION.md
@@ -0,0 +1,133 @@
+# Public website refresh, 2026-11-07
+
+Scope: the three static GitHub Pages pages and their shared stylesheet/script.
+Base: `a1307b621b28b5c677fa88d5793bb4d8f43726f1`. Scientific code, evidence,
+experiment results and acceptance criteria are outside this change.
+
+## Direction and sources
+
+The incumbent serif/dark/wave identity is retained, with a split introduction and
+interactive model, a charcoal/amber palette, clearer controls and evidence
+hierarchy, and a method list instead of three feature cards. Reasons and motion
+dials are recorded in [DESIGN.md](DESIGN.md).
+
+User-requested guides were read from these source revisions:
+
+- [taste-skill](https://github.com/Leonxlnx/taste-skill), `f6b7657`.
+- [Impeccable](https://github.com/pbakaus/impeccable), `687bc38`.
+- [anti-slop](https://github.com/miqdadbadjuber/anti-slop), `9504989`, during mode
+ selected by the user in this session.
+
+No new images, brand marks, client claims, testimonials, accounts or dependencies
+were added to the website. Fonts remain local. Existing scientific captions and
+qualifications are retained.
+
+## Rendered and interaction verification
+
+Chromium 1243 was run locally against an HTTP-served checkout. The system
+browser adapter supplied `--no-sandbox` because this host does not support the
+browser's default namespace sandbox. No skill source was modified.
+
+- All three pages: 320x800, 390x844, 768x1024, 820x1180, 1024x768 and 1440x900.
+ Eighteen layouts passed root-overflow and content-boundary checks. Command
+ examples scroll inside their own focusable region.
+- 103 interaction observations passed at mobile and desktop widths, with zero
+ unexpected browser console errors or JavaScript exceptions.
+- Every figure on every page opens its actual original, loads, closes with both
+ Escape and the Close button, and returns focus to its link.
+- Both simulations: play, pause, replay, timeline scrubbing and keyboard changes
+ to speed/distance update the curve and named readouts.
+- Every local navigation, section link and page transition was clicked. All
+ nine distinct external URLs returned HTTP 200; external anchors were not
+ verified as destinations within the GitHub page.
+- The physics disclosure opens with the pointer and closes by keyboard.
+- Delayed original image: visible loading status followed by the actual figure.
+ Blocked original image: recovery text, original-image link and working close.
+ The deliberately blocked request's console error is recorded separately.
+- Reduced motion: the simulation starts still and accepts explicit playback;
+ the entrance and hover transitions are disabled.
+- Normal motion: automatic playback advances, stops advancing offscreen and
+ resumes when the model returns. Switching the preference to reduced motion
+ stops playback and removes the entrance animation.
+- With JavaScript disabled: headings, explanatory SVG, content and original
+ figure links remain; unavailable enhancement controls stay hidden.
+- Axe-core WCAG 2 A/AA and 2.1 AA: zero detected violations across all three
+ pages at 390 and 1440 pixels. The scan found and prompted the keyboard fix
+ for the mobile command region. Automated scans do not certify accessibility.
+- `node --check docs/site.js` and `git diff --check` passed.
+- Taste's local performance run (three runs per size, 1440 and 390): zero FAILs
+ and one WARN for the existing 457.9 KiB full-resolution Livermore WebP. Total
+ measured transfer was 589.3 KiB on desktop and 210.9 KiB on mobile; the mobile
+ figure variant was 90.4 KiB. No broken requests, measured layout shift or long
+ tasks were recorded in that local run. These are lab observations, not field
+ performance claims. Original scientific plot assets were retained.
+
+Local screenshots, per-interaction receipts, accessibility results and link
+responses are in `/home/cinna/dopplergeist-site-refresh-preview/`. These are
+website checks, not validation of geolocation accuracy. Scientific tests were
+not rerun for this static-site change. Field Web Vitals were not measured.
+
+## Anti-slop delivery gate
+
+Each line records a scoped check of the changed interface.
+
+- R-02 PASS: new interface copy contains no em dash; original metadata is preserved.
+- R-03 PASS: eighteen layouts fit 320 through 1440 pixels; navigation and controls have 44px targets.
+- R-17 PASS: the existing 466-aircraft example remains tied to the linked experiment; no statistics added.
+- R-18 PASS: no testimonials or invented identities.
+- R-23 PASS: existing assets, name and navigation are retained; layout work is within the user's refresh request.
+- R-24 PASS: all local navigation destinations were clicked and resolved.
+- R-25 PASS: six axe A/AA scans found no contrast violations; hover/focus colors were inspected.
+- R-26 PASS: 103 recorded interaction checks; no new dead controls.
+- R-27 PASS: the viewer has unopened, loading, loaded and recoverable error states.
+- R-28 PASS: no FAQ added.
+- R-32 PASS: skip link, sliders, disclosure and dialog keyboard paths verified; visible focus retained.
+- R-33 PASS: UI changes were written directly in the source; no source-rewriting helper shipped.
+- R-34 PASS: one fixed theme, consistent across all three pages; no theme toggle.
+- R-35 PASS: HTTP-served Chromium run, clicked local navigation and controls, zero unexpected console errors.
+- R-36 PASS: no invented claims or measured-performance numbers.
+- R-37 PASS: incumbent direction and explicit dials recorded before UI edits in DESIGN.md.
+- R-38 PASS: original research content and plot assets preserved; no fabricated content.
+- R-39 PASS: native controls, labels, focus, image alternatives and reduced-motion handling verified.
+- R-40 PASS: images retain dimensions, scripts defer, fonts are local, no third-party runtime scripts added.
+- R-01 PASS: flat charcoal surfaces and amber signal emphasis; no decorative gradients/glows.
+- R-04 PASS: existing aircraft/microphone geometry explains the model; no generic icon set added.
+- R-06 PASS: retained editorial serif and readable sans; measurement labels identify axes and controls.
+- R-07 PASS: wavefronts exist inside the simulation; no decorative page grid.
+- R-08 PASS: primary action is text; retained arrows denote destinations or diagram direction.
+- R-09 PASS: no badges added.
+- R-10 PASS: no glass or backdrop blur.
+- R-12 PASS: no floating card shadows.
+- R-13 PASS: no glow layer.
+- R-14 PASS: research figures and a method list replace a uniform feature-card rhythm.
+- R-19 PASS: one brief introduction and explicit simulation playback; no scroll reveals.
+- R-22 PASS: only the existing domain model and actual experiment imagery.
+- R-05 PASS: existing research narrative; split model, evidence figures and method list have different composition.
+- R-11 PASS: 12px frames and 4px controls; no pill system.
+- R-15 PASS: primary action says Read the method and opens that page.
+- R-16 PASS: no new marketing buzzwords.
+- R-20 PASS: the physical wave/curve instrument and actual aircraft evidence anchor the identity.
+- R-21 PASS: dark canvas preserves the incumbent world and continuity with measurement figures.
+- R-29 PASS: neutral surfaces, paper text and one amber accent; plot data retains original colors.
+- R-30 PASS: no reference website cloned.
+- R-31 PASS: one-line reasons for palette, layout, type, spacing, containers, imagery and motion in DESIGN.md.
+- Liveliness PASS: ENERGY 2 / RHYTHM 3 / MOTION 2; the instrument is the focal point and identity motif.
+- C-1..C-5 PASS: documented decisions, working controls, real content, responsive/keyboard paths and factual claims.
+
+## Other guide checks
+
+Impeccable context and its manual detector were run. The detector identified a
+real skip-link hover contrast issue, which was fixed. Its padding warnings
+were checked against computed/rendered padding (24px for method rows and physics
+details, 36px for page transitions). Explicit longhands now express that padding.
+The generic Geist warning is an intentional retention of the incumbent,
+self-hosted type system, as documented in DESIGN.md.
+
+The strict taste-skill template gate ended `GATE: OPEN 35 (rounds used up)`.
+It improved from 46 to 38 to 35 findings across the three allowed rounds. No
+waivers were created. Every remaining finding is recorded in
+[SITE_REFRESH_TASTE_GATE.md](SITE_REFRESH_TASTE_GATE.md), including fixed screen
+geometry, mandatory visuals in prose sections, the original headline, container
+conventions and the retained scientific captions. The guide says to stop fixing
+after the third round. This gate is open, independently of the passing browser
+and accessibility checks; the proposed change is left unmerged for review.
diff --git a/docs/examples.html b/docs/examples.html
index 828b6aa..87f8bd1 100644
--- a/docs/examples.html
+++ b/docs/examples.html
@@ -1,16 +1,18 @@
<!doctype html>
-<html lang="en">
+<html lang="en" data-type="software">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="theme-color" content="#090e21">
+<meta name="page-type" content="software">
+<meta name="site-kind" content="software">
+<meta name="theme-color" content="#121816">
<title>Audio Geolocation Examples — DOPPLERGEIST</title>
<meta name="description" content="Real aircraft recordings analyzed with DOPPLERGEIST. Browse Doppler spectrograms, flight-path fits and geographic search results from the repository.">
<meta name="robots" content="index,follow,max-image-preview:large">
<link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/examples.html">
<link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>
-<link rel="stylesheet" href="site.css?v=3">
-<script src="site.js?v=3" defer></script>
+<link rel="stylesheet" href="site.css?v=4">
+<script src="site.js?v=4" defer></script>
<link rel="icon" href="site-media/favicon.svg" type="image/svg+xml">
<meta property="og:type" content="website">
<meta property="og:site_name" content="DOPPLERGEIST">
diff --git a/docs/how-it-works.html b/docs/how-it-works.html
index 4d7f0a6..be220b8 100644
--- a/docs/how-it-works.html
+++ b/docs/how-it-works.html
@@ -1,16 +1,18 @@
<!doctype html>
-<html lang="en">
+<html lang="en" data-type="software">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="theme-color" content="#090e21">
+<meta name="page-type" content="software">
+<meta name="site-kind" content="software">
+<meta name="theme-color" content="#121816">
<title>How Aircraft Doppler Audio Geolocation Works — DOPPLERGEIST</title>
<meta name="description" content="How DOPPLERGEIST locates audio: detect Doppler frequency ridges, match historical ADS-B flight paths, model sound propagation and search for the microphone.">
<meta name="robots" content="index,follow,max-image-preview:large">
<link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/how-it-works.html">
<link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>
-<link rel="stylesheet" href="site.css?v=3">
-<script src="site.js?v=3" defer></script>
+<link rel="stylesheet" href="site.css?v=4">
+<script src="site.js?v=4" defer></script>
<link rel="icon" href="site-media/favicon.svg" type="image/svg+xml">
<meta property="og:type" content="website">
<meta property="og:site_name" content="DOPPLERGEIST">
@@ -41,7 +43,7 @@
<svg class="doppler-scene" viewBox="0 0 1080 490" role="img" aria-labelledby="demo-title demo-desc">
<title id="demo-title">How motion changes the pitch at a microphone</title>
<desc id="demo-desc">An aircraft moves from left to right, emitting evenly timed sound waves. Waves are closer together ahead and farther apart behind. The received pitch drops as the aircraft passes. The diagram includes sound travel time and illustrates a constant tone and speed; it is not recorded data.</desc>
-<defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath><linearGradient id="curve-color"><stop stop-color="#bba6fa"/><stop offset="1" stop-color="#79e2d1"/></linearGradient></defs>
+<defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath></defs>
<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="402.86" cy="105" r="42.00"/><circle cx="383.27" cy="105" r="98.00"/><circle cx="363.67" cy="105" r="154.00"/><circle cx="344.08" cy="105" r="210.00"/><circle cx="324.49" cy="105" r="266.00"/><circle cx="304.90" cy="105" r="322.00"/><circle cx="285.31" cy="105" r="378.00"/><circle cx="265.71" cy="105" r="434.00"/><circle cx="246.12" cy="105" r="490.00"/><circle cx="226.53" cy="105" r="546.00"/><circle cx="206.94" cy="105" r="602.00"/><circle cx="187.35" cy="105" r="658.00"/></g>
<path class="sound-link" data-sound-link d="M417.55 105L540 268.27"/>
<g class="aircraft" data-plane transform="translate(417.55 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>
@@ -55,7 +57,7 @@
</svg>
<div class="demo-controls" hidden>
<div class="demo-transport"><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label"><span>Flyover position</span><input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><div class="pitch-readout"><output data-pitch aria-live="off">Higher pitch</output><span class="demo-phase" data-phase>Approaching · higher pitch</span></div></div>
-<div class="demo-parameters"><label><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>
+<div class="demo-parameters"><label for="demo-speed"><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label for="demo-distance"><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>
</div>
</div><details class="physics-detail"><summary>The physics behind the curve</summary><div><p>For a steady source tone and a stationary microphone, the received frequency is <code>f = f₀ c / (c + vᵣ)</code>. Here <code>f₀</code> is the source frequency, <code>c</code> is sound speed, and <code>vᵣ</code> is radial velocity at emission, positive when moving away.</p><p>Sound emitted at time <code>τ</code> arrives at <code>t = τ + r(τ) / c</code>. The model solves for that emission time before calculating the pitch. The sound of closest approach arrives after the aircraft has passed.</p><a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/docs/METHODOLOGY.md#physical-model-and-sign-convention">Read the physical model ↗</a></div></details></section>
<nav class="page-jumps wrap" aria-label="On this page"><a href="#hear">Detect</a><a href="#flight">Match</a><a href="#search">Locate</a><a href="#run">Run locally</a></nav>
@@ -69,7 +71,7 @@
<figure class="evidence-figure"><div class="figure-heading"><span>The candidate map</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/location-scores.png" aria-label="View full-size image: Scored microphone positions on a geographic grid, with the highest score marked by a star"><img src="site-media/location-scores.webp" srcset="site-media/location-scores-960.webp 960w, site-media/location-scores.webp 1120w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1120" height="960" loading="lazy" decoding="async" alt="Scored microphone positions on a geographic grid, with the highest score marked by a star"></a><figcaption>Color encodes fit score, not location probability.</figcaption></figure>
</section>
<section class="section wrap setup" aria-labelledby="run"><h2 id="run">Run it locally.</h2><p>Install Python 3.11 or later and FFmpeg, then start the local upload interface.</p>
-<pre><code>git clone https://github.com/1337isnot1337/DOPPLERGEIST.git
+<pre tabindex="0" role="region" aria-label="Local installation commands"><code>git clone https://github.com/1337isnot1337/DOPPLERGEIST.git
cd DOPPLERGEIST
python -m venv .venv
.venv/bin/python -m pip install .
diff --git a/docs/index.html b/docs/index.html
index 6a31d1b..18b1d21 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,16 +1,19 @@
<!doctype html>
-<html lang="en">
+<html lang="en" data-type="software">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta name="theme-color" content="#090e21">
+<meta name="page-type" content="software">
+<meta name="site-kind" content="software">
+<script>document.documentElement.classList.add('m-enter');</script>
+<meta name="theme-color" content="#121816">
<title>DOPPLERGEIST — Aircraft Doppler Audio Geolocation</title>
<meta name="description" content="Find where audio was recorded using aircraft Doppler shifts and historical ADS-B flight tracks. Explore DOPPLERGEIST’s real recordings, spectrograms and location maps.">
<meta name="robots" content="index,follow,max-image-preview:large">
<link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/">
<link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>
-<link rel="stylesheet" href="site.css?v=3">
-<script src="site.js?v=3" defer></script>
+<link rel="stylesheet" href="site.css?v=4">
+<script src="site.js?v=4" defer></script>
<link rel="icon" href="site-media/favicon.svg" type="image/svg+xml">
<meta property="og:type" content="website">
<meta property="og:site_name" content="DOPPLERGEIST">
@@ -28,7 +31,7 @@
<meta name="twitter:image:alt" content="Aircraft Doppler spectrogram and satellite map from the real Livermore recording">
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#website","url":"https://1337isnot1337.github.io/DOPPLERGEIST/","name":"DOPPLERGEIST"},{"@type":"WebPage","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#page","url":"https://1337isnot1337.github.io/DOPPLERGEIST/","name":"DOPPLERGEIST — Aircraft Doppler Audio Geolocation","description":"Find where audio was recorded using aircraft Doppler shifts and historical ADS-B flight tracks. Explore DOPPLERGEIST’s real recordings, spectrograms and location maps.","isPartOf":{"@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#website"},"primaryImageOfPage":{"@type":"ImageObject","contentUrl":"https://1337isnot1337.github.io/DOPPLERGEIST/site-media/livermore-automatic-mp3.png"}},{"@type":"SoftwareSourceCode","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#software","name":"DOPPLERGEIST","description":"Audio geolocation software that matches aircraft Doppler signatures to historical ADS-B flight trajectories.","codeRepository":"https://github.com/1337isnot1337/DOPPLERGEIST","programmingLanguage":"Python","runtimePlatform":"Python 3.11 or later","license":"https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/LICENSE","author":{"@type":"Person","name":"Cinna Davis","url":"https://github.com/1337isnot1337"}}]}</script>
</head>
-<body>
+<body class="home">
<a class="skip" href="#main">Skip to content</a>
<header class="site-header wrap">
<a class="brand" href="./" aria-label="DOPPLERGEIST home">DOPPLERGEIST</a>
@@ -36,14 +39,14 @@
</header>
<main id="main">
-<section class="hero wrap">
-<p class="eyebrow">Aircraft audio geolocation</p>
-<div class="hero-copy"><h1>A flight leaves<br>a trace <span>in sound.</span></h1><div><p>DOPPLERGEIST uses the changing pitch of passing aircraft and historical flight paths to search for where a recording was made.</p><div class="hero-links"><a class="text-link" href="how-it-works.html">Explore the method <span aria-hidden="true">→</span></a><a href="examples.html">See real recordings</a></div></div></div>
+<section class="hero wrap" data-enter>
+<div class="hero-copy"><h1>A flight leaves<br>a trace <span>in sound.</span></h1><p class="hero-category">Aircraft audio geolocation</p><div><p>DOPPLERGEIST uses the changing pitch of passing aircraft and historical flight paths to search for where a recording was made.</p><div class="hero-links"><a class="button-link" href="how-it-works.html">Read the method</a><a href="examples.html">See real recordings</a></div></div></div>
<div class="doppler-demo" data-doppler>
+<div class="instrument-heading"><span>The Doppler effect</span><span>Interactive model</span></div>
<svg class="doppler-scene" viewBox="0 0 1080 490" role="img" aria-labelledby="demo-title demo-desc">
<title id="demo-title">How motion changes the pitch at a microphone</title>
<desc id="demo-desc">An aircraft moves from left to right, emitting evenly timed sound waves. Waves are closer together ahead and farther apart behind. The received pitch drops as the aircraft passes. The diagram includes sound travel time and illustrates a constant tone and speed; it is not recorded data.</desc>
-<defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath><linearGradient id="curve-color"><stop stop-color="#bba6fa"/><stop offset="1" stop-color="#79e2d1"/></linearGradient></defs>
+<defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath></defs>
<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="402.86" cy="105" r="42.00"/><circle cx="383.27" cy="105" r="98.00"/><circle cx="363.67" cy="105" r="154.00"/><circle cx="344.08" cy="105" r="210.00"/><circle cx="324.49" cy="105" r="266.00"/><circle cx="304.90" cy="105" r="322.00"/><circle cx="285.31" cy="105" r="378.00"/><circle cx="265.71" cy="105" r="434.00"/><circle cx="246.12" cy="105" r="490.00"/><circle cx="226.53" cy="105" r="546.00"/><circle cx="206.94" cy="105" r="602.00"/><circle cx="187.35" cy="105" r="658.00"/></g>
<path class="sound-link" data-sound-link d="M417.55 105L540 268.27"/>
<g class="aircraft" data-plane transform="translate(417.55 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>
@@ -57,7 +60,7 @@
</svg>
<div class="demo-controls" hidden>
<div class="demo-transport"><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label"><span>Flyover position</span><input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><div class="pitch-readout"><output data-pitch aria-live="off">Higher pitch</output><span class="demo-phase" data-phase>Approaching · higher pitch</span></div></div>
-<div class="demo-parameters"><label><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>
+<div class="demo-parameters"><label for="demo-speed"><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label for="demo-distance"><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>
</div>
</div>
</section>
@@ -73,9 +76,9 @@
<section class="section wrap" aria-labelledby="flyovers">
<div class="section-intro"><h2 id="flyovers">More flyovers. One location.</h2><p>DOPPLERGEIST scans the whole recording and fits independent flyovers to a shared microphone position and clock.</p></div>
<figure class="evidence-figure"><div class="figure-heading"><span>Across the recording</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/discovery-overview.png" aria-label="View full-size image: Automatically detected moving-frequency traces spread across an hour-long recording"><img src="site-media/discovery-overview.webp" srcset="site-media/discovery-overview-960.webp 960w, site-media/discovery-overview.webp 1560w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1560" height="650" loading="lazy" decoding="async" alt="Automatically detected moving-frequency traces spread across an hour-long recording"></a><figcaption>Moving-frequency proposals found by the detector; proposals are not confirmed aircraft.</figcaption></figure>
-<p class="section-link"><a href="examples.html">See the example gallery <span aria-hidden="true">↗</span></a></p>
+<p class="section-link"><a href="examples.html">See the example gallery</a></p>
</section>
-<section class="closing wrap"><h2>Start with a recording.</h2><p>Run DOPPLERGEIST locally with your audio and its recording-time window.</p><a class="text-link" href="how-it-works.html#run">Get DOPPLERGEIST <span aria-hidden="true">↗</span></a></section>
+<section class="closing wrap"><h2>Start with a recording.</h2><p>Run DOPPLERGEIST locally with your audio and its recording-time window.</p><a class="button-link" href="how-it-works.html#run">Get DOPPLERGEIST</a></section>
</main>
<footer class="wrap">
diff --git a/docs/site.css b/docs/site.css
index 5555195..65ef192 100644
--- a/docs/site.css
+++ b/docs/site.css
@@ -1,177 +1,232 @@
@font-face { font-family: "Geist Serif"; src: url("site-fonts/GeistSerif-Regular.woff2") format("woff2"); font-style: normal; font-weight: 400; font-display: swap; }
@font-face { font-family: "Geist"; src: url("site-fonts/Geist-Regular.woff2") format("woff2"); font-style: normal; font-weight: 400; font-display: swap; }
-:root { color-scheme: dark; --bg: #090e21; --surface: #10172b; --text: #f7f1ff; --muted: #b5bdd4; --lilac: #bba6fa; --mint: #79e2d1; --line: #2b344f; }
+:root {
+ color-scheme: dark;
+ --bg: #121816;
+ --surface: #19221e;
+ --text: #f3f0e7;
+ --muted: #b3bdb5;
+ --accent: #f2b57f;
+ --line: #3a4940;
+ --radius: 12px;
+ --ease: cubic-bezier(.16, 1, .3, 1);
+}
* { box-sizing: border-box; }
-html { scroll-behavior: smooth; scroll-padding-top: 32px; }
+html { scroll-behavior: auto; scroll-padding-top: 32px; scrollbar-color: var(--line) var(--bg); }
body { margin: 0; background: var(--bg); color: var(--text); font: 400 18px/1.65 "Geist", Arial, sans-serif; -webkit-font-smoothing: antialiased; }
h1, h2, .brand { font-family: "Geist Serif", Georgia, serif; font-weight: 400; }
h1, h2, h3, p, figure { margin: 0; }
-h1 { font-size: clamp(56px, 6.6vw, 94px); line-height: 1.06; letter-spacing: -.035em; text-wrap: balance; }
-h1 span { color: var(--lilac); }
-h2 { font-size: clamp(36px, 4vw, 56px); line-height: 1.14; letter-spacing: -.025em; text-wrap: balance; }
-h3 { font-size: 21px; font-weight: 400; }
-a { color: inherit; text-underline-offset: .25em; text-decoration-thickness: 1px; }
-a:hover { color: var(--mint); }
-:focus-visible { outline: 2px solid var(--mint); outline-offset: 6px; }
+h1 { font-size: clamp(56px, 6.6vw, 94px); line-height: 1.04; letter-spacing: -.035em; text-wrap: balance; }
+h1 span { color: var(--accent); }
+h2 { font-size: clamp(36px, 4vw, 56px); line-height: 1.12; letter-spacing: -.025em; text-wrap: balance; }
+h3 { font-size: 22px; line-height: 1.35; font-weight: 400; }
+a { color: inherit; text-underline-offset: .3em; text-decoration-thickness: 1px; transition: color .2s, border-color .2s; }
+a:hover { color: var(--accent); }
+a, button, summary, label[for] { cursor: pointer; }
+a:active, button:active { transform: translateY(1px); }
+:focus-visible { outline: 2px solid var(--accent); outline-offset: 5px; }
img { display: block; max-width: 100%; height: auto; }
button, input { font: inherit; }
-button { cursor: pointer; }
+button { cursor: pointer; transition: background .2s, color .2s, transform .2s var(--ease); }
+button:disabled, input:disabled { cursor: not-allowed; opacity: .5; }
[hidden] { display: none !important; }
-::selection { background: var(--lilac); color: var(--bg); }
-.wrap { width: min(1200px, calc(100% - 112px)); margin-inline: auto; }
-.skip { position: absolute; top: 12px; left: 12px; transform: translateY(-180%); z-index: 5; background: var(--mint); color: var(--bg); padding: 10px 20px; }
+::selection { background: var(--accent); color: var(--bg); }
+.wrap { width: min(1280px, calc(100% - 112px)); margin-inline: auto; }
+.skip { position: absolute; top: 12px; left: 12px; transform: translateY(-180%); z-index: 5; background: var(--accent); color: var(--bg); padding: 10px 20px; }
.skip:focus { transform: none; }
-.site-header { min-height: 98px; display: flex; align-items: center; justify-content: space-between; gap: 32px; border-bottom: 1px solid var(--line); }
-.brand { font-size: 25px; letter-spacing: .015em; text-decoration: none; }
-nav { display: flex; gap: 28px; align-items: center; font-size: 14px; }
-nav a { text-decoration: none; padding-block: 10px; }
-nav a[aria-current="page"] { color: var(--mint); text-decoration: underline; text-underline-offset: 8px; }
-.nav-repo { border-left: 1px solid var(--line); padding-left: 28px; }
-.hero { padding-top: 62px; }
-.eyebrow { color: var(--muted); font-size: 12px; letter-spacing: .13em; text-transform: uppercase; }
-.hero-copy { display: grid; grid-template-columns: 1.35fr 1fr; gap: 6%; align-items: end; margin-top: 24px; }
-.hero-copy h1 { font-size: clamp(54px, 5.6vw, 80px); }
-.hero-copy > div { padding-bottom: 7px; }
-.hero-copy p { color: var(--muted); max-width: 470px; font-size: 19px; }
-.hero-links { display: flex; flex-wrap: wrap; align-items: center; gap: 16px 26px; margin-top: 24px; font-size: 15px; }
-.hero-links > a:last-child { text-decoration-color: var(--line); }
+.skip:hover { color: var(--bg); text-decoration: underline; }
+.site-header { min-height: 88px; display: flex; align-items: center; justify-content: space-between; gap: 32px; border-bottom: 1px solid var(--line); }
+.brand { display: inline-flex; align-items: center; min-height: 44px; font-size: 24px; letter-spacing: .01em; text-decoration: none; white-space: nowrap; }
+nav { display: flex; gap: 32px; align-items: center; font-size: 14px; }
+nav a { display: inline-flex; align-items: center; min-height: 44px; text-decoration: none; }
+nav a[aria-current="page"] { color: var(--accent); text-decoration: underline; text-underline-offset: 10px; }
+.nav-repo { border: 1px solid var(--line); border-radius: 4px; padding-inline: 18px; gap: 12px; }
+.nav-repo:hover { border-color: var(--accent); }
+/* The explanation and its instrument share the first screen. */
+.hero { display: grid; grid-template-columns: .95fr 1.2fr; align-items: center; gap: 5%; min-height: calc(100svh - 88px); padding-block: 56px 72px; }
+.hero-copy { min-width: 0; }
+.hero-copy h1 { font-size: clamp(60px, 5.6vw, 82px); }
+.hero-category { margin-block: 28px 12px; color: var(--accent); font-size: 15px; }
+.hero-copy > div > p { color: var(--muted); max-width: 43ch; font-size: 18px; }
+.hero-links { display: flex; flex-wrap: wrap; align-items: center; gap: 14px 24px; margin-top: 32px; font-size: 15px; }
+.hero-links > a:last-child { min-height: 48px; display: inline-flex; align-items: center; text-decoration-color: var(--line); }
+.button-link { display: inline-flex; align-items: center; justify-content: center; min-height: 48px; border: 1px solid var(--accent); border-radius: 4px; padding: 10px 20px; background: var(--accent); color: var(--bg); text-decoration: none; transition: background .2s, transform .2s var(--ease); }
+.button-link:hover { background: var(--text); border-color: var(--text); color: var(--bg); transform: translateY(-2px); }
+.button-link:active { transform: translateY(1px); }
.section { padding-top: 104px; }
-.section-intro { margin-bottom: 32px; }
-.section-intro p { color: var(--muted); max-width: 690px; margin-top: 20px; }
-.evidence-figure { min-width: 0; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); padding: 0 16px; }
-.figure-heading { display: flex; justify-content: space-between; gap: 16px; color: var(--muted); font-size: 13px; padding: 14px 2px; }
-.figure-link { display: block; cursor: zoom-in; background: #fbfaf7; border-radius: 3px; overflow: hidden; }
-.figure-link img { width: 100%; }
+.section-intro { display: grid; grid-template-columns: 1fr .9fr; gap: 8%; align-items: end; margin-bottom: 40px; }
+.section-intro p { color: var(--muted); max-width: 65ch; }
+.evidence-figure { min-width: 0; background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius); padding: 0 16px; overflow: hidden; }
+.figure-heading { display: flex; justify-content: space-between; align-items: center; gap: 16px; color: var(--muted); font-size: 13px; padding: 16px 4px; }
+.figure-link { display: block; cursor: zoom-in; background: #fbfaf7; border-radius: 4px; overflow: hidden; }
+.figure-link img { width: 100%; transition: transform .5s var(--ease); }
+.figure-link:hover img { transform: scale(1.02); }
.figure-link:focus-visible { outline-offset: 3px; }
-figcaption { padding: 16px 2px 18px; font-size: 14px; line-height: 1.6; color: var(--muted); }
+figcaption { padding: 18px 4px; font-size: 14px; line-height: 1.6; color: var(--muted); }
.pair { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; align-items: start; }
-.section-link { margin-top: 24px; font-size: 16px; }
-.section-link a, .text-link { color: var(--mint); text-decoration: none; display: inline-block; border-bottom: 1px solid var(--mint); padding-bottom: 4px; }
+.section-link { margin-top: 20px; font-size: 16px; }
+.section-link a, .text-link { color: var(--accent); text-decoration: none; display: inline-flex; align-items: center; gap: 12px; min-height: 44px; border-bottom: 1px solid var(--line); }
.section-link a:hover, .text-link:hover { color: var(--text); border-color: var(--text); }
-.method-summary { margin-top: 96px; border-top: 1px solid var(--line); padding-top: 58px; }
-.method-steps { display: grid; grid-template-columns: repeat(3, 1fr); gap: 40px; list-style: none; padding: 0; margin: 42px 0 0; counter-reset: step; }
-.method-steps li { border-top: 1px solid var(--line); padding-top: 22px; counter-increment: step; }
-.method-steps h3::before { content: "0" counter(step) " / "; color: var(--lilac); font-size: 13px; margin-right: 6px; }
-.method-steps p { margin-top: 14px; font-size: 16px; color: var(--muted); }
-.closing { padding-block: 100px; }
-.closing p { margin: 21px 0 28px; color: var(--muted); max-width: 600px; }
+.method-summary { margin-top: 104px; border-top: 1px solid var(--line); padding-top: 88px; }
+.method-summary .section-intro { grid-template-columns: 1fr; }
+.method-summary .section-intro p { max-width: 620px; margin-top: 24px; }
+.method-steps { list-style: none; padding: 0; margin: 48px 0 0; }
+.method-steps li { display: grid; grid-template-columns: 1fr 1.1fr; gap: 8%; border-top: 1px solid var(--line); padding-top: 24px; padding-bottom: 24px; }
+.method-steps p { max-width: 48ch; font-size: 16px; color: var(--muted); }
+.closing { padding-block: 120px 104px; }
+.closing h2 { max-width: 780px; }
+.closing p { margin: 24px 0 28px; color: var(--muted); max-width: 600px; }
footer { border-top: 1px solid var(--line); padding-block: 30px 40px; display: flex; justify-content: space-between; align-items: center; gap: 30px; }
footer nav { font-size: 13px; color: var(--muted); }
-.page-heading { padding-top: 72px; }
+.page-heading { padding-top: 88px; }
.page-heading h1 { max-width: 1120px; }
-.page-heading p { color: var(--muted); font-size: 20px; max-width: 720px; margin-top: 25px; }
+.page-heading p { color: var(--muted); font-size: 20px; max-width: 720px; margin-top: 28px; }
.page-jumps { margin-top: 44px; border-bottom: 1px solid var(--line); padding-bottom: 12px; gap: 32px; flex-wrap: wrap; }
.first { padding-top: 64px; }
.separate-figure { margin-top: 32px; }
.location-section { display: grid; grid-template-columns: .85fr 1.15fr; gap: 7%; align-items: center; }
-.location-section p { margin-top: 22px; color: var(--muted); }
+.location-section p { margin-top: 24px; color: var(--muted); }
.location-section .text-link { margin-top: 26px; }
.setup > p { margin-block: 24px; max-width: 720px; color: var(--muted); }
code { font-family: "SFMono-Regular", Consolas, monospace; font-size: .87em; }
-pre { margin-block: 28px; padding: 28px; overflow-x: auto; background: var(--surface); border: 1px solid var(--line); border-left: 2px solid var(--lilac); border-radius: 3px; line-height: 1.9; }
-.source-link { margin-top: 42px; color: var(--mint); font-size: 16px; }
-.next-page { display: flex; justify-content: space-between; gap: 24px; border-top: 1px solid var(--line); padding-block: 36px 60px; margin-top: 80px; }
+pre { margin-block: 28px; padding: 28px; overflow-x: auto; background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius); line-height: 1.9; }
+.source-link { margin-top: 42px; color: var(--accent); font-size: 16px; }
+.source-link a { display: inline-flex; align-items: center; min-height: 44px; }
+.next-page { display: flex; justify-content: space-between; gap: 24px; border-top: 1px solid var(--line); padding-top: 36px; padding-bottom: 60px; margin-top: 88px; }
.next-page > span { font-size: 15px; color: var(--muted); }
-.next-page > a { font-family: "Geist Serif", Georgia, serif; font-size: 25px; text-decoration: none; }
-/* The illustration shares the site's palette and retains a useful static state. */
-.doppler-demo { margin-top: 40px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); overflow: hidden; }
-.demo-phase { color: var(--mint); font-size: 13px; }
+.next-page > a { font-family: "Geist Serif", Georgia, serif; font-size: 28px; text-decoration: none; }
+/* Wave geometry is the identity motif, not a decorative background. */
+.doppler-demo { min-width: 0; margin-top: 40px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); overflow: hidden; }
+.hero .doppler-demo { margin-top: 0; }
+.instrument-heading { display: flex; justify-content: space-between; align-items: center; gap: 20px; border-bottom: 1px solid var(--line); padding: 18px 24px; font-size: 14px; }
+.instrument-heading > span:last-child { color: var(--muted); font-size: 13px; }
+.demo-phase { color: var(--accent); font-size: 13px; }
.doppler-scene { display: block; width: 100%; height: auto; }
-.doppler-scene text { fill: var(--muted); font: 14px "Geist", Arial, sans-serif; letter-spacing: .02em; }
+.doppler-scene text { fill: var(--muted); font: 14px "Geist", Arial, sans-serif; }
+.hero .doppler-scene text { font-size: 22px; }
.flight-line { stroke: var(--line); stroke-dasharray: 5 9; fill: none; }
-.wavefronts { fill: none; stroke: var(--lilac); stroke-opacity: .27; stroke-width: 1.2; }
+.wavefronts { fill: none; stroke: var(--accent); stroke-opacity: .35; stroke-width: 1.4; }
.aircraft { fill: var(--text); }
-.sound-link { fill: none; stroke: var(--lilac); stroke-dasharray: 3 6; opacity: .6; }
-.receiver-halo { fill: var(--bg); stroke: var(--mint); stroke-opacity: .4; }
-.receiver { stroke: var(--mint); fill: none; stroke-width: 2; }
+.sound-link { fill: none; stroke: var(--accent); stroke-dasharray: 3 6; opacity: .6; }
+.receiver-halo { fill: var(--bg); stroke: var(--accent); stroke-opacity: .6; }
+.receiver { stroke: var(--accent); fill: none; stroke-width: 2; }
.chart-grid { stroke: var(--line); fill: none; }
-.pitch-curve { stroke: url(#curve-color); stroke-width: 3; fill: none; }
-.chart-cursor { stroke: var(--mint); stroke-opacity: .45; }
-.pitch-dot { fill: var(--mint); stroke: var(--surface); stroke-width: 3; }
-.demo-controls { padding: 24px 26px; }
-.demo-transport { display: grid; grid-template-columns: auto minmax(0, 1fr) 190px; align-items: center; gap: 28px; }
-.pitch-readout { display: grid; gap: 3px; text-align: right; font-variant-numeric: tabular-nums; }
+.pitch-curve { stroke: var(--accent); stroke-width: 3; fill: none; }
+.chart-cursor { stroke: var(--accent); stroke-opacity: .45; }
+.pitch-dot { fill: var(--accent); stroke: var(--surface); stroke-width: 3; }
+.demo-controls { padding: 24px; }
+.demo-transport { display: grid; grid-template-columns: auto minmax(0, 1fr) 190px; align-items: center; gap: 24px; }
+.pitch-readout { display: grid; min-width: 0; gap: 3px; text-align: right; font-variant-numeric: tabular-nums; }
.pitch-readout output { font-size: 16px; }
-.demo-parameters { display: grid; grid-template-columns: 1fr 1fr; gap: 32px; margin-top: 22px; padding-top: 22px; border-top: 1px solid var(--line); }
+.demo-parameters { display: grid; grid-template-columns: 1fr 1fr; gap: 28px; margin-top: 24px; padding-top: 20px; border-top: 1px solid var(--line); }
.demo-parameters label { min-width: 0; }
.demo-parameters label > span { display: flex; justify-content: space-between; gap: 12px; font-size: 13px; color: var(--muted); }
.demo-parameters output { color: var(--text); font-variant-numeric: tabular-nums; }
+.hero .demo-transport { grid-template-columns: auto 1fr; gap: 16px; }
+.hero .timeline-label { grid-row: 2; grid-column: 1 / -1; margin-top: 4px; }
+.hero .pitch-readout { grid-column: 2; grid-row: 1; }
[data-receiver] { cursor: ns-resize; touch-action: none; }
.receiver-hit { fill: transparent; }
[data-receiver]:hover .receiver-halo { stroke-opacity: 1; }
-.play-button, .viewer-close { border: 1px solid var(--line); border-radius: 4px; padding: 10px 18px; color: var(--text); background: var(--bg); font-size: 14px; min-width: 128px; min-height: 44px; }
-.play-button:hover, .viewer-close:hover { border-color: var(--mint); }
-.timeline-label { min-width: 0; color: var(--muted); font-size: 12px; display: grid; gap: 4px; }
-input[type="range"] { width: 100%; min-width: 60px; accent-color: var(--mint); cursor: ew-resize; min-height: 32px; }
-.physics-detail { border-bottom: 1px solid var(--line); padding-block: 24px; font-size: 16px; }
-.physics-detail summary { cursor: pointer; color: var(--lilac); }
+.play-button, .viewer-close { display: inline-flex; align-items: center; justify-content: center; border: 1px solid var(--line); border-radius: 4px; padding: 10px 18px; color: var(--text); background: transparent; font-size: 14px; min-width: 128px; min-height: 44px; }
+.play-button:hover, .viewer-close:hover { background: var(--accent); color: var(--bg); border-color: var(--accent); transform: translateY(-2px); }
+.play-button:active, .viewer-close:active { transform: translateY(1px); }
+.timeline-label { min-width: 0; color: var(--muted); font-size: 13px; display: grid; gap: 4px; }
+input[type="range"] { width: 100%; min-width: 0; accent-color: var(--accent); cursor: ew-resize; min-height: 44px; margin: 0; }
+.physics-detail { border-bottom: 1px solid var(--line); padding-top: 24px; padding-bottom: 24px; font-size: 16px; }
+.physics-detail summary { cursor: pointer; color: var(--accent); min-height: 44px; align-content: center; }
.physics-detail > div { max-width: 760px; color: var(--muted); padding-top: 18px; }
.physics-detail p + p { margin-top: 15px; }
-.physics-detail a { display: inline-block; margin-top: 18px; }
-/* Native modal provides Escape, focus containment and focus restoration. */
-.figure-viewer { width: min(1500px, 96vw); max-height: 94dvh; padding: 20px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); color: var(--text); }
-.figure-viewer::backdrop { background: rgb(4 7 17 / .9); }
+.physics-detail a { display: inline-block; margin-top: 18px; min-height: 44px; }
+/* Native dialogs retain Escape, focus containment and focus restoration. */
+.figure-viewer { width: min(1500px, 96vw); max-height: 94dvh; padding: 24px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); color: var(--text); }
+.figure-viewer::backdrop { background: rgb(8 12 10 / .92); }
.viewer-toolbar { display: flex; gap: 24px; align-items: center; justify-content: space-between; margin-bottom: 18px; }
.viewer-toolbar p { font-size: 16px; }
-.figure-viewer img { max-height: 70dvh; width: auto; margin-inline: auto; object-fit: contain; }
-.viewer-caption { font-size: 14px; color: var(--muted); margin-top: 18px; }
-.viewer-original { display: inline-block; font-size: 14px; color: var(--mint); margin-top: 12px; }
+.figure-viewer img { max-height: 65dvh; width: auto; margin-inline: auto; object-fit: contain; }
+.figure-viewer[aria-busy="true"] img { visibility: hidden; }
+.viewer-status, .viewer-caption { font-size: 14px; color: var(--muted); margin-top: 18px; }
+.viewer-original { display: inline-flex; align-items: center; min-height: 44px; font-size: 14px; color: var(--accent); margin-top: 12px; }
body:has(.figure-viewer[open]) { overflow: hidden; }
-@media (max-width: 1000px) { .hero-copy { grid-template-columns: 1fr; gap: 24px; } .hero-copy p { max-width: 690px; } .hero-links { margin-top: 18px; } }
+@keyframes instrument-enter { from { opacity: .7; transform: translateY(16px); } to { opacity: 1; transform: none; } }
+@media (prefers-reduced-motion: no-preference) { html.m-enter .hero[data-enter] > * { animation: instrument-enter .8s var(--ease) both; } .hero .doppler-demo { animation-delay: .1s; } }
+@media (min-width: 1101px) { .home .section { min-height: 100svh; padding-block: 88px 72px; } .home .method-summary { margin-top: 0; } }
+@media (max-width: 1100px) {
+ .hero { grid-template-columns: 1fr; gap: 40px; }
+ .hero-copy { display: grid; grid-template-columns: 1fr 1fr; align-items: end; gap: 24px 40px; }
+ .hero-category { grid-column: 1 / -1; grid-row: 1; margin: 0; }
+ .hero-copy h1 { grid-column: 1; grid-row: 2; }
+ .hero-copy > div { grid-column: 2; grid-row: 2; }
+ .hero-copy h1 { font-size: clamp(54px, 6.4vw, 72px); }
+ .hero .doppler-scene { max-height: 360px; }
+ .hero .doppler-scene text { font-size: 22px; }
+ .hero .demo-transport { grid-template-columns: auto minmax(0, 1fr) 190px; gap: 24px; }
+ .hero .timeline-label { grid-row: 1; grid-column: 2; margin: 0; }
+ .hero .pitch-readout { grid-row: 1; grid-column: 3; }
+}
@media (max-width: 900px) {
.wrap { width: calc(100% - 64px); }
.site-header { gap: 20px; }
- nav { gap: 18px; }
- .nav-repo { padding-left: 18px; }
+ nav { gap: 20px; }
.brand { font-size: 22px; }
- .hero, .page-heading { padding-top: 48px; }
- .section { padding-top: 72px; }
- .method-summary { margin-top: 72px; padding-top: 42px; }
- .method-steps { gap: 24px; }
+ .hero, .page-heading { padding-top: 56px; }
+ .section { padding-top: 80px; }
+ .section-intro { gap: 32px; }
+ .method-summary { margin-top: 80px; padding-top: 64px; }
.location-section { gap: 32px; grid-template-columns: 1fr 1fr; }
footer { align-items: start; }
- footer nav { flex-wrap: wrap; justify-content: flex-end; gap: 12px 20px; }
+ footer nav { flex-wrap: wrap; justify-content: flex-end; gap: 8px 20px; }
}
@media (max-width: 700px) {
body { font-size: 17px; }
.wrap { width: calc(100% - 40px); }
- .site-header { padding-block: 20px 12px; min-height: 0; flex-wrap: wrap; gap: 10px; }
- .site-header nav { width: 100%; justify-content: space-between; gap: 12px; font-size: 13px; }
- .nav-repo { border-left: 0; padding-left: 0; }
- .hero, .page-heading { padding-top: 38px; }
- h1 { font-size: clamp(42px, 9vw, 64px); line-height: 1.1; }
+ .site-header { padding-block: 18px 10px; min-height: 0; flex-wrap: wrap; gap: 8px; }
+ .site-header nav { width: 100%; justify-content: space-between; gap: 8px; font-size: 13px; }
+ .nav-repo { border: 0; padding: 0; gap: 5px; }
+ .brand { font-size: 23px; }
+ .hero { padding-block: 44px 56px; gap: 32px; }
+ .hero-copy { display: block; }
+ .hero-copy h1, h1 { font-size: clamp(42px, 10.8vw, 64px); line-height: 1.08; }
h2 { font-size: 36px; }
- .hero-copy { margin-top: 20px; }
- .hero-copy h1 { font-size: clamp(42px, 9vw, 64px); }
- .hero-copy p, .page-heading p { font-size: 18px; }
- .section, .first { padding-top: 60px; }
- .section-intro { margin-bottom: 24px; }
- .pair, .location-section, .method-steps { grid-template-columns: 1fr; gap: 28px; }
- .method-summary { margin-top: 60px; padding-top: 36px; }
- .method-steps { margin-top: 28px; }
+ .hero-category { margin-block: 24px 12px; font-size: 14px; }
+ .hero-copy > div > p, .page-heading p { font-size: 17px; }
+ .hero-links { margin-top: 24px; gap: 12px 20px; }
+ .page-heading { padding-top: 44px; }
+ .section, .first { padding-top: 64px; }
+ .section-intro { grid-template-columns: 1fr; gap: 20px; margin-bottom: 28px; }
+ .pair, .location-section { grid-template-columns: 1fr; gap: 28px; }
+ .method-summary { margin-top: 64px; padding-top: 56px; }
+ .method-summary .section-intro p { margin-top: 0; }
+ .method-steps { margin-top: 32px; }
+ .method-steps li { grid-template-columns: 1fr; gap: 12px; padding-block: 24px; }
.evidence-figure { padding-inline: 10px; }
- figcaption { font-size: 13px; padding-block: 12px 14px; }
- .figure-heading { font-size: 12px; padding-block: 12px; }
- .closing { padding-block: 68px; }
- .next-page { margin-top: 60px; flex-direction: column; gap: 10px; padding-bottom: 40px; }
- footer { flex-direction: column; gap: 12px; padding-block: 26px; }
- footer nav { justify-content: flex-start; gap: 12px 20px; }
+ figcaption { font-size: 13px; padding-block: 14px; }
+ .figure-heading { font-size: 13px; padding: 14px 2px; }
+ .closing { padding-block: 88px 72px; }
+ .next-page { margin-top: 64px; flex-direction: column; gap: 10px; padding-bottom: 40px; }
+ footer { flex-direction: column; gap: 16px; padding-block: 28px; }
+ footer nav { justify-content: flex-start; gap: 8px 20px; }
pre { padding: 18px; font-size: 14px; }
- .page-jumps { gap: 12px 24px; font-size: 13px; margin-top: 28px; }
+ .page-jumps { gap: 8px 24px; font-size: 13px; margin-top: 28px; }
.doppler-demo { margin-top: 28px; }
- .demo-phase { font-size: 12px; }
- .doppler-scene { min-height: 210px; }
- .doppler-scene text { font-size: 30px; }
+ .instrument-heading { padding: 16px; gap: 12px; }
+ .instrument-heading > span:last-child { font-size: 13px; }
+ .doppler-scene, .hero .doppler-scene { min-height: 190px; max-height: none; }
+ .doppler-scene text, .hero .doppler-scene text { font-size: 52px; }
.demo-controls { padding: 16px; }
- .demo-transport { grid-template-columns: auto 1fr; gap: 16px; }
- .pitch-readout { grid-column: 2; grid-row: 1; }
+ .demo-transport, .hero .demo-transport { grid-template-columns: auto 1fr; gap: 16px; }
+ .pitch-readout, .hero .pitch-readout { grid-column: 2; grid-row: 1; }
.pitch-readout output { font-size: 14px; }
+ .demo-phase { font-size: 12px; }
.demo-parameters { grid-template-columns: 1fr; gap: 16px; margin-top: 16px; padding-top: 16px; }
.receiver-hit { r: 66px; }
- .timeline-label { grid-column: 1 / -1; grid-row: 2; }
+ .timeline-label, .hero .timeline-label { grid-column: 1 / -1; grid-row: 2; }
.play-button { min-width: 116px; padding-inline: 12px; }
- .figure-viewer { padding: 12px; }
+ .figure-viewer { padding: 16px; }
.viewer-toolbar { gap: 12px; }
.viewer-close { min-width: auto; }
}
-@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
+@media (prefers-reduced-motion: reduce) {
+ html { scroll-behavior: auto; }
+ *, *::before, *::after { animation: none !important; transition: none !important; }
+}
diff --git a/docs/site.js b/docs/site.js
index 28b0a3b..b84a19a 100644
--- a/docs/site.js
+++ b/docs/site.js
@@ -155,8 +155,20 @@
const viewer = document.createElement('dialog');
viewer.className = 'figure-viewer';
viewer.setAttribute('aria-labelledby', 'viewer-title');
- viewer.innerHTML = '<div class="viewer-toolbar"><p id="viewer-title"></p><button type="button" class="viewer-close" autofocus>Close <span aria-hidden="true">×</span></button></div><img alt=""><p class="viewer-caption"></p><a class="viewer-original">Open original image ↗</a>';
+ viewer.innerHTML = '<div class="viewer-toolbar"><p id="viewer-title"></p><button type="button" class="viewer-close" autofocus>Close <span aria-hidden="true">×</span></button></div><p class="viewer-status" role="status" hidden></p><img alt="" width="2610" height="1278"><p class="viewer-caption"></p><a class="viewer-original">Open original image ↗</a>';
document.body.append(viewer);
+ const fullImage = viewer.querySelector('img');
+ const imageStatus = viewer.querySelector('.viewer-status');
+ fullImage.addEventListener('load', () => {
+ viewer.removeAttribute('aria-busy');
+ imageStatus.hidden = true;
+ });
+ fullImage.addEventListener('error', () => {
+ viewer.removeAttribute('aria-busy');
+ fullImage.hidden = true;
+ imageStatus.hidden = false;
+ imageStatus.textContent = 'The full-size figure could not load. Try opening the original image below.';
+ });
viewer.querySelector('button').addEventListener('click', () => viewer.close());
viewer.addEventListener('click', event => { if (event.target === viewer) viewer.close(); });
document.querySelectorAll('.figure-link').forEach(link => {
@@ -166,8 +178,15 @@
const figure = link.closest('figure');
viewer.querySelector('#viewer-title').textContent = figure.querySelector('.figure-heading span').textContent;
const image = viewer.querySelector('img');
+ const preview = link.querySelector('img');
+ image.width = Number(preview.getAttribute('width'));
+ image.height = Number(preview.getAttribute('height'));
+ image.hidden = false;
+ imageStatus.textContent = 'Loading full-size figure…';
+ imageStatus.hidden = false;
+ viewer.setAttribute('aria-busy', 'true');
image.src = link.href;
- image.alt = link.querySelector('img').alt;
+ image.alt = preview.alt;
viewer.querySelector('.viewer-caption').textContent = figure.querySelector('figcaption').textContent;
viewer.querySelector('.viewer-original').href = link.href;
viewer.showModal();