@fusion.dev/helix-docs 0.186.0 → 0.187.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/content/charting.mdx +11 -0
- package/content/coding-agents.mdx +95 -41
- package/content/metrics.mdx +222 -222
- package/content/using-helix-with-an-agent.mdx +46 -39
- package/dist/index.d.ts +3 -4
- package/dist/index.js +2 -3
- package/dist/pages.generated.js +1 -1
- package/dist/reference.d.ts +12 -11
- package/dist/reference.js +13 -7
- package/dist/sources.generated.js +374 -302
- package/package.json +9 -9
- package/dist/catalog.d.ts +0 -194
- package/dist/catalog.js +0 -163
- package/dist/naming.d.ts +0 -14
- package/dist/naming.js +0 -8
|
@@ -761,6 +761,17 @@ table should not be seen, hide it visually, and the data is still there:
|
|
|
761
761
|
>…</table>
|
|
762
762
|
\`\`\`
|
|
763
763
|
|
|
764
|
+
A table hidden this way takes no room on the page, however many rows it has.
|
|
765
|
+
Inside an element with a \`transform\` or a \`filter\`, a long hidden table still
|
|
766
|
+
lengthens that element's scrolling area. Wrap the table in a hidden \`<div>\`
|
|
767
|
+
there:
|
|
768
|
+
|
|
769
|
+
\`\`\`html
|
|
770
|
+
<div data-hidden-visually>
|
|
771
|
+
<table id="revenue">…</table>
|
|
772
|
+
</div>
|
|
773
|
+
\`\`\`
|
|
774
|
+
|
|
764
775
|
The table's caption becomes the chart's accessible name unless you set \`label\`.
|
|
765
776
|
The caption usually has the right words already.
|
|
766
777
|
|
|
@@ -907,15 +918,20 @@ type such as \`ButtonEmphasis\` sends you somewhere else to look.
|
|
|
907
918
|
## Markdown and JSON for each component family
|
|
908
919
|
|
|
909
920
|
\`\`\`
|
|
910
|
-
/components/<family>.md
|
|
911
|
-
/components/<family>.json
|
|
921
|
+
https://fusion.dev/helix/components/<family>.md
|
|
922
|
+
https://fusion.dev/helix/components/<family>.json
|
|
912
923
|
\`\`\`
|
|
913
924
|
|
|
914
|
-
These are static files.
|
|
925
|
+
These are static files, one pair for each family. Read the family you are
|
|
926
|
+
writing instead of the whole manifest. The manifest holds every family in one
|
|
927
|
+
file, and it is several megabytes.
|
|
928
|
+
|
|
929
|
+
The \`.md\` file has:
|
|
915
930
|
|
|
916
931
|
- the family's metadata
|
|
932
|
+
- a Usage block with the import lines for the family
|
|
917
933
|
- every element's description and API tables
|
|
918
|
-
- the examples
|
|
934
|
+
- the examples, each with the import lines it needs
|
|
919
935
|
|
|
920
936
|
The HTML page leaves the examples out on purpose. The page lists what a
|
|
921
937
|
component can do, and the sandbox beside it shows what the component looks
|
|
@@ -923,24 +939,49 @@ like. Keeping pictures out of the reference keeps it the one place you can trust
|
|
|
923
939
|
to be complete. An agent cannot use the sandbox, and it reads an example as
|
|
924
940
|
text, so the \`.md\` file includes the examples.
|
|
925
941
|
|
|
926
|
-
|
|
942
|
+
Each example the visual check pictures links its pictures under it: wide at
|
|
943
|
+
640 pixels, narrow at 390, and dark at 640, taken in the environment that
|
|
944
|
+
\`examples.json\` records. Compare a render of your own to them.
|
|
945
|
+
|
|
946
|
+
The \`.json\` file has the same family as structured data, and three fields an
|
|
947
|
+
agent uses most:
|
|
948
|
+
|
|
949
|
+
- \`usage\`, the import block for each tier
|
|
950
|
+
- \`imports\` on each example, an import line for every element it writes
|
|
951
|
+
- \`specifier\` and \`words\` on each element: the line that registers it, and the
|
|
952
|
+
properties \`registerWords\` translates
|
|
953
|
+
|
|
954
|
+
## Import every family you write
|
|
927
955
|
|
|
928
|
-
|
|
956
|
+
Each tag needs its family's entry imported. A family registers its own parts,
|
|
957
|
+
so \`@fusion.dev/helix/tabs\` registers Tab and Tab Panel. A family does not
|
|
958
|
+
register another family's elements that you write inside it:
|
|
929
959
|
|
|
930
|
-
|
|
960
|
+
\`\`\`js
|
|
961
|
+
import '@fusion.dev/helix/select'
|
|
962
|
+
import '@fusion.dev/helix/option'
|
|
963
|
+
\`\`\`
|
|
964
|
+
|
|
965
|
+
Without the Option import, the options are unknown elements and the Select
|
|
966
|
+
offers nothing. The same is true
|
|
967
|
+
of the layout around an example: a Button inside a Flex needs both imports.
|
|
968
|
+
Copy the import lines above an example together with its markup.
|
|
931
969
|
|
|
932
|
-
|
|
970
|
+
## Check the code you wrote
|
|
971
|
+
|
|
972
|
+
These checks run on your project, and each one prints JSON with \`--json\`:
|
|
973
|
+
|
|
974
|
+
| Command | What it finds |
|
|
933
975
|
|---|---|
|
|
934
|
-
|
|
|
935
|
-
|
|
|
936
|
-
|
|
|
937
|
-
| A visual property draws from its axis | \`helix component\`'s \`axes\` |
|
|
938
|
-
| A form control styles with \`:disabled\` | \`helix component --only disabled\` |
|
|
939
|
-
| A component that animates supports reduced motion | \`helix component --only motion\` |
|
|
940
|
-
| No component reads a primitive token | \`helix component\`'s \`tokens\` |
|
|
976
|
+
| \`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 |
|
|
977
|
+
| \`helix theme audit\` | Every foreground and background pair in your theme that misses its contrast target |
|
|
978
|
+
| \`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 |
|
|
941
979
|
|
|
942
|
-
|
|
943
|
-
|
|
980
|
+
\`helix scan\` and \`helix theme audit\` exit 1 when they find an error and 0 when
|
|
981
|
+
they find none. Run them after you write Helix code, and fix each finding
|
|
982
|
+
before you finish. \`helix scan --file <path>\` reports one file's findings, and
|
|
983
|
+
\`helix scan --stdin tsx\` reads a snippet from stdin. Both still read the whole
|
|
984
|
+
project, so an import in another file counts.
|
|
944
985
|
|
|
945
986
|
## The index
|
|
946
987
|
|
|
@@ -968,28 +1009,57 @@ Each family page has a menu beside its title with:
|
|
|
968
1009
|
The links send the URL, because the URL stays current. A pasted copy starts to
|
|
969
1010
|
go stale as soon as you paste it.
|
|
970
1011
|
|
|
971
|
-
##
|
|
1012
|
+
## The Helix MCP server
|
|
972
1013
|
|
|
973
1014
|
\`\`\`sh
|
|
974
|
-
helix mcp
|
|
1015
|
+
helix mcp init --client claude
|
|
975
1016
|
\`\`\`
|
|
976
1017
|
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
1018
|
+
\`helix mcp\` runs an MCP server over stdio. It answers from the Helix packages
|
|
1019
|
+
your project installs, so every answer is for the version you build with, and
|
|
1020
|
+
each one names that package and version. \`helix mcp init\` adds the server to
|
|
1021
|
+
the file your client reads and keeps every other server in it:
|
|
981
1022
|
|
|
982
|
-
|
|
1023
|
+
| Client | File |
|
|
1024
|
+
|---|---|
|
|
1025
|
+
| \`claude\` | \`.mcp.json\` |
|
|
1026
|
+
| \`cursor\` | \`.cursor/mcp.json\` |
|
|
1027
|
+
| \`vscode\` | \`.vscode/mcp.json\` |
|
|
983
1028
|
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
1029
|
+
The server runs \`npx @fusion.dev/helix-cli mcp\`, which is the copy in your
|
|
1030
|
+
project. It has eight tools:
|
|
1031
|
+
|
|
1032
|
+
| Tool | What it returns |
|
|
1033
|
+
|---|---|
|
|
1034
|
+
| \`helix_find\` | The families that answer a name, an alias, a tag, or a purpose, best first |
|
|
1035
|
+
| \`helix_family\` | One family's tags, properties and their unions, events and their React props, slots, parts, custom properties, words, and import lines |
|
|
1036
|
+
| \`helix_example\` | One example as HTML and TSX, with its stylesheet, the import lines it needs, and links to its pictures |
|
|
1037
|
+
| \`helix_imports\` | The import lines for a list of tags, and the closest tag to any unknown one |
|
|
1038
|
+
| \`helix_tokens\` | The semantic tokens, by a word in the name or description and by category |
|
|
1039
|
+
| \`helix_check\` | The findings \`helix scan\` reports for the files you name, or for a snippet before you write it |
|
|
1040
|
+
| \`helix_audit_theme\` | Every foreground and background pair a brand color derives to, with its ratio and target |
|
|
1041
|
+
| \`helix_derive_theme\` | The theme's CSS |
|
|
1042
|
+
|
|
1043
|
+
Each result is structured, with an output schema, and the same JSON as text.
|
|
1044
|
+
A name that matches more than one family, such as \`Dropdown\`, returns an error
|
|
1045
|
+
listing each family. The theme tools take the same JSON that a
|
|
1046
|
+
\`helix.theme.json\` file holds.
|
|
1047
|
+
|
|
1048
|
+
Each lookup is also a command, for a script or a person:
|
|
1049
|
+
|
|
1050
|
+
\`\`\`sh
|
|
1051
|
+
helix api find dropdown
|
|
1052
|
+
helix api family select
|
|
1053
|
+
helix api example select
|
|
1054
|
+
helix api imports helix-select helix-option
|
|
1055
|
+
helix api tokens surface --category color
|
|
1056
|
+
\`\`\`
|
|
987
1057
|
|
|
988
|
-
|
|
1058
|
+
\`--json\` prints what the MCP tool returns.
|
|
989
1059
|
|
|
990
|
-
**\`
|
|
991
|
-
as \`helix theme build\`. A failing palette pasted into a stylesheet is
|
|
992
|
-
a warning above it, and an agent does not read warnings.
|
|
1060
|
+
**\`helix_derive_theme\` does not return a palette that fails its own targets**,
|
|
1061
|
+
the same as \`helix theme build\`. A failing palette pasted into a stylesheet is
|
|
1062
|
+
worse than a warning above it, and an agent does not read warnings.
|
|
993
1063
|
|
|
994
1064
|
You run \`helix mcp\` yourself, and we do not host it. A server we operated would
|
|
995
1065
|
be one more service between you and your own tokens. \`helix mcp\` is a
|
|
@@ -998,17 +1068,12 @@ no network requests.
|
|
|
998
1068
|
|
|
999
1069
|
## What we do not publish for agents
|
|
1000
1070
|
|
|
1001
|
-
**\`llms-full.txt\`, or any other whole-library download.** A single
|
|
1002
|
-
every page goes out of date as soon as anything changes. Each link in
|
|
1003
|
-
can be cached on its own and stays current on its own.
|
|
1071
|
+
**\`llms-full.txt\`, or any other whole-library download of the pages.** A single
|
|
1072
|
+
file with every page goes out of date as soon as anything changes. Each link in
|
|
1073
|
+
\`llms.txt\` can be cached on its own and stays current on its own.
|
|
1004
1074
|
|
|
1005
|
-
|
|
1006
|
-
the
|
|
1007
|
-
the families you use.
|
|
1008
|
-
|
|
1009
|
-
**A search index.** The site has a search index for people. There is nothing an
|
|
1010
|
-
agent can query yet. Reading \`llms.txt\` and the documents it names takes less
|
|
1011
|
-
work than learning most search APIs.
|
|
1075
|
+
\`llms.txt\` is the index, in one request, and each family's \`.md\` file is its
|
|
1076
|
+
document. Fetch the families you use, or ask \`helix mcp\`.
|
|
1012
1077
|
`,
|
|
1013
1078
|
color: `---
|
|
1014
1079
|
description: The color roles, why Helix uses OKLCH, and how the engine meets contrast targets.
|
|
@@ -4232,7 +4297,7 @@ on its own.
|
|
|
4232
4297
|
|
|
4233
4298
|
| | Raw | Gzip | Brotli |
|
|
4234
4299
|
|---|---|---|---|
|
|
4235
|
-
| Lit and \`@fusion.dev/helix-core\` | 248,564 | 79,270 | 67,
|
|
4300
|
+
| Lit and \`@fusion.dev/helix-core\` | 248,564 | 79,270 | 67,889 |
|
|
4236
4301
|
|
|
4237
4302
|
## Whole packages
|
|
4238
4303
|
|
|
@@ -4243,12 +4308,12 @@ either barrel. The per-component tables show what your page pays.
|
|
|
4243
4308
|
|
|
4244
4309
|
| Package | Raw | Gzip | Brotli | |
|
|
4245
4310
|
|---|---|---|---|---|
|
|
4246
|
-
| \`@fusion.dev/helix-core\` | 247,773 | 79,121 | 67,
|
|
4247
|
-
| \`@fusion.dev/helix-headless\` | 1,337,367 | 373,053 | 279,
|
|
4311
|
+
| \`@fusion.dev/helix-core\` | 247,773 | 79,121 | 67,573 | The element base class, mixins, decorators, and floating positioning. |
|
|
4312
|
+
| \`@fusion.dev/helix-headless\` | 1,337,367 | 373,053 | 279,925 | Every headless family. The barrel entry includes all of them. |
|
|
4248
4313
|
| \`@fusion.dev/helix-icons\` | 56,111 | 17,847 | 15,166 | The whole glyph set. |
|
|
4249
4314
|
| \`@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. |
|
|
4250
4315
|
| \`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. |
|
|
4251
|
-
| \`@fusion.dev/helix\` | 2,015,564 | 520,954 | 371,
|
|
4316
|
+
| \`@fusion.dev/helix\` | 2,015,564 | 520,954 | 371,815 | Every styled family. |
|
|
4252
4317
|
| \`lit\` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
|
|
4253
4318
|
|
|
4254
4319
|
## Stylesheets
|
|
@@ -4261,7 +4326,7 @@ shows the whole cost of using the base layer on its own.
|
|
|
4261
4326
|
|
|
4262
4327
|
| File | Raw | Gzip | Brotli | |
|
|
4263
4328
|
|---|---|---|---|---|
|
|
4264
|
-
| \`base.css\` | 34,
|
|
4329
|
+
| \`base.css\` | 34,352 | 4,806 | 4,174 | The base layer. It styles markup Helix does not render, and it works with no JavaScript. |
|
|
4265
4330
|
| \`elements.css\` | 19,050 | 2,860 | 2,551 | Hides each element until its definition loads. It is generated from the tags in \`@fusion.dev/helix\`. |
|
|
4266
4331
|
| \`helix.css\` | 207 | 148 | 118 | The other four stylesheets in one import, in the order they must load. |
|
|
4267
4332
|
| \`primitives.css\` | 7,511 | 1,401 | 1,221 | The primitive layer. It is private, and it ships because \`tokens.css\` refers to it. |
|
|
@@ -4271,11 +4336,11 @@ shows the whole cost of using the base layer on its own.
|
|
|
4271
4336
|
|
|
4272
4337
|
**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.
|
|
4273
4338
|
|
|
4274
|
-
Across the 106 styled components, the smallest is \`code\` at 8,
|
|
4339
|
+
Across the 106 styled components, the smallest is \`code\` at 8,333 bytes gzipped alone, and the largest is \`data-table\` at 66,818. Every family together is 520,954.
|
|
4275
4340
|
|
|
4276
|
-
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.
|
|
4341
|
+
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.
|
|
4277
4342
|
|
|
4278
|
-
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,
|
|
4343
|
+
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,645 bytes gzipped alone.
|
|
4279
4344
|
|
|
4280
4345
|
## Compared with other systems
|
|
4281
4346
|
|
|
@@ -4287,12 +4352,12 @@ The table has no whole-library row. That row would compare how many components e
|
|
|
4287
4352
|
|
|
4288
4353
|
| Component | System | Raw | Gzip | Brotli |
|
|
4289
4354
|
|---|---|---|---|---|
|
|
4290
|
-
| \`button\` | **Helix** | 41,612 | 14,007 | 12,
|
|
4355
|
+
| \`button\` | **Helix** | 41,612 | 14,007 | 12,441 |
|
|
4291
4356
|
| | Carbon | 133,058 | 20,959 | 17,685 |
|
|
4292
4357
|
| | Material Web | 47,060 | 14,173 | 12,591 |
|
|
4293
4358
|
| | Shoelace | 62,628 | 18,287 | 15,805 |
|
|
4294
4359
|
| | Spectrum | 98,792 | 22,045 | 18,674 |
|
|
4295
|
-
| \`checkbox\` | **Helix** | 46,865 | 15,190 | 13,
|
|
4360
|
+
| \`checkbox\` | **Helix** | 46,865 | 15,190 | 13,516 |
|
|
4296
4361
|
| | Carbon | 60,255 | 15,609 | 13,550 |
|
|
4297
4362
|
| | Material Web | 43,785 | 13,556 | 12,015 |
|
|
4298
4363
|
| | Shoelace | 47,614 | 15,177 | 13,301 |
|
|
@@ -4302,22 +4367,22 @@ The table has no whole-library row. That row would compare how many components e
|
|
|
4302
4367
|
| | Material Web | 34,238 | 11,510 | 10,229 |
|
|
4303
4368
|
| | Shoelace | 52,754 | 17,698 | 15,554 |
|
|
4304
4369
|
| | Spectrum | 155,708 | 31,899 | 26,262 |
|
|
4305
|
-
| \`radio\` | **Helix** | 50,349 | 15,977 | 14,
|
|
4370
|
+
| \`radio\` | **Helix** | 50,349 | 15,977 | 14,203 |
|
|
4306
4371
|
| | Carbon | 63,055 | 16,887 | 14,605 |
|
|
4307
4372
|
| | Material Web | 41,044 | 13,234 | 11,757 |
|
|
4308
4373
|
| | Shoelace | 34,865 | 12,027 | 10,559 |
|
|
4309
4374
|
| | Spectrum | 38,685 | 10,660 | 9,370 |
|
|
4310
|
-
| \`switch\` | **Helix** | 43,562 | 14,637 | 13,
|
|
4375
|
+
| \`switch\` | **Helix** | 43,562 | 14,637 | 13,010 |
|
|
4311
4376
|
| | Carbon | 69,423 | 17,127 | 14,764 |
|
|
4312
4377
|
| | Material Web | 50,155 | 14,577 | 12,935 |
|
|
4313
4378
|
| | Shoelace | 37,833 | 11,814 | 10,568 |
|
|
4314
4379
|
| | Spectrum | 62,322 | 15,059 | 13,321 |
|
|
4315
|
-
| \`tabs\` | **Helix** | 55,263 | 17,753 | 15,
|
|
4380
|
+
| \`tabs\` | **Helix** | 55,263 | 17,753 | 15,835 |
|
|
4316
4381
|
| | Carbon | 578,766 | 73,537 | 43,235 |
|
|
4317
4382
|
| | Material Web | 38,883 | 12,820 | 11,368 |
|
|
4318
4383
|
| | Shoelace | 54,573 | 17,140 | 15,068 |
|
|
4319
4384
|
| | Spectrum | 64,875 | 18,298 | 16,283 |
|
|
4320
|
-
| \`tooltip\` | **Helix** | 61,420 | 21,833 | 19,
|
|
4385
|
+
| \`tooltip\` | **Helix** | 61,420 | 21,833 | 19,366 |
|
|
4321
4386
|
| | Carbon | 189,382 | 30,354 | 22,273 |
|
|
4322
4387
|
| | Material Web | | not shipped | |
|
|
4323
4388
|
| | Shoelace | 57,412 | 20,220 | 17,933 |
|
|
@@ -4369,105 +4434,105 @@ Structure, accessibility, state, and form participation. It has no presentation
|
|
|
4369
4434
|
|
|
4370
4435
|
| Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
|
|
4371
4436
|
|---|---|---|---|---|---|---|
|
|
4372
|
-
| \`accordion\` | 31,879 | 11,805 | 10,464 | 5,329 | 1,598 | 1,
|
|
4373
|
-
| \`announcement\` | 36,692 | 13,313 | 11,
|
|
4374
|
-
| \`app-header\` | 32,289 | 11,
|
|
4375
|
-
| \`area-chart\` | 90,301 | 31,
|
|
4376
|
-
| \`avatar\` | 30,463 | 11,596 | 10,
|
|
4377
|
-
| \`badge\` | 27,088 | 10,568 | 9,
|
|
4378
|
-
| \`bar-chart\` | 94,416 | 32,821 | 29,
|
|
4379
|
-
| \`blockquote\` | 24,107 | 9,
|
|
4380
|
-
| \`breadcrumbs\` | 36,279 | 13,906 | 12,
|
|
4381
|
-
| \`button\` | 35,194 | 12,591 | 11,
|
|
4382
|
-
| \`button-group\` | 27,640 | 10,382 | 9,203 | 4,928 | 1,516 | 1,
|
|
4383
|
-
| \`callout\` | 35,256 | 13,
|
|
4384
|
-
| \`canvas\` | 108,483 | 34,750 | 30,
|
|
4385
|
-
| \`card\` | 23,777 | 9,
|
|
4386
|
-
| \`carousel\` | 42,748 | 15,234 | 13,
|
|
4387
|
-
| \`chat\` | 79,390 | 26,446 | 23,
|
|
4388
|
-
| \`checkbox\` | 40,374 | 13,681 | 12,
|
|
4389
|
-
| \`checkbox-group\` | 47,602 | 15,
|
|
4390
|
-
| \`code\` | 20,301 | 8,015 | 7,
|
|
4391
|
-
| \`code-block\` | 102,738 | 34,889 | 30,
|
|
4392
|
-
| \`color-input\` | 141,792 | 45,087 | 39,
|
|
4393
|
-
| \`color-picker\` | 103,415 | 32,966 | 28,
|
|
4394
|
-
| \`combobox\` | 132,023 | 41,951 | 36,
|
|
4395
|
-
| \`command\` | 99,513 | 31,476 | 27,
|
|
4396
|
-
| \`copy-button\` | 80,548 | 27,649 | 24,
|
|
4397
|
-
| \`data-table\` | 199,900 | 61,
|
|
4398
|
-
| \`date-input\` | 141,223 | 44,512 | 39,
|
|
4399
|
-
| \`date-picker\` | 61,360 | 20,936 | 18,
|
|
4400
|
-
| \`description-list\` | 22,900 | 8,
|
|
4401
|
-
| \`dialog\` | 38,247 | 13,598 | 12,117 | 5,837 | 1,753 | 1,
|
|
4402
|
-
| \`divider\` | 22,991 | 8,924 | 7,882 | 1,416 | 502 |
|
|
4403
|
-
| \`donut-chart\` | 89,212 | 31,127 | 27,
|
|
4404
|
-
| \`drawer\` | 42,892 | 15,123 | 13,
|
|
4405
|
-
| \`drilldown\` | 42,756 | 14,941 | 13,
|
|
4406
|
-
| \`empty\` | 24,194 | 9,
|
|
4407
|
-
| \`file-input\` | 57,757 | 20,019 | 17,
|
|
4408
|
-
| \`filter-input\` | 97,846 | 32,
|
|
4409
|
-
| \`format-date\` | 30,158 | 11,290 | 10,090 | 4,434 | 1,263 | 1,
|
|
4410
|
-
| \`graph\` | 74,369 | 24,
|
|
4411
|
-
| \`heatmap\` | 98,128 | 33,
|
|
4412
|
-
| \`icon\` | 82,157 | 28,050 | 23,
|
|
4413
|
-
| \`icon-button\` | 35,305 | 12,620 | 11,
|
|
4414
|
-
| \`image\` | 25,504 | 9,
|
|
4415
|
-
| \`input\` | 46,361 | 15,974 | 14,090 | 7,352 | 2,452 | 1,
|
|
4416
|
-
| \`isometric-heatmap\` | 102,771 | 34,
|
|
4417
|
-
| \`kbd\` | 27,511 | 10,
|
|
4418
|
-
| \`legend\` | 35,184 | 12,935 | 11,
|
|
4419
|
-
| \`lightbox\` | 55,724 | 18,
|
|
4420
|
-
| \`line-chart\` | 91,335 | 31,
|
|
4421
|
-
| \`list\` | 61,803 | 21,
|
|
4422
|
-
| \`listbox\` | 76,711 | 25,427 | 22,
|
|
4423
|
-
| \`loader\` | 26,379 | 10,041 | 8,907 | 2,775 | 969 |
|
|
4424
|
-
| \`map\` | 78,565 | 24,393 | 21,
|
|
4425
|
-
| \`megamenu\` | 60,027 | 21,698 | 19,
|
|
4426
|
-
| \`menu\` | 97,473 | 32,550 | 28,
|
|
4427
|
-
| \`meter\` | 31,721 | 12,026 | 10,720 | 4,894 | 1,453 | 1,
|
|
4428
|
-
| \`navigation\` | 33,088 | 12,436 | 11,
|
|
4429
|
-
| \`notifications\` | 58,346 | 19,881 | 17,
|
|
4430
|
-
| \`number-input\` | 56,271 | 18,839 | 16,
|
|
4431
|
-
| \`object-inspector\` | 113,929 | 38,372 | 33,
|
|
4432
|
-
| \`option\` | 26,477 | 9,
|
|
4433
|
-
| \`outline\` | 33,612 | 12,
|
|
4434
|
-
| \`pagination\` | 136,258 | 43,650 | 37,
|
|
4435
|
-
| \`pin-input\` | 47,068 | 16,413 | 14,656 | 6,736 | 2,253 | 1,
|
|
4436
|
-
| \`popover\` | 63,806 | 22,
|
|
4437
|
-
| \`progress\` | 28,084 | 10,730 | 9,552 | 2,970 | 933 |
|
|
4438
|
-
| \`qr-code\` | 42,719 | 16,
|
|
4439
|
-
| \`quote\` | 22,516 | 8,885 | 7,828 | 1,211 | 523 |
|
|
4440
|
-
| \`radio\` | 42,561 | 14,464 | 12,
|
|
4441
|
-
| \`rating\` | 50,257 | 17,289 | 15,
|
|
4442
|
-
| \`scatter-chart\` | 91,226 | 31,
|
|
4443
|
-
| \`scroll-area\` | 30,430 | 11,079 | 9,814 | 8,499 | 2,602 | 2,
|
|
4444
|
-
| \`select\` | 115,289 | 38,173 | 33,
|
|
4445
|
-
| \`skeleton\` | 22,328 | 8,644 | 7,
|
|
4446
|
-
| \`skip-link\` | 23,871 | 9,
|
|
4447
|
-
| \`slider\` | 52,873 | 17,
|
|
4448
|
-
| \`sparkline\` | 47,984 | 17,500 | 15,601 | 5,981 | 2,162 | 1,
|
|
4449
|
-
| \`speed-dial\` | 68,751 | 24,718 | 21,
|
|
4450
|
-
| \`splitter\` | 43,751 | 15,167 | 13,536 | 14,397 | 3,878 | 3,
|
|
4451
|
-
| \`stat\` | 25,255 | 9,675 | 8,
|
|
4452
|
-
| \`steps\` | 53,623 | 18,
|
|
4453
|
-
| \`switch\` | 39,233 | 13,495 | 12,048 | 1,679 | 625 |
|
|
4454
|
-
| \`table\` | 118,358 | 37,061 | 32,
|
|
4455
|
-
| \`tabs\` | 46,310 | 15,908 | 14,148 | 10,491 | 2,916 | 2,
|
|
4456
|
-
| \`tag\` | 42,676 | 15,
|
|
4457
|
-
| \`textarea\` | 43,852 | 14,941 | 13,
|
|
4458
|
-
| \`time-input\` | 169,269 | 52,676 | 45,
|
|
4459
|
-
| \`time-picker\` | 99,603 | 31,
|
|
4460
|
-
| \`timeline\` | 31,286 | 11,863 | 10,
|
|
4461
|
-
| \`toast\` | 50,871 | 17,940 | 16,020 | 12,124 | 3,529 | 2,
|
|
4462
|
-
| \`toggle\` | 45,577 | 15,270 | 13,
|
|
4463
|
-
| \`toolbar\` | 31,047 | 11,573 | 10,294 | 5,158 | 1,694 | 1,
|
|
4464
|
-
| \`tooltip\` | 58,616 | 21,
|
|
4465
|
-
| \`tour\` | 83,670 | 28,
|
|
4466
|
-
| \`tree\` | 67,586 | 22,717 | 20,
|
|
4467
|
-
| \`trend\` | 29,717 | 11,
|
|
4468
|
-
| \`video\` | 141,208 | 44,
|
|
4469
|
-
| \`video-playlist\` | 127,686 | 41,301 | 36,
|
|
4470
|
-
| \`virtual-list\` | 63,451 | 21,
|
|
4437
|
+
| \`accordion\` | 31,879 | 11,805 | 10,464 | 5,329 | 1,598 | 1,201 |
|
|
4438
|
+
| \`announcement\` | 36,692 | 13,313 | 11,857 | 4,682 | 1,425 | 1,151 |
|
|
4439
|
+
| \`app-header\` | 32,289 | 11,899 | 10,609 | 5,871 | 1,795 | 1,314 |
|
|
4440
|
+
| \`area-chart\` | 90,301 | 31,725 | 28,033 | 14,058 | 4,345 | 3,519 |
|
|
4441
|
+
| \`avatar\` | 30,463 | 11,596 | 10,395 | 3,957 | 1,234 | 996 |
|
|
4442
|
+
| \`badge\` | 27,088 | 10,568 | 9,410 | 2,942 | 919 | 680 |
|
|
4443
|
+
| \`bar-chart\` | 94,416 | 32,821 | 29,079 | 18,026 | 5,441 | 4,384 |
|
|
4444
|
+
| \`blockquote\` | 24,107 | 9,421 | 8,333 | 2,402 | 913 | 792 |
|
|
4445
|
+
| \`breadcrumbs\` | 36,279 | 13,906 | 12,381 | 7,360 | 2,451 | 1,863 |
|
|
4446
|
+
| \`button\` | 35,194 | 12,591 | 11,199 | 4,925 | 1,471 | 1,101 |
|
|
4447
|
+
| \`button-group\` | 27,640 | 10,382 | 9,203 | 4,928 | 1,516 | 1,108 |
|
|
4448
|
+
| \`callout\` | 35,256 | 13,595 | 12,070 | 2,884 | 992 | 672 |
|
|
4449
|
+
| \`canvas\` | 108,483 | 34,750 | 30,378 | 68,927 | 20,973 | 17,579 |
|
|
4450
|
+
| \`card\` | 23,777 | 9,053 | 8,018 | 2,090 | 655 | 458 |
|
|
4451
|
+
| \`carousel\` | 42,748 | 15,234 | 13,592 | 15,006 | 4,215 | 3,284 |
|
|
4452
|
+
| \`chat\` | 79,390 | 26,446 | 23,340 | 27,455 | 8,116 | 6,323 |
|
|
4453
|
+
| \`checkbox\` | 40,374 | 13,681 | 12,223 | 3,107 | 979 | 715 |
|
|
4454
|
+
| \`checkbox-group\` | 47,602 | 15,600 | 13,904 | 8,325 | 2,351 | 1,675 |
|
|
4455
|
+
| \`code\` | 20,301 | 8,015 | 7,128 | 138 | 67 | 44 |
|
|
4456
|
+
| \`code-block\` | 102,738 | 34,889 | 30,829 | 36,843 | 10,785 | 8,723 |
|
|
4457
|
+
| \`color-input\` | 141,792 | 45,087 | 39,353 | 55,136 | 14,334 | 11,579 |
|
|
4458
|
+
| \`color-picker\` | 103,415 | 32,966 | 28,889 | 47,256 | 12,743 | 10,286 |
|
|
4459
|
+
| \`combobox\` | 132,023 | 41,951 | 36,926 | 35,791 | 9,112 | 7,114 |
|
|
4460
|
+
| \`command\` | 99,513 | 31,476 | 27,699 | 30,061 | 8,170 | 6,287 |
|
|
4461
|
+
| \`copy-button\` | 80,548 | 27,649 | 24,493 | 18,341 | 4,985 | 3,862 |
|
|
4462
|
+
| \`data-table\` | 199,900 | 61,427 | 52,552 | 89,488 | 23,783 | 19,122 |
|
|
4463
|
+
| \`date-input\` | 141,223 | 44,512 | 39,087 | 38,229 | 9,447 | 7,481 |
|
|
4464
|
+
| \`date-picker\` | 61,360 | 20,936 | 18,758 | 20,347 | 5,579 | 4,404 |
|
|
4465
|
+
| \`description-list\` | 22,900 | 8,766 | 7,766 | 1,565 | 525 | 363 |
|
|
4466
|
+
| \`dialog\` | 38,247 | 13,598 | 12,117 | 5,837 | 1,753 | 1,370 |
|
|
4467
|
+
| \`divider\` | 22,991 | 8,924 | 7,882 | 1,416 | 502 | 365 |
|
|
4468
|
+
| \`donut-chart\` | 89,212 | 31,127 | 27,516 | 14,641 | 4,497 | 3,726 |
|
|
4469
|
+
| \`drawer\` | 42,892 | 15,123 | 13,470 | 7,698 | 2,295 | 1,762 |
|
|
4470
|
+
| \`drilldown\` | 42,756 | 14,941 | 13,298 | 9,710 | 2,724 | 2,115 |
|
|
4471
|
+
| \`empty\` | 24,194 | 9,251 | 8,200 | 1,951 | 658 | 452 |
|
|
4472
|
+
| \`file-input\` | 57,757 | 20,019 | 17,787 | 13,094 | 4,155 | 3,327 |
|
|
4473
|
+
| \`filter-input\` | 97,846 | 32,818 | 29,095 | 21,630 | 6,199 | 4,832 |
|
|
4474
|
+
| \`format-date\` | 30,158 | 11,290 | 10,090 | 4,434 | 1,263 | 1,027 |
|
|
4475
|
+
| \`graph\` | 74,369 | 24,503 | 21,668 | 21,878 | 6,484 | 5,239 |
|
|
4476
|
+
| \`heatmap\` | 98,128 | 33,504 | 29,599 | 18,944 | 5,590 | 4,500 |
|
|
4477
|
+
| \`icon\` | 82,157 | 28,050 | 23,958 | 58,304 | 19,661 | 16,059 |
|
|
4478
|
+
| \`icon-button\` | 35,305 | 12,620 | 11,230 | 5,034 | 1,512 | 1,196 |
|
|
4479
|
+
| \`image\` | 25,504 | 9,480 | 8,403 | 3,824 | 1,152 | 876 |
|
|
4480
|
+
| \`input\` | 46,361 | 15,974 | 14,090 | 7,352 | 2,452 | 1,782 |
|
|
4481
|
+
| \`isometric-heatmap\` | 102,771 | 34,712 | 30,611 | 23,536 | 6,749 | 5,369 |
|
|
4482
|
+
| \`kbd\` | 27,511 | 10,571 | 9,363 | 3,516 | 1,152 | 829 |
|
|
4483
|
+
| \`legend\` | 35,184 | 12,935 | 11,491 | 2,957 | 1,019 | 860 |
|
|
4484
|
+
| \`lightbox\` | 55,724 | 18,816 | 16,708 | 16,730 | 4,692 | 3,556 |
|
|
4485
|
+
| \`line-chart\` | 91,335 | 31,881 | 28,246 | 14,762 | 4,418 | 3,595 |
|
|
4486
|
+
| \`list\` | 61,803 | 21,294 | 18,990 | 15,242 | 4,449 | 3,468 |
|
|
4487
|
+
| \`listbox\` | 76,711 | 25,427 | 22,518 | 15,565 | 4,585 | 3,562 |
|
|
4488
|
+
| \`loader\` | 26,379 | 10,041 | 8,907 | 2,775 | 969 | 755 |
|
|
4489
|
+
| \`map\` | 78,565 | 24,393 | 21,306 | 37,025 | 10,128 | 7,979 |
|
|
4490
|
+
| \`megamenu\` | 60,027 | 21,698 | 19,184 | 8,595 | 2,405 | 1,729 |
|
|
4491
|
+
| \`menu\` | 97,473 | 32,550 | 28,740 | 30,180 | 7,996 | 6,317 |
|
|
4492
|
+
| \`meter\` | 31,721 | 12,026 | 10,720 | 4,894 | 1,453 | 1,142 |
|
|
4493
|
+
| \`navigation\` | 33,088 | 12,436 | 11,039 | 3,366 | 1,183 | 972 |
|
|
4494
|
+
| \`notifications\` | 58,346 | 19,881 | 17,738 | 18,207 | 5,055 | 4,084 |
|
|
4495
|
+
| \`number-input\` | 56,271 | 18,839 | 16,788 | 13,524 | 3,662 | 2,808 |
|
|
4496
|
+
| \`object-inspector\` | 113,929 | 38,372 | 33,710 | 35,492 | 10,303 | 8,228 |
|
|
4497
|
+
| \`option\` | 26,477 | 9,764 | 8,662 | 4,525 | 1,231 | 929 |
|
|
4498
|
+
| \`outline\` | 33,612 | 12,598 | 11,179 | 7,856 | 2,569 | 1,942 |
|
|
4499
|
+
| \`pagination\` | 136,258 | 43,650 | 37,968 | 45,377 | 11,934 | 9,430 |
|
|
4500
|
+
| \`pin-input\` | 47,068 | 16,413 | 14,656 | 6,736 | 2,253 | 1,679 |
|
|
4501
|
+
| \`popover\` | 63,806 | 22,941 | 20,269 | 6,375 | 1,876 | 1,391 |
|
|
4502
|
+
| \`progress\` | 28,084 | 10,730 | 9,552 | 2,970 | 933 | 784 |
|
|
4503
|
+
| \`qr-code\` | 42,719 | 16,645 | 14,846 | 17,004 | 6,288 | 5,327 |
|
|
4504
|
+
| \`quote\` | 22,516 | 8,885 | 7,828 | 1,211 | 523 | 436 |
|
|
4505
|
+
| \`radio\` | 42,561 | 14,464 | 12,878 | 3,817 | 1,227 | 860 |
|
|
4506
|
+
| \`rating\` | 50,257 | 17,289 | 15,409 | 8,029 | 2,456 | 1,823 |
|
|
4507
|
+
| \`scatter-chart\` | 91,226 | 31,676 | 27,953 | 16,127 | 4,840 | 3,799 |
|
|
4508
|
+
| \`scroll-area\` | 30,430 | 11,079 | 9,814 | 8,499 | 2,602 | 2,068 |
|
|
4509
|
+
| \`select\` | 115,289 | 38,173 | 33,453 | 26,033 | 7,140 | 5,340 |
|
|
4510
|
+
| \`skeleton\` | 22,328 | 8,644 | 7,666 | 991 | 367 | 229 |
|
|
4511
|
+
| \`skip-link\` | 23,871 | 9,338 | 8,265 | 1,225 | 493 | 350 |
|
|
4512
|
+
| \`slider\` | 52,873 | 17,826 | 15,978 | 13,159 | 3,817 | 2,927 |
|
|
4513
|
+
| \`sparkline\` | 47,984 | 17,500 | 15,601 | 5,981 | 2,162 | 1,673 |
|
|
4514
|
+
| \`speed-dial\` | 68,751 | 24,718 | 21,898 | 10,915 | 2,990 | 2,359 |
|
|
4515
|
+
| \`splitter\` | 43,751 | 15,167 | 13,536 | 14,397 | 3,878 | 3,177 |
|
|
4516
|
+
| \`stat\` | 25,255 | 9,675 | 8,601 | 2,303 | 781 | 553 |
|
|
4517
|
+
| \`steps\` | 53,623 | 18,636 | 16,567 | 13,603 | 3,869 | 3,159 |
|
|
4518
|
+
| \`switch\` | 39,233 | 13,495 | 12,048 | 1,679 | 625 | 396 |
|
|
4519
|
+
| \`table\` | 118,358 | 37,061 | 32,288 | 45,150 | 12,476 | 10,092 |
|
|
4520
|
+
| \`tabs\` | 46,310 | 15,908 | 14,148 | 10,491 | 2,916 | 2,292 |
|
|
4521
|
+
| \`tag\` | 42,676 | 15,620 | 13,972 | 8,455 | 2,548 | 2,025 |
|
|
4522
|
+
| \`textarea\` | 43,852 | 14,941 | 13,326 | 5,402 | 1,622 | 1,271 |
|
|
4523
|
+
| \`time-input\` | 169,269 | 52,676 | 45,838 | 48,511 | 12,418 | 9,781 |
|
|
4524
|
+
| \`time-picker\` | 99,603 | 31,517 | 27,728 | 33,933 | 9,190 | 7,178 |
|
|
4525
|
+
| \`timeline\` | 31,286 | 11,863 | 10,638 | 4,061 | 1,259 | 981 |
|
|
4526
|
+
| \`toast\` | 50,871 | 17,940 | 16,020 | 12,124 | 3,529 | 2,769 |
|
|
4527
|
+
| \`toggle\` | 45,577 | 15,270 | 13,576 | 6,007 | 1,799 | 1,303 |
|
|
4528
|
+
| \`toolbar\` | 31,047 | 11,573 | 10,294 | 5,158 | 1,694 | 1,299 |
|
|
4529
|
+
| \`tooltip\` | 58,616 | 21,091 | 18,704 | 8,434 | 2,378 | 1,931 |
|
|
4530
|
+
| \`tour\` | 83,670 | 28,722 | 25,379 | 19,815 | 5,458 | 4,358 |
|
|
4531
|
+
| \`tree\` | 67,586 | 22,717 | 20,230 | 17,199 | 4,979 | 3,932 |
|
|
4532
|
+
| \`trend\` | 29,717 | 11,568 | 10,337 | 3,487 | 1,133 | 886 |
|
|
4533
|
+
| \`video\` | 141,208 | 44,137 | 38,490 | 66,217 | 16,841 | 13,759 |
|
|
4534
|
+
| \`video-playlist\` | 127,686 | 41,301 | 36,312 | 42,775 | 11,224 | 9,029 |
|
|
4535
|
+
| \`virtual-list\` | 63,451 | 21,632 | 19,226 | 23,305 | 7,171 | 5,849 |
|
|
4471
4536
|
|
|
4472
4537
|
### Styled tier
|
|
4473
4538
|
|
|
@@ -4475,112 +4540,112 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
|
|
|
4475
4540
|
|
|
4476
4541
|
| Family | Alone raw | Alone gzip | Alone brotli | Added raw | Added gzip | Added brotli |
|
|
4477
4542
|
|---|---|---|---|---|---|---|
|
|
4478
|
-
| \`accordion\` | 35,311 | 12,654 | 11,
|
|
4479
|
-
| \`announcement\` | 41,307 | 14,365 | 12,844 | 9,278 | 2,489 |
|
|
4480
|
-
| \`app-header\` | 37,449 | 13,103 | 11,662 | 11,016 | 3,009 | 2,
|
|
4481
|
-
| \`area-chart\` | 98,393 | 33,578 | 29,
|
|
4482
|
-
| \`aura\` | 56,085 | 19,320 | 17,
|
|
4483
|
-
| \`avatar\` | 33,464 | 12,
|
|
4484
|
-
| \`badge\` | 32,595 | 11,820 | 10,
|
|
4485
|
-
| \`bar-chart\` | 108,944 | 35,724 | 31,
|
|
4486
|
-
| \`blockquote\` | 26,332 | 9,
|
|
4487
|
-
| \`breadcrumbs\` | 43,220 | 15,115 | 13,
|
|
4488
|
-
| \`button\` | 41,612 | 14,007 | 12,
|
|
4489
|
-
| \`button-group\` | 31,138 | 11,066 | 9,
|
|
4490
|
-
| \`callout\` | 39,049 | 14,537 | 12,949 | 6,659 | 1,950 | 1,
|
|
4491
|
-
| \`canvas\` | 129,523 | 38,
|
|
4492
|
-
| \`card\` | 27,678 | 10,
|
|
4493
|
-
| \`carousel\` | 53,234 | 17,022 | 15,256 | 25,477 | 6,
|
|
4494
|
-
| \`chat\` | 94,674 | 29,166 | 25,
|
|
4495
|
-
| \`checkbox\` | 46,865 | 15,190 | 13,
|
|
4496
|
-
| \`checkbox-group\` | 54,826 | 17,244 | 15,360 | 15,542 | 4,028 | 3,
|
|
4497
|
-
| \`code\` | 21,154 | 8,
|
|
4498
|
-
| \`code-block\` | 127,213 | 38,714 | 34,
|
|
4499
|
-
| \`color-input\` | 184,176 | 51,
|
|
4500
|
-
| \`color-picker\` | 140,348 | 38,508 | 33,
|
|
4501
|
-
| \`combobox\` | 147,503 | 44,927 | 39,
|
|
4502
|
-
| \`command\` | 110,791 | 33,835 | 29,
|
|
4503
|
-
| \`copy-button\` | 92,577 | 29,825 | 26,
|
|
4504
|
-
| \`data-table\` | 230,715 | 66,
|
|
4505
|
-
| \`date-input\` | 162,349 | 48,215 | 42,
|
|
4506
|
-
| \`date-picker\` | 69,281 | 22,363 |
|
|
4507
|
-
| \`description-list\` | 25,855 | 9,
|
|
4508
|
-
| \`dialog\` | 43,360 | 14,855 | 13,244 | 10,933 | 3,007 | 2,
|
|
4509
|
-
| \`divider\` | 25,291 | 9,547 | 8,433 | 3,699 | 1,140 |
|
|
4510
|
-
| \`donut-chart\` | 99,170 | 33,263 | 29,
|
|
4511
|
-
| \`drawer\` | 48,725 | 16,
|
|
4512
|
-
| \`drilldown\` | 48,438 | 16,235 | 14,
|
|
4513
|
-
| \`empty\` | 25,503 | 9,726 | 8,598 | 3,242 | 1,117 |
|
|
4514
|
-
| \`file-input\` | 69,285 | 22,
|
|
4515
|
-
| \`filter-input\` | 108,688 | 34,
|
|
4516
|
-
| \`flex\` | 25,740 | 9,194 | 8,
|
|
4517
|
-
| \`format-date\` | 30,414 | 11,403 | 10,189 | 4,672 | 1,402 | 1,
|
|
4518
|
-
| \`graph\` | 89,037 | 27,
|
|
4519
|
-
| \`grid\` | 27,002 | 9,846 | 8,
|
|
4520
|
-
| \`heatmap\` | 105,486 | 35,189 | 31,
|
|
4521
|
-
| \`icon\` | 83,995 | 28,
|
|
4522
|
-
| \`icon-button\` | 43,040 | 13,981 | 12,
|
|
4523
|
-
| \`image\` | 26,892 | 9,
|
|
4524
|
-
| \`input\` | 50,619 | 17,063 | 15,
|
|
4525
|
-
| \`isometric-heatmap\` | 110,852 | 36,558 | 32,
|
|
4526
|
-
| \`kbd\` | 29,504 | 11,
|
|
4527
|
-
| \`legend\` | 40,423 | 14,214 | 12,
|
|
4528
|
-
| \`lightbox\` | 62,016 | 20,155 | 17,
|
|
4529
|
-
| \`line-chart\` | 102,454 | 34,257 | 30,
|
|
4530
|
-
| \`list\` | 68,150 | 22,
|
|
4531
|
-
| \`listbox\` | 81,154 | 26,
|
|
4532
|
-
| \`loader\` | 29,263 | 10,814 | 9,643 | 5,642 | 1,730 | 1,
|
|
4533
|
-
| \`map\` | 111,513 | 29,575 |
|
|
4534
|
-
| \`megamenu\` | 64,996 | 22,865 | 20,
|
|
4535
|
-
| \`menu\` | 108,403 | 34,
|
|
4536
|
-
| \`meter\` | 37,896 | 13,377 | 11,
|
|
4537
|
-
| \`navigation\` | 36,814 | 13,268 | 11,
|
|
4538
|
-
| \`notifications\` | 71,808 | 22,447 |
|
|
4539
|
-
| \`number-input\` | 61,253 | 20,024 | 17,
|
|
4540
|
-
| \`object-inspector\` | 130,338 | 41,206 | 36,
|
|
4541
|
-
| \`option\` | 29,672 | 10,762 | 9,552 | 7,712 | 2,213 | 1,
|
|
4542
|
-
| \`orb\` | 35,265 | 13,488 | 12,
|
|
4543
|
-
| \`outline\` | 37,846 | 13,
|
|
4544
|
-
| \`pagination\` | 153,264 | 46,929 | 40,
|
|
4545
|
-
| \`pin-input\` | 50,409 | 17,316 | 15,
|
|
4546
|
-
| \`popover\` | 66,958 | 23,702 | 20,
|
|
4547
|
-
| \`progress\` | 35,232 | 12,380 | 11,035 | 10,101 | 2,602 | 2,
|
|
4548
|
-
| \`qr-code\` | 44,321 | 17,121 | 15,
|
|
4549
|
-
| \`quote\` | 23,074 | 9,079 | 8,
|
|
4550
|
-
| \`radio\` | 50,349 | 15,977 | 14,
|
|
4551
|
-
| \`rating\` | 54,190 | 18,519 | 16,
|
|
4552
|
-
| \`sandbox\` | 104,428 | 31,
|
|
4553
|
-
| \`scatter-chart\` | 100,317 | 33,
|
|
4554
|
-
| \`scroll-area\` | 35,437 | 12,
|
|
4555
|
-
| \`select\` | 124,418 | 40,070 | 35,
|
|
4556
|
-
| \`skeleton\` | 26,090 | 9,664 | 8,
|
|
4557
|
-
| \`skip-link\` | 25,441 | 9,
|
|
4558
|
-
| \`slider\` | 67,842 | 20,140 | 18,
|
|
4559
|
-
| \`sparkline\` | 53,442 | 18,851 | 16,826 | 11,421 | 3,519 | 2,
|
|
4560
|
-
| \`speed-dial\` | 75,797 | 26,105 | 23,
|
|
4561
|
-
| \`splitter\` | 49,804 | 16,210 | 14,531 | 20,431 | 4,937 | 4,
|
|
4562
|
-
| \`stat\` | 28,117 | 10,372 | 9,280 | 5,157 | 1,482 | 1,
|
|
4563
|
-
| \`steps\` | 67,449 | 21,
|
|
4564
|
-
| \`strands\` | 62,138 | 23,148 | 20,
|
|
4565
|
-
| \`switch\` | 43,562 | 14,637 | 13,
|
|
4566
|
-
| \`table\` | 135,900 | 40,155 | 34,
|
|
4567
|
-
| \`tabs\` | 55,263 | 17,753 | 15,
|
|
4568
|
-
| \`tag\` | 47,247 | 16,757 | 14,
|
|
4569
|
-
| \`text\` | 28,756 | 9,943 | 8,755 | 7,396 | 1,519 | 1,
|
|
4570
|
-
| \`textarea\` | 47,785 | 15,949 | 14,
|
|
4571
|
-
| \`time-input\` | 193,597 | 56,836 | 49,
|
|
4572
|
-
| \`time-picker\` | 111,928 | 33,946 | 29,
|
|
4573
|
-
| \`timeline\` | 38,179 | 13,326 | 11,
|
|
4574
|
-
| \`toast\` | 58,767 | 19,
|
|
4575
|
-
| \`toggle\` | 50,439 | 16,510 | 14,
|
|
4576
|
-
| \`toolbar\` | 33,726 | 12,066 | 10,723 | 7,822 | 2,163 | 1,
|
|
4577
|
-
| \`tooltip\` | 61,420 | 21,833 | 19,
|
|
4578
|
-
| \`tour\` | 93,661 | 30,
|
|
4579
|
-
| \`tree\` | 76,275 | 24,651 | 21,
|
|
4580
|
-
| \`trend\` | 31,231 | 12,
|
|
4581
|
-
| \`video\` | 161,715 | 47,866 | 41,
|
|
4582
|
-
| \`video-playlist\` | 143,639 | 44,
|
|
4583
|
-
| \`virtual-list\` | 65,445 | 22,136 | 19,
|
|
4543
|
+
| \`accordion\` | 35,311 | 12,654 | 11,236 | 8,746 | 2,463 | 1,998 |
|
|
4544
|
+
| \`announcement\` | 41,307 | 14,365 | 12,844 | 9,278 | 2,489 | 2,054 |
|
|
4545
|
+
| \`app-header\` | 37,449 | 13,103 | 11,662 | 11,016 | 3,009 | 2,470 |
|
|
4546
|
+
| \`area-chart\` | 98,393 | 33,578 | 29,660 | 22,131 | 6,256 | 5,025 |
|
|
4547
|
+
| \`aura\` | 56,085 | 19,320 | 17,126 | 29,774 | 9,335 | 7,865 |
|
|
4548
|
+
| \`avatar\` | 33,464 | 12,351 | 11,051 | 6,945 | 2,007 | 1,685 |
|
|
4549
|
+
| \`badge\` | 32,595 | 11,820 | 10,531 | 8,438 | 2,177 | 1,748 |
|
|
4550
|
+
| \`bar-chart\` | 108,944 | 35,724 | 31,568 | 32,533 | 8,394 | 6,820 |
|
|
4551
|
+
| \`blockquote\` | 26,332 | 9,968 | 8,824 | 4,612 | 1,452 | 1,164 |
|
|
4552
|
+
| \`breadcrumbs\` | 43,220 | 15,115 | 13,466 | 14,285 | 3,697 | 3,044 |
|
|
4553
|
+
| \`button\` | 41,612 | 14,007 | 12,441 | 11,324 | 2,907 | 2,346 |
|
|
4554
|
+
| \`button-group\` | 31,138 | 11,066 | 9,805 | 8,409 | 2,230 | 1,841 |
|
|
4555
|
+
| \`callout\` | 39,049 | 14,537 | 12,949 | 6,659 | 1,950 | 1,535 |
|
|
4556
|
+
| \`canvas\` | 129,523 | 38,718 | 33,863 | 89,611 | 24,897 | 20,987 |
|
|
4557
|
+
| \`card\` | 27,678 | 10,060 | 8,915 | 5,976 | 1,650 | 1,363 |
|
|
4558
|
+
| \`carousel\` | 53,234 | 17,022 | 15,256 | 25,477 | 6,038 | 4,946 |
|
|
4559
|
+
| \`chat\` | 94,674 | 29,166 | 25,830 | 42,730 | 10,859 | 8,749 |
|
|
4560
|
+
| \`checkbox\` | 46,865 | 15,190 | 13,516 | 9,580 | 2,503 | 1,920 |
|
|
4561
|
+
| \`checkbox-group\` | 54,826 | 17,244 | 15,360 | 15,542 | 4,028 | 3,169 |
|
|
4562
|
+
| \`code\` | 21,154 | 8,333 | 7,402 | 976 | 399 | 301 |
|
|
4563
|
+
| \`code-block\` | 127,213 | 38,714 | 34,143 | 61,300 | 14,740 | 12,109 |
|
|
4564
|
+
| \`color-input\` | 184,176 | 51,348 | 44,934 | 97,504 | 20,559 | 17,166 |
|
|
4565
|
+
| \`color-picker\` | 140,348 | 38,508 | 33,775 | 84,177 | 18,389 | 15,187 |
|
|
4566
|
+
| \`combobox\` | 147,503 | 44,927 | 39,531 | 51,254 | 12,085 | 9,694 |
|
|
4567
|
+
| \`command\` | 110,791 | 33,835 | 29,880 | 41,332 | 10,522 | 8,545 |
|
|
4568
|
+
| \`copy-button\` | 92,577 | 29,825 | 26,416 | 30,355 | 7,219 | 5,801 |
|
|
4569
|
+
| \`data-table\` | 230,715 | 66,818 | 57,324 | 120,282 | 29,306 | 23,816 |
|
|
4570
|
+
| \`date-input\` | 162,349 | 48,215 | 42,468 | 59,336 | 13,196 | 10,823 |
|
|
4571
|
+
| \`date-picker\` | 69,281 | 22,363 | 20,060 | 28,250 | 7,010 | 5,666 |
|
|
4572
|
+
| \`description-list\` | 25,855 | 9,518 | 8,459 | 4,508 | 1,284 | 1,017 |
|
|
4573
|
+
| \`dialog\` | 43,360 | 14,855 | 13,244 | 10,933 | 3,007 | 2,490 |
|
|
4574
|
+
| \`divider\` | 25,291 | 9,547 | 8,433 | 3,699 | 1,140 | 891 |
|
|
4575
|
+
| \`donut-chart\` | 99,170 | 33,263 | 29,415 | 24,576 | 6,712 | 5,427 |
|
|
4576
|
+
| \`drawer\` | 48,725 | 16,509 | 14,724 | 13,512 | 3,708 | 2,986 |
|
|
4577
|
+
| \`drilldown\` | 48,438 | 16,235 | 14,469 | 15,378 | 4,052 | 3,262 |
|
|
4578
|
+
| \`empty\` | 25,503 | 9,726 | 8,598 | 3,242 | 1,117 | 896 |
|
|
4579
|
+
| \`file-input\` | 69,285 | 22,420 | 19,930 | 24,612 | 6,551 | 5,279 |
|
|
4580
|
+
| \`filter-input\` | 108,688 | 34,990 | 30,999 | 32,465 | 8,412 | 6,787 |
|
|
4581
|
+
| \`flex\` | 25,740 | 9,194 | 8,149 | 4,763 | 1,047 | 850 |
|
|
4582
|
+
| \`format-date\` | 30,414 | 11,403 | 10,189 | 4,672 | 1,402 | 1,050 |
|
|
4583
|
+
| \`graph\` | 89,037 | 27,079 | 23,901 | 36,528 | 9,184 | 7,421 |
|
|
4584
|
+
| \`grid\` | 27,002 | 9,846 | 8,742 | 5,638 | 1,467 | 1,312 |
|
|
4585
|
+
| \`heatmap\` | 105,486 | 35,189 | 31,063 | 26,281 | 7,264 | 5,929 |
|
|
4586
|
+
| \`icon\` | 83,995 | 28,566 | 24,515 | 60,129 | 20,177 | 16,474 |
|
|
4587
|
+
| \`icon-button\` | 43,040 | 13,981 | 12,435 | 12,753 | 2,882 | 2,258 |
|
|
4588
|
+
| \`image\` | 26,892 | 9,947 | 8,792 | 5,194 | 1,620 | 1,337 |
|
|
4589
|
+
| \`input\` | 50,619 | 17,063 | 15,049 | 11,597 | 3,559 | 2,663 |
|
|
4590
|
+
| \`isometric-heatmap\` | 110,852 | 36,558 | 32,275 | 31,598 | 8,642 | 6,913 |
|
|
4591
|
+
| \`kbd\` | 29,504 | 11,110 | 9,838 | 5,494 | 1,685 | 1,342 |
|
|
4592
|
+
| \`legend\` | 40,423 | 14,214 | 12,607 | 8,067 | 2,264 | 1,846 |
|
|
4593
|
+
| \`lightbox\` | 62,016 | 20,155 | 17,964 | 23,006 | 6,017 | 4,683 |
|
|
4594
|
+
| \`line-chart\` | 102,454 | 34,257 | 30,340 | 25,863 | 6,849 | 5,539 |
|
|
4595
|
+
| \`list\` | 68,150 | 22,816 | 20,343 | 21,569 | 5,958 | 4,706 |
|
|
4596
|
+
| \`listbox\` | 81,154 | 26,542 | 23,465 | 19,994 | 5,703 | 4,473 |
|
|
4597
|
+
| \`loader\` | 29,263 | 10,814 | 9,643 | 5,642 | 1,730 | 1,396 |
|
|
4598
|
+
| \`map\` | 111,513 | 29,575 | 25,948 | 69,961 | 15,525 | 12,703 |
|
|
4599
|
+
| \`megamenu\` | 64,996 | 22,865 | 20,305 | 13,547 | 3,558 | 2,813 |
|
|
4600
|
+
| \`menu\` | 108,403 | 34,710 | 30,612 | 41,098 | 10,160 | 8,290 |
|
|
4601
|
+
| \`meter\` | 37,896 | 13,377 | 11,948 | 11,050 | 2,820 | 2,322 |
|
|
4602
|
+
| \`navigation\` | 36,814 | 13,268 | 11,774 | 7,077 | 2,025 | 1,612 |
|
|
4603
|
+
| \`notifications\` | 71,808 | 22,447 | 19,990 | 31,663 | 7,637 | 6,248 |
|
|
4604
|
+
| \`number-input\` | 61,253 | 20,024 | 17,846 | 18,491 | 4,850 | 3,838 |
|
|
4605
|
+
| \`object-inspector\` | 130,338 | 41,206 | 36,258 | 51,884 | 13,190 | 10,666 |
|
|
4606
|
+
| \`option\` | 29,672 | 10,762 | 9,552 | 7,712 | 2,213 | 1,846 |
|
|
4607
|
+
| \`orb\` | 35,265 | 13,488 | 12,001 | 9,730 | 3,689 | 3,108 |
|
|
4608
|
+
| \`outline\` | 37,846 | 13,459 | 11,945 | 12,073 | 3,491 | 2,800 |
|
|
4609
|
+
| \`pagination\` | 153,264 | 46,929 | 40,857 | 62,366 | 15,240 | 12,281 |
|
|
4610
|
+
| \`pin-input\` | 50,409 | 17,316 | 15,449 | 10,058 | 3,179 | 2,402 |
|
|
4611
|
+
| \`popover\` | 66,958 | 23,702 | 20,940 | 9,509 | 2,658 | 2,109 |
|
|
4612
|
+
| \`progress\` | 35,232 | 12,380 | 11,035 | 10,101 | 2,602 | 2,225 |
|
|
4613
|
+
| \`qr-code\` | 44,321 | 17,121 | 15,278 | 18,589 | 6,787 | 5,736 |
|
|
4614
|
+
| \`quote\` | 23,074 | 9,079 | 8,006 | 1,752 | 733 | 509 |
|
|
4615
|
+
| \`radio\` | 50,349 | 15,977 | 14,203 | 11,594 | 2,766 | 2,213 |
|
|
4616
|
+
| \`rating\` | 54,190 | 18,519 | 16,486 | 11,946 | 3,671 | 2,903 |
|
|
4617
|
+
| \`sandbox\` | 104,428 | 31,486 | 27,640 | 72,147 | 19,289 | 16,119 |
|
|
4618
|
+
| \`scatter-chart\` | 100,317 | 33,785 | 29,869 | 25,197 | 6,982 | 5,771 |
|
|
4619
|
+
| \`scroll-area\` | 35,437 | 12,027 | 10,702 | 13,489 | 3,582 | 2,961 |
|
|
4620
|
+
| \`select\` | 124,418 | 40,070 | 35,154 | 35,147 | 9,067 | 7,129 |
|
|
4621
|
+
| \`skeleton\` | 26,090 | 9,664 | 8,589 | 4,738 | 1,432 | 1,187 |
|
|
4622
|
+
| \`skip-link\` | 25,441 | 9,852 | 8,690 | 2,780 | 983 | 736 |
|
|
4623
|
+
| \`slider\` | 67,842 | 20,140 | 18,005 | 28,108 | 6,184 | 5,032 |
|
|
4624
|
+
| \`sparkline\` | 53,442 | 18,851 | 16,826 | 11,421 | 3,519 | 2,864 |
|
|
4625
|
+
| \`speed-dial\` | 75,797 | 26,105 | 23,139 | 17,946 | 4,404 | 3,516 |
|
|
4626
|
+
| \`splitter\` | 49,804 | 16,210 | 14,531 | 20,431 | 4,937 | 4,039 |
|
|
4627
|
+
| \`stat\` | 28,117 | 10,372 | 9,280 | 5,157 | 1,482 | 1,194 |
|
|
4628
|
+
| \`steps\` | 67,449 | 21,377 | 19,024 | 27,416 | 6,635 | 5,515 |
|
|
4629
|
+
| \`strands\` | 62,138 | 23,148 | 20,396 | 38,015 | 13,797 | 11,910 |
|
|
4630
|
+
| \`switch\` | 43,562 | 14,637 | 13,010 | 5,998 | 1,792 | 1,391 |
|
|
4631
|
+
| \`table\` | 135,900 | 40,155 | 34,934 | 62,687 | 15,581 | 12,776 |
|
|
4632
|
+
| \`tabs\` | 55,263 | 17,753 | 15,835 | 19,437 | 4,783 | 3,841 |
|
|
4633
|
+
| \`tag\` | 47,247 | 16,757 | 14,968 | 13,016 | 3,658 | 2,921 |
|
|
4634
|
+
| \`text\` | 28,756 | 9,943 | 8,755 | 7,396 | 1,519 | 1,235 |
|
|
4635
|
+
| \`textarea\` | 47,785 | 15,949 | 14,228 | 9,318 | 2,677 | 2,078 |
|
|
4636
|
+
| \`time-input\` | 193,597 | 56,836 | 49,504 | 72,824 | 16,646 | 13,498 |
|
|
4637
|
+
| \`time-picker\` | 111,928 | 33,946 | 29,864 | 46,251 | 11,628 | 9,328 |
|
|
4638
|
+
| \`timeline\` | 38,179 | 13,326 | 11,930 | 10,947 | 2,751 | 2,261 |
|
|
4639
|
+
| \`toast\` | 58,767 | 19,784 | 17,637 | 20,006 | 5,408 | 4,422 |
|
|
4640
|
+
| \`toggle\` | 50,439 | 16,510 | 14,668 | 10,854 | 3,077 | 2,438 |
|
|
4641
|
+
| \`toolbar\` | 33,726 | 12,066 | 10,723 | 7,822 | 2,163 | 1,769 |
|
|
4642
|
+
| \`tooltip\` | 61,420 | 21,833 | 19,366 | 11,220 | 3,137 | 2,485 |
|
|
4643
|
+
| \`tour\` | 93,661 | 30,696 | 27,184 | 29,787 | 7,497 | 6,053 |
|
|
4644
|
+
| \`tree\` | 76,275 | 24,651 | 21,972 | 25,874 | 6,942 | 5,517 |
|
|
4645
|
+
| \`trend\` | 31,231 | 12,049 | 10,722 | 4,982 | 1,613 | 1,281 |
|
|
4646
|
+
| \`video\` | 161,715 | 47,866 | 41,707 | 86,712 | 20,444 | 16,977 |
|
|
4647
|
+
| \`video-playlist\` | 143,639 | 44,278 | 38,886 | 58,709 | 14,189 | 11,798 |
|
|
4648
|
+
| \`virtual-list\` | 65,445 | 22,136 | 19,655 | 25,282 | 7,676 | 6,231 |
|
|
4584
4649
|
|
|
4585
4650
|
## What an install adds to \`node_modules\`
|
|
4586
4651
|
|
|
@@ -4593,11 +4658,11 @@ stripped column shows the bytes we removed.
|
|
|
4593
4658
|
| Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
|
|
4594
4659
|
|---|---|---|---|---|
|
|
4595
4660
|
| \`@fusion.dev/helix-core\` | 2,561,244 | 559 | 727,996 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\`, \`tslib\` |
|
|
4596
|
-
| \`@fusion.dev/helix-headless\` |
|
|
4661
|
+
| \`@fusion.dev/helix-headless\` | 25,354,104 | 716 | 2,256,499 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`tslib\`, \`uqr\` |
|
|
4597
4662
|
| \`@fusion.dev/helix-icons\` | 150,509 | 21 | 48,154 | \`svgo\` |
|
|
4598
|
-
| \`@fusion.dev/helix-styles\` | 121,
|
|
4663
|
+
| \`@fusion.dev/helix-styles\` | 121,089 | 6 | 0 | none |
|
|
4599
4664
|
| \`@fusion.dev/helix-theme\` | 529,299 | 8 | 5,393 | none |
|
|
4600
|
-
| \`@fusion.dev/helix\` |
|
|
4665
|
+
| \`@fusion.dev/helix\` | 26,639,279 | 968 | 539,177 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\`, \`tslib\` |
|
|
4601
4666
|
|
|
4602
4667
|
## Not measured yet
|
|
4603
4668
|
|
|
@@ -7641,7 +7706,7 @@ type needs less leading. \`--helix-leading-heading\` expresses that once, so no
|
|
|
7641
7706
|
heading level needs its own multiplier.
|
|
7642
7707
|
`,
|
|
7643
7708
|
'using-helix-with-an-agent': `---
|
|
7644
|
-
description:
|
|
7709
|
+
description: Five mistakes that look like Helix bugs, and the files an agent should read.
|
|
7645
7710
|
parent: coding-agents
|
|
7646
7711
|
section: Getting started
|
|
7647
7712
|
title: Using Helix with an agent
|
|
@@ -7666,42 +7731,53 @@ link to. Paste the link into the file your tool reads. [The MCP
|
|
|
7666
7731
|
server](./coding-agents) works with any vendor and runs code, and Claude,
|
|
7667
7732
|
Cursor, Windsurf, and Zed all support it.
|
|
7668
7733
|
|
|
7669
|
-
## Read the
|
|
7734
|
+
## Read the family before writing its tags
|
|
7670
7735
|
|
|
7671
7736
|
\`\`\`
|
|
7672
|
-
https://fusion.dev/helix/
|
|
7673
|
-
|
|
7737
|
+
https://fusion.dev/helix/components/<family>.md
|
|
7738
|
+
https://fusion.dev/helix/components/<family>.json
|
|
7674
7739
|
\`\`\`
|
|
7675
7740
|
|
|
7676
|
-
|
|
7741
|
+
Each family's file lists:
|
|
7677
7742
|
|
|
7743
|
+
- the import lines for the family
|
|
7678
7744
|
- every tag
|
|
7679
7745
|
- every property, with its literal union
|
|
7680
|
-
- every event, with its class
|
|
7746
|
+
- every event, with its class and its React prop
|
|
7681
7747
|
- every slot, part, and custom property
|
|
7748
|
+
- the examples, each with the import lines it needs
|
|
7682
7749
|
|
|
7683
|
-
**If a tag is not in
|
|
7684
|
-
a declared union is invalid. Property types are literal unions for this
|
|
7685
|
-
\`'ghost' | 'outlined' | 'solid' | 'subtle'\` shows you the values, and a
|
|
7686
|
-
type such as \`ButtonEmphasis\` sends you somewhere else to find them.
|
|
7687
|
-
|
|
7688
|
-
When you need one family, fetch it as data:
|
|
7689
|
-
|
|
7690
|
-
\`\`\`
|
|
7691
|
-
https://fusion.dev/helix/components/<family>.json
|
|
7692
|
-
https://fusion.dev/helix/components/<family>.md
|
|
7693
|
-
\`\`\`
|
|
7750
|
+
**If a tag is not in a family's file, it does not exist.** A property value
|
|
7751
|
+
outside a declared union is invalid. Property types are literal unions for this
|
|
7752
|
+
reason. \`'ghost' | 'outlined' | 'solid' | 'subtle'\` shows you the values, and a
|
|
7753
|
+
named type such as \`ButtonEmphasis\` sends you somewhere else to find them.
|
|
7694
7754
|
|
|
7695
|
-
The
|
|
7696
|
-
|
|
7697
|
-
request, it names every
|
|
7755
|
+
The manifest at \`https://fusion.dev/helix/custom-elements.json\` holds every
|
|
7756
|
+
family in one file, which is several megabytes. Read the families you use.
|
|
7757
|
+
Start from \`https://fusion.dev/llms.txt\`. In one request, it names every
|
|
7758
|
+
document and the machine-readable sources.
|
|
7698
7759
|
|
|
7699
|
-
##
|
|
7760
|
+
## Five mistakes that look like Helix bugs
|
|
7700
7761
|
|
|
7701
7762
|
Each of these looks like a bug in Helix. They are listed from the most common to
|
|
7702
7763
|
the least common.
|
|
7703
7764
|
|
|
7704
|
-
### 1.
|
|
7765
|
+
### 1. Writing a tag without importing its family
|
|
7766
|
+
|
|
7767
|
+
Each tag needs its family's entry imported. A family does not register another
|
|
7768
|
+
family's elements that you write inside it, so a Select needs Option imported
|
|
7769
|
+
beside it, and a Data Table needs Table:
|
|
7770
|
+
|
|
7771
|
+
\`\`\`js
|
|
7772
|
+
import '@fusion.dev/helix/select'
|
|
7773
|
+
import '@fusion.dev/helix/option'
|
|
7774
|
+
\`\`\`
|
|
7775
|
+
|
|
7776
|
+
Without the second line, the options are unknown elements and the Select offers
|
|
7777
|
+
nothing. Each family's Usage block and each example list the lines to import.
|
|
7778
|
+
Copy them with the markup.
|
|
7779
|
+
|
|
7780
|
+
### 2. Blocking a change without \`preventDefault()\`
|
|
7705
7781
|
|
|
7706
7782
|
**Setting \`value\`, \`open\`, \`checked\`, or \`active\` sets the starting state and
|
|
7707
7783
|
corrects the current state.** The element starts in that state and then applies
|
|
@@ -7733,7 +7809,7 @@ block a change, call \`preventDefault()\` on the matching \`helix-before-*\` eve
|
|
|
7733
7809
|
A form reset returns the element to \`default-value\` and the matching attributes
|
|
7734
7810
|
for the other states. See [State and control](./state-and-control).
|
|
7735
7811
|
|
|
7736
|
-
###
|
|
7812
|
+
### 3. Using the exact event name
|
|
7737
7813
|
|
|
7738
7814
|
In React, write \`onhelix-before-open\`. \`onHelixOpen\` and \`onOpen\` do not work.
|
|
7739
7815
|
React removes \`on\` from the prop name and listens for exactly the rest, so the
|
|
@@ -7747,7 +7823,7 @@ so a menu closing inside a dialog does not close the dialog. \`helix-select\`,
|
|
|
7747
7823
|
listen for them on a container. If a listener on a wrapper receives nothing, the
|
|
7748
7824
|
event is a lifecycle event. Put the listener on the element.
|
|
7749
7825
|
|
|
7750
|
-
###
|
|
7826
|
+
### 4. Styling a disabled control with \`:disabled\`
|
|
7751
7827
|
|
|
7752
7828
|
\`\`\`css
|
|
7753
7829
|
helix-input:disabled { … } /* right: matches a disabled fieldset too */
|
|
@@ -7758,7 +7834,7 @@ The browser disables a control inside \`<fieldset disabled>\` without adding an
|
|
|
7758
7834
|
attribute to it. The \`[disabled]\` selector does not match it, so the control
|
|
7759
7835
|
looks enabled while it does not accept input.
|
|
7760
7836
|
|
|
7761
|
-
###
|
|
7837
|
+
### 5. Loading every style layer before the elements
|
|
7762
7838
|
|
|
7763
7839
|
\`\`\`ts
|
|
7764
7840
|
import '@fusion.dev/helix-styles/helix.css'
|
|
@@ -7879,18 +7955,15 @@ directory you own. You paste the line above, and you can delete it.
|
|
|
7879
7955
|
|
|
7880
7956
|
## Install the Helix MCP server
|
|
7881
7957
|
|
|
7882
|
-
\`\`\`
|
|
7883
|
-
|
|
7884
|
-
"mcpServers": {
|
|
7885
|
-
"helix": { "command": "helix", "args": ["mcp"] }
|
|
7886
|
-
}
|
|
7887
|
-
}
|
|
7958
|
+
\`\`\`sh
|
|
7959
|
+
helix mcp init --client claude
|
|
7888
7960
|
\`\`\`
|
|
7889
7961
|
|
|
7890
|
-
\`helix mcp\`
|
|
7891
|
-
|
|
7892
|
-
|
|
7893
|
-
|
|
7962
|
+
\`helix mcp\` answers from the Helix packages your project installs: families,
|
|
7963
|
+
examples, import lines, tokens, and the theme a brand color produces. \`--client\`
|
|
7964
|
+
takes \`claude\`, \`cursor\`, or \`vscode\`, and writes the server into the file that
|
|
7965
|
+
client reads. [Coding agents](./coding-agents) lists the tools. It runs on your
|
|
7966
|
+
machine, talks to a client you chose, and makes no network requests.
|
|
7894
7967
|
|
|
7895
7968
|
## What this guide does not cover
|
|
7896
7969
|
|
|
@@ -7898,10 +7971,9 @@ you chose, and makes no network requests.
|
|
|
7898
7971
|
and hooks change with the library, and they are in a file you can fetch. A list
|
|
7899
7972
|
of them here would be a second copy that goes stale. Fetch the family.
|
|
7900
7973
|
|
|
7901
|
-
**The theme a brand color produces.** Helix computes it, so
|
|
7902
|
-
|
|
7903
|
-
|
|
7904
|
-
machine, and we do not host it.
|
|
7974
|
+
**The theme a brand color produces.** Helix computes it, so call
|
|
7975
|
+
\`helix_derive_theme\`, or run \`helix theme build\`. Both take the same JSON that a
|
|
7976
|
+
\`helix.theme.json\` file holds.
|
|
7905
7977
|
|
|
7906
7978
|
**Whether a component fits your case.** Read the examples to decide. Every
|
|
7907
7979
|
family's \`.md\` file includes them as text, and
|