Skip to content

The design language that makes your AI harness better at design.

JavaScript
5.0 KB
Raw Blame
//! `wide-tracking` in the static engine: short capital labels are the
//! standard treatment for wide tracking, running text is not.

use impeccable_html::{detect_html_source, DetectHtmlOptions};
use std::path::Path;

fn tracking_hits(body: &str) -> usize {
    let html = format!(
        "<!DOCTYPE html>\n<html><head><style>\n\
         .run {{ font-size: 16px; line-height: 26px; width: 520px; }}\n\
         </style></head><body>{body}</body></html>\n"
    );
    detect_html_source(&html, Path::new("/tmp/wide-tracking.html"), &DetectHtmlOptions::default())
        .iter()
        .filter(|f| f.antipattern == "wide-tracking")
        .count()
}

fn repo_root() -> std::path::PathBuf {
    std::env::var("IMPECCABLE_PUBLIC_REPO")
        .map(std::path::PathBuf::from)
        .unwrap_or_else(|_| Path::new(env!("CARGO_MANIFEST_DIR")).join("../.."))
}

#[test]
fn short_capital_label_passes() {
    assert_eq!(
        tracking_hits(
            r#"<span class="run" style="letter-spacing: 0.18em">LIMITED EDITION RELEASE 2026</span>"#
        ),
        0
    );
    assert_eq!(
        tracking_hits(
            r#"<span class="run" style="letter-spacing: 0.18em; text-transform: uppercase">Fall 2026 technology preview</span>"#
        ),
        0
    );
}

#[test]
fn mixed_case_label_still_flags() {
    assert_eq!(
        tracking_hits(
            r#"<span class="run" style="letter-spacing: 0.18em">Fall 2026 technology preview</span>"#
        ),
        1
    );
}

#[test]
fn typed_capitals_past_label_length_take_the_uppercase_exemption() {
    // Capitals typed into the markup say what `text-transform` says, past
    // the label length (mialight.app's caption that wraps on a phone).
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em">SUPPORT HOURS RUN MONDAY TO FRIDAY, FROM NINE UNTIL SIX.</p>"#
        ),
        0
    );
    // A sentence typed in capitals is still running text: `all-caps-body`
    // reads only a declared transform, so this rule keeps it.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em">SUPPORT HOURS RUN MONDAY TO FRIDAY, FROM NINE IN THE MORNING UNTIL SIX IN THE EVENING.</p>"#
        ),
        1
    );
    // A transform that lowers the case renders no capitals.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em; text-transform: lowercase">SUPPORT HOURS RUN MONDAY TO FRIDAY.</p>"#
        ),
        1
    );
    // `capitalize` leaves capitals as they were typed.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em; text-transform: capitalize">SUPPORT HOURS RUN MONDAY TO FRIDAY.</p>"#
        ),
        0
    );
    // A long run of Hangul with one Latin acronym is not a capitals label,
    // but CJK text takes open tracking by convention (observations-47 row
    // 21), as the browser engine reads it.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em">고객센터 운영 시간은 월요일부터 금요일까지 오전 아홉 시부터 오후 여섯 시까지입니다 (KST)</p>"#
        ),
        0
    );
    // The same run in Latin letters is running text.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em">Support hours run Monday to Friday, from nine in the morning until six (KST)</p>"#
        ),
        1
    );
    // An English line that carries a longer Japanese translation in a
    // hidden child is read by its own text (review): still running text.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em"><span hidden>サポートの受付時間は月曜日から金曜日の午前九時から午後六時までとなっております。祝日と年末年始は休業日となりますのでご了承ください</span>Support hours run Monday to Friday, from nine until six</p>"#
        ),
        1
    );
}

#[test]
fn declared_uppercase_stays_exempt() {
    // `text-transform: uppercase` is the author saying the run is set in
    // capitals at any length; `all-caps-body` owns a reading block of it.
    assert_eq!(
        tracking_hits(
            r#"<p class="run" style="letter-spacing: 0.12em; text-transform: uppercase">Every booking is confirmed by email within one working day of the request.</p>"#
        ),
        0
    );
}

#[test]
fn fixture_flag_and_pass_cases() {
    let fixture = repo_root().join("tests/fixtures/antipatterns/wide-tracking.html");
    assert!(fixture.is_file(), "missing fixture at {}", fixture.display());
    let html = std::fs::read_to_string(&fixture).unwrap();
    let findings = detect_html_source(&html, &fixture, &DetectHtmlOptions::default());
    let tracked = findings
        .iter()
        .filter(|f| f.antipattern == "wide-tracking")
        .count();
    assert_eq!(
        tracked, 3,
        "expected the three flag-column runs and no pass-column label, got {findings:?}"
    );
}