feat(cssom): implement CSS nth-child() and nth-of-type() selector support

[Copilot]

Adds complete support for CSS :nth-child() and :nth-of-type() pseudo-class selectors, including both parser and matching functionality.

Features Added

Parser Support

• Keywords: odd, even (e.g., :nth-child(odd))
• Numbers: Simple position matching (e.g., :nth-child(3))
• Formulas: Full an+b syntax support (e.g., :nth-child(3n+2), :nth-child(-n+3))
• Variants: Both :nth-child() and :nth-of-type() selectors

Matching Engine

• Accurate element position calculation among siblings
• Proper an+b formula evaluation for all edge cases
• Distinction between child position (all elements) vs type position (same tag elements)
• Support for forward sequences (2n+1) and backward sequences (-n+3)

Examples

/* Select odd rows */
tr:nth-child(odd) { background: lightgray; }

/* Select every 3rd paragraph starting from 2nd */
p:nth-child(3n+2) { margin-left: 20px; }

/* Select first 3 elements */
div:nth-child(-n+3) { border-top: 1px solid blue; }

/* Select every 2nd heading of same type */
h2:nth-of-type(2n) { color: purple; }

Implementation Details

Modified Files:

• src/client/cssom/selectors/css_selector_parser.hpp - Added nth-child data fields and methods
• src/client/cssom/selectors/css_selector_parser.cpp - Implemented parsing logic for an+b formulas
• src/client/cssom/selectors/matching.cpp - Added position-based matching algorithms
• tests/client/css_selector_parser_tests.cpp - Comprehensive test coverage for all syntax variations
• docs/internals/CSS_SELECTOR_PARSER_IMPL.md - Updated documentation with usage examples

Key Technical Changes:

• Extended Component class with nthA_ and nthB_ fields to store an+b coefficients
• Added parseNthFormula() method to handle all nth-child syntax variations
• Implemented isNthChild() and isNthOfType() helper functions for accurate position matching
• Proper string representation for debugging and serialization

Testing

• ✅ 320 comprehensive test assertions pass (100% backwards compatibility)
• ✅ Tests cover all syntax variations: keywords, numbers, positive/negative formulas
• ✅ Complex selector combinations with nth-child work correctly
• ✅ C++ code formatting applied and verified

The implementation follows the CSS specification exactly and integrates seamlessly with the existing selector infrastructure without breaking any existing functionality.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• registry.npmmirror.com
  • Triggering command: npm ci (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.