""" Mobile layout regression tests — run on every QA pass. These tests check that the CSS and HTML structure required for correct mobile rendering (375px–640px viewport widths) is intact after every change. They are static checks (no server needed) that catch common regressions: - Mobile breakpoints present for key layout elements - Right panel slide-over markup and CSS intact - Profile dropdown not clipped by overflow on mobile - Composer footer chips scroll correctly on narrow viewports - Mobile sidebar navigation stays available on phones - No full-viewport overflow that would break scroll Run as part of the standard test suite: pytest tests/test_mobile_layout.py -v """ import pathlib import re from html.parser import HTMLParser REPO = pathlib.Path(__file__).parent.parent HTML = (REPO / "static" / "index.html").read_text(encoding="utf-8") CSS = (REPO / "static" / "style.css").read_text(encoding="utf-8") def _max_width_media_blocks(width_px): """Return all @media(max-width:Npx) bodies using balanced braces.""" pattern = re.compile(rf'@media\s*\(\s*max-width\s*:\s*{width_px}px\s*\)\s*\{{') blocks = [] for match in pattern.finditer(CSS): open_brace = match.end() - 1 depth = 0 for idx in range(open_brace, len(CSS)): if CSS[idx] == "{": depth += 1 elif CSS[idx] == "}": depth -= 1 if depth == 0: blocks.append(CSS[open_brace + 1:idx]) break return blocks def _composer_phone_media_block(): for block in _max_width_media_blocks(640): if ".composer-footer" in block: return block raise AssertionError("Missing composer rules in @media(max-width:640px)") def _strip_css_comments(css): return re.sub(r'/\*.*?\*/', '', css, flags=re.DOTALL) def _rule_body(css, selector): for match in re.finditer(r'([^{}]+)\{([^{}]*)\}', _strip_css_comments(css)): selectors = {part.strip() for part in match.group(1).split(",")} if selector in selectors: return match.group(2) raise AssertionError(f"Missing CSS rule for {selector}") def _declarations(rule_body): declarations = {} for item in rule_body.split(";"): if ":" not in item: continue prop, value = item.split(":", 1) declarations[prop.strip()] = re.sub(r'\s+', ' ', value.strip()) return declarations def _optional_declarations(css, selector): try: return _declarations(_rule_body(css, selector)) except AssertionError: return {} def _display_hidden(declarations): return declarations.get("display", "").replace(" ", "") in {"none", "none!important"} def _display_inline_flex(declarations): return declarations.get("display", "").replace(" ", "") in {"inline-flex", "inline-flex!important"} class _ComposerLeftDropdownParser(HTMLParser): _VOID_TAGS = { "area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr", } def __init__(self): super().__init__() self.stack = [] self.violations = [] def handle_starttag(self, tag, attrs): self._handle_element(tag, attrs, push=True) def handle_startendtag(self, tag, attrs): self._handle_element(tag, attrs, push=False) def handle_endtag(self, tag): tag = tag.lower() for idx in range(len(self.stack) - 1, -1, -1): if self.stack[idx]["tag"] == tag: del self.stack[idx:] break def _handle_element(self, tag, attrs, push): tag = tag.lower() attrs = dict(attrs) classes = set((attrs.get("class") or "").split()) element_id = attrs.get("id") or "" inside_composer_left = any( "composer-left" in item["classes"] for item in self.stack ) is_dropdown = ( element_id.endswith("Dropdown") or any("dropdown" in class_name for class_name in classes) ) if inside_composer_left and is_dropdown: label = f"#{element_id}" if element_id else "." + ".".join(sorted(classes)) self.violations.append(label) if push and tag not in self._VOID_TAGS: self.stack.append({"tag": tag, "classes": classes}) # ── Mobile breakpoint rules ─────────────────────────────────────────────────── def test_mobile_breakpoint_900px_present(): """@media(max-width:900px) must hide the right panel and show mobile-files-btn.""" assert "@media(max-width:900px)" in CSS or "@media (max-width: 900px)" in CSS, \ "Missing @media(max-width:900px) breakpoint in style.css" # Right panel should be hidden at 900px, replaced by slide-over assert ".rightpanel{display:none" in CSS or ".rightpanel {display:none" in CSS or \ re.search(r'max-width:900px\).*?\.rightpanel\{display:none', CSS, re.DOTALL), \ ".rightpanel must be display:none at max-width:900px (slide-over replaces it)" def test_mobile_breakpoint_640px_present(): """@media(max-width:640px) must exist for narrow phone layouts.""" assert "@media(max-width:640px)" in CSS or "@media (max-width: 640px)" in CSS, \ "Missing @media(max-width:640px) breakpoint in style.css" def test_settings_system_version_controls_wrap_on_phone_widths(): """Settings -> System version badges must wrap instead of overflowing phones.""" mobile_css = "\n".join(_max_width_media_blocks(768)) assert ".settings-section-head" in mobile_css, ( "Settings section header needs a mobile rule so title and update controls stack." ) assert "flex-direction:column" in mobile_css.replace(" ", ""), ( "Settings section header should stack vertically on mobile." ) assert "#checkUpdatesBlock" in mobile_css, ( "Settings update/version controls need a mobile rule." ) assert "flex-wrap:wrap" in mobile_css.replace(" ", ""), ( "Version badges and Check now button must wrap instead of overflowing." ) assert "width:100%" in mobile_css.replace(" ", ""), ( "The update controls row should take the available mobile width." ) assert ".settings-version-badge" in mobile_css and "white-space:nowrap" in mobile_css.replace(" ", ""), ( "Individual version badges should stay intact while the group wraps." ) def test_rightpanel_mobile_slide_over_css(): """Right panel must have position:fixed slide-over CSS for mobile.""" # At max-width:900px the rightpanel should be position:fixed, off-screen right assert "position:fixed" in CSS, \ "style.css must have position:fixed for rightpanel mobile slide-over" assert ".rightpanel.mobile-open{right:0" in CSS or ".rightpanel.mobile-open {right:0" in CSS, \ ".rightpanel.mobile-open must set right:0 to slide panel in from right" assert "min(300px, 100vw)" in CSS or "min(300px,100vw)" in CSS, \ "rightpanel mobile width should be capped defensively with 100vw" assert "var(--mobile-rightpanel-width)" in CSS, \ "mobile rightpanel width variable should be used in compact mode rules" assert "calc(-1 * var(--mobile-rightpanel-width))" in CSS, \ "closed mobile rightpanel should be off-canvas using a width-based negative offset" mobile_640 = re.search(r'@media\(max-width:640px\)\{([^{}]*(?:\{[^{}]*\}[^{}]*)*)\}', CSS, re.DOTALL) assert mobile_640, "@media(max-width:640px) block missing from style.css" rightpanel_block = mobile_640.group(1) assert re.search(r'\.rightpanel\{[^}]*width:\s*var\(--mobile-rightpanel-width\)\s*!important', rightpanel_block, re.DOTALL), \ ".rightpanel width must use var(--mobile-rightpanel-width) with !important in mobile block" assert re.search(r'\.rightpanel\.mobile-open\{[^}]*right:\s*0\s*!important', rightpanel_block, re.DOTALL), \ "mobile-open mobile rightpanel must force right:0 with !important" assert re.search(r'\.rightpanel\{[^}]*box-shadow:\s*none\s*!important', rightpanel_block, re.DOTALL), \ "closed mobile rightpanel should have no shadow to avoid right-edge bleed" assert re.search(r'\.rightpanel\{[^}]*padding-top:\s*var\(--app-titlebar-safe-top\)', rightpanel_block, re.DOTALL), \ "mobile rightpanel should reserve the same PWA top inset as the titlebar" assert re.search(r'\.rightpanel\{[^}]*box-sizing:\s*border-box', rightpanel_block, re.DOTALL), \ "mobile rightpanel safe-area padding must stay inside its fixed height" assert re.search(r'\.rightpanel\.mobile-open\{[^}]*box-shadow:\s*-4px 0 24px rgba\(0,\s*0,\s*0,\s*\.?4\)', rightpanel_block, re.DOTALL), \ "open mobile rightpanel should keep the edge shadow" assert re.search(r'\.rightpanel\s+\.panel-header\{[^}]*row-gap:\s*8px', rightpanel_block), \ "mobile workspace header should keep comfortable row spacing" def test_workspace_panel_inline_width_is_desktop_only(): """Persisted rightpanel width must only be restored above compact/mobile breakpoints.""" boot_js = (REPO / "static" / "boot.js").read_text(encoding="utf-8") assert "function _syncWorkspacePanelInlineWidth()" in boot_js, \ "_syncWorkspacePanelInlineWidth() must exist to keep panel width mobile-safe" assert "_syncWorkspacePanelInlineWidth();" in boot_js, \ "_syncWorkspacePanelInlineWidth() must be called when viewport changes" assert "localStorage.getItem('hermes-panel-w')" in boot_js, \ "Panel width helper must source hermes-panel-w from localStorage" assert "_workspacePanelEls();" in boot_js and "style.removeProperty('width')" in boot_js, \ "Panel helper must clear inline width while in compact/mobile viewport" def test_workspace_panel_boot_restore_is_desktop_only(): """Persisted workspace panels should not auto-cover compact/mobile launch.""" boot_js = (REPO / "static" / "boot.js").read_text(encoding="utf-8") assert "if(_ephPanelPref&&!_isCompactWorkspaceViewport()) _workspacePanelMode='browse';" in boot_js assert "if(S.session&&S.session.workspace&&panelPref&&!_isCompactWorkspaceViewport()){" in boot_js assert "if(_freshPanelPref&&!_isCompactWorkspaceViewport()) _workspacePanelMode='browse';" in boot_js def _container_query_block(css: str, container_query: str): query_pattern = re.compile( rf'@container\s+{re.escape(container_query)}\s*\{{', re.DOTALL, ) for match in query_pattern.finditer(css): start = match.end() - 1 end = css.find("@container", start + 1) if end == -1: end = css.find("@media", start + 1) if end == -1: end = len(css) block = css[start + 1:end] return block return "" def _container_media_block(css: str, media_query: str): query_pattern = re.compile( rf'@media\s*\(\s*max-width:\s*{re.escape(media_query)}\s*\)\s*\{{', re.DOTALL, ) def _media_block_end(css_text: str, open_brace_idx: int) -> int: depth = 0 for idx in range(open_brace_idx, len(css_text)): if css_text[idx] == "{": depth += 1 elif css_text[idx] == "}": depth -= 1 if depth == 0: return idx return -1 def _strip_nested_media(block: str) -> str: parts = [] cursor = 0 while True: nested = block.find("@media", cursor) if nested == -1: parts.append(block[cursor:]) break parts.append(block[cursor:nested]) nested_open = block.find("{", nested) if nested_open == -1: break nested_close = _media_block_end(block, nested_open) if nested_close == -1: break cursor = nested_close + 1 return "".join(parts) for match in query_pattern.finditer(css): start = match.end() - 1 end = _media_block_end(css, start) if end == -1: continue block = css[start + 1:end] block = _strip_nested_media(block) if ".composer-profile-label" in block or ".composer-profile-chip" in block: return block return "" def test_composer_controls_switch_to_icon_only_by_container_width(): """Composer controls should progressively compact based on footer width.""" assert re.search(r'\.composer-footer\s*\{[^}]*container-type:inline-size[^}]*container-name:composer-footer[^}]*\}', CSS), \ ".composer-footer should define container-type:inline-size and container-name:composer-footer" compact_700 = _container_query_block(CSS, "composer-footer (max-width: 700px)") assert compact_700, "Expected composer mid-width compact rules at @container composer-footer (max-width: 700px)" for selector in ( ".composer-workspace-label", ".composer-model-label", ".composer-model-chevron", "#composerWorkspaceLabel", "#composerModelLabel", ".composer-workspace-chip", ".composer-model-chip", ".composer-divider", ): assert selector in compact_700, f"{selector} should be present in the 700px composer compact block" assert "display:none" in compact_700 assert "max-width:52px" in compact_700 # Ensure this first stage does not prematurely remove profile/reasoning labels. assert ".composer-profile-label" not in compact_700 assert ".composer-reasoning-label" not in compact_700 assert ".composer-profile-chevron" not in compact_700 assert ".composer-reasoning-chevron" not in compact_700 compact_520 = _container_query_block(CSS, "composer-footer (max-width: 520px)") assert compact_520, "Expected full composer icon-only rules at @container composer-footer (max-width: 520px)" for selector in ( ".composer-profile-label", ".composer-workspace-label", ".composer-model-label", ".composer-reasoning-label", ".composer-profile-chevron", ".composer-workspace-chevron", ".composer-model-chevron", ".composer-reasoning-chevron", "#composerProfileLabel", "#composerWorkspaceLabel", "#composerModelLabel", "#composerReasoningLabel", ".composer-model-chip", ".composer-profile-chip", ".composer-reasoning-chip", ): assert selector in compact_520, f"{selector} should be present in the 520px composer compact block" assert "width:44px" in compact_520 assert "display:none" in compact_520 assert ".composer-workspace-chip{display:none!important" in compact_520.replace(" ", ""), \ "520px container compact mode must remove the blank workspace switch slot" assert ".composer-left>*{flex-shrink:0" in compact_520.replace(" ", ""), \ "520px container compact mode must stop controls from shrinking into each other" assert ".composer-mobile-config-btn" in compact_520 and "display:inline-flex!important" in compact_520, \ "520px container compact mode must expose the mobile config button even when viewport is wider than 640px" # Regression intent: # - this container rule should not depend on right-panel open/closed state. # - left-sidebar-only constriction must still collapse composer controls together. assert ".layout:not(.workspace-panel-collapsed)" not in compact_700, \ "composer-footer compact rule should be state-agnostic (left sidebar + closed right panel case included)" assert ".layout:not(.workspace-panel-collapsed)" not in compact_520, \ "composer-footer compact rule should be state-agnostic (left sidebar + closed right panel case included)" def test_composer_700px_workspace_switch_does_not_become_blank_chip(): """The 700px container state may hide the workspace label, but needs a switch affordance.""" compact_700 = _container_query_block(CSS, "composer-footer (max-width: 700px)") assert compact_700, "Expected composer mid-width compact rules at @container composer-footer (max-width: 700px)" workspace_label = _declarations(_rule_body(compact_700, ".composer-workspace-label")) workspace_chip = _optional_declarations(compact_700, ".composer-workspace-chip") workspace_chevron = _optional_declarations(compact_700, ".composer-workspace-chevron") mobile_config = _optional_declarations(compact_700, ".composer-mobile-config-btn") assert _display_hidden(workspace_label), \ "700px container state should hide the long workspace label before tighter mobile rules" if not _display_hidden(workspace_chip) and not _display_inline_flex(mobile_config): assert not _display_hidden(workspace_chevron), \ "700px container state must not leave the visible workspace switch chip without a label or chevron" def test_composer_compact_switch_is_not_viewport_only(): """Compact controls should be container-triggered, not bound to viewport width alone.""" assert "composer-footer (max-width: 700px)" in CSS, \ "Container-query breakpoint should track composer footer width" assert "composer-footer (max-width: 520px)" in CSS, \ "Container-query second-stage breakpoint should track composer footer width" assert re.search(r'@container\s+composer-footer\s*\(max-width:\s*860px\)', CSS) is None, \ "Full icon-only should not be tied to a 860px threshold any more" assert re.search(r'@container\s+composer-footer\s*\(max-width:\s*1000px\)', CSS) is None, \ "Full icon-only/first-stage container gate should not be tied to 1000px" media_860 = _container_media_block(CSS, "860px") assert media_860 == "", \ "Composer compact breakpoint should not be a dedicated 860px viewport media query" media_900 = _container_media_block(CSS, "900px") assert media_900 == "", \ "Composer compact breakpoint should use container queries, not viewport media at 900px" def test_mobile_overlay_present(): """Mobile overlay element must exist for tap-to-close sidebar behavior.""" assert 'id="mobileOverlay"' in HTML, \ "#mobileOverlay element missing from index.html" assert "mobile-overlay" in CSS, \ ".mobile-overlay CSS rule missing from style.css" def test_sidebar_nav_present(): """Sidebar top navigation tabs must be present.""" assert 'class="sidebar-nav"' in HTML, \ ".sidebar-nav missing from index.html" assert ".sidebar-nav{" in CSS or ".sidebar-nav {" in CSS, \ ".sidebar-nav CSS rule missing from style.css" def test_mobile_keeps_panel_navigation_available(): """Phone breakpoint must keep panel navigation available inside the drawer.""" mobile_css = "\n".join(_max_width_media_blocks(640)) assert mobile_css, "Missing @media(max-width:640px) block in style.css" assert ".sidebar-nav" in mobile_css, \ "Phone panel navigation must remain available in the hamburger drawer" def test_mobile_keeps_hamburger_drawer_with_vertical_44px_panel_targets(): """Phone panel navigation should be vertical inside the hamburger drawer. Phones need to preserve horizontal space for the conversation. The titlebar hamburger opens the session/sidebar drawer; inside that drawer, panel icons should use a vertical strip with 44px targets instead of a cramped top row. """ mobile_css = "\n".join(_max_width_media_blocks(640)) assert re.search(r'\.app-titlebar-hamburger,\s*\.app-titlebar-spacer\{[^}]*display:\s*flex', mobile_css), ( "Phone titlebar hamburger must stay visible" ) assert not re.search(r'\.rail\{[^}]*display:\s*flex[^}]*position:\s*fixed', mobile_css), ( "Phone must not use a persistent left rail that consumes chat width" ) assert not re.search(r'\.sidebar\s*>\s*\.sidebar-nav\{[^}]*display:\s*none', mobile_css), ( "Phone hamburger drawer must keep the sidebar panel tabs visible" ) assert re.search(r'\.sidebar-nav\{[^}]*position:\s*absolute', mobile_css), ( "Phone drawer panel tabs should be laid out as an internal side strip" ) assert re.search(r'\.sidebar-nav\{[^}]*width:\s*52px', mobile_css), ( "Phone drawer panel strip should reserve stable space for 44px targets" ) assert re.search(r'\.sidebar-nav\{[^}]*flex-direction:\s*column', mobile_css), ( "Phone drawer panel tabs must be vertical, not horizontal" ) assert re.search(r'\.sidebar-nav\s+\.nav-tab\{[^}]*min-width:\s*44px', mobile_css), ( "Phone drawer panel tabs must be at least 44px wide" ) assert re.search(r'\.sidebar-nav\s+\.nav-tab\{[^}]*min-height:\s*44px', mobile_css), ( "Phone drawer panel tabs must be at least 44px tall" ) assert re.search(r'\.sidebar\s+\.panel-view\{[^}]*margin-left:\s*52px', mobile_css), ( "Phone drawer panel content should start beside the vertical icon strip" ) assert re.search(r'\.sidebar\s+\.panel-icon-btn\{[^}]*min-width:\s*44px', mobile_css), ( "Sidebar panel buttons must min-width:44px on phone" ) assert re.search(r'\.sidebar\s+\.panel-icon-btn\{[^}]*min-height:\s*44px', mobile_css), ( "Sidebar panel buttons must min-height:44px on phone" ) assert re.search(r'\.sidebar\s+\.panel-icon-btn\{[^}]*width:\s*auto', mobile_css), ( "Sidebar panel buttons must override their base 24px width on phone" ) assert re.search(r'\.sidebar\s+\.panel-icon-btn\{[^}]*height:\s*auto', mobile_css), ( "Sidebar panel buttons must override their base 24px height on phone" ) assert not re.search(r'(?= 100, \ f".profile-dropdown z-index {m.group(1)} is too low — must be >= 100 to clear topbar" def test_composer_dropdowns_are_not_nested_inside_left_control_row(): """Composer dropdown surfaces should remain outside .composer-left. The left row can wrap/scroll on phones; dropdowns need to be siblings so that overflow rules on the control row cannot clip them. """ parser = _ComposerLeftDropdownParser() parser.feed(HTML) assert not parser.violations, ( "Composer dropdowns must not be nested inside .composer-left: " + ", ".join(parser.violations) ) def test_topbar_chips_mobile_overflow(): """topbar-chips must use overflow-x:auto on mobile for chip scrolling. Chips (profile, workspace, model, files) must scroll horizontally on narrow viewports rather than wrapping onto a second line which would break the topbar layout. """ # At narrow viewport, topbar-chips should scroll assert "overflow-x:auto" in CSS or "overflow-x: auto" in CSS, \ "topbar-chips must have overflow-x:auto for mobile chip scrolling" # ── Workspace panel close ───────────────────────────────────────────────────── def test_workspace_close_button_present(): """Workspace panel must have a close/hide button accessible on mobile.""" # Accept handleWorkspaceClose() (two-step close: file→browse→closed), or the # lower-level functions directly. handleWorkspaceClose is preferred because # it dismisses a file preview first before closing the panel. has_close = ( 'onclick="handleWorkspaceClose()"' in HTML or 'onclick="closeWorkspacePanel()"' in HTML or 'onclick="toggleWorkspacePanel()"' in HTML ) assert has_close, \ "handleWorkspaceClose() or closeWorkspacePanel() must be wired to a button to close the workspace panel on mobile" def test_toggle_mobile_files_js_defined(): """toggleMobileFiles() must be defined in boot.js.""" boot_js = (REPO / "static" / "boot.js").read_text(encoding="utf-8") assert "function toggleMobileFiles()" in boot_js, \ "toggleMobileFiles() missing from static/boot.js" assert "mobile-open" in boot_js, \ "toggleMobileFiles() must toggle mobile-open class on the right panel" assert "function closeMobileWorkspacePanelFromChat(e)" in boot_js assert "$('mainChat')?.addEventListener('pointerdown', closeMobileWorkspacePanelFromChat);" in boot_js def test_new_conversation_closes_mobile_sidebar(): """New conversation must close the mobile drawer so the chat pane is visible immediately.""" boot_js = (REPO / "static" / "boot.js").read_text(encoding="utf-8") # Handler is now multi-line — search for the full block rather than a single line. assert "$('btnNewChat').onclick" in boot_js, "btnNewChat onclick handler missing from static/boot.js" # Find the handler block and verify closeMobileSidebar appears in it. # The handler grew comments after #1432 (in-flight guard refactor), so use a # generous window to cover the full handler body. idx = boot_js.find("$('btnNewChat').onclick") handler_block = boot_js[idx:idx+1500] assert "closeMobileSidebar" in handler_block, \ "btnNewChat handler must closeMobileSidebar() after creating the new session" shortcut_line = next((ln for ln in boot_js.splitlines() if "e.key==='k'" in ln or "e.key === 'k'" in ln), "") assert shortcut_line, "Cmd/Ctrl+K new chat shortcut missing from static/boot.js" shortcut_block = "\n".join(boot_js.splitlines()[boot_js.splitlines().index(shortcut_line):boot_js.splitlines().index(shortcut_line)+24]) assert "closeMobileSidebar" in shortcut_block, \ "Cmd/Ctrl+K new chat shortcut must closeMobileSidebar() after creating the new session" def test_new_conversation_shortcut_works_while_busy(): """Cmd/Ctrl+K should still create a new conversation while the current one is busy. The previous behavior gated the shortcut on !S.busy, which meant users had to wait for a long generation to finish before they could start something new — the exact moment they want to switch context. """ boot_js = (REPO / "static" / "boot.js").read_text(encoding="utf-8") shortcut_line = next((ln for ln in boot_js.splitlines() if "e.key==='k'" in ln or "e.key === 'k'" in ln), "") assert shortcut_line, "Cmd/Ctrl+K new chat shortcut missing from static/boot.js" # Inspect the next 10 lines after the keybinding match — the gating block # would live there if it had been kept. idx = boot_js.splitlines().index(shortcut_line) shortcut_block = "\n".join(boot_js.splitlines()[idx:idx + 10]) # Strip the existing message-count guard (which is unrelated and stays) so # we only check for an S.busy gate on the newSession() call itself. assert "if(!S.busy)" not in shortcut_block, ( "Cmd/Ctrl+K must not be blocked by the current session's busy state" ) assert "if (!S.busy)" not in shortcut_block, ( "Cmd/Ctrl+K must not be blocked by the current session's busy state" ) # ── Viewport and scroll safety ──────────────────────────────────────────────── def test_body_overflow_hidden(): """body must have overflow:hidden to prevent double scrollbars on mobile.""" assert "body{" in CSS or "body {" in CSS, \ "body rule missing from style.css" assert re.search(r'body\{[^}]*overflow:hidden', CSS), \ "body must have overflow:hidden to prevent double scrollbars" def test_flex_parents_allow_message_scroller_to_shrink(): """The top-level flex containers must opt into min-height:0 so .messages can scroll on mobile. Mobile Safari/Chrome can trap scroll when a flex child with overflow:auto sits inside parents whose min-height remains auto. Both .layout and .main need min-height:0. """ assert re.search(r'\.layout\{[^}]*min-height:0', CSS), \ ".layout must set min-height:0 so the chat column can shrink and scroll" assert re.search(r'\.main\{[^}]*min-height:0', CSS), \ ".main must set min-height:0 so .messages remains scrollable while busy" def test_messages_touch_scrolling_hints_present(): """The messages scroller must advertise touch-friendly scrolling behavior. On mobile browsers, momentum scrolling and explicit pan-y/overscroll behavior help prevent the chat area from feeling locked while the app body itself stays overflow:hidden. """ assert re.search(r'\.messages\{[^}]*-webkit-overflow-scrolling:\s*touch', CSS), \ ".messages must enable -webkit-overflow-scrolling:touch for mobile momentum scroll" assert re.search(r'\.messages\{[^}]*touch-action:\s*pan-y', CSS), \ ".messages must set touch-action:pan-y so vertical swipe gestures scroll the transcript" assert re.search(r'\.messages\{[^}]*overscroll-behavior-y:\s*contain', CSS), \ ".messages must contain vertical overscroll so the transcript keeps the gesture" def test_100dvh_viewport_height(): """Layout must use 100dvh (dynamic viewport height) for correct mobile sizing. On mobile Safari and Chrome, 100vh includes the browser chrome (address bar), causing content to be hidden. 100dvh accounts for the actual available height. """ assert "100dvh" in CSS, \ "style.css must use 100dvh for correct mobile viewport height (100vh hides content under address bar)" def test_pwa_safe_area_top_stays_scoped_to_installed_modes(): """The PWA shell should not opt into cover-mode geometry for every browser surface.""" assert 'viewport-fit=cover' not in HTML assert 'apple-mobile-web-app-status-bar-style" content="black-translucent"' in HTML assert "@media (display-mode: standalone), (display-mode: fullscreen)" in CSS assert "--app-titlebar-safe-top:env(safe-area-inset-top" in CSS assert "--app-safe-bottom:" not in CSS def test_titlebar_safe_area_top_uses_scoped_variable(): """The titlebar must use the safe-area variable instead of direct env().""" m = re.search(r'\.app-titlebar\{(?P
[^}]*)\}', CSS) assert m, ".app-titlebar rule missing from style.css" rule = m.group("body") assert "padding-top:var(--app-titlebar-safe-top)" in rule, ( ".app-titlebar must use the scoped safe-area variable for top padding" ) assert "padding-top:env(safe-area-inset-top" not in rule, ( ".app-titlebar must not apply env(safe-area-inset-top) directly in " "the base browser/webview layout" ) def test_safe_area_variables_available_for_pwa_shell(): """Top safe-area variable should be available to installed PWA shell CSS.""" assert "--app-titlebar-safe-top:0px" in CSS, ( "titlebar top safe-area variable must default to 0px" ) assert "--app-titlebar-safe-top:env(safe-area-inset-top" in CSS, ( "CSS must expose env(safe-area-inset-top) through --app-titlebar-safe-top" ) assert "padding:8px 10px 12px!important" in CSS, ( "Phone composer should keep the proven pre-cover-mode padding contract" ) def test_composer_touch_target_size(): """Send button and composer inputs must have minimum 44px touch targets on mobile. Apple HIG and Google Material guidelines both require 44px minimum touch targets. """ # Check that mobile CSS doesn't make the send button smaller than 44×44 # We check that there's at least a min-height definition for touch targets assert re.search(r'(min-height|height).*44px', CSS), \ "style.css must define 44px minimum touch targets for mobile (send button, nav buttons)" def test_mobile_composer_footer_stays_single_row(): """Phone composer controls should stay in one footer row.""" mobile_css = _composer_phone_media_block() footer = _declarations(_rule_body(mobile_css, ".composer-footer")) assert footer.get("flex-wrap") == "nowrap", \ "mobile composer footer must stay visually single-row" left = _declarations(_rule_body(mobile_css, ".composer-left")) assert left.get("flex") != "1 1 100%", \ "mobile composer-left controls must not take their own full-width row" assert left.get("width") != "100%", \ "mobile composer-left controls must not span a separate row" assert left.get("flex-wrap") == "nowrap", \ "mobile composer-left controls must remain in one row" right = _declarations(_rule_body(mobile_css, ".composer-right")) assert right.get("flex") != "1 1 100%", \ "mobile composer-right actions must not take their own full-width row" assert right.get("width") != "100%", \ "mobile composer-right actions must not span a separate row" assert right.get("justify-content") == "flex-end", \ "mobile composer-right actions must stay end-aligned" def test_mobile_composer_left_scrolls_horizontally_without_wrapping(): """If many primary controls are visible, the single control row should scroll.""" left = _declarations(_rule_body(_composer_phone_media_block(), ".composer-left")) assert left.get("overflow-x") == "auto", \ "mobile composer-left must allow horizontal overflow in the single row" assert left.get("overflow-y") == "hidden", \ "mobile composer-left must not create a second vertical control row" assert left.get("max-height") == "none", \ "mobile composer-left must not preserve the old bounded two-row height" def test_mobile_composer_left_children_do_not_shrink_into_each_other(): """Phone composer controls must scroll or compact, never shrink/overlap siblings.""" mobile_css = _composer_phone_media_block() left = _declarations(_rule_body(mobile_css, ".composer-left")) assert left.get("gap") == "10px", \ "mobile composer-left needs explicit spacing between 44px touch targets" children = _declarations(_rule_body(mobile_css, ".composer-left > *")) assert children.get("flex-shrink") == "0", \ "mobile composer-left children must not shrink and visually overlap" for selector in ( ".composer-profile-wrap", ".composer-ws-wrap", ): declarations = _declarations(_rule_body(mobile_css, selector)) assert declarations.get("flex") == "0 0 auto", \ f"{selector} must opt out of flex shrinking on phones" workspace_group = _declarations(_rule_body(mobile_css, ".composer-workspace-group")) assert workspace_group.get("flex") == "0 0 44px", \ ".composer-workspace-group must reserve exactly one 44px slot on phones" def test_legacy_320px_composer_tightens_spacing_without_shrinking_targets(): """At 320px, keep 44px controls but use smaller gutters so config stays visible.""" narrow_blocks = [block for block in _max_width_media_blocks(340) if ".composer-left" in block] assert narrow_blocks, "Missing 320px/legacy-phone composer spacing override" narrow_css = narrow_blocks[0] footer = _declarations(_rule_body(narrow_css, ".composer-footer")) left = _declarations(_rule_body(narrow_css, ".composer-left")) wrap = _declarations(_rule_body(narrow_css, ".composer-wrap")) assert footer.get("gap") == "4px", \ "320px footer should tighten only the gutter between left controls and send" assert left.get("gap") == "2px", \ "320px left controls need compact gutters to fit config before the fixed send button" assert wrap.get("padding-left") == "8px!important", \ "320px composer should reclaim a little side padding without shrinking touch targets" assert ".send-btn{width:44px;height:44px;" in _composer_phone_media_block(), \ "narrow spacing override must not shrink the 44px send button" assert ".composer-mobile-config-btn{box-sizing:border-box;position:relative;display:inline-flex!important;width:44px;height:44px" in _composer_phone_media_block(), \ "narrow spacing override must not shrink the 44px mobile config button" def test_mobile_composer_workspace_switch_does_not_leave_empty_icon_slot(): """The phone footer should keep only the useful workspace files button inline.""" mobile_css = _composer_phone_media_block() workspace_group = _declarations(_rule_body(mobile_css, ".composer-workspace-group")) workspace_files = _declarations(_rule_body(mobile_css, ".composer-workspace-files-btn")) workspace_chip = _declarations(_rule_body(mobile_css, ".composer-workspace-chip")) assert workspace_group.get("max-width") == "44px", \ "workspace group should collapse to one 44px files button on phones" assert workspace_group.get("width") == "44px", \ "workspace group should have an exact border-box phone width" assert workspace_group.get("box-sizing") == "border-box", \ "workspace group must use border-box for its 44px phone slot" assert workspace_group.get("border") == "none", \ "workspace files shortcut should not keep the desktop pill/circle border on phones" assert workspace_group.get("background") == "transparent", \ "workspace files shortcut should visually match other transparent mobile icon buttons" assert workspace_files.get("max-width") == "44px", \ "workspace files button should be the only visible workspace footer target on phones" assert workspace_files.get("width") == "44px", \ "workspace files button should have an exact border-box phone width" assert workspace_files.get("box-sizing") == "border-box", \ "workspace files button must not grow beyond its 44px phone slot due to padding" assert workspace_chip.get("display") == "none!important", \ "workspace switch chip has no visible mobile label/icon and must not consume a blank slot" def test_mobile_composer_overflow_control_present(): """Phone composer must expose a compact overflow/settings control.""" assert 'id="composerMobileConfigBtn"' in HTML, \ "#composerMobileConfigBtn missing from index.html" assert 'id="composerMobileConfigPanel"' in HTML, \ "#composerMobileConfigPanel missing from index.html" assert 'aria-controls="composerMobileConfigPanel"' in HTML, \ "mobile config button must be associated with its panel" left_start = HTML.index('