A phone, and how much of this could not be used on one

The sidebar was a 280px panel laid over the page below the phone breakpoint,
opened from first paint, with the only control that closed it underneath it --
and that control existed on /chat and on none of the seven other pages carrying
a sidebar, Settings included. It starts closed at that width now, slides, dims
the page behind it, and closes by tapping beside it, by Escape, or by its own
button, which is inside the drawer where it can be reached.

Everything a finger has to hit was 36px, or 28 for renaming a chat, every action
on a message and every panel's close button. Raising --control-h under a coarse
pointer is the only fix that reaches all forty of them, which is what that token
is for. The row and message actions were also hover-only, so on a phone they did
not exist at all.

Installing: the splash and the browser chrome follow the instance's theme rather
than always being Moria's near-black; there are screenshots, so the install
offer is a dialog rather than a one-line bar; a new release no longer takes over
a page somebody is reading; the notification badge is a silhouette rather than a
grey square; and a browser rotating its own subscription no longer ends
notifications for good.

Every request now says it is happening -- nothing did before, so anything slower
than a few milliseconds looked like a click that had not registered.

A chat can be archived. The column has been filtered on in four places since
folders arrived and written by nothing, which is what made it look built.

chat.css may contain media queries. The ban protected the composer toolbar from
being "fixed" with a breakpoint; that guarantee is asserted directly now, and
the old test would have passed a version of the file that wrapped the toolbar
without one.

scripts/shoot.py is the instrument all of this was found with: it renders a page
through TestClient into a real headless browser at a real size and refuses to
run if an asset URL was left pointing at testserver.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-25 13:39:35 +00:00
co-authored by Claude Opus 5
parent 92070d7879
commit 28390095a9
44 changed files with 2290 additions and 135 deletions
+115
View File
@@ -0,0 +1,115 @@
"""The sidebar as a drawer: closed by default where it covers the page.
Below the phone breakpoint the sidebar is a fixed 280px overlay. It was
rendered with no `hidden` attribute at any width and nothing ever set one on
load, so on a 390px phone it covered the page from first paint -- with the only
control that could close it, the topbar's toggle, underneath it. And that toggle
existed on `/chat` alone: the seven other pages carrying the sidebar had no
dismiss control of any kind.
"""
from __future__ import annotations
from pathlib import Path
from fastapi.testclient import TestClient
import lembas
ROOT = Path(lembas.__file__).parent
TEMPLATES = ROOT / "web/templates"
APP_CSS = (ROOT / "web/static/css/app.css").read_text(encoding="utf-8")
APP_JS = (ROOT / "web/static/js/app.js").read_text(encoding="utf-8")
# Every page that renders the sidebar.
CARRIERS = [
"settings.html",
"chat/index.html",
"reports/_layout.html",
"messages/index.html",
"schedules/_layout.html",
"library/_layout.html",
"agents/_layout.html",
"folders/edit.html",
]
def test_every_page_with_a_sidebar_has_a_way_to_close_it():
"""`grep -rn 'data-toggle="#sidebar"'` returned exactly one hit, and the
other seven pages were unusable on a phone because of it."""
missing = [
name
for name in CARRIERS
if "partials/_sidebar_toggle.html" not in (TEMPLATES / name).read_text(encoding="utf-8")
]
assert not missing, f"no sidebar toggle on: {missing}"
def test_the_toggle_is_one_partial_and_not_eight_copies():
"""The next control added to a topbar should not have to be added eight
times, which is how the first one came to exist once."""
toggle = (TEMPLATES / "partials/_sidebar_toggle.html").read_text(encoding="utf-8")
assert 'data-toggle="#sidebar"' in toggle
assert 'aria-label="Toggle sidebar"' in toggle
def test_the_toggle_does_not_claim_to_be_open():
"""It rendered `aria-expanded="true"` from the template -- a fact nobody
checked and one that was false on every phone. `syncToggles` writes it."""
toggle = (TEMPLATES / "partials/_sidebar_toggle.html").read_text(encoding="utf-8")
# The element, not the file: the comment above it explains at length why
# the attribute is absent, and a test reading the file fails on the
# explanation for the fix.
button = toggle.split("<button", 1)[1].split(">", 1)[0]
assert "aria-expanded" not in button
assert 'syncToggles("#sidebar"' in APP_JS
def test_the_drawer_is_closed_by_default_only_where_it_is_a_drawer():
"""Three states, and the third is the one that matters: absent means
"follow the width", which is what the server renders because the server
does not know the width."""
assert 'data-sidebar="open"' in APP_CSS
assert 'data-sidebar="closed"' in APP_CSS
assert 'return !window.matchMedia(NARROW).matches;' in APP_JS
def test_the_close_button_is_reachable_inside_the_open_drawer():
"""`.sidebar__close` is `display: none` at width and turned back on inside
the media query. Both rules are one class deep, so the order decides -- and
written the other way round the button is invisible at every width,
including inside the drawer it exists for."""
base = APP_CSS.index("\n.sidebar__close {")
inside = APP_CSS.index(" .sidebar__close {")
assert base < inside, "the base rule must come first or it wins everywhere"
def test_nothing_behind_the_drawer_can_be_tabbed_into():
assert 'toggleAttribute("inert"' in APP_JS
def test_inert_is_never_left_behind_on_a_widened_window():
"""An `inert` left on a window somebody widened is a page that has stopped
responding, which is worse than the bug it is here to fix."""
assert 'matchMedia(NARROW).addEventListener("change"' in APP_JS
def test_the_drawer_is_dismissible_without_finding_a_button():
sidebar = (TEMPLATES / "partials/sidebar.html").read_text(encoding="utf-8")
assert 'class="sidebar-scrim"' in sidebar
assert 'data-toggle="#sidebar"' in sidebar
assert ".sidebar-scrim" in APP_CSS
def test_the_sidebar_does_not_go_through_setpanel():
"""The other three panels use the `hidden` attribute, which is one value
for both widths -- the thing this panel cannot use."""
assert 'if (selector === "#sidebar") return setSidebar(open);' in APP_JS
def test_the_toggle_is_a_real_target(client: TestClient, registered):
"""44px comes from `--control-h` under the coarse-pointer block, so this
only holds while `.btn--icon` keeps taking its size from that token."""
tokens = (ROOT / "web/static/css/tokens.css").read_text(encoding="utf-8")
assert "--tap-min: 2.75rem" in tokens
assert "--control-h: var(--tap-min)" in tokens