Skip to content

test: check every split component page like the Button's - #57

Merged
alexgrozav merged 2 commits into
component-sub-pages-uxf-421from
split-tests-uxf-423
Oct 22, 2026
Merged

alexgrozav merged 2 commits into
component-sub-pages-uxf-421from
split-tests-uxf-423

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The tests and checks that proved the Button's split now cover every component page split the same way, so each component that moves into a folder of its own is in the gate without a change to these files.

server/lib/raw.test.ts runs its split-page tests once per folder in content/docs/3.components/ that has an index.md, named for the folder. Each page is one page with its parts joined back in, with the outline every component page has. It has a page per layer, each ending with its rules and then its questions, if it has any. Its .navigation.yml names the folder with an icon. Its Overview has no FAQ, a card for each part with that part's description, and a link to each part's rules. Its anchor map sends every section of its parts on to them, and none of the Overview's. The Button's own anchor cases stay as they were.

mcp/lib/standard.test.ts reads every split page's rules from its layer pages' tables. mcp/lib/pages.test.ts finds every split page from each of its parts' paths, with an anchor and as its /raw file. scripts/check-mcp.mjs checks every page that has parts: each part's path reads the whole page, a part's link with an anchor reads that section, the UX rules hold one of its rules, and the introduction links every part. The Button's #loading and Variants checks stay.

No content, join, redirect map or sidebar changes.

Checklist

  • The title follows Conventional Commits, as in feat(docs): add the focus guideline.
  • pnpm check-types passes.
  • Docs changes: the pages read well on pnpm dev. (No docs changes.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes.)

alexgrozav and others added 2 commits October 22, 2026 12:42
The tests and check-mcp that proved the Button's split now run once per split folder in 3.components/, found from the files, so each component that's split the same way is in the gate without a change to them. The Button's own anchor, #loading and Variants cases stay as they are.

Co-authored-by: multica-agent <github@multica.ai>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://split-tests-uxf-423-opencomponents.blue-water-0397.workers.dev (commit 694a15a)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://ebd8b105-opencomponents.blue-water-0397.workers.dev 694a15a 2026-10-22T12:15:21.078Z Visit the dashboard ↗

@alexgrozav
alexgrozav merged commit e47cda0 into component-sub-pages-uxf-421 Oct 22, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the split-tests-uxf-423 branch October 22, 2026 12:34
alexgrozav added a commit that referenced this pull request Oct 23, 2026
… layer (#69)

## What changed

The other ten component pages now have the shape the Button's got in
#54: the Card, Checkbox, Checkbox Group, Dialog, Input, Radio Group,
Spinner, Switch, Textarea and Tooltip each become a folder in
`content/docs/3.components/`. Each folder holds an Overview and a page
per layer: User Interface (UI), User Experience (UX), Developer
Experience (DX) and Agentic Experience (AX). The text moves as it is.
The only changes are the ones the Button's split made: the cards in
place of the intro's list of layers, At a glance starting before the
paragraph on examples, the four Checklist links, each part's rules under
"UI Checklist" and so on, its questions under its own FAQ, and link
targets.

Once the Checkbox was a folder, Nuxt Content would have listed Checkbox
Group before it, since it sorts by file path and `-` comes before `/`.
`app/lib/navigation.ts` keeps the component pages in name order in the
sidebar, the header's menu and the links to the previous and next pages.
`app/components/UContentSurround.vue` replaces Nuxt UI's to read that
order. The tests that covered the Button's split, and the Button-only
checks in `scripts/check-mcp.mjs`, now run once for every split
component. Links between components go straight to the section's new
page. Links from before the split, like `/docs/components/input#sizes`,
still land on the right page through the redirect map.

In the sidebar and the header's menu, a component's name opens and
closes the list of its pages, the Overview and its layers, without
navigating, so you pick the page you want. The group still opens on any
of its pages and closes once you leave them.

Agents see no difference. `/raw/docs/components/<component>.md` and
`.yaml`, and the MCP server, serve each component as one page with the
outline and contract it has on `main`. The FAQ comes back grouped by
layer. A changelog entry announces the change, and `AGENTS.md` and
`.github/CONTRIBUTING.md` now say every component page is split like the
Button's.

It collects these PRs, each reviewed on its own: #56 (component order),
#57 (split tests), #58 to #67 (one per component), #68 (links between
components, changelog, guides) and #70 (the name opens the group,
without navigating).

To try it, run `pnpm dev` and open `/docs/components/checkbox`.

## Checklist

- [x] The title follows [Conventional
Commits](https://www.conventionalcommits.org), as in `feat(docs): add
the focus guideline`.
- [x] `pnpm check-types` passes.
- [x] Docs changes: the pages read well on `pnpm dev`. (Checked on a
`pnpm build` served with `wrangler dev`.)
- [x] Homepage changes: `pnpm build`, then `pnpm lighthouse`, still
scores 100 in every category. (No homepage changes, but the redirect map
now covers eleven components and loads on every page, so it ran: 100 in
every category on all three runs.)

---------

Co-authored-by: multica-agent <github@multica.ai>
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