Skip to content

docs(htmlcss): expand CSS property reference and overhaul L0 fixtures#632

Merged
softmarshmallow merged 2 commits intomainfrom
feature/recursing-williamson
Apr 6, 2026
Merged

docs(htmlcss): expand CSS property reference and overhaul L0 fixtures#632
softmarshmallow merged 2 commits intomainfrom
feature/recursing-williamson

Conversation

@softmarshmallow
Copy link
Copy Markdown
Member

@softmarshmallow softmarshmallow commented Apr 6, 2026

Summary

  • Expand htmlcss.md Text & Font section from 11 to ~75 CSS properties across 9 sub-sections (font variants, text layout, decoration, emphasis, writing modes, inline alignment, ruby)
  • Convert all 30 L0 HTML fixtures from branded dark theme to probe-friendly B/W high-contrast palette for headless testing
  • Rename 7 fixtures to follow <domain>-<property>[-<descriptor>] naming convention (flex-, filter-, inline-, list-, transform- domains)
  • Add grid-template.html fixture covering grid-template-columns/rows, fr units, repeat(), gap, spanning, auto-flow, and template-areas
  • Rewrite L0 README with domain taxonomy, probe-friendly authoring rules, and updated template
  • Add .agents/skills/fixtures/SKILL.md — general fixture authoring skill covering best practices, git inclusion policy, and local-only reference rules

Test plan

  • cargo test -p cg --lib -- htmlcss::tests --test-threads=1 passes with updated fixtures
  • Visual spot-check fixtures via cargo run -p grida-dev -- fixtures/test-html/L0/mixed-card.html
  • Verify no old branded colors remain: grep -rl '#030712' fixtures/test-html/L0/

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • Documentation

    • Added comprehensive fixture authoring guide with best practices and git policies
    • Significantly expanded CSS property support documentation with detailed capability matrix across 15+ categories, including partial-support notes
    • Updated fixture naming and organizational guidelines with domain-driven conventions
  • Style

    • Updated 25+ test fixtures from dark to light theme with improved contrast and consistency
    • Simplified visual designs and standardized color palettes across test fixtures

softmarshmallow and others added 2 commits April 6, 2026 19:39
- Expand Text & Font section in htmlcss.md from 11 to ~75 properties
  across 9 sub-sections (font variants, text layout, decoration,
  emphasis, writing modes, inline alignment, ruby)
- Convert all 30 L0 fixtures from branded dark theme to probe-friendly
  B/W high-contrast palette for headless testing
- Rename 7 fixtures to follow <domain>-<property>[-<descriptor>] convention
  (flex-, filter-, inline-, list-, transform- domains)
- Add grid-template.html fixture covering grid-template-columns/rows,
  fr units, repeat(), gap, spanning, auto-flow, and template-areas
- Rewrite L0 README with domain taxonomy, authoring rules for
  probe-friendly fixture design, and updated template

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Covers what fixtures are, why we keep them, best practices for
authoring probe-friendly fixtures, git inclusion policy (committed
vs local-only), and the rule to never reference local-only fixtures
in committed code or tests.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Apr 6, 2026 10:53am
docs Ready Ready Preview, Comment Apr 6, 2026 10:53am
grida Ready Ready Preview, Comment Apr 6, 2026 10:53am
viewer Ready Ready Preview, Comment Apr 6, 2026 10:53am
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
backgrounds Ignored Ignored Apr 6, 2026 10:53am
code Ignored Ignored Apr 6, 2026 10:53am
legacy Ignored Ignored Apr 6, 2026 10:53am

Request Review

@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 6, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 9e2ea66f-4562-411c-bd3f-68cd3f6981e6

📥 Commits

Reviewing files that changed from the base of the PR and between 82f73dd and 11f44cc.

