Skip to content

A live bird collage card for your Home Assistant dashboard.

BirdNET-Go 2026 integrations: SSE live feed, Private Mode, native MQTT discovery, HA card-picker (#67)

Adam Oberley2be08dcf8f44
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ff3178ad..27fdba9e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,37 @@
# Changelog
+## Unreleased
+
+### Added
+- **Live detections.** The card now subscribes to BirdNET-Go's SSE stream
+ (`/api/v2/detections/stream`, `live: true` by default) as a push signal:
+ a new detection refreshes the card within seconds instead of on the next
+ 30s poll. Falls back silently on servers without the endpoint (or with
+ Private Mode enabled); the polling safety net is unchanged. Bounded
+ reconnects with backoff; the stream pauses while the tab is hidden.
+- **Private Mode support.** New `api_token` option (card YAML, visual
+ editor, and `AV_CONFIG.apiToken` on the standalone page) sends a Bearer
+ token on every BirdNET-Go API call — including clip playback, which is
+ fetched as a blob so the `<audio>` element can carry the auth. A 401
+ without a token shows a clear "BirdNET-Go requires sign-in" hint instead
+ of a silently empty card.
+- **Native MQTT auto-discovery, first-class.** BirdNET-Go's own Home
+ Assistant MQTT discovery sensors (Jan 2026) are picked up automatically,
+ and a microphone whose sensors go `unavailable` is now surfaced with a
+ quiet "{n} microphone(s) offline" note in the stats view (named when HA
+ can format the entity name). README documents the one-toggle
+ `mqtt_auto_config` zero-YAML setup for the alexbelgium add-on.
+- **HA 2026.6 card-picker suggestions.** Selecting any BirdNET-Go sensor
+ in the new dashboard card picker now suggests Bird Card with a live
+ preview (`getEntitySuggestion`).
+
+### Fixed
+- **Hardened against 2026 BirdNET-Go API changes**: the false-positive
+ report sends both the old and new review field names and surfaces the
+ new CSRF 403 distinctly; detection `source` is accepted as string or
+ object; audio requests honor `503 + Retry-After` while a clip is still
+ being written.
+
## v1.3.0 — 2026-08-27
### Added
diff --git a/README.md b/README.md
index c7056dc3..b2df1c77 100644
--- a/README.md
+++ b/README.md
@@ -377,6 +377,20 @@ keeps flowing anywhere the API can't be reached, and every microphone
becomes a real HA device you can use in automations (announce rare birds,
light up a lamp for an owl...).
+**Zero-YAML path (alexbelgium add-on):** as of the add-on's Jan 2026
+update, switching on **`mqtt_auto_config`** (BirdNET-Go's web UI →
+**Configuration** tab) alone does the whole job - it wires up HA's broker
+credentials *and* turns on BirdNET-Go's native Home Assistant MQTT
+discovery, publishing each microphone as a proper HA device with retained
+state (`_species` / `_confidence` / `_scientific_name` / `_sound_level`
+sensors, correctly showing `unavailable` if that mic's source drops). Flip
+it on, restart the app, and skip straight to step 4 below to verify - the
+card finds the discovered sensors automatically, nothing to set here or in
+the card's YAML.
+
+Not using the add-on, or wiring MQTT up by hand? The manual steps below
+still work exactly as before:
+
1. **Broker**: install the official **Mosquitto broker** app (Settings →
Apps - it's in the official catalog, no custom repository needed)
and start it. HA will then offer the discovered **MQTT integration**
@@ -395,7 +409,8 @@ light up a lamp for an owl...).
(auto-discovery) option. This is a separate toggle from MQTT itself,
off by default - and it's the one that creates the per-microphone
device with the *Scientific Name* / *Last Species* / *Confidence*
- sensors this card uses.
+ sensors this card uses. (Already on if you used `mqtt_auto_config`
+ above - this step is only needed for the manual broker setup.)
4. **Verify**: Settings → Devices & Services → MQTT should show a
"BirdNET-Go <your mic>" device whose sensors update on each
detection. The card picks them up automatically - nothing to
diff --git a/dist/habird-card.js b/dist/habird-card.js
index ff8c2dcb..3a552dc7 100644
--- a/dist/habird-card.js
+++ b/dist/habird-card.js
@@ -2,8 +2,8 @@
* Source of truth: homeassistant/www/{apt.js,styles.css,index.html}. */
(function () {
'use strict';
-var HABIRD_TEMPLATE = "<div class=\"av-shell av-local\">\n\n<a class=\"return-to-atlas\" id=\"returnToAtlas\" href=\"/\" aria-label=\"back to collage\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M10 3 L4 8 L10 13\"/>\n </svg>\n collage\n</a>\n<header class=\"top\">\n <div class=\"window-pick\" id=\"winPick\" role=\"tablist\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button data-h=\"1\" type=\"button\" data-i18n=\"winpick.1h\">1H</button>\n <button data-h=\"12\" type=\"button\" data-i18n=\"winpick.12h\">12H</button>\n <button data-h=\"24\" type=\"button\" aria-current=\"true\" data-i18n=\"winpick.24h\">24H</button>\n <button data-h=\"168\" type=\"button\" data-i18n=\"winpick.7d\">7D</button>\n <button data-h=\"1000000\" type=\"button\" data-i18n=\"winpick.all\">ALL</button>\n </div>\n <button class=\"menu-btn\" id=\"menuBtn\">menu</button>\n</header>\n\n<aside id=\"menu-dd\" aria-hidden=\"true\">\n <div id=\"dd-locked\">\n <form class=\"lock-row\" id=\"unlockForm\">\n <input id=\"lockPass\" type=\"password\" placeholder=\"password\" autocomplete=\"current-password\">\n <button type=\"submit\" aria-label=\"unlock\">→</button>\n </form>\n <p class=\"lock-hint\" id=\"lockHint\">enter password to unlock tools.</p>\n </div>\n <nav class=\"menu-items\" id=\"dd-items\"></nav>\n <p class=\"built-by\">built by <a href=\"https://theodore.net\" target=\"_blank\" rel=\"noopener\">teddy</a> · <a href=\"https://github.com/Twarner491/AvianVisitors\" target=\"_blank\" rel=\"noopener\">github</a></p>\n</aside>\n\n<main class=\"stage\">\n <header class=\"static-head\">\n <button type=\"button\" class=\"pre\" id=\"aboutLink\" data-i18n=\"head.about\">your birds</button>\n <h1 id=\"staticTitle\">Heard Recently</h1>\n </header>\n <div class=\"views\" id=\"views\">\n\n \n <section class=\"view\" id=\"v0\" aria-label=\"Bird collage\" data-i18n-aria=\"aria.collage\">\n <div class=\"gcollage\" id=\"collage\"></div>\n \n <div class=\"wall-widgets\" id=\"wallWidgets\" data-corner=\"bottom-right\" hidden>\n <div class=\"ww-block\" id=\"wwClock\" hidden>\n <span class=\"ww-big\" id=\"wwTime\">--:--</span>\n <span class=\"ww-cap\" id=\"wwDate\"></span>\n </div>\n <i class=\"ww-rule\" id=\"wwRule\" hidden aria-hidden=\"true\"></i>\n <div class=\"ww-block\" id=\"wwWeather\" hidden>\n <span class=\"ww-big\" id=\"wwTemp\"></span>\n <span class=\"ww-cap\" id=\"wwCond\"></span>\n <span class=\"ww-cap\" id=\"wwSun\"></span>\n </div>\n </div>\n </section>\n\n \n <section class=\"view\" id=\"v1\" aria-label=\"Stats\" data-i18n-aria=\"aria.stats\">\n <div class=\"stats-grid\">\n <div class=\"stats-timeline\" id=\"statsTimeline\">\n \n </div>\n <aside class=\"stats-side\">\n <div class=\"grp\">\n <h3 data-i18n=\"stats.byPeriod\">By Period</h3>\n <small data-i18n=\"stats.byPeriodSub\">detections, grouped by recency</small>\n <ol id=\"statsByPeriod\"></ol>\n </div>\n <div class=\"grp\">\n <h3 data-i18n=\"stats.topSpecies\">Top Species</h3>\n <small id=\"statsTopSpecCap\">most-heard, current window</small>\n <ol id=\"statsTopSpec\"></ol>\n </div>\n <div class=\"grp\">\n <h3 data-i18n=\"stats.firstDetections\">First Detections</h3>\n <small data-i18n=\"stats.firstDetectionsSub\">newest additions to the life list</small>\n <ol id=\"statsFirstSeen\"></ol>\n </div>\n </aside>\n </div>\n </section>\n\n \n <section class=\"view\" id=\"v2\" aria-label=\"Atlas\" data-i18n-aria=\"aria.atlas\">\n <div class=\"atlas-controls\">\n <div class=\"atlas-sort\" id=\"atlasSort\" role=\"tablist\" aria-label=\"sort atlas\" data-i18n-aria=\"atlas.sort\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button data-sort=\"count\" type=\"button\" aria-current=\"true\" aria-label=\"most heard\" data-i18n-aria=\"atlas.mostHeard\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\">\n <path d=\"M2 12 V8\"/><path d=\"M6 12 V5\"/><path d=\"M10 12 V3\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.mostHeard\">most heard</span>\n </button>\n <button data-sort=\"recent\" type=\"button\" aria-label=\"most recent\" data-i18n-aria=\"atlas.mostRecent\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <circle cx=\"7\" cy=\"7\" r=\"5.2\"/><path d=\"M7 4 V7 L9.2 8.3\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.mostRecent\">most recent</span>\n </button>\n <button data-sort=\"alpha\" type=\"button\" aria-label=\"alphabetical\" data-i18n-aria=\"atlas.alphabetical\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M2.4 11.5 L4 4.5 L5.6 11.5\"/><path d=\"M2.9 9.2 H5.1\"/>\n <path d=\"M8.2 11.5 V4.5 H10.4 a1.3 1.3 0 0 1 0 2.6 H8.2\"/><path d=\"M8.2 7.1 H10.6 a1.5 1.5 0 0 1 0 3 H8.2\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.atoz\">a → z</span>\n </button>\n </div>\n </div>\n <div class=\"atlas-grid\" id=\"atlasGrid\"></div>\n </section>\n\n </div>\n</main>\n\n<div id=\"detail-modal\" aria-hidden=\"true\" role=\"dialog\" aria-labelledby=\"modalCommon\">\n <div class=\"modal-backdrop\" data-close=\"1\"></div>\n <article class=\"modal-card\">\n <button class=\"modal-close\" type=\"button\" aria-label=\"Close\" data-i18n-aria=\"modal.close\" data-close=\"1\">×</button>\n <div class=\"modal-grid\">\n <div class=\"modal-img\">\n <img id=\"modalImg\" src=\"\" alt=\"\" loading=\"eager\">\n <div class=\"pose-toggle\" id=\"modalPoseToggle\" role=\"tablist\" aria-label=\"Pose\" data-i18n-aria=\"modal.pose\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button type=\"button\" data-pose=\"1\" aria-label=\"perched\" data-i18n-aria=\"modal.perched\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M3.5 6.5 C 4 4, 6 3, 8 4 C 10 3.6, 11.6 4.6, 12 6.5 L 11.5 8 C 11 9.6, 9.4 10.4, 8 10.4 C 6.4 10.4, 4.8 9.6, 4.2 8 Z\"/>\n <circle cx=\"10.6\" cy=\"5.7\" r=\".4\" fill=\"currentColor\"/>\n <path d=\"M12 6.2 L 13.6 5.8\"/>\n <path d=\"M7.5 10.4 L 7.2 12.2\"/>\n <path d=\"M8.6 10.4 L 8.9 12.2\"/>\n <path d=\"M2 12.6 H 13\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"modal.perched\">perched</span>\n </button>\n <button type=\"button\" data-pose=\"2\" aria-label=\"in flight\" data-i18n-aria=\"modal.inFlight\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M1.5 8 Q 4.5 4, 7.5 7.5 Q 11 4, 14.5 8\"/>\n <path d=\"M7.5 7.5 L 8 9.5\"/>\n <circle cx=\"8.5\" cy=\"7.2\" r=\".4\" fill=\"currentColor\"/>\n <path d=\"M8.6 7 L 10 6.6\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"modal.inFlight\">in flight</span>\n </button>\n </div>\n </div>\n <div class=\"modal-info\">\n <h2 id=\"modalCommon\">-</h2>\n <p class=\"sci\" id=\"modalSci\"></p>\n <div class=\"modal-meta\">\n <span class=\"meta-item\"><span class=\"k\" data-i18n=\"modal.genus\">genus</span><span class=\"v\" id=\"modalGenus\">-</span></span>\n <span class=\"meta-item\"><span class=\"k\" data-i18n=\"modal.rarity\">rarity</span><span class=\"v\" id=\"modalRarity\">-</span></span>\n </div>\n <div class=\"modal-stats\">\n <div><span class=\"n\" id=\"modalAllTime\">-</span><span class=\"lbl\" data-i18n=\"modal.allTime\">all time</span></div>\n <div id=\"modalWindowStat\"><span class=\"n\" id=\"modalWindow\">-</span><span class=\"lbl\" id=\"modalWindowLbl\">window</span></div>\n \n <div id=\"modalVisitsStat\" style=\"display:none\"><span class=\"n\" id=\"modalVisits\">-</span><span class=\"lbl\" id=\"modalVisitsLbl\" data-i18n=\"modal.visits\">visits</span></div>\n <div><span class=\"n\" id=\"modalFirstSeen\">-</span><span class=\"lbl\" data-i18n=\"modal.firstHeard\">first heard</span></div>\n </div>\n <p class=\"desc placeholder\" id=\"modalDesc\" data-i18n=\"modal.loadingDesc\">Loading description...</p>\n </div>\n </div>\n <div class=\"modal-recordings\">\n <div class=\"rec-head\">\n <h3 data-i18n=\"modal.recordings\">Recordings</h3>\n <button type=\"button\" class=\"ref-call-btn\" id=\"modalRefCall\" hidden aria-label=\"play reference call\" data-i18n-aria=\"modal.playRefCall\">\n <svg viewBox=\"0 0 12 12\" fill=\"currentColor\"><path d=\"M3 2 L10 6 L3 10 Z\"/></svg><span data-i18n=\"modal.refCall\">reference call</span>\n </button>\n <span class=\"rec-count\" id=\"modalRecCount\"></span>\n </div>\n <p class=\"ref-credit\" id=\"modalRefCredit\" hidden></p>\n <ol id=\"modalRecordings\">\n <li class=\"rec-empty\" data-i18n=\"modal.loadingRecordings\">Loading recordings...</li>\n </ol>\n </div>\n <div class=\"modal-actions\">\n <a id=\"modalWiki\" class=\"chip ext\" target=\"_blank\" rel=\"noopener\" data-i18n=\"modal.wiki\">wiki</a>\n <a id=\"modalEbird\" class=\"chip ext\" target=\"_blank\" rel=\"noopener\" data-i18n=\"modal.ebird\">ebird</a>\n </div>\n </article>\n</div>\n\n<div id=\"about-modal\" aria-hidden=\"true\" role=\"dialog\" aria-labelledby=\"aboutTitle\">\n <div class=\"modal-backdrop\" data-close=\"1\"></div>\n <div class=\"about-card\" role=\"document\">\n <button type=\"button\" class=\"modal-close\" data-close=\"1\" aria-label=\"close\" data-i18n-aria=\"modal.close\">×</button>\n <p class=\"about-eyebrow\" data-i18n=\"head.about\">your birds</p>\n <h2 id=\"aboutTitle\" data-i18n=\"about.title\">The birds outside your window</h2>\n <p class=\"about-body\" data-i18n-html=\"about.body\">A tiny microphone identifies every passing bird with <a href=\"https://github.com/tphakala/birdnet-go\" target=\"_blank\" rel=\"noopener\">BirdNET-Go</a>, built on Cornell's <a href=\"https://birdnet.cornell.edu/\" target=\"_blank\" rel=\"noopener\">BirdNET</a>. Each species shows up as an illustration in the collage, sized by how often it's been heard. Confident detections perch; uncertain ones fly past.</p>\n <button type=\"button\" class=\"about-explore\" data-close=\"1\" data-i18n=\"about.explore\">explore the birds →</button>\n </div>\n</div>\n\n<nav class=\"slider\" id=\"slider\" aria-label=\"View\" data-i18n-aria=\"view.aria\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button type=\"button\" data-i=\"0\" aria-current=\"true\" data-i18n=\"view.collage\">collage</button>\n <button type=\"button\" data-i=\"1\" data-i18n=\"view.stats\">stats</button>\n <button type=\"button\" data-i=\"2\" data-i18n=\"view.atlas\">atlas</button>\n</nav>\n\n\n\n<section class=\"admin-screen\" id=\"adminScreen\" aria-hidden=\"true\">\n <div class=\"admin-frame\">\n <header class=\"admin-title\"><h1 id=\"adminTitle\"></h1></header>\n <div class=\"admin-body\" id=\"adminBody\"></div>\n </div>\n</section>\n\n\n\n\n\n</div>";
-var HABIRD_CSS = " :host {\n color-scheme: light;\n /* Type is variable-driven so the card build can swap the editorial\n serif/mono pairing for the Home Assistant system font. */\n --av-font-display: ui-serif, \"Iowan Old Style\", \"Apple Garamond\", \"Bookman Old Style\", Georgia, serif;\n --av-font-mono: ui-monospace, \"SF Mono\", Menlo, monospace;\n --paper: #fcfcfb; /* near-pure white, faintest warm undertone */\n --paper-2: #f3f2ee; /* recessed track */\n --paper-3: #e8e6df; /* placeholder fill */\n --ink: #1a1612;\n --ink-2: #4a3f31;\n --ink-soft: #908576;\n --accent: #4a3f31; /* warm dark grey - matches ink-2, no longer red */\n --accent-2: #1a1612; /* near-black ink - same hue as the title text */\n --hairline: rgba(26,22,18,0.14); /* faint divider lines + chart gridlines */\n --pill: #fcfcfb; /* active-toggle sliding pill */\n /* Depth shadow recipes - replace flat 1px borders */\n --edge: inset 0 0 0 1px rgba(255,255,255,0.55), 0 0 0 1px rgba(26,22,18,0.04);\n --edge-lg: inset 0 0 0 1px rgba(255,255,255,0.6), 0 0 0 1px rgba(26,22,18,0.06), 0 8px 28px rgba(26,22,18,0.06);\n --recess: inset 0 1px 2px rgba(26,22,18,0.06), inset 0 0 0 1px rgba(26,22,18,0.04);\n --raised: inset 0 0 0 1px rgba(255,255,255,0.8), 0 0 0 1px rgba(26,22,18,0.05), 0 1px 2px rgba(26,22,18,0.07);\n }\n /* ---- Charcoal dark theme. Set via data-theme=\"dark\" on <html> (an\n inline script in index.html applies the saved choice before paint;\n the switcher lives in Settings). The whole UI is variable-driven, so\n flipping ink<->paper inverts cleanly: text reads light, the stats\n squares become light marks on dark, the collage cutouts (transparent\n PNGs) sit on the charcoal directly. Shadow recipes are re-cut for a\n dark surface (faint light edges, deeper drop shadows). ---- */\n :host([data-theme=\"dark\"]) {\n color-scheme: dark;\n --paper: #1a1a1a; /* neutral charcoal page bg (no blue tint) */\n --paper-2: #242424; /* recessed track */\n --paper-3: #303030; /* placeholder fill */\n --ink: #ece8e1; /* warm off-white text / marks */\n --ink-2: #b7afa2; /* secondary text */\n --ink-soft: #837c70; /* muted text */\n --accent: #d8d2c6; /* light warm - pills read light-on-dark */\n --accent-2: #ece8e1;\n --hairline: rgba(236,232,225,0.20); /* faint light divider on charcoal */\n --pill: #404040; /* raised, clearly lighter than the track (neutral) */\n --edge: inset 0 0 0 1px rgba(255,255,255,0.05), 0 0 0 1px rgba(0,0,0,0.4);\n --edge-lg: inset 0 0 0 1px rgba(255,255,255,0.06), 0 0 0 1px rgba(0,0,0,0.5), 0 10px 30px rgba(0,0,0,0.5);\n --recess: inset 0 1px 2px rgba(0,0,0,0.5), inset 0 0 0 1px rgba(255,255,255,0.04);\n --raised: inset 0 0 0 1px rgba(255,255,255,0.07), 0 0 0 1px rgba(0,0,0,0.4), 0 1px 2px rgba(0,0,0,0.5);\n }\n * { box-sizing: border-box; }\n .av-shell { margin: 0; padding: 0; height: 100%; background: var(--paper); color: var(--ink); }\n .av-shell {\n font-family: var(--av-font-display);\n -webkit-font-smoothing: antialiased;\n overflow: hidden;\n }\n .mono { font-family: var(--av-font-mono); letter-spacing: 0.02em; }\n\n /* ============ Stage / views ============\n Stage is a flex column: a static title block sits on top, the views\n slider fills the remaining height. The title NEVER moves when the\n view changes - only its text fades when the new view's title differs\n from the current one. */\n .stage {\n position: absolute; inset: 0; overflow: hidden;\n display: flex; flex-direction: column;\n }\n .static-head {\n flex: 0 0 auto;\n padding: 84px 32px 22px;\n text-align: center; position: relative; z-index: 5;\n }\n .static-head .pre {\n display: inline-block;\n background: none; border: 0; padding: 0;\n font: italic 400 clamp(13px, 1.4cqw, 18px)/1 var(--av-font-display);\n color: var(--ink-2); letter-spacing: 0.06em; margin-bottom: 6px;\n cursor: pointer; transition: color 140ms ease;\n }\n .static-head .pre:hover {\n color: var(--ink);\n text-decoration: underline; text-underline-offset: 3px;\n text-decoration-thickness: 1px;\n }\n .static-head h1 {\n margin: 0; padding: 0;\n font: 700 clamp(24px, 3.2cqw, 40px)/1 var(--av-font-display);\n letter-spacing: 0.06em; color: var(--ink); text-transform: uppercase;\n font-style: normal;\n transition: opacity 240ms cubic-bezier(.7,.05,.2,1);\n }\n .static-head.swap-out h1 { opacity: 0; }\n /* Stats + Atlas hide the shared title so their content uses the full\n height (the collage keeps it). */\n body.av-view-stats .static-head, body.av-view-atlas .static-head { display: none; }\n @container av-card (max-width: 700px) {\n .static-head { padding: 96px 18px 22px; }\n }\n\n .views {\n flex: 1 1 auto; min-height: 0;\n position: relative; display: flex;\n transition: transform 480ms cubic-bezier(.7,.05,.2,1);\n }\n .view { flex: 0 0 100%; height: 100%; overflow: auto; padding: 8px 56px 132px; position: relative; }\n /* The collage view fits the viewport (no scroll). Atlas keeps normal\n scroll; stats scrolls when its grid outgrows the box (overridden at\n the .stats-grid rules below). */\n .view#v0, .view#v1 { overflow: hidden; padding: 8px 32px 88px; }\n .view#v0 { display: flex; }\n .view#v1 { display: flex; flex-direction: column; }\n @container av-card (max-width: 700px) { .view { padding: 8px 18px 132px; } .view#v0, .view#v1 { padding: 8px 16px 88px; } }\n\n /* ============ Top bar - window picker (left) + menu button (right). ============\n Visible on every view; the picker is the universal time-window control. */\n .top {\n position: absolute; top: 22px; left: 0; right: 0;\n display: flex; justify-content: space-between; align-items: center;\n padding: 0 28px; z-index: 30; pointer-events: none;\n }\n .top > * { pointer-events: auto; }\n .top .window-pick {\n display: inline-flex; gap: 0; padding: 4px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: relative;\n }\n .top .window-pick button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 10px/1 var(--av-font-mono); letter-spacing: 0.18em;\n padding: 9px 16px; border-radius: 999px; cursor: pointer; text-transform: uppercase;\n transition: color 200ms ease;\n position: relative; z-index: 1;\n }\n .top .window-pick button:hover { color: var(--ink); }\n .top .window-pick button[aria-current=\"true\"] { color: var(--ink); }\n .menu-btn {\n background: var(--paper); border: 0; color: var(--ink);\n font: 11px/1 var(--av-font-mono); padding: 9px 14px 8px;\n border-radius: 999px; cursor: pointer; letter-spacing: 0.18em; text-transform: lowercase;\n box-shadow: var(--raised);\n transition: transform 160ms ease;\n }\n .menu-btn:hover { transform: translateY(-1px); }\n .menu-btn:active { transform: translateY(0); }\n /* Compact top bar on mobile - the time-window pill goes from\n spacious to thumb-tight without losing legibility. */\n @container av-card (max-width: 700px) {\n .top { top: 12px; padding: 0 12px; }\n .top .window-pick { padding: 3px; }\n .top .window-pick button {\n font-size: 8.5px; padding: 6px 10px; letter-spacing: 0.12em;\n }\n .menu-btn { font-size: 9px; padding: 6px 11px 5px; letter-spacing: 0.14em; }\n .return-to-atlas { top: 10px; left: 10px; padding: 5px 10px; font-size: 8.5px; }\n }\n @container av-card (max-width: 420px) {\n .top .window-pick button { font-size: 8px; padding: 5px 7px; letter-spacing: 0.08em; }\n }\n\n /* ============ Bottom slider - recessed track, raised active pill ============ */\n .slider {\n position: absolute; bottom: 28px; left: 50%; transform: translateX(-50%);\n display: flex; gap: 0; padding: 4px; z-index: 30;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: absolute; /* re-emit for the pill positioning */\n }\n .slider button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 10px/1 var(--av-font-mono); letter-spacing: 0.2em;\n padding: 11px 24px; border-radius: 999px; cursor: pointer; text-transform: uppercase;\n transition: color 200ms ease;\n position: relative; z-index: 1;\n }\n .slider button:hover { color: var(--ink); }\n .slider button[aria-current=\"true\"] { color: var(--ink); }\n\n /* Shared sliding pill - JS animates transform and width to the\n active button's position. The pill is the only element with the\n raised-paper look; buttons just toggle their text colour. */\n .seg-pill {\n position: absolute; top: 4px; bottom: 4px; left: 0;\n background: var(--pill); border-radius: 999px;\n box-shadow: var(--raised);\n transition: transform 320ms cubic-bezier(.7,.05,.2,1), width 320ms cubic-bezier(.7,.05,.2,1);\n will-change: transform, width;\n pointer-events: none; z-index: 0;\n }\n\n /* ============ Menu dropdown ============ */\n #menu-dd {\n position: absolute; top: 58px; right: 28px; z-index: 25;\n width: 360px; max-width: calc(100cqw - 24px);\n max-height: calc(100cqh - 80px); overflow: auto;\n background: var(--paper); border-radius: 12px;\n box-shadow: var(--edge-lg);\n padding: 14px; opacity: 0; transform: translateY(-6px);\n pointer-events: none; transition: opacity 200ms ease, transform 200ms ease;\n }\n #menu-dd.open { opacity: 1; transform: translateY(0); pointer-events: auto; }\n\n .lock-row {\n display: flex; gap: 6px; align-items: stretch;\n background: var(--paper-2); border-radius: 8px;\n box-shadow: var(--recess);\n padding: 4px;\n }\n .lock-row input {\n flex: 1; background: transparent; border: 0; outline: 0;\n color: var(--ink); padding: 8px 10px;\n font: 13px var(--av-font-mono);\n }\n .lock-row input::placeholder { color: var(--ink-soft); }\n .lock-row button {\n background: var(--paper); border: 0; color: var(--ink);\n width: 32px; padding: 0; border-radius: 6px; cursor: pointer;\n font: 14px/1 var(--av-font-mono);\n box-shadow: var(--raised);\n display: flex; align-items: center; justify-content: center;\n }\n .lock-row button:hover { color: var(--accent); }\n .lock-hint {\n margin: 8px 4px 0; font: 10px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n .lock-err { color: var(--accent); }\n /* Tiny \"built by teddy\" attribution - appears under the lock-screen\n password field AND at the foot of the about-card. Same monospace\n micro-type used by .lock-hint so the two contexts read consistent. */\n .built-by {\n margin: 14px 4px 0;\n font: 10px var(--av-font-mono);\n color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n .built-by a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 2px;\n }\n .built-by a:hover { color: var(--ink); }\n .about-card .built-by { margin-top: 18px; }\n\n .menu-items { padding: 4px 4px; display: none; }\n .menu-items.show { display: block; }\n .menu-items h3 {\n font: 9px/1 var(--av-font-mono); letter-spacing: 0.24em;\n color: var(--ink-soft); text-transform: uppercase; margin: 12px 4px 4px;\n }\n .menu-items a {\n display: block; padding: 9px 8px; color: var(--ink); text-decoration: none;\n font: 14px var(--av-font-display); border-radius: 6px;\n transition: background 120ms ease;\n }\n .menu-items a:hover { background: var(--paper-2); color: var(--accent); }\n\n /* ============ Settings cards inside the drawer ============\n Form controls match the time-picker's design language: recessed\n track + raised paper element. Toggles, sliders, and segmented\n pickers share the same depth-shadow recipe. */\n .menu-section {\n margin-top: 14px; padding-top: 12px;\n border-top: 1px solid rgba(26,22,18,0.07);\n }\n .menu-section:first-of-type { margin-top: 6px; border-top: 0; padding-top: 0; }\n .menu-section h3 {\n font: 700 9px var(--av-font-mono); letter-spacing: 0.20em;\n color: var(--ink); text-transform: uppercase;\n margin: 0 0 8px 4px;\n }\n /* Collapsible section - header is a button row with caret on the right.\n Default state is collapsed so accidental clicks don't touch settings. */\n .menu-section.collapsible > .section-header {\n display: flex; align-items: center; justify-content: space-between;\n cursor: pointer; user-select: none;\n padding: 4px 6px 6px 0;\n margin: 0 0 4px 0;\n }\n .menu-section.collapsible > .section-header h3 { margin: 0; }\n .menu-section.collapsible > .section-header .caret {\n width: 10px; height: 10px; transition: transform 200ms cubic-bezier(.7,.05,.2,1);\n color: var(--ink-soft);\n }\n .menu-section.collapsible[data-open=\"true\"] > .section-header .caret { transform: rotate(90deg); }\n .menu-section.collapsible > .section-body {\n max-height: 0; overflow: hidden;\n transition: max-height 280ms cubic-bezier(.7,.05,.2,1);\n }\n .menu-section.collapsible[data-open=\"true\"] > .section-body {\n max-height: 800px;\n }\n .menu-row {\n display: grid; grid-template-columns: 1fr auto; gap: 12px;\n align-items: center;\n padding: 8px 6px 8px 10px;\n border-radius: 6px;\n }\n .menu-row + .menu-row { box-shadow: inset 0 1px 0 rgba(26,22,18,0.06); }\n .menu-row .label {\n font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .hint {\n display: block;\n font: 9px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em; margin-top: 1px;\n }\n\n /* Toggle switch (raised pill that slides) */\n .switch {\n position: relative; width: 38px; height: 20px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n cursor: pointer;\n border: 0; padding: 0;\n }\n .switch::after {\n content: ''; position: absolute; top: 2px; left: 2px;\n width: 16px; height: 16px;\n background: var(--pill); border-radius: 999px;\n box-shadow: var(--raised);\n transition: transform 220ms cubic-bezier(.7,.05,.2,1), background 200ms ease;\n }\n .switch[aria-checked=\"true\"] {\n background: var(--ink-2);\n }\n .switch[aria-checked=\"true\"]::after {\n transform: translateX(18px);\n background: var(--pill);\n }\n\n /* Slider - title row (label + value badge with breathing room) and\n a track row underneath. Value sits at the far right with a wide\n gap so it never crowds the label text. */\n .slider-row {\n display: block;\n padding: 8px 6px 10px 10px;\n }\n .slider-row .head {\n display: flex; align-items: baseline; gap: 24px;\n margin-bottom: 6px;\n }\n .slider-row .head .label-block { flex: 1; min-width: 0; }\n .slider-row .label {\n font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .slider-row .value {\n flex: 0 0 auto;\n font: 11px var(--av-font-mono);\n color: var(--ink); font-variant-numeric: tabular-nums;\n background: var(--paper-2); padding: 3px 10px; border-radius: 4px;\n box-shadow: var(--recess);\n min-width: 48px; text-align: center;\n }\n .slider-row .slider-track {\n margin-top: 2px;\n }\n .slider-track input[type=\"range\"] {\n -webkit-appearance: none; appearance: none;\n width: 100%; height: 18px; background: transparent; cursor: pointer;\n }\n .slider-track input[type=\"range\"]::-webkit-slider-runnable-track {\n height: 4px; background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .slider-track input[type=\"range\"]::-webkit-slider-thumb {\n -webkit-appearance: none; appearance: none;\n width: 16px; height: 16px; margin-top: -6px;\n background: var(--paper); border-radius: 999px;\n box-shadow: var(--raised);\n cursor: pointer;\n }\n .slider-track input[type=\"range\"]::-moz-range-track {\n height: 4px; background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .slider-track input[type=\"range\"]::-moz-range-thumb {\n width: 16px; height: 16px;\n background: var(--paper); border-radius: 999px;\n box-shadow: var(--raised); border: 0;\n cursor: pointer;\n }\n\n /* Segmented picker (same pill-on-recess pattern as the time picker) */\n .seg {\n display: inline-flex; padding: 4px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: relative;\n }\n .seg button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.16em; text-transform: uppercase;\n padding: 6px 12px; border-radius: 999px; cursor: pointer;\n position: relative; z-index: 1;\n transition: color 200ms ease;\n }\n .seg button[aria-current=\"true\"] {\n color: var(--ink);\n background: var(--pill);\n box-shadow: var(--raised);\n }\n\n /* Inline live-audio player - sits at the top of the unlocked drawer.\n A single play/stop button with a quiet running-indicator dot. */\n .live-audio {\n display: flex; align-items: center; gap: 12px;\n padding: 10px 12px; margin: 0 0 6px;\n background: var(--paper-2); border-radius: 8px;\n box-shadow: var(--recess);\n }\n .live-audio .pulse {\n width: 8px; height: 8px; border-radius: 50%;\n background: var(--ink-soft); flex-shrink: 0;\n transition: background 200ms ease;\n }\n .live-audio[data-on=\"true\"] .pulse {\n background: #c44a3b;\n animation: pulsate 1.6s ease-in-out infinite;\n }\n @keyframes pulsate {\n 0%, 100% { opacity: 0.4; transform: scale(1); }\n 50% { opacity: 1; transform: scale(1.25); }\n }\n .live-audio .label {\n flex: 1; font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .live-audio .label .hint {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n .live-audio button {\n background: var(--paper); border: 0; color: var(--ink);\n padding: 6px 12px; border-radius: 4px;\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.14em; text-transform: uppercase; cursor: pointer;\n box-shadow: var(--raised);\n display: inline-flex; align-items: center; gap: 6px;\n }\n .live-audio button svg { width: 9px; height: 9px; }\n .live-audio button + button { margin-left: 4px; }\n /* Live spectrogram - hidden until the user clicks LISTEN. We\n collapse via max-height (not display:none) so the canvas inside\n keeps its layout dimensions and paints correctly on expand. */\n .live-spectro {\n width: 100%; height: 0;\n background: var(--paper-2); border-radius: 6px;\n margin: 0; overflow: hidden;\n box-shadow: var(--recess);\n transition: height 240ms cubic-bezier(.7,.05,.2,1), margin 240ms ease;\n }\n .live-audio[data-on=\"true\"] + .live-spectro {\n height: 70px; margin: 0 0 8px;\n }\n .live-status {\n font: 9.5px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em; text-transform: lowercase;\n margin: -4px 0 6px 0; padding: 0 4px;\n min-height: 13px;\n }\n .live-status.err { color: #a83a2d; }\n .menu-links a .l-hint {\n display: block; font: 8.5px var(--av-font-display); text-transform: none;\n letter-spacing: 0; color: var(--ink-soft); margin-top: 2px;\n }\n .menu-links a.full { grid-column: 1 / -1; }\n\n /* External BirdNET pages - small grid of cards */\n .menu-links {\n display: grid; grid-template-columns: 1fr 1fr; gap: 6px;\n margin: 4px 0 2px;\n }\n .menu-links a {\n display: flex; align-items: center; justify-content: center;\n padding: 9px 10px;\n background: var(--paper-2);\n color: var(--ink); text-decoration: none;\n font: 10.5px var(--av-font-mono);\n letter-spacing: 0.10em; text-transform: lowercase;\n border-radius: 6px;\n box-shadow: var(--raised);\n transition: transform 160ms ease, color 160ms ease;\n }\n .menu-links a:hover { transform: translateY(-1px); color: var(--ink); background: var(--paper); }\n .menu-save-row {\n display: flex; gap: 8px; align-items: center; justify-content: flex-end;\n margin-top: 10px; padding: 0 4px;\n }\n .menu-save-row .save-state {\n flex: 1; font: 9px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n .menu-save-row .save-state.ok { color: #2d5d3a; }\n .menu-save-row .save-state.err { color: var(--accent); }\n .menu-save-row button {\n background: var(--ink); color: var(--paper); border: 0;\n padding: 7px 14px; border-radius: 6px;\n font: 10px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: uppercase; cursor: pointer;\n box-shadow: var(--raised);\n }\n .menu-save-row button:disabled { opacity: 0.4; cursor: default; }\n\n /* ============ View 1 - Collage (Galliformes-style poster) ============\n Viewport-fit, no scroll. The shared static-head provides the title;\n this view's content is just the cluster of bird cutouts which fills\n the remaining viewport height. */\n .gcollage {\n /* No max-width: the packing area spans the full viewport so the flock\n can use the whole screen on wide laptops/monitors. */\n flex: 1 1 auto; width: 100%; margin: 0 auto;\n position: relative; min-height: 0;\n }\n /* Centre-out bloom: each tile fades + scales in; JS staggers the\n animation-delay by distance from the cluster centre. backwards\n fill-mode holds the hidden start state through the delay, and we keep\n no forwards transform so the hover scale still works afterward. */\n @keyframes gtile-in {\n from { opacity: 0; transform: scale(0.82); }\n to { opacity: 1; transform: scale(1); }\n }\n .gtile.entering {\n animation: gtile-in 420ms cubic-bezier(.2,.7,.3,1) backwards;\n }\n @media (prefers-reduced-motion: reduce) {\n .gtile.entering { animation: none; }\n }\n /* Atlas: cards rise + fade in, row by row (JS staggers by row). */\n @keyframes bird-card-in {\n from { opacity: 0; transform: translateY(16px) scale(0.96); }\n to { opacity: 1; transform: none; }\n }\n .bird-card.entering { animation: bird-card-in 480ms cubic-bezier(.2,.7,.3,1) backwards; }\n /* Stats: the heatmap populates top-to-bottom - the hour header leads,\n species rows stagger down the list; the side panel fades in just\n behind. Opacity only (sticky cells reposition themselves, so\n animating transform here would fight their layout). */\n @keyframes stats-fade-in { from { opacity: 0; } to { opacity: 1; } }\n .stats-hm-head.entering, .stats-hm-row.entering,\n .stats-side h3.entering, .stats-side small.entering, .stats-side li.entering {\n animation: stats-fade-in 340ms ease backwards;\n }\n @media (prefers-reduced-motion: reduce) {\n .bird-card.entering, .stats-hm-head.entering, .stats-hm-row.entering,\n .stats-side h3.entering, .stats-side small.entering, .stats-side li.entering { animation: none; }\n }\n .gtile {\n position: absolute;\n background: transparent; border: 0; padding: 0; margin: 0;\n overflow: visible; /* let drop-shadow extend past the bbox */\n /* transform stays quick for hover; the layout box glides so a\n repack (new bird, count change, resize) reads as the flock\n settling rather than a redraw. */\n transition: transform 130ms ease,\n left 760ms cubic-bezier(.3, 0, .2, 1),\n top 760ms cubic-bezier(.3, 0, .2, 1),\n width 760ms cubic-bezier(.3, 0, .2, 1),\n height 760ms cubic-bezier(.3, 0, .2, 1);\n /* Events are handled at the .collage level via alpha-mask\n hit-testing - the tile rectangles must not intercept them. */\n pointer-events: none;\n }\n /* Hover state is driven by JS alpha-mask hit-testing (.is-hover),\n NOT the CSS :hover pseudo - the rectangular tile bounding boxes\n overlap, so :hover would light up the wrong bird. .is-hover only\n ever sits on the one tile whose silhouette is actually under the\n cursor. */\n .gtile.is-hover { transform: scale(1.04); z-index: 3; }\n /* A bird leaving the window fades + shrinks away; renderCollage\n removes the node when the exit finishes. */\n .gtile.leaving {\n opacity: 0; transform: scale(.85);\n transition: opacity 520ms ease, transform 520ms ease;\n }\n .gtile img {\n width: 100%; height: 100%; object-fit: contain; display: block;\n /* Cutouts arrive as alpha-bbox-cropped transparent-bg PNGs, so\n object-fit: contain leaves no whitespace inside the tile - the\n bird touches all four sides. Soft drop shadow keeps it readable\n on paper. */\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n transition: filter 130ms ease;\n }\n .gtile.is-hover img {\n filter: drop-shadow(0 3px 10px rgba(26,22,18,0.26)) saturate(1.1);\n }\n /* Hover pill - surfaces the windowed count for the bird under the\n cursor. Confirms (Anna's-hummingbird-is-#1 paranoia) that the\n collage scaling reflects the selected window, not all-time. */\n /* JS anchors the pill to the hovered bird (left/top set per-hover) and\n keeps it clear of the bottom switcher, so it no longer hides behind\n it. translateX(-50%) centres it on the supplied point; z-index sits\n above the slider (30) as a backstop for any residual overlap. */\n .collage-tip {\n position: absolute; left: 0; top: 0;\n transform: translate(0, 0) translateX(-50%);\n padding: 6px 14px;\n background: var(--paper);\n border-radius: 999px;\n box-shadow: 0 6px 18px rgba(26,22,18,0.12),\n inset 0 0 0 1px rgba(255,255,255,0.6);\n font: italic 13px/1.3 var(--av-font-display);\n color: var(--ink);\n letter-spacing: 0.02em;\n opacity: 0; pointer-events: none;\n transition: opacity 150ms ease,\n transform 200ms cubic-bezier(.3, 0, .2, 1);\n white-space: nowrap;\n z-index: 31;\n }\n .collage-tip[aria-hidden=\"false\"] { opacity: 1; }\n .collage-tip .ct-name { font-style: normal; font-weight: 600; }\n .collage-tip .ct-n { font-style: normal; font-weight: 700; }\n .collage-tip .ct-w { color: var(--ink-soft); }\n\n .empty {\n color: var(--ink-soft); font: 10px var(--av-font-mono);\n padding: 120px 0; text-align: center; letter-spacing: 0.18em;\n text-transform: uppercase;\n }\n\n /* Page header is now shared at .stage > .static-head - see top of CSS. */\n /* Stats grid: the activity heatmap on the LEFT, text sections on the\n RIGHT. Each text section is a list with subtle separators. The\n heatmap scrolls within its panel; the view itself can also scroll\n if the whole grid outgrows the viewport. */\n .stats-grid {\n flex: 1 1 auto; min-height: 0;\n display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 48px;\n max-width: 1400px; margin: 0 auto; width: 100%;\n align-items: stretch;\n }\n /* Anything that doesn't fit (short desktop window, stacked mobile\n layout) scrolls instead of clipping. */\n .view#v1 { overflow-y: auto; overflow-x: hidden; }\n @container av-card (max-width: 900px) {\n /* Stacked single column: take the content's natural (tall) height instead\n of shrinking to the view (flex: 1 1 auto + min-height: 0 would let the\n grid collapse, clipping the heatmap), so #v1 actually scrolls on phones\n and portrait displays. */\n .stats-grid { grid-template-columns: 1fr; gap: 40px; flex: 0 0 auto; min-height: 0; }\n /* Stacked order: tables first, the heatmap underneath, and a buffer\n below it so its bottom row scrolls clear of the floating view\n switcher. */\n .stats-side { order: 1; }\n /* Full-height heatmap (no inner scroll) so the whole view is ONE scroll on\n a phone, not a nested one. Selector outranks the base max-height rule\n that follows it in source order. */\n .view#v1 .stats-timeline { order: 2; margin-bottom: 64px; max-height: none; }\n }\n /* Desktop two-column: size the grid to the side panel's content height\n (the heatmap pane stretches to match it, scrolling internally) and\n float it in the centre of the view. */\n @container av-card (min-width: 901px) {\n .stats-grid { flex: 0 1 auto; margin: auto; }\n }\n\n /* Activity heatmap: one row per species (most-heard first), one cell\n per hour of day, BirdNET-Go dashboard style. Cell tint deepens with\n detection count - mixed from paper toward ink so both themes work -\n and the count prints inside. The hour header sticks to the top of\n the scroll; species names stick to the left edge when the plot\n scrolls sideways on phones. */\n .stats-timeline {\n position: relative;\n flex: 1 1 auto; min-height: 120px;\n max-height: min(88cqh, 1600px);\n overflow: auto; -webkit-overflow-scrolling: touch;\n }\n .stats-hm {\n --hm-name: 200px;\n display: flex; flex-direction: column;\n min-width: 100%;\n }\n .stats-hm-head, .stats-hm-row {\n display: grid;\n grid-template-columns: var(--hm-name) repeat(24, minmax(22px, 1fr)) 48px;\n gap: 3px;\n padding: 1px 0;\n }\n .stats-hm-head {\n position: sticky; top: 0; z-index: 3;\n background: var(--paper);\n }\n .stats-hm-hr {\n font: 10px/1 var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n text-align: center; padding: 3px 0 4px;\n }\n .stats-hm-name {\n position: sticky; left: 0; z-index: 2;\n background: var(--paper);\n display: flex; align-items: center;\n padding-right: 10px; overflow: hidden;\n transition: background 140ms ease;\n }\n .stats-hm-name .com {\n font: 600 14px/1.2 var(--av-font-display); color: var(--ink);\n white-space: nowrap; overflow: hidden; text-overflow: ellipsis;\n transition: color 130ms ease;\n }\n .stats-hm-cell {\n display: flex; align-items: center; justify-content: center;\n min-height: 26px;\n border-radius: 2px;\n background: var(--paper-2);\n font: 11px/1 var(--av-font-mono); color: var(--ink);\n font-variant-numeric: tabular-nums;\n overflow: hidden;\n }\n /* Hours outside the current sub-day window get no tray tint, so the\n window's extent reads as the band of filled trays. */\n .stats-hm-cell.off { background: transparent; box-shadow: inset 0 0 0 1px var(--paper-2); }\n /* Five count steps (log scale, set in renderActivity), paper -> ink. */\n .stats-hm-cell.l1 { background: color-mix(in srgb, var(--ink) 12%, var(--paper)); }\n .stats-hm-cell.l2 { background: color-mix(in srgb, var(--ink) 26%, var(--paper)); }\n .stats-hm-cell.l3 { background: color-mix(in srgb, var(--ink) 45%, var(--paper)); color: var(--paper); }\n .stats-hm-cell.l4 { background: color-mix(in srgb, var(--ink) 68%, var(--paper)); color: var(--paper); }\n .stats-hm-cell.l5 { background: var(--ink); color: var(--paper); }\n .stats-hm-tot {\n display: flex; align-items: center; justify-content: flex-end;\n padding-right: 2px;\n font: 12px/1 var(--av-font-mono); color: var(--ink-soft);\n font-variant-numeric: tabular-nums;\n }\n .stats-hm-head .stats-hm-tot {\n align-items: flex-start; padding-top: 3px;\n font-size: 9.5px; letter-spacing: 0.04em;\n }\n /* Cross-highlight: hovering a heatmap row or a table row lights up the\n matching species on the other side - the name shifts to the accent\n ink. Click opens the species' detail modal (data-sci delegation). */\n .stats-hm-row { cursor: pointer; }\n .stats-hm-row:hover .stats-hm-name,\n .stats-hm-row.sync-hi .stats-hm-name { background: var(--paper-2); }\n .stats-hm-row:hover .com,\n .stats-hm-row.sync-hi .com { color: var(--accent); }\n .stats-hm-empty {\n position: absolute; inset: 0;\n display: flex; align-items: center; justify-content: center;\n font: 11px var(--av-font-mono); color: var(--ink-soft);\n text-transform: lowercase; letter-spacing: 0.18em;\n }\n /* Caption under the matrix: what the columns cover (rolling window vs\n last-7-days aggregate) and whether the rows were trimmed. Sticky so\n it doesn't wander off when the plot scrolls sideways. */\n .stats-hm-cap {\n position: sticky; left: 0;\n padding: 8px 0 2px;\n font: 8.5px/1 var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n /* Phones: fixed-width cells -> the plot grows past the viewport and\n scrolls horizontally under the sticky name column. */\n @container av-card (max-width: 700px) {\n .stats-hm { --hm-name: 104px; min-width: max-content; }\n .stats-hm-head, .stats-hm-row {\n grid-template-columns: var(--hm-name) repeat(24, 26px) 40px;\n }\n }\n\n /* (Old chart-card / .stats-charts CSS removed - replaced by the\n activity heatmap above.) */\n\n .stats-side {\n display: flex; flex-direction: column; justify-content: center;\n align-self: stretch; max-height: 100%;\n padding: 6px 0;\n }\n .stats-side h3 {\n font: 700 11.5px var(--av-font-mono); color: var(--ink);\n letter-spacing: 0.18em; text-transform: uppercase; margin: 0 0 1px;\n border-left: 2px solid var(--accent); padding-left: 10px;\n }\n /* Tight, content-sized groups - they sit just below their headers\n rather than spreading to fill the column. */\n .stats-side .grp { flex: 0 0 auto; }\n .stats-side .grp + .grp { margin-top: 22px; }\n .stats-side .grp small {\n display: block; font: 10px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em; margin: 0 0 3px 12px;\n }\n /* The whole list is one grid so counts share an aligned column, sized\n to the longest name (max-content) so that column sits right beside\n the names instead of stretching to a far edge. Each row is a subgrid\n so it still gets its own hover background + separator. */\n .stats-side ol {\n list-style: none; padding: 0; margin: 0;\n display: grid; grid-template-columns: 40px max-content 1fr;\n column-gap: 14px; align-content: start;\n }\n .stats-side li {\n display: grid; grid-template-columns: subgrid; grid-column: 1 / -1;\n align-items: baseline; padding: 3px 0;\n box-shadow: inset 0 -1px 0 rgba(26,22,18,0.05);\n font: 14px/1.3 var(--av-font-display); color: var(--ink);\n transition: background 140ms ease, color 140ms ease;\n }\n .stats-side li[data-sci] { cursor: pointer; }\n .stats-side li[data-sci]:hover { background: var(--paper-2); }\n /* Cross-highlight from a hovered timeline square. */\n .stats-side li.sync-hi { background: var(--paper-2); }\n .stats-side li.sync-hi span:not(.yr):not(.ct) { color: var(--accent); }\n .stats-side li .yr { font: 11px var(--av-font-mono); color: var(--accent-2); letter-spacing: 0.04em; }\n .stats-side li .ct { font: 13px var(--av-font-mono); color: var(--ink-soft); font-variant-numeric: tabular-nums; justify-self: end; }\n\n /* (Histogram strip removed - charts moved into the stats-grid LEFT\n column as full-bleed chart cards. See .stats-charts above.) */\n\n /* ============ View 3 - Atlas ============\n Field-guide grid: one card per species, each card holds the cutout,\n names, window/all-time detection counts, and small action chips for\n audio playback, Wikipedia, and eBird. */\n .atlas-controls {\n max-width: 1280px; margin: 0 auto 18px;\n display: flex; justify-content: flex-end; align-items: center;\n }\n .atlas-sort {\n display: inline-flex; padding: 3px; position: relative;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .atlas-sort button {\n background: transparent; border: 0; color: var(--ink-soft);\n width: 30px; height: 26px; padding: 0; border-radius: 999px;\n cursor: pointer; position: relative; z-index: 1;\n display: inline-flex; align-items: center; justify-content: center;\n transition: color 200ms ease;\n }\n .atlas-sort button svg { width: 13px; height: 13px; display: block; }\n .atlas-sort button:hover { color: var(--ink); }\n .atlas-sort button[aria-current=\"true\"] { color: var(--ink); }\n .atlas-sort button .tip {\n position: absolute; top: calc(100% + 6px); left: 50%;\n transform: translateX(-50%); white-space: nowrap;\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; color: var(--ink-soft);\n background: var(--paper); padding: 3px 8px; border-radius: 4px;\n box-shadow: var(--raised);\n opacity: 0; pointer-events: none; transition: opacity 160ms ease;\n }\n .atlas-sort button:hover .tip { opacity: 1; }\n .atlas-grid {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));\n gap: 22px;\n max-width: 1280px; margin: 0 auto;\n }\n /* Mobile atlas: a compact 2-up grid instead of one giant card per row,\n so you can scan many birds and tap easily. Inline actions are hidden -\n tapping the card opens the detail modal, which has play/wiki/ebird +\n recordings - making the whole card one big touch target. */\n @container av-card (max-width: 700px) {\n /* minmax(0,1fr) lets the columns shrink below their content's intrinsic\n width (otherwise the chips force overflow). Selectors are scoped under\n .atlas-grid so they out-specify the base .bird-card rules that appear\n later in the file. */\n .atlas-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; }\n .atlas-grid .bird-card { min-height: 0; padding: 12px 12px 14px; border-radius: 9px; }\n .atlas-grid .bird-card .stat { top: 10px; left: 11px; font-size: 8px; }\n .atlas-grid .bird-card .stat .n { font-size: 11px; }\n .atlas-grid .bird-card .img-wrap { margin: 30px 0 8px; }\n .atlas-grid .bird-card .img-wrap img { max-height: 96px; }\n .atlas-grid .bird-card h3 { font-size: 12.5px; }\n .atlas-grid .bird-card .sci { font-size: 9.5px; }\n .atlas-grid .bird-card .actions { display: none; }\n .atlas-grid .lifer-badge { top: 9px; right: 9px; font-size: 7px; padding: 3px 5px; letter-spacing: 0.1em; }\n }\n .bird-card {\n position: relative;\n background: var(--paper);\n border-radius: 10px;\n padding: 16px 16px 12px;\n box-shadow: var(--edge-lg);\n display: flex; flex-direction: column;\n min-height: 320px;\n cursor: pointer;\n transition: transform 200ms ease, box-shadow 200ms ease;\n }\n .bird-card:hover { transform: translateY(-1px); box-shadow: var(--edge-xl, 0 6px 16px rgba(26,22,18,0.12)); }\n .bird-card .actions, .bird-card .spectro-wrap { cursor: auto; }\n .bird-card .actions button, .bird-card .actions a { cursor: pointer; }\n .bird-card .stat {\n position: absolute; top: 14px; left: 16px;\n font: 9px/1.5 var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n /* \"lifer\" badge - shown top-right when a species' first-ever detection\n falls inside the selected window (set in renderAtlas). pointer-events\n off so it never blocks the card's click-to-open. */\n .lifer-badge {\n position: absolute; top: 12px; right: 12px; z-index: 2;\n font: 700 8px/1 var(--av-font-mono);\n letter-spacing: 0.14em; text-transform: uppercase;\n color: var(--paper); background: var(--accent);\n padding: 4px 7px; border-radius: 999px;\n box-shadow: 0 2px 6px rgba(26,22,18,0.18);\n pointer-events: none;\n }\n .bird-card .stat .n {\n color: var(--ink); font: 700 13px/1 var(--av-font-display);\n font-variant-numeric: tabular-nums; margin-right: 4px;\n letter-spacing: 0;\n }\n .bird-card .stat .lbl { display: block; }\n .bird-card .img-wrap {\n flex: 1 1 auto; min-height: 0;\n display: flex; align-items: center; justify-content: center;\n margin: 38px 0 10px;\n padding: 4px;\n }\n .bird-card .img-wrap img {\n max-width: 100%; max-height: 160px; display: block;\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n }\n .bird-card h3 {\n margin: 0;\n font: 700 14.5px/1.15 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.01em;\n }\n .bird-card .sci {\n font: italic 11px/1.2 var(--av-font-display);\n color: var(--ink-2); margin: 2px 0 0;\n }\n .bird-card .actions {\n display: flex; gap: 6px; align-items: stretch;\n margin-top: 12px; padding-top: 10px;\n box-shadow: inset 0 1px 0 rgba(26,22,18,0.07);\n }\n .bird-card .chip {\n flex: 0 0 auto;\n background: var(--paper-2);\n border: 0; color: var(--ink);\n padding: 5px 9px;\n border-radius: 4px;\n font: 9.5px/1 var(--av-font-mono);\n text-transform: lowercase; letter-spacing: 0.10em;\n text-decoration: none;\n cursor: pointer;\n display: inline-flex; align-items: center; gap: 5px;\n box-shadow: var(--raised);\n transition: transform 160ms ease, color 160ms ease;\n white-space: nowrap;\n }\n .bird-card .chip:hover {\n color: var(--ink); transform: translateY(-1px);\n }\n .bird-card .chip[data-active=\"true\"] {\n color: var(--paper);\n background: var(--ink);\n }\n .bird-card .chip svg { width: 10px; height: 10px; display: block; }\n .bird-card .chip.play { padding-left: 7px; }\n .bird-card .chip.ext::after { content: '↗'; opacity: 0.6; font-size: 11px; }\n\n /* Selected card highlight - matches the page-slider and time-window\n pill aesthetic: the active element is a slightly *brighter* paper\n surface (raised) on top of a slightly *recessed* background.\n No accent colour, no glowing ring - just the same depth shadow\n recipe the rest of the chrome uses. */\n .bird-card { transition: transform 280ms cubic-bezier(.7,.05,.2,1), box-shadow 280ms ease, background 200ms ease; }\n .bird-card[data-active=\"true\"] {\n background: var(--paper);\n box-shadow:\n inset 0 0 0 1px rgba(255,255,255,0.85),\n 0 0 0 1px rgba(26,22,18,0.06),\n 0 10px 26px rgba(26,22,18,0.10);\n transform: translateY(-1px);\n }\n .bird-card[data-pulse=\"true\"] {\n animation: bird-card-pulse 520ms cubic-bezier(.45,.05,.2,1);\n }\n /* Soft fade-in of the raised state, no ring pulse */\n @keyframes bird-card-pulse {\n 0% { transform: translateY(2px); }\n 100% { transform: translateY(-1px); }\n }\n\n .atlas-empty {\n grid-column: 1 / -1;\n padding: 80px 16px; text-align: center;\n font: 12px/1.6 var(--av-font-display); color: var(--ink-2);\n }\n .atlas-empty p { margin: 0 0 4px; }\n .atlas-empty p.hint {\n font: 10px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em;\n }\n\n /* ============ Admin screen (system / logs / tools) ============\n Overlays the slider when activated via #admin=... hash. Lives\n inside the same shell as the rest of the app so the header,\n menu button, and time-window pill stay put - feels native. */\n .admin-screen {\n position: absolute; inset: 60px 0 60px 0;\n background: var(--bg);\n overflow-y: auto;\n z-index: 5;\n opacity: 0; pointer-events: none;\n transition: opacity 200ms ease;\n }\n .admin-screen[aria-hidden=\"false\"] { opacity: 1; pointer-events: auto; }\n .admin-frame {\n max-width: 1100px; margin: 0 auto; padding: 0 28px 40px;\n }\n .admin-title {\n text-align: center; margin: 0 auto 28px;\n }\n .admin-title h1 {\n margin: 0;\n font: 32px/1.1 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.005em;\n }\n /* Return-to-atlas pill in the same slot the time-window pill\n normally lives - matches its visual language. */\n .return-to-atlas {\n position: absolute; top: 18px; left: 20px; z-index: 6;\n display: none; align-items: center; gap: 6px;\n padding: 7px 14px; border-radius: 999px;\n background: var(--paper-2);\n color: var(--ink-soft);\n font: 10px var(--av-font-mono); letter-spacing: 0.18em;\n text-transform: lowercase; cursor: pointer;\n text-decoration: none;\n box-shadow: var(--recess);\n transition: color 200ms ease;\n }\n .av-shell.admin-on .return-to-atlas { display: inline-flex; }\n .av-shell.admin-on #slider { visibility: hidden; }\n .av-shell.admin-on .static-head { opacity: 0; pointer-events: none; }\n /* Hide the time-window pill on admin pages (it doesn't apply\n there) - the return-to-atlas link takes its slot. */\n .av-shell.admin-on #winPick { visibility: hidden; }\n .return-to-atlas:hover { color: var(--ink); }\n .return-to-atlas svg { width: 10px; height: 10px; }\n .admin-body { padding-top: 4px; }\n .admin-grid {\n display: grid; gap: 14px;\n grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\n margin-bottom: 22px;\n }\n .admin-card {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; box-shadow: var(--edge);\n }\n .admin-card h3 {\n margin: 0 0 6px; font: 10px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink-soft); font-weight: 500;\n }\n .admin-card .v { font: 20px var(--av-font-display); color: var(--ink); }\n .admin-card .sub { font: 11px var(--av-font-mono); color: var(--ink-soft); margin-top: 4px; }\n .admin-card.alert { box-shadow: 0 0 0 1px var(--accent), var(--edge); }\n .admin-card.alert h3 { color: var(--accent); }\n .admin-card.warn { box-shadow: 0 0 0 1px #c47a1f, var(--edge); }\n .admin-card.warn h3 { color: #c47a1f; }\n .admin-section-head {\n font: 700 11px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink); margin: 24px 0 10px;\n border-left: 2px solid var(--accent-2); padding-left: 10px;\n }\n table.admin-tbl {\n width: 100%; border-collapse: collapse;\n font: 12px var(--av-font-mono);\n background: var(--paper); border-radius: 8px; overflow: hidden;\n box-shadow: var(--edge);\n }\n table.admin-tbl th, table.admin-tbl td {\n border-bottom: 1px solid var(--rule, #c8bfae);\n padding: 9px 12px; text-align: left;\n }\n table.admin-tbl tr:last-child th, table.admin-tbl tr:last-child td { border-bottom: 0; }\n table.admin-tbl th {\n color: var(--ink-soft); text-transform: uppercase;\n font-size: 9.5px; letter-spacing: 0.14em; font-weight: 500;\n }\n table.admin-tbl .pill {\n display: inline-block; padding: 1px 8px; border-radius: 999px;\n font-size: 9.5px; letter-spacing: 0.06em; text-transform: uppercase;\n }\n table.admin-tbl .pill.active { background: rgba(90,122,58,.18); color: #4d6730; }\n table.admin-tbl .pill.inactive { background: rgba(168,52,29,.18); color: var(--accent); }\n table.admin-tbl .pill.failed { background: rgba(168,52,29,.18); color: var(--accent); }\n table.admin-tbl button.restart {\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.04em; text-transform: lowercase;\n padding: 4px 10px; border: 0; background: var(--paper-2);\n border-radius: 4px; cursor: pointer; color: var(--ink-soft);\n box-shadow: var(--raised);\n }\n table.admin-tbl button.restart:hover { color: var(--ink); }\n table.admin-tbl button.restart[disabled] { opacity: .5; cursor: wait; }\n .admin-logs-toolbar {\n display: flex; gap: 8px; align-items: center; margin-bottom: 14px;\n }\n .admin-logs-toolbar select, .admin-logs-toolbar input[type=\"number\"] {\n font: 12px var(--av-font-mono);\n padding: 6px 10px; border: 1px solid var(--rule, #c8bfae);\n border-radius: 4px; background: var(--paper); color: var(--ink);\n }\n .admin-logs-toolbar label {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: uppercase; color: var(--ink-soft);\n }\n .admin-logs-pane {\n background: #1c1a14; color: #d7cba8;\n font: 12px/1.5 var(--av-font-mono);\n padding: 14px 16px; border-radius: 8px;\n max-height: 65cqh; overflow: auto; white-space: pre-wrap;\n }\n .admin-actions-grid {\n display: grid; gap: 12px;\n grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));\n }\n .admin-action {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; box-shadow: var(--edge);\n }\n .admin-action h4 { margin: 0 0 6px; font: 15px var(--av-font-display); color: var(--ink); }\n .admin-action p { margin: 0 0 10px; font: 12.5px var(--av-font-display); color: var(--ink-soft); }\n .admin-action button.run {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; padding: 6px 12px; border: 0;\n background: var(--ink); color: var(--paper); border-radius: 999px;\n cursor: pointer;\n }\n .admin-action button.run[disabled] { opacity: .5; cursor: wait; }\n .admin-action .out {\n margin-top: 10px; font: 10.5px var(--av-font-mono);\n color: var(--ink-soft); white-space: pre-wrap;\n }\n .admin-action.deploy pre {\n background: #1c1a14; color: #d7cba8;\n font: 11px var(--av-font-mono);\n padding: 12px 14px; border-radius: 6px;\n overflow: auto; white-space: pre-wrap; word-break: break-all;\n margin: 0;\n }\n .admin-action.deploy button.copy {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.06em;\n text-transform: lowercase; padding: 5px 10px;\n background: var(--paper-2); color: var(--ink-soft);\n border: 0; border-radius: 4px; cursor: pointer; box-shadow: var(--raised);\n margin-top: 8px;\n }\n .admin-action.deploy button.copy:hover { color: var(--ink); }\n .admin-unreachable {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; color: var(--accent);\n font: 12px var(--av-font-mono);\n margin-bottom: 18px; box-shadow: 0 0 0 1px var(--accent), var(--edge);\n }\n /* When admin screen is shown, the slider underneath is hidden so it\n doesn't compete for scrolling. The static title gets swapped out\n too - admin is its own section with its own visual identity.\n Menu button + time-window pill stay visible (still useful). */\n .av-shell.admin-on #views { display: none; }\n .av-shell.admin-on .nav-band,\n .av-shell.admin-on #slider { visibility: hidden; }\n .av-shell.admin-on .static-head { opacity: 0; pointer-events: none; transition: opacity 200ms ease; }\n\n /* Mobile compact: drawer takes near-full width, admin pads tighter,\n section heads + cards downsize. */\n @container av-card (max-width: 700px) {\n #menu-dd { top: 50px; right: 8px; left: 8px; width: auto; padding: 10px; }\n .admin-screen { inset: 52px 0 60px 0; }\n .admin-frame { padding: 0 14px 32px; }\n .admin-title { margin-bottom: 18px; }\n .admin-title h1 { font-size: 22px; }\n .admin-grid { gap: 10px; grid-template-columns: repeat(auto-fit, minmax(170px, 1fr)); }\n .admin-card { padding: 12px 14px; }\n .admin-card .v { font-size: 18px; }\n .admin-section-head { margin: 18px 0 8px; font-size: 10px; letter-spacing: 0.12em; }\n table.admin-tbl th, table.admin-tbl td { padding: 7px 8px; font-size: 11px; }\n .admin-actions-grid { gap: 10px; grid-template-columns: 1fr; }\n .admin-action { padding: 12px 14px; }\n /* Slider track bottom nav: tuck closer to bottom edge */\n .slider { bottom: 14px; padding: 3px; }\n .slider button { font-size: 9.5px; padding: 6px 11px; }\n }\n @container av-card (max-width: 700px) {\n /* Detail-modal: full-screen on small screens. */\n #detail-modal { padding: 12px; }\n /* Extra top padding = a clear strip for the close button, so the X\n sits in its own corner instead of on the artwork. */\n .modal-card { padding: 44px 18px 18px; border-radius: 10px; }\n .modal-close { top: 10px; right: 10px; }\n .modal-info h2 { font-size: 22px; }\n .modal-img { height: 160px; padding: 10px; }\n .modal-grid { gap: 18px; }\n /* Keep the description short so the recordings are in reach - the\n full text is one tap away on the wiki link. */\n .modal-info .desc {\n font-size: 12px; line-height: 1.5;\n display: -webkit-box; -webkit-line-clamp: 4;\n -webkit-box-orient: vertical; overflow: hidden;\n cursor: pointer;\n }\n .modal-info .desc.expanded { -webkit-line-clamp: unset; display: block; }\n .rec-row .when { font-size: 10.5px; }\n .rec-row .when small { font-size: 8.5px; }\n }\n\n /* ============ Detail modal (atlas card expansion) ============\n Click a bird card -> this fades in over a soft ink backdrop with\n the full sketch, taxonomic info, Wikipedia summary, and a\n scrollable list of every past audio capture for the species. */\n /* /about - a brief explainer popup floated over the index page.\n Reuses .modal-backdrop / .modal-close; opened by the #about hash. */\n #about-modal {\n position: absolute; inset: 0; z-index: 60;\n display: flex; align-items: center; justify-content: center;\n padding: 24px;\n pointer-events: none; opacity: 0;\n transition: opacity 200ms ease;\n }\n #about-modal[aria-hidden=\"false\"] { pointer-events: auto; opacity: 1; }\n .about-card {\n position: relative;\n max-width: 432px; width: 100%;\n background: var(--paper);\n border-radius: 14px;\n box-shadow:\n inset 0 0 0 1px rgba(255,255,255,0.6),\n 0 30px 80px rgba(26,22,18,0.24);\n padding: 34px 34px 28px;\n transform: translateY(10px) scale(0.985);\n transition: transform 260ms cubic-bezier(.32,.72,.32,1);\n }\n #about-modal[aria-hidden=\"false\"] .about-card { transform: none; }\n .about-card .about-eyebrow {\n margin: 0 0 7px;\n font: italic 400 13px/1 var(--av-font-display);\n color: var(--ink-2); letter-spacing: 0.06em;\n }\n .about-card h2 {\n margin: 0 0 13px;\n font: 700 22px/1.25 var(--av-font-display);\n letter-spacing: 0.01em; color: var(--ink);\n }\n .about-card .about-body {\n margin: 0;\n font: 400 14.5px/1.62 var(--av-font-display);\n color: var(--ink-2);\n }\n /* Plain inline link - same ink as the prose, a simple underline, no\n hover treatment. */\n .about-card .about-body a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 2px;\n }\n .about-card .about-explore {\n margin-top: 20px;\n background: none; border: 0; padding: 0;\n font: 700 11px/1 var(--av-font-mono);\n letter-spacing: 0.08em; text-transform: lowercase;\n color: var(--ink-soft); cursor: pointer;\n transition: color 140ms ease;\n }\n .about-card .about-explore:hover { color: var(--ink); }\n #detail-modal {\n position: absolute; inset: 0; z-index: 50;\n display: flex; align-items: center; justify-content: center;\n padding: 24px;\n pointer-events: none; opacity: 0;\n /* One opacity fade for backdrop + card together; the card also\n morphs via transform (see morphModalOpen). Driven by .is-open so\n the fade can run *during* the close morph, not after it. */\n transition: opacity 260ms ease;\n }\n #detail-modal.is-open { pointer-events: auto; opacity: 1; }\n .modal-backdrop {\n position: absolute; inset: 0;\n background: rgba(26,22,18,0.32);\n backdrop-filter: blur(3px); -webkit-backdrop-filter: blur(3px);\n }\n .modal-card {\n position: relative;\n /* Cap to the overlay, NOT the viewport. #detail-modal is inset:0 with\n 24px padding, so 100% here == its content box == the old\n calc(100cqh - 48px) on a normal viewport - but robustly. In the card\n build 100cqh becomes 100cqh, and when Home Assistant gives the card an\n indefinite height (masonry / content-sized slots) Blink resolves cqh\n to 0, so calc(100cqh - 48px) collapsed to 0 and the modal shrank to a\n strip of padding (Chrome / HA companion WebView only; Firefox & Safari\n resolved it fine). % of the definite inset:0 overlay sidesteps that. */\n max-width: 920px; max-height: 100%;\n width: 100%;\n background: var(--paper);\n border-radius: 14px;\n /* A real border, not an inset shadow: borders paint outside the\n scrolling content box, so scrolled images/spectrograms can never\n slide over the card's outline. */\n border: 1px solid var(--hairline);\n box-shadow: 0 30px 80px rgba(26,22,18,0.22);\n padding: 30px 34px 26px;\n overflow: auto;\n /* The expand-from-card animation is driven by inline transform\n and opacity set on open/close - see openDetailModal. CSS\n transition handles the in-between glide. */\n transform-origin: 50% 50%;\n will-change: transform, opacity;\n }\n .modal-card.is-morphing {\n transition: transform 300ms cubic-bezier(.22,.61,.36,1);\n }\n .modal-close {\n position: absolute; top: 16px; right: 16px;\n background: var(--paper-2); border: 0;\n width: 30px; height: 30px; border-radius: 999px;\n font: 16px/1 var(--av-font-mono); color: var(--ink);\n box-shadow: var(--raised);\n cursor: pointer; z-index: 1;\n }\n .modal-close:hover { color: var(--accent-2); }\n .modal-grid {\n display: grid; grid-template-columns: 1fr 1.15fr; gap: 32px;\n align-items: start;\n }\n @container av-card (max-width: 700px) {\n .modal-grid { grid-template-columns: 1fr; gap: 22px; }\n .modal-card { padding: 22px; }\n }\n .modal-img {\n position: relative;\n background: var(--paper-2); border-radius: 10px;\n display: flex; align-items: center; justify-content: center;\n padding: 16px;\n /* Fixed frame: the illustration fits INSIDE it (object-fit) instead\n of the frame growing to the illustration's aspect. */\n height: 230px;\n box-shadow: var(--recess);\n }\n .modal-img img {\n max-width: 100%; max-height: 100%;\n width: auto; height: auto; object-fit: contain;\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n transition: opacity 220ms ease;\n }\n .modal-img img.swapping { opacity: 0; }\n /* Pose toggle - bottom-left corner of the modal sketch, icon strip.\n Same recipe as the time-window slider: recessed paper-2 well, a\n white sliding pill behind the active button (via .seg-pill), and\n a color shift on the icon itself. */\n .pose-toggle {\n position: absolute; left: 10px; bottom: 10px;\n display: inline-flex; padding: 3px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n z-index: 2;\n }\n .pose-toggle button {\n background: transparent; border: 0; color: var(--ink-soft);\n width: 30px; height: 26px; padding: 0; border-radius: 999px;\n cursor: pointer; position: relative; z-index: 1;\n display: inline-flex; align-items: center; justify-content: center;\n transition: color 200ms ease;\n }\n .pose-toggle button svg { width: 13px; height: 13px; display: block; }\n .pose-toggle button:hover { color: var(--ink); }\n .pose-toggle button[aria-current=\"true\"] { color: var(--ink); }\n .pose-toggle button .tip {\n position: absolute; bottom: calc(100% + 6px); left: 50%;\n transform: translateX(-50%); white-space: nowrap;\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; color: var(--ink-soft);\n background: var(--paper); padding: 3px 8px; border-radius: 4px;\n box-shadow: var(--raised);\n opacity: 0; pointer-events: none; transition: opacity 160ms ease;\n }\n .pose-toggle button:hover .tip { opacity: 1; }\n .pose-toggle[data-unavailable=\"true\"] { display: none; }\n .pose-toggle button[data-unavailable=\"true\"] { display: none; }\n .modal-info h2 {\n margin: 4px 36px 0 0;\n font: 700 26px/1.1 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.01em;\n }\n .modal-info .sci {\n font: italic 13.5px/1.3 var(--av-font-display);\n color: var(--ink-2); margin: 4px 0 6px;\n }\n .modal-stats {\n display: grid; grid-template-columns: repeat(3, 1fr); gap: 8px;\n margin-bottom: 18px;\n }\n .modal-stats > div {\n background: var(--paper-2);\n border-radius: 6px; padding: 10px 12px;\n box-shadow: var(--recess);\n }\n .modal-stats .n {\n display: block;\n font: 800 17px/1 var(--av-font-display);\n color: var(--ink); font-variant-numeric: tabular-nums;\n }\n .modal-stats .lbl {\n display: block; margin-top: 4px;\n font: 8.5px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .modal-info .desc {\n font: 13px/1.55 var(--av-font-display);\n color: var(--ink); margin: 0 0 10px;\n }\n .modal-info .desc.placeholder { color: var(--ink-soft); font-style: italic; }\n .modal-meta {\n display: flex; flex-wrap: wrap; gap: 16px;\n font: 9.5px var(--av-font-mono); color: var(--ink-soft);\n margin: 0 0 14px;\n }\n .modal-meta .k { letter-spacing: 0.12em; text-transform: uppercase; }\n .modal-meta .v { color: var(--ink); margin-left: 6px; }\n .modal-meta .v.rare { color: var(--accent-2); }\n .modal-recordings {\n margin-top: 14px; padding-top: 14px;\n box-shadow: inset 0 1px 0 rgba(26,22,18,0.07);\n }\n .modal-recordings .rec-head {\n display: flex; align-items: baseline; justify-content: space-between;\n margin-bottom: 8px;\n }\n .modal-recordings h3 {\n font: 700 10px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink); margin: 0;\n border-left: 2px solid var(--accent-2); padding-left: 10px;\n }\n .modal-recordings .rec-count {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em;\n }\n /* Reference-call (Xeno-Canto) button + its attribution line. */\n .modal-recordings .rec-head { gap: 8px; align-items: center; }\n .modal-recordings .rec-count { margin-left: auto; }\n .ref-call-btn {\n display: inline-flex; align-items: center; gap: 5px;\n font: 700 9px var(--av-font-mono); letter-spacing: 0.1em; text-transform: uppercase;\n color: var(--ink-soft); background: var(--paper); white-space: nowrap;\n border: 1px solid var(--hairline); border-radius: 999px;\n padding: 4px 11px 4px 9px; cursor: pointer;\n transition: color 160ms ease, background 160ms ease, border-color 160ms ease, transform 120ms ease;\n }\n .ref-call-btn svg { width: 9px; height: 9px; display: block; }\n .ref-call-btn:hover { color: var(--ink); background: var(--paper-2); transform: translateY(-1px); }\n .ref-call-btn[data-active=\"true\"] { color: var(--accent-2); border-color: var(--ink-soft); }\n .ref-call-btn.loading { opacity: 0.65; cursor: progress; }\n .ref-credit {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em; line-height: 1.55; margin: -2px 0 8px;\n }\n .ref-credit a { color: var(--ink-2); text-decoration: underline; text-underline-offset: 2px; }\n .ref-credit a:hover { color: var(--ink); }\n .modal-recordings ol {\n list-style: none; padding: 0; margin: 0;\n max-height: 220px; overflow-y: auto;\n display: flex; flex-direction: column; gap: 4px;\n padding-right: 4px;\n }\n .rec-row {\n display: grid; grid-template-columns: 30px 1fr auto auto; gap: 10px;\n align-items: center;\n padding: 6px 10px; border-radius: 6px;\n background: var(--paper);\n box-shadow: var(--edge);\n transition: background 160ms ease;\n }\n .rec-row:hover { background: var(--paper-2); }\n .rec-row.expanded { grid-template-columns: 30px 1fr auto; }\n /* Spectrogram strip - inline below the row header. Click on the row\n toggles open/closed independent of playback so you can scan\n spectrograms visually without listening. */\n .rec-spectro {\n grid-column: 1 / -1;\n margin-top: 8px;\n height: 0; overflow: hidden;\n border-radius: 4px;\n /* Paper background - the spectrogram canvas paints ink ON it,\n matching the sketch palette. */\n background: var(--paper-2);\n box-shadow: var(--recess);\n position: relative;\n transition: height 240ms cubic-bezier(.7,.05,.2,1);\n }\n .rec-row.expanded .rec-spectro { height: 88px; }\n /* The spectrogram is rendered client-side onto a canvas - we fetch\n the mp3, decode via Web Audio, run an STFT, and paint columns\n with our ink palette. No BirdNET-Pi PNG involved. */\n .rec-spectro canvas {\n position: absolute; inset: 0;\n width: 100%; height: 100%;\n display: block;\n opacity: 0; transition: opacity 240ms ease;\n }\n .rec-spectro canvas.ready { opacity: 1; }\n .rec-spectro .rec-spectro-loading {\n position: absolute; inset: 0;\n display: flex; align-items: center; justify-content: center;\n color: var(--ink-soft);\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase;\n pointer-events: none;\n }\n /* Played portion - soft ink wash over the paper ground. */\n .rec-spectro .rec-spectro-played {\n position: absolute; left: 0; top: 0; bottom: 0; width: 0%;\n background: linear-gradient(90deg, rgba(26,22,18,0.16), rgba(26,22,18,0.06));\n pointer-events: none;\n }\n /* Cursor - sliding paper pill with a raised shadow, same recipe as\n the time-window slider's seg-pill. Pops against both the bright\n paper regions of the spectrogram and the inked vocalization\n bands. */\n .rec-spectro .rec-spectro-cursor {\n position: absolute; top: 50%; left: 0;\n width: 14px; height: 20px;\n transform: translate(-50%, -50%);\n background: var(--paper);\n border-radius: 999px;\n box-shadow: 0 1px 3px rgba(26,22,18,0.30), inset 0 0 0 1px rgba(26,22,18,0.18);\n pointer-events: none;\n opacity: 0;\n }\n .rec-spectro .rec-spectro-cursor::after {\n content: '';\n position: absolute; left: 50%; top: -100%; bottom: -100%;\n width: 1.5px; transform: translateX(-50%);\n background: rgba(251,247,238,0.85);\n box-shadow: 0 0 0 0.5px rgba(26,22,18,0.20);\n }\n .rec-spectro.armed .rec-spectro-cursor { opacity: 1; }\n /* Dark mode: the spectrogram ground is charcoal (paintSpectrogram paints\n with --paper), so the dark played-veil and the --paper cursor pill would\n both vanish into it. Flip the veil light, and make the cursor a light\n pill so it still reads against the dark ground. */\n :host([data-theme=\"dark\"]) .rec-spectro .rec-spectro-played {\n background: linear-gradient(90deg, rgba(236,232,225,0.18), rgba(236,232,225,0.07));\n }\n :host([data-theme=\"dark\"]) .rec-spectro .rec-spectro-cursor {\n background: var(--ink);\n }\n .rec-spectro .rec-spectro-scrub {\n position: absolute; inset: 0;\n cursor: ew-resize;\n }\n .rec-row .play {\n background: var(--paper-2); border: 0; color: var(--ink);\n width: 24px; height: 24px; border-radius: 999px;\n display: inline-flex; align-items: center; justify-content: center;\n box-shadow: var(--raised); cursor: pointer;\n padding: 0;\n }\n .rec-row .play svg { width: 8px; height: 8px; }\n .rec-row .play[data-active=\"true\"] {\n background: var(--ink); color: var(--paper);\n }\n .rec-row .when {\n font: 11px/1.2 var(--av-font-mono); color: var(--ink);\n }\n .rec-row .when small {\n display: block; font-size: 9px; color: var(--ink-soft);\n letter-spacing: 0.06em; margin-top: 1px;\n }\n .rec-row .conf {\n font: 10px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.06em;\n font-variant-numeric: tabular-nums;\n }\n .rec-empty {\n padding: 14px;\n font: 11px/1.5 var(--av-font-display); color: var(--ink-soft);\n text-align: center;\n }\n .modal-actions {\n display: flex; gap: 8px; margin-top: 18px;\n }\n .modal-actions .chip {\n flex: 0 0 auto;\n background: var(--paper-2);\n border: 0; color: var(--ink);\n padding: 7px 12px;\n border-radius: 4px;\n font: 10px/1 var(--av-font-mono);\n text-transform: lowercase; letter-spacing: 0.12em;\n text-decoration: none;\n display: inline-flex; align-items: center; gap: 5px;\n box-shadow: var(--raised);\n transition: transform 160ms ease;\n }\n .modal-actions .chip:hover { transform: translateY(-1px); }\n .modal-actions .chip.ext::after { content: '↗'; opacity: 0.6; }\n\n /* Spectrogram appears on first audio play. Recoloured via CSS filter\n so BirdNET-Pi's default colour spectrogram comes out as a clean\n monochrome ink strip, matching the rest of the chart. Click to\n replay; a thin progress bar tracks playback in real time. */\n .bird-card .spectro-wrap {\n position: relative;\n min-height: 0; margin: 6px 0 2px;\n cursor: pointer;\n overflow: hidden;\n border-radius: 3px;\n box-shadow: var(--recess);\n }\n .bird-card .spectro-wrap:empty { display: none; }\n /* Canvas is painted client-side in the active theme's paper/ink palette\n (paintSpectrogram reads data-theme), so it follows light/dark mode with\n no CSS filter - same renderer as the modal recording spectrograms. */\n .bird-card .spectro-wrap canvas {\n width: 100%; height: 44px; display: block;\n }\n /* Progress wash: a translucent veil that grows as the clip plays. Ink in\n light mode; in dark mode a light veil so it stays visible over the\n charcoal spectrogram ground. */\n .bird-card .spectro-wrap::after {\n content: '';\n position: absolute; top: 0; bottom: 0; left: 0;\n width: var(--prog, 0%);\n background: linear-gradient(to right, rgba(26,22,18,0.30), rgba(26,22,18,0.05));\n pointer-events: none;\n transition: width 60ms linear;\n }\n :host([data-theme=\"dark\"]) .bird-card .spectro-wrap::after {\n background: linear-gradient(to right, rgba(236,232,225,0.26), rgba(236,232,225,0.05));\n }\n /* Playhead - thin vertical line at the leading edge */\n .bird-card .spectro-wrap::before {\n content: '';\n position: absolute; top: 0; bottom: 0;\n left: var(--prog, 0%);\n width: 1px;\n background: var(--ink);\n opacity: var(--playhead, 0);\n pointer-events: none;\n transition: opacity 200ms ease;\n }\n .bird-card[data-playing=\"true\"] .spectro-wrap::before { --playhead: 0.6; }\n\n/* ============ AvianVisitors mode toggle ============\n * Default install (.av-shell.av-local): hide the lock-row, show drawer items\n * directly when the menu opens. The PHP shim at /avian/api/menu.php\n * returns items immediately with no auth, so the live JS skips the lock\n * flow entirely.\n *\n * Forwarded install (body.av-forwarded): show the lock row so users\n * type the basic-auth password before items unlock. Pair with\n * AV_REQUIRE_AUTH=1 in php-fpm env + Caddy basic_auth on /avian/api/.\n * See avian/forwarding/. */\n.av-shell.av-local #dd-locked { display: none; }\n.av-shell.av-local #dd-items { display: block; }\n\n/* ============ Wall-display widgets (HA build) ============\n Clock + weather as a quiet corner block INSIDE the collage view.\n renderCollage() stamps this element's box into the silhouette-packing\n grid, so when the flock grows the birds nest around the numerals the\n same way they nest around each other. Same editorial recipe as the\n rest of the page: a serif display line over a monospace, letterspaced\n micro-caption, on the paper/ink variables so dark theme inverts free.\n pointer-events:none keeps hover/click hit-testing on the birds. */\n.wall-widgets {\n position: absolute; z-index: 6;\n display: flex; flex-direction: column; gap: 10px;\n pointer-events: none;\n}\n.wall-widgets[hidden] { display: none; }\n.wall-widgets[data-corner=\"bottom-right\"] { right: 36px; bottom: 96px; align-items: flex-end; text-align: right; }\n.wall-widgets[data-corner=\"bottom-left\"] { left: 36px; bottom: 96px; align-items: flex-start; text-align: left; }\n.wall-widgets[data-corner=\"top-right\"] { right: 36px; top: 14px; align-items: flex-end; text-align: right; }\n.wall-widgets[data-corner=\"top-left\"] { left: 36px; top: 14px; align-items: flex-start; text-align: left; }\n.ww-block { display: flex; flex-direction: column; gap: 3px; }\n.wall-widgets[data-corner$=\"right\"] .ww-block { align-items: flex-end; }\n.wall-widgets[data-corner$=\"left\"] .ww-block { align-items: flex-start; }\n.ww-block[hidden] { display: none; }\n.ww-big {\n font: 600 clamp(26px, 3cqw, 40px)/1 var(--av-font-display);\n color: var(--ink);\n font-variant-numeric: tabular-nums;\n letter-spacing: 0.01em;\n}\n.ww-cap {\n font: 9.5px/1.45 var(--av-font-mono);\n letter-spacing: 0.16em; text-transform: uppercase;\n color: var(--ink-soft);\n}\n.ww-cap:empty { display: none; }\n.ww-rule {\n width: 44px; height: 1px;\n background: var(--hairline);\n}\n.ww-rule[hidden] { display: none; }\n@container av-card (max-width: 700px) {\n .wall-widgets { gap: 8px; }\n .wall-widgets[data-corner$=\"right\"] { right: 18px; }\n .wall-widgets[data-corner$=\"left\"] { left: 18px; }\n .wall-widgets[data-corner^=\"bottom\"] { bottom: 92px; }\n .ww-big { font-size: 20px; }\n .ww-cap { font-size: 8px; letter-spacing: 0.1em; }\n /* The sunrise/sunset caption is the first thing to go on a phone. */\n #wwSun { display: none; }\n}\n/* Kiosk cursor hiding - applied to <body> by apt.js after idle when the\n wall options ask for it. */\n.av-shell.ww-cursor-hidden, .av-shell.ww-cursor-hidden * { cursor: none !important; }\n\n/* ---- Card build: configured title floats over the collage ---- */\n/* When a card sets a custom title, the heading is lifted out of the\n flex flow and overlaid on the collage top; renderCollage stamps the\n h1's box into the packing grid so birds nest around the words,\n clock-style. Stats/atlas keep headroom so their content doesn't\n slide under it. */\n.av-shell.av-title-overlay .static-head {\n position: absolute; top: 6px; left: 0; right: 0; z-index: 6;\n pointer-events: none; padding: 26px 32px 0;\n}\n.av-shell.av-title-overlay .view#v1,\n.av-shell.av-title-overlay .view#v2 { padding-top: 96px; }\n\n/* Card option: view picker pinned to the top edge instead of bottom. */\n.av-shell.av-picker-top .slider { top: 10px; bottom: auto; }\n.av-shell.av-picker-top .view { padding-bottom: 28px; }\n.av-shell.av-picker-top .view#v0, .av-shell.av-picker-top .view#v1 { padding-bottom: 24px; }\n\n/* ---- Recording-row review flag ---- */\n/* Writes a false-positive review back to BirdNET-Go. A quiet ghost x\n beside the confidence; first tap arms it into a labelled pill, second\n tap confirms - a stray touch can't flag anything. */\n.rec-row .flag {\n justify-self: end;\n min-width: 22px; height: 22px;\n display: inline-flex; align-items: center; justify-content: center;\n background: transparent; border: 0; border-radius: 999px;\n font: 10px/1 var(--av-font-mono); letter-spacing: 0;\n color: var(--ink-soft);\n padding: 0 6px; cursor: pointer; white-space: nowrap;\n transition: color 140ms ease, background 140ms ease;\n}\n.rec-row .flag:hover { color: var(--ink); background: var(--paper-2); }\n.rec-row .flag[data-state=\"armed\"] {\n background: var(--accent-2); color: var(--paper);\n font-size: 9px; letter-spacing: 0.08em; text-transform: uppercase;\n padding: 0 9px;\n}\n.rec-row .flag[data-state=\"done\"] { color: var(--ink); cursor: default; }\n.rec-row .flag[data-state=\"failed\"] {\n color: var(--accent-2); font-weight: 700;\n font-size: 8.5px; letter-spacing: 0.06em; text-transform: uppercase;\n}\n.rec-row .flag:disabled { cursor: default; }\n.rec-row.flagged .when, .rec-row.flagged .conf { text-decoration: line-through; opacity: 0.55; }\n\n/* ---- card-build additions ---- */\n:host {\n display: block; position: relative;\n width: 100%; height: 100%; min-height: 560px;\n overflow: hidden;\n border-radius: var(--ha-card-border-radius, 12px);\n /* The card box is the responsive container all @container rules and\n cq units resolve against. */\n container: av-card / size;\n}\n.av-shell { position: absolute; inset: 0; overflow: hidden; }\n/* Card default: transparent, so the collage sits directly on the HA\n dashboard. background: paper restores the page's warm ground. */\n.av-shell { background: transparent; }\n.av-shell.av-bg-paper { background: var(--paper); }\n/* font: system swaps the editorial serif/mono pairing for HA's own\n typeface (set per-theme by HA; Roboto stock). */\n.av-shell.av-font-system {\n --av-font-display: var(--ha-font-family-body, var(--mdc-typography-font-family, Roboto, \"Segoe UI\", sans-serif));\n --av-font-mono: var(--ha-font-family-body, var(--mdc-typography-font-family, Roboto, \"Segoe UI\", sans-serif));\n}\n/* The view picker hugs the card's bottom edge (the page floats it higher). */\n.slider { bottom: 10px; }\n/* The collage owns the WHOLE card - no reserved band for the picker\n (it's stamped into the packing grid as an obstacle instead), so the\n flock centres in the true middle of the card. */\n.view#v0 { padding: 12px 14px; }\n/* Clock/weather sit a finger's width off the card's true corners. */\n.wall-widgets[data-corner$=\"right\"] { right: 16px; }\n.wall-widgets[data-corner$=\"left\"] { left: 16px; }\n.wall-widgets[data-corner^=\"top\"] { top: 12px; }\n.wall-widgets[data-corner^=\"bottom\"] { bottom: 14px; }\n/* In system-font mode the empty state reads as a normal sentence in the\n configured font instead of editorial letterspaced small-caps. */\n.av-shell.av-font-system .empty {\n font: 14px/1.5 var(--av-font-mono);\n text-transform: none; letter-spacing: 0;\n}\n/* In system-font mode the picker drops the editorial small-caps treatment\n and reads like native HA tabs. */\n.av-shell.av-font-system .slider button {\n font: 500 13px/1 var(--av-font-mono);\n letter-spacing: 0; text-transform: capitalize;\n padding: 9px 16px;\n}\n/* BirdNET-Pi admin chrome has no backend here (same as the static HA build). */\n#menuBtn, #menu-dd, #returnToAtlas, #adminScreen { display: none !important; }\n";
+var HABIRD_TEMPLATE = "<div class=\"av-shell av-local\">\n\n<a class=\"return-to-atlas\" id=\"returnToAtlas\" href=\"/\" aria-label=\"back to collage\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.7\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M10 3 L4 8 L10 13\"/>\n </svg>\n collage\n</a>\n<header class=\"top\">\n <div class=\"window-pick\" id=\"winPick\" role=\"tablist\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button data-h=\"1\" type=\"button\" data-i18n=\"winpick.1h\">1H</button>\n <button data-h=\"12\" type=\"button\" data-i18n=\"winpick.12h\">12H</button>\n <button data-h=\"24\" type=\"button\" aria-current=\"true\" data-i18n=\"winpick.24h\">24H</button>\n <button data-h=\"168\" type=\"button\" data-i18n=\"winpick.7d\">7D</button>\n <button data-h=\"1000000\" type=\"button\" data-i18n=\"winpick.all\">ALL</button>\n </div>\n <button class=\"menu-btn\" id=\"menuBtn\">menu</button>\n</header>\n\n<aside id=\"menu-dd\" aria-hidden=\"true\">\n <div id=\"dd-locked\">\n <form class=\"lock-row\" id=\"unlockForm\">\n <input id=\"lockPass\" type=\"password\" placeholder=\"password\" autocomplete=\"current-password\">\n <button type=\"submit\" aria-label=\"unlock\">→</button>\n </form>\n <p class=\"lock-hint\" id=\"lockHint\">enter password to unlock tools.</p>\n </div>\n <nav class=\"menu-items\" id=\"dd-items\"></nav>\n <p class=\"built-by\">built by <a href=\"https://theodore.net\" target=\"_blank\" rel=\"noopener\">teddy</a> · <a href=\"https://github.com/Twarner491/AvianVisitors\" target=\"_blank\" rel=\"noopener\">github</a></p>\n</aside>\n\n<main class=\"stage\">\n <header class=\"static-head\">\n <button type=\"button\" class=\"pre\" id=\"aboutLink\" data-i18n=\"head.about\">your birds</button>\n <h1 id=\"staticTitle\">Heard Recently</h1>\n </header>\n <div class=\"views\" id=\"views\">\n\n \n <section class=\"view\" id=\"v0\" aria-label=\"Bird collage\" data-i18n-aria=\"aria.collage\">\n <div class=\"gcollage\" id=\"collage\"></div>\n \n <div class=\"wall-widgets\" id=\"wallWidgets\" data-corner=\"bottom-right\" hidden>\n <div class=\"ww-block\" id=\"wwClock\" hidden>\n <span class=\"ww-big\" id=\"wwTime\">--:--</span>\n <span class=\"ww-cap\" id=\"wwDate\"></span>\n </div>\n <i class=\"ww-rule\" id=\"wwRule\" hidden aria-hidden=\"true\"></i>\n <div class=\"ww-block\" id=\"wwWeather\" hidden>\n <span class=\"ww-big\" id=\"wwTemp\"></span>\n <span class=\"ww-cap\" id=\"wwCond\"></span>\n <span class=\"ww-cap\" id=\"wwSun\"></span>\n </div>\n </div>\n </section>\n\n \n <section class=\"view\" id=\"v1\" aria-label=\"Stats\" data-i18n-aria=\"aria.stats\">\n <div class=\"stats-grid\">\n <div class=\"stats-timeline\" id=\"statsTimeline\">\n \n </div>\n <aside class=\"stats-side\">\n <div class=\"grp\">\n <h3 data-i18n=\"stats.byPeriod\">By Period</h3>\n <small data-i18n=\"stats.byPeriodSub\">detections, grouped by recency</small>\n <ol id=\"statsByPeriod\"></ol>\n \n <small id=\"statsMicNote\" class=\"mic-note\" hidden></small>\n </div>\n <div class=\"grp\">\n <h3 data-i18n=\"stats.topSpecies\">Top Species</h3>\n <small id=\"statsTopSpecCap\">most-heard, current window</small>\n <ol id=\"statsTopSpec\"></ol>\n </div>\n <div class=\"grp\">\n <h3 data-i18n=\"stats.firstDetections\">First Detections</h3>\n <small data-i18n=\"stats.firstDetectionsSub\">newest additions to the life list</small>\n <ol id=\"statsFirstSeen\"></ol>\n </div>\n </aside>\n </div>\n </section>\n\n \n <section class=\"view\" id=\"v2\" aria-label=\"Atlas\" data-i18n-aria=\"aria.atlas\">\n <div class=\"atlas-controls\">\n <div class=\"atlas-sort\" id=\"atlasSort\" role=\"tablist\" aria-label=\"sort atlas\" data-i18n-aria=\"atlas.sort\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button data-sort=\"count\" type=\"button\" aria-current=\"true\" aria-label=\"most heard\" data-i18n-aria=\"atlas.mostHeard\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\">\n <path d=\"M2 12 V8\"/><path d=\"M6 12 V5\"/><path d=\"M10 12 V3\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.mostHeard\">most heard</span>\n </button>\n <button data-sort=\"recent\" type=\"button\" aria-label=\"most recent\" data-i18n-aria=\"atlas.mostRecent\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <circle cx=\"7\" cy=\"7\" r=\"5.2\"/><path d=\"M7 4 V7 L9.2 8.3\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.mostRecent\">most recent</span>\n </button>\n <button data-sort=\"alpha\" type=\"button\" aria-label=\"alphabetical\" data-i18n-aria=\"atlas.alphabetical\">\n <svg viewBox=\"0 0 14 14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.3\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M2.4 11.5 L4 4.5 L5.6 11.5\"/><path d=\"M2.9 9.2 H5.1\"/>\n <path d=\"M8.2 11.5 V4.5 H10.4 a1.3 1.3 0 0 1 0 2.6 H8.2\"/><path d=\"M8.2 7.1 H10.6 a1.5 1.5 0 0 1 0 3 H8.2\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"atlas.atoz\">a → z</span>\n </button>\n </div>\n </div>\n <div class=\"atlas-grid\" id=\"atlasGrid\"></div>\n </section>\n\n </div>\n</main>\n\n<div id=\"detail-modal\" aria-hidden=\"true\" role=\"dialog\" aria-labelledby=\"modalCommon\">\n <div class=\"modal-backdrop\" data-close=\"1\"></div>\n <article class=\"modal-card\">\n <button class=\"modal-close\" type=\"button\" aria-label=\"Close\" data-i18n-aria=\"modal.close\" data-close=\"1\">×</button>\n <div class=\"modal-grid\">\n <div class=\"modal-img\">\n <img id=\"modalImg\" src=\"\" alt=\"\" loading=\"eager\">\n <div class=\"pose-toggle\" id=\"modalPoseToggle\" role=\"tablist\" aria-label=\"Pose\" data-i18n-aria=\"modal.pose\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button type=\"button\" data-pose=\"1\" aria-label=\"perched\" data-i18n-aria=\"modal.perched\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M3.5 6.5 C 4 4, 6 3, 8 4 C 10 3.6, 11.6 4.6, 12 6.5 L 11.5 8 C 11 9.6, 9.4 10.4, 8 10.4 C 6.4 10.4, 4.8 9.6, 4.2 8 Z\"/>\n <circle cx=\"10.6\" cy=\"5.7\" r=\".4\" fill=\"currentColor\"/>\n <path d=\"M12 6.2 L 13.6 5.8\"/>\n <path d=\"M7.5 10.4 L 7.2 12.2\"/>\n <path d=\"M8.6 10.4 L 8.9 12.2\"/>\n <path d=\"M2 12.6 H 13\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"modal.perched\">perched</span>\n </button>\n <button type=\"button\" data-pose=\"2\" aria-label=\"in flight\" data-i18n-aria=\"modal.inFlight\">\n <svg viewBox=\"0 0 16 16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.4\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n <path d=\"M1.5 8 Q 4.5 4, 7.5 7.5 Q 11 4, 14.5 8\"/>\n <path d=\"M7.5 7.5 L 8 9.5\"/>\n <circle cx=\"8.5\" cy=\"7.2\" r=\".4\" fill=\"currentColor\"/>\n <path d=\"M8.6 7 L 10 6.6\"/>\n </svg>\n <span class=\"tip\" data-i18n=\"modal.inFlight\">in flight</span>\n </button>\n </div>\n </div>\n <div class=\"modal-info\">\n <h2 id=\"modalCommon\">-</h2>\n <p class=\"sci\" id=\"modalSci\"></p>\n <div class=\"modal-meta\">\n <span class=\"meta-item\"><span class=\"k\" data-i18n=\"modal.genus\">genus</span><span class=\"v\" id=\"modalGenus\">-</span></span>\n <span class=\"meta-item\"><span class=\"k\" data-i18n=\"modal.rarity\">rarity</span><span class=\"v\" id=\"modalRarity\">-</span></span>\n </div>\n <div class=\"modal-stats\">\n <div><span class=\"n\" id=\"modalAllTime\">-</span><span class=\"lbl\" data-i18n=\"modal.allTime\">all time</span></div>\n <div id=\"modalWindowStat\"><span class=\"n\" id=\"modalWindow\">-</span><span class=\"lbl\" id=\"modalWindowLbl\">window</span></div>\n \n <div id=\"modalVisitsStat\" style=\"display:none\"><span class=\"n\" id=\"modalVisits\">-</span><span class=\"lbl\" id=\"modalVisitsLbl\" data-i18n=\"modal.visits\">visits</span></div>\n <div><span class=\"n\" id=\"modalFirstSeen\">-</span><span class=\"lbl\" data-i18n=\"modal.firstHeard\">first heard</span></div>\n </div>\n <p class=\"desc placeholder\" id=\"modalDesc\" data-i18n=\"modal.loadingDesc\">Loading description...</p>\n </div>\n </div>\n <div class=\"modal-recordings\">\n <div class=\"rec-head\">\n <h3 data-i18n=\"modal.recordings\">Recordings</h3>\n <button type=\"button\" class=\"ref-call-btn\" id=\"modalRefCall\" hidden aria-label=\"play reference call\" data-i18n-aria=\"modal.playRefCall\">\n <svg viewBox=\"0 0 12 12\" fill=\"currentColor\"><path d=\"M3 2 L10 6 L3 10 Z\"/></svg><span data-i18n=\"modal.refCall\">reference call</span>\n </button>\n <span class=\"rec-count\" id=\"modalRecCount\"></span>\n </div>\n <p class=\"ref-credit\" id=\"modalRefCredit\" hidden></p>\n <ol id=\"modalRecordings\">\n <li class=\"rec-empty\" data-i18n=\"modal.loadingRecordings\">Loading recordings...</li>\n </ol>\n </div>\n <div class=\"modal-actions\">\n <a id=\"modalWiki\" class=\"chip ext\" target=\"_blank\" rel=\"noopener\" data-i18n=\"modal.wiki\">wiki</a>\n <a id=\"modalEbird\" class=\"chip ext\" target=\"_blank\" rel=\"noopener\" data-i18n=\"modal.ebird\">ebird</a>\n </div>\n </article>\n</div>\n\n<div id=\"about-modal\" aria-hidden=\"true\" role=\"dialog\" aria-labelledby=\"aboutTitle\">\n <div class=\"modal-backdrop\" data-close=\"1\"></div>\n <div class=\"about-card\" role=\"document\">\n <button type=\"button\" class=\"modal-close\" data-close=\"1\" aria-label=\"close\" data-i18n-aria=\"modal.close\">×</button>\n <p class=\"about-eyebrow\" data-i18n=\"head.about\">your birds</p>\n <h2 id=\"aboutTitle\" data-i18n=\"about.title\">The birds outside your window</h2>\n <p class=\"about-body\" data-i18n-html=\"about.body\">A tiny microphone identifies every passing bird with <a href=\"https://github.com/tphakala/birdnet-go\" target=\"_blank\" rel=\"noopener\">BirdNET-Go</a>, built on Cornell's <a href=\"https://birdnet.cornell.edu/\" target=\"_blank\" rel=\"noopener\">BirdNET</a>. Each species shows up as an illustration in the collage, sized by how often it's been heard. Confident detections perch; uncertain ones fly past.</p>\n <button type=\"button\" class=\"about-explore\" data-close=\"1\" data-i18n=\"about.explore\">explore the birds →</button>\n </div>\n</div>\n\n<nav class=\"slider\" id=\"slider\" aria-label=\"View\" data-i18n-aria=\"view.aria\">\n <i class=\"seg-pill\" aria-hidden=\"true\"></i>\n <button type=\"button\" data-i=\"0\" aria-current=\"true\" data-i18n=\"view.collage\">collage</button>\n <button type=\"button\" data-i=\"1\" data-i18n=\"view.stats\">stats</button>\n <button type=\"button\" data-i=\"2\" data-i18n=\"view.atlas\">atlas</button>\n</nav>\n\n\n\n<section class=\"admin-screen\" id=\"adminScreen\" aria-hidden=\"true\">\n <div class=\"admin-frame\">\n <header class=\"admin-title\"><h1 id=\"adminTitle\"></h1></header>\n <div class=\"admin-body\" id=\"adminBody\"></div>\n </div>\n</section>\n\n\n\n\n\n</div>";
+var HABIRD_CSS = " :host {\n color-scheme: light;\n /* Type is variable-driven so the card build can swap the editorial\n serif/mono pairing for the Home Assistant system font. */\n --av-font-display: ui-serif, \"Iowan Old Style\", \"Apple Garamond\", \"Bookman Old Style\", Georgia, serif;\n --av-font-mono: ui-monospace, \"SF Mono\", Menlo, monospace;\n --paper: #fcfcfb; /* near-pure white, faintest warm undertone */\n --paper-2: #f3f2ee; /* recessed track */\n --paper-3: #e8e6df; /* placeholder fill */\n --ink: #1a1612;\n --ink-2: #4a3f31;\n --ink-soft: #908576;\n --accent: #4a3f31; /* warm dark grey - matches ink-2, no longer red */\n --accent-2: #1a1612; /* near-black ink - same hue as the title text */\n --hairline: rgba(26,22,18,0.14); /* faint divider lines + chart gridlines */\n --pill: #fcfcfb; /* active-toggle sliding pill */\n /* Depth shadow recipes - replace flat 1px borders */\n --edge: inset 0 0 0 1px rgba(255,255,255,0.55), 0 0 0 1px rgba(26,22,18,0.04);\n --edge-lg: inset 0 0 0 1px rgba(255,255,255,0.6), 0 0 0 1px rgba(26,22,18,0.06), 0 8px 28px rgba(26,22,18,0.06);\n --recess: inset 0 1px 2px rgba(26,22,18,0.06), inset 0 0 0 1px rgba(26,22,18,0.04);\n --raised: inset 0 0 0 1px rgba(255,255,255,0.8), 0 0 0 1px rgba(26,22,18,0.05), 0 1px 2px rgba(26,22,18,0.07);\n }\n /* ---- Charcoal dark theme. Set via data-theme=\"dark\" on <html> (an\n inline script in index.html applies the saved choice before paint;\n the switcher lives in Settings). The whole UI is variable-driven, so\n flipping ink<->paper inverts cleanly: text reads light, the stats\n squares become light marks on dark, the collage cutouts (transparent\n PNGs) sit on the charcoal directly. Shadow recipes are re-cut for a\n dark surface (faint light edges, deeper drop shadows). ---- */\n :host([data-theme=\"dark\"]) {\n color-scheme: dark;\n --paper: #1a1a1a; /* neutral charcoal page bg (no blue tint) */\n --paper-2: #242424; /* recessed track */\n --paper-3: #303030; /* placeholder fill */\n --ink: #ece8e1; /* warm off-white text / marks */\n --ink-2: #b7afa2; /* secondary text */\n --ink-soft: #837c70; /* muted text */\n --accent: #d8d2c6; /* light warm - pills read light-on-dark */\n --accent-2: #ece8e1;\n --hairline: rgba(236,232,225,0.20); /* faint light divider on charcoal */\n --pill: #404040; /* raised, clearly lighter than the track (neutral) */\n --edge: inset 0 0 0 1px rgba(255,255,255,0.05), 0 0 0 1px rgba(0,0,0,0.4);\n --edge-lg: inset 0 0 0 1px rgba(255,255,255,0.06), 0 0 0 1px rgba(0,0,0,0.5), 0 10px 30px rgba(0,0,0,0.5);\n --recess: inset 0 1px 2px rgba(0,0,0,0.5), inset 0 0 0 1px rgba(255,255,255,0.04);\n --raised: inset 0 0 0 1px rgba(255,255,255,0.07), 0 0 0 1px rgba(0,0,0,0.4), 0 1px 2px rgba(0,0,0,0.5);\n }\n * { box-sizing: border-box; }\n .av-shell { margin: 0; padding: 0; height: 100%; background: var(--paper); color: var(--ink); }\n .av-shell {\n font-family: var(--av-font-display);\n -webkit-font-smoothing: antialiased;\n overflow: hidden;\n }\n .mono { font-family: var(--av-font-mono); letter-spacing: 0.02em; }\n\n /* ============ Stage / views ============\n Stage is a flex column: a static title block sits on top, the views\n slider fills the remaining height. The title NEVER moves when the\n view changes - only its text fades when the new view's title differs\n from the current one. */\n .stage {\n position: absolute; inset: 0; overflow: hidden;\n display: flex; flex-direction: column;\n }\n .static-head {\n flex: 0 0 auto;\n padding: 84px 32px 22px;\n text-align: center; position: relative; z-index: 5;\n }\n .static-head .pre {\n display: inline-block;\n background: none; border: 0; padding: 0;\n font: italic 400 clamp(13px, 1.4cqw, 18px)/1 var(--av-font-display);\n color: var(--ink-2); letter-spacing: 0.06em; margin-bottom: 6px;\n cursor: pointer; transition: color 140ms ease;\n }\n .static-head .pre:hover {\n color: var(--ink);\n text-decoration: underline; text-underline-offset: 3px;\n text-decoration-thickness: 1px;\n }\n .static-head h1 {\n margin: 0; padding: 0;\n font: 700 clamp(24px, 3.2cqw, 40px)/1 var(--av-font-display);\n letter-spacing: 0.06em; color: var(--ink); text-transform: uppercase;\n font-style: normal;\n transition: opacity 240ms cubic-bezier(.7,.05,.2,1);\n }\n .static-head.swap-out h1 { opacity: 0; }\n /* Stats + Atlas hide the shared title so their content uses the full\n height (the collage keeps it). */\n body.av-view-stats .static-head, body.av-view-atlas .static-head { display: none; }\n @container av-card (max-width: 700px) {\n .static-head { padding: 96px 18px 22px; }\n }\n\n .views {\n flex: 1 1 auto; min-height: 0;\n position: relative; display: flex;\n transition: transform 480ms cubic-bezier(.7,.05,.2,1);\n }\n .view { flex: 0 0 100%; height: 100%; overflow: auto; padding: 8px 56px 132px; position: relative; }\n /* The collage view fits the viewport (no scroll). Atlas keeps normal\n scroll; stats scrolls when its grid outgrows the box (overridden at\n the .stats-grid rules below). */\n .view#v0, .view#v1 { overflow: hidden; padding: 8px 32px 88px; }\n .view#v0 { display: flex; }\n .view#v1 { display: flex; flex-direction: column; }\n @container av-card (max-width: 700px) { .view { padding: 8px 18px 132px; } .view#v0, .view#v1 { padding: 8px 16px 88px; } }\n\n /* ============ Top bar - window picker (left) + menu button (right). ============\n Visible on every view; the picker is the universal time-window control. */\n .top {\n position: absolute; top: 22px; left: 0; right: 0;\n display: flex; justify-content: space-between; align-items: center;\n padding: 0 28px; z-index: 30; pointer-events: none;\n }\n .top > * { pointer-events: auto; }\n .top .window-pick {\n display: inline-flex; gap: 0; padding: 4px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: relative;\n }\n .top .window-pick button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 10px/1 var(--av-font-mono); letter-spacing: 0.18em;\n padding: 9px 16px; border-radius: 999px; cursor: pointer; text-transform: uppercase;\n transition: color 200ms ease;\n position: relative; z-index: 1;\n }\n .top .window-pick button:hover { color: var(--ink); }\n .top .window-pick button[aria-current=\"true\"] { color: var(--ink); }\n .menu-btn {\n background: var(--paper); border: 0; color: var(--ink);\n font: 11px/1 var(--av-font-mono); padding: 9px 14px 8px;\n border-radius: 999px; cursor: pointer; letter-spacing: 0.18em; text-transform: lowercase;\n box-shadow: var(--raised);\n transition: transform 160ms ease;\n }\n .menu-btn:hover { transform: translateY(-1px); }\n .menu-btn:active { transform: translateY(0); }\n /* Compact top bar on mobile - the time-window pill goes from\n spacious to thumb-tight without losing legibility. */\n @container av-card (max-width: 700px) {\n .top { top: 12px; padding: 0 12px; }\n .top .window-pick { padding: 3px; }\n .top .window-pick button {\n font-size: 8.5px; padding: 6px 10px; letter-spacing: 0.12em;\n }\n .menu-btn { font-size: 9px; padding: 6px 11px 5px; letter-spacing: 0.14em; }\n .return-to-atlas { top: 10px; left: 10px; padding: 5px 10px; font-size: 8.5px; }\n }\n @container av-card (max-width: 420px) {\n .top .window-pick button { font-size: 8px; padding: 5px 7px; letter-spacing: 0.08em; }\n }\n\n /* ============ Bottom slider - recessed track, raised active pill ============ */\n .slider {\n position: absolute; bottom: 28px; left: 50%; transform: translateX(-50%);\n display: flex; gap: 0; padding: 4px; z-index: 30;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: absolute; /* re-emit for the pill positioning */\n }\n .slider button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 10px/1 var(--av-font-mono); letter-spacing: 0.2em;\n padding: 11px 24px; border-radius: 999px; cursor: pointer; text-transform: uppercase;\n transition: color 200ms ease;\n position: relative; z-index: 1;\n }\n .slider button:hover { color: var(--ink); }\n .slider button[aria-current=\"true\"] { color: var(--ink); }\n\n /* Shared sliding pill - JS animates transform and width to the\n active button's position. The pill is the only element with the\n raised-paper look; buttons just toggle their text colour. */\n .seg-pill {\n position: absolute; top: 4px; bottom: 4px; left: 0;\n background: var(--pill); border-radius: 999px;\n box-shadow: var(--raised);\n transition: transform 320ms cubic-bezier(.7,.05,.2,1), width 320ms cubic-bezier(.7,.05,.2,1);\n will-change: transform, width;\n pointer-events: none; z-index: 0;\n }\n\n /* ============ Menu dropdown ============ */\n #menu-dd {\n position: absolute; top: 58px; right: 28px; z-index: 25;\n width: 360px; max-width: calc(100cqw - 24px);\n max-height: calc(100cqh - 80px); overflow: auto;\n background: var(--paper); border-radius: 12px;\n box-shadow: var(--edge-lg);\n padding: 14px; opacity: 0; transform: translateY(-6px);\n pointer-events: none; transition: opacity 200ms ease, transform 200ms ease;\n }\n #menu-dd.open { opacity: 1; transform: translateY(0); pointer-events: auto; }\n\n .lock-row {\n display: flex; gap: 6px; align-items: stretch;\n background: var(--paper-2); border-radius: 8px;\n box-shadow: var(--recess);\n padding: 4px;\n }\n .lock-row input {\n flex: 1; background: transparent; border: 0; outline: 0;\n color: var(--ink); padding: 8px 10px;\n font: 13px var(--av-font-mono);\n }\n .lock-row input::placeholder { color: var(--ink-soft); }\n .lock-row button {\n background: var(--paper); border: 0; color: var(--ink);\n width: 32px; padding: 0; border-radius: 6px; cursor: pointer;\n font: 14px/1 var(--av-font-mono);\n box-shadow: var(--raised);\n display: flex; align-items: center; justify-content: center;\n }\n .lock-row button:hover { color: var(--accent); }\n .lock-hint {\n margin: 8px 4px 0; font: 10px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n .lock-err { color: var(--accent); }\n /* Tiny \"built by teddy\" attribution - appears under the lock-screen\n password field AND at the foot of the about-card. Same monospace\n micro-type used by .lock-hint so the two contexts read consistent. */\n .built-by {\n margin: 14px 4px 0;\n font: 10px var(--av-font-mono);\n color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n .built-by a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 2px;\n }\n .built-by a:hover { color: var(--ink); }\n .about-card .built-by { margin-top: 18px; }\n\n .menu-items { padding: 4px 4px; display: none; }\n .menu-items.show { display: block; }\n .menu-items h3 {\n font: 9px/1 var(--av-font-mono); letter-spacing: 0.24em;\n color: var(--ink-soft); text-transform: uppercase; margin: 12px 4px 4px;\n }\n .menu-items a {\n display: block; padding: 9px 8px; color: var(--ink); text-decoration: none;\n font: 14px var(--av-font-display); border-radius: 6px;\n transition: background 120ms ease;\n }\n .menu-items a:hover { background: var(--paper-2); color: var(--accent); }\n\n /* ============ Settings cards inside the drawer ============\n Form controls match the time-picker's design language: recessed\n track + raised paper element. Toggles, sliders, and segmented\n pickers share the same depth-shadow recipe. */\n .menu-section {\n margin-top: 14px; padding-top: 12px;\n border-top: 1px solid rgba(26,22,18,0.07);\n }\n .menu-section:first-of-type { margin-top: 6px; border-top: 0; padding-top: 0; }\n .menu-section h3 {\n font: 700 9px var(--av-font-mono); letter-spacing: 0.20em;\n color: var(--ink); text-transform: uppercase;\n margin: 0 0 8px 4px;\n }\n /* Collapsible section - header is a button row with caret on the right.\n Default state is collapsed so accidental clicks don't touch settings. */\n .menu-section.collapsible > .section-header {\n display: flex; align-items: center; justify-content: space-between;\n cursor: pointer; user-select: none;\n padding: 4px 6px 6px 0;\n margin: 0 0 4px 0;\n }\n .menu-section.collapsible > .section-header h3 { margin: 0; }\n .menu-section.collapsible > .section-header .caret {\n width: 10px; height: 10px; transition: transform 200ms cubic-bezier(.7,.05,.2,1);\n color: var(--ink-soft);\n }\n .menu-section.collapsible[data-open=\"true\"] > .section-header .caret { transform: rotate(90deg); }\n .menu-section.collapsible > .section-body {\n max-height: 0; overflow: hidden;\n transition: max-height 280ms cubic-bezier(.7,.05,.2,1);\n }\n .menu-section.collapsible[data-open=\"true\"] > .section-body {\n max-height: 800px;\n }\n .menu-row {\n display: grid; grid-template-columns: 1fr auto; gap: 12px;\n align-items: center;\n padding: 8px 6px 8px 10px;\n border-radius: 6px;\n }\n .menu-row + .menu-row { box-shadow: inset 0 1px 0 rgba(26,22,18,0.06); }\n .menu-row .label {\n font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .hint {\n display: block;\n font: 9px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em; margin-top: 1px;\n }\n\n /* Toggle switch (raised pill that slides) */\n .switch {\n position: relative; width: 38px; height: 20px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n cursor: pointer;\n border: 0; padding: 0;\n }\n .switch::after {\n content: ''; position: absolute; top: 2px; left: 2px;\n width: 16px; height: 16px;\n background: var(--pill); border-radius: 999px;\n box-shadow: var(--raised);\n transition: transform 220ms cubic-bezier(.7,.05,.2,1), background 200ms ease;\n }\n .switch[aria-checked=\"true\"] {\n background: var(--ink-2);\n }\n .switch[aria-checked=\"true\"]::after {\n transform: translateX(18px);\n background: var(--pill);\n }\n\n /* Slider - title row (label + value badge with breathing room) and\n a track row underneath. Value sits at the far right with a wide\n gap so it never crowds the label text. */\n .slider-row {\n display: block;\n padding: 8px 6px 10px 10px;\n }\n .slider-row .head {\n display: flex; align-items: baseline; gap: 24px;\n margin-bottom: 6px;\n }\n .slider-row .head .label-block { flex: 1; min-width: 0; }\n .slider-row .label {\n font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .slider-row .value {\n flex: 0 0 auto;\n font: 11px var(--av-font-mono);\n color: var(--ink); font-variant-numeric: tabular-nums;\n background: var(--paper-2); padding: 3px 10px; border-radius: 4px;\n box-shadow: var(--recess);\n min-width: 48px; text-align: center;\n }\n .slider-row .slider-track {\n margin-top: 2px;\n }\n .slider-track input[type=\"range\"] {\n -webkit-appearance: none; appearance: none;\n width: 100%; height: 18px; background: transparent; cursor: pointer;\n }\n .slider-track input[type=\"range\"]::-webkit-slider-runnable-track {\n height: 4px; background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .slider-track input[type=\"range\"]::-webkit-slider-thumb {\n -webkit-appearance: none; appearance: none;\n width: 16px; height: 16px; margin-top: -6px;\n background: var(--paper); border-radius: 999px;\n box-shadow: var(--raised);\n cursor: pointer;\n }\n .slider-track input[type=\"range\"]::-moz-range-track {\n height: 4px; background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .slider-track input[type=\"range\"]::-moz-range-thumb {\n width: 16px; height: 16px;\n background: var(--paper); border-radius: 999px;\n box-shadow: var(--raised); border: 0;\n cursor: pointer;\n }\n\n /* Segmented picker (same pill-on-recess pattern as the time picker) */\n .seg {\n display: inline-flex; padding: 4px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n position: relative;\n }\n .seg button {\n background: transparent; border: 0; color: var(--ink-soft);\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.16em; text-transform: uppercase;\n padding: 6px 12px; border-radius: 999px; cursor: pointer;\n position: relative; z-index: 1;\n transition: color 200ms ease;\n }\n .seg button[aria-current=\"true\"] {\n color: var(--ink);\n background: var(--pill);\n box-shadow: var(--raised);\n }\n\n /* Inline live-audio player - sits at the top of the unlocked drawer.\n A single play/stop button with a quiet running-indicator dot. */\n .live-audio {\n display: flex; align-items: center; gap: 12px;\n padding: 10px 12px; margin: 0 0 6px;\n background: var(--paper-2); border-radius: 8px;\n box-shadow: var(--recess);\n }\n .live-audio .pulse {\n width: 8px; height: 8px; border-radius: 50%;\n background: var(--ink-soft); flex-shrink: 0;\n transition: background 200ms ease;\n }\n .live-audio[data-on=\"true\"] .pulse {\n background: #c44a3b;\n animation: pulsate 1.6s ease-in-out infinite;\n }\n @keyframes pulsate {\n 0%, 100% { opacity: 0.4; transform: scale(1); }\n 50% { opacity: 1; transform: scale(1.25); }\n }\n .live-audio .label {\n flex: 1; font: 12.5px var(--av-font-display); color: var(--ink);\n }\n .live-audio .label .hint {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n .live-audio button {\n background: var(--paper); border: 0; color: var(--ink);\n padding: 6px 12px; border-radius: 4px;\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.14em; text-transform: uppercase; cursor: pointer;\n box-shadow: var(--raised);\n display: inline-flex; align-items: center; gap: 6px;\n }\n .live-audio button svg { width: 9px; height: 9px; }\n .live-audio button + button { margin-left: 4px; }\n /* Live spectrogram - hidden until the user clicks LISTEN. We\n collapse via max-height (not display:none) so the canvas inside\n keeps its layout dimensions and paints correctly on expand. */\n .live-spectro {\n width: 100%; height: 0;\n background: var(--paper-2); border-radius: 6px;\n margin: 0; overflow: hidden;\n box-shadow: var(--recess);\n transition: height 240ms cubic-bezier(.7,.05,.2,1), margin 240ms ease;\n }\n .live-audio[data-on=\"true\"] + .live-spectro {\n height: 70px; margin: 0 0 8px;\n }\n .live-status {\n font: 9.5px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em; text-transform: lowercase;\n margin: -4px 0 6px 0; padding: 0 4px;\n min-height: 13px;\n }\n .live-status.err { color: #a83a2d; }\n .menu-links a .l-hint {\n display: block; font: 8.5px var(--av-font-display); text-transform: none;\n letter-spacing: 0; color: var(--ink-soft); margin-top: 2px;\n }\n .menu-links a.full { grid-column: 1 / -1; }\n\n /* External BirdNET pages - small grid of cards */\n .menu-links {\n display: grid; grid-template-columns: 1fr 1fr; gap: 6px;\n margin: 4px 0 2px;\n }\n .menu-links a {\n display: flex; align-items: center; justify-content: center;\n padding: 9px 10px;\n background: var(--paper-2);\n color: var(--ink); text-decoration: none;\n font: 10.5px var(--av-font-mono);\n letter-spacing: 0.10em; text-transform: lowercase;\n border-radius: 6px;\n box-shadow: var(--raised);\n transition: transform 160ms ease, color 160ms ease;\n }\n .menu-links a:hover { transform: translateY(-1px); color: var(--ink); background: var(--paper); }\n .menu-save-row {\n display: flex; gap: 8px; align-items: center; justify-content: flex-end;\n margin-top: 10px; padding: 0 4px;\n }\n .menu-save-row .save-state {\n flex: 1; font: 9px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n .menu-save-row .save-state.ok { color: #2d5d3a; }\n .menu-save-row .save-state.err { color: var(--accent); }\n .menu-save-row button {\n background: var(--ink); color: var(--paper); border: 0;\n padding: 7px 14px; border-radius: 6px;\n font: 10px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: uppercase; cursor: pointer;\n box-shadow: var(--raised);\n }\n .menu-save-row button:disabled { opacity: 0.4; cursor: default; }\n\n /* ============ View 1 - Collage (Galliformes-style poster) ============\n Viewport-fit, no scroll. The shared static-head provides the title;\n this view's content is just the cluster of bird cutouts which fills\n the remaining viewport height. */\n .gcollage {\n /* No max-width: the packing area spans the full viewport so the flock\n can use the whole screen on wide laptops/monitors. */\n flex: 1 1 auto; width: 100%; margin: 0 auto;\n position: relative; min-height: 0;\n }\n /* Centre-out bloom: each tile fades + scales in; JS staggers the\n animation-delay by distance from the cluster centre. backwards\n fill-mode holds the hidden start state through the delay, and we keep\n no forwards transform so the hover scale still works afterward. */\n @keyframes gtile-in {\n from { opacity: 0; transform: scale(0.82); }\n to { opacity: 1; transform: scale(1); }\n }\n .gtile.entering {\n animation: gtile-in 420ms cubic-bezier(.2,.7,.3,1) backwards;\n }\n @media (prefers-reduced-motion: reduce) {\n .gtile.entering { animation: none; }\n }\n /* Atlas: cards rise + fade in, row by row (JS staggers by row). */\n @keyframes bird-card-in {\n from { opacity: 0; transform: translateY(16px) scale(0.96); }\n to { opacity: 1; transform: none; }\n }\n .bird-card.entering { animation: bird-card-in 480ms cubic-bezier(.2,.7,.3,1) backwards; }\n /* Stats: the heatmap populates top-to-bottom - the hour header leads,\n species rows stagger down the list; the side panel fades in just\n behind. Opacity only (sticky cells reposition themselves, so\n animating transform here would fight their layout). */\n @keyframes stats-fade-in { from { opacity: 0; } to { opacity: 1; } }\n .stats-hm-head.entering, .stats-hm-row.entering,\n .stats-side h3.entering, .stats-side small.entering, .stats-side li.entering {\n animation: stats-fade-in 340ms ease backwards;\n }\n @media (prefers-reduced-motion: reduce) {\n .bird-card.entering, .stats-hm-head.entering, .stats-hm-row.entering,\n .stats-side h3.entering, .stats-side small.entering, .stats-side li.entering { animation: none; }\n }\n .gtile {\n position: absolute;\n background: transparent; border: 0; padding: 0; margin: 0;\n overflow: visible; /* let drop-shadow extend past the bbox */\n /* transform stays quick for hover; the layout box glides so a\n repack (new bird, count change, resize) reads as the flock\n settling rather than a redraw. */\n transition: transform 130ms ease,\n left 760ms cubic-bezier(.3, 0, .2, 1),\n top 760ms cubic-bezier(.3, 0, .2, 1),\n width 760ms cubic-bezier(.3, 0, .2, 1),\n height 760ms cubic-bezier(.3, 0, .2, 1);\n /* Events are handled at the .collage level via alpha-mask\n hit-testing - the tile rectangles must not intercept them. */\n pointer-events: none;\n }\n /* Hover state is driven by JS alpha-mask hit-testing (.is-hover),\n NOT the CSS :hover pseudo - the rectangular tile bounding boxes\n overlap, so :hover would light up the wrong bird. .is-hover only\n ever sits on the one tile whose silhouette is actually under the\n cursor. */\n .gtile.is-hover { transform: scale(1.04); z-index: 3; }\n /* A bird leaving the window fades + shrinks away; renderCollage\n removes the node when the exit finishes. */\n .gtile.leaving {\n opacity: 0; transform: scale(.85);\n transition: opacity 520ms ease, transform 520ms ease;\n }\n .gtile img {\n width: 100%; height: 100%; object-fit: contain; display: block;\n /* Cutouts arrive as alpha-bbox-cropped transparent-bg PNGs, so\n object-fit: contain leaves no whitespace inside the tile - the\n bird touches all four sides. Soft drop shadow keeps it readable\n on paper. */\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n transition: filter 130ms ease;\n }\n .gtile.is-hover img {\n filter: drop-shadow(0 3px 10px rgba(26,22,18,0.26)) saturate(1.1);\n }\n /* Hover pill - surfaces the windowed count for the bird under the\n cursor. Confirms (Anna's-hummingbird-is-#1 paranoia) that the\n collage scaling reflects the selected window, not all-time. */\n /* JS anchors the pill to the hovered bird (left/top set per-hover) and\n keeps it clear of the bottom switcher, so it no longer hides behind\n it. translateX(-50%) centres it on the supplied point; z-index sits\n above the slider (30) as a backstop for any residual overlap. */\n .collage-tip {\n position: absolute; left: 0; top: 0;\n transform: translate(0, 0) translateX(-50%);\n padding: 6px 14px;\n background: var(--paper);\n border-radius: 999px;\n box-shadow: 0 6px 18px rgba(26,22,18,0.12),\n inset 0 0 0 1px rgba(255,255,255,0.6);\n font: italic 13px/1.3 var(--av-font-display);\n color: var(--ink);\n letter-spacing: 0.02em;\n opacity: 0; pointer-events: none;\n transition: opacity 150ms ease,\n transform 200ms cubic-bezier(.3, 0, .2, 1);\n white-space: nowrap;\n z-index: 31;\n }\n .collage-tip[aria-hidden=\"false\"] { opacity: 1; }\n .collage-tip .ct-name { font-style: normal; font-weight: 600; }\n .collage-tip .ct-n { font-style: normal; font-weight: 700; }\n .collage-tip .ct-w { color: var(--ink-soft); }\n\n .empty {\n color: var(--ink-soft); font: 10px var(--av-font-mono);\n padding: 120px 0; text-align: center; letter-spacing: 0.18em;\n text-transform: uppercase;\n }\n\n /* Page header is now shared at .stage > .static-head - see top of CSS. */\n /* Stats grid: the activity heatmap on the LEFT, text sections on the\n RIGHT. Each text section is a list with subtle separators. The\n heatmap scrolls within its panel; the view itself can also scroll\n if the whole grid outgrows the viewport. */\n .stats-grid {\n flex: 1 1 auto; min-height: 0;\n display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 48px;\n max-width: 1400px; margin: 0 auto; width: 100%;\n align-items: stretch;\n }\n /* Anything that doesn't fit (short desktop window, stacked mobile\n layout) scrolls instead of clipping. */\n .view#v1 { overflow-y: auto; overflow-x: hidden; }\n @container av-card (max-width: 900px) {\n /* Stacked single column: take the content's natural (tall) height instead\n of shrinking to the view (flex: 1 1 auto + min-height: 0 would let the\n grid collapse, clipping the heatmap), so #v1 actually scrolls on phones\n and portrait displays. */\n .stats-grid { grid-template-columns: 1fr; gap: 40px; flex: 0 0 auto; min-height: 0; }\n /* Stacked order: tables first, the heatmap underneath, and a buffer\n below it so its bottom row scrolls clear of the floating view\n switcher. */\n .stats-side { order: 1; }\n /* Full-height heatmap (no inner scroll) so the whole view is ONE scroll on\n a phone, not a nested one. Selector outranks the base max-height rule\n that follows it in source order. */\n .view#v1 .stats-timeline { order: 2; margin-bottom: 64px; max-height: none; }\n }\n /* Desktop two-column: size the grid to the side panel's content height\n (the heatmap pane stretches to match it, scrolling internally) and\n float it in the centre of the view. */\n @container av-card (min-width: 901px) {\n .stats-grid { flex: 0 1 auto; margin: auto; }\n }\n\n /* Activity heatmap: one row per species (most-heard first), one cell\n per hour of day, BirdNET-Go dashboard style. Cell tint deepens with\n detection count - mixed from paper toward ink so both themes work -\n and the count prints inside. The hour header sticks to the top of\n the scroll; species names stick to the left edge when the plot\n scrolls sideways on phones. */\n .stats-timeline {\n position: relative;\n flex: 1 1 auto; min-height: 120px;\n max-height: min(88cqh, 1600px);\n overflow: auto; -webkit-overflow-scrolling: touch;\n }\n .stats-hm {\n --hm-name: 200px;\n display: flex; flex-direction: column;\n min-width: 100%;\n }\n .stats-hm-head, .stats-hm-row {\n display: grid;\n grid-template-columns: var(--hm-name) repeat(24, minmax(22px, 1fr)) 48px;\n gap: 3px;\n padding: 1px 0;\n }\n .stats-hm-head {\n position: sticky; top: 0; z-index: 3;\n background: var(--paper);\n }\n .stats-hm-hr {\n font: 10px/1 var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n text-align: center; padding: 3px 0 4px;\n }\n .stats-hm-name {\n position: sticky; left: 0; z-index: 2;\n background: var(--paper);\n display: flex; align-items: center;\n padding-right: 10px; overflow: hidden;\n transition: background 140ms ease;\n }\n .stats-hm-name .com {\n font: 600 14px/1.2 var(--av-font-display); color: var(--ink);\n white-space: nowrap; overflow: hidden; text-overflow: ellipsis;\n transition: color 130ms ease;\n }\n .stats-hm-cell {\n display: flex; align-items: center; justify-content: center;\n min-height: 26px;\n border-radius: 2px;\n background: var(--paper-2);\n font: 11px/1 var(--av-font-mono); color: var(--ink);\n font-variant-numeric: tabular-nums;\n overflow: hidden;\n }\n /* Hours outside the current sub-day window get no tray tint, so the\n window's extent reads as the band of filled trays. */\n .stats-hm-cell.off { background: transparent; box-shadow: inset 0 0 0 1px var(--paper-2); }\n /* Five count steps (log scale, set in renderActivity), paper -> ink. */\n .stats-hm-cell.l1 { background: color-mix(in srgb, var(--ink) 12%, var(--paper)); }\n .stats-hm-cell.l2 { background: color-mix(in srgb, var(--ink) 26%, var(--paper)); }\n .stats-hm-cell.l3 { background: color-mix(in srgb, var(--ink) 45%, var(--paper)); color: var(--paper); }\n .stats-hm-cell.l4 { background: color-mix(in srgb, var(--ink) 68%, var(--paper)); color: var(--paper); }\n .stats-hm-cell.l5 { background: var(--ink); color: var(--paper); }\n .stats-hm-tot {\n display: flex; align-items: center; justify-content: flex-end;\n padding-right: 2px;\n font: 12px/1 var(--av-font-mono); color: var(--ink-soft);\n font-variant-numeric: tabular-nums;\n }\n .stats-hm-head .stats-hm-tot {\n align-items: flex-start; padding-top: 3px;\n font-size: 9.5px; letter-spacing: 0.04em;\n }\n /* Cross-highlight: hovering a heatmap row or a table row lights up the\n matching species on the other side - the name shifts to the accent\n ink. Click opens the species' detail modal (data-sci delegation). */\n .stats-hm-row { cursor: pointer; }\n .stats-hm-row:hover .stats-hm-name,\n .stats-hm-row.sync-hi .stats-hm-name { background: var(--paper-2); }\n .stats-hm-row:hover .com,\n .stats-hm-row.sync-hi .com { color: var(--accent); }\n .stats-hm-empty {\n position: absolute; inset: 0;\n display: flex; align-items: center; justify-content: center;\n font: 11px var(--av-font-mono); color: var(--ink-soft);\n text-transform: lowercase; letter-spacing: 0.18em;\n }\n /* Caption under the matrix: what the columns cover (rolling window vs\n last-7-days aggregate) and whether the rows were trimmed. Sticky so\n it doesn't wander off when the plot scrolls sideways. */\n .stats-hm-cap {\n position: sticky; left: 0;\n padding: 8px 0 2px;\n font: 8.5px/1 var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em;\n }\n /* Phones: fixed-width cells -> the plot grows past the viewport and\n scrolls horizontally under the sticky name column. */\n @container av-card (max-width: 700px) {\n .stats-hm { --hm-name: 104px; min-width: max-content; }\n .stats-hm-head, .stats-hm-row {\n grid-template-columns: var(--hm-name) repeat(24, 26px) 40px;\n }\n }\n\n /* (Old chart-card / .stats-charts CSS removed - replaced by the\n activity heatmap above.) */\n\n .stats-side {\n display: flex; flex-direction: column; justify-content: center;\n align-self: stretch; max-height: 100%;\n padding: 6px 0;\n }\n .stats-side h3 {\n font: 700 11.5px var(--av-font-mono); color: var(--ink);\n letter-spacing: 0.18em; text-transform: uppercase; margin: 0 0 1px;\n border-left: 2px solid var(--accent); padding-left: 10px;\n }\n /* Tight, content-sized groups - they sit just below their headers\n rather than spreading to fill the column. */\n .stats-side .grp { flex: 0 0 auto; }\n .stats-side .grp + .grp { margin-top: 22px; }\n .stats-side .grp small {\n display: block; font: 10px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em; margin: 0 0 3px 12px;\n }\n /* Sits under the By Period list rather than above it, so its own\n top margin replaces the subtitle's bottom one. */\n .stats-side .grp small.mic-note { margin: 6px 0 0 12px; }\n /* The whole list is one grid so counts share an aligned column, sized\n to the longest name (max-content) so that column sits right beside\n the names instead of stretching to a far edge. Each row is a subgrid\n so it still gets its own hover background + separator. */\n .stats-side ol {\n list-style: none; padding: 0; margin: 0;\n display: grid; grid-template-columns: 40px max-content 1fr;\n column-gap: 14px; align-content: start;\n }\n .stats-side li {\n display: grid; grid-template-columns: subgrid; grid-column: 1 / -1;\n align-items: baseline; padding: 3px 0;\n box-shadow: inset 0 -1px 0 rgba(26,22,18,0.05);\n font: 14px/1.3 var(--av-font-display); color: var(--ink);\n transition: background 140ms ease, color 140ms ease;\n }\n .stats-side li[data-sci] { cursor: pointer; }\n .stats-side li[data-sci]:hover { background: var(--paper-2); }\n /* Cross-highlight from a hovered timeline square. */\n .stats-side li.sync-hi { background: var(--paper-2); }\n .stats-side li.sync-hi span:not(.yr):not(.ct) { color: var(--accent); }\n .stats-side li .yr { font: 11px var(--av-font-mono); color: var(--accent-2); letter-spacing: 0.04em; }\n .stats-side li .ct { font: 13px var(--av-font-mono); color: var(--ink-soft); font-variant-numeric: tabular-nums; justify-self: end; }\n\n /* (Histogram strip removed - charts moved into the stats-grid LEFT\n column as full-bleed chart cards. See .stats-charts above.) */\n\n /* ============ View 3 - Atlas ============\n Field-guide grid: one card per species, each card holds the cutout,\n names, window/all-time detection counts, and small action chips for\n audio playback, Wikipedia, and eBird. */\n .atlas-controls {\n max-width: 1280px; margin: 0 auto 18px;\n display: flex; justify-content: flex-end; align-items: center;\n }\n .atlas-sort {\n display: inline-flex; padding: 3px; position: relative;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n }\n .atlas-sort button {\n background: transparent; border: 0; color: var(--ink-soft);\n width: 30px; height: 26px; padding: 0; border-radius: 999px;\n cursor: pointer; position: relative; z-index: 1;\n display: inline-flex; align-items: center; justify-content: center;\n transition: color 200ms ease;\n }\n .atlas-sort button svg { width: 13px; height: 13px; display: block; }\n .atlas-sort button:hover { color: var(--ink); }\n .atlas-sort button[aria-current=\"true\"] { color: var(--ink); }\n .atlas-sort button .tip {\n position: absolute; top: calc(100% + 6px); left: 50%;\n transform: translateX(-50%); white-space: nowrap;\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; color: var(--ink-soft);\n background: var(--paper); padding: 3px 8px; border-radius: 4px;\n box-shadow: var(--raised);\n opacity: 0; pointer-events: none; transition: opacity 160ms ease;\n }\n .atlas-sort button:hover .tip { opacity: 1; }\n .atlas-grid {\n display: grid;\n grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));\n gap: 22px;\n max-width: 1280px; margin: 0 auto;\n }\n /* Mobile atlas: a compact 2-up grid instead of one giant card per row,\n so you can scan many birds and tap easily. Inline actions are hidden -\n tapping the card opens the detail modal, which has play/wiki/ebird +\n recordings - making the whole card one big touch target. */\n @container av-card (max-width: 700px) {\n /* minmax(0,1fr) lets the columns shrink below their content's intrinsic\n width (otherwise the chips force overflow). Selectors are scoped under\n .atlas-grid so they out-specify the base .bird-card rules that appear\n later in the file. */\n .atlas-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; }\n .atlas-grid .bird-card { min-height: 0; padding: 12px 12px 14px; border-radius: 9px; }\n .atlas-grid .bird-card .stat { top: 10px; left: 11px; font-size: 8px; }\n .atlas-grid .bird-card .stat .n { font-size: 11px; }\n .atlas-grid .bird-card .img-wrap { margin: 30px 0 8px; }\n .atlas-grid .bird-card .img-wrap img { max-height: 96px; }\n .atlas-grid .bird-card h3 { font-size: 12.5px; }\n .atlas-grid .bird-card .sci { font-size: 9.5px; }\n .atlas-grid .bird-card .actions { display: none; }\n .atlas-grid .lifer-badge { top: 9px; right: 9px; font-size: 7px; padding: 3px 5px; letter-spacing: 0.1em; }\n }\n .bird-card {\n position: relative;\n background: var(--paper);\n border-radius: 10px;\n padding: 16px 16px 12px;\n box-shadow: var(--edge-lg);\n display: flex; flex-direction: column;\n min-height: 320px;\n cursor: pointer;\n transition: transform 200ms ease, box-shadow 200ms ease;\n }\n .bird-card:hover { transform: translateY(-1px); box-shadow: var(--edge-xl, 0 6px 16px rgba(26,22,18,0.12)); }\n .bird-card .actions, .bird-card .spectro-wrap { cursor: auto; }\n .bird-card .actions button, .bird-card .actions a { cursor: pointer; }\n .bird-card .stat {\n position: absolute; top: 14px; left: 16px;\n font: 9px/1.5 var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.04em;\n }\n /* \"lifer\" badge - shown top-right when a species' first-ever detection\n falls inside the selected window (set in renderAtlas). pointer-events\n off so it never blocks the card's click-to-open. */\n .lifer-badge {\n position: absolute; top: 12px; right: 12px; z-index: 2;\n font: 700 8px/1 var(--av-font-mono);\n letter-spacing: 0.14em; text-transform: uppercase;\n color: var(--paper); background: var(--accent);\n padding: 4px 7px; border-radius: 999px;\n box-shadow: 0 2px 6px rgba(26,22,18,0.18);\n pointer-events: none;\n }\n .bird-card .stat .n {\n color: var(--ink); font: 700 13px/1 var(--av-font-display);\n font-variant-numeric: tabular-nums; margin-right: 4px;\n letter-spacing: 0;\n }\n .bird-card .stat .lbl { display: block; }\n .bird-card .img-wrap {\n flex: 1 1 auto; min-height: 0;\n display: flex; align-items: center; justify-content: center;\n margin: 38px 0 10px;\n padding: 4px;\n }\n .bird-card .img-wrap img {\n max-width: 100%; max-height: 160px; display: block;\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n }\n .bird-card h3 {\n margin: 0;\n font: 700 14.5px/1.15 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.01em;\n }\n .bird-card .sci {\n font: italic 11px/1.2 var(--av-font-display);\n color: var(--ink-2); margin: 2px 0 0;\n }\n .bird-card .actions {\n display: flex; gap: 6px; align-items: stretch;\n margin-top: 12px; padding-top: 10px;\n box-shadow: inset 0 1px 0 rgba(26,22,18,0.07);\n }\n .bird-card .chip {\n flex: 0 0 auto;\n background: var(--paper-2);\n border: 0; color: var(--ink);\n padding: 5px 9px;\n border-radius: 4px;\n font: 9.5px/1 var(--av-font-mono);\n text-transform: lowercase; letter-spacing: 0.10em;\n text-decoration: none;\n cursor: pointer;\n display: inline-flex; align-items: center; gap: 5px;\n box-shadow: var(--raised);\n transition: transform 160ms ease, color 160ms ease;\n white-space: nowrap;\n }\n .bird-card .chip:hover {\n color: var(--ink); transform: translateY(-1px);\n }\n .bird-card .chip[data-active=\"true\"] {\n color: var(--paper);\n background: var(--ink);\n }\n .bird-card .chip svg { width: 10px; height: 10px; display: block; }\n .bird-card .chip.play { padding-left: 7px; }\n .bird-card .chip.ext::after { content: '↗'; opacity: 0.6; font-size: 11px; }\n\n /* Selected card highlight - matches the page-slider and time-window\n pill aesthetic: the active element is a slightly *brighter* paper\n surface (raised) on top of a slightly *recessed* background.\n No accent colour, no glowing ring - just the same depth shadow\n recipe the rest of the chrome uses. */\n .bird-card { transition: transform 280ms cubic-bezier(.7,.05,.2,1), box-shadow 280ms ease, background 200ms ease; }\n .bird-card[data-active=\"true\"] {\n background: var(--paper);\n box-shadow:\n inset 0 0 0 1px rgba(255,255,255,0.85),\n 0 0 0 1px rgba(26,22,18,0.06),\n 0 10px 26px rgba(26,22,18,0.10);\n transform: translateY(-1px);\n }\n .bird-card[data-pulse=\"true\"] {\n animation: bird-card-pulse 520ms cubic-bezier(.45,.05,.2,1);\n }\n /* Soft fade-in of the raised state, no ring pulse */\n @keyframes bird-card-pulse {\n 0% { transform: translateY(2px); }\n 100% { transform: translateY(-1px); }\n }\n\n .atlas-empty {\n grid-column: 1 / -1;\n padding: 80px 16px; text-align: center;\n font: 12px/1.6 var(--av-font-display); color: var(--ink-2);\n }\n .atlas-empty p { margin: 0 0 4px; }\n .atlas-empty p.hint {\n font: 10px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em;\n }\n\n /* ============ Admin screen (system / logs / tools) ============\n Overlays the slider when activated via #admin=... hash. Lives\n inside the same shell as the rest of the app so the header,\n menu button, and time-window pill stay put - feels native. */\n .admin-screen {\n position: absolute; inset: 60px 0 60px 0;\n background: var(--bg);\n overflow-y: auto;\n z-index: 5;\n opacity: 0; pointer-events: none;\n transition: opacity 200ms ease;\n }\n .admin-screen[aria-hidden=\"false\"] { opacity: 1; pointer-events: auto; }\n .admin-frame {\n max-width: 1100px; margin: 0 auto; padding: 0 28px 40px;\n }\n .admin-title {\n text-align: center; margin: 0 auto 28px;\n }\n .admin-title h1 {\n margin: 0;\n font: 32px/1.1 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.005em;\n }\n /* Return-to-atlas pill in the same slot the time-window pill\n normally lives - matches its visual language. */\n .return-to-atlas {\n position: absolute; top: 18px; left: 20px; z-index: 6;\n display: none; align-items: center; gap: 6px;\n padding: 7px 14px; border-radius: 999px;\n background: var(--paper-2);\n color: var(--ink-soft);\n font: 10px var(--av-font-mono); letter-spacing: 0.18em;\n text-transform: lowercase; cursor: pointer;\n text-decoration: none;\n box-shadow: var(--recess);\n transition: color 200ms ease;\n }\n .av-shell.admin-on .return-to-atlas { display: inline-flex; }\n .av-shell.admin-on #slider { visibility: hidden; }\n .av-shell.admin-on .static-head { opacity: 0; pointer-events: none; }\n /* Hide the time-window pill on admin pages (it doesn't apply\n there) - the return-to-atlas link takes its slot. */\n .av-shell.admin-on #winPick { visibility: hidden; }\n .return-to-atlas:hover { color: var(--ink); }\n .return-to-atlas svg { width: 10px; height: 10px; }\n .admin-body { padding-top: 4px; }\n .admin-grid {\n display: grid; gap: 14px;\n grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));\n margin-bottom: 22px;\n }\n .admin-card {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; box-shadow: var(--edge);\n }\n .admin-card h3 {\n margin: 0 0 6px; font: 10px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink-soft); font-weight: 500;\n }\n .admin-card .v { font: 20px var(--av-font-display); color: var(--ink); }\n .admin-card .sub { font: 11px var(--av-font-mono); color: var(--ink-soft); margin-top: 4px; }\n .admin-card.alert { box-shadow: 0 0 0 1px var(--accent), var(--edge); }\n .admin-card.alert h3 { color: var(--accent); }\n .admin-card.warn { box-shadow: 0 0 0 1px #c47a1f, var(--edge); }\n .admin-card.warn h3 { color: #c47a1f; }\n .admin-section-head {\n font: 700 11px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink); margin: 24px 0 10px;\n border-left: 2px solid var(--accent-2); padding-left: 10px;\n }\n table.admin-tbl {\n width: 100%; border-collapse: collapse;\n font: 12px var(--av-font-mono);\n background: var(--paper); border-radius: 8px; overflow: hidden;\n box-shadow: var(--edge);\n }\n table.admin-tbl th, table.admin-tbl td {\n border-bottom: 1px solid var(--rule, #c8bfae);\n padding: 9px 12px; text-align: left;\n }\n table.admin-tbl tr:last-child th, table.admin-tbl tr:last-child td { border-bottom: 0; }\n table.admin-tbl th {\n color: var(--ink-soft); text-transform: uppercase;\n font-size: 9.5px; letter-spacing: 0.14em; font-weight: 500;\n }\n table.admin-tbl .pill {\n display: inline-block; padding: 1px 8px; border-radius: 999px;\n font-size: 9.5px; letter-spacing: 0.06em; text-transform: uppercase;\n }\n table.admin-tbl .pill.active { background: rgba(90,122,58,.18); color: #4d6730; }\n table.admin-tbl .pill.inactive { background: rgba(168,52,29,.18); color: var(--accent); }\n table.admin-tbl .pill.failed { background: rgba(168,52,29,.18); color: var(--accent); }\n table.admin-tbl button.restart {\n font: 9.5px var(--av-font-mono);\n letter-spacing: 0.04em; text-transform: lowercase;\n padding: 4px 10px; border: 0; background: var(--paper-2);\n border-radius: 4px; cursor: pointer; color: var(--ink-soft);\n box-shadow: var(--raised);\n }\n table.admin-tbl button.restart:hover { color: var(--ink); }\n table.admin-tbl button.restart[disabled] { opacity: .5; cursor: wait; }\n .admin-logs-toolbar {\n display: flex; gap: 8px; align-items: center; margin-bottom: 14px;\n }\n .admin-logs-toolbar select, .admin-logs-toolbar input[type=\"number\"] {\n font: 12px var(--av-font-mono);\n padding: 6px 10px; border: 1px solid var(--rule, #c8bfae);\n border-radius: 4px; background: var(--paper); color: var(--ink);\n }\n .admin-logs-toolbar label {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: uppercase; color: var(--ink-soft);\n }\n .admin-logs-pane {\n background: #1c1a14; color: #d7cba8;\n font: 12px/1.5 var(--av-font-mono);\n padding: 14px 16px; border-radius: 8px;\n max-height: 65cqh; overflow: auto; white-space: pre-wrap;\n }\n .admin-actions-grid {\n display: grid; gap: 12px;\n grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));\n }\n .admin-action {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; box-shadow: var(--edge);\n }\n .admin-action h4 { margin: 0 0 6px; font: 15px var(--av-font-display); color: var(--ink); }\n .admin-action p { margin: 0 0 10px; font: 12.5px var(--av-font-display); color: var(--ink-soft); }\n .admin-action button.run {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; padding: 6px 12px; border: 0;\n background: var(--ink); color: var(--paper); border-radius: 999px;\n cursor: pointer;\n }\n .admin-action button.run[disabled] { opacity: .5; cursor: wait; }\n .admin-action .out {\n margin-top: 10px; font: 10.5px var(--av-font-mono);\n color: var(--ink-soft); white-space: pre-wrap;\n }\n .admin-action.deploy pre {\n background: #1c1a14; color: #d7cba8;\n font: 11px var(--av-font-mono);\n padding: 12px 14px; border-radius: 6px;\n overflow: auto; white-space: pre-wrap; word-break: break-all;\n margin: 0;\n }\n .admin-action.deploy button.copy {\n font: 9.5px var(--av-font-mono); letter-spacing: 0.06em;\n text-transform: lowercase; padding: 5px 10px;\n background: var(--paper-2); color: var(--ink-soft);\n border: 0; border-radius: 4px; cursor: pointer; box-shadow: var(--raised);\n margin-top: 8px;\n }\n .admin-action.deploy button.copy:hover { color: var(--ink); }\n .admin-unreachable {\n background: var(--paper); border-radius: 8px;\n padding: 14px 16px; color: var(--accent);\n font: 12px var(--av-font-mono);\n margin-bottom: 18px; box-shadow: 0 0 0 1px var(--accent), var(--edge);\n }\n /* When admin screen is shown, the slider underneath is hidden so it\n doesn't compete for scrolling. The static title gets swapped out\n too - admin is its own section with its own visual identity.\n Menu button + time-window pill stay visible (still useful). */\n .av-shell.admin-on #views { display: none; }\n .av-shell.admin-on .nav-band,\n .av-shell.admin-on #slider { visibility: hidden; }\n .av-shell.admin-on .static-head { opacity: 0; pointer-events: none; transition: opacity 200ms ease; }\n\n /* Mobile compact: drawer takes near-full width, admin pads tighter,\n section heads + cards downsize. */\n @container av-card (max-width: 700px) {\n #menu-dd { top: 50px; right: 8px; left: 8px; width: auto; padding: 10px; }\n .admin-screen { inset: 52px 0 60px 0; }\n .admin-frame { padding: 0 14px 32px; }\n .admin-title { margin-bottom: 18px; }\n .admin-title h1 { font-size: 22px; }\n .admin-grid { gap: 10px; grid-template-columns: repeat(auto-fit, minmax(170px, 1fr)); }\n .admin-card { padding: 12px 14px; }\n .admin-card .v { font-size: 18px; }\n .admin-section-head { margin: 18px 0 8px; font-size: 10px; letter-spacing: 0.12em; }\n table.admin-tbl th, table.admin-tbl td { padding: 7px 8px; font-size: 11px; }\n .admin-actions-grid { gap: 10px; grid-template-columns: 1fr; }\n .admin-action { padding: 12px 14px; }\n /* Slider track bottom nav: tuck closer to bottom edge */\n .slider { bottom: 14px; padding: 3px; }\n .slider button { font-size: 9.5px; padding: 6px 11px; }\n }\n @container av-card (max-width: 700px) {\n /* Detail-modal: full-screen on small screens. */\n #detail-modal { padding: 12px; }\n /* Extra top padding = a clear strip for the close button, so the X\n sits in its own corner instead of on the artwork. */\n .modal-card { padding: 44px 18px 18px; border-radius: 10px; }\n .modal-close { top: 10px; right: 10px; }\n .modal-info h2 { font-size: 22px; }\n .modal-img { height: 160px; padding: 10px; }\n .modal-grid { gap: 18px; }\n /* Keep the description short so the recordings are in reach - the\n full text is one tap away on the wiki link. */\n .modal-info .desc {\n font-size: 12px; line-height: 1.5;\n display: -webkit-box; -webkit-line-clamp: 4;\n -webkit-box-orient: vertical; overflow: hidden;\n cursor: pointer;\n }\n .modal-info .desc.expanded { -webkit-line-clamp: unset; display: block; }\n .rec-row .when { font-size: 10.5px; }\n .rec-row .when small { font-size: 8.5px; }\n }\n\n /* ============ Detail modal (atlas card expansion) ============\n Click a bird card -> this fades in over a soft ink backdrop with\n the full sketch, taxonomic info, Wikipedia summary, and a\n scrollable list of every past audio capture for the species. */\n /* /about - a brief explainer popup floated over the index page.\n Reuses .modal-backdrop / .modal-close; opened by the #about hash. */\n #about-modal {\n position: absolute; inset: 0; z-index: 60;\n display: flex; align-items: center; justify-content: center;\n padding: 24px;\n pointer-events: none; opacity: 0;\n transition: opacity 200ms ease;\n }\n #about-modal[aria-hidden=\"false\"] { pointer-events: auto; opacity: 1; }\n .about-card {\n position: relative;\n max-width: 432px; width: 100%;\n background: var(--paper);\n border-radius: 14px;\n box-shadow:\n inset 0 0 0 1px rgba(255,255,255,0.6),\n 0 30px 80px rgba(26,22,18,0.24);\n padding: 34px 34px 28px;\n transform: translateY(10px) scale(0.985);\n transition: transform 260ms cubic-bezier(.32,.72,.32,1);\n }\n #about-modal[aria-hidden=\"false\"] .about-card { transform: none; }\n .about-card .about-eyebrow {\n margin: 0 0 7px;\n font: italic 400 13px/1 var(--av-font-display);\n color: var(--ink-2); letter-spacing: 0.06em;\n }\n .about-card h2 {\n margin: 0 0 13px;\n font: 700 22px/1.25 var(--av-font-display);\n letter-spacing: 0.01em; color: var(--ink);\n }\n .about-card .about-body {\n margin: 0;\n font: 400 14.5px/1.62 var(--av-font-display);\n color: var(--ink-2);\n }\n /* Plain inline link - same ink as the prose, a simple underline, no\n hover treatment. */\n .about-card .about-body a {\n color: inherit;\n text-decoration: underline;\n text-underline-offset: 2px;\n }\n .about-card .about-explore {\n margin-top: 20px;\n background: none; border: 0; padding: 0;\n font: 700 11px/1 var(--av-font-mono);\n letter-spacing: 0.08em; text-transform: lowercase;\n color: var(--ink-soft); cursor: pointer;\n transition: color 140ms ease;\n }\n .about-card .about-explore:hover { color: var(--ink); }\n #detail-modal {\n position: absolute; inset: 0; z-index: 50;\n display: flex; align-items: center; justify-content: center;\n padding: 24px;\n pointer-events: none; opacity: 0;\n /* One opacity fade for backdrop + card together; the card also\n morphs via transform (see morphModalOpen). Driven by .is-open so\n the fade can run *during* the close morph, not after it. */\n transition: opacity 260ms ease;\n }\n #detail-modal.is-open { pointer-events: auto; opacity: 1; }\n .modal-backdrop {\n position: absolute; inset: 0;\n background: rgba(26,22,18,0.32);\n backdrop-filter: blur(3px); -webkit-backdrop-filter: blur(3px);\n }\n .modal-card {\n position: relative;\n /* Cap to the overlay, NOT the viewport. #detail-modal is inset:0 with\n 24px padding, so 100% here == its content box == the old\n calc(100cqh - 48px) on a normal viewport - but robustly. In the card\n build 100cqh becomes 100cqh, and when Home Assistant gives the card an\n indefinite height (masonry / content-sized slots) Blink resolves cqh\n to 0, so calc(100cqh - 48px) collapsed to 0 and the modal shrank to a\n strip of padding (Chrome / HA companion WebView only; Firefox & Safari\n resolved it fine). % of the definite inset:0 overlay sidesteps that. */\n max-width: 920px; max-height: 100%;\n width: 100%;\n background: var(--paper);\n border-radius: 14px;\n /* A real border, not an inset shadow: borders paint outside the\n scrolling content box, so scrolled images/spectrograms can never\n slide over the card's outline. */\n border: 1px solid var(--hairline);\n box-shadow: 0 30px 80px rgba(26,22,18,0.22);\n padding: 30px 34px 26px;\n overflow: auto;\n /* The expand-from-card animation is driven by inline transform\n and opacity set on open/close - see openDetailModal. CSS\n transition handles the in-between glide. */\n transform-origin: 50% 50%;\n will-change: transform, opacity;\n }\n .modal-card.is-morphing {\n transition: transform 300ms cubic-bezier(.22,.61,.36,1);\n }\n .modal-close {\n position: absolute; top: 16px; right: 16px;\n background: var(--paper-2); border: 0;\n width: 30px; height: 30px; border-radius: 999px;\n font: 16px/1 var(--av-font-mono); color: var(--ink);\n box-shadow: var(--raised);\n cursor: pointer; z-index: 1;\n }\n .modal-close:hover { color: var(--accent-2); }\n .modal-grid {\n display: grid; grid-template-columns: 1fr 1.15fr; gap: 32px;\n align-items: start;\n }\n @container av-card (max-width: 700px) {\n .modal-grid { grid-template-columns: 1fr; gap: 22px; }\n .modal-card { padding: 22px; }\n }\n .modal-img {\n position: relative;\n background: var(--paper-2); border-radius: 10px;\n display: flex; align-items: center; justify-content: center;\n padding: 16px;\n /* Fixed frame: the illustration fits INSIDE it (object-fit) instead\n of the frame growing to the illustration's aspect. */\n height: 230px;\n box-shadow: var(--recess);\n }\n .modal-img img {\n max-width: 100%; max-height: 100%;\n width: auto; height: auto; object-fit: contain;\n filter: drop-shadow(0 2px 6px rgba(26,22,18,0.10));\n transition: opacity 220ms ease;\n }\n .modal-img img.swapping { opacity: 0; }\n /* Pose toggle - bottom-left corner of the modal sketch, icon strip.\n Same recipe as the time-window slider: recessed paper-2 well, a\n white sliding pill behind the active button (via .seg-pill), and\n a color shift on the icon itself. */\n .pose-toggle {\n position: absolute; left: 10px; bottom: 10px;\n display: inline-flex; padding: 3px;\n background: var(--paper-2); border-radius: 999px;\n box-shadow: var(--recess);\n z-index: 2;\n }\n .pose-toggle button {\n background: transparent; border: 0; color: var(--ink-soft);\n width: 30px; height: 26px; padding: 0; border-radius: 999px;\n cursor: pointer; position: relative; z-index: 1;\n display: inline-flex; align-items: center; justify-content: center;\n transition: color 200ms ease;\n }\n .pose-toggle button svg { width: 13px; height: 13px; display: block; }\n .pose-toggle button:hover { color: var(--ink); }\n .pose-toggle button[aria-current=\"true\"] { color: var(--ink); }\n .pose-toggle button .tip {\n position: absolute; bottom: calc(100% + 6px); left: 50%;\n transform: translateX(-50%); white-space: nowrap;\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase; color: var(--ink-soft);\n background: var(--paper); padding: 3px 8px; border-radius: 4px;\n box-shadow: var(--raised);\n opacity: 0; pointer-events: none; transition: opacity 160ms ease;\n }\n .pose-toggle button:hover .tip { opacity: 1; }\n .pose-toggle[data-unavailable=\"true\"] { display: none; }\n .pose-toggle button[data-unavailable=\"true\"] { display: none; }\n .modal-info h2 {\n margin: 4px 36px 0 0;\n font: 700 26px/1.1 var(--av-font-display);\n color: var(--ink); letter-spacing: 0.01em;\n }\n .modal-info .sci {\n font: italic 13.5px/1.3 var(--av-font-display);\n color: var(--ink-2); margin: 4px 0 6px;\n }\n .modal-stats {\n display: grid; grid-template-columns: repeat(3, 1fr); gap: 8px;\n margin-bottom: 18px;\n }\n .modal-stats > div {\n background: var(--paper-2);\n border-radius: 6px; padding: 10px 12px;\n box-shadow: var(--recess);\n }\n .modal-stats .n {\n display: block;\n font: 800 17px/1 var(--av-font-display);\n color: var(--ink); font-variant-numeric: tabular-nums;\n }\n .modal-stats .lbl {\n display: block; margin-top: 4px;\n font: 8.5px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.12em;\n text-transform: uppercase;\n }\n .modal-info .desc {\n font: 13px/1.55 var(--av-font-display);\n color: var(--ink); margin: 0 0 10px;\n }\n .modal-info .desc.placeholder { color: var(--ink-soft); font-style: italic; }\n .modal-meta {\n display: flex; flex-wrap: wrap; gap: 16px;\n font: 9.5px var(--av-font-mono); color: var(--ink-soft);\n margin: 0 0 14px;\n }\n .modal-meta .k { letter-spacing: 0.12em; text-transform: uppercase; }\n .modal-meta .v { color: var(--ink); margin-left: 6px; }\n .modal-meta .v.rare { color: var(--accent-2); }\n .modal-recordings {\n margin-top: 14px; padding-top: 14px;\n box-shadow: inset 0 1px 0 rgba(26,22,18,0.07);\n }\n .modal-recordings .rec-head {\n display: flex; align-items: baseline; justify-content: space-between;\n margin-bottom: 8px;\n }\n .modal-recordings h3 {\n font: 700 10px var(--av-font-mono);\n letter-spacing: 0.18em; text-transform: uppercase;\n color: var(--ink); margin: 0;\n border-left: 2px solid var(--accent-2); padding-left: 10px;\n }\n .modal-recordings .rec-count {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.06em;\n }\n /* Reference-call (Xeno-Canto) button + its attribution line. */\n .modal-recordings .rec-head { gap: 8px; align-items: center; }\n .modal-recordings .rec-count { margin-left: auto; }\n .ref-call-btn {\n display: inline-flex; align-items: center; gap: 5px;\n font: 700 9px var(--av-font-mono); letter-spacing: 0.1em; text-transform: uppercase;\n color: var(--ink-soft); background: var(--paper); white-space: nowrap;\n border: 1px solid var(--hairline); border-radius: 999px;\n padding: 4px 11px 4px 9px; cursor: pointer;\n transition: color 160ms ease, background 160ms ease, border-color 160ms ease, transform 120ms ease;\n }\n .ref-call-btn svg { width: 9px; height: 9px; display: block; }\n .ref-call-btn:hover { color: var(--ink); background: var(--paper-2); transform: translateY(-1px); }\n .ref-call-btn[data-active=\"true\"] { color: var(--accent-2); border-color: var(--ink-soft); }\n .ref-call-btn.loading { opacity: 0.65; cursor: progress; }\n .ref-credit {\n font: 9px var(--av-font-mono); color: var(--ink-soft);\n letter-spacing: 0.04em; line-height: 1.55; margin: -2px 0 8px;\n }\n .ref-credit a { color: var(--ink-2); text-decoration: underline; text-underline-offset: 2px; }\n .ref-credit a:hover { color: var(--ink); }\n .modal-recordings ol {\n list-style: none; padding: 0; margin: 0;\n max-height: 220px; overflow-y: auto;\n display: flex; flex-direction: column; gap: 4px;\n padding-right: 4px;\n }\n .rec-row {\n display: grid; grid-template-columns: 30px 1fr auto auto; gap: 10px;\n align-items: center;\n padding: 6px 10px; border-radius: 6px;\n background: var(--paper);\n box-shadow: var(--edge);\n transition: background 160ms ease;\n }\n .rec-row:hover { background: var(--paper-2); }\n .rec-row.expanded { grid-template-columns: 30px 1fr auto; }\n /* Spectrogram strip - inline below the row header. Click on the row\n toggles open/closed independent of playback so you can scan\n spectrograms visually without listening. */\n .rec-spectro {\n grid-column: 1 / -1;\n margin-top: 8px;\n height: 0; overflow: hidden;\n border-radius: 4px;\n /* Paper background - the spectrogram canvas paints ink ON it,\n matching the sketch palette. */\n background: var(--paper-2);\n box-shadow: var(--recess);\n position: relative;\n transition: height 240ms cubic-bezier(.7,.05,.2,1);\n }\n .rec-row.expanded .rec-spectro { height: 88px; }\n /* The spectrogram is rendered client-side onto a canvas - we fetch\n the mp3, decode via Web Audio, run an STFT, and paint columns\n with our ink palette. No BirdNET-Pi PNG involved. */\n .rec-spectro canvas {\n position: absolute; inset: 0;\n width: 100%; height: 100%;\n display: block;\n opacity: 0; transition: opacity 240ms ease;\n }\n .rec-spectro canvas.ready { opacity: 1; }\n .rec-spectro .rec-spectro-loading {\n position: absolute; inset: 0;\n display: flex; align-items: center; justify-content: center;\n color: var(--ink-soft);\n font: 9px var(--av-font-mono); letter-spacing: 0.14em;\n text-transform: lowercase;\n pointer-events: none;\n }\n /* Played portion - soft ink wash over the paper ground. */\n .rec-spectro .rec-spectro-played {\n position: absolute; left: 0; top: 0; bottom: 0; width: 0%;\n background: linear-gradient(90deg, rgba(26,22,18,0.16), rgba(26,22,18,0.06));\n pointer-events: none;\n }\n /* Cursor - sliding paper pill with a raised shadow, same recipe as\n the time-window slider's seg-pill. Pops against both the bright\n paper regions of the spectrogram and the inked vocalization\n bands. */\n .rec-spectro .rec-spectro-cursor {\n position: absolute; top: 50%; left: 0;\n width: 14px; height: 20px;\n transform: translate(-50%, -50%);\n background: var(--paper);\n border-radius: 999px;\n box-shadow: 0 1px 3px rgba(26,22,18,0.30), inset 0 0 0 1px rgba(26,22,18,0.18);\n pointer-events: none;\n opacity: 0;\n }\n .rec-spectro .rec-spectro-cursor::after {\n content: '';\n position: absolute; left: 50%; top: -100%; bottom: -100%;\n width: 1.5px; transform: translateX(-50%);\n background: rgba(251,247,238,0.85);\n box-shadow: 0 0 0 0.5px rgba(26,22,18,0.20);\n }\n .rec-spectro.armed .rec-spectro-cursor { opacity: 1; }\n /* Dark mode: the spectrogram ground is charcoal (paintSpectrogram paints\n with --paper), so the dark played-veil and the --paper cursor pill would\n both vanish into it. Flip the veil light, and make the cursor a light\n pill so it still reads against the dark ground. */\n :host([data-theme=\"dark\"]) .rec-spectro .rec-spectro-played {\n background: linear-gradient(90deg, rgba(236,232,225,0.18), rgba(236,232,225,0.07));\n }\n :host([data-theme=\"dark\"]) .rec-spectro .rec-spectro-cursor {\n background: var(--ink);\n }\n .rec-spectro .rec-spectro-scrub {\n position: absolute; inset: 0;\n cursor: ew-resize;\n }\n .rec-row .play {\n background: var(--paper-2); border: 0; color: var(--ink);\n width: 24px; height: 24px; border-radius: 999px;\n display: inline-flex; align-items: center; justify-content: center;\n box-shadow: var(--raised); cursor: pointer;\n padding: 0;\n }\n .rec-row .play svg { width: 8px; height: 8px; }\n .rec-row .play[data-active=\"true\"] {\n background: var(--ink); color: var(--paper);\n }\n .rec-row .when {\n font: 11px/1.2 var(--av-font-mono); color: var(--ink);\n }\n .rec-row .when small {\n display: block; font-size: 9px; color: var(--ink-soft);\n letter-spacing: 0.06em; margin-top: 1px;\n }\n .rec-row .conf {\n font: 10px var(--av-font-mono);\n color: var(--ink-soft); letter-spacing: 0.06em;\n font-variant-numeric: tabular-nums;\n }\n .rec-empty {\n padding: 14px;\n font: 11px/1.5 var(--av-font-display); color: var(--ink-soft);\n text-align: center;\n }\n .modal-actions {\n display: flex; gap: 8px; margin-top: 18px;\n }\n .modal-actions .chip {\n flex: 0 0 auto;\n background: var(--paper-2);\n border: 0; color: var(--ink);\n padding: 7px 12px;\n border-radius: 4px;\n font: 10px/1 var(--av-font-mono);\n text-transform: lowercase; letter-spacing: 0.12em;\n text-decoration: none;\n display: inline-flex; align-items: center; gap: 5px;\n box-shadow: var(--raised);\n transition: transform 160ms ease;\n }\n .modal-actions .chip:hover { transform: translateY(-1px); }\n .modal-actions .chip.ext::after { content: '↗'; opacity: 0.6; }\n\n /* Spectrogram appears on first audio play. Recoloured via CSS filter\n so BirdNET-Pi's default colour spectrogram comes out as a clean\n monochrome ink strip, matching the rest of the chart. Click to\n replay; a thin progress bar tracks playback in real time. */\n .bird-card .spectro-wrap {\n position: relative;\n min-height: 0; margin: 6px 0 2px;\n cursor: pointer;\n overflow: hidden;\n border-radius: 3px;\n box-shadow: var(--recess);\n }\n .bird-card .spectro-wrap:empty { display: none; }\n /* Canvas is painted client-side in the active theme's paper/ink palette\n (paintSpectrogram reads data-theme), so it follows light/dark mode with\n no CSS filter - same renderer as the modal recording spectrograms. */\n .bird-card .spectro-wrap canvas {\n width: 100%; height: 44px; display: block;\n }\n /* Progress wash: a translucent veil that grows as the clip plays. Ink in\n light mode; in dark mode a light veil so it stays visible over the\n charcoal spectrogram ground. */\n .bird-card .spectro-wrap::after {\n content: '';\n position: absolute; top: 0; bottom: 0; left: 0;\n width: var(--prog, 0%);\n background: linear-gradient(to right, rgba(26,22,18,0.30), rgba(26,22,18,0.05));\n pointer-events: none;\n transition: width 60ms linear;\n }\n :host([data-theme=\"dark\"]) .bird-card .spectro-wrap::after {\n background: linear-gradient(to right, rgba(236,232,225,0.26), rgba(236,232,225,0.05));\n }\n /* Playhead - thin vertical line at the leading edge */\n .bird-card .spectro-wrap::before {\n content: '';\n position: absolute; top: 0; bottom: 0;\n left: var(--prog, 0%);\n width: 1px;\n background: var(--ink);\n opacity: var(--playhead, 0);\n pointer-events: none;\n transition: opacity 200ms ease;\n }\n .bird-card[data-playing=\"true\"] .spectro-wrap::before { --playhead: 0.6; }\n\n/* ============ AvianVisitors mode toggle ============\n * Default install (.av-shell.av-local): hide the lock-row, show drawer items\n * directly when the menu opens. The PHP shim at /avian/api/menu.php\n * returns items immediately with no auth, so the live JS skips the lock\n * flow entirely.\n *\n * Forwarded install (body.av-forwarded): show the lock row so users\n * type the basic-auth password before items unlock. Pair with\n * AV_REQUIRE_AUTH=1 in php-fpm env + Caddy basic_auth on /avian/api/.\n * See avian/forwarding/. */\n.av-shell.av-local #dd-locked { display: none; }\n.av-shell.av-local #dd-items { display: block; }\n\n/* ============ Wall-display widgets (HA build) ============\n Clock + weather as a quiet corner block INSIDE the collage view.\n renderCollage() stamps this element's box into the silhouette-packing\n grid, so when the flock grows the birds nest around the numerals the\n same way they nest around each other. Same editorial recipe as the\n rest of the page: a serif display line over a monospace, letterspaced\n micro-caption, on the paper/ink variables so dark theme inverts free.\n pointer-events:none keeps hover/click hit-testing on the birds. */\n.wall-widgets {\n position: absolute; z-index: 6;\n display: flex; flex-direction: column; gap: 10px;\n pointer-events: none;\n}\n.wall-widgets[hidden] { display: none; }\n.wall-widgets[data-corner=\"bottom-right\"] { right: 36px; bottom: 96px; align-items: flex-end; text-align: right; }\n.wall-widgets[data-corner=\"bottom-left\"] { left: 36px; bottom: 96px; align-items: flex-start; text-align: left; }\n.wall-widgets[data-corner=\"top-right\"] { right: 36px; top: 14px; align-items: flex-end; text-align: right; }\n.wall-widgets[data-corner=\"top-left\"] { left: 36px; top: 14px; align-items: flex-start; text-align: left; }\n.ww-block { display: flex; flex-direction: column; gap: 3px; }\n.wall-widgets[data-corner$=\"right\"] .ww-block { align-items: flex-end; }\n.wall-widgets[data-corner$=\"left\"] .ww-block { align-items: flex-start; }\n.ww-block[hidden] { display: none; }\n.ww-big {\n font: 600 clamp(26px, 3cqw, 40px)/1 var(--av-font-display);\n color: var(--ink);\n font-variant-numeric: tabular-nums;\n letter-spacing: 0.01em;\n}\n.ww-cap {\n font: 9.5px/1.45 var(--av-font-mono);\n letter-spacing: 0.16em; text-transform: uppercase;\n color: var(--ink-soft);\n}\n.ww-cap:empty { display: none; }\n.ww-rule {\n width: 44px; height: 1px;\n background: var(--hairline);\n}\n.ww-rule[hidden] { display: none; }\n@container av-card (max-width: 700px) {\n .wall-widgets { gap: 8px; }\n .wall-widgets[data-corner$=\"right\"] { right: 18px; }\n .wall-widgets[data-corner$=\"left\"] { left: 18px; }\n .wall-widgets[data-corner^=\"bottom\"] { bottom: 92px; }\n .ww-big { font-size: 20px; }\n .ww-cap { font-size: 8px; letter-spacing: 0.1em; }\n /* The sunrise/sunset caption is the first thing to go on a phone. */\n #wwSun { display: none; }\n}\n/* Kiosk cursor hiding - applied to <body> by apt.js after idle when the\n wall options ask for it. */\n.av-shell.ww-cursor-hidden, .av-shell.ww-cursor-hidden * { cursor: none !important; }\n\n/* ---- Card build: configured title floats over the collage ---- */\n/* When a card sets a custom title, the heading is lifted out of the\n flex flow and overlaid on the collage top; renderCollage stamps the\n h1's box into the packing grid so birds nest around the words,\n clock-style. Stats/atlas keep headroom so their content doesn't\n slide under it. */\n.av-shell.av-title-overlay .static-head {\n position: absolute; top: 6px; left: 0; right: 0; z-index: 6;\n pointer-events: none; padding: 26px 32px 0;\n}\n.av-shell.av-title-overlay .view#v1,\n.av-shell.av-title-overlay .view#v2 { padding-top: 96px; }\n\n/* Card option: view picker pinned to the top edge instead of bottom. */\n.av-shell.av-picker-top .slider { top: 10px; bottom: auto; }\n.av-shell.av-picker-top .view { padding-bottom: 28px; }\n.av-shell.av-picker-top .view#v0, .av-shell.av-picker-top .view#v1 { padding-bottom: 24px; }\n\n/* ---- Recording-row review flag ---- */\n/* Writes a false-positive review back to BirdNET-Go. A quiet ghost x\n beside the confidence; first tap arms it into a labelled pill, second\n tap confirms - a stray touch can't flag anything. */\n.rec-row .flag {\n justify-self: end;\n min-width: 22px; height: 22px;\n display: inline-flex; align-items: center; justify-content: center;\n background: transparent; border: 0; border-radius: 999px;\n font: 10px/1 var(--av-font-mono); letter-spacing: 0;\n color: var(--ink-soft);\n padding: 0 6px; cursor: pointer; white-space: nowrap;\n transition: color 140ms ease, background 140ms ease;\n}\n.rec-row .flag:hover { color: var(--ink); background: var(--paper-2); }\n.rec-row .flag[data-state=\"armed\"] {\n background: var(--accent-2); color: var(--paper);\n font-size: 9px; letter-spacing: 0.08em; text-transform: uppercase;\n padding: 0 9px;\n}\n.rec-row .flag[data-state=\"done\"] { color: var(--ink); cursor: default; }\n.rec-row .flag[data-state=\"failed\"] {\n color: var(--accent-2); font-weight: 700;\n font-size: 8.5px; letter-spacing: 0.06em; text-transform: uppercase;\n}\n.rec-row .flag:disabled { cursor: default; }\n.rec-row.flagged .when, .rec-row.flagged .conf { text-decoration: line-through; opacity: 0.55; }\n\n/* ---- card-build additions ---- */\n:host {\n display: block; position: relative;\n width: 100%; height: 100%; min-height: 560px;\n overflow: hidden;\n border-radius: var(--ha-card-border-radius, 12px);\n /* The card box is the responsive container all @container rules and\n cq units resolve against. */\n container: av-card / size;\n}\n.av-shell { position: absolute; inset: 0; overflow: hidden; }\n/* Card default: transparent, so the collage sits directly on the HA\n dashboard. background: paper restores the page's warm ground. */\n.av-shell { background: transparent; }\n.av-shell.av-bg-paper { background: var(--paper); }\n/* font: system swaps the editorial serif/mono pairing for HA's own\n typeface (set per-theme by HA; Roboto stock). */\n.av-shell.av-font-system {\n --av-font-display: var(--ha-font-family-body, var(--mdc-typography-font-family, Roboto, \"Segoe UI\", sans-serif));\n --av-font-mono: var(--ha-font-family-body, var(--mdc-typography-font-family, Roboto, \"Segoe UI\", sans-serif));\n}\n/* The view picker hugs the card's bottom edge (the page floats it higher). */\n.slider { bottom: 10px; }\n/* The collage owns the WHOLE card - no reserved band for the picker\n (it's stamped into the packing grid as an obstacle instead), so the\n flock centres in the true middle of the card. */\n.view#v0 { padding: 12px 14px; }\n/* Clock/weather sit a finger's width off the card's true corners. */\n.wall-widgets[data-corner$=\"right\"] { right: 16px; }\n.wall-widgets[data-corner$=\"left\"] { left: 16px; }\n.wall-widgets[data-corner^=\"top\"] { top: 12px; }\n.wall-widgets[data-corner^=\"bottom\"] { bottom: 14px; }\n/* In system-font mode the empty state reads as a normal sentence in the\n configured font instead of editorial letterspaced small-caps. */\n.av-shell.av-font-system .empty {\n font: 14px/1.5 var(--av-font-mono);\n text-transform: none; letter-spacing: 0;\n}\n/* In system-font mode the picker drops the editorial small-caps treatment\n and reads like native HA tabs. */\n.av-shell.av-font-system .slider button {\n font: 500 13px/1 var(--av-font-mono);\n letter-spacing: 0; text-transform: capitalize;\n padding: 9px 16px;\n}\n/* BirdNET-Pi admin chrome has no backend here (same as the static HA build). */\n#menuBtn, #menu-dd, #returnToAtlas, #adminScreen { display: none !important; }\n";
// Generated by avian/scripts/build_masks.py - DO NOT EDIT BY HAND.
// DIMS[slug] = [w, h]; MASKS[slug] = { w, h, bits } 1-bit silhouettes
@@ -70,6 +70,11 @@ var DIRS = {"acanthis-flammea-2":213,"acanthiza-chrysorrhoa-2":208,"acanthiza-li
'stats.today': 'today',
'stats.last7days': 'last 7 days',
'stats.allTime': 'all time',
+ // Shown only when >=1 auto-discovered HA microphone sensor is offline
+ // (native MQTT discovery's availability topic reads 'unavailable').
+ 'stats.micsOffline': '{n} microphone(s) offline',
+ // Same note, but naming the one offline mic (HA formatEntityName available).
+ 'stats.micOfflineNamed': '{name} is offline',
// ---- Stats: Top Species ----
'stats.topSpecies': 'Top Species',
'stats.topSpecCap': 'most-heard, {window}',
@@ -100,6 +105,9 @@ var DIRS = {"acanthis-flammea-2":213,"acanthiza-chrysorrhoa-2":208,"acanthiza-li
'atlas.new': 'new',
'atlas.newTitle': 'first time this species has ever been heard here',
+ // ---- API errors ----
+ 'error.privateMode': 'BirdNET-Go requires sign-in (Private Mode) — set api_token in the card config',
+
// ---- Detail modal: chrome ----
'modal.close': 'Close',
'modal.pose': 'Pose',
@@ -160,6 +168,8 @@ var DIRS = {"acanthis-flammea-2":213,"acanthiza-chrysorrhoa-2":208,"acanthiza-li
'flag.couldNotSave': 'could not save: {why}',
'flag.needsIngress': 'needs the HA ingress connection - {detail}',
'flag.refused': 'BirdNET-Go refused ({err})',
+ 'flag.forbidden': 'blocked',
+ 'flag.forbiddenDetail': 'BirdNET-Go rejected the request (CSRF) - reload the card and try again',
// ---- Weather conditions (standalone / fallback path) ----
// Keyed by Home Assistant's weather condition slugs. The card build
@@ -2299,6 +2309,29 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
function bgUrl(path) { return BG_BASE + '/api/v2' + path; }
+ // ---- API token (Private Mode) ----
+ // BirdNET-Go's "Private Mode" (Security.PrivateMode, mid-2026+) locks the
+ // ENTIRE v2 API behind login - every unauthenticated request 401s, even
+ // the previously-public detections/analytics routes this adapter relies
+ // on. api_token carries a personal token minted in BirdNET-Go's own
+ // settings; when set, every request that touches the BirdNET-Go API
+ // (reads AND the review write-back) rides an Authorization: Bearer
+ // header. This is the ONLY place that header gets added - Wikipedia,
+ // Xeno-Canto and Home Assistant fetches call the platform fetch()
+ // directly (see bgWiki, the XC helpers below, and haJson further down)
+ // and never see it. With no token set this is a transparent passthrough.
+ function bgFetch(url, opts) {
+ opts = opts || {};
+ if (!AV_CFG.apiToken) return fetch(url, opts);
+ var headers = {}, k;
+ for (k in (opts.headers || {})) headers[k] = opts.headers[k];
+ headers.Authorization = 'Bearer ' + AV_CFG.apiToken;
+ var merged = {};
+ for (k in opts) merged[k] = opts[k];
+ merged.headers = headers;
+ return fetch(url, merged);
+ }
+
// ---- HTTPS / Nabu Casa: route the API through HA ingress ----
// Remote access tunnels only HA itself, and the browser blocks an
// https page from calling a plain-http LAN URL (mixed content) - so
@@ -2434,7 +2467,13 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
(location.protocol === 'https:' ? ';Secure' : '');
}
function post() {
- return fetch(base + '/api/v2/detections/' + encodeURIComponent(id) + '/review', {
+ // Field name: BirdNET-Go's public API reference documents this
+ // route (POST /detections/:id/review) but not its request body -
+ // and the Apr 2026 release renamed the SEARCH response's verdict
+ // field 'verified' -> 'correct'. Send both; BirdNET-Go ignores
+ // unknown JSON fields, so this reads correctly on either side of
+ // the rename without needing to sniff the server version first.
+ return bgFetch(base + '/api/v2/detections/' + encodeURIComponent(id) + '/review', {
method: 'POST',
credentials: 'same-origin',
cache: 'no-store',
@@ -2442,7 +2481,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
'Content-Type': 'application/json',
'X-CSRF-Token': tok,
},
- body: JSON.stringify({ verified: verified }),
+ body: JSON.stringify({ verified: verified, correct: verified }),
}).then(function (r) { return r.ok ? r : Promise.reject(r.status); });
}
return post().catch(function (status) {
@@ -2462,11 +2501,41 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
// CORS-clean audio (crossOrigin=anonymous; BirdNET-Go's media endpoints
// send permissive CORS, and ingress is same-origin anyway).
var _boostCtx = null;
+ // Private Mode: a plain `<audio src>` can never carry the Authorization
+ // header BirdNET-Go now requires (see bgFetch) - clip playback would 401
+ // even with a correctly configured api_token, unlike the spectrogram
+ // decode path (bgAudioFetch) which already goes through fetch(). Only
+ // detour through a fetched blob when a token is actually configured -
+ // the common (no token) case keeps the cheap direct <audio src>, and
+ // reuses bgAudioFetch's 503+Retry-After retry for free.
function makeAudio(url) {
var audio = new Audio();
var db = +AV_CFG.audioBoostDb || 0;
if (db > 0) audio.crossOrigin = 'anonymous';
- audio.src = url;
+ if (AV_CFG.apiToken) {
+ // Deliberately never revoke this object URL: the 'emptied' event
+ // (the obvious hook) fires as part of the same load algorithm that
+ // sets audio.src in the first place, which would revoke the blob
+ // before the browser ever fetches it. Rows also keep their <audio>
+ // around after playback ends so the user can replay without
+ // re-fetching (see the 'ended' handler above), so there's no safe
+ // "done with this clip" moment short of the element being GC'd -
+ // one clip's worth of blob per play is an acceptable trade for
+ // Private Mode installs actually being able to play clips at all.
+ bgAudioFetch(url).then(function (r) {
+ if (!r.ok) throw new Error('HTTP ' + r.status);
+ return r.blob();
+ }).then(function (blob) {
+ audio.src = URL.createObjectURL(blob);
+ }).catch(function () {
+ // Surface the same failure state a bare <audio src> 401/404 would -
+ // existing 'error' listeners (e.g. the play button's "missing"
+ // state) still fire even though this never touched audio.src.
+ try { audio.dispatchEvent(new Event('error')); } catch (e2) {}
+ });
+ } else {
+ audio.src = url;
+ }
if (db > 0) {
var Ctx = window.AudioContext || window.webkitAudioContext;
if (Ctx) {
@@ -2488,7 +2557,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
function bgJson(path) {
return BG_READY.then(function () {
- return fetch(bgUrl(path), { cache: 'no-store' });
+ return bgFetch(bgUrl(path), { cache: 'no-store' });
}).then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); });
}
// Short-TTL memo so one refreshAll() fan-out (stats + lifelist + recent +
@@ -2762,6 +2831,18 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
});
}
+ // DetectionResponse.source changed from a plain string to an object
+ // {id, type, displayName} in BirdNET-Go's Aug 2026 release (per the API
+ // docs, unauthenticated clients only ever get the anonymized id form
+ // either way - full displayName needs an authenticated request). Route
+ // every read of a detection's source through here so it resolves to a
+ // display string regardless of which shape the server sends.
+ function sourceDisplayName(source) {
+ if (source == null) return '';
+ if (typeof source === 'string') return source;
+ return source.displayName || source.id || '';
+ }
+
// Per-species detail: the detection list that powers the modal's
// Recordings section. queryType=search matches sci OR common name with
// LIKE, so re-filter to the exact scientific name (keeps subspecies and
@@ -2775,7 +2856,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
var dets = ((parts[0] || {}).data || []).filter(function (d) {
return d.scientificName === sci;
}).map(function (d) {
- return { d: d.date, t: d.time, file: String(d.id), conf: +d.confidence || 0 };
+ return { d: d.date, t: d.time, file: String(d.id), conf: +d.confidence || 0, src: sourceDisplayName(d.source) };
});
var row = parts[1].species.filter(function (s) { return s.sci === sci; })[0] || {};
return {
@@ -2825,6 +2906,23 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
return bgUrl('/audio/' + encodeURIComponent(fileId));
}
+ // Extended-capture clips answer 503 + Retry-After while BirdNET-Go is
+ // still writing the file to disk. Wait the advertised delay (capped at
+ // 10s so a bad/huge header can't hang the UI) and retry exactly once;
+ // a second failure (or a 503 with no Retry-After) falls through to the
+ // caller's existing error handling unchanged. Used for the spectrogram
+ // decode fetches only - playback itself goes through a plain <audio>
+ // element (see makeAudio), which can't retry a load this way.
+ function bgAudioFetch(url) {
+ return bgFetch(url).then(function (r) {
+ if (r.status !== 503) return r;
+ var ra = parseFloat(r.headers.get('Retry-After'));
+ var wait = Math.min((ra > 0 ? ra : 1), 10) * 1000;
+ return new Promise(function (res) { setTimeout(res, wait); })
+ .then(function () { return bgFetch(url); });
+ });
+ }
+
// Latest clip for a species (the atlas cards' play button). Resolved
// lazily on first play and cached - the legacy recording.php?sci= shim
// did this lookup server-side.
@@ -2981,34 +3079,82 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
function hhDays() { return Math.max(1, +AV_CFG.historyDays || 10); }
// The MQTT sensor trios, one per microphone. Explicit via AV_CFG.haSensors
- // (a list of *_scientific_name entity ids) or discovered by suffix.
+ // (a list of *_scientific_name entity ids) or discovered by suffix. This
+ // also picks up BirdNET-Go's native HA MQTT auto-discovery sensors
+ // (shipped Jan 2026, e.g. via the alexbelgium add-on's mqtt_auto_config)
+ // without any change - they publish the same *_scientific_name /
+ // *_confidence suffix convention as a manually-wired MQTT sensor.
+ //
+ // Each returned set carries `offline`: true when the scientific-name
+ // sensor's current HA state is 'unavailable' or 'unknown' - the state
+ // native discovery's device availability topic flips it to when the
+ // source (RTSP stream, USB mic, ...) drops. The mic stays listed (its
+ // history is never dropped - hhJoinHistory already ignores unavailable/
+ // unknown readings when it walks that history, offline or not) but
+ // callers can use the flag to exclude it from "is everything live"
+ // checks. `offline` is false when we have no current-state info to
+ // judge from (the AV_CFG.haSensors override without a live hass).
function hhSensorSets() {
// Feeder-visit sensors (see vvSensorIds below) share the
// *_scientific_name suffix but are a different stream - never count
// a camera sighting as a microphone call.
var skip = {};
vvSensorIds().forEach(function (id) { skip[id] = 1; });
- function fromIds(ids) {
+ function fromIds(ids, stateOf) {
+ stateOf = stateOf || function () { return null; };
return ids.filter(function (id) { return /_scientific_name$/.test(id) && !skip[id]; })
.map(function (id) {
+ var st = stateOf(id);
return {
sci: id,
conf: id.replace(/_scientific_name$/, '_confidence'),
com: id.replace(/_scientific_name$/, '_last_species'),
+ offline: st === 'unavailable' || st === 'unknown',
};
});
}
+ var hass = AV_CFG.__getHass && AV_CFG.__getHass();
+ var stateOfHass = (hass && hass.states)
+ ? function (id) { return hass.states[id] && hass.states[id].state; }
+ : null;
if (AV_CFG.haSensors && AV_CFG.haSensors.length) {
- return Promise.resolve(fromIds(AV_CFG.haSensors));
+ return Promise.resolve(fromIds(AV_CFG.haSensors, stateOfHass));
}
- var hass = AV_CFG.__getHass && AV_CFG.__getHass();
- if (hass && hass.states) return Promise.resolve(fromIds(Object.keys(hass.states)));
+ if (hass && hass.states) return Promise.resolve(fromIds(Object.keys(hass.states), stateOfHass));
return haMemo('states', 60000, function () { return haApi('states'); })
.then(function (all) {
- return fromIds((all || []).map(function (e) { return e.entity_id; }));
+ var byId = {};
+ (all || []).forEach(function (e) { byId[e.entity_id] = e.state; });
+ return fromIds((all || []).map(function (e) { return e.entity_id; }),
+ function (id) { return byId[id]; });
});
}
+ // The currently-offline microphones (see hhSensorSets' `offline` flag).
+ // Resolves [] (never rejects) with no HA connection or no discovered
+ // sensors, so callers can use it unconditionally to drive a UI note.
+ function hhOfflineMics() {
+ if (!haAvailable()) return Promise.resolve([]);
+ return hhSensorSets().then(function (sets) {
+ return sets.filter(function (s) { return s.offline; });
+ }).catch(function () { return []; });
+ }
+ // A sensor entity's display name, preferring HA's own entity-name
+ // formatter (hass.formatEntityName, added in HA 2026.6) over the raw
+ // entity id - it follows the user's HA naming/language settings the
+ // same way the picker itself does. Falls back to '' (not the id) so
+ // callers can tell "no nicer name available" apart from a real one and
+ // keep their own current behaviour in that case.
+ function haEntityLabel(hass, id) {
+ try {
+ var st = hass && hass.states && hass.states[id];
+ if (st && typeof hass.formatEntityName === 'function') {
+ return hass.formatEntityName(st) || '';
+ }
+ } catch (e) { /* fall through to '' below */ }
+ return '';
+ }
+
function hhFmtTs(ms) {
var d = new Date(ms);
var p = function (n) { return (n < 10 ? '0' : '') + n; };
@@ -4633,6 +4779,12 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
activity: null, // ./avian/api/birdnet-api.php?action=activity&hours=N (per-species hourly heatmap)
visits: null, // vvRecent(hours) - feeder-camera sightings, when configured
};
+ // Set by the most recent refreshAll() when the stats/lifelist fetches
+ // (the primary summary/daily calls) came back 401 - BirdNET-Go's
+ // "Private Mode" gating the whole API behind login with no api_token
+ // configured. Read by renderAtlas to swap its normal empty state for a
+ // message that says what's actually wrong, instead of a silent blank.
+ var apiPrivateMode = false;
// Derived chart arrays, backfilled so 30 buckets always exist.
var STATS = {
@@ -4892,6 +5044,36 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
return liRow(label, s.com, '', s.sci);
}).join('')
: liRow('-', tt('stats.noneYet'), ''));
+
+ renderMicOfflineNote();
+ }
+
+ // Discovered-microphone availability note - a small muted line under
+ // "By Period" that only appears while at least one auto-discovered mic
+ // sensor is offline (native HA MQTT discovery flips it to 'unavailable'
+ // when the source drops). Silent (element stays hidden) the rest of the
+ // time, including when the card isn't using any HA sensors at all.
+ function renderMicOfflineNote() {
+ var el = __root.getElementById('statsMicNote');
+ if (!el) return;
+ hhOfflineMics().then(function (offline) {
+ if (!offline.length) {
+ el.hidden = true;
+ el.textContent = '';
+ return;
+ }
+ el.hidden = false;
+ // Name the mic when HA can format entity names and exactly one is
+ // offline - a name reads better than a count of one. Any other
+ // case (no formatter, or several mics down) keeps the plain count,
+ // which also reads fine as a list of names would get long.
+ var name = offline.length === 1
+ ? haEntityLabel(AV_CFG.__getHass && AV_CFG.__getHass(), offline[0].sci)
+ : '';
+ el.textContent = name
+ ? tt('stats.micOfflineNamed', { name: name })
+ : tt('stats.micsOffline', { n: offline.length });
+ });
}
// ---- Atlas: field-guide card grid ----
@@ -4945,10 +5127,15 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
recent.forEach(function (s) { winBySci[s.sci] = +s.n; });
if (!lifelist.length) {
- setHtml(grid, '<div class="atlas-empty">' +
- '<p>' + esc(tt('atlas.emptyTitle')) + '</p>' +
- '<p class="hint">' + esc(tt('atlas.emptyHint')) + '</p>' +
- '</div>');
+ // Private Mode (401 on the primary summary/daily fetches) gets its
+ // own message instead of the generic "nothing yet" copy - the fix
+ // (set api_token) is different from "wait for detections".
+ setHtml(grid, apiPrivateMode
+ ? '<div class="atlas-empty"><p>' + esc(tt('error.privateMode')) + '</p></div>'
+ : '<div class="atlas-empty">' +
+ '<p>' + esc(tt('atlas.emptyTitle')) + '</p>' +
+ '<p class="hint">' + esc(tt('atlas.emptyHint')) + '</p>' +
+ '</div>');
return;
}
@@ -5112,7 +5299,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
} else {
var actx = getSpecCtx();
if (actx) {
- fetch(aurl)
+ bgAudioFetch(aurl)
.then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.arrayBuffer(); })
.then(function (b) { return actx.decodeAudioData(b); })
.then(function (buf) {
@@ -5231,9 +5418,20 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
}
function refreshAll(animate) {
var forHours = currentHours;
+ // Only the primary summary/daily fetches (stats + lifelist) flip the
+ // Private Mode message - a 401 from a secondary call (timeseries,
+ // visits, ...) still means "not signed in", but stats/lifelist always
+ // fire together and their failure alone is enough to tell the story.
+ var authFailed = false;
+ function watchAuth(p) {
+ return p.catch(function (e) {
+ if (e === 401) authFailed = true;
+ return null;
+ });
+ }
return Promise.all([
- fetchJson('./avian/api/birdnet-api.php?action=stats').catch(function () { return null; }),
- fetchJson('./avian/api/birdnet-api.php?action=lifelist').catch(function () { return null; }),
+ watchAuth(fetchJson('./avian/api/birdnet-api.php?action=stats')),
+ watchAuth(fetchJson('./avian/api/birdnet-api.php?action=lifelist')),
fetchJson('./avian/api/birdnet-api.php?action=timeseries&days=30').catch(function () { return null; }),
fetchJson('./avian/api/birdnet-api.php?action=firstseen&limit=10').catch(function () { return null; }),
fetchJson('./avian/api/birdnet-api.php?action=recent&hours=' + forHours).catch(function () { return null; }),
@@ -5242,6 +5440,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
? vvRecent(forHours).catch(function () { return null; })
: Promise.resolve(null),
]).then(function (parts) {
+ apiPrivateMode = authFailed;
DATA.stats = parts[0];
DATA.lifelist = parts[1];
DATA.timeseries = parts[2];
@@ -5261,8 +5460,10 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
// Kick off the initial fetch. Renders pull from DATA as soon as it
// populates; until then the page sits with empty histograms + lists.
- // animate=true so the collage blooms in on first load.
- refreshAll(true);
+ // animate=true so the collage blooms in on first load. The live SSE
+ // stream (below) only opens once this settles, so it never races the
+ // very first render.
+ refreshAll(true).then(function () { startLive(); });
// Hook into the window picker so the data refetches on change. Pass
// animate=true so the collage blooms (the silent poll passes nothing).
@@ -5291,24 +5492,103 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
__realdoc.addEventListener('visibilitychange', function () {
if (document.hidden) {
stopPolling();
+ stopLive();
} else {
// Force an immediate refresh on return so the user sees fresh
// data right away, then resume normal polling cadence.
refreshAll();
startPolling();
+ startLive();
}
});
startPolling();
- // Card builds call this when a BirdNET-Go MQTT sensor updates: clear
- // the short-TTL response memos (they'd otherwise serve the pre-event
- // answer) and refresh immediately. No-op on the static page.
+ // Shared "something changed, refetch" path: clears the short-TTL
+ // response memos (they'd otherwise serve the pre-event answer) and
+ // refreshes right away. Card builds reach this via a BirdNET-Go MQTT
+ // sensor update (__exposeRefresh below); the live SSE stream (below)
+ // reaches it too - both are just triggers, neither carries any data.
+ function pushRefresh() {
+ _bgMemo = {};
+ _haMemo = {};
+ refreshAll();
+ }
+
+ // Card builds call this when a BirdNET-Go MQTT sensor updates. No-op
+ // on the static page.
if (AV_CFG.__exposeRefresh) {
- AV_CFG.__exposeRefresh(function () {
- _bgMemo = {};
- _haMemo = {};
- refreshAll();
- });
+ AV_CFG.__exposeRefresh(pushRefresh);
+ }
+
+ // ---- Live detections (SSE) ----
+ // BirdNET-Go's detections/stream endpoint (GET {base}/api/v2/detections/
+ // stream, an EventSource) pushes a 'detection' event the instant a new
+ // call lands. This is a REFRESH SIGNAL ONLY: the event payload is never
+ // parsed into DATA - only the polling fetches above ever populate it -
+ // so a server-version mismatch in the event's shape can't corrupt
+ // state, it can only fail to speed up a refresh that would have
+ // happened within POLL_MS anyway. Debounced 2s (a burst of near-
+ // simultaneous calls should trigger one refetch, not several).
+ var LIVE_ENABLED = AV_CFG.live !== false && typeof EventSource !== 'undefined';
+ var liveSource = null;
+ var liveReconnectT = null;
+ var liveDebounceT = null;
+ var liveReconnectDelay = 5000; // 5s, doubles up to a 60s cap
+ var liveFailures = 0; // consecutive drops since the last open
+ // Failing before the connection ever opens usually means a 404 (server
+ // predates the stream endpoint) or 401 (BirdNET-Go Private Mode -
+ // EventSource can't carry the Authorization header this page would
+ // otherwise send) - EventSource exposes no HTTP status, so that's
+ // indistinguishable from a one-off transient failure (BirdNET-Go/HA
+ // still starting up, a brief network blip). Retry once with the normal
+ // backoff before concluding it's permanent, so a startup race doesn't
+ // silently disable the feature for the rest of this boot. Normal 30s
+ // polling is unaffected either way.
+ var livePreOpenFailures = 0;
+ var liveGaveUp = false;
+
+ function liveDebouncedRefresh() {
+ clearTimeout(liveDebounceT);
+ liveDebounceT = setTimeout(pushRefresh, 2000);
+ }
+ function stopLive() {
+ clearTimeout(liveReconnectT);
+ liveReconnectT = null;
+ clearTimeout(liveDebounceT);
+ liveDebounceT = null;
+ if (liveSource) { liveSource.close(); liveSource = null; }
+ }
+ function startLive() {
+ if (!LIVE_ENABLED || liveGaveUp || liveSource || document.hidden) return;
+ var opened = false;
+ var es = new EventSource(bgUrl('/detections/stream'));
+ liveSource = es;
+ es.addEventListener('detection', liveDebouncedRefresh);
+ es.onopen = function () {
+ opened = true;
+ liveFailures = 0;
+ liveReconnectDelay = 5000;
+ };
+ es.onerror = function () {
+ if (liveSource !== es) return; // superseded by a later attempt already
+ stopLive();
+ if (!opened) {
+ livePreOpenFailures++;
+ if (livePreOpenFailures >= 2) { liveGaveUp = true; return; }
+ liveReconnectT = setTimeout(startLive, liveReconnectDelay);
+ liveReconnectDelay = Math.min(60000, liveReconnectDelay * 2);
+ return;
+ }
+ liveFailures++;
+ if (liveFailures >= 5) return; // stop retrying until the next card boot
+ liveReconnectT = setTimeout(startLive, liveReconnectDelay);
+ liveReconnectDelay = Math.min(60000, liveReconnectDelay * 2);
+ };
+ }
+ // Card builds call this from disconnectedCallback so a stream doesn't
+ // linger once the card leaves the dashboard. No-op on the static page.
+ if (AV_CFG.__exposeLiveStop) {
+ AV_CFG.__exposeLiveStop(stopLive);
}
// ---- Menu dropdown ----
@@ -6184,7 +6464,12 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
__root.getElementById('modalRecCount').textContent = tt('modal.captured', { n: dets.length });
__root.getElementById('modalRecordings').innerHTML = dets.length
? dets.map(function (d) {
- return '<li class="rec-row" data-file="' + esc(d.file || '') + '" data-date="' + esc(d.d || '') + '">'
+ return '<li class="rec-row" data-file="' + esc(d.file || '') + '" data-date="' + esc(d.d || '') + '"'
+ // Multi-source stations (several RTSP/mic inputs) tag each
+ // detection with which one heard it; exposed as a data
+ // attribute (no dedicated UI yet) so it survives round-trip
+ // and can be styled/queried later without another API audit.
+ + (d.src ? ' data-source="' + esc(d.src) + '"' : '') + '>'
+ '<button class="play" type="button" aria-label="' + esc(tt('modal.play')) + '">' + ICON_PLAY + '</button>'
+ '<span class="when">' + esc(fmtRecTime(d.d, d.t)) + '<small>' + esc(fmtDateLine(d.d, d.t)) + '</small></span>'
// Review write-back needs a detection id - present with the
@@ -6995,7 +7280,7 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
}
var ctx = getSpecCtx();
if (!ctx) { fail(tt('spectro.noWebAudio')); return; }
- fetch(bgAudioUrl(file))
+ bgAudioFetch(bgAudioUrl(file))
.then(function (r) {
if (!r.ok) throw new Error('HTTP ' + r.status);
return r.arrayBuffer();
@@ -7058,10 +7343,16 @@ function runHABirdApp(__root, __shell, __cardConfig, __imgBase) {
flagBtn.disabled = false;
// Tooltips don't exist on touch - put a short reason IN the pill.
var isPath = typeof err === 'string' && err.indexOf('needs-ingress') === 0;
+ // 403 is BirdNET-Go's Aug 2026 CSRF enforcement rejecting the
+ // write (a stale self-minted token, or a proxy that stripped the
+ // cookie) - distinct enough from a generic error code to say so.
+ var isForbidden = err === 403;
var label = isPath ? tt('flag.noPath')
+ : isForbidden ? tt('flag.forbidden')
: (typeof err === 'number' ? tt('flag.errCode', { code: err }) : tt('flag.failed'));
var why = isPath
? tt('flag.needsIngress', { detail: err.slice('needs-ingress: '.length) })
+ : isForbidden ? tt('flag.forbiddenDetail')
: tt('flag.refused', { err: err });
try { console.warn('[bird-card] review write failed:', err); } catch (e) {}
setFlag('failed', label, tt('flag.couldNotSave', { why: why }));
@@ -7567,10 +7858,12 @@ var HABIRD_EDITOR_SCHEMA = [
{ value: 'ha', label: 'MQTT history only' },
] } } },
{ name: 'birdnet_url', selector: { text: {} } },
+ { name: 'api_token', selector: { text: {} } },
{ name: '', type: 'grid', schema: [
{ name: 'history_days', selector: { number: { min: 1, max: 365, step: 1, mode: 'box', unit_of_measurement: 'days' } } },
{ name: 'poll_seconds', selector: { number: { min: 10, max: 3600, step: 10, mode: 'box', unit_of_measurement: 's' } } },
] },
+ { name: 'live', selector: { boolean: {} } },
{ name: 'visits_sensors', selector: { entity: { multiple: true, filter: [{ domain: 'sensor' }] } } },
] },
];
@@ -7603,9 +7896,11 @@ var HABIRD_LABELS = {
collage_spacing: 'Bird spacing',
image_base: 'Artwork base URL',
birdnet_url: 'BirdNET-Go URL',
+ api_token: 'BirdNET-Go API token',
data_source: 'Data source',
history_days: 'History span',
poll_seconds: 'Refresh interval',
+ live: 'Live updates',
visits_sensors: 'Feeder visit sensors',
};
var HABIRD_HELPERS = {
@@ -7630,9 +7925,11 @@ var HABIRD_HELPERS = {
collage_spacing: 'How much space sits between birds (any shape). Birds never overlap; lower packs them closer and a touch bigger, higher gives more breathing room.',
image_base: 'Default (blank): artwork from the CDN. Use /local/habird-art/ for an offline copy.',
birdnet_url: 'Default (blank): this host on port 8080, or HA ingress when remote.',
+ api_token: "Default (blank): none. Required if BirdNET-Go's Security > Private Mode is on - every API call 401s without it. Create a token in BirdNET-Go's own settings; sent as an Authorization: Bearer header, never to Wikipedia/Xeno-Canto/Home Assistant.",
data_source: 'Automatic uses the API and falls back to the MQTT sensors.',
history_days: 'How far MQTT history reaches; bounded by recorder retention.',
poll_seconds: 'Safety-net refresh. MQTT pushes new detections instantly.',
+ live: "Opens a live connection to BirdNET-Go's own detection stream (in addition to the MQTT push above) so new calls refresh the card within a couple seconds. Falls back to the interval above alone if the stream is unavailable (older BirdNET-Go, or Private Mode).",
visits_sensors: "Optional: a feeder camera's BirdNET-style “... scientific name” sensors (e.g. published by an LLM Vision automation). Their sightings blend in as per-species “visits” next to the audio “calls” - on hover, in the atlas and in the detail view.",
};
@@ -7656,6 +7953,16 @@ class HABirdCard extends HTMLElement {
// fresh app instance - cheapest correct thing is a full re-boot.
if (this._booted) {
this._booted = false;
+ // Tear down the old instance's live bits the same way
+ // disconnectedCallback does - otherwise its SSE connection, poll
+ // timer and document-level visibilitychange listener are orphaned
+ // (unreachable, but never closed) every time setConfig reboots the
+ // app, e.g. the dashboard editor calling setConfig on every keystroke
+ // during live preview.
+ if (this._stopLive) { this._stopLive(); this._stopLive = null; }
+ this._refresh = null;
+ this._watchIds = null;
+ this._lastStamp = null;
if (this.shadowRoot) this.shadowRoot.innerHTML = '';
if (this.isConnected) this._boot();
}
@@ -7722,6 +8029,7 @@ class HABirdCard extends HTMLElement {
selectorPosition: c.selector_position || 'bottom',
windowHours: c.window || 24, // hours, or 'all'
birdnetGoUrl: c.birdnet_url || '',
+ apiToken: c.api_token || '', // Bearer token for BirdNET-Go's "Private Mode"
dataSource: c.data_source || 'auto',
language: c.language || '', // UI language override ('' = auto: hass -> browser)
historyDays: c.history_days,
@@ -7733,6 +8041,12 @@ class HABirdCard extends HTMLElement {
// MQTT sensor updates push refreshes (see _watchDetections), so the
// timer is just a safety net - much longer than the page's 30s.
pollSeconds: c.poll_seconds || 60,
+ // Live detections: an EventSource straight to BirdNET-Go's own
+ // stream, as a second (independent) push-refresh trigger alongside
+ // the MQTT watcher above. On by default; the off switch is for old
+ // BirdNET-Go builds or Private Mode installs, where the stream
+ // 404s/401s on every boot and there's no point retrying it.
+ live: c.live !== false,
// How much of the card the flock fills (0.1-1.0, default 0.5). The
// count curve in renderCollage nudges it per bird count.
collageFill: (typeof c.collage_fill === 'number') ? c.collage_fill : 0.5,
@@ -7761,6 +8075,9 @@ class HABirdCard extends HTMLElement {
tapAction: c.tap_action || 'both', // both | info | call
xenoCantoKey: c.xeno_canto_key || '', // enables reference calls
__exposeRefresh: function (fn) { self._refresh = fn; },
+ // Lets disconnectedCallback close the live SSE stream (if any) when
+ // the card leaves the dashboard, instead of it lingering forever.
+ __exposeLiveStop: function (fn) { self._stopLive = fn; },
sitConfidence: (typeof c.sit_confidence === 'number') ? c.sit_confidence : 0.90,
wall: {
clock: !!c.clock,
@@ -7789,6 +8106,7 @@ class HABirdCard extends HTMLElement {
}
disconnectedCallback() {
if (this._ro) { this._ro.disconnect(); this._ro = null; }
+ if (this._stopLive) { this._stopLive(); this._stopLive = null; }
}
getCardSize() { return 8; }
// Sections-view sizing: full width, tall by default, never crushed.
@@ -7825,7 +8143,7 @@ class HABirdCardEditor extends HTMLElement {
this.appendChild(this._form);
}
this._form.schema = HABIRD_EDITOR_SCHEMA;
- this._form.data = Object.assign({ corner: 'bottom-right', sit_confidence: 0.90, window: '24', background: 'transparent', font: 'system', data_source: 'auto', view: 'collage', view_selector: true, selector_position: 'bottom', collage_fill: 0.5, size_contrast: 0.5, paper_color: '', paper_color_dark: '', paper_texture: 0, audio_boost: 24 }, this._config);
+ this._form.data = Object.assign({ corner: 'bottom-right', sit_confidence: 0.90, window: '24', background: 'transparent', font: 'system', data_source: 'auto', view: 'collage', view_selector: true, selector_position: 'bottom', collage_fill: 0.5, size_contrast: 0.5, paper_color: '', paper_color_dark: '', paper_texture: 0, audio_boost: 24, live: true }, this._config);
this._form.hass = this._hass;
}
}
@@ -7844,6 +8162,30 @@ if (!window.customCards.some(function (c) { return c.type === 'habird-card'; }))
name: 'Bird Card',
description: 'Live bird collage from your BirdNET-Go detections, with optional clock and weather.',
documentationURL: 'https://github.com/adamoberley/HABirdDashboard',
+ // HA 2026.6+ entity-picker card suggestions: when the user picks an
+ // entity that looks like one of BirdNET-Go's MQTT sensors, offer this
+ // card in the picker instead of leaving them to find it by name. {}
+ // is a fully valid config (the card auto-discovers every *_scientific_name
+ // sensor hass exposes) - no entity-specific config to build here.
+ // getEntitySuggestion is just an extra property on the registration
+ // object; older HA builds that don't know about it never call it, so
+ // its presence can't break them. Guarded in a try/catch anyway since a
+ // thrown error here runs inside HA's own picker UI, not this card.
+ getEntitySuggestion: function (hass, entityId) {
+ try {
+ var id = String(entityId || '').toLowerCase();
+ if (id.split('.')[0] !== 'sensor') return null;
+ var suffixes = ['_scientific_name', '_confidence', '_last_species', '_sound_level'];
+ for (var i = 0; i < suffixes.length; i++) {
+ if (id.slice(-suffixes[i].length) === suffixes[i]) {
+ return { config: { type: 'custom:habird-card' } };
+ }
+ }
+ return null;
+ } catch (e) {
+ return null;
+ }
+ },
});
}
diff --git a/homeassistant/card/build.js b/homeassistant/card/build.js
index f5583cd3..632fcf60 100644
--- a/homeassistant/card/build.js
+++ b/homeassistant/card/build.js
@@ -307,10 +307,12 @@ var HABIRD_EDITOR_SCHEMA = [
{ value: 'ha', label: 'MQTT history only' },
] } } },
{ name: 'birdnet_url', selector: { text: {} } },
+ { name: 'api_token', selector: { text: {} } },
{ name: '', type: 'grid', schema: [
{ name: 'history_days', selector: { number: { min: 1, max: 365, step: 1, mode: 'box', unit_of_measurement: 'days' } } },
{ name: 'poll_seconds', selector: { number: { min: 10, max: 3600, step: 10, mode: 'box', unit_of_measurement: 's' } } },
] },
+ { name: 'live', selector: { boolean: {} } },
{ name: 'visits_sensors', selector: { entity: { multiple: true, filter: [{ domain: 'sensor' }] } } },
] },
];
@@ -343,9 +345,11 @@ var HABIRD_LABELS = {
collage_spacing: 'Bird spacing',
image_base: 'Artwork base URL',
birdnet_url: 'BirdNET-Go URL',
+ api_token: 'BirdNET-Go API token',
data_source: 'Data source',
history_days: 'History span',
poll_seconds: 'Refresh interval',
+ live: 'Live updates',
visits_sensors: 'Feeder visit sensors',
};
var HABIRD_HELPERS = {
@@ -370,9 +374,11 @@ var HABIRD_HELPERS = {
collage_spacing: 'How much space sits between birds (any shape). Birds never overlap; lower packs them closer and a touch bigger, higher gives more breathing room.',
image_base: 'Default (blank): artwork from the CDN. Use /local/habird-art/ for an offline copy.',
birdnet_url: 'Default (blank): this host on port 8080, or HA ingress when remote.',
+ api_token: "Default (blank): none. Required if BirdNET-Go's Security > Private Mode is on - every API call 401s without it. Create a token in BirdNET-Go's own settings; sent as an Authorization: Bearer header, never to Wikipedia/Xeno-Canto/Home Assistant.",
data_source: 'Automatic uses the API and falls back to the MQTT sensors.',
history_days: 'How far MQTT history reaches; bounded by recorder retention.',
poll_seconds: 'Safety-net refresh. MQTT pushes new detections instantly.',
+ live: "Opens a live connection to BirdNET-Go's own detection stream (in addition to the MQTT push above) so new calls refresh the card within a couple seconds. Falls back to the interval above alone if the stream is unavailable (older BirdNET-Go, or Private Mode).",
visits_sensors: "Optional: a feeder camera's BirdNET-style “... scientific name” sensors (e.g. published by an LLM Vision automation). Their sightings blend in as per-species “visits” next to the audio “calls” - on hover, in the atlas and in the detail view.",
};
@@ -396,6 +402,16 @@ class HABirdCard extends HTMLElement {
// fresh app instance - cheapest correct thing is a full re-boot.
if (this._booted) {
this._booted = false;
+ // Tear down the old instance's live bits the same way
+ // disconnectedCallback does - otherwise its SSE connection, poll
+ // timer and document-level visibilitychange listener are orphaned
+ // (unreachable, but never closed) every time setConfig reboots the
+ // app, e.g. the dashboard editor calling setConfig on every keystroke
+ // during live preview.
+ if (this._stopLive) { this._stopLive(); this._stopLive = null; }
+ this._refresh = null;
+ this._watchIds = null;
+ this._lastStamp = null;
if (this.shadowRoot) this.shadowRoot.innerHTML = '';
if (this.isConnected) this._boot();
}
@@ -462,6 +478,7 @@ class HABirdCard extends HTMLElement {
selectorPosition: c.selector_position || 'bottom',
windowHours: c.window || 24, // hours, or 'all'
birdnetGoUrl: c.birdnet_url || '',
+ apiToken: c.api_token || '', // Bearer token for BirdNET-Go's "Private Mode"
dataSource: c.data_source || 'auto',
language: c.language || '', // UI language override ('' = auto: hass -> browser)
historyDays: c.history_days,
@@ -473,6 +490,12 @@ class HABirdCard extends HTMLElement {
// MQTT sensor updates push refreshes (see _watchDetections), so the
// timer is just a safety net - much longer than the page's 30s.
pollSeconds: c.poll_seconds || 60,
+ // Live detections: an EventSource straight to BirdNET-Go's own
+ // stream, as a second (independent) push-refresh trigger alongside
+ // the MQTT watcher above. On by default; the off switch is for old
+ // BirdNET-Go builds or Private Mode installs, where the stream
+ // 404s/401s on every boot and there's no point retrying it.
+ live: c.live !== false,
// How much of the card the flock fills (0.1-1.0, default 0.5). The
// count curve in renderCollage nudges it per bird count.
collageFill: (typeof c.collage_fill === 'number') ? c.collage_fill : 0.5,
@@ -501,6 +524,9 @@ class HABirdCard extends HTMLElement {
tapAction: c.tap_action || 'both', // both | info | call
xenoCantoKey: c.xeno_canto_key || '', // enables reference calls
__exposeRefresh: function (fn) { self._refresh = fn; },
+ // Lets disconnectedCallback close the live SSE stream (if any) when
+ // the card leaves the dashboard, instead of it lingering forever.
+ __exposeLiveStop: function (fn) { self._stopLive = fn; },
sitConfidence: (typeof c.sit_confidence === 'number') ? c.sit_confidence : 0.90,
wall: {
clock: !!c.clock,
@@ -529,6 +555,7 @@ class HABirdCard extends HTMLElement {
}
disconnectedCallback() {
if (this._ro) { this._ro.disconnect(); this._ro = null; }
+ if (this._stopLive) { this._stopLive(); this._stopLive = null; }
}
getCardSize() { return 8; }
// Sections-view sizing: full width, tall by default, never crushed.
@@ -565,7 +592,7 @@ class HABirdCardEditor extends HTMLElement {
this.appendChild(this._form);
}
this._form.schema = HABIRD_EDITOR_SCHEMA;
- this._form.data = Object.assign({ corner: 'bottom-right', sit_confidence: 0.90, window: '24', background: 'transparent', font: 'system', data_source: 'auto', view: 'collage', view_selector: true, selector_position: 'bottom', collage_fill: 0.5, size_contrast: 0.5, paper_color: '', paper_color_dark: '', paper_texture: 0, audio_boost: 24 }, this._config);
+ this._form.data = Object.assign({ corner: 'bottom-right', sit_confidence: 0.90, window: '24', background: 'transparent', font: 'system', data_source: 'auto', view: 'collage', view_selector: true, selector_position: 'bottom', collage_fill: 0.5, size_contrast: 0.5, paper_color: '', paper_color_dark: '', paper_texture: 0, audio_boost: 24, live: true }, this._config);
this._form.hass = this._hass;
}
}
@@ -584,6 +611,30 @@ if (!window.customCards.some(function (c) { return c.type === 'habird-card'; }))
name: 'Bird Card',
description: 'Live bird collage from your BirdNET-Go detections, with optional clock and weather.',
documentationURL: 'https://github.com/adamoberley/HABirdDashboard',
+ // HA 2026.6+ entity-picker card suggestions: when the user picks an
+ // entity that looks like one of BirdNET-Go's MQTT sensors, offer this
+ // card in the picker instead of leaving them to find it by name. {}
+ // is a fully valid config (the card auto-discovers every *_scientific_name
+ // sensor hass exposes) - no entity-specific config to build here.
+ // getEntitySuggestion is just an extra property on the registration
+ // object; older HA builds that don't know about it never call it, so
+ // its presence can't break them. Guarded in a try/catch anyway since a
+ // thrown error here runs inside HA's own picker UI, not this card.
+ getEntitySuggestion: function (hass, entityId) {
+ try {
+ var id = String(entityId || '').toLowerCase();
+ if (id.split('.')[0] !== 'sensor') return null;
+ var suffixes = ['_scientific_name', '_confidence', '_last_species', '_sound_level'];
+ for (var i = 0; i < suffixes.length; i++) {
+ if (id.slice(-suffixes[i].length) === suffixes[i]) {
+ return { config: { type: 'custom:habird-card' } };
+ }
+ }
+ return null;
+ } catch (e) {
+ return null;
+ }
+ },
});
}
`;
diff --git a/homeassistant/www/apt.js b/homeassistant/www/apt.js
index 3596ecd1..d852025d 100644
--- a/homeassistant/www/apt.js
+++ b/homeassistant/www/apt.js
@@ -175,6 +175,29 @@
function bgUrl(path) { return BG_BASE + '/api/v2' + path; }
+ // ---- API token (Private Mode) ----
+ // BirdNET-Go's "Private Mode" (Security.PrivateMode, mid-2026+) locks the
+ // ENTIRE v2 API behind login - every unauthenticated request 401s, even
+ // the previously-public detections/analytics routes this adapter relies
+ // on. api_token carries a personal token minted in BirdNET-Go's own
+ // settings; when set, every request that touches the BirdNET-Go API
+ // (reads AND the review write-back) rides an Authorization: Bearer
+ // header. This is the ONLY place that header gets added - Wikipedia,
+ // Xeno-Canto and Home Assistant fetches call the platform fetch()
+ // directly (see bgWiki, the XC helpers below, and haJson further down)
+ // and never see it. With no token set this is a transparent passthrough.
+ function bgFetch(url, opts) {
+ opts = opts || {};
+ if (!AV_CFG.apiToken) return fetch(url, opts);
+ var headers = {}, k;
+ for (k in (opts.headers || {})) headers[k] = opts.headers[k];
+ headers.Authorization = 'Bearer ' + AV_CFG.apiToken;
+ var merged = {};
+ for (k in opts) merged[k] = opts[k];
+ merged.headers = headers;
+ return fetch(url, merged);
+ }
+
// ---- HTTPS / Nabu Casa: route the API through HA ingress ----
// Remote access tunnels only HA itself, and the browser blocks an
// https page from calling a plain-http LAN URL (mixed content) - so
@@ -310,7 +333,13 @@
(location.protocol === 'https:' ? ';Secure' : '');
}
function post() {
- return fetch(base + '/api/v2/detections/' + encodeURIComponent(id) + '/review', {
+ // Field name: BirdNET-Go's public API reference documents this
+ // route (POST /detections/:id/review) but not its request body -
+ // and the Apr 2026 release renamed the SEARCH response's verdict
+ // field 'verified' -> 'correct'. Send both; BirdNET-Go ignores
+ // unknown JSON fields, so this reads correctly on either side of
+ // the rename without needing to sniff the server version first.
+ return bgFetch(base + '/api/v2/detections/' + encodeURIComponent(id) + '/review', {
method: 'POST',
credentials: 'same-origin',
cache: 'no-store',
@@ -318,7 +347,7 @@
'Content-Type': 'application/json',
'X-CSRF-Token': tok,
},
- body: JSON.stringify({ verified: verified }),
+ body: JSON.stringify({ verified: verified, correct: verified }),
}).then(function (r) { return r.ok ? r : Promise.reject(r.status); });
}
return post().catch(function (status) {
@@ -338,11 +367,41 @@
// CORS-clean audio (crossOrigin=anonymous; BirdNET-Go's media endpoints
// send permissive CORS, and ingress is same-origin anyway).
var _boostCtx = null;
+ // Private Mode: a plain `<audio src>` can never carry the Authorization
+ // header BirdNET-Go now requires (see bgFetch) - clip playback would 401
+ // even with a correctly configured api_token, unlike the spectrogram
+ // decode path (bgAudioFetch) which already goes through fetch(). Only
+ // detour through a fetched blob when a token is actually configured -
+ // the common (no token) case keeps the cheap direct <audio src>, and
+ // reuses bgAudioFetch's 503+Retry-After retry for free.
function makeAudio(url) {
var audio = new Audio();
var db = +AV_CFG.audioBoostDb || 0;
if (db > 0) audio.crossOrigin = 'anonymous';
- audio.src = url;
+ if (AV_CFG.apiToken) {
+ // Deliberately never revoke this object URL: the 'emptied' event
+ // (the obvious hook) fires as part of the same load algorithm that
+ // sets audio.src in the first place, which would revoke the blob
+ // before the browser ever fetches it. Rows also keep their <audio>
+ // around after playback ends so the user can replay without
+ // re-fetching (see the 'ended' handler above), so there's no safe
+ // "done with this clip" moment short of the element being GC'd -
+ // one clip's worth of blob per play is an acceptable trade for
+ // Private Mode installs actually being able to play clips at all.
+ bgAudioFetch(url).then(function (r) {
+ if (!r.ok) throw new Error('HTTP ' + r.status);
+ return r.blob();
+ }).then(function (blob) {
+ audio.src = URL.createObjectURL(blob);
+ }).catch(function () {
+ // Surface the same failure state a bare <audio src> 401/404 would -
+ // existing 'error' listeners (e.g. the play button's "missing"
+ // state) still fire even though this never touched audio.src.
+ try { audio.dispatchEvent(new Event('error')); } catch (e2) {}
+ });
+ } else {
+ audio.src = url;
+ }
if (db > 0) {
var Ctx = window.AudioContext || window.webkitAudioContext;
if (Ctx) {
@@ -364,7 +423,7 @@
function bgJson(path) {
return BG_READY.then(function () {
- return fetch(bgUrl(path), { cache: 'no-store' });
+ return bgFetch(bgUrl(path), { cache: 'no-store' });
}).then(function (r) { return r.ok ? r.json() : Promise.reject(r.status); });
}
// Short-TTL memo so one refreshAll() fan-out (stats + lifelist + recent +
@@ -638,6 +697,18 @@
});
}
+ // DetectionResponse.source changed from a plain string to an object
+ // {id, type, displayName} in BirdNET-Go's Aug 2026 release (per the API
+ // docs, unauthenticated clients only ever get the anonymized id form
+ // either way - full displayName needs an authenticated request). Route
+ // every read of a detection's source through here so it resolves to a
+ // display string regardless of which shape the server sends.
+ function sourceDisplayName(source) {
+ if (source == null) return '';
+ if (typeof source === 'string') return source;
+ return source.displayName || source.id || '';
+ }
+
// Per-species detail: the detection list that powers the modal's
// Recordings section. queryType=search matches sci OR common name with
// LIKE, so re-filter to the exact scientific name (keeps subspecies and
@@ -651,7 +722,7 @@
var dets = ((parts[0] || {}).data || []).filter(function (d) {
return d.scientificName === sci;
}).map(function (d) {
- return { d: d.date, t: d.time, file: String(d.id), conf: +d.confidence || 0 };
+ return { d: d.date, t: d.time, file: String(d.id), conf: +d.confidence || 0, src: sourceDisplayName(d.source) };
});
var row = parts[1].species.filter(function (s) { return s.sci === sci; })[0] || {};
return {
@@ -701,6 +772,23 @@
return bgUrl('/audio/' + encodeURIComponent(fileId));
}
+ // Extended-capture clips answer 503 + Retry-After while BirdNET-Go is
+ // still writing the file to disk. Wait the advertised delay (capped at
+ // 10s so a bad/huge header can't hang the UI) and retry exactly once;
+ // a second failure (or a 503 with no Retry-After) falls through to the
+ // caller's existing error handling unchanged. Used for the spectrogram
+ // decode fetches only - playback itself goes through a plain <audio>
+ // element (see makeAudio), which can't retry a load this way.
+ function bgAudioFetch(url) {
+ return bgFetch(url).then(function (r) {
+ if (r.status !== 503) return r;
+ var ra = parseFloat(r.headers.get('Retry-After'));
+ var wait = Math.min((ra > 0 ? ra : 1), 10) * 1000;
+ return new Promise(function (res) { setTimeout(res, wait); })
+ .then(function () { return bgFetch(url); });
+ });
+ }
+
// Latest clip for a species (the atlas cards' play button). Resolved
// lazily on first play and cached - the legacy recording.php?sci= shim
// did this lookup server-side.
@@ -857,34 +945,82 @@
function hhDays() { return Math.max(1, +AV_CFG.historyDays || 10); }
// The MQTT sensor trios, one per microphone. Explicit via AV_CFG.haSensors
- // (a list of *_scientific_name entity ids) or discovered by suffix.
+ // (a list of *_scientific_name entity ids) or discovered by suffix. This
+ // also picks up BirdNET-Go's native HA MQTT auto-discovery sensors
+ // (shipped Jan 2026, e.g. via the alexbelgium add-on's mqtt_auto_config)
+ // without any change - they publish the same *_scientific_name /
+ // *_confidence suffix convention as a manually-wired MQTT sensor.
+ //
+ // Each returned set carries `offline`: true when the scientific-name
+ // sensor's current HA state is 'unavailable' or 'unknown' - the state
+ // native discovery's device availability topic flips it to when the
+ // source (RTSP stream, USB mic, ...) drops. The mic stays listed (its
+ // history is never dropped - hhJoinHistory already ignores unavailable/
+ // unknown readings when it walks that history, offline or not) but
+ // callers can use the flag to exclude it from "is everything live"
+ // checks. `offline` is false when we have no current-state info to
+ // judge from (the AV_CFG.haSensors override without a live hass).
function hhSensorSets() {
// Feeder-visit sensors (see vvSensorIds below) share the
// *_scientific_name suffix but are a different stream - never count
// a camera sighting as a microphone call.
var skip = {};
vvSensorIds().forEach(function (id) { skip[id] = 1; });
- function fromIds(ids) {
+ function fromIds(ids, stateOf) {
+ stateOf = stateOf || function () { return null; };
return ids.filter(function (id) { return /_scientific_name$/.test(id) && !skip[id]; })
.map(function (id) {
+ var st = stateOf(id);
return {
sci: id,
conf: id.replace(/_scientific_name$/, '_confidence'),
com: id.replace(/_scientific_name$/, '_last_species'),
+ offline: st === 'unavailable' || st === 'unknown',
};
});
}
+ var hass = AV_CFG.__getHass && AV_CFG.__getHass();
+ var stateOfHass = (hass && hass.states)
+ ? function (id) { return hass.states[id] && hass.states[id].state; }
+ : null;
if (AV_CFG.haSensors && AV_CFG.haSensors.length) {
- return Promise.resolve(fromIds(AV_CFG.haSensors));
+ return Promise.resolve(fromIds(AV_CFG.haSensors, stateOfHass));
}
- var hass = AV_CFG.__getHass && AV_CFG.__getHass();
- if (hass && hass.states) return Promise.resolve(fromIds(Object.keys(hass.states)));
+ if (hass && hass.states) return Promise.resolve(fromIds(Object.keys(hass.states), stateOfHass));
return haMemo('states', 60000, function () { return haApi('states'); })
.then(function (all) {
- return fromIds((all || []).map(function (e) { return e.entity_id; }));
+ var byId = {};
+ (all || []).forEach(function (e) { byId[e.entity_id] = e.state; });
+ return fromIds((all || []).map(function (e) { return e.entity_id; }),
+ function (id) { return byId[id]; });
});
}
+ // The currently-offline microphones (see hhSensorSets' `offline` flag).
+ // Resolves [] (never rejects) with no HA connection or no discovered
+ // sensors, so callers can use it unconditionally to drive a UI note.
+ function hhOfflineMics() {
+ if (!haAvailable()) return Promise.resolve([]);
+ return hhSensorSets().then(function (sets) {
+ return sets.filter(function (s) { return s.offline; });
+ }).catch(function () { return []; });
+ }
+ // A sensor entity's display name, preferring HA's own entity-name
+ // formatter (hass.formatEntityName, added in HA 2026.6) over the raw
+ // entity id - it follows the user's HA naming/language settings the
+ // same way the picker itself does. Falls back to '' (not the id) so
+ // callers can tell "no nicer name available" apart from a real one and
+ // keep their own current behaviour in that case.
+ function haEntityLabel(hass, id) {
+ try {
+ var st = hass && hass.states && hass.states[id];
+ if (st && typeof hass.formatEntityName === 'function') {
+ return hass.formatEntityName(st) || '';
+ }
+ } catch (e) { /* fall through to '' below */ }
+ return '';
+ }
+
function hhFmtTs(ms) {
var d = new Date(ms);
var p = function (n) { return (n < 10 ? '0' : '') + n; };
@@ -2509,6 +2645,12 @@
activity: null, // ./avian/api/birdnet-api.php?action=activity&hours=N (per-species hourly heatmap)
visits: null, // vvRecent(hours) - feeder-camera sightings, when configured
};
+ // Set by the most recent refreshAll() when the stats/lifelist fetches
+ // (the primary summary/daily calls) came back 401 - BirdNET-Go's
+ // "Private Mode" gating the whole API behind login with no api_token
+ // configured. Read by renderAtlas to swap its normal empty state for a
+ // message that says what's actually wrong, instead of a silent blank.
+ var apiPrivateMode = false;
// Derived chart arrays, backfilled so 30 buckets always exist.
var STATS = {
@@ -2768,6 +2910,36 @@
return liRow(label, s.com, '', s.sci);
}).join('')
: liRow('-', tt('stats.noneYet'), ''));
+
+ renderMicOfflineNote();
+ }
+
+ // Discovered-microphone availability note - a small muted line under
+ // "By Period" that only appears while at least one auto-discovered mic
+ // sensor is offline (native HA MQTT discovery flips it to 'unavailable'
+ // when the source drops). Silent (element stays hidden) the rest of the
+ // time, including when the card isn't using any HA sensors at all.
+ function renderMicOfflineNote() {
+ var el = document.getElementById('statsMicNote');
+ if (!el) return;
+ hhOfflineMics().then(function (offline) {
+ if (!offline.length) {
+ el.hidden = true;
+ el.textContent = '';
+ return;
+ }
+ el.hidden = false;
+ // Name the mic when HA can format entity names and exactly one is
+ // offline - a name reads better than a count of one. Any other
+ // case (no formatter, or several mics down) keeps the plain count,
+ // which also reads fine as a list of names would get long.
+ var name = offline.length === 1
+ ? haEntityLabel(AV_CFG.__getHass && AV_CFG.__getHass(), offline[0].sci)
+ : '';
+ el.textContent = name
+ ? tt('stats.micOfflineNamed', { name: name })
+ : tt('stats.micsOffline', { n: offline.length });
+ });
}
// ---- Atlas: field-guide card grid ----
@@ -2821,10 +2993,15 @@
recent.forEach(function (s) { winBySci[s.sci] = +s.n; });
if (!lifelist.length) {
- setHtml(grid, '<div class="atlas-empty">' +
- '<p>' + esc(tt('atlas.emptyTitle')) + '</p>' +
- '<p class="hint">' + esc(tt('atlas.emptyHint')) + '</p>' +
- '</div>');
+ // Private Mode (401 on the primary summary/daily fetches) gets its
+ // own message instead of the generic "nothing yet" copy - the fix
+ // (set api_token) is different from "wait for detections".
+ setHtml(grid, apiPrivateMode
+ ? '<div class="atlas-empty"><p>' + esc(tt('error.privateMode')) + '</p></div>'
+ : '<div class="atlas-empty">' +
+ '<p>' + esc(tt('atlas.emptyTitle')) + '</p>' +
+ '<p class="hint">' + esc(tt('atlas.emptyHint')) + '</p>' +
+ '</div>');
return;
}
@@ -2988,7 +3165,7 @@
} else {
var actx = getSpecCtx();
if (actx) {
- fetch(aurl)
+ bgAudioFetch(aurl)
.then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.arrayBuffer(); })
.then(function (b) { return actx.decodeAudioData(b); })
.then(function (buf) {
@@ -3107,9 +3284,20 @@
}
function refreshAll(animate) {
var forHours = currentHours;
+ // Only the primary summary/daily fetches (stats + lifelist) flip the
+ // Private Mode message - a 401 from a secondary call (timeseries,
+ // visits, ...) still means "not signed in", but stats/lifelist always
+ // fire together and their failure alone is enough to tell the story.
+ var authFailed = false;
+ function watchAuth(p) {
+ return p.catch(function (e) {
+ if (e === 401) authFailed = true;
+ return null;
+ });
+ }
return Promise.all([
- fetchJson('./avian/api/birdnet-api.php?action=stats').catch(function () { return null; }),
- fetchJson('./avian/api/birdnet-api.php?action=lifelist').catch(function () { return null; }),
+ watchAuth(fetchJson('./avian/api/birdnet-api.php?action=stats')),
+ watchAuth(fetchJson('./avian/api/birdnet-api.php?action=lifelist')),
fetchJson('./avian/api/birdnet-api.php?action=timeseries&days=30').catch(function () { return null; }),
fetchJson('./avian/api/birdnet-api.php?action=firstseen&limit=10').catch(function () { return null; }),
fetchJson('./avian/api/birdnet-api.php?action=recent&hours=' + forHours).catch(function () { return null; }),
@@ -3118,6 +3306,7 @@
? vvRecent(forHours).catch(function () { return null; })
: Promise.resolve(null),
]).then(function (parts) {
+ apiPrivateMode = authFailed;
DATA.stats = parts[0];
DATA.lifelist = parts[1];
DATA.timeseries = parts[2];
@@ -3137,8 +3326,10 @@
// Kick off the initial fetch. Renders pull from DATA as soon as it
// populates; until then the page sits with empty histograms + lists.
- // animate=true so the collage blooms in on first load.
- refreshAll(true);
+ // animate=true so the collage blooms in on first load. The live SSE
+ // stream (below) only opens once this settles, so it never races the
+ // very first render.
+ refreshAll(true).then(function () { startLive(); });
// Hook into the window picker so the data refetches on change. Pass
// animate=true so the collage blooms (the silent poll passes nothing).
@@ -3167,24 +3358,103 @@
document.addEventListener('visibilitychange', function () {
if (document.hidden) {
stopPolling();
+ stopLive();
} else {
// Force an immediate refresh on return so the user sees fresh
// data right away, then resume normal polling cadence.
refreshAll();
startPolling();
+ startLive();
}
});
startPolling();
- // Card builds call this when a BirdNET-Go MQTT sensor updates: clear
- // the short-TTL response memos (they'd otherwise serve the pre-event
- // answer) and refresh immediately. No-op on the static page.
+ // Shared "something changed, refetch" path: clears the short-TTL
+ // response memos (they'd otherwise serve the pre-event answer) and
+ // refreshes right away. Card builds reach this via a BirdNET-Go MQTT
+ // sensor update (__exposeRefresh below); the live SSE stream (below)
+ // reaches it too - both are just triggers, neither carries any data.
+ function pushRefresh() {
+ _bgMemo = {};
+ _haMemo = {};
+ refreshAll();
+ }
+
+ // Card builds call this when a BirdNET-Go MQTT sensor updates. No-op
+ // on the static page.
if (AV_CFG.__exposeRefresh) {
- AV_CFG.__exposeRefresh(function () {
- _bgMemo = {};
- _haMemo = {};
- refreshAll();
- });
+ AV_CFG.__exposeRefresh(pushRefresh);
+ }
+
+ // ---- Live detections (SSE) ----
+ // BirdNET-Go's detections/stream endpoint (GET {base}/api/v2/detections/
+ // stream, an EventSource) pushes a 'detection' event the instant a new
+ // call lands. This is a REFRESH SIGNAL ONLY: the event payload is never
+ // parsed into DATA - only the polling fetches above ever populate it -
+ // so a server-version mismatch in the event's shape can't corrupt
+ // state, it can only fail to speed up a refresh that would have
+ // happened within POLL_MS anyway. Debounced 2s (a burst of near-
+ // simultaneous calls should trigger one refetch, not several).
+ var LIVE_ENABLED = AV_CFG.live !== false && typeof EventSource !== 'undefined';
+ var liveSource = null;
+ var liveReconnectT = null;
+ var liveDebounceT = null;
+ var liveReconnectDelay = 5000; // 5s, doubles up to a 60s cap
+ var liveFailures = 0; // consecutive drops since the last open
+ // Failing before the connection ever opens usually means a 404 (server
+ // predates the stream endpoint) or 401 (BirdNET-Go Private Mode -
+ // EventSource can't carry the Authorization header this page would
+ // otherwise send) - EventSource exposes no HTTP status, so that's
+ // indistinguishable from a one-off transient failure (BirdNET-Go/HA
+ // still starting up, a brief network blip). Retry once with the normal
+ // backoff before concluding it's permanent, so a startup race doesn't
+ // silently disable the feature for the rest of this boot. Normal 30s
+ // polling is unaffected either way.
+ var livePreOpenFailures = 0;
+ var liveGaveUp = false;
+
+ function liveDebouncedRefresh() {
+ clearTimeout(liveDebounceT);
+ liveDebounceT = setTimeout(pushRefresh, 2000);
+ }
+ function stopLive() {
+ clearTimeout(liveReconnectT);
+ liveReconnectT = null;
+ clearTimeout(liveDebounceT);
+ liveDebounceT = null;
+ if (liveSource) { liveSource.close(); liveSource = null; }
+ }
+ function startLive() {
+ if (!LIVE_ENABLED || liveGaveUp || liveSource || document.hidden) return;
+ var opened = false;
+ var es = new EventSource(bgUrl('/detections/stream'));
+ liveSource = es;
+ es.addEventListener('detection', liveDebouncedRefresh);
+ es.onopen = function () {
+ opened = true;
+ liveFailures = 0;
+ liveReconnectDelay = 5000;
+ };
+ es.onerror = function () {
+ if (liveSource !== es) return; // superseded by a later attempt already
+ stopLive();
+ if (!opened) {
+ livePreOpenFailures++;
+ if (livePreOpenFailures >= 2) { liveGaveUp = true; return; }
+ liveReconnectT = setTimeout(startLive, liveReconnectDelay);
+ liveReconnectDelay = Math.min(60000, liveReconnectDelay * 2);
+ return;
+ }
+ liveFailures++;
+ if (liveFailures >= 5) return; // stop retrying until the next card boot
+ liveReconnectT = setTimeout(startLive, liveReconnectDelay);
+ liveReconnectDelay = Math.min(60000, liveReconnectDelay * 2);
+ };
+ }
+ // Card builds call this from disconnectedCallback so a stream doesn't
+ // linger once the card leaves the dashboard. No-op on the static page.
+ if (AV_CFG.__exposeLiveStop) {
+ AV_CFG.__exposeLiveStop(stopLive);
}
// ---- Menu dropdown ----
@@ -4060,7 +4330,12 @@
document.getElementById('modalRecCount').textContent = tt('modal.captured', { n: dets.length });
document.getElementById('modalRecordings').innerHTML = dets.length
? dets.map(function (d) {
- return '<li class="rec-row" data-file="' + esc(d.file || '') + '" data-date="' + esc(d.d || '') + '">'
+ return '<li class="rec-row" data-file="' + esc(d.file || '') + '" data-date="' + esc(d.d || '') + '"'
+ // Multi-source stations (several RTSP/mic inputs) tag each
+ // detection with which one heard it; exposed as a data
+ // attribute (no dedicated UI yet) so it survives round-trip
+ // and can be styled/queried later without another API audit.
+ + (d.src ? ' data-source="' + esc(d.src) + '"' : '') + '>'
+ '<button class="play" type="button" aria-label="' + esc(tt('modal.play')) + '">' + ICON_PLAY + '</button>'
+ '<span class="when">' + esc(fmtRecTime(d.d, d.t)) + '<small>' + esc(fmtDateLine(d.d, d.t)) + '</small></span>'
// Review write-back needs a detection id - present with the
@@ -4871,7 +5146,7 @@
}
var ctx = getSpecCtx();
if (!ctx) { fail(tt('spectro.noWebAudio')); return; }
- fetch(bgAudioUrl(file))
+ bgAudioFetch(bgAudioUrl(file))
.then(function (r) {
if (!r.ok) throw new Error('HTTP ' + r.status);
return r.arrayBuffer();
@@ -4934,10 +5209,16 @@
flagBtn.disabled = false;
// Tooltips don't exist on touch - put a short reason IN the pill.
var isPath = typeof err === 'string' && err.indexOf('needs-ingress') === 0;
+ // 403 is BirdNET-Go's Aug 2026 CSRF enforcement rejecting the
+ // write (a stale self-minted token, or a proxy that stripped the
+ // cookie) - distinct enough from a generic error code to say so.
+ var isForbidden = err === 403;
var label = isPath ? tt('flag.noPath')
+ : isForbidden ? tt('flag.forbidden')
: (typeof err === 'number' ? tt('flag.errCode', { code: err }) : tt('flag.failed'));
var why = isPath
? tt('flag.needsIngress', { detail: err.slice('needs-ingress: '.length) })
+ : isForbidden ? tt('flag.forbiddenDetail')
: tt('flag.refused', { err: err });
try { console.warn('[bird-card] review write failed:', err); } catch (e) {}
setFlag('failed', label, tt('flag.couldNotSave', { why: why }));
diff --git a/homeassistant/www/config.js b/homeassistant/www/config.js
index 3a44c85c..9dd021c6 100644
--- a/homeassistant/www/config.js
+++ b/homeassistant/www/config.js
@@ -21,6 +21,18 @@ window.AV_CONFIG = {
// e.g. 'http://192.168.1.50:8080'.
birdnetGoUrl: '',
+ // API token for BirdNET-Go's "Private Mode" (Security.PrivateMode). When
+ // that's on, BirdNET-Go requires a signed-in session for every API call -
+ // this page has no login flow, so every request 401s without a token.
+ // Create one in BirdNET-Go's own settings and paste it here; it rides an
+ // Authorization: Bearer header on every request to BirdNET-Go (never to
+ // Wikipedia, Xeno-Canto, or Home Assistant).
+ //
+ // SECURITY NOTE: like wall.haToken below, /config/www files are served
+ // without authentication, so this token is readable by anyone who can
+ // reach this page. Leave '' unless Private Mode is actually on.
+ apiToken: '',
+
// Data source. 'auto' (default) reads BirdNET-Go's REST API and, if
// that's unreachable from this browser, falls back to rebuilding the
// detection stream from Home Assistant's history of the BirdNET-Go
@@ -32,6 +44,19 @@ window.AV_CONFIG = {
dataSource: 'auto',
historyDays: 10,
+ // Live detections. When true (the default), this page opens one
+ // EventSource to BirdNET-Go's detections/stream endpoint after the
+ // first load, so a new detection refreshes the page within a couple
+ // seconds instead of waiting for the next 30s poll. It's purely a
+ // "something changed, refetch" signal - no data comes from the stream
+ // itself, so nothing else about the page depends on it. Reconnects
+ // automatically (with backoff) if the connection drops; gives up for
+ // the rest of this page load if the endpoint 404s (older BirdNET-Go)
+ // or 401s (Private Mode - EventSource can't carry apiToken's
+ // Authorization header). The 30s poll above always keeps working
+ // either way; set this false to skip the stream entirely.
+ live: true,
+
// Feeder visits (optional). If a camera watches your feeder and an
// automation (e.g. LLM Vision) publishes each identified visitor as a
// BirdNET-style MQTT sensor trio (*_scientific_name, *_confidence,
diff --git a/homeassistant/www/i18n/en.js b/homeassistant/www/i18n/en.js
index adfbcf8e..a6a7cc7d 100644
--- a/homeassistant/www/i18n/en.js
+++ b/homeassistant/www/i18n/en.js
@@ -56,6 +56,11 @@
'stats.today': 'today',
'stats.last7days': 'last 7 days',
'stats.allTime': 'all time',
+ // Shown only when >=1 auto-discovered HA microphone sensor is offline
+ // (native MQTT discovery's availability topic reads 'unavailable').
+ 'stats.micsOffline': '{n} microphone(s) offline',
+ // Same note, but naming the one offline mic (HA formatEntityName available).
+ 'stats.micOfflineNamed': '{name} is offline',
// ---- Stats: Top Species ----
'stats.topSpecies': 'Top Species',
'stats.topSpecCap': 'most-heard, {window}',
@@ -86,6 +91,9 @@
'atlas.new': 'new',
'atlas.newTitle': 'first time this species has ever been heard here',
+ // ---- API errors ----
+ 'error.privateMode': 'BirdNET-Go requires sign-in (Private Mode) — set api_token in the card config',
+
// ---- Detail modal: chrome ----
'modal.close': 'Close',
'modal.pose': 'Pose',
@@ -146,6 +154,8 @@
'flag.couldNotSave': 'could not save: {why}',
'flag.needsIngress': 'needs the HA ingress connection - {detail}',
'flag.refused': 'BirdNET-Go refused ({err})',
+ 'flag.forbidden': 'blocked',
+ 'flag.forbiddenDetail': 'BirdNET-Go rejected the request (CSRF) - reload the card and try again',
// ---- Weather conditions (standalone / fallback path) ----
// Keyed by Home Assistant's weather condition slugs. The card build
diff --git a/homeassistant/www/index.html b/homeassistant/www/index.html
index a639e52b..ef6c4db5 100644
--- a/homeassistant/www/index.html
+++ b/homeassistant/www/index.html
@@ -98,6 +98,9 @@
<h3 data-i18n="stats.byPeriod">By Period</h3>
<small data-i18n="stats.byPeriodSub">detections, grouped by recency</small>
<ol id="statsByPeriod"></ol>
+ <!-- Only shown while >=1 auto-discovered HA microphone sensor
+ reads 'unavailable'/'unknown' - see renderMicOfflineNote(). -->
+ <small id="statsMicNote" class="mic-note" hidden></small>
</div>
<div class="grp">
<h3 data-i18n="stats.topSpecies">Top Species</h3>
diff --git a/homeassistant/www/styles.css b/homeassistant/www/styles.css
index 1d33889e..eea6d8ba 100644
--- a/homeassistant/www/styles.css
+++ b/homeassistant/www/styles.css
@@ -778,6 +778,9 @@
display: block; font: 10px var(--av-font-mono); color: var(--ink-soft);
letter-spacing: 0.06em; margin: 0 0 3px 12px;
}
+ /* Sits under the By Period list rather than above it, so its own
+ top margin replaces the subtitle's bottom one. */
+ .stats-side .grp small.mic-note { margin: 6px 0 0 12px; }
/* The whole list is one grid so counts share an aligned column, sized
to the longest name (max-content) so that column sits right beside
the names instead of stretching to a far edge. Each row is a subgrid
diff --git a/tests/test-api-hardening.js b/tests/test-api-hardening.js
new file mode 100644
index 00000000..db7b0812
--- /dev/null
+++ b/tests/test-api-hardening.js
@@ -0,0 +1,204 @@
+// Hardening against BirdNET-Go >=20260615 API/auth changes:
+// - api_token rides an Authorization: Bearer header on every BirdNET-Go
+// call (and ONLY BirdNET-Go calls - never Wikipedia/Xeno-Canto/HA).
+// - a 401 on the primary summary/daily fetches (Private Mode with no
+// token configured) surfaces a specific message instead of a silent
+// blank atlas.
+// - a detection's `source` field is accepted as either a plain string
+// or the {id,type,displayName} object BirdNET-Go's Aug 2026 release
+// sends, preferring displayName.
+// - an extended-capture clip's 503 + Retry-After is retried once before
+// falling through to the existing error path.
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const fs = require('fs');
+const { JSDOM } = require('jsdom');
+const assert = require('assert');
+const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
+
+function baseBoot(fetchImpl, opts) {
+ opts = opts || {};
+ const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+ url: 'http://ha.local:8123/x', runScripts: 'outside-only', pretendToBeVisual: true,
+ });
+ const { window } = dom;
+ window.fetch = fetchImpl;
+ window.Audio = class { constructor(){ this.crossOrigin=null; } addEventListener(){} load(){} play(){return Promise.resolve();} pause(){} };
+ Object.defineProperty(window.HTMLElement.prototype, 'clientWidth', { get() { return 800; } });
+ Object.defineProperty(window.HTMLElement.prototype, 'clientHeight', { get() { return 600; } });
+ window.HTMLCanvasElement.prototype.getContext = () => null;
+ window.ResizeObserver = class { observe(){} disconnect(){} };
+ if (opts.windowSetup) opts.windowSetup(window);
+ window.eval(CARD);
+ const card = window.document.createElement('habird-card');
+ card.setConfig(Object.assign({ data_source: 'api' }, opts.config || {}));
+ card.hass = { themes: {}, states: {} };
+ window.document.body.appendChild(card);
+ return { window, card };
+}
+
+const summary = [
+ { scientific_name: 'Corvus corax', common_name: 'Common Raven', count: 9, first_heard: '2026-06-01 09:00:00', last_heard: '2026-06-10 08:20:00', max_confidence: 0.95 },
+];
+const daily = summary.map(s => ({ ...s, hourly_counts: Array(24).fill(1), latest_heard: '13:55:00' }));
+
+let done = 0;
+const TOTAL = 4;
+function pass(name) { console.log(name + ' OK'); if (++done === TOTAL) console.log('\nAPI HARDENING TESTS PASSED'); }
+function fail(name, e) { console.error(name + ' FAIL:', e.message); process.exit(1); }
+
+// --- A: Bearer header on BirdNET-Go calls, absent from Wikipedia ---
+(function () {
+ const calls = [];
+ const fetchImpl = (url, opts) => {
+ calls.push({ url: String(url), headers: (opts && opts.headers) || null });
+ const u = String(url);
+ const p = u.replace('http://ha.local:8080', '');
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (u.startsWith('https://en.wikipedia.org/')) return ok({ extract: 'A large corvid.' });
+ if (p.startsWith('/api/v2/analytics/species/summary')) return ok(summary);
+ if (p.startsWith('/api/v2/analytics/species/daily')) return ok(daily);
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections')) return ok({ data: [] });
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+ };
+ const { window, card } = baseBoot(fetchImpl, { config: { api_token: 'tok-secret-123' } });
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ // Open the detail modal so the Wikipedia fetch actually fires.
+ root.querySelector('.bird-card').dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const bg = calls.filter(c => c.url.includes('/api/v2/'));
+ assert.ok(bg.length > 0, 'at least one BirdNET-Go call made');
+ bg.forEach(c => {
+ assert.ok(c.headers && c.headers.Authorization === 'Bearer tok-secret-123',
+ 'missing/wrong bearer on ' + c.url + ': ' + JSON.stringify(c.headers));
+ });
+ const wiki = calls.filter(c => c.url.startsWith('https://en.wikipedia.org/'));
+ assert.ok(wiki.length > 0, 'wikipedia call made');
+ wiki.forEach(c => {
+ assert.ok(!c.headers || !c.headers.Authorization,
+ 'bearer leaked onto wikipedia call: ' + JSON.stringify(c.headers));
+ });
+ pass('A: bearer attached to BirdNET-Go only');
+ } catch (e) { fail('A', e); }
+ }, 500);
+ } catch (e) { fail('A', e); }
+ }, 1700);
+})();
+
+// --- B: 401 on the primary summary/daily fetches -> Private Mode message ---
+(function () {
+ const fetchImpl = (url) => {
+ const p = String(url).replace('http://ha.local:8080', '');
+ const unauth = () => Promise.resolve({ ok: false, status: 401, json: () => Promise.reject(401) });
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (p.startsWith('/api/v2/analytics/species/summary')) return unauth();
+ if (p.startsWith('/api/v2/analytics/species/daily')) return unauth();
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections')) return ok({ data: [] });
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+ };
+ const { card } = baseBoot(fetchImpl);
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ const grid = root.getElementById('atlasGrid');
+ assert.ok(grid.textContent.indexOf('Private Mode') >= 0,
+ 'private-mode message shown: ' + grid.textContent);
+ assert.ok(grid.textContent.indexOf('No birds detected yet') < 0,
+ 'generic empty copy suppressed: ' + grid.textContent);
+ pass('B: 401 surfaces the Private Mode message');
+ } catch (e) { fail('B', e); }
+ }, 1700);
+})();
+
+// --- C: detection source as a string vs {id,type,displayName} object ---
+(function () {
+ const fetchImpl = (url) => {
+ const p = String(url).replace('http://ha.local:8080', '');
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (p.startsWith('/api/v2/analytics/species/summary')) return ok(summary);
+ if (p.startsWith('/api/v2/analytics/species/daily')) return ok(daily);
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections?queryType=search')) return ok({ data: [
+ { id: 101, date: '2026-06-10', time: '08:20:00', scientificName: 'Corvus corax', commonName: 'Common Raven', confidence: 0.71, source: { id: 'mic-1', type: 'rtsp', displayName: 'Backyard Mic' } },
+ { id: 102, date: '2026-06-09', time: '07:10:00', scientificName: 'Corvus corax', commonName: 'Common Raven', confidence: 0.65, source: 'Balcony Mic' },
+ ] });
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+ };
+ const { window, card } = baseBoot(fetchImpl);
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ root.querySelector('.bird-card').dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const rows = [...root.querySelectorAll('#modalRecordings .rec-row')];
+ const objectSourced = rows.find(r => r.getAttribute('data-file') === '101');
+ const stringSourced = rows.find(r => r.getAttribute('data-file') === '102');
+ assert.ok(objectSourced, 'row 101 rendered');
+ assert.ok(stringSourced, 'row 102 rendered');
+ assert.strictEqual(objectSourced.getAttribute('data-source'), 'Backyard Mic', 'object source -> displayName');
+ assert.strictEqual(stringSourced.getAttribute('data-source'), 'Balcony Mic', 'string source passes through');
+ pass('C: source string/object both render');
+ } catch (e) { fail('C', e); }
+ }, 900);
+ } catch (e) { fail('C', e); }
+ }, 1700);
+})();
+
+// --- D: audio clip 503 + Retry-After retries once, then succeeds ---
+(function () {
+ let audioCalls = 0;
+ const fetchImpl = (url) => {
+ const p = String(url).replace('http://ha.local:8080', '');
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (p.startsWith('/api/v2/analytics/species/summary')) return ok(summary);
+ if (p.startsWith('/api/v2/analytics/species/daily')) return ok(daily);
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections?queryType=search')) return ok({ data: [
+ { id: 103, date: '2026-06-10', time: '08:20:00', scientificName: 'Corvus corax', commonName: 'Common Raven', confidence: 0.71 },
+ ] });
+ if (p.startsWith('/api/v2/audio/')) {
+ audioCalls++;
+ if (audioCalls === 1) {
+ return Promise.resolve({ ok: false, status: 503, headers: { get: (h) => (h === 'Retry-After' ? '1' : null) } });
+ }
+ return Promise.resolve({ ok: true, status: 200, arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)) });
+ }
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+ };
+ const { window, card } = baseBoot(fetchImpl, { config: {} });
+ // Spectrogram decode needs a WebAudio context; the actual pixel paint is
+ // scheduled via requestAnimationFrame - no-op it so this test only
+ // exercises the fetch/retry/decode chain, not canvas rendering.
+ window.AudioContext = class {
+ decodeAudioData() { return Promise.resolve({ sampleRate: 44100, getChannelData: () => new Float32Array(2048) }); }
+ };
+ window.requestAnimationFrame = function () {};
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ root.querySelector('.bird-card').dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const row = root.querySelector('#modalRecordings .rec-row[data-file="103"]');
+ assert.ok(row, 'recording row rendered');
+ row.dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ assert.strictEqual(audioCalls, 2, 'exactly one retry after the 503: ' + audioCalls);
+ const loadingEl = row.querySelector('.rec-spectro-loading');
+ assert.strictEqual(loadingEl.style.display, 'none', 'decode succeeded after retry (loading indicator cleared)');
+ pass('D: 503 + Retry-After retried once then succeeded');
+ setTimeout(() => process.exit(0), 100);
+ } catch (e) { fail('D', e); }
+ }, 2200);
+ } catch (e) { fail('D', e); }
+ }, 900);
+ } catch (e) { fail('D', e); }
+ }, 1700);
+})();
diff --git a/tests/test-audio-auth.js b/tests/test-audio-auth.js
new file mode 100644
index 00000000..c619fda7
--- /dev/null
+++ b/tests/test-audio-auth.js
@@ -0,0 +1,120 @@
+// Private Mode clip playback: a bare `<audio src=...>` can never carry the
+// Authorization: Bearer header BirdNET-Go's Private Mode requires (unlike
+// the spectrogram decode path, which already fetches through bgFetch), so
+// tapping "play" on a detection would silently 401 even with a correctly
+// configured api_token. makeAudio() now routes playback through a fetched
+// blob (reusing bgAudioFetch, same as the spectrogram) when a token is
+// configured, and only then. This test drives the modal's play button and
+// asserts the audio clip request carried the bearer header and the <audio>
+// element ended up pointed at a blob: URL, never the raw (401-prone) API
+// URL.
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const fs = require('fs');
+const { JSDOM } = require('jsdom');
+const assert = require('assert');
+const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
+
+const summary = [
+ { scientific_name: 'Corvus corax', common_name: 'Common Raven', count: 9, first_heard: '2026-06-01 09:00:00', last_heard: '2026-06-10 08:20:00', max_confidence: 0.95 },
+];
+const daily = summary.map(s => ({ ...s, hourly_counts: Array(24).fill(1), latest_heard: '13:55:00' }));
+
+// A fuller <audio> stub than the other suites need: makeAudio() sets .src
+// asynchronously (after the authorized blob fetch resolves) and dispatches
+// a synthetic 'error' event on failure, so the stub has to actually track
+// listeners and the assigned src instead of no-op'ing everything.
+class StubAudio {
+ constructor() {
+ this._src = '';
+ this._listeners = {};
+ this.crossOrigin = null;
+ this.currentTime = 0;
+ this.duration = 0;
+ this.paused = true;
+ StubAudio.instances.push(this);
+ }
+ set src(v) { this._src = v; }
+ get src() { return this._src; }
+ addEventListener(type, fn) { (this._listeners[type] = this._listeners[type] || []).push(fn); }
+ dispatchEvent(evt) { (this._listeners[evt.type] || []).forEach((fn) => fn(evt)); return true; }
+ load() {}
+ play() { this.paused = false; return Promise.resolve(); }
+ pause() { this.paused = true; }
+}
+StubAudio.instances = [];
+
+function boot(fetchImpl, config) {
+ const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+ url: 'http://ha.local:8123/x', runScripts: 'outside-only', pretendToBeVisual: true,
+ });
+ const { window } = dom;
+ window.fetch = fetchImpl;
+ window.Audio = StubAudio;
+ // jsdom has no createObjectURL/revokeObjectURL implementation.
+ window.URL.createObjectURL = (blob) => 'blob:stub/' + (blob && blob.__id || 'x');
+ window.URL.revokeObjectURL = () => {};
+ Object.defineProperty(window.HTMLElement.prototype, 'clientWidth', { get() { return 800; } });
+ Object.defineProperty(window.HTMLElement.prototype, 'clientHeight', { get() { return 600; } });
+ window.HTMLCanvasElement.prototype.getContext = () => null;
+ window.ResizeObserver = class { observe(){} disconnect(){} };
+ window.eval(CARD);
+ const card = window.document.createElement('habird-card');
+ card.setConfig(Object.assign({ data_source: 'api', api_token: 'tok-secret-123' }, config || {}));
+ card.hass = { themes: {}, states: {} };
+ window.document.body.appendChild(card);
+ return { window, card };
+}
+
+const calls = [];
+const fetchImpl = (url, opts) => {
+ const u = String(url);
+ calls.push({ url: u, headers: (opts && opts.headers) || null });
+ const p = u.replace('http://ha.local:8080', '');
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (p.startsWith('/api/v2/analytics/species/summary')) return ok(summary);
+ if (p.startsWith('/api/v2/analytics/species/daily')) return ok(daily);
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections?queryType=search')) return ok({ data: [
+ { id: 201, date: '2026-06-10', time: '08:20:00', scientificName: 'Corvus corax', commonName: 'Common Raven', confidence: 0.71 },
+ ] });
+ if (p.startsWith('/api/v2/audio/')) {
+ const blob = { __id: '201', size: 8, type: 'audio/wav' };
+ return Promise.resolve({ ok: true, status: 200, blob: () => Promise.resolve(blob) });
+ }
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+};
+
+const { window, card } = boot(fetchImpl);
+
+setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ root.querySelector('.bird-card').dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const row = root.querySelector('#modalRecordings .rec-row[data-file="201"]');
+ assert.ok(row, 'recording row rendered');
+ const playBtn = row.querySelector('.play');
+ assert.ok(playBtn, 'play button rendered');
+ playBtn.dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const audioCalls = calls.filter((c) => c.url.includes('/api/v2/audio/'));
+ assert.ok(audioCalls.length > 0, 'clip audio was fetched (not left to a bare <audio src>)');
+ audioCalls.forEach((c) => {
+ assert.ok(c.headers && c.headers.Authorization === 'Bearer tok-secret-123',
+ 'clip fetch carried the bearer header: ' + JSON.stringify(c.headers));
+ });
+ const clipAudio = StubAudio.instances[StubAudio.instances.length - 1];
+ assert.ok(clipAudio, 'an <audio> element was created for the clip');
+ assert.ok(/^blob:/.test(clipAudio.src),
+ 'audio element points at a fetched blob, not the raw (401-prone) API URL: ' + clipAudio.src);
+ console.log('AUTHORIZED CLIP PLAYBACK TEST PASSED');
+ process.exit(0);
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+ }, 600);
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+ }, 900);
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+}, 1700);
diff --git a/tests/test-entity-suggestion.js b/tests/test-entity-suggestion.js
new file mode 100644
index 00000000..a47301ae
--- /dev/null
+++ b/tests/test-entity-suggestion.js
@@ -0,0 +1,61 @@
+// HA 2026.6+ card-picker entity suggestions: window.customCards' habird-card
+// entry exposes getEntitySuggestion(hass, entityId). It should suggest this
+// card for BirdNET-Go's MQTT sensor trio (and native discovery's sound-level
+// sensor) and stay silent for anything else, per
+// https://developers.home-assistant.io/blog/2026/05/27/custom-card-suggestions/
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const fs = require('fs');
+const { JSDOM } = require('jsdom');
+const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
+
+const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+ url: 'http://ha.local:8123/lovelace/birds', runScripts: 'outside-only', pretendToBeVisual: true,
+});
+const { window } = dom;
+window.fetch = () => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve([]) });
+window.Audio = class { addEventListener(){} load(){} play(){return Promise.resolve();} pause(){} };
+Object.defineProperty(window.HTMLElement.prototype, 'clientWidth', { get() { return 800; } });
+Object.defineProperty(window.HTMLElement.prototype, 'clientHeight', { get() { return 600; } });
+window.HTMLCanvasElement.prototype.getContext = () => null;
+window.ResizeObserver = class { observe(){} disconnect(){} };
+window.eval(CARD);
+
+const assert = require('assert');
+try {
+ const entry = window.customCards.find((c) => c.type === 'habird-card');
+ assert.ok(entry, 'habird-card registered in window.customCards');
+ assert.strictEqual(typeof entry.getEntitySuggestion, 'function', 'getEntitySuggestion present');
+
+ const hass = { states: {} };
+ const yes = entry.getEntitySuggestion(hass, 'sensor.back_yard_scientific_name');
+ assert.ok(yes && yes.config && yes.config.type === 'custom:habird-card',
+ 'suggests custom:habird-card for a BirdNET-Go sensor: ' + JSON.stringify(yes));
+
+ // Every documented BirdNET-Go suffix, and case-insensitively.
+ ['sensor.back_yard_confidence',
+ 'sensor.back_yard_last_species', 'sensor.back_yard_sound_level',
+ 'sensor.BACK_YARD_SCIENTIFIC_NAME'].forEach((id) => {
+ const s = entry.getEntitySuggestion(hass, id);
+ assert.ok(s && s.config && s.config.type === 'custom:habird-card', 'suggests for ' + id + ': ' + JSON.stringify(s));
+ });
+
+ const no = entry.getEntitySuggestion(hass, 'sensor.kitchen_temperature');
+ assert.ok(no === null || no === undefined, 'no suggestion for an unrelated sensor: ' + JSON.stringify(no));
+
+ // The bare '_species' suffix was dropped (too generic - matched any
+ // unrelated sensor ending in "_species", not just BirdNET-Go's own).
+ const bareSpecies = entry.getEntitySuggestion(hass, 'sensor.back_yard_species');
+ assert.ok(bareSpecies === null || bareSpecies === undefined,
+ 'bare _species suffix no longer suggested: ' + JSON.stringify(bareSpecies));
+
+ // A non-sensor domain sharing the suffix text shouldn't match either.
+ const otherDomain = entry.getEntitySuggestion(hass, 'binary_sensor.back_yard_scientific_name');
+ assert.ok(otherDomain === null || otherDomain === undefined, 'sensor domain required: ' + JSON.stringify(otherDomain));
+
+ console.log('ENTITY SUGGESTION TEST PASSED');
+ process.exit(0);
+} catch (e) {
+ console.error('FAIL:', e.message);
+ process.exit(1);
+}
diff --git a/tests/test-live.js b/tests/test-live.js
new file mode 100644
index 00000000..4d73c1d7
--- /dev/null
+++ b/tests/test-live.js
@@ -0,0 +1,196 @@
+// Live detections (SSE): the card opens one EventSource to BirdNET-Go's
+// detections/stream endpoint after the first successful load and treats
+// each 'detection' event as a pure "something changed, refetch" signal -
+// same push-refresh path the MQTT sensor watcher uses (test-mqtt.js).
+// Four scenarios: a detection event triggers a debounced refresh; an
+// endpoint that fails before ever opening (404/401) gets exactly one
+// retry (a startup race looks identical to a real 404/401 - EventSource
+// exposes no HTTP status) and then gives up, no unbounded retry storm;
+// config live:false never constructs an EventSource at all; and a second
+// setConfig call while the card stays connected tears down the previous
+// instance's live stream instead of leaking it.
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const fs = require('fs');
+const { JSDOM } = require('jsdom');
+const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
+
+const summary = [
+ { scientific_name: 'Calypte anna', common_name: "Anna's Hummingbird", count: 500, first_heard: '2026-01-02 08:00:00', last_heard: '2026-06-10 13:55:00', max_confidence: 0.99 },
+];
+const daily = summary.map(s => ({ ...s, hourly_counts: Array(24).fill(1), latest_heard: '13:55:00' }));
+
+// A stubbed EventSource: jsdom has no real implementation. Tracks every
+// instance constructed (so a test can assert a bounded count - "no retry
+// storm") and exposes __open/__detect/__error so a test can drive it by
+// hand instead of needing a real HTTP server.
+function makeStubES() {
+ class StubES {
+ constructor(url) {
+ this.url = url;
+ this._listeners = {};
+ this.onopen = null;
+ this.onerror = null;
+ this.closed = false;
+ StubES.instances.push(this);
+ }
+ addEventListener(type, fn) { (this._listeners[type] = this._listeners[type] || []).push(fn); }
+ close() { this.closed = true; }
+ __open() { if (this.onopen) this.onopen(); }
+ __detect() { (this._listeners.detection || []).forEach((fn) => fn({})); }
+ __error() { if (this.onerror) this.onerror(); }
+ }
+ StubES.instances = [];
+ return StubES;
+}
+
+// A stub that behaves like BirdNET-Go returning 404 (old server) or 401
+// (Private Mode): EventSource can't read the HTTP status itself, so both
+// surface identically - the connection fails before onopen ever fires.
+function makeImmediateFailES() {
+ class FailES {
+ constructor(url) {
+ this.url = url;
+ this._listeners = {};
+ this.onopen = null;
+ this.onerror = null;
+ FailES.instances.push(this);
+ // Real EventSource failures are async (network round-trip); a
+ // setTimeout keeps this stub honest about that instead of firing
+ // synchronously inside the constructor.
+ setTimeout(() => { if (this.onerror) this.onerror(); }, 0);
+ }
+ addEventListener(type, fn) { (this._listeners[type] = this._listeners[type] || []).push(fn); }
+ close() {}
+ }
+ FailES.instances = [];
+ return FailES;
+}
+
+function boot(config, ESClass) {
+ const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+ url: 'http://ha.local:8123/lovelace/birds', runScripts: 'outside-only', pretendToBeVisual: true,
+ });
+ const { window } = dom;
+ const errors = [];
+ window.addEventListener('error', (e) => errors.push((e.error && e.error.stack) || e.message));
+ let summaryCalls = 0;
+ window.fetch = (url) => {
+ const p = String(url).replace('http://ha.local:8080', '');
+ const ok = (b) => Promise.resolve({ ok: true, status: 200, json: () => Promise.resolve(JSON.parse(JSON.stringify(b))) });
+ if (p.startsWith('/api/v2/analytics/species/summary')) { summaryCalls++; return ok(summary); }
+ if (p.startsWith('/api/v2/analytics/species/daily')) return ok(daily);
+ if (p.includes('/analytics/')) return ok({ data: [] });
+ if (p.includes('/detections')) return ok({ data: [] });
+ return Promise.resolve({ ok: false, status: 404, json: () => Promise.reject(404) });
+ };
+ window.Audio = class { addEventListener(){} load(){} play(){return Promise.resolve();} pause(){} };
+ Object.defineProperty(window.HTMLElement.prototype, 'clientWidth', { get() { return this.id === 'collage' ? 1200 : 300; } });
+ Object.defineProperty(window.HTMLElement.prototype, 'clientHeight', { get() { return this.id === 'collage' ? 800 : 100; } });
+ window.HTMLCanvasElement.prototype.getContext = () => null;
+ window.ResizeObserver = class { observe(){} disconnect(){} };
+ window.EventSource = ESClass;
+ window.eval(CARD);
+
+ const card = window.document.createElement('habird-card');
+ card.setConfig(config);
+ card.hass = { themes: {}, states: {} };
+ window.document.body.appendChild(card);
+ return { window, card, errors, getSummaryCalls: () => summaryCalls };
+}
+
+const assert = require('assert');
+let remaining = 4;
+function scenarioDone(label) {
+ console.log(label);
+ if (--remaining === 0) { console.log('\nLIVE SSE TESTS PASSED'); process.exit(0); }
+}
+
+// --- Scenario A: detection event -> debounced push-refresh ---
+{
+ const StubES = makeStubES();
+ const { errors, getSummaryCalls } = boot({}, StubES); // default config: live defaults true
+ setTimeout(() => {
+ try {
+ assert.strictEqual(StubES.instances.length, 1, 'one EventSource opened after first load: ' + StubES.instances.length);
+ const es = StubES.instances[0];
+ assert.strictEqual(es.url, 'http://ha.local:8080/api/v2/detections/stream', 'stream URL: ' + es.url);
+ es.__open();
+ const before = getSummaryCalls();
+ es.__detect();
+ // Immediately after the event nothing has fetched yet - it's debounced.
+ assert.strictEqual(getSummaryCalls(), before, 'refresh is debounced, not immediate');
+ setTimeout(() => {
+ try {
+ assert.ok(getSummaryCalls() > before, 'detection event triggered a refresh: ' + before + ' -> ' + getSummaryCalls());
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ scenarioDone('A: detection event -> push refresh OK');
+ } catch (e) { console.error('A FAIL:', e.message); process.exit(1); }
+ }, 2300); // > the 2s debounce
+ } catch (e) { console.error('A FAIL:', e.message); process.exit(1); }
+ }, 1700);
+}
+
+// --- Scenario B: immediate failure (404/401) -> one retry, then gives up ---
+{
+ const FailES = makeImmediateFailES();
+ const { errors } = boot({}, FailES); // default config: live defaults true
+ setTimeout(() => {
+ try {
+ // A failure before the very first onopen is indistinguishable from a
+ // one-off startup race (BirdNET-Go/HA still coming up), so it gets
+ // exactly one retry (first backoff ~5s) before being treated as
+ // permanent. Wait past that retry and confirm there were exactly two
+ // attempts total, then confirm no third ever follows (no unbounded
+ // retry storm).
+ assert.strictEqual(FailES.instances.length, 2, 'exactly one retry after the first pre-open failure: ' + FailES.instances.length);
+ setTimeout(() => {
+ try {
+ assert.strictEqual(FailES.instances.length, 2, 'gives up after the second pre-open failure, no further attempts: ' + FailES.instances.length);
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ scenarioDone('B: immediate 404/401 -> one retry then gives up OK');
+ } catch (e) { console.error('B FAIL:', e.message); process.exit(1); }
+ }, 15000);
+ } catch (e) { console.error('B FAIL:', e.message); process.exit(1); }
+ }, 9000);
+}
+
+// --- Scenario C: live:false -> EventSource never constructed ---
+{
+ const StubES = makeStubES();
+ const { errors } = boot({ live: false }, StubES);
+ setTimeout(() => {
+ try {
+ assert.strictEqual(StubES.instances.length, 0, 'live:false must never open a stream: ' + StubES.instances.length);
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ scenarioDone('C: live:false -> no EventSource OK');
+ } catch (e) { console.error('C FAIL:', e.message); process.exit(1); }
+ }, 1700);
+}
+
+// --- Scenario D: setConfig while connected tears down the old live stream ---
+// Regression test for the setConfig reboot path leaking the previous
+// instance's EventSource (it only ever closed on disconnectedCallback,
+// never on a reconfigure-while-connected - the dashboard editor's live
+// preview calls setConfig on every keystroke).
+{
+ const StubES = makeStubES();
+ const { card, errors } = boot({}, StubES); // default config: live defaults true
+ setTimeout(() => {
+ try {
+ assert.strictEqual(StubES.instances.length, 1, 'one EventSource opened after first boot: ' + StubES.instances.length);
+ const first = StubES.instances[0];
+ first.__open();
+ card.setConfig({ title: 'renamed' });
+ assert.strictEqual(first.closed, true, 'previous EventSource closed by the reconfigure, not orphaned');
+ setTimeout(() => {
+ try {
+ assert.strictEqual(StubES.instances.length, 2, 'the rebooted instance opens its own EventSource: ' + StubES.instances.length);
+ assert.notStrictEqual(StubES.instances[1], first, 'a fresh EventSource, not the old one reused');
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ scenarioDone('D: setConfig reconfigure closes the previous live stream OK');
+ } catch (e) { console.error('D FAIL:', e.message); process.exit(1); }
+ }, 1700);
+ } catch (e) { console.error('D FAIL:', e.message); process.exit(1); }
+ }, 1700);
+}
diff --git a/tests/test-mic-availability.js b/tests/test-mic-availability.js
new file mode 100644
index 00000000..d180472d
--- /dev/null
+++ b/tests/test-mic-availability.js
@@ -0,0 +1,163 @@
+// BirdNET-Go's native HA MQTT auto-discovery (shipped Jan 2026, e.g. via
+// the alexbelgium add-on's mqtt_auto_config) publishes the same
+// *_scientific_name / *_confidence / *_last_species trio the card already
+// discovers, but backed by a device availability topic: entities flip to
+// state 'unavailable' when their source drops. Assert that an offline mic
+// (a) doesn't break aggregation or drop its prior history, and (b) drives
+// a small "N microphone(s) offline" note - present only while >=1 mic is
+// offline, absent when every discovered mic is online.
+const path = require('path');
+const ROOT = path.resolve(__dirname, '..');
+const fs = require('fs');
+const { JSDOM } = require('jsdom');
+const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
+
+function boot() {
+ const dom = new JSDOM('<!doctype html><html><body></body></html>', {
+ url: 'http://ha.local:8123/lovelace/birds', runScripts: 'outside-only', pretendToBeVisual: true,
+ });
+ const { window } = dom;
+ const errors = [];
+ window.addEventListener('error', e => errors.push((e.error && e.error.stack) || e.message));
+ // Every direct fetch (BirdNET-Go API on :8080) fails - data must come
+ // from HA history of the MQTT sensors, same as test-mqtt.js.
+ window.fetch = () => Promise.reject(new TypeError('Failed to fetch'));
+ window.Audio = class { addEventListener(){} load(){} play(){return Promise.resolve();} pause(){} };
+ Object.defineProperty(window.HTMLElement.prototype, 'clientWidth', { get() { return this.id === 'collage' ? 1200 : 300; } });
+ Object.defineProperty(window.HTMLElement.prototype, 'clientHeight', { get() { return this.id === 'collage' ? 800 : 100; } });
+ window.HTMLCanvasElement.prototype.getContext = () => null;
+ window.ResizeObserver = class { observe(){} disconnect(){} };
+ window.eval(CARD);
+ return { window, errors };
+}
+
+const now = Date.now();
+const iso = (msAgo) => new Date(now - msAgo).toISOString();
+function entityRows(id, rows) {
+ return rows.map((r, i) => i === 0
+ ? { entity_id: id, state: r[0], last_changed: r[1] }
+ : { state: r[0], last_changed: r[1] });
+}
+
+const A = 'sensor.birdnet_go_door_bell'; // stays online
+const B = 'sensor.birdnet_go_garden'; // goes offline (native discovery availability)
+
+// Both mics have prior history - B's must survive being marked offline.
+// hist shape: one array per entity, first row carries entity_id.
+const historyByEntity = [
+ entityRows(A + '_scientific_name', [['Calypte anna', iso(3 * 3600000)]]),
+ entityRows(A + '_confidence', [['99.0', iso(3 * 3600000)]]),
+ entityRows(A + '_last_species', [["Anna's Hummingbird", iso(3 * 3600000)]]),
+ entityRows(B + '_scientific_name', [['Corvus corax', iso(2 * 3600000)]]),
+ entityRows(B + '_confidence', [['71.0', iso(2 * 3600000)]]),
+ entityRows(B + '_last_species', [['Common Raven', iso(2 * 3600000)]]),
+];
+
+function makeHass(bOffline, opts) {
+ opts = opts || {};
+ const hass = {
+ themes: { darkMode: false },
+ states: {
+ [A + '_scientific_name']: { entity_id: A + '_scientific_name', state: 'Calypte anna' },
+ [A + '_confidence']: { entity_id: A + '_confidence', state: '99.0' },
+ [A + '_last_species']: { entity_id: A + '_last_species', state: "Anna's Hummingbird" },
+ [B + '_scientific_name']: { entity_id: B + '_scientific_name', state: bOffline ? 'unavailable' : 'Corvus corax' },
+ [B + '_confidence']: { entity_id: B + '_confidence', state: bOffline ? 'unavailable' : '71.0' },
+ [B + '_last_species']: { entity_id: B + '_last_species', state: bOffline ? 'unavailable' : 'Common Raven' },
+ 'sun.sun': { attributes: {} },
+ },
+ callApi: (method, p) => {
+ if (p.startsWith('history/period/')) return Promise.resolve(JSON.parse(JSON.stringify(historyByEntity)));
+ return Promise.reject(404);
+ },
+ };
+ if (opts.formatEntityName) hass.formatEntityName = opts.formatEntityName;
+ return hass;
+}
+
+const assert = require('assert');
+
+function runOfflineCase(done) {
+ const { window, errors } = boot();
+ const hass = makeHass(true);
+ const card = window.document.createElement('habird-card');
+ card.setConfig({});
+ card.hass = hass;
+ window.document.body.appendChild(card);
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ const tiles = [...root.querySelectorAll('.gtile')];
+ // Aggregation didn't break, and B's prior history wasn't dropped:
+ // both species still render from history despite B currently
+ // reading 'unavailable'.
+ assert.strictEqual(tiles.length, 2, 'both mics history-derived species render: ' + tiles.length);
+ const anna = tiles.find(t => t.dataset.sci === 'Calypte anna');
+ const raven = tiles.find(t => t.dataset.sci === 'Corvus corax');
+ assert.ok(anna && anna.title.includes('1 call'), 'online mic call counted: ' + (anna && anna.title));
+ assert.ok(raven && raven.title.includes('1 call'), 'offline mic keeps its prior history: ' + (raven && raven.title));
+
+ const note = root.getElementById('statsMicNote');
+ assert.ok(note, 'mic note element present');
+ assert.strictEqual(note.hidden, false, 'note shown with 1 mic offline');
+ assert.strictEqual(note.textContent, '1 microphone(s) offline', 'note text: ' + note.textContent);
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ console.log('MIC OFFLINE NOTE TEST PASSED');
+ done();
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+ }, 2000);
+}
+
+// hass.formatEntityName (HA 2026.6+) is defined and exactly one mic is
+// offline - the note must name that mic (stats.micOfflineNamed), not fall
+// back to the plain count. Regression test: the mock hass never used to
+// define formatEntityName, so this branch (haEntityLabel's "no formatter"
+// fallback vs. its actual formatter path) had zero coverage - a wrong
+// entity id, an inverted offline.length===1 check, or a typo'd tt() key
+// would all still render fine and slip through.
+function runNamedOfflineCase(done) {
+ const { window, errors } = boot();
+ const hass = makeHass(true, {
+ formatEntityName: (st) => (st.entity_id === B + '_scientific_name' ? 'Garden Mic' : null),
+ });
+ const card = window.document.createElement('habird-card');
+ card.setConfig({});
+ card.hass = hass;
+ window.document.body.appendChild(card);
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ const note = root.getElementById('statsMicNote');
+ assert.ok(note, 'mic note element present');
+ assert.strictEqual(note.hidden, false, 'note shown with 1 mic offline');
+ assert.strictEqual(note.textContent, 'Garden Mic is offline',
+ 'note names the offline mic via formatEntityName: ' + note.textContent);
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ console.log('NAMED MIC OFFLINE NOTE TEST PASSED');
+ done();
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+ }, 2000);
+}
+
+function runAllOnlineCase() {
+ const { window, errors } = boot();
+ const hass = makeHass(false);
+ const card = window.document.createElement('habird-card');
+ card.setConfig({});
+ card.hass = hass;
+ window.document.body.appendChild(card);
+ setTimeout(() => {
+ try {
+ const root = card.shadowRoot;
+ const note = root.getElementById('statsMicNote');
+ assert.ok(note, 'mic note element present');
+ assert.strictEqual(note.hidden, true, 'note hidden when every mic is online');
+ assert.strictEqual(note.textContent, '', 'note text empty when hidden');
+ assert.deepStrictEqual(errors, [], 'errors: ' + errors.join('; '));
+ console.log('ALL-ONLINE NO-NOTE TEST PASSED');
+ process.exit(0);
+ } catch (e) { console.error('FAIL:', e.message); process.exit(1); }
+ }, 2000);
+}
+
+runOfflineCase(() => runNamedOfflineCase(runAllOnlineCase));
diff --git a/tests/test-review.js b/tests/test-review.js
index ea1c782e..2bdffa45 100644
--- a/tests/test-review.js
+++ b/tests/test-review.js
@@ -8,7 +8,7 @@ const fs = require('fs');
const { JSDOM } = require('jsdom');
const CARD = fs.readFileSync(ROOT + '/dist/habird-card.js', 'utf8');
-function boot({ ingress }) {
+function boot({ ingress, reviewStatus }) {
const dom = new JSDOM('<!doctype html><html><body></body></html>', { url: 'http://ha.local:8123/x', runScripts: 'outside-only', pretendToBeVisual: true });
const { window } = dom;
const summary = [
@@ -24,6 +24,7 @@ function boot({ ingress }) {
if (u.startsWith('https://en.wikipedia.org/')) return ok({ extract: 'A large bird.' });
if (opts && opts.method === 'POST' && p.includes('/review')) {
posts.push({ url: u, headers: opts.headers, body: JSON.parse(opts.body), cookie: window.document.cookie });
+ if (reviewStatus === 403) return Promise.resolve({ ok: false, status: 403, json: () => Promise.reject(403) });
return ok({ success: true });
}
if (p.startsWith('/api/v2/analytics/species/summary')) return ok(summary);
@@ -80,13 +81,19 @@ let done = 0;
assert.strictEqual(posts.length, 1, 'one POST');
assert.ok(posts[0].url.startsWith('/api/hassio_ingress/TOK/api/v2/detections/42/review'), 'via ingress: ' + posts[0].url);
assert.strictEqual(posts[0].body.verified, 'false_positive');
+ // Sent alongside the legacy field: BirdNET-Go's public API docs
+ // don't pin down the review body's field name, and the Apr 2026
+ // release renamed the search response's verdict field
+ // 'verified' -> 'correct' - unknown fields are ignored
+ // server-side, so sending both reads correctly either way.
+ assert.strictEqual(posts[0].body.correct, 'false_positive');
const tok = posts[0].headers['X-CSRF-Token'];
assert.ok(tok && tok.length > 10, 'token minted');
assert.ok(posts[0].cookie.includes('csrf=' + tok), 'header equals the cookie (double-submit)');
assert.strictEqual(flag.getAttribute('data-state'), 'done');
assert.strictEqual(flag.textContent, '✓');
console.log('A: ingress write-back OK (self-minted double-submit token)');
- if (++done === 2) console.log('\nREVIEW V2 TESTS PASSED');
+ if (++done === 3) console.log('\nREVIEW V2 TESTS PASSED');
} catch (e) { console.error('A FAIL:', e.message); process.exit(1); }
}, 400);
} catch (e) { console.error('A FAIL:', e.message); process.exit(1); }
@@ -114,8 +121,10 @@ let done = 0;
try {
assert.strictEqual(flag.getAttribute('data-state'), 'idle', 'failure auto-resets');
console.log('B: cross-origin refusal + auto-reset OK');
- if (++done === 2) console.log('\nREVIEW V2 TESTS PASSED');
- setTimeout(() => process.exit(0), 100);
+ if (++done === 3) {
+ console.log('\nREVIEW V2 TESTS PASSED');
+ setTimeout(() => process.exit(0), 100);
+ }
} catch (e) { console.error('B FAIL:', e.message); process.exit(1); }
}, 5400);
} catch (e) { console.error('B FAIL:', e.message); process.exit(1); }
@@ -124,3 +133,34 @@ let done = 0;
}, 900);
}, 1700);
}
+
+// --- C: BirdNET-Go's Aug 2026 CSRF enforcement rejects the write (403) ---
+// -> the flag pill fails with a distinct "blocked" message, not the
+// generic error-code pill.
+{
+ const { window, card, posts } = boot({ ingress: true, reviewStatus: 403 });
+ setTimeout(() => {
+ const root = card.shadowRoot;
+ root.querySelector('.bird-card').dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ const flag = root.querySelector('#modalRecordings .rec-row .flag');
+ flag.dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ flag.dispatchEvent(new window.MouseEvent('click', { bubbles: true, composed: true }));
+ setTimeout(() => {
+ try {
+ assert.strictEqual(posts.length, 1, 'one POST attempted');
+ assert.strictEqual(flag.getAttribute('data-state'), 'failed');
+ assert.strictEqual(flag.textContent, 'blocked', 'distinct 403 label, not a generic error code');
+ assert.ok(flag.title.includes('CSRF'), 'tooltip names the cause: ' + flag.title);
+ console.log('C: 403 CSRF rejection -> distinct "blocked" message OK');
+ if (++done === 3) {
+ console.log('\nREVIEW V2 TESTS PASSED');
+ setTimeout(() => process.exit(0), 100);
+ }
+ } catch (e) { console.error('C FAIL:', e.message); process.exit(1); }
+ }, 400);
+ } catch (e) { console.error('C FAIL:', e.message); process.exit(1); }
+ }, 900);
+ }, 1700);
+}