[bheston]

Pull Request

Description

Adds parity tests for the reference tokens and for style generation by the aui CLI, so refactors can be checked for regressions, and fixes a bug in aui compile-styles found while doing so.

• Reference token parity snapshots (src/reference/parity.spec.ts): snapshots the evaluated color (base, layer, palette, and recipe) tokens for several base colors, light and dark layers, and layer nesting, and the density tokens for several density adjustments, design units, and stroke thicknesses. Tokens are resolved through a real element hierarchy (a stub stands in for FASTElement as jsdom has no custom elements), so inheritance and derived values behave as in the browser. Regenerate with npm run unit-tests:update-snapshots.
• Fix aui compile-styles for code anatomies: path.format ignores ext when base is present, so prettier parsed the CSS as index.js and every component with a TypeScript/JavaScript anatomy failed to compile (only JSON anatomies worked). Includes a changeset.
• CLI oracle (scripts/styles-oracle.mjs, src/__test__/styles-oracle): compiles test only fixtures with the real CLI (compile-styles, compile-style, compile-json-anatomy, and the -e option) and compares the generated stylesheets and reported warnings to a checked in baseline. The fixtures are samples adapted from Adaptive Web Components and Polar UI anatomies, plus made up anatomies that stress each capability of the style generation. About 55 capabilities are also asserted directly, so the baseline is not taken on trust. npm run styles:oracle diffs and npm run styles:oracle:update replaces the baseline.

Issues

• Follow up to AUI: Improve test coverage of core #309.

Reviewer Notes

• The generated CSS only references design tokens, so the oracle covers structure and selectors, and the parity snapshots cover evaluated values.
• The oracle fixtures are test only and are not published (src/ and scripts/ are in .npmignore). The copies are not kept in sync with their sources.
• Existing behavior recorded in the baseline, not changed here: parts starting with :: get no state selector (hover, active, and focus collapse to one selector), AWC's anchor generates the never matching :host(:not([href])[href]), and the header comment of code anatomies always says from index.js.
• Smoke test: npm run build && npm run unit-tests in packages/adaptive-ui, then npm run styles:oracle.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 30aaab3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@adaptive-web/adaptive-ui	Patch
@adaptive-web/adaptive-web-components	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR