ducoterra
b0c7aed613
All verification complete. Final report:
**Phase 165 — Prose word wrap (final verification pass)**
- Verified: `PROSE_FORMATS={txt,text}` + `isProseDoc` (single-site, image arm wins); `renderDocument` three-way branch (md → `.doc-md`, prose → `.doc-prose` text node, else `pre.doc-raw` byte-identical); `.doc-prose` CSS = 72rem column, `pre-wrap` + `overflow-wrap: anywhere`, tokens only, zero literals; `[data-view="pages"]` hide list includes `.doc-prose` as one grouped declaration; phase-116 scrollbar rules intact and modal-scoped; no `innerHTML` in the prose path.
- Tests/lint (all 100% green):
- `uv run pytest` → **3854 passed** (unit + integration)
- `uv run pytest --cov=app --cov-report=term-missing` → **TOTAL 99%** (>90%)
- `uv run ruff check .` → All checks passed; `uv run pyright` → **0 errors**
- `uv run pytest tests/e2e/test_prose_word_wrap.py -v --no-cov` → **5 passed** (isolation)
- Isolation regressions: document_viewer 8, image_documents 4, pdf_pages_in_sources 4, pdf_strip_additive_selfheal 5, edit_summaries 4, summary_in_viewer 4, chat_answer_clusters 4, garbage_pdf 3, pdf_support 6, sticky_navbar 3, smoke 3 — all passed
- Completion criteria: image description wraps, full text, both surfaces ✔; `.txt` wraps same way ✔; `py`/`json`/code keep `pre.doc-raw` + horizontal overflow + themed modal scrollbar (E2E negative control + pins) ✔; no innerHTML, AA `--ink`/`--surface` pair ✔; full gates green ✔; commit + phase-dir move are harness-owned (not executed per pipeline rules).
- Documentation: README already updated by task 03 (viewer section + image-docs section); full README/AGENTS.md review found no further inconsistencies — **verified consistent, no changes needed**.
- Notable deviations: `.doc-prose` omits `font-family: inherit` from 00_phase D2's snippet — task 01's authoritative "exact property set" excludes it and `div` inherits fonts anyway (behavior identical). PDF deferral (A4) intact: `format == "pdf"` stays in `.doc-raw`, owner call recorded.
- Next pending phase: `166_hide_empty_answer_bubble`.
240 lines
9.8 KiB
Python
240 lines
9.8 KiB
Python
"""Unit: every page matches the RAG page's 72rem width (phase 100).
|
|
|
|
The measured-width browser proof is E2E-gated by the phase's width
|
|
suite (task 03); like the other frontend-adjacent unit files (the
|
|
test_save_chat_ui.py pattern), this module pins the styles.css markers
|
|
the width contract depends on, so a silent regression is caught
|
|
without a browser:
|
|
|
|
* the ``--chat-column`` custom property in ``:root`` — 72rem, EQUAL to
|
|
the ``.container``'s 72rem cap (owner instruction 2026-09-12:
|
|
"match the width of the RAG page for all other pages" — supersedes
|
|
the 2026-08-31 instruction), with the provenance comment;
|
|
* NO ``@media (min-width: 1500px)`` block anywhere in the file — the
|
|
phase-58 wide-desktop doubling is deleted in full (the token is
|
|
72rem at every viewport);
|
|
* the reading-column selectors — ``.chat-shell``,
|
|
``.shared-shell``, ``.doc-md``, ``.doc-image`` (phase 122, task 04),
|
|
``.doc-pages`` (phase 148, task 03 — the page strip),
|
|
``.doc-view-toggle`` (phase 163, task 04 — the Text/Pages toggle
|
|
above the additive views), ``.doc-prose`` (phase 165, task 01 — the
|
|
wrapping prose block: image descriptions and txt/text docs ride the
|
|
SAME reading column as their .doc-md sibling), and
|
|
``.doc-summary:has(+ .doc-md)`` — each capped with
|
|
``max-width: var(--chat-column)`` and NOTHING else
|
|
in the file uses the token for a max-width (exactly eight rules);
|
|
* the flipped negative pin — ZERO literal ``max-width: 46rem`` rules
|
|
remain (the phase-27/59/91 form-column caps are retired): the form
|
|
shells (``.tuning-shell``, ``.theme-shell``, ``.doc-edit-shell``)
|
|
carry no cap, no token, and no ``margin-inline`` — structurally
|
|
``.sources-shell``;
|
|
* the two source-page dialogs (phase 69 remove-confirm, phase 89
|
|
ignore-editor) cap at the chat-column width THROUGH THE TOKEN —
|
|
``min(var(--chat-column), calc(100vw - 2rem))`` — or the viewport;
|
|
* the stale width comments are gone — no "46rem base" / "92rem at
|
|
>=1500px" / "1500px" width claims remain (the "46rem column
|
|
contract" wording was rewritten to the 72rem contract, 2026-09-12).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from pathlib import Path
|
|
|
|
FRONTEND = Path(__file__).resolve().parents[2] / "frontend"
|
|
STYLES_CSS = FRONTEND / "assets" / "styles.css"
|
|
|
|
|
|
def _css() -> str:
|
|
return STYLES_CSS.read_text(encoding="utf-8")
|
|
|
|
|
|
def _rule_block(css: str, selector: str) -> str:
|
|
"""The declaration block of a top-level (or nested) rule: the
|
|
``{…}`` following ``selector`` via balanced-brace counting."""
|
|
m = re.search(rf"^{re.escape(selector)} \{{", css, re.MULTILINE)
|
|
assert m, f"styles.css must define a rule for {selector}"
|
|
start = css.index("{", m.start())
|
|
depth = 0
|
|
for i in range(start, len(css)):
|
|
if css[i] == "{":
|
|
depth += 1
|
|
elif css[i] == "}":
|
|
depth -= 1
|
|
if depth == 0:
|
|
return css[start : i + 1]
|
|
raise AssertionError(f"unbalanced braces in the {selector} rule")
|
|
|
|
|
|
# ---------- the --chat-column token ----------
|
|
|
|
|
|
def test_root_declares_chat_column_72rem_equal_to_the_container() -> None:
|
|
""":root declares --chat-column: 72rem — EQUAL to the .container's
|
|
72rem cap (one width for everything) — with the owner-provenance
|
|
comment (instruction 2026-09-12)."""
|
|
css = _css()
|
|
root = _rule_block(css, ":root")
|
|
assert "--chat-column: 72rem" in root, (
|
|
":root must declare the --chat-column width (72rem)"
|
|
)
|
|
# The token equals the container's cap (the RAG page's width).
|
|
container = _rule_block(css, ".container")
|
|
assert "max-width: 72rem" in container, (
|
|
".container's 72rem cap is the width the token now equals"
|
|
)
|
|
pre = css[: css.index("--chat-column: 72rem")]
|
|
comment = pre[pre.rindex("/*") : pre.rindex("*/")]
|
|
assert "owner instruction 2026-09-12" in comment, (
|
|
"the token's comment must cite the owner instruction "
|
|
"(2026-09-12 — match the width of the RAG page)"
|
|
)
|
|
|
|
|
|
def test_the_wide_desktop_doubling_is_retired() -> None:
|
|
"""No @media (min-width: 1500px) block remains (the phase-58 2x
|
|
override is deleted in full, 2026-09-12) and the token is never
|
|
assigned the old wide value — 72rem at every viewport."""
|
|
css = _css()
|
|
assert "@media (min-width: 1500px)" not in css, (
|
|
"the wide-desktop media block must be deleted (retired 2026-09-12)"
|
|
)
|
|
assert "--chat-column: 92rem" not in css, (
|
|
"the token is never doubled to the old wide value"
|
|
)
|
|
|
|
|
|
def test_no_literal_46rem_width_remains() -> None:
|
|
"""Flipped negative pin (phase 100 D1): ZERO literal
|
|
max-width: 46rem rules remain in the file — the phase-27/59/91
|
|
form-column caps are retired, and the dialog panels ride the
|
|
token, not a 46rem literal."""
|
|
css = _css()
|
|
assert css.count("max-width: 46rem") == 0, (
|
|
"no literal max-width: 46rem rule may remain (retired 2026-09-12)"
|
|
)
|
|
assert "min(46rem" not in css, (
|
|
"the dialog panels must ride the token, not a 46rem literal"
|
|
)
|
|
|
|
|
|
# ---------- the four reading-column selectors ----------
|
|
|
|
|
|
def test_the_reading_columns_use_the_token() -> None:
|
|
""".chat-shell, .shared-shell, .doc-md, .doc-image (phase 122,
|
|
task 04 — the viewer's image block rides the SAME reading column
|
|
as its .doc-md sibling), .doc-pages (phase 148, task 03 — the
|
|
viewer's page strip rides the SAME reading column in the shared
|
|
#doc-content slot), .doc-view-toggle (phase 163, task 04 — the
|
|
Text/Pages toggle sits above the additive views, aligned with
|
|
them), .doc-prose (phase 165, task 01 — the wrapping prose block
|
|
is .doc-md's column with prose rhythm) and
|
|
.doc-summary:has(+ .doc-md) each cap with
|
|
max-width: var(--chat-column) — and exactly those eight rules use
|
|
the token for a max-width (no other selector)."""
|
|
css = _css()
|
|
for selector in (
|
|
".chat-shell",
|
|
".shared-shell",
|
|
".doc-md",
|
|
".doc-image",
|
|
".doc-pages",
|
|
".doc-view-toggle",
|
|
".doc-prose",
|
|
".doc-summary:has(+ .doc-md)",
|
|
):
|
|
assert "max-width: var(--chat-column)" in _rule_block(css, selector), (
|
|
f"{selector} must cap with max-width: var(--chat-column)"
|
|
)
|
|
assert css.count("max-width: var(--chat-column)") == 8, (
|
|
"exactly the reading-column selectors use the token"
|
|
)
|
|
|
|
|
|
def test_doc_md_keeps_width_100_under_the_cap() -> None:
|
|
""".doc-md stays width:100% under the token cap (the modal's
|
|
1100px panel remains its effective ceiling there — phase 100 D2)."""
|
|
assert "width: 100%" in _rule_block(_css(), ".doc-md")
|
|
|
|
|
|
# ---------- the form shells + the dialog panels ----------
|
|
|
|
|
|
def test_the_form_shells_ride_the_full_container() -> None:
|
|
"""The form shells (.tuning-shell — phase 27, .theme-shell —
|
|
phase 91, .doc-edit-shell — phase 59) carry NO cap, NO token, and
|
|
NO margin-inline: the .container ancestor centers them, so they
|
|
ride the 72rem frame like .sources-shell (flex column,
|
|
gap 1.25rem, flex: 1 — the owner instruction 2026-09-12 retires
|
|
the form-column caps)."""
|
|
css = _css()
|
|
for selector in (".tuning-shell", ".theme-shell", ".doc-edit-shell"):
|
|
block = _rule_block(css, selector)
|
|
assert "max-width" not in block, (
|
|
f"{selector} must carry no cap (retired 2026-09-12)"
|
|
)
|
|
assert "var(--chat-column)" not in block, (
|
|
f"{selector} rides the .container frame, not the token"
|
|
)
|
|
assert "margin-inline" not in block, (
|
|
f"{selector} is centered by the .container ancestor"
|
|
)
|
|
for decl in (
|
|
"display: flex",
|
|
"flex-direction: column",
|
|
"gap: 1.25rem",
|
|
"flex: 1",
|
|
):
|
|
assert decl in block, (
|
|
f"{selector} keeps the .sources-shell shape ({decl})"
|
|
)
|
|
|
|
|
|
def test_the_dialog_panels_ride_the_token() -> None:
|
|
"""The two source-page dialogs (phase 69 remove-confirm, phase 89
|
|
ignore-editor) cap at the chat-column width THROUGH THE TOKEN —
|
|
min(var(--chat-column), calc(100vw - 2rem)) — or the viewport,
|
|
whichever is narrower (the 46rem literals ride no more)."""
|
|
css = _css()
|
|
for selector in (".remove-confirm-panel", ".ignore-editor-panel"):
|
|
block = _rule_block(css, selector)
|
|
assert "min(var(--chat-column), calc(100vw - 2rem))" in block, (
|
|
f"{selector} must ride the token (the chat-column width "
|
|
"or the viewport)"
|
|
)
|
|
|
|
|
|
# ---------- the comment contract ----------
|
|
|
|
|
|
def test_comments_carry_the_72rem_contract() -> None:
|
|
"""The stale width claims are gone from the file: no "≤46rem",
|
|
"46rem base", "92rem at >=1500px" or "1500px" wording (the
|
|
2026-08-31 contract was rewritten to the 72rem contract), with the
|
|
owner instruction (2026-09-12) as the provenance at the token and
|
|
the reading-column comments naming 72rem."""
|
|
css = _css()
|
|
assert "≤46rem" not in css, (
|
|
"the stale '≤46rem' contract wording must be updated"
|
|
)
|
|
assert "46rem base" not in css, "no stale '46rem base' claim may remain"
|
|
assert "92rem at >=1500px" not in css, (
|
|
"no stale wide-override claim may remain"
|
|
)
|
|
assert "1500px" not in css, (
|
|
"the wide-desktop breakpoint wording is retired (2026-09-12)"
|
|
)
|
|
# Provenance at the authoritative spot (the token).
|
|
token_idx = css.index("--chat-column: 72rem")
|
|
assert "owner instruction 2026-09-12" in css[max(0, token_idx - 400) : token_idx]
|
|
# The chat-shell + shared-shell comments name the 72rem contract.
|
|
chat_comment = css[: css.index(".chat-shell {")]
|
|
assert "72rem" in chat_comment, (
|
|
"the chat-shell comment must name the 72rem contract"
|
|
)
|
|
shared_idx = css.index(".shared-shell {")
|
|
shared_rule = css[shared_idx : shared_idx + 400]
|
|
assert "72rem" in shared_rule, (
|
|
"the shared-shell comment must name the 72rem contract"
|
|
)
|