Skip to content

test(viewer): tokens SSOT proptest surface (WBS-6.2 #450) - #471

Closed
KooshaPari wants to merge 1 commit into
mainfrom
fix/viewer-tokens-properties-20260808
Closed

test(viewer): tokens SSOT proptest surface (WBS-6.2 #450)#471
KooshaPari wants to merge 1 commit into
mainfrom
fix/viewer-tokens-properties-20260808

Conversation

@KooshaPari

@KooshaPari KooshaPari commented Aug 10, 2026

Copy link
Copy Markdown
Owner

User description

Summary

Adds crates/sl-viewer/tests/properties_viewer_tokens.rs with 10 proptest properties pinning the tokens SSOT (WBS-6.2 #450).

lab_coat::* (5 properties)

  • Every hex is well-formed #RRGGBB (7-char lowercase ASCII).
  • Every hex is non-empty and pairwise distinct across the documented 16-constant set.
  • Every hex appears in TOKENS_CSS.

REQUIRED_CSS_VARS (3 properties)

  • Every entry starts with --, is non-empty, and is unique across the documented set.
  • Every entry appears in TOKENS_CSS.

VIEWER_COLOR_SCHEME (2 properties)

  • Declares both :root and :root[data-theme="dark"] selectors.
  • Uses the color-scheme property exactly twice.

Validation

  • cargo test -p sl-viewer --test properties_viewer_tokens --features "desktop parquet" --locked — 10 passed
  • cargo fmt --all --check — clean

WBS / TRACEABILITY

WBS-6.2 evidence list and TRACEABILITY.json gain crates/sl-viewer/tests/properties_viewer_tokens.rs. CHANGELOG Unreleased documents the new surface.


CodeAnt-AI Description

Add property coverage for viewer design tokens and color-scheme wiring

What Changed

  • Added 10 automated checks covering viewer color values, required CSS variables, and light/dark theme declarations.
  • Tests now detect malformed or duplicate colors, missing CSS values, invalid variable names, and incomplete dark-mode configuration.
  • Recorded the new token checks in the WBS evidence, traceability data, and changelog.

Impact

✅ Earlier detection of viewer theme regressions
✅ Fewer Rust/CSS design-token mismatches
✅ Reliable light and dark browser color handling

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Adds crates/sl-viewer/tests/properties_viewer_tokens.rs with 10
proptest properties pinning the design-token SSOT invariants:

* lab_coat::*:
  * Every hex is a well-formed #RRGGBB (7-char lowercase ASCII hex).
  * Every hex is non-empty.
  * All 16 documented hex constants are pairwise distinct.
  * Every hex appears in TOKENS_CSS so the Rust mirror and the
    CSS SSOT stay in sync.
* REQUIRED_CSS_VARS:
  * Every entry starts with --.
  * Every entry is non-empty.
  * The set is duplicate-free.
  * Every entry appears in TOKENS_CSS.
* VIEWER_COLOR_SCHEME:
  * Declares both :root and :root[data-theme dark] selectors.
  * Uses color-scheme exactly twice.

Updates WBS-6.2 evidence list, TRACEABILITY.json, and CHANGELOG.
Copilot AI lite review requested due to automatic review settings August 10, 2026 01:49
@codeant-ai

codeant-ai Bot commented Aug 10, 2026

Copy link
Copy Markdown

🤖 CodeAnt AI — Review Status

Status Commit Started (UTC) Finished (UTC)
✅ Reviewed your PR 7296187 Aug 10, 2026 · 01:50 01:52

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@codeant-ai

codeant-ai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@KooshaPari, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 57 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 22143c8b-f418-4f4d-a4ad-c010ef89387b

📥 Commits

Reviewing files that changed from the base of the PR and between e0a89df and 7296187.

📒 Files selected for processing (4)
  • CHANGELOG.md
  • crates/sl-viewer/tests/properties_viewer_tokens.rs
  • docs/ops/TRACEABILITY.json
  • docs/ops/WBS.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codeant-ai codeant-ai Bot added the size:L This PR changes 100-499 lines, ignoring generated files label Aug 10, 2026
Comment on lines +44 to +69
/// The full list of `lab_coat::*` hex constants in stable declaration
/// order. We compute this once via a small reflection-on-source approach:
/// every `pub const` in `lab_coat::*` whose value is a `&'static str`
/// starting with `#`. Since we can't introspect Rust modules at runtime,
/// we hard-code the list (mirroring `tokens.rs`). The constants are
/// public — any new addition requires also extending this list, which
/// the `proptest` exhaustiveness check below will catch.
fn lab_coat_hex_list() -> &'static [&'static str] {
&[
lab_coat::LAB_WHITE,
lab_coat::SLATE,
lab_coat::COBALT,
lab_coat::COBALT_ON_DARK,
lab_coat::ORANGE,
lab_coat::TEAL,
lab_coat::TEAL_ON_DARK,
lab_coat::BG_DARK,
lab_coat::SURFACE_LIGHT,
lab_coat::BORDER_LIGHT,
lab_coat::BORDER_DARK,
lab_coat::TEXT_DARK,
lab_coat::TEXT_MUTED_LIGHT,
lab_coat::TEXT_MUTED_DARK,
lab_coat::DANGER_LIGHT,
lab_coat::DANGER_DARK,
]

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The list is manually maintained, so adding a new lab_coat constant to tokens.rs without adding it here will not cause any property to fail. The comment claims an exhaustiveness check, but there is no independent count or enumeration against the production module. This can silently leave a new Rust token unvalidated; use a genuinely exhaustive source or remove the exhaustiveness claim. [incomplete implementation]

Severity Level: Major ⚠️
- ⚠️ New Lab-Coat constants can bypass token properties.
- ⚠️ Rust/CSS drift may reach the viewer undetected.
- ⚠️ The documented exhaustiveness claim is false.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 44:69
**Comment:**
	*Incomplete Implementation: The list is manually maintained, so adding a new `lab_coat` constant to `tokens.rs` without adding it here will not cause any property to fail. The comment claims an exhaustiveness check, but there is no independent count or enumeration against the production module. This can silently leave a new Rust token unvalidated; use a genuinely exhaustive source or remove the exhaustiveness claim.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +114 to +118
let hex = lab_coat_hex_list()[i];
prop_assert!(
TOKENS_CSS.contains(hex),
"TOKENS_CSS missing lab_coat hex {:?}",
hex,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: contains(hex) only verifies that the color appears somewhere in the shared stylesheet, not that the corresponding Lab-Coat token is assigned that color. For example, changing BG_DARK to the unrelated skeleton color #e5e7eb would still pass because that value exists elsewhere in TOKENS_CSS, while the --sl-bg mapping would be out of sync. Validate the token name and value on the same declaration line, as the existing mirror test does. [api mismatch]

Severity Level: Major ⚠️
- ❌ Viewer colors can diverge from Rust token meanings.
- ⚠️ Dark and light surfaces may render incorrectly.
- ⚠️ Existing checks omit viewer-specific CSS mappings.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 114:118
**Comment:**
	*Api Mismatch: `contains(hex)` only verifies that the color appears somewhere in the shared stylesheet, not that the corresponding Lab-Coat token is assigned that color. For example, changing `BG_DARK` to the unrelated skeleton color `#e5e7eb` would still pass because that value exists elsewhere in `TOKENS_CSS`, while the `--sl-bg` mapping would be out of sync. Validate the token name and value on the same declaration line, as the existing mirror test does.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +154 to +160
fn required_css_var_in_tokens_css(i in required_var_index_strategy()) {
let var = REQUIRED_CSS_VARS[i];
prop_assert!(
TOKENS_CSS.contains(var),
"TOKENS_CSS missing required CSS var {:?}",
var,
);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: TOKENS_CSS.contains(var) does not prove that the required variable is declared. For instance, if the exact --sl-bg declaration is removed while --sl-bg-muted remains, the test still passes because the shorter name is a substring of the remaining variable. Match a complete custom-property declaration rather than an arbitrary substring. [api mismatch]

Severity Level: Major ⚠️
- ⚠️ Missing required CSS variables can evade CI.
- ❌ Viewer styles may lose intended token values.
- ⚠️ Prefix collisions weaken both token checks.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 154:160
**Comment:**
	*Api Mismatch: `TOKENS_CSS.contains(var)` does not prove that the required variable is declared. For instance, if the exact `--sl-bg` declaration is removed while `--sl-bg-muted` remains, the test still passes because the shorter name is a substring of the remaining variable. Match a complete custom-property declaration rather than an arbitrary substring.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

Comment on lines +171 to +173
fn viewer_color_scheme_declares_both_selectors(_i in 0u8..4) {
prop_assert!(VIEWER_COLOR_SCHEME.contains(":root"));
prop_assert!(VIEWER_COLOR_SCHEME.contains("[data-theme=\"dark\"]"));

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion: The two independent substring checks do not require the dark attribute selector to be attached to :root. A stylesheet containing a standalone :root rule and a separate .other[data-theme="dark"] rule would pass even though the injected dark color-scheme rule does not apply to the document root. Check for the exact :root[data-theme="dark"] selector. [incorrect condition logic]

Severity Level: Major ⚠️
- ❌ Dark-mode browser color handling can fail.
- ⚠️ Scrollbars and form controls may retain light styling.
- ⚠️ Viewer root theme toggling becomes incorrectly wired.

Fix in Cursor Fix in VSCode Claude

Prompt for AI Agent 🤖
This is a comment left during a code review.

**Path:** crates/sl-viewer/tests/properties_viewer_tokens.rs
**Line:** 171:173
**Comment:**
	*Incorrect Condition Logic: The two independent substring checks do not require the dark attribute selector to be attached to `:root`. A stylesheet containing a standalone `:root` rule and a separate `.other[data-theme="dark"]` rule would pass even though the injected dark color-scheme rule does not apply to the document root. Check for the exact `:root[data-theme="dark"]` selector.

Validate the correctness of the flagged issue. If correct, How can I resolve this? If you propose a fix, implement it and please make it concise.
Once fix is implemented, also check other comments on the same PR, and ask user if the user wants to fix the rest of the comments as well. if said yes, then fetch all the comments validate the correctness and implement a minimal fix
👍 | 👎

@KooshaPari

Copy link
Copy Markdown
Owner Author

Closing due to merge conflicts.

@KooshaPari KooshaPari closed this Aug 10, 2026
@KooshaPari
KooshaPari deleted the fix/viewer-tokens-properties-20260808 branch August 10, 2026 02:11
KooshaPari pushed a commit that referenced this pull request Aug 12, 2026
…#471)

Shards the unique viewer proptest from #490 onto main without the
obsolete pre-rename daemon source churn.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants