Release 2026-06-01: Bird Families tab, species coverage, basemaps, and map fixes by jimchurches · Pull Request #264 · jimchurches/myebirdstuff

jimchurches · 2026-06-01T01:10:04Z

Summary

Promote the current beta-next integration branch to main as the next Explorer release. This release focuses on Bird Families as a first-class tab, world species coverage metrics, map/basemap improvements, Streamlit API updates, popup constant codegen, and test/CI hygiene.

Embedded build version remains 2026-05-24 until the follow-up hygiene branch bumps it to 2026-06-01.

Changes

Bird Families & species coverage

Move Bird Families to a top-level main tab (Move Bird Families to a top-level main tab #261)
Add world species coverage against eBird taxonomy on the Bird Families overview (Add global species coverage against eBird taxonomy #263)
Rename the Interesting Lists expander to Species: Coverage and refine layout/performance

Maps & basemaps

Add CARTO Voyager and Esri World Topo basemap options (Add CARTO Voyager and Esri World Topo basemap options #248)
Centralize basemap configuration in a shared YAML manifest (Centralize basemap config in shared YAML manifest #257)
Shared helper for map species banner URL resolution (Shared helper for map species banner URL resolution #256)
Fix species map banner links to resolve via base species code (fix: Species map banner links via base species code #252)
Unify MAP_POPUP_MAX_WIDTH_PX across Python, React, and HTML export via codegen from defaults.py ([Enhancement] Unify MAP_POPUP_MAX_WIDTH_PX across Python, React, and export JS #265, merged Unify MAP_POPUP_MAX_WIDTH_PX via codegen from defaults.py #266)

Streamlit & export

Replace deprecated st.components.v1.html with st.iframe (Replace deprecated st.components.v1.html with st.iframe #259)
Pass basemap defaults through HTML export config; tighten export tests

Testing & CI

Isolate E2E config from repo config_secret.yaml (Fix E2E tests overwriting local config_secret.yaml #250)
Expanded coverage for basemap manifest, taxonomy bundle, family summary, and banner URL integration
Generated map assets check now covers popup width constants (generate_basemap_assets.py --check)

Tooling & dependencies

Add /pr-review Cursor command (Add /pr-review Cursor command for targeted issue/PR reviews #255)
Bump Python deps via Dependabot (chore(deps): bump the python-deps group with 2 updates #260)

Testing

python3 -m ruff check explorer/ — passed
python3 -m pytest tests/ -q — 636 passed, 7 skipped (includes [Enhancement] Unify MAP_POPUP_MAX_WIDTH_PX across Python, React, and export JS #265 export popup width test)

Notes

38 commits on beta-next since main
Follow-up hygiene work (including build version bump to 2026-06-01) will land on release-2026-06-01-final-review after this merge.

Issues

Refs: #246 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #246

Refs: #247 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #247

Refs: #251 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #251

Refs: #254 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #254

Refs: #253 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #253

Replace hand-maintained tile URLs across Python, React, and HTML export with a single basemaps.yaml source, generated TS assets, and runtime export injection. Fixes #249 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #249 Co-authored-by: Cursor <cursoragent@cursor.com>

Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #249

Refs: #258 Co-authored-by: Cursor <cursoragent@cursor.com>

Refs: #258

Updates the requirements on [streamlit](https://github.com/streamlit/streamlit) and [ruff](https://github.com/astral-sh/ruff) to permit the latest version. Updates `streamlit` to 1.58.0 - [Release notes](https://github.com/streamlit/streamlit/releases) - [Commits](streamlit/streamlit@1.57.0...1.58.0) Updates `ruff` to 0.15.15 - [Release notes](https://github.com/astral-sh/ruff/releases) - [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md) - [Commits](astral-sh/ruff@0.15.14...0.15.15) --- updated-dependencies: - dependency-name: streamlit dependency-version: 1.58.0 dependency-type: direct:production dependency-group: python-deps - dependency-name: ruff dependency-version: 0.15.15 dependency-type: direct:production dependency-group: python-deps ... Signed-off-by: dependabot[bot] <support@github.com>

Ranking & Lists keeps nested Top Lists and Interesting Lists only; species-group coverage UI and prep bundle are unchanged. Co-authored-by: Cursor <cursoragent@cursor.com>

Extract species-group coverage UI and prep helpers from rankings module; add fragment tests and fix empty-taxonomy messaging when bundle exists. Co-authored-by: Cursor <cursoragent@cursor.com>

…hon-deps-c872317b72 chore(deps): bump the python-deps group with 2 updates

RANKING_LISTS_FAMILIES_BUNDLE_KEY replaces RANKINGS_TAB_BUNDLE_KEY; align build_ranking_lists_families_bundle and sync_ranking_lists_families_bundle. Co-authored-by: Cursor <cursoragent@cursor.com>

Move magic numbers into defaults.py, streamlit_ui_constants.py, and settings_schema_defaults.py; dedupe MAP_HEIGHT bounds via schema re-export; rename map_working/taxonomy_assets and other opaque locals; drop stale app_prep_map_ui test aliases in favour of app_prep_map_leaflet_caches. Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T02:20:04Z

Hygiene branch update (`release-2026-06-01-final-review`)

Post-release code review cleanup committed on the hygiene branch (ahead of merging onto beta-next):

Commit: 5c1fc318 — refactor: Centralize Streamlit defaults and clarify orchestration naming

What changed

Constants → correct home

MAP_IFRAME_MIN_HEIGHT_PX, Leaflet session LRU sizes, Bird Families dataframe height, country not-seen cache size → defaults.py
Spinner emoji iframe height + batch-ms floor → streamlit_ui_constants.py
Rankings visible rows + yearly column window → settings_schema_defaults.py (no more magic 16 / 10 / 3 / 25)
MAP_HEIGHT_PX_* deduped: single source in schema, re-exported from defaults.py

Naming

mw / tax → map_working / taxonomy_assets in app orchestration
ix → species_search_index; settings UI _msc* → marker_colour_scheme_*

Cleanup

Removed stale _leaflet_payload_cache_* aliases from app_prep_map_ui; tests import app_prep_map_leaflet_caches directly

Checks

python3 -m ruff check explorer/ — passed
python3 -m pytest tests/ -q — 635 passed, 7 skipped

Branch state

b39c6c79 — build version bump to 2026-06-01
5c1fc318 — defaults/naming hygiene (this commit)

Deferred follow-ups (not in this commit): triplicated MAP_POPUP_MAX_WIDTH_PX across Python/TS/export JS; issue-led module docstrings trim.

…lts.py Extend generate_basemap_assets.py to emit TS, CSS, and export JS constants from MAP_POPUP_MAX_WIDTH_PX; HTML export concatenates the generated snippet; CI --check covers all generated map assets. Refs: #265 Co-authored-by: Cursor <cursoragent@cursor.com>

…266) Refs: #265

Replace issue-led module and helper docstrings in app orchestration, rankings, country, yearly summary, bird families, and map sidebar UI with behaviour-focused descriptions for new contributors. Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

Complete the docstring hygiene pass across orchestration, caches, settings, theme, constants, landing/data loading, maintenance, and defaults inline comments so behaviour is documented without (refs #NN) issue ledgers. Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T02:55:28Z

Docstring hygiene (release branch)

Two commits on release-2026-06-01-final-review:

545e4c2b — Core tab modules: app.py, rankings, country, yearly summary, bird families, app_map_ui.py
Latest — Remaining Streamlit package: orchestration, caches, settings, theme, constants, landing, maintenance, perf, defaults comments

Goal: Describe what/why in docstrings; drop (refs #NN) from module/helper docs (issue history stays in git/PRs).

Scope: All explorer/app/streamlit/ — no remaining refs # in that tree.

Checks: ruff check explorer/ + pytest tests/ -q passed on each commit.

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T03:00:01Z

Release hygiene (branch `release-2026-06-01-final-review`)

Follow-up doc/comment cleanup on the release review branch — no behaviour changes.

Commits

09affa62 — docs: Rewrite presentation CSS comments without issue refs (checklist_stats_display, rankings_display, maintenance_display)
841be4f3 — docs: Remove issue refs from presentation module docstrings (checklist_stats_display, maintenance_display, rankings_display, stats_html_helpers, design_map_preview, leaflet_map_export.js)

Earlier on same branch

Streamlit module docstrings (no (refs #NN))
Centralized defaults / naming pass
Build version 2026-06-01

Quality

ruff check explorer/ — pass
pytest tests/ -q — 635 passed, 7 skipped

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T03:07:32Z

Hygiene (release-2026-06-01-final-review): moved main-tab hover green (#156248) from streamlit_theme.py to THEME_MAIN_TAB_HOVER_HEX in defaults.py alongside THEME_PRIMARY_HEX and other theme tokens — no visual change, just one place for tweakables.

Commit: `refactor: Centralize main tab hover colour in defaults`

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T03:09:25Z

Hygiene: _filter_taxonomy_for_coverage parameter renamed tax → taxonomy_frame in bird_families_streamlit_html.py (matches naming rubric; no behaviour change).

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T03:34:10Z

Hygiene: cleared 8 pre-existing F401 unused imports in test files (test_all_locations_map_component, test_design_map_preview, test_map_renderer, test_streamlit_map_prep, test_taxonomy_bundle) — ruff check tests/ now clean; no test behaviour change.

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches · 2026-06-01T04:00:41Z

Final review hygiene: theme inactive/header hex moved to `defaults.py`; `streamlit_theme.py` issue refs removed; `taxonomy_frame` naming in Bird Families coverage; test docstrings/comments cleaned (kept `refs #189` on release-version tests only). No behaviour change.

Refs: #264

jimchurches and others added 30 commits May 24, 2026 12:37

ui: Add CARTO Voyager and Esri World Topo basemap options

a6f330a

Refs: #246 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Tidy basemap docs and tests after PR review

df32223

Refs: #246 Co-authored-by: Cursor <cursoragent@cursor.com>

ui: Add CARTO Voyager and Esri World Topo basemap options (#248)

b3e5eba

Refs: #246

fix: Isolate E2E config from repo config_secret.yaml

843058a

Refs: #247 Co-authored-by: Cursor <cursoragent@cursor.com>

test: Tighten E2E config isolation coverage after review

c85e8a3

Refs: #247 Co-authored-by: Cursor <cursoragent@cursor.com>

fix: Isolate E2E config from repo config_secret.yaml (#250)

a604264

Refs: #247

fix: Resolve species map banner links via base species code

7478ce0

Refs: #251 Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Tidy species banner URL lookup after review

8abb063

Refs: #251 Co-authored-by: Cursor <cursoragent@cursor.com>

fix: Resolve species map banner links via base species code (#252)

a7ca8c0

Refs: #251

docs: Add /pr-review Cursor command for targeted issue/PR reviews

300a4da

Refs: #254 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Add /pr-review Cursor command for targeted issue/PR reviews (#255)

3a1394d

Refs: #254

refactor: Add shared helper for map species banner URLs

1fceb1c

Refs: #253 Co-authored-by: Cursor <cursoragent@cursor.com>

test: Assert map prep banner HTML includes species eBird links

2f20f8e

Refs: #253 Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Shared helper for map species banner URL resolution (#256)

a12bc91

Refs: #253

refactor: Centralize basemap config in shared YAML manifest

f1a7232

Replace hand-maintained tile URLs across Python, React, and HTML export with a single basemaps.yaml source, generated TS assets, and runtime export injection. Fixes #249 Co-authored-by: Cursor <cursoragent@cursor.com>

test: Assert export HTML embeds basemap manifest in config

6e3924f

Refs: #249 Co-authored-by: Cursor <cursoragent@cursor.com>

fix: Pass basemap default through HTML export config

6ec125c

Refs: #249 Co-authored-by: Cursor <cursoragent@cursor.com>

fix: Run basemap asset check in frontend build --check-only mode

3ea4520

Refs: #249 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Note map HTML export size is not a performance priority

9a09086

Refs: #249 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Add /start-issue-work Cursor command

3195388

Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Centralize basemap config in shared YAML manifest (#257)

812d2e9

Refs: #249

fix: Replace deprecated st.components.v1.html with st.iframe

e86e06b

Refs: #258 Co-authored-by: Cursor <cursoragent@cursor.com>

test: Cover export auto-click st.iframe and update export UX docs

dd8cd1c

Refs: #258 Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Remove dead export auto-click CSS and legacy test stub

b0a78e2

Refs: #258 Co-authored-by: Cursor <cursoragent@cursor.com>

fix: Replace deprecated st.components.v1.html with st.iframe (#259)

c32a0ad

Refs: #258

ui: Move Bird Families to a top-level main tab

1d8b928

Ranking & Lists keeps nested Top Lists and Interesting Lists only; species-group coverage UI and prep bundle are unchanged. Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Split Bird Families into bird_families_streamlit_html

aa0fc39

Extract species-group coverage UI and prep helpers from rankings module; add fragment tests and fix empty-taxonomy messaging when bundle exists. Co-authored-by: Cursor <cursoragent@cursor.com>

Merge pull request #260 from jimchurches/dependabot/pip/beta-next/pyt…

632ebd5

…hon-deps-c872317b72 chore(deps): bump the python-deps group with 2 updates

refactor: Rename shared ranking/families session bundle key

32cb8bc

RANKING_LISTS_FAMILIES_BUNDLE_KEY replaces RANKINGS_TAB_BUNDLE_KEY; align build_ranking_lists_families_bundle and sync_ranking_lists_families_bundle. Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches mentioned this pull request Jun 1, 2026

[Enhancement] Unify MAP_POPUP_MAX_WIDTH_PX across Python, React, and export JS #265

Closed

jimchurches and others added 4 commits June 1, 2026 12:29

refactor: Unify MAP_POPUP_MAX_WIDTH_PX via codegen from defaults.py (#…

34196af

…266) Refs: #265

jimchurches and others added 2 commits June 1, 2026 12:59

docs: Rewrite presentation CSS comments without issue refs

09affa6

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Remove issue refs from presentation module docstrings

841be4f

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Centralize main tab hover colour in defaults

9c602c0

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

refactor: Rename taxonomy coverage helper parameter

e977219

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

test: Remove unused imports flagged by ruff in tests

fecf36b

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Finish final review hygiene for theme tokens and tests

1ceea97

Refs: #264 Co-authored-by: Cursor <cursoragent@cursor.com>

jimchurches mentioned this pull request Jun 1, 2026

Release hygiene: defaults, docstrings, and build version 2026-06-01 #267

Merged

docs: Release hygiene for 2026-06-01 build (#267)

1abfbde

Refs: #264

jimchurches merged commit 131c682 into main Jun 1, 2026
14 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release 2026-06-01: Bird Families tab, species coverage, basemaps, and map fixes#264

Release 2026-06-01: Bird Families tab, species coverage, basemaps, and map fixes#264
jimchurches merged 49 commits into
mainfrom
beta-next

jimchurches commented Jun 1, 2026 •

edited

Loading

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

jimchurches commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Bird Families & species coverage

Maps & basemaps

Streamlit & export

Testing & CI

Tooling & dependencies

Testing

Notes

Issues

Uh oh!

jimchurches commented Jun 1, 2026

Hygiene branch update (release-2026-06-01-final-review)

What changed

Checks

Branch state

Uh oh!

jimchurches commented Jun 1, 2026

Docstring hygiene (release branch)

Uh oh!

jimchurches commented Jun 1, 2026

Release hygiene (branch release-2026-06-01-final-review)

Commits

Earlier on same branch

Quality

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

jimchurches commented Jun 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

jimchurches commented Jun 1, 2026 •

edited

Loading

Hygiene branch update (`release-2026-06-01-final-review`)

Release hygiene (branch `release-2026-06-01-final-review`)