@fusion.dev/helix-docs 0.186.1 → 0.188.0

package/dist/sources.generated.js

@@ -479,6 +479,48 @@ TypeScript declares custom elements this way. The interface merges from your
 source, and a generated file cannot name a class that is not in the same
 program.
 
+## Check your components with \`helix component\`
+
+\`helix component\` checks the components you write on Helix's base classes. Name
+the folders that hold them in \`helix.json\` at your project's root:
+
+\`\`\`json
+{ "tiers": ["src/components"] }
+\`\`\`
+
+Then run it:
+
+\`\`\`sh
+helix component audit
+helix component check
+\`\`\`
+
+\`audit\` prints each rule and what it found, and \`check\` prints nothing when
+there is nothing to report. Both exit 1 on a finding, and \`--json\` prints the
+findings as data. The rules check what your components document and write:
+
+| Rule | What it checks |
+|---|---|
+| \`tier\` | A component built on a headless one that renders children sets \`tier\`, so its children are yours and not Helix's |
+| \`registered\` | Every element a component's base renders is registered under the prefix it sets |
+| \`composed\` | A module that renders one of your elements, by its base or in its own template, imports the module that registers it |
+| \`slots\` | A \`@slot\` you document is one the Helix class under it takes, or one your template renders |
+| \`exportparts\` | A \`::part()\` written at your elements or at Helix's names a part that element publishes |
+| \`words\` | A component with \`static words\` declares its English defaults \`@words\`, and joins no word into a sentence outside the message |
+| \`dispatched\` | An event your component sends by name, with \`new CustomEvent\` or \`new Event\`, is documented with \`@event\` |
+| \`parts\` | A \`@csspart\` you document is rendered, and a \`part\` you render is documented |
+| \`states\` | A custom state you record is documented with \`@cssstate\`, and a documented one is recorded |
+| \`hooks\` | A \`@cssproperty\` you document is read, and one you read is documented |
+| \`restated\` | A part, a slot, or an event is declared once |
+| \`reflected\` | A property that reflects has no default, so a host carries no attribute nobody wrote |
+| \`reflected-defaults\` | A reflected property writes no attribute on upgrade that a server did not send |
+| \`attribute-names\` | A property that mirrors a platform attribute answers to the platform's spelling |
+| \`constructed\` | No class field reads the element's attributes in its initializer, where a parsed element has none yet |
+| \`observers\` | An observer built once is not torn down by a lifecycle that runs many times |
+| \`leaks\` | A listener on something the element does not own is removed when the element is |
+
+\`--only parts,states\` runs a few of them.
+
 ## What the headless tier handles for you
 
 ### Tree-shaking
@@ -918,15 +960,20 @@ type such as \`ButtonEmphasis\` sends you somewhere else to look.
 ## Markdown and JSON for each component family
 
 \`\`\`
-/components/<family>.md
-/components/<family>.json
+https://fusion.dev/helix/components/<family>.md
+https://fusion.dev/helix/components/<family>.json
 \`\`\`
 
-These are static files. The \`.md\` file has:
+These are static files, one pair for each family. Read the family you are
+writing instead of the whole manifest. The manifest holds every family in one
+file, and it is several megabytes.
+
+The \`.md\` file has:
 
 - the family's metadata
+- a Usage block with the import lines for the family
 - every element's description and API tables
-- the examples
+- the examples, each with the import lines it needs
 
 The HTML page leaves the examples out on purpose. The page lists what a
 component can do, and the sandbox beside it shows what the component looks
@@ -934,24 +981,49 @@ like. Keeping pictures out of the reference keeps it the one place you can trust
 to be complete. An agent cannot use the sandbox, and it reads an example as
 text, so the \`.md\` file includes the examples.
 
-The \`.json\` file has the same family as structured data.
+Each example the visual check pictures links its pictures under it: wide at
+640 pixels, narrow at 390, and dark at 640, taken in the environment that
+\`examples.json\` records. Compare a render of your own to them.
 
-## Rules the build checks
+The \`.json\` file has the same family as structured data, and three fields an
+agent uses most:
 
-Code that looks right can still fail these checks:
+- \`usage\`, the import block for each tier
+- \`imports\` on each example, an import line for every element it writes
+- \`specifier\` and \`words\` on each element: the line that registers it, and the
+  properties \`registerWords\` translates
 
-| Rule | Check |
+## Import every family you write
+
+Each tag needs its family's entry imported. A family registers its own parts,
+so \`@fusion.dev/helix/tabs\` registers Tab and Tab Panel. A family does not
+register another family's elements that you write inside it:
+
+\`\`\`js
+import '@fusion.dev/helix/select'
+import '@fusion.dev/helix/option'
+\`\`\`
+
+Without the Option import, the options are unknown elements and the Select
+offers nothing. The same is true
+of the layout around an example: a Button inside a Flex needs both imports.
+Copy the import lines above an example together with its markup.
+
+## Check the code you wrote
+
+These checks run on your project, and each one prints JSON with \`--json\`:
+
+| Command | What it finds |
 |---|---|
-| A dispatched event must be declared | \`helix component --only events\` |
-| A documented part must be rendered | \`helix component\`'s \`parts\` |
-| A documented CSS hook must be read | \`helix component --only hooks\` |
-| A visual property draws from its axis | \`helix component\`'s \`axes\` |
-| A form control styles with \`:disabled\` | \`helix component --only disabled\` |
-| A component that animates supports reduced motion | \`helix component --only motion\` |
-| No component reads a primitive token | \`helix component\`'s \`tokens\` |
+| \`helix scan\` | Unknown tags, attributes, values, slots, parts, hooks, React event props, and tokens, a \`--_helix-\` primitive read, \`[disabled]\` on a form control, a selector on an attribute the element never writes back, and a tag whose entry nothing imports, each with its file and line |
+| \`helix theme audit\` | Every foreground and background pair in your theme that misses its contrast target |
+| \`initDiagnostics()\` from \`@fusion.dev/helix-diagnostics\` | The same findings on the running page, and what the library reports as it runs, such as an option nobody imported |
 
-If you generate Helix code, watch the first two rules. Breaking them produces
-output that looks like it works and is wrong.
+\`helix scan\` and \`helix theme audit\` exit 1 when they find an error and 0 when
+they find none. Run them after you write Helix code, and fix each finding
+before you finish. \`helix scan --file <path>\` reports one file's findings, and
+\`helix scan --stdin tsx\` reads a snippet from stdin. Both still read the whole
+project, so an import in another file counts.
 
 ## The index
 
@@ -979,28 +1051,58 @@ Each family page has a menu beside its title with:
 The links send the URL, because the URL stays current. A pasted copy starts to
 go stale as soon as you paste it.
 
-## Compute a theme with \`helix mcp\`
+## The Helix MCP server
 
 \`\`\`sh
-helix mcp
+helix mcp init --client claude
 \`\`\`
 
-The three sources above are fixed sets. Every tag, token, and example is
-published, and an agent can fetch it. None of them has the theme for *your*
-brand color. The input is a color, and there are infinitely many colors, so
-Helix has to compute the theme when an agent requests it.
+\`helix mcp\` runs an MCP server over stdio. It answers from the Helix packages
+your project installs, so every answer is for the version you build with, and
+each one names that package and version. \`helix mcp init\` adds the server to
+the file your client reads and keeps every other server in it:
+
+| Client | File |
+|---|---|
+| \`claude\` | \`.mcp.json\` |
+| \`cursor\` | \`.cursor/mcp.json\` |
+| \`vscode\` | \`.vscode/mcp.json\` |
 
-\`helix mcp\` runs an MCP server over stdio with two tools:
+The server runs \`npx @fusion.dev/helix-cli mcp\`, which is the copy in your
+project. It has nine tools:
 
-- \`helix_audit_theme\` measures every foreground against the background it is
-  painted on. It reports each pair with its ratio and target.
-- \`helix_derive_theme\` returns the CSS.
+| Tool | What it returns |
+|---|---|
+| \`helix_find\` | The families that answer a name, an alias, a tag, or a purpose, best first |
+| \`helix_family\` | One family's tags, properties and their unions, events and their React props, slots, parts, custom properties, words, and import lines |
+| \`helix_example\` | One example as HTML and TSX, with its stylesheet, the import lines it needs, and links to its pictures |
+| \`helix_imports\` | The import lines for a list of tags, and the closest tag to any unknown one |
+| \`helix_tokens\` | The semantic tokens, by a word in the name or description and by category |
+| \`helix_check\` | The findings \`helix scan\` reports for the files you name, or for a snippet before you write it |
+| \`helix_check_page\` | The findings the page diagnostics report for each address you name, opened headless, with what the library logged as the page ran |
+| \`helix_audit_theme\` | Every foreground and background pair a brand color derives to, with its ratio and target |
+| \`helix_derive_theme\` | The theme's CSS |
+
+Each result is structured, with an output schema, and the same JSON as text.
+A name that matches more than one family, such as \`Dropdown\`, returns an error
+listing each family. The theme tools take the same JSON that a
+\`helix.theme.json\` file holds.
+
+Each lookup is also a command, for a script or a person:
+
+\`\`\`sh
+helix api find dropdown
+helix api family select
+helix api example select
+helix api imports helix-select helix-option
+helix api tokens surface --category color
+\`\`\`
 
-Both take the same JSON that a \`helix.theme.json\` file holds.
+\`--json\` prints what the MCP tool returns.
 
-**\`helix mcp\` does not return a palette that fails its own targets**, the same
-as \`helix theme build\`. A failing palette pasted into a stylesheet is worse than
-a warning above it, and an agent does not read warnings.
+**\`helix_derive_theme\` does not return a palette that fails its own targets**,
+the same as \`helix theme build\`. A failing palette pasted into a stylesheet is
+worse than a warning above it, and an agent does not read warnings.
 
 You run \`helix mcp\` yourself, and we do not host it. A server we operated would
 be one more service between you and your own tokens. \`helix mcp\` is a
@@ -1009,17 +1111,12 @@ no network requests.
 
 ## What we do not publish for agents
 
-**\`llms-full.txt\`, or any other whole-library download.** A single file with
-every page goes out of date as soon as anything changes. Each link in \`llms.txt\`
-can be cached on its own and stays current on its own.
+**\`llms-full.txt\`, or any other whole-library download of the pages.** A single
+file with every page goes out of date as soon as anything changes. Each link in
+\`llms.txt\` can be cached on its own and stays current on its own.
 
-The two sources already here cover what such a file would be for. \`llms.txt\` is
-the index, in one request, and each family's \`.md\` file is its document. Fetch
-the families you use.
-
-**A search index.** The site has a search index for people. There is nothing an
-agent can query yet. Reading \`llms.txt\` and the documents it names takes less
-work than learning most search APIs.
+\`llms.txt\` is the index, in one request, and each family's \`.md\` file is its
+document. Fetch the families you use, or ask \`helix mcp\`.
 `,
     color: `---
 description: The color roles, why Helix uses OKLCH, and how the engine meets contrast targets.
@@ -4243,7 +4340,7 @@ on its own.
 
 | | Raw | Gzip | Brotli |
 |---|---|---|---|
-| Lit and \`@fusion.dev/helix-core\` | 248,564 | 79,270 | 67,871 |
+| Lit and \`@fusion.dev/helix-core\` | 248,564 | 79,270 | 67,881 |
 
 ## Whole packages
 
@@ -4254,12 +4351,12 @@ either barrel. The per-component tables show what your page pays.
 
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
-| \`@fusion.dev/helix-core\` | 247,773 | 79,121 | 67,606 | The element base class, mixins, decorators, and floating positioning. |
-| \`@fusion.dev/helix-headless\` | 1,337,367 | 373,053 | 279,891 | Every headless family. The barrel entry includes all of them. |
+| \`@fusion.dev/helix-core\` | 247,773 | 79,121 | 67,595 | The element base class, mixins, decorators, and floating positioning. |
+| \`@fusion.dev/helix-headless\` | 1,337,367 | 373,053 | 280,098 | Every headless family. The barrel entry includes all of them. |
 | \`@fusion.dev/helix-icons\` | 56,111 | 17,847 | 15,166 | The whole glyph set. |
 | \`@fusion.dev/helix-theme\` | 3,626 | 1,597 | 1,384 | The JavaScript that runs the derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
 | \`fusion_helix_theme_bg.wasm\` | 490,971 | 155,905 | 125,923 | The derivation engine itself, in WebAssembly. The entry above loads it when the engine runs. |
-| \`@fusion.dev/helix\` | 2,015,564 | 520,954 | 371,924 | Every styled family. |
+| \`@fusion.dev/helix\` | 2,015,564 | 520,954 | 372,055 | Every styled family. |
 | \`lit\` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
 
 ## Stylesheets
@@ -4282,9 +4379,9 @@ shows the whole cost of using the base layer on its own.
 
 **Most of your first component is the shared runtime.** The median styled family is 17,535 bytes gzipped alone, and it adds 3,868 to a page that already has Helix. The shared runtime is 78 percent of the first component, and the component itself is 22 percent. Ten typical components cost the first number once, plus nine of the added number. The two columns in the tables below let you work that out for your own components.
 
-Across the 106 styled components, the smallest is \`code\` at 8,333 bytes gzipped alone, and the largest is \`data-table\` at 66,817. Every family together is 520,954.
+Across the 106 styled components, the smallest is \`code\` at 8,331 bytes gzipped alone, and the largest is \`data-table\` at 66,817. Every family together is 520,954.
 
-No family imports a barrel. The \`barrels\` rule in \`fusion workspace\` enforces that. \`@fusion.dev/helix-headless\` marks every module in \`dist\` as having side effects, which is true of a file that calls \`customElements.define\`. A bundler can remove none of it. One \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 373,053 bytes gzipped, whatever else the page imports. That is 21 times the median family above. All 106 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
+No family imports a barrel. The \`barrels\` rule in \`fusion x workspace\` enforces that. \`@fusion.dev/helix-headless\` marks every module in \`dist\` as having side effects, which is true of a file that calls \`customElements.define\`. A bundler can remove none of it. One \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 373,053 bytes gzipped, whatever else the page imports. That is 21 times the median family above. All 106 styled families import the headless family they extend directly. The rule checks the shape of the import, so it applies to any package that sets \`sideEffects\`, whatever its name.
 
 The headless tier never had the problem, so it serves as the control. \`@fusion.dev/helix-core\` is \`sideEffects: false\`, and the median headless family is 16,647 bytes gzipped alone.
 
@@ -4298,37 +4395,37 @@ The table has no whole-library row. That row would compare how many components e
 
 | Component | System | Raw | Gzip | Brotli |
 |---|---|---|---|---|
-| \`button\` | **Helix** | 41,612 | 14,007 | 12,463 |
+| \`button\` | **Helix** | 41,612 | 14,007 | 12,440 |
 | | Carbon | 133,058 | 20,959 | 17,685 |
 | | Material Web | 47,060 | 14,173 | 12,591 |
 | | Shoelace | 62,628 | 18,287 | 15,805 |
 | | Spectrum | 98,792 | 22,045 | 18,674 |
-| \`checkbox\` | **Helix** | 46,865 | 15,190 | 13,511 |
+| \`checkbox\` | **Helix** | 46,865 | 15,190 | 13,517 |
 | | Carbon | 60,255 | 15,609 | 13,550 |
 | | Material Web | 43,785 | 13,556 | 12,015 |
 | | Shoelace | 47,614 | 15,177 | 13,301 |
 | | Spectrum | 62,492 | 15,437 | 13,481 |
-| \`dialog\` | **Helix** | 43,360 | 14,855 | 13,245 |
+| \`dialog\` | **Helix** | 43,360 | 14,855 | 13,244 |
 | | Carbon | 510,866 | 67,390 | 39,189 |
 | | Material Web | 34,238 | 11,510 | 10,229 |
 | | Shoelace | 52,754 | 17,698 | 15,554 |
 | | Spectrum | 155,708 | 31,899 | 26,262 |
-| \`radio\` | **Helix** | 50,349 | 15,977 | 14,212 |
+| \`radio\` | **Helix** | 50,349 | 15,977 | 14,203 |
 | | Carbon | 63,055 | 16,887 | 14,605 |
 | | Material Web | 41,044 | 13,234 | 11,757 |
 | | Shoelace | 34,865 | 12,027 | 10,559 |
 | | Spectrum | 38,685 | 10,660 | 9,370 |
-| \`switch\` | **Helix** | 43,562 | 14,637 | 13,013 |
+| \`switch\` | **Helix** | 43,562 | 14,638 | 13,007 |
 | | Carbon | 69,423 | 17,127 | 14,764 |
 | | Material Web | 50,155 | 14,577 | 12,935 |
 | | Shoelace | 37,833 | 11,814 | 10,568 |
 | | Spectrum | 62,322 | 15,059 | 13,321 |
-| \`tabs\` | **Helix** | 55,263 | 17,753 | 15,836 |
+| \`tabs\` | **Helix** | 55,263 | 17,753 | 15,846 |
 | | Carbon | 578,766 | 73,537 | 43,235 |
 | | Material Web | 38,883 | 12,820 | 11,368 |
 | | Shoelace | 54,573 | 17,140 | 15,068 |
 | | Spectrum | 64,875 | 18,298 | 16,283 |
-| \`tooltip\` | **Helix** | 61,420 | 21,833 | 19,384 |
+| \`tooltip\` | **Helix** | 61,420 | 21,833 | 19,329 |
 | | Carbon | 189,382 | 30,354 | 22,273 |
 | | Material Web | | not shipped | |
 | | Shoelace | 57,412 | 20,220 | 17,933 |
@@ -4380,105 +4477,105 @@ Structure, accessibility, state, and form participation. It has no presentation
 
 | Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
 |---|---|---|---|---|---|---|
-| \`accordion\` | 31,879 | 11,805 | 10,502 | 5,329 | 1,598 | 1,333 |
-| \`announcement\` | 36,692 | 13,313 | 11,874 | 4,682 | 1,425 | 1,119 |
-| \`app-header\` | 32,289 | 11,899 | 10,558 | 5,871 | 1,795 | 1,307 |
-| \`area-chart\` | 90,301 | 31,725 | 28,102 | 14,058 | 4,345 | 3,533 |
-| \`avatar\` | 30,463 | 11,596 | 10,391 | 3,957 | 1,234 | 1,079 |
-| \`badge\` | 27,088 | 10,568 | 9,409 | 2,942 | 919 | 743 |
-| \`bar-chart\` | 94,416 | 32,821 | 29,078 | 18,026 | 5,441 | 4,452 |
-| \`blockquote\` | 24,107 | 9,420 | 8,332 | 2,402 | 913 | 777 |
-| \`breadcrumbs\` | 36,279 | 13,906 | 12,383 | 7,360 | 2,451 | 1,999 |
-| \`button\` | 35,194 | 12,591 | 11,209 | 4,925 | 1,471 | 1,189 |
-| \`button-group\` | 27,640 | 10,382 | 9,203 | 4,928 | 1,516 | 1,200 |
-| \`callout\` | 35,256 | 13,595 | 12,075 | 2,884 | 992 | 755 |
-| \`canvas\` | 108,483 | 34,750 | 30,372 | 68,927 | 20,973 | 17,537 |
-| \`card\` | 23,777 | 9,054 | 8,019 | 2,090 | 655 | 533 |
-| \`carousel\` | 42,748 | 15,234 | 13,597 | 15,006 | 4,215 | 3,340 |
-| \`chat\` | 79,390 | 26,446 | 23,395 | 27,455 | 8,116 | 6,412 |
-| \`checkbox\` | 40,374 | 13,681 | 12,203 | 3,107 | 979 | 623 |
-| \`checkbox-group\` | 47,602 | 15,599 | 13,900 | 8,325 | 2,351 | 1,714 |
-| \`code\` | 20,301 | 8,015 | 7,096 | 138 | 67 | 120 |
-| \`code-block\` | 102,738 | 34,890 | 30,820 | 36,843 | 10,785 | 8,779 |
-| \`color-input\` | 141,792 | 45,087 | 39,379 | 55,136 | 14,334 | 11,686 |
-| \`color-picker\` | 103,415 | 32,966 | 28,879 | 47,256 | 12,743 | 10,363 |
-| \`combobox\` | 132,023 | 41,951 | 36,909 | 35,791 | 9,112 | 7,182 |
-| \`command\` | 99,513 | 31,476 | 27,730 | 30,061 | 8,171 | 6,354 |
-| \`copy-button\` | 80,548 | 27,649 | 24,480 | 18,341 | 4,985 | 3,925 |
-| \`data-table\` | 199,900 | 61,428 | 52,577 | 89,488 | 23,783 | 19,098 |
-| \`date-input\` | 141,223 | 44,512 | 39,162 | 38,229 | 9,447 | 7,544 |
-| \`date-picker\` | 61,360 | 20,936 | 18,732 | 20,347 | 5,579 | 4,413 |
-| \`description-list\` | 22,900 | 8,765 | 7,766 | 1,565 | 525 | 315 |
-| \`dialog\` | 38,247 | 13,598 | 12,121 | 5,837 | 1,753 | 1,282 |
-| \`divider\` | 22,991 | 8,924 | 7,885 | 1,416 | 502 | 332 |
-| \`donut-chart\` | 89,212 | 31,127 | 27,512 | 14,641 | 4,497 | 3,675 |
-| \`drawer\` | 42,892 | 15,123 | 13,459 | 7,698 | 2,295 | 1,801 |
-| \`drilldown\` | 42,756 | 14,941 | 13,297 | 9,710 | 2,724 | 2,185 |
-| \`empty\` | 24,194 | 9,250 | 8,197 | 1,951 | 658 | 524 |
-| \`file-input\` | 57,757 | 20,019 | 17,823 | 13,094 | 4,155 | 3,295 |
-| \`filter-input\` | 97,846 | 32,819 | 29,091 | 21,630 | 6,198 | 4,871 |
-| \`format-date\` | 30,158 | 11,290 | 10,099 | 4,434 | 1,263 | 1,016 |
-| \`graph\` | 74,369 | 24,504 | 21,724 | 21,878 | 6,484 | 5,238 |
-| \`heatmap\` | 98,128 | 33,505 | 29,619 | 18,944 | 5,590 | 4,517 |
-| \`icon\` | 82,157 | 28,050 | 23,960 | 58,304 | 19,661 | 16,198 |
-| \`icon-button\` | 35,305 | 12,620 | 11,241 | 5,034 | 1,512 | 1,210 |
-| \`image\` | 25,504 | 9,480 | 8,414 | 3,824 | 1,152 | 926 |
-| \`input\` | 46,361 | 15,974 | 14,092 | 7,352 | 2,452 | 1,720 |
-| \`isometric-heatmap\` | 102,771 | 34,713 | 30,604 | 23,536 | 6,748 | 5,382 |
-| \`kbd\` | 27,511 | 10,570 | 9,362 | 3,516 | 1,152 | 782 |
-| \`legend\` | 35,184 | 12,935 | 11,492 | 2,957 | 1,019 | 866 |
-| \`lightbox\` | 55,724 | 18,818 | 16,720 | 16,730 | 4,692 | 3,628 |
-| \`line-chart\` | 91,335 | 31,880 | 28,291 | 14,762 | 4,418 | 3,664 |
-| \`list\` | 61,803 | 21,292 | 18,960 | 15,242 | 4,449 | 3,487 |
-| \`listbox\` | 76,711 | 25,427 | 22,454 | 15,565 | 4,585 | 3,539 |
-| \`loader\` | 26,379 | 10,041 | 8,932 | 2,775 | 969 | 755 |
-| \`map\` | 78,565 | 24,393 | 21,346 | 37,025 | 10,128 | 7,926 |
-| \`megamenu\` | 60,027 | 21,698 | 19,218 | 8,595 | 2,405 | 1,797 |
-| \`menu\` | 97,473 | 32,550 | 28,751 | 30,180 | 7,996 | 6,357 |
-| \`meter\` | 31,721 | 12,026 | 10,718 | 4,894 | 1,453 | 1,284 |
-| \`navigation\` | 33,088 | 12,436 | 11,050 | 3,366 | 1,183 | 976 |
-| \`notifications\` | 58,346 | 19,881 | 17,729 | 18,207 | 5,055 | 4,063 |
-| \`number-input\` | 56,271 | 18,839 | 16,812 | 13,524 | 3,662 | 2,797 |
-| \`object-inspector\` | 113,929 | 38,372 | 33,759 | 35,492 | 10,303 | 8,201 |
-| \`option\` | 26,477 | 9,763 | 8,661 | 4,525 | 1,231 | 1,101 |
-| \`outline\` | 33,612 | 12,598 | 11,180 | 7,856 | 2,569 | 1,910 |
-| \`pagination\` | 136,258 | 43,650 | 37,984 | 45,377 | 11,934 | 9,433 |
-| \`pin-input\` | 47,068 | 16,413 | 14,643 | 6,736 | 2,253 | 1,685 |
-| \`popover\` | 63,806 | 22,941 | 20,259 | 6,375 | 1,876 | 1,386 |
-| \`progress\` | 28,084 | 10,730 | 9,550 | 2,970 | 933 | 761 |
-| \`qr-code\` | 42,719 | 16,647 | 14,848 | 17,004 | 6,288 | 5,409 |
-| \`quote\` | 22,516 | 8,885 | 7,828 | 1,211 | 523 | 361 |
-| \`radio\` | 42,561 | 14,464 | 12,878 | 3,817 | 1,227 | 840 |
-| \`rating\` | 50,257 | 17,289 | 15,435 | 8,029 | 2,456 | 1,909 |
-| \`scatter-chart\` | 91,226 | 31,675 | 28,028 | 16,127 | 4,840 | 3,981 |
-| \`scroll-area\` | 30,430 | 11,079 | 9,814 | 8,499 | 2,602 | 2,062 |
-| \`select\` | 115,289 | 38,173 | 33,419 | 26,033 | 7,140 | 5,464 |
-| \`skeleton\` | 22,328 | 8,644 | 7,664 | 991 | 367 | 189 |
-| \`skip-link\` | 23,871 | 9,338 | 8,270 | 1,225 | 493 | 483 |
-| \`slider\` | 52,873 | 17,824 | 15,978 | 13,159 | 3,817 | 2,962 |
-| \`sparkline\` | 47,984 | 17,500 | 15,653 | 5,981 | 2,162 | 1,717 |
-| \`speed-dial\` | 68,751 | 24,718 | 21,887 | 10,915 | 2,990 | 2,427 |
-| \`splitter\` | 43,751 | 15,167 | 13,557 | 14,397 | 3,878 | 3,122 |
-| \`stat\` | 25,255 | 9,675 | 8,616 | 2,303 | 781 | 617 |
-| \`steps\` | 53,623 | 18,636 | 16,626 | 13,603 | 3,869 | 3,176 |
-| \`switch\` | 39,233 | 13,495 | 12,048 | 1,679 | 625 | 378 |
-| \`table\` | 118,358 | 37,061 | 32,243 | 45,150 | 12,475 | 10,199 |
-| \`tabs\` | 46,310 | 15,908 | 14,148 | 10,491 | 2,916 | 2,306 |
-| \`tag\` | 42,676 | 15,622 | 13,978 | 8,455 | 2,548 | 1,971 |
-| \`textarea\` | 43,852 | 14,941 | 13,327 | 5,402 | 1,622 | 1,252 |
-| \`time-input\` | 169,269 | 52,676 | 45,816 | 48,511 | 12,418 | 9,779 |
-| \`time-picker\` | 99,603 | 31,518 | 27,757 | 33,933 | 9,190 | 7,245 |
-| \`timeline\` | 31,286 | 11,863 | 10,579 | 4,061 | 1,260 | 1,031 |
-| \`toast\` | 50,871 | 17,940 | 16,004 | 12,124 | 3,529 | 2,773 |
-| \`toggle\` | 45,577 | 15,270 | 13,575 | 6,007 | 1,799 | 1,402 |
-| \`toolbar\` | 31,047 | 11,573 | 10,294 | 5,158 | 1,694 | 1,386 |
-| \`tooltip\` | 58,616 | 21,090 | 18,717 | 8,434 | 2,378 | 1,863 |
-| \`tour\` | 83,670 | 28,721 | 25,358 | 19,815 | 5,458 | 4,399 |
-| \`tree\` | 67,586 | 22,717 | 20,230 | 17,199 | 4,979 | 4,072 |
-| \`trend\` | 29,717 | 11,569 | 10,322 | 3,487 | 1,133 | 978 |
-| \`video\` | 141,208 | 44,138 | 38,547 | 66,217 | 16,841 | 13,726 |
-| \`video-playlist\` | 127,686 | 41,301 | 36,303 | 42,775 | 11,224 | 9,153 |
-| \`virtual-list\` | 63,451 | 21,632 | 19,223 | 23,305 | 7,171 | 5,823 |
+| \`accordion\` | 31,879 | 11,805 | 10,464 | 5,329 | 1,598 | 1,256 |
+| \`announcement\` | 36,692 | 13,313 | 11,854 | 4,682 | 1,425 | 1,118 |
+| \`app-header\` | 32,289 | 11,899 | 10,606 | 5,871 | 1,796 | 1,259 |
+| \`area-chart\` | 90,301 | 31,725 | 28,046 | 14,058 | 4,345 | 3,496 |
+| \`avatar\` | 30,463 | 11,596 | 10,369 | 3,957 | 1,234 | 973 |
+| \`badge\` | 27,088 | 10,568 | 9,410 | 2,942 | 920 | 756 |
+| \`bar-chart\` | 94,416 | 32,821 | 29,099 | 18,026 | 5,441 | 4,501 |
+| \`blockquote\` | 24,107 | 9,422 | 8,332 | 2,402 | 913 | 753 |
+| \`breadcrumbs\` | 36,279 | 13,906 | 12,382 | 7,360 | 2,452 | 1,974 |
+| \`button\` | 35,194 | 12,591 | 11,222 | 4,925 | 1,472 | 1,121 |
+| \`button-group\` | 27,640 | 10,382 | 9,200 | 4,928 | 1,517 | 1,109 |
+| \`callout\` | 35,256 | 13,593 | 12,058 | 2,884 | 992 | 726 |
+| \`canvas\` | 108,483 | 34,750 | 30,438 | 68,927 | 20,973 | 17,684 |
+| \`card\` | 23,777 | 9,054 | 8,019 | 2,090 | 655 | 525 |
+| \`carousel\` | 42,748 | 15,234 | 13,597 | 15,006 | 4,216 | 3,333 |
+| \`chat\` | 79,390 | 26,444 | 23,377 | 27,455 | 8,117 | 6,376 |
+| \`checkbox\` | 40,374 | 13,681 | 12,199 | 3,107 | 979 | 666 |
+| \`checkbox-group\` | 47,602 | 15,601 | 13,904 | 8,325 | 2,351 | 1,779 |
+| \`code\` | 20,301 | 8,015 | 7,121 | 138 | 67 | 44 |
+| \`code-block\` | 102,738 | 34,890 | 30,788 | 36,843 | 10,786 | 8,800 |
+| \`color-input\` | 141,792 | 45,087 | 39,341 | 55,136 | 14,334 | 11,510 |
+| \`color-picker\` | 103,415 | 32,966 | 28,881 | 47,256 | 12,743 | 10,241 |
+| \`combobox\` | 132,023 | 41,951 | 36,907 | 35,791 | 9,112 | 7,035 |
+| \`command\` | 99,513 | 31,476 | 27,708 | 30,061 | 8,171 | 6,363 |
+| \`copy-button\` | 80,548 | 27,649 | 24,490 | 18,341 | 4,985 | 3,998 |
+| \`data-table\` | 199,900 | 61,427 | 52,553 | 89,488 | 23,783 | 19,070 |
+| \`date-input\` | 141,223 | 44,512 | 39,113 | 38,229 | 9,448 | 7,610 |
+| \`date-picker\` | 61,360 | 20,936 | 18,750 | 20,347 | 5,579 | 4,382 |
+| \`description-list\` | 22,900 | 8,765 | 7,766 | 1,565 | 526 | 391 |
+| \`dialog\` | 38,247 | 13,598 | 12,117 | 5,837 | 1,753 | 1,446 |
+| \`divider\` | 22,991 | 8,924 | 7,882 | 1,416 | 502 | 425 |
+| \`donut-chart\` | 89,212 | 31,127 | 27,556 | 14,641 | 4,497 | 3,632 |
+| \`drawer\` | 42,892 | 15,123 | 13,469 | 7,698 | 2,296 | 1,835 |
+| \`drilldown\` | 42,756 | 14,941 | 13,297 | 9,710 | 2,724 | 2,066 |
+| \`empty\` | 24,194 | 9,251 | 8,200 | 1,951 | 658 | 530 |
+| \`file-input\` | 57,757 | 20,019 | 17,785 | 13,094 | 4,155 | 3,281 |
+| \`filter-input\` | 97,846 | 32,819 | 29,116 | 21,630 | 6,199 | 4,852 |
+| \`format-date\` | 30,158 | 11,290 | 10,090 | 4,434 | 1,264 | 1,089 |
+| \`graph\` | 74,369 | 24,504 | 21,641 | 21,878 | 6,485 | 5,288 |
+| \`heatmap\` | 98,128 | 33,505 | 29,605 | 18,944 | 5,590 | 4,462 |
+| \`icon\` | 82,157 | 28,050 | 23,959 | 58,304 | 19,662 | 16,121 |
+| \`icon-button\` | 35,305 | 12,620 | 11,230 | 5,034 | 1,513 | 1,165 |
+| \`image\` | 25,504 | 9,480 | 8,404 | 3,824 | 1,152 | 935 |
+| \`input\` | 46,361 | 15,974 | 14,090 | 7,352 | 2,452 | 1,865 |
+| \`isometric-heatmap\` | 102,771 | 34,713 | 30,595 | 23,536 | 6,749 | 5,398 |
+| \`kbd\` | 27,511 | 10,571 | 9,367 | 3,516 | 1,153 | 767 |
+| \`legend\` | 35,184 | 12,935 | 11,491 | 2,957 | 1,019 | 874 |
+| \`lightbox\` | 55,724 | 18,816 | 16,725 | 16,730 | 4,692 | 3,582 |
+| \`line-chart\` | 91,335 | 31,881 | 28,290 | 14,762 | 4,418 | 3,698 |
+| \`list\` | 61,803 | 21,294 | 18,983 | 15,242 | 4,449 | 3,619 |
+| \`listbox\` | 76,711 | 25,427 | 22,527 | 15,565 | 4,585 | 3,551 |
+| \`loader\` | 26,379 | 10,041 | 8,907 | 2,775 | 969 | 751 |
+| \`map\` | 78,565 | 24,393 | 21,288 | 37,025 | 10,128 | 7,955 |
+| \`megamenu\` | 60,027 | 21,698 | 19,183 | 8,595 | 2,405 | 1,778 |
+| \`menu\` | 97,473 | 32,550 | 28,767 | 30,180 | 7,996 | 6,383 |
+| \`meter\` | 31,721 | 12,026 | 10,721 | 4,894 | 1,453 | 1,182 |
+| \`navigation\` | 33,088 | 12,436 | 11,034 | 3,366 | 1,183 | 1,023 |
+| \`notifications\` | 58,346 | 19,881 | 17,738 | 18,207 | 5,056 | 4,000 |
+| \`number-input\` | 56,271 | 18,840 | 16,789 | 13,524 | 3,662 | 2,768 |
+| \`object-inspector\` | 113,929 | 38,372 | 33,717 | 35,492 | 10,304 | 8,250 |
+| \`option\` | 26,477 | 9,763 | 8,662 | 4,525 | 1,231 | 950 |
+| \`outline\` | 33,612 | 12,598 | 11,179 | 7,856 | 2,569 | 1,942 |
+| \`pagination\` | 136,258 | 43,650 | 37,953 | 45,377 | 11,934 | 9,415 |
+| \`pin-input\` | 47,068 | 16,413 | 14,653 | 6,736 | 2,253 | 1,741 |
+| \`popover\` | 63,806 | 22,941 | 20,256 | 6,375 | 1,876 | 1,363 |
+| \`progress\` | 28,084 | 10,730 | 9,551 | 2,970 | 933 | 720 |
+| \`qr-code\` | 42,719 | 16,647 | 14,847 | 17,004 | 6,288 | 5,382 |
+| \`quote\` | 22,516 | 8,884 | 7,827 | 1,211 | 523 | 417 |
+| \`radio\` | 42,561 | 14,464 | 12,878 | 3,817 | 1,228 | 898 |
+| \`rating\` | 50,257 | 17,289 | 15,409 | 8,029 | 2,456 | 1,870 |
+| \`scatter-chart\` | 91,226 | 31,676 | 27,942 | 16,127 | 4,840 | 3,890 |
+| \`scroll-area\` | 30,430 | 11,080 | 9,813 | 8,499 | 2,603 | 2,039 |
+| \`select\` | 115,289 | 38,173 | 33,481 | 26,033 | 7,140 | 5,395 |
+| \`skeleton\` | 22,328 | 8,644 | 7,666 | 991 | 368 | 296 |
+| \`skip-link\` | 23,871 | 9,338 | 8,264 | 1,225 | 494 | 424 |
+| \`slider\` | 52,873 | 17,826 | 15,978 | 13,159 | 3,818 | 3,037 |
+| \`sparkline\` | 47,984 | 17,499 | 15,601 | 5,981 | 2,162 | 1,764 |
+| \`speed-dial\` | 68,751 | 24,718 | 21,901 | 10,915 | 2,990 | 2,266 |
+| \`splitter\` | 43,751 | 15,167 | 13,536 | 14,397 | 3,878 | 3,176 |
+| \`stat\` | 25,255 | 9,675 | 8,601 | 2,303 | 781 | 544 |
+| \`steps\` | 53,623 | 18,635 | 16,567 | 13,603 | 3,870 | 3,086 |
+| \`switch\` | 39,233 | 13,495 | 12,047 | 1,679 | 625 | 379 |
+| \`table\` | 118,358 | 37,061 | 32,257 | 45,150 | 12,475 | 10,024 |
+| \`tabs\` | 46,310 | 15,908 | 14,160 | 10,491 | 2,916 | 2,259 |
+| \`tag\` | 42,676 | 15,620 | 13,972 | 8,455 | 2,548 | 1,991 |
+| \`textarea\` | 43,852 | 14,941 | 13,326 | 5,402 | 1,622 | 1,239 |
+| \`time-input\` | 169,269 | 52,676 | 45,872 | 48,511 | 12,418 | 9,739 |
+| \`time-picker\` | 99,603 | 31,518 | 27,772 | 33,933 | 9,190 | 7,206 |
+| \`timeline\` | 31,286 | 11,863 | 10,607 | 4,061 | 1,260 | 1,014 |
+| \`toast\` | 50,871 | 17,938 | 16,020 | 12,124 | 3,529 | 2,827 |
+| \`toggle\` | 45,577 | 15,270 | 13,576 | 6,007 | 1,799 | 1,392 |
+| \`toolbar\` | 31,047 | 11,573 | 10,294 | 5,158 | 1,695 | 1,249 |
+| \`tooltip\` | 58,616 | 21,090 | 18,705 | 8,434 | 2,379 | 1,908 |
+| \`tour\` | 83,670 | 28,722 | 25,339 | 19,815 | 5,459 | 4,255 |
+| \`tree\` | 67,586 | 22,718 | 20,230 | 17,199 | 4,980 | 4,023 |
+| \`trend\` | 29,717 | 11,569 | 10,337 | 3,487 | 1,134 | 913 |
+| \`video\` | 141,208 | 44,137 | 38,496 | 66,217 | 16,841 | 13,780 |
+| \`video-playlist\` | 127,686 | 41,301 | 36,338 | 42,775 | 11,225 | 9,072 |
+| \`virtual-list\` | 63,451 | 21,630 | 19,226 | 23,305 | 7,171 | 5,779 |
 
 ### Styled tier
 
@@ -4486,112 +4583,112 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
 
 | Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
 |---|---|---|---|---|---|---|
-| \`accordion\` | 35,311 | 12,654 | 11,240 | 8,746 | 2,463 | 1,948 |
-| \`announcement\` | 41,307 | 14,365 | 12,832 | 9,278 | 2,489 | 2,024 |
-| \`app-header\` | 37,449 | 13,103 | 11,682 | 11,016 | 3,009 | 2,469 |
-| \`area-chart\` | 98,393 | 33,578 | 29,732 | 22,131 | 6,256 | 5,102 |
-| \`aura\` | 56,085 | 19,320 | 17,131 | 29,774 | 9,335 | 7,842 |
-| \`avatar\` | 33,464 | 12,351 | 11,026 | 6,945 | 2,007 | 1,688 |
-| \`badge\` | 32,595 | 11,821 | 10,551 | 8,438 | 2,177 | 1,852 |
-| \`bar-chart\` | 108,944 | 35,724 | 31,549 | 32,533 | 8,394 | 6,916 |
-| \`blockquote\` | 26,332 | 9,969 | 8,821 | 4,612 | 1,452 | 1,093 |
-| \`breadcrumbs\` | 43,220 | 15,115 | 13,527 | 14,285 | 3,697 | 2,939 |
-| \`button\` | 41,612 | 14,007 | 12,463 | 11,324 | 2,907 | 2,360 |
-| \`button-group\` | 31,138 | 11,066 | 9,809 | 8,409 | 2,229 | 1,770 |
-| \`callout\` | 39,049 | 14,537 | 12,921 | 6,659 | 1,950 | 1,613 |
-| \`canvas\` | 129,523 | 38,717 | 33,827 | 89,611 | 24,897 | 20,993 |
-| \`card\` | 27,678 | 10,059 | 8,913 | 5,976 | 1,650 | 1,408 |
-| \`carousel\` | 53,234 | 17,022 | 15,257 | 25,477 | 6,037 | 4,920 |
-| \`chat\` | 94,674 | 29,166 | 25,830 | 42,730 | 10,859 | 8,815 |
-| \`checkbox\` | 46,865 | 15,190 | 13,511 | 9,580 | 2,503 | 2,019 |
-| \`checkbox-group\` | 54,826 | 17,244 | 15,372 | 15,542 | 4,028 | 3,157 |
-| \`code\` | 21,154 | 8,333 | 7,402 | 976 | 399 | 408 |
-| \`code-block\` | 127,213 | 38,715 | 34,182 | 61,300 | 14,740 | 12,131 |
-| \`color-input\` | 184,176 | 51,349 | 44,929 | 97,504 | 20,559 | 17,115 |
-| \`color-picker\` | 140,348 | 38,508 | 33,859 | 84,177 | 18,389 | 15,176 |
-| \`combobox\` | 147,503 | 44,927 | 39,520 | 51,254 | 12,085 | 9,797 |
-| \`command\` | 110,791 | 33,835 | 29,771 | 41,332 | 10,522 | 8,516 |
-| \`copy-button\` | 92,577 | 29,825 | 26,383 | 30,355 | 7,219 | 5,878 |
-| \`data-table\` | 230,715 | 66,817 | 57,261 | 120,282 | 29,305 | 23,835 |
-| \`date-input\` | 162,349 | 48,216 | 42,392 | 59,336 | 13,196 | 10,800 |
-| \`date-picker\` | 69,281 | 22,363 | 20,013 | 28,250 | 7,010 | 5,726 |
-| \`description-list\` | 25,855 | 9,517 | 8,469 | 4,508 | 1,284 | 1,109 |
-| \`dialog\` | 43,360 | 14,855 | 13,245 | 10,933 | 3,007 | 2,524 |
-| \`divider\` | 25,291 | 9,547 | 8,464 | 3,699 | 1,140 | 979 |
-| \`donut-chart\` | 99,170 | 33,263 | 29,387 | 24,576 | 6,712 | 5,497 |
-| \`drawer\` | 48,725 | 16,508 | 14,719 | 13,512 | 3,708 | 3,050 |
-| \`drilldown\` | 48,438 | 16,235 | 14,490 | 15,378 | 4,052 | 3,224 |
-| \`empty\` | 25,503 | 9,727 | 8,607 | 3,242 | 1,117 | 942 |
-| \`file-input\` | 69,285 | 22,419 | 19,935 | 24,612 | 6,551 | 5,415 |
-| \`filter-input\` | 108,688 | 34,991 | 31,031 | 32,465 | 8,412 | 6,840 |
-| \`flex\` | 25,740 | 9,194 | 8,157 | 4,763 | 1,047 | 878 |
-| \`format-date\` | 30,414 | 11,403 | 10,198 | 4,672 | 1,402 | 1,107 |
-| \`graph\` | 89,037 | 27,081 | 23,844 | 36,528 | 9,184 | 7,506 |
-| \`grid\` | 27,002 | 9,846 | 8,741 | 5,638 | 1,467 | 1,230 |
-| \`heatmap\` | 105,486 | 35,189 | 31,061 | 26,281 | 7,263 | 5,865 |
-| \`icon\` | 83,995 | 28,567 | 24,453 | 60,129 | 20,177 | 16,557 |
-| \`icon-button\` | 43,040 | 13,981 | 12,453 | 12,753 | 2,882 | 2,317 |
-| \`image\` | 26,892 | 9,947 | 8,821 | 5,194 | 1,620 | 1,303 |
-| \`input\` | 50,619 | 17,063 | 15,045 | 11,597 | 3,559 | 2,627 |
-| \`isometric-heatmap\` | 110,852 | 36,558 | 32,275 | 31,598 | 8,642 | 6,913 |
-| \`kbd\` | 29,504 | 11,110 | 9,797 | 5,494 | 1,685 | 1,325 |
-| \`legend\` | 40,423 | 14,214 | 12,625 | 8,067 | 2,264 | 1,810 |
-| \`lightbox\` | 62,016 | 20,155 | 17,963 | 23,006 | 6,017 | 4,593 |
-| \`line-chart\` | 102,454 | 34,257 | 30,346 | 25,863 | 6,849 | 5,573 |
-| \`list\` | 68,150 | 22,816 | 20,329 | 21,569 | 5,958 | 4,723 |
-| \`listbox\` | 81,154 | 26,542 | 23,438 | 19,994 | 5,703 | 4,506 |
-| \`loader\` | 29,263 | 10,814 | 9,634 | 5,642 | 1,730 | 1,484 |
-| \`map\` | 111,513 | 29,575 | 25,965 | 69,961 | 15,526 | 12,613 |
-| \`megamenu\` | 64,996 | 22,865 | 20,221 | 13,547 | 3,558 | 2,865 |
-| \`menu\` | 108,403 | 34,711 | 30,637 | 41,098 | 10,160 | 8,348 |
-| \`meter\` | 37,896 | 13,378 | 11,969 | 11,050 | 2,820 | 2,508 |
-| \`navigation\` | 36,814 | 13,268 | 11,785 | 7,077 | 2,025 | 1,732 |
-| \`notifications\` | 71,808 | 22,446 | 20,037 | 31,663 | 7,637 | 6,298 |
-| \`number-input\` | 61,253 | 20,024 | 17,839 | 18,491 | 4,850 | 3,805 |
-| \`object-inspector\` | 130,338 | 41,206 | 36,260 | 51,884 | 13,190 | 10,875 |
-| \`option\` | 29,672 | 10,762 | 9,549 | 7,712 | 2,213 | 1,807 |
-| \`orb\` | 35,265 | 13,488 | 12,001 | 9,730 | 3,689 | 3,210 |
-| \`outline\` | 37,846 | 13,459 | 11,935 | 12,073 | 3,491 | 2,776 |
-| \`pagination\` | 153,264 | 46,929 | 40,875 | 62,366 | 15,240 | 12,294 |
-| \`pin-input\` | 50,409 | 17,317 | 15,440 | 10,058 | 3,179 | 2,506 |
-| \`popover\` | 66,958 | 23,702 | 20,976 | 9,509 | 2,658 | 2,152 |
-| \`progress\` | 35,232 | 12,381 | 11,032 | 10,101 | 2,602 | 2,208 |
-| \`qr-code\` | 44,321 | 17,121 | 15,244 | 18,589 | 6,787 | 5,692 |
-| \`quote\` | 23,074 | 9,079 | 8,002 | 1,752 | 733 | 550 |
-| \`radio\` | 50,349 | 15,977 | 14,212 | 11,594 | 2,766 | 2,188 |
-| \`rating\` | 54,190 | 18,519 | 16,487 | 11,946 | 3,671 | 2,932 |
-| \`sandbox\` | 104,428 | 31,484 | 27,587 | 72,147 | 19,289 | 16,253 |
-| \`scatter-chart\` | 100,317 | 33,784 | 29,846 | 25,197 | 6,982 | 5,634 |
-| \`scroll-area\` | 35,437 | 12,025 | 10,693 | 13,489 | 3,582 | 2,900 |
-| \`select\` | 124,418 | 40,070 | 35,154 | 35,147 | 9,067 | 7,122 |
-| \`skeleton\` | 26,090 | 9,664 | 8,592 | 4,738 | 1,432 | 1,201 |
-| \`skip-link\` | 25,441 | 9,852 | 8,716 | 2,780 | 983 | 749 |
-| \`slider\` | 67,842 | 20,140 | 18,033 | 28,108 | 6,184 | 4,977 |
-| \`sparkline\` | 53,442 | 18,851 | 16,828 | 11,421 | 3,519 | 2,958 |
-| \`speed-dial\` | 75,797 | 26,105 | 23,156 | 17,946 | 4,404 | 3,565 |
-| \`splitter\` | 49,804 | 16,210 | 14,530 | 20,431 | 4,937 | 3,943 |
-| \`stat\` | 28,117 | 10,372 | 9,251 | 5,157 | 1,482 | 1,256 |
-| \`steps\` | 67,449 | 21,378 | 19,029 | 27,416 | 6,635 | 5,427 |
-| \`strands\` | 62,138 | 23,148 | 20,404 | 38,015 | 13,797 | 11,914 |
-| \`switch\` | 43,562 | 14,637 | 13,013 | 5,998 | 1,792 | 1,411 |
-| \`table\` | 135,900 | 40,155 | 34,939 | 62,687 | 15,581 | 12,729 |
-| \`tabs\` | 55,263 | 17,753 | 15,836 | 19,437 | 4,783 | 3,907 |
-| \`tag\` | 47,247 | 16,758 | 14,982 | 13,016 | 3,658 | 2,984 |
-| \`text\` | 28,756 | 9,943 | 8,757 | 7,396 | 1,519 | 1,309 |
-| \`textarea\` | 47,785 | 15,949 | 14,227 | 9,318 | 2,677 | 2,198 |
-| \`time-input\` | 193,597 | 56,836 | 49,498 | 72,824 | 16,646 | 13,607 |
-| \`time-picker\` | 111,928 | 33,946 | 29,852 | 46,251 | 11,627 | 9,388 |
-| \`timeline\` | 38,179 | 13,326 | 11,920 | 10,947 | 2,751 | 2,253 |
-| \`toast\` | 58,767 | 19,783 | 17,643 | 20,006 | 5,408 | 4,355 |
-| \`toggle\` | 50,439 | 16,510 | 14,669 | 10,854 | 3,077 | 2,499 |
-| \`toolbar\` | 33,726 | 12,066 | 10,715 | 7,822 | 2,163 | 1,631 |
-| \`tooltip\` | 61,420 | 21,833 | 19,384 | 11,220 | 3,137 | 2,532 |
-| \`tour\` | 93,661 | 30,695 | 27,192 | 29,787 | 7,497 | 6,082 |
-| \`tree\` | 76,275 | 24,651 | 21,953 | 25,874 | 6,942 | 5,599 |
-| \`trend\` | 31,231 | 12,050 | 10,723 | 4,982 | 1,613 | 1,250 |
-| \`video\` | 161,715 | 47,866 | 41,751 | 86,712 | 20,444 | 17,161 |
-| \`video-playlist\` | 143,639 | 44,279 | 38,910 | 58,709 | 14,189 | 11,730 |
-| \`virtual-list\` | 65,445 | 22,136 | 19,637 | 25,282 | 7,676 | 6,296 |
+| \`accordion\` | 35,311 | 12,654 | 11,236 | 8,746 | 2,463 | 2,016 |
+| \`announcement\` | 41,307 | 14,365 | 12,844 | 9,278 | 2,489 | 2,072 |
+| \`app-header\` | 37,449 | 13,103 | 11,682 | 11,016 | 3,009 | 2,472 |
+| \`area-chart\` | 98,393 | 33,578 | 29,681 | 22,131 | 6,257 | 5,070 |
+| \`aura\` | 56,085 | 19,320 | 17,108 | 29,774 | 9,336 | 7,876 |
+| \`avatar\` | 33,464 | 12,351 | 11,051 | 6,945 | 2,007 | 1,646 |
+| \`badge\` | 32,595 | 11,820 | 10,538 | 8,438 | 2,178 | 1,772 |
+| \`bar-chart\` | 108,944 | 35,724 | 31,572 | 32,533 | 8,394 | 6,852 |
+| \`blockquote\` | 26,332 | 9,968 | 8,824 | 4,612 | 1,452 | 1,178 |
+| \`breadcrumbs\` | 43,220 | 15,115 | 13,467 | 14,285 | 3,698 | 3,040 |
+| \`button\` | 41,612 | 14,007 | 12,440 | 11,324 | 2,908 | 2,298 |
+| \`button-group\` | 31,138 | 11,066 | 9,842 | 8,409 | 2,230 | 1,782 |
+| \`callout\` | 39,049 | 14,535 | 12,913 | 6,659 | 1,950 | 1,513 |
+| \`canvas\` | 129,523 | 38,717 | 33,888 | 89,611 | 24,897 | 20,996 |
+| \`card\` | 27,678 | 10,060 | 8,915 | 5,976 | 1,650 | 1,334 |
+| \`carousel\` | 53,234 | 17,022 | 15,255 | 25,477 | 6,038 | 4,870 |
+| \`chat\` | 94,674 | 29,164 | 25,829 | 42,730 | 10,860 | 8,790 |
+| \`checkbox\` | 46,865 | 15,190 | 13,517 | 9,580 | 2,503 | 1,944 |
+| \`checkbox-group\` | 54,826 | 17,245 | 15,350 | 15,542 | 4,028 | 3,246 |
+| \`code\` | 21,154 | 8,331 | 7,402 | 976 | 400 | 302 |
+| \`code-block\` | 127,213 | 38,714 | 34,143 | 61,300 | 14,740 | 12,197 |
+| \`color-input\` | 184,176 | 51,348 | 44,906 | 97,504 | 20,559 | 17,123 |
+| \`color-picker\` | 140,348 | 38,508 | 33,798 | 84,177 | 18,390 | 15,111 |
+| \`combobox\` | 147,503 | 44,927 | 39,521 | 51,254 | 12,086 | 9,732 |
+| \`command\` | 110,791 | 33,835 | 29,865 | 41,332 | 10,522 | 8,578 |
+| \`copy-button\` | 92,577 | 29,825 | 26,415 | 30,355 | 7,220 | 5,816 |
+| \`data-table\` | 230,715 | 66,817 | 57,250 | 120,282 | 29,305 | 23,909 |
+| \`date-input\` | 162,349 | 48,215 | 42,382 | 59,336 | 13,196 | 10,914 |
+| \`date-picker\` | 69,281 | 22,363 | 20,060 | 28,250 | 7,010 | 5,696 |
+| \`description-list\` | 25,855 | 9,517 | 8,456 | 4,508 | 1,284 | 1,066 |
+| \`dialog\` | 43,360 | 14,855 | 13,244 | 10,933 | 3,007 | 2,429 |
+| \`divider\` | 25,291 | 9,547 | 8,433 | 3,699 | 1,141 | 848 |
+| \`donut-chart\` | 99,170 | 33,263 | 29,421 | 24,576 | 6,712 | 5,519 |
+| \`drawer\` | 48,725 | 16,508 | 14,718 | 13,512 | 3,708 | 3,022 |
+| \`drilldown\` | 48,438 | 16,235 | 14,465 | 15,378 | 4,052 | 3,152 |
+| \`empty\` | 25,503 | 9,726 | 8,598 | 3,242 | 1,118 | 869 |
+| \`file-input\` | 69,285 | 22,419 | 19,892 | 24,612 | 6,551 | 5,311 |
+| \`filter-input\` | 108,688 | 34,991 | 31,014 | 32,465 | 8,412 | 6,809 |
+| \`flex\` | 25,740 | 9,195 | 8,149 | 4,763 | 1,048 | 935 |
+| \`format-date\` | 30,414 | 11,403 | 10,189 | 4,672 | 1,402 | 1,046 |
+| \`graph\` | 89,037 | 27,080 | 23,910 | 36,528 | 9,184 | 7,482 |
+| \`grid\` | 27,002 | 9,846 | 8,742 | 5,638 | 1,467 | 1,298 |
+| \`heatmap\` | 105,486 | 35,189 | 31,084 | 26,281 | 7,264 | 5,828 |
+| \`icon\` | 83,995 | 28,566 | 24,453 | 60,129 | 20,178 | 16,509 |
+| \`icon-button\` | 43,040 | 13,981 | 12,435 | 12,753 | 2,883 | 2,232 |
+| \`image\` | 26,892 | 9,947 | 8,805 | 5,194 | 1,621 | 1,269 |
+| \`input\` | 50,619 | 17,063 | 15,053 | 11,597 | 3,559 | 2,712 |
+| \`isometric-heatmap\` | 110,852 | 36,559 | 32,285 | 31,598 | 8,642 | 6,875 |
+| \`kbd\` | 29,504 | 11,109 | 9,839 | 5,494 | 1,685 | 1,317 |
+| \`legend\` | 40,423 | 14,214 | 12,618 | 8,067 | 2,264 | 1,748 |
+| \`lightbox\` | 62,016 | 20,155 | 17,964 | 23,006 | 6,017 | 4,675 |
+| \`line-chart\` | 102,454 | 34,257 | 30,348 | 25,863 | 6,850 | 5,597 |
+| \`list\` | 68,150 | 22,816 | 20,364 | 21,569 | 5,958 | 4,789 |
+| \`listbox\` | 81,154 | 26,542 | 23,415 | 19,994 | 5,704 | 4,449 |
+| \`loader\` | 29,263 | 10,814 | 9,643 | 5,642 | 1,730 | 1,434 |
+| \`map\` | 111,513 | 29,575 | 25,972 | 69,961 | 15,526 | 12,713 |
+| \`megamenu\` | 64,996 | 22,865 | 20,223 | 13,547 | 3,559 | 2,740 |
+| \`menu\` | 108,403 | 34,711 | 30,660 | 41,098 | 10,160 | 8,328 |
+| \`meter\` | 37,896 | 13,378 | 11,948 | 11,050 | 2,821 | 2,509 |
+| \`navigation\` | 36,814 | 13,270 | 11,770 | 7,077 | 2,025 | 1,715 |
+| \`notifications\` | 71,808 | 22,447 | 20,022 | 31,663 | 7,637 | 6,268 |
+| \`number-input\` | 61,253 | 20,024 | 17,821 | 18,491 | 4,851 | 3,791 |
+| \`object-inspector\` | 130,338 | 41,206 | 36,213 | 51,884 | 13,191 | 10,671 |
+| \`option\` | 29,672 | 10,762 | 9,552 | 7,712 | 2,214 | 1,720 |
+| \`orb\` | 35,265 | 13,489 | 12,038 | 9,730 | 3,690 | 3,222 |
+| \`outline\` | 37,846 | 13,459 | 11,946 | 12,073 | 3,491 | 2,636 |
+| \`pagination\` | 153,264 | 46,929 | 40,896 | 62,366 | 15,241 | 12,287 |
+| \`pin-input\` | 50,409 | 17,316 | 15,449 | 10,058 | 3,179 | 2,491 |
+| \`popover\` | 66,958 | 23,702 | 20,940 | 9,509 | 2,658 | 2,163 |
+| \`progress\` | 35,232 | 12,380 | 11,030 | 10,101 | 2,602 | 2,356 |
+| \`qr-code\` | 44,321 | 17,121 | 15,249 | 18,589 | 6,787 | 5,728 |
+| \`quote\` | 23,074 | 9,080 | 8,006 | 1,752 | 733 | 537 |
+| \`radio\` | 50,349 | 15,977 | 14,203 | 11,594 | 2,766 | 2,266 |
+| \`rating\` | 54,190 | 18,519 | 16,485 | 11,946 | 3,671 | 2,845 |
+| \`sandbox\` | 104,428 | 31,484 | 27,584 | 72,147 | 19,289 | 16,159 |
+| \`scatter-chart\` | 100,317 | 33,785 | 29,872 | 25,197 | 6,983 | 5,655 |
+| \`scroll-area\` | 35,437 | 12,027 | 10,679 | 13,489 | 3,583 | 2,910 |
+| \`select\` | 124,418 | 40,070 | 35,132 | 35,147 | 9,068 | 7,080 |
+| \`skeleton\` | 26,090 | 9,664 | 8,589 | 4,738 | 1,433 | 1,190 |
+| \`skip-link\` | 25,441 | 9,851 | 8,690 | 2,780 | 983 | 753 |
+| \`slider\` | 67,842 | 20,140 | 17,971 | 28,108 | 6,184 | 5,029 |
+| \`sparkline\` | 53,442 | 18,851 | 16,851 | 11,421 | 3,520 | 2,874 |
+| \`speed-dial\` | 75,797 | 26,105 | 23,131 | 17,946 | 4,405 | 3,556 |
+| \`splitter\` | 49,804 | 16,210 | 14,531 | 20,431 | 4,937 | 4,060 |
+| \`stat\` | 28,117 | 10,372 | 9,280 | 5,157 | 1,483 | 1,178 |
+| \`steps\` | 67,449 | 21,378 | 19,083 | 27,416 | 6,636 | 5,388 |
+| \`strands\` | 62,138 | 23,148 | 20,396 | 38,015 | 13,797 | 11,925 |
+| \`switch\` | 43,562 | 14,638 | 13,007 | 5,998 | 1,793 | 1,392 |
+| \`table\` | 135,900 | 40,155 | 34,974 | 62,687 | 15,581 | 12,853 |
+| \`tabs\` | 55,263 | 17,753 | 15,846 | 19,437 | 4,783 | 3,864 |
+| \`tag\` | 47,247 | 16,757 | 14,968 | 13,016 | 3,658 | 2,940 |
+| \`text\` | 28,756 | 9,943 | 8,755 | 7,396 | 1,519 | 1,260 |
+| \`textarea\` | 47,785 | 15,949 | 14,227 | 9,318 | 2,678 | 2,149 |
+| \`time-input\` | 193,597 | 56,836 | 49,480 | 72,824 | 16,646 | 13,626 |
+| \`time-picker\` | 111,928 | 33,946 | 29,873 | 46,251 | 11,628 | 9,402 |
+| \`timeline\` | 38,179 | 13,326 | 11,921 | 10,947 | 2,752 | 2,268 |
+| \`toast\` | 58,767 | 19,781 | 17,659 | 20,006 | 5,409 | 4,346 |
+| \`toggle\` | 50,439 | 16,509 | 14,668 | 10,854 | 3,077 | 2,473 |
+| \`toolbar\` | 33,726 | 12,066 | 10,723 | 7,822 | 2,163 | 1,725 |
+| \`tooltip\` | 61,420 | 21,833 | 19,329 | 11,220 | 3,137 | 2,506 |
+| \`tour\` | 93,661 | 30,696 | 27,131 | 29,787 | 7,498 | 5,974 |
+| \`tree\` | 76,275 | 24,651 | 21,957 | 25,874 | 6,943 | 5,657 |
+| \`trend\` | 31,231 | 12,050 | 10,722 | 4,982 | 1,613 | 1,353 |
+| \`video\` | 161,715 | 47,866 | 41,770 | 86,712 | 20,444 | 16,964 |
+| \`video-playlist\` | 143,639 | 44,278 | 38,906 | 58,709 | 14,190 | 11,656 |
+| \`virtual-list\` | 65,445 | 22,136 | 19,690 | 25,282 | 7,676 | 6,226 |
 
 ## What an install adds to \`node_modules\`
 
@@ -4603,12 +4700,12 @@ stripped column shows the bytes we removed.
 
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
-| \`@fusion.dev/helix-core\` | 2,561,244 | 559 | 727,996 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\`, \`tslib\` |
-| \`@fusion.dev/helix-headless\` | 22,147,132 | 714 | 2,256,499 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`tslib\`, \`uqr\` |
+| \`@fusion.dev/helix-core\` | 2,560,950 | 559 | 727,994 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\`, \`tslib\` |
+| \`@fusion.dev/helix-headless\` | 25,355,390 | 716 | 2,256,500 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`tslib\`, \`uqr\` |
 | \`@fusion.dev/helix-icons\` | 150,509 | 21 | 48,154 | \`svgo\` |
 | \`@fusion.dev/helix-styles\` | 121,089 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 529,299 | 8 | 5,393 | none |
-| \`@fusion.dev/helix\` | 22,136,770 | 966 | 539,177 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\`, \`tslib\` |
+| \`@fusion.dev/helix\` | 26,659,493 | 969 | 539,178 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\`, \`tslib\` |
 
 ## Not measured yet
 
@@ -7652,7 +7749,7 @@ type needs less leading. \`--helix-leading-heading\` expresses that once, so no
 heading level needs its own multiplier.
 `,
     'using-helix-with-an-agent': `---
-description: Four mistakes that look like Helix bugs, and the files an agent should read.
+description: Five mistakes that look like Helix bugs, and the files an agent should read.
 parent: coding-agents
 section: Getting started
 title: Using Helix with an agent
@@ -7661,58 +7758,63 @@ title: Using Helix with an agent
 
 # Using Helix with an agent
 
-**We publish this guide as a web page so that every tool can read it.** It began
-as \`.claude/skills/using-helix/SKILL.md\`, a file format that one vendor reads in
-a repository. Every other vendor reads its own file:
-
-- Cursor reads \`.cursor/rules\`.
-- Copilot reads \`.github/copilot-instructions.md\`.
+This guide is in two places, and both say the same thing:
 
-If you install the published packages, you have none of these files. You have
-this site and no checkout of our repository.
+- this page, which [llms.txt](https://fusion.dev/llms.txt) indexes
+- \`skills/helix/SKILL.md\` inside \`@fusion.dev/helix\`, which matches the version
+  you installed and works offline
 
-So the guide lives in one place, here, at a URL that
-[llms.txt](https://fusion.dev/llms.txt) indexes and that each of those files can
-link to. Paste the link into the file your tool reads. [The MCP
-server](./coding-agents) works with any vendor and runs code, and Claude,
-Cursor, Windsurf, and Zed all support it.
+[Link your tool to this guide](#link-your-tool-to-this-guide) says how to point
+each tool at one of them. [The MCP server](./coding-agents) works with any
+vendor and runs code, and Claude, Cursor, Windsurf, and Zed all support it.
 
-## Read the manifest before writing a tag
+## Read the family before writing its tags
 
 \`\`\`
-https://fusion.dev/helix/custom-elements.json
-@fusion.dev/helix/custom-elements.json
+https://fusion.dev/helix/components/<family>.md
+https://fusion.dev/helix/components/<family>.json
 \`\`\`
 
-The manifest lists:
+Each family's file lists:
 
+- the import lines for the family
 - every tag
 - every property, with its literal union
-- every event, with its class
+- every event, with its class and its React prop
 - every slot, part, and custom property
+- the examples, each with the import lines it needs
 
-**If a tag is not in the manifest, it does not exist.** A property value outside
-a declared union is invalid. Property types are literal unions for this reason.
-\`'ghost' | 'outlined' | 'solid' | 'subtle'\` shows you the values, and a named
-type such as \`ButtonEmphasis\` sends you somewhere else to find them.
+**If a tag is not in a family's file, it does not exist.** A property value
+outside a declared union is invalid. Property types are literal unions for this
+reason. \`'ghost' | 'outlined' | 'solid' | 'subtle'\` shows you the values, and a
+named type such as \`ButtonEmphasis\` sends you somewhere else to find them.
 
-When you need one family, fetch it as data:
+The manifest at \`https://fusion.dev/helix/custom-elements.json\` holds every
+family in one file, which is several megabytes. Read the families you use.
+Start from \`https://fusion.dev/llms.txt\`. In one request, it names every
+document and the machine-readable sources.
 
-\`\`\`
-https://fusion.dev/helix/components/<family>.json
-https://fusion.dev/helix/components/<family>.md
-\`\`\`
-
-The \`.md\` file has the API tables and the examples. The HTML page leaves the
-examples out on purpose. Start from \`https://fusion.dev/llms.txt\`. In one
-request, it names every document and these two sources.
-
-## Four mistakes that look like Helix bugs
+## Five mistakes that look like Helix bugs
 
 Each of these looks like a bug in Helix. They are listed from the most common to
 the least common.
 
-### 1. Blocking a change without \`preventDefault()\`
+### 1. Writing a tag without importing its family
+
+Each tag needs its family's entry imported. A family does not register another
+family's elements that you write inside it, so a Select needs Option imported
+beside it, and a Data Table needs Table:
+
+\`\`\`js
+import '@fusion.dev/helix/select'
+import '@fusion.dev/helix/option'
+\`\`\`
+
+Without the second line, the options are unknown elements and the Select offers
+nothing. Each family's Usage block and each example list the lines to import.
+Copy them with the markup.
+
+### 2. Blocking a change without \`preventDefault()\`
 
 **Setting \`value\`, \`open\`, \`checked\`, or \`active\` sets the starting state and
 corrects the current state.** The element starts in that state and then applies
@@ -7744,7 +7846,7 @@ block a change, call \`preventDefault()\` on the matching \`helix-before-*\` eve
 A form reset returns the element to \`default-value\` and the matching attributes
 for the other states. See [State and control](./state-and-control).
 
-### 2. Using the exact event name
+### 3. Using the exact event name
 
 In React, write \`onhelix-before-open\`. \`onHelixOpen\` and \`onOpen\` do not work.
 React removes \`on\` from the prop name and listens for exactly the rest, so the
@@ -7758,7 +7860,7 @@ so a menu closing inside a dialog does not close the dialog. \`helix-select\`,
 listen for them on a container. If a listener on a wrapper receives nothing, the
 event is a lifecycle event. Put the listener on the element.
 
-### 3. Styling a disabled control with \`:disabled\`
+### 4. Styling a disabled control with \`:disabled\`
 
 \`\`\`css
 helix-input:disabled { … }   /* right: matches a disabled fieldset too */
@@ -7769,7 +7871,7 @@ The browser disables a control inside \`<fieldset disabled>\` without adding an
 attribute to it. The \`[disabled]\` selector does not match it, so the control
 looks enabled while it does not accept input.
 
-### 4. Loading every style layer before the elements
+### 5. Loading every style layer before the elements
 
 \`\`\`ts
 import '@fusion.dev/helix-styles/helix.css'
@@ -7865,20 +7967,28 @@ If you are adding a script to a recipe, use the component.
 
 ## Link your tool to this guide
 
-**Link to this page from your instructions file, and do not copy it.** Each tool
-that reads project instructions reads a file in your repository, and each tool
-reads a different one. A copy starts to go stale as soon as you paste it, and
-this page changes with the library.
+**Point your tool at the guide, and do not copy it.** A copy starts to go stale
+as soon as you paste it, and the guide changes with the library.
+
+The skill in the package matches the Helix you installed. In Claude Code, link
+it into your project's skills folder:
+
+\`\`\`sh
+mkdir -p .claude/skills
+ln -s ../../node_modules/@fusion.dev/helix/skills/helix .claude/skills/helix
+\`\`\`
+
+Other tools read a file in your repository. Add a line to it that names the
+skill, or this page:
 
 \`\`\`md
-Helix: read https://fusion.dev/helix/docs/using-helix-with-an-agent
-before writing components, and https://fusion.dev/helix/custom-elements.json
-for the API.
+Helix: read node_modules/@fusion.dev/helix/skills/helix/SKILL.md before
+writing components, and node_modules/@fusion.dev/helix/api.json for the API.
 \`\`\`
 
 | Tool | Where it goes |
 |---|---|
-| Claude Code | \`AGENTS.md\` or \`CLAUDE.md\`, or a skill in \`.claude/skills/\` |
+| Claude Code | \`.claude/skills/helix\`, or a line in \`AGENTS.md\` or \`CLAUDE.md\` |
 | Cursor | \`.cursor/rules/\` |
 | GitHub Copilot | \`.github/copilot-instructions.md\` |
 | Anything else | Whatever it reads. The line is the same |
@@ -7886,22 +7996,19 @@ for the API.
 We do not write those files for you, and we chose this on purpose. You would
 have to maintain a file we generated in your repository against our changes. A
 tool that rewrote it on install would be a dependency you did not ask for, in a
-directory you own. You paste the line above, and you can delete it.
+directory you own. You add the link or the line, and you can delete it.
 
 ## Install the Helix MCP server
 
-\`\`\`json
-{
-  "mcpServers": {
-    "helix": { "command": "helix", "args": ["mcp"] }
-  }
-}
+\`\`\`sh
+helix mcp init --client claude
 \`\`\`
 
-\`helix mcp\` is a subcommand of the CLI. It serves MCP over stdio, which Claude,
-Cursor, Windsurf, and Zed all read. It computes the theme a given brand color
-produces, which no document can list. It runs on your machine, talks to a client
-you chose, and makes no network requests.
+\`helix mcp\` answers from the Helix packages your project installs: families,
+examples, import lines, tokens, and the theme a brand color produces. \`--client\`
+takes \`claude\`, \`cursor\`, or \`vscode\`, and writes the server into the file that
+client reads. [Coding agents](./coding-agents) lists the tools. It runs on your
+machine, talks to a client you chose, and makes no network requests.
 
 ## What this guide does not cover
 
@@ -7909,10 +8016,9 @@ you chose, and makes no network requests.
 and hooks change with the library, and they are in a file you can fetch. A list
 of them here would be a second copy that goes stale. Fetch the family.
 
-**The theme a brand color produces.** Helix computes it, so use \`helix mcp\`, an
-MCP server over stdio with \`helix_audit_theme\` and \`helix_derive_theme\`. Both
-take the same JSON that a \`helix.theme.json\` file holds. It runs on your
-machine, and we do not host it.
+**The theme a brand color produces.** Helix computes it, so call
+\`helix_derive_theme\`, or run \`helix theme build\`. Both take the same JSON that a
+\`helix.theme.json\` file holds.
 
 **Whether a component fits your case.** Read the examples to decide. Every
 family's \`.md\` file includes them as text, and