📒 Files selected for processing (34)
  • .agents/skills/fixtures/SKILL.md
  • docs/wg/feat-2d/htmlcss.md
  • fixtures/test-html/L0/README.md
  • fixtures/test-html/L0/box-dimensions.html
  • fixtures/test-html/L0/box-margin.html
  • fixtures/test-html/L0/box-padding.html
  • fixtures/test-html/L0/filter-backdrop-blur.html
  • fixtures/test-html/L0/filter-blur.html
  • fixtures/test-html/L0/flex-column.html
  • fixtures/test-html/L0/flex-row.html
  • fixtures/test-html/L0/grid-template.html
  • fixtures/test-html/L0/inline-elements.html
  • fixtures/test-html/L0/layout-block.html
  • fixtures/test-html/L0/layout-display-none.html
  • fixtures/test-html/L0/list-style.html
  • fixtures/test-html/L0/mixed-card.html
  • fixtures/test-html/L0/mixed-inline-style.html
  • fixtures/test-html/L0/paint-background-solid.html
  • fixtures/test-html/L0/paint-blend-mode.html
  • fixtures/test-html/L0/paint-border-radius.html
  • fixtures/test-html/L0/paint-border-style.html
  • fixtures/test-html/L0/paint-gradient-linear.html
  • fixtures/test-html/L0/paint-gradient-radial.html
  • fixtures/test-html/L0/paint-opacity.html
  • fixtures/test-html/L0/paint-shadow.html
  • fixtures/test-html/L0/text-align.html
  • fixtures/test-html/L0/text-color.html
  • fixtures/test-html/L0/text-decoration-full.html
  • fixtures/test-html/L0/text-decoration.html
  • fixtures/test-html/L0/text-font-properties.html
  • fixtures/test-html/L0/text-letter-spacing.html
  • fixtures/test-html/L0/text-line-height.html
  • fixtures/test-html/L0/text-shadow.html
  • fixtures/test-html/L0/transform-2d.html

Walkthrough

This PR establishes fixture authoring guidelines and systematically updates test fixtures for the HTML/CSS renderer. It adds documentation on fixture best practices (SKILL.md), expands CSS property support documentation, updates the fixture README with new naming conventions and structural requirements, and applies consistent light-theme styling and high-contrast colors across 30+ HTML/CSS test fixtures. One new grid-template fixture is also added.

Changes

Cohort / File(s) Summary
Fixture Guidelines & Documentation
.agents/skills/fixtures/SKILL.md, fixtures/test-html/L0/README.md, docs/wg/feat-2d/htmlcss.md
New SKILL.md establishes fixture authoring and git-inclusion policies; README overhauled with flat domain-driven naming scheme, structural requirements (one property per file, minimal HTML), and probe-friendly styling rules; CSS property support expanded with granular capability matrix covering Grid, Flexbox, Transforms, Filters, and other property areas.
Theme & Styling Updates
fixtures/test-html/L0/box-*.html, fixtures/test-html/L0/filter-*.html, fixtures/test-html/L0/flex-*.html, fixtures/test-html/L0/layout-*.html, fixtures/test-html/L0/paint-*.html, fixtures/test-html/L0/text-*.html, fixtures/test-html/L0/transform-*.html, fixtures/test-html/L0/mixed-*.html, fixtures/test-html/L0/inline-elements.html, fixtures/test-html/L0/list-style.html
Consistent theme switch across ~30 fixtures: dark background/text (#030712/#e2e8f0) → light (#fff/#000); added margin: 0 and explicit padding: 24px; label colors darkened (#94a3b8#666); removed rounded corners; updated sample color values (e.g., indigo/purple → black/primary colors); simplified gradients and shadows to high-contrast palettes.
New Fixture
fixtures/test-html/L0/grid-template.html
Added comprehensive CSS Grid specimen fixture demonstrating grid-template-columns (fixed/fractional/repeat), grid-template-rows, gap, spanning, grid-auto-flow: dense, and grid-template-areas with labeled examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

Suggested labels

canvas, chore

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/recursing-williamson

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 and usage tips.

@softmarshmallow softmarshmallow merged commit 99bd007 into main Apr 6, 2026
12 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant