npm - @fusion.dev/helix-docs - Versions diffs - 0.54.0 → 0.55.0 - Mend

@fusion.dev/helix-docs 0.54.0 → 0.55.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.

Files changed (5) hide show

package/content/metrics.mdx +30 -30
package/content/size-and-density.mdx +6 -2
package/content/visual-axes.mdx +32 -4
package/dist/sources.generated.js +68 -36
package/package.json +3 -3

package/content/metrics.mdx CHANGED Viewed

@@ -59,10 +59,10 @@ repository does that. The per-component tables are what a page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 147,226 | 48,349 | 40,887 | Element base class, mixins, decorators, floating positioning. |
-| `@fusion.dev/helix-headless` | 603,471 | 156,550 | 121,866 | Every headless family, which is what the barrel means. |
+| `@fusion.dev/helix-headless` | 603,522 | 156,553 | 121,886 | Every headless family, which is what the barrel means. |
 | `@fusion.dev/helix-icons` | 47,484 | 14,907 | 12,553 | The whole glyph set. |
 | `@fusion.dev/helix-theme` | 3,288 | 1,571 | 1,355 | The derivation engine. Build time for most consumers, runtime for a theme switcher. |
-| `@fusion.dev/helix` | 1,080,878 | 253,701 | 185,862 | Every styled family. |
+| `@fusion.dev/helix` | 1,081,980 | 253,807 | 186,053 | Every styled family. |
 | `lit` | 15,394 | 6,118 | 5,460 | Not ours. Here so it can be subtracted from every row above it. |
 ## The stylesheets
@@ -83,13 +83,13 @@ is the whole cost of adopting the base layer on its own.
 ## What the numbers say
-**Most of a first component is the runtime under it.** The median styled family is 18,826 bytes gzipped alone and adds 2,205 to a page that already has Helix on it, so 88 percent of the first one is shared and 12 percent is the component. Ten typical components are one plus nine additions rather than ten of the first number, and the pair of columns below is what lets that be worked out rather than guessed.
+**Most of a first component is the runtime under it.** The median styled family is 18,826 bytes gzipped alone and adds 2,218 to a page that already has Helix on it, so 88 percent of the first one is shared and 12 percent is the component. Ten typical components are one plus nine additions rather than ten of the first number, and the pair of columns below is what lets that be worked out rather than guessed.
-Across the tier: the cheapest is `code` at 9,451 gzipped alone, the dearest `data-table` at 59,152, over 100 components. Every family at once is 253,701.
+Across the tier: the cheapest is `code` at 9,451 gzipped alone, the dearest `data-table` at 59,198, over 100 components. Every family at once is 253,807.
-**No family imports a barrel, and the `barrels` rule in `fusion workspace` is what keeps it that way.** `@fusion.dev/helix-headless` is `sideEffects` over every module in `dist`, which is true of a file that calls `customElements.define` and which means a bundler may drop none of it: one `import { HelixHeadlessButton } from '@fusion.dev/helix-headless'` costs 156,550 bytes gzipped whatever else the page does, which is 8 times the median family measured above. The styled tier imports the family it extends instead, all 100 of them, and the check refuses the shape rather than the package name, so the rule follows `sideEffects` wherever it goes.
+**No family imports a barrel, and the `barrels` rule in `fusion workspace` is what keeps it that way.** `@fusion.dev/helix-headless` is `sideEffects` over every module in `dist`, which is true of a file that calls `customElements.define` and which means a bundler may drop none of it: one `import { HelixHeadlessButton } from '@fusion.dev/helix-headless'` costs 156,553 bytes gzipped whatever else the page does, which is 8 times the median family measured above. The styled tier imports the family it extends instead, all 100 of them, and the check refuses the shape rather than the package name, so the rule follows `sideEffects` wherever it goes.
-The headless tier never had the problem, and it is the control: `@fusion.dev/helix-core` is `sideEffects: false`, and a headless family is a median of 20,532 bytes gzipped alone.
+The headless tier never had the problem, and it is the control: `@fusion.dev/helix-core` is `sideEffects: false`, and a headless family is a median of 20,530 bytes gzipped alone.
 ## Against other systems
@@ -106,17 +106,17 @@ Four other libraries of custom elements, pinned and measured on 2026-08-24 by `t
 | | Material Web | 47,060 | 14,173 | 12,591 |
 | | Shoelace | 62,628 | 18,287 | 15,805 |
 | | Spectrum | 98,792 | 22,045 | 18,674 |
-| `checkbox` | **Helix** | 42,376 | 13,006 | 11,453 |
+| `checkbox` | **Helix** | 42,841 | 13,039 | 11,450 |
 | | 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** | 36,307 | 11,623 | 10,259 |
+| `dialog` | **Helix** | 36,349 | 11,636 | 10,265 |
 | | 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** | 45,833 | 13,387 | 11,823 |
+| `radio` | **Helix** | 46,423 | 13,448 | 11,882 |
 | | Carbon | 63,055 | 16,887 | 14,605 |
 | | Material Web | 41,044 | 13,234 | 11,757 |
 | | Shoelace | 34,865 | 12,027 | 10,559 |
@@ -137,7 +137,7 @@ Four other libraries of custom elements, pinned and measured on 2026-08-24 by `t
 | | Shoelace | 57,412 | 20,220 | 17,933 |
 | | Spectrum | 136,599 | 40,552 | 35,286 |
-**Where Helix loses**, which is the half of a comparison table worth reading: `dialog`, `radio`, `switch`, `tabs`, `tooltip`. The largest gap is radio against Spectrum, by 2,727 bytes gzipped. 7 of 28 peer measurements come in under ours.
+**Where Helix loses**, which is the half of a comparison table worth reading: `dialog`, `radio`, `switch`, `tabs`, `tooltip`. The largest gap is radio against Spectrum, by 2,788 bytes gzipped. 7 of 28 peer measurements come in under ours.
 - **Carbon** `@carbon/web-components@2.61.0`. Its dialog is Modal, its radio is Radio Button, and its switch is Toggle.
 - **Material Web** `@material/web@2.5.0`. Ships no tooltip. Its button is measured as the filled one, there being no single button element.
@@ -188,7 +188,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | `area-chart` | 74,755 | 25,601 | 22,598 | 11,066 | 3,413 | 2,823 |
 | `avatar` | 30,963 | 10,323 | 9,111 | 3,257 | 919 | 732 |
 | `badge` | 28,449 | 9,658 | 8,493 | 1,162 | 297 | 241 |
-| `bar-chart` | 76,394 | 25,965 | 22,972 | 12,696 | 3,773 | 3,124 |
+| `bar-chart` | 76,406 | 25,966 | 22,962 | 12,708 | 3,774 | 3,131 |
 | `blockquote` | 28,464 | 9,687 | 8,534 | 774 | 177 | 118 |
 | `breadcrumbs` | 76,525 | 25,352 | 20,888 | 1,965 | 441 | 363 |
 | `button` | 32,931 | 10,866 | 9,561 | 3,137 | 810 | 711 |
@@ -206,7 +206,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | `combobox` | 132,319 | 42,745 | 35,897 | 20,388 | 5,072 | 4,193 |
 | `command` | 102,707 | 32,668 | 26,883 | 17,705 | 4,516 | 3,718 |
 | `copy-button` | 115,835 | 38,799 | 32,590 | 11,901 | 2,968 | 2,456 |
-| `data-table` | 170,373 | 52,745 | 44,536 | 54,836 | 13,935 | 11,551 |
+| `data-table` | 170,408 | 52,757 | 44,535 | 54,871 | 13,943 | 11,715 |
 | `date-input` | 130,322 | 42,258 | 35,456 | 18,550 | 4,750 | 3,954 |
 | `date-picker` | 87,537 | 28,957 | 23,814 | 9,997 | 2,810 | 2,281 |
 | `description-list` | 28,423 | 9,527 | 8,396 | 1,132 | 178 | 172 |
@@ -230,7 +230,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | `list` | 29,375 | 9,761 | 8,590 | 1,725 | 343 | 256 |
 | `listbox` | 94,458 | 30,818 | 25,165 | 10,942 | 2,996 | 2,362 |
 | `loader` | 28,560 | 9,693 | 8,526 | 900 | 224 | 162 |
-| `megamenu` | 58,768 | 20,368 | 17,992 | 4,941 | 1,357 | 1,072 |
+| `megamenu` | 58,768 | 20,365 | 18,023 | 4,941 | 1,355 | 989 |
 | `menu` | 114,091 | 38,572 | 32,324 | 8,816 | 2,239 | 1,745 |
 | `meter` | 31,750 | 10,542 | 9,277 | 4,099 | 1,047 | 882 |
 | `navigation` | 30,198 | 10,203 | 9,003 | 1,361 | 358 | 280 |
@@ -259,7 +259,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | `stat` | 28,808 | 9,624 | 8,464 | 1,148 | 189 | 159 |
 | `steps` | 84,562 | 27,788 | 22,780 | 6,219 | 1,510 | 1,168 |
 | `switch` | 35,949 | 11,576 | 10,243 | 1,524 | 481 | 350 |
-| `table` | 85,428 | 28,370 | 23,263 | 9,221 | 2,572 | 2,132 |
+| `table` | 85,463 | 28,383 | 23,227 | 9,256 | 2,581 | 2,075 |
 | `tabs` | 36,077 | 11,569 | 10,198 | 3,925 | 911 | 720 |
 | `tag` | 75,927 | 25,307 | 20,715 | 897 | 191 | 194 |
 | `textarea` | 38,454 | 12,148 | 10,669 | 4,026 | 1,101 | 867 |
@@ -288,31 +288,31 @@ The headless tier plus presentation. This is what `bun add @fusion.dev/helix` gi
 | `app-header` | 32,804 | 10,624 | 9,379 | 5,121 | 1,226 | 1,076 |
 | `area-chart` | 82,141 | 27,208 | 24,027 | 18,433 | 5,026 | 4,214 |
 | `aura` | 94,970 | 32,811 | 28,423 | 66,522 | 23,026 | 19,836 |
-| `avatar` | 34,548 | 11,085 | 9,765 | 6,832 | 1,691 | 1,349 |
+| `avatar` | 34,549 | 11,085 | 9,765 | 6,833 | 1,689 | 1,356 |
 | `badge` | 31,553 | 10,365 | 9,136 | 4,249 | 1,008 | 847 |
-| `bar-chart` | 89,160 | 28,516 | 25,225 | 25,442 | 6,337 | 5,281 |
+| `bar-chart` | 89,210 | 28,519 | 25,248 | 25,492 | 6,339 | 5,292 |
 | `blockquote` | 29,620 | 9,970 | 8,765 | 1,914 | 477 | 368 |
 | `breadcrumbs` | 80,091 | 26,152 | 21,562 | 5,518 | 1,240 | 1,051 |
 | `button` | 39,024 | 11,978 | 10,565 | 9,212 | 1,934 | 1,662 |
 | `button-group` | 29,996 | 9,950 | 8,756 | 2,320 | 528 | 499 |
 | `callout` | 77,642 | 25,753 | 21,314 | 2,895 | 767 | 634 |
 | `card` | 31,587 | 10,410 | 9,158 | 3,915 | 980 | 943 |
-| `carousel` | 94,968 | 29,707 | 24,655 | 20,108 | 4,328 | 3,725 |
+| `carousel` | 94,840 | 29,701 | 24,624 | 19,980 | 4,320 | 3,700 |
 | `chat` | 113,049 | 35,489 | 29,342 | 31,432 | 7,585 | 6,423 |
-| `checkbox` | 42,376 | 13,006 | 11,453 | 8,337 | 2,064 | 1,778 |
+| `checkbox` | 42,841 | 13,039 | 11,450 | 8,802 | 2,100 | 1,785 |
 | `checkbox-group` | 41,537 | 12,854 | 11,324 | 6,981 | 1,839 | 1,407 |
 | `code` | 28,016 | 9,451 | 8,318 | 1,511 | 366 | 327 |
 | `code-block` | 137,688 | 43,293 | 36,473 | 33,731 | 7,278 | 6,200 |
 | `color-input` | 168,628 | 48,951 | 41,328 | 59,311 | 11,851 | 10,104 |
 | `color-picker` | 130,441 | 37,570 | 31,204 | 47,984 | 9,957 | 8,550 |
 | `combobox` | 147,122 | 45,410 | 38,194 | 35,172 | 7,737 | 6,383 |
-| `command` | 113,170 | 34,701 | 28,584 | 28,157 | 6,589 | 5,541 |
+| `command` | 113,212 | 34,712 | 28,636 | 28,199 | 6,600 | 5,573 |
 | `copy-button` | 125,839 | 40,569 | 34,091 | 21,887 | 4,687 | 3,940 |
-| `data-table` | 207,102 | 59,152 | 49,725 | 91,546 | 20,427 | 16,850 |
+| `data-table` | 207,626 | 59,198 | 49,817 | 92,070 | 20,470 | 16,883 |
 | `date-input` | 146,243 | 45,292 | 38,229 | 34,448 | 7,741 | 6,583 |
 | `date-picker` | 93,154 | 30,121 | 24,814 | 15,596 | 3,955 | 3,318 |
 | `description-list` | 30,801 | 10,095 | 8,892 | 3,502 | 774 | 676 |
-| `dialog` | 36,307 | 11,623 | 10,259 | 7,037 | 1,822 | 1,555 |
+| `dialog` | 36,349 | 11,636 | 10,265 | 7,079 | 1,832 | 1,548 |
 | `divider` | 30,826 | 10,284 | 9,053 | 3,120 | 760 | 643 |
 | `donut-chart` | 81,645 | 26,464 | 23,449 | 19,364 | 4,953 | 4,204 |
 | `drawer` | 34,988 | 11,255 | 9,908 | 6,007 | 1,495 | 1,323 |
@@ -320,13 +320,13 @@ The headless tier plus presentation. This is what `bun add @fusion.dev/helix` gi
 | `empty` | 29,763 | 9,992 | 8,809 | 2,087 | 540 | 515 |
 | `file-input` | 98,248 | 30,977 | 25,470 | 17,344 | 3,927 | 3,363 |
 | `filter-input` | 171,269 | 50,094 | 42,162 | 55,844 | 11,287 | 9,406 |
-| `flex` | 29,298 | 9,798 | 8,623 | 1,999 | 455 | 472 |
+| `flex` | 29,377 | 9,803 | 8,625 | 2,078 | 459 | 452 |
 | `format-date` | 32,581 | 10,883 | 9,622 | 3,497 | 860 | 647 |
-| `grid` | 29,825 | 9,963 | 8,786 | 2,522 | 621 | 539 |
+| `grid` | 29,831 | 9,956 | 8,764 | 2,528 | 615 | 529 |
 | `heatmap` | 80,558 | 26,185 | 23,262 | 17,832 | 4,543 | 3,743 |
 | `icon` | 75,854 | 25,190 | 20,767 | 1,641 | 381 | 371 |
 | `icon-button` | 39,345 | 11,910 | 10,494 | 9,537 | 1,869 | 1,643 |
-| `image` | 32,252 | 10,608 | 9,338 | 4,897 | 1,310 | 1,096 |
+| `image` | 32,195 | 10,599 | 9,341 | 4,840 | 1,306 | 997 |
 | `input` | 92,448 | 29,682 | 24,353 | 10,938 | 2,630 | 2,130 |
 | `kbd` | 31,686 | 10,798 | 9,494 | 4,373 | 1,498 | 1,191 |
 | `legend` | 37,016 | 11,919 | 10,475 | 5,790 | 1,397 | 1,133 |
@@ -334,7 +334,7 @@ The headless tier plus presentation. This is what `bun add @fusion.dev/helix` gi
 | `list` | 33,439 | 10,707 | 9,426 | 5,779 | 1,299 | 1,126 |
 | `listbox` | 98,727 | 31,815 | 26,007 | 15,204 | 3,981 | 3,286 |
 | `loader` | 31,726 | 10,457 | 9,209 | 4,051 | 989 | 858 |
-| `megamenu` | 63,649 | 21,442 | 19,011 | 9,805 | 2,427 | 1,978 |
+| `megamenu` | 63,649 | 21,440 | 19,005 | 9,805 | 2,426 | 2,038 |
 | `menu` | 121,468 | 40,143 | 33,700 | 16,174 | 3,760 | 3,098 |
 | `meter` | 37,148 | 11,685 | 10,324 | 9,479 | 2,209 | 1,942 |
 | `navigation` | 31,579 | 10,593 | 9,325 | 2,726 | 765 | 611 |
@@ -350,8 +350,8 @@ The headless tier plus presentation. This is what `bun add @fusion.dev/helix` gi
 | `progress` | 34,630 | 11,137 | 9,846 | 6,962 | 1,661 | 1,476 |
 | `qr-code` | 41,913 | 14,435 | 12,705 | 14,628 | 5,111 | 4,374 |
 | `quote` | 28,498 | 9,609 | 8,455 | 1,191 | 295 | 222 |
-| `radio` | 45,833 | 13,387 | 11,823 | 10,419 | 2,184 | 1,784 |
-| `rating` | 44,841 | 14,195 | 12,539 | 10,730 | 3,091 | 2,509 |
+| `radio` | 46,423 | 13,448 | 11,882 | 11,010 | 2,247 | 1,859 |
+| `rating` | 44,835 | 14,196 | 12,497 | 10,724 | 3,091 | 2,486 |
 | `sandbox` | 63,540 | 17,409 | 15,411 | 35,445 | 7,795 | 6,587 |
 | `scatter-chart` | 82,664 | 27,049 | 23,880 | 19,815 | 5,259 | 4,377 |
 | `scroll-area` | 33,234 | 10,788 | 9,496 | 5,874 | 1,451 | 1,189 |
@@ -365,7 +365,7 @@ The headless tier plus presentation. This is what `bun add @fusion.dev/helix` gi
 | `stat` | 31,624 | 10,248 | 9,065 | 3,954 | 831 | 751 |
 | `steps` | 98,180 | 30,216 | 24,841 | 19,825 | 3,900 | 3,290 |
 | `switch` | 40,217 | 12,632 | 11,126 | 5,777 | 1,541 | 1,291 |
-| `table` | 90,786 | 29,472 | 24,185 | 14,568 | 3,644 | 3,137 |
+| `table` | 90,841 | 29,483 | 24,181 | 14,623 | 3,653 | 3,119 |
 | `tabs` | 42,314 | 12,842 | 11,287 | 10,153 | 2,201 | 1,744 |
 | `tag` | 79,131 | 26,169 | 21,453 | 4,086 | 1,022 | 831 |
 | `text` | 31,284 | 10,086 | 8,873 | 3,987 | 798 | 641 |
@@ -395,11 +395,11 @@ column is what was removed rather than part of what remains.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 878,078 | 129 | 190,771 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
-| `@fusion.dev/helix-headless` | 11,379,677 | 472 | 859,484 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
+| `@fusion.dev/helix-headless` | 11,393,601 | 472 | 859,522 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
 | `@fusion.dev/helix-icons` | 65,943 | 11 | 20,928 | none |
 | `@fusion.dev/helix-styles` | 101,139 | 6 | 0 | none |
 | `@fusion.dev/helix-theme` | 465,413 | 8 | 4,703 | none |
-| `@fusion.dev/helix` | 12,394,381 | 798 | 338,979 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
+| `@fusion.dev/helix` | 12,469,777 | 798 | 339,233 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
 ## Not measured yet

package/content/size-and-density.mdx CHANGED Viewed

@@ -31,8 +31,8 @@ does not know which it is in; the region does.
 **Optical role.** Real, and only for things that are not controls. An avatar at
 24 in a list and 96 on a profile is a different graphic, not a taller control.
-That is why `size` survives on `Avatar` and `Spinner` and nowhere else: those
-are pictures.
+That is why `size` survives on `Avatar`, `Loader` and `Orb`: those are
+pictures.
 ## The test that settles it
@@ -46,6 +46,10 @@ one element at a time, which is exactly how a row ends up with one member the
 wrong height. Said once on the region, a ragged row is not discouraged. It is
 unwritable.
+`Dialog` keeps a `size` by the same test read from the other end. Two dialogs
+never sit together: one is on screen at a time, in the top layer, so it *is* the
+region rather than a control in one.
 That is also what makes this safe for anything generating code, whether that is
 a person or a model: there is no size to get wrong, and one question to ask per
 region instead of one per element.

package/content/visual-axes.mdx CHANGED Viewed

@@ -14,8 +14,10 @@ vocabularies. You cannot invent a value, and a component may take a subset.
 | `emphasis` | `ghost`, `muted`, `outlined`, `solid`, `subtle` |
 | `material` | `frosted`, `glass`, `transparent` |
 | `nesting` | `heading`, `peer`, `subordinate` |
+| `orientation` | `auto`, `horizontal`, `vertical` |
 | `separation` | `elevated`, `filled`, `outlined`, `plain` |
 | `shape` | `arc`, `circle`, `dots`, `ring`, `rounded`, `square`, `text` |
+| `size` | `sm`, `md`, `lg`, `full` |
 | `tone` | The status and intent words: `primary`, `accent`, `neutral`, `danger`, and so on |
 | `width` | `auto`, `full` |
@@ -47,8 +49,8 @@ and a component reintroducing it fails the build.
 ## Two axes, not one
 This is the test. `Megamenu` is the worked example: a consumer can make the panel
-glass, which is not an appearance, because `full` already occupies that axis with
-a layout. A panel can be glass *and* outlined. Two axes.
+glass, which is not an appearance, because `band` already occupies that axis
+with a layout. A panel can be glass *and* outlined. Two axes.
 If you are adding a property and cannot decide which axis it belongs to, that is
 usually the answer: it is two properties.
@@ -61,7 +63,7 @@ usually the answer: it is two properties.
 ```
 `variant` takes no registry, being component-specific by definition: `segmented`
-against `underlined`, `list` against `wheels`, `dots` against `marks`. It is a
+against `underlined`, `list` against `wheels`, `grip` against `line`. It is a
 choice between two widgets, which is structural wherever it is made, so it lives
 on either tier.
@@ -77,7 +79,33 @@ what gets *rendered*: a meter at `ring` emits an arc rather than a bar, so the
 markup differs before any rule is written. `nesting` says what depth *is*: a
 tree at `subordinate` ranks its rows, a tree at `heading` makes each branch the
 name of the list under it, a file explorer does neither, and that is true of a
-tree nobody has styled.
+tree nobody has styled. `orientation` is `shape`'s reason again: `aria-orientation`
+is markup, and the toolbar, the splitter, the divider and the table column all
+write it with nothing painted.
+`size` is the axis that goes the other way. It is asked of pictures and regions
+and never of controls, which take their height from the region they sit in
+through `data-density`, so it lives only where something is painted.
+## What each shape is
+`shape` is the axis whose values are geometries that look alike in a table and
+not on a page, so it is worth saying what each one draws.
+| Value | What it draws |
+|---|---|
+| `arc` | An open curve, a gauge that stops short of a full turn |
+| `circle` | A full round, the whole edge at `radii-full` |
+| `dots` | Separate marks rather than one joined figure |
+| `ring` | A closed curve, the whole turn drawn as a band |
+| `rounded` | Corners cut to `radii-md`, still a rectangle |
+| `square` | Sharp corners, the pole `rounded` departs from |
+| `text` | A line of type's shape, as wide as a line and as tall |
+**`square` is not `rounded`.** They were one word for a while: an avatar drawing
+`radii-md` called it `square` while a QR code drawing sharp modules called it
+`square` too, in the same registered axis. Membership is what a check can see,
+so nothing could have caught that, and a table is what stops it happening again.
 ## What a step inward means

package/dist/sources.generated.js CHANGED Viewed

@@ -2023,10 +2023,10 @@ repository does that. The per-component tables are what a page pays.
 | Package | Raw | Gzip | Brotli | |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 147,226 | 48,349 | 40,887 | Element base class, mixins, decorators, floating positioning. |
-| \`@fusion.dev/helix-headless\` | 603,471 | 156,550 | 121,866 | Every headless family, which is what the barrel means. |
+| \`@fusion.dev/helix-headless\` | 603,522 | 156,553 | 121,886 | Every headless family, which is what the barrel means. |
 | \`@fusion.dev/helix-icons\` | 47,484 | 14,907 | 12,553 | The whole glyph set. |
 | \`@fusion.dev/helix-theme\` | 3,288 | 1,571 | 1,355 | The derivation engine. Build time for most consumers, runtime for a theme switcher. |
-| \`@fusion.dev/helix\` | 1,080,878 | 253,701 | 185,862 | Every styled family. |
+| \`@fusion.dev/helix\` | 1,081,980 | 253,807 | 186,053 | Every styled family. |
 | \`lit\` | 15,394 | 6,118 | 5,460 | Not ours. Here so it can be subtracted from every row above it. |
 ## The stylesheets
@@ -2047,13 +2047,13 @@ is the whole cost of adopting the base layer on its own.
 ## What the numbers say
-**Most of a first component is the runtime under it.** The median styled family is 18,826 bytes gzipped alone and adds 2,205 to a page that already has Helix on it, so 88 percent of the first one is shared and 12 percent is the component. Ten typical components are one plus nine additions rather than ten of the first number, and the pair of columns below is what lets that be worked out rather than guessed.
+**Most of a first component is the runtime under it.** The median styled family is 18,826 bytes gzipped alone and adds 2,218 to a page that already has Helix on it, so 88 percent of the first one is shared and 12 percent is the component. Ten typical components are one plus nine additions rather than ten of the first number, and the pair of columns below is what lets that be worked out rather than guessed.
-Across the tier: the cheapest is \`code\` at 9,451 gzipped alone, the dearest \`data-table\` at 59,152, over 100 components. Every family at once is 253,701.
+Across the tier: the cheapest is \`code\` at 9,451 gzipped alone, the dearest \`data-table\` at 59,198, over 100 components. Every family at once is 253,807.
-**No family imports a barrel, and the \`barrels\` rule in \`fusion workspace\` is what keeps it that way.** \`@fusion.dev/helix-headless\` is \`sideEffects\` over every module in \`dist\`, which is true of a file that calls \`customElements.define\` and which means a bundler may drop none of it: one \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 156,550 bytes gzipped whatever else the page does, which is 8 times the median family measured above. The styled tier imports the family it extends instead, all 100 of them, and the check refuses the shape rather than the package name, so the rule follows \`sideEffects\` wherever it goes.
+**No family imports a barrel, and the \`barrels\` rule in \`fusion workspace\` is what keeps it that way.** \`@fusion.dev/helix-headless\` is \`sideEffects\` over every module in \`dist\`, which is true of a file that calls \`customElements.define\` and which means a bundler may drop none of it: one \`import { HelixHeadlessButton } from '@fusion.dev/helix-headless'\` costs 156,553 bytes gzipped whatever else the page does, which is 8 times the median family measured above. The styled tier imports the family it extends instead, all 100 of them, and the check refuses the shape rather than the package name, so the rule follows \`sideEffects\` wherever it goes.
-The headless tier never had the problem, and it is the control: \`@fusion.dev/helix-core\` is \`sideEffects: false\`, and a headless family is a median of 20,532 bytes gzipped alone.
+The headless tier never had the problem, and it is the control: \`@fusion.dev/helix-core\` is \`sideEffects: false\`, and a headless family is a median of 20,530 bytes gzipped alone.
 ## Against other systems
@@ -2070,17 +2070,17 @@ Four other libraries of custom elements, pinned and measured on 2026-08-24 by \`
 | | Material Web | 47,060 | 14,173 | 12,591 |
 | | Shoelace | 62,628 | 18,287 | 15,805 |
 | | Spectrum | 98,792 | 22,045 | 18,674 |
-| \`checkbox\` | **Helix** | 42,376 | 13,006 | 11,453 |
+| \`checkbox\` | **Helix** | 42,841 | 13,039 | 11,450 |
 | | 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** | 36,307 | 11,623 | 10,259 |
+| \`dialog\` | **Helix** | 36,349 | 11,636 | 10,265 |
 | | 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** | 45,833 | 13,387 | 11,823 |
+| \`radio\` | **Helix** | 46,423 | 13,448 | 11,882 |
 | | Carbon | 63,055 | 16,887 | 14,605 |
 | | Material Web | 41,044 | 13,234 | 11,757 |
 | | Shoelace | 34,865 | 12,027 | 10,559 |
@@ -2101,7 +2101,7 @@ Four other libraries of custom elements, pinned and measured on 2026-08-24 by \`
 | | Shoelace | 57,412 | 20,220 | 17,933 |
 | | Spectrum | 136,599 | 40,552 | 35,286 |
-**Where Helix loses**, which is the half of a comparison table worth reading: \`dialog\`, \`radio\`, \`switch\`, \`tabs\`, \`tooltip\`. The largest gap is radio against Spectrum, by 2,727 bytes gzipped. 7 of 28 peer measurements come in under ours.
+**Where Helix loses**, which is the half of a comparison table worth reading: \`dialog\`, \`radio\`, \`switch\`, \`tabs\`, \`tooltip\`. The largest gap is radio against Spectrum, by 2,788 bytes gzipped. 7 of 28 peer measurements come in under ours.
 - **Carbon** \`@carbon/web-components@2.61.0\`. Its dialog is Modal, its radio is Radio Button, and its switch is Toggle.
 - **Material Web** \`@material/web@2.5.0\`. Ships no tooltip. Its button is measured as the filled one, there being no single button element.
@@ -2152,7 +2152,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | \`area-chart\` | 74,755 | 25,601 | 22,598 | 11,066 | 3,413 | 2,823 |
 | \`avatar\` | 30,963 | 10,323 | 9,111 | 3,257 | 919 | 732 |
 | \`badge\` | 28,449 | 9,658 | 8,493 | 1,162 | 297 | 241 |
-| \`bar-chart\` | 76,394 | 25,965 | 22,972 | 12,696 | 3,773 | 3,124 |
+| \`bar-chart\` | 76,406 | 25,966 | 22,962 | 12,708 | 3,774 | 3,131 |
 | \`blockquote\` | 28,464 | 9,687 | 8,534 | 774 | 177 | 118 |
 | \`breadcrumbs\` | 76,525 | 25,352 | 20,888 | 1,965 | 441 | 363 |
 | \`button\` | 32,931 | 10,866 | 9,561 | 3,137 | 810 | 711 |
@@ -2170,7 +2170,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | \`combobox\` | 132,319 | 42,745 | 35,897 | 20,388 | 5,072 | 4,193 |
 | \`command\` | 102,707 | 32,668 | 26,883 | 17,705 | 4,516 | 3,718 |
 | \`copy-button\` | 115,835 | 38,799 | 32,590 | 11,901 | 2,968 | 2,456 |
-| \`data-table\` | 170,373 | 52,745 | 44,536 | 54,836 | 13,935 | 11,551 |
+| \`data-table\` | 170,408 | 52,757 | 44,535 | 54,871 | 13,943 | 11,715 |
 | \`date-input\` | 130,322 | 42,258 | 35,456 | 18,550 | 4,750 | 3,954 |
 | \`date-picker\` | 87,537 | 28,957 | 23,814 | 9,997 | 2,810 | 2,281 |
 | \`description-list\` | 28,423 | 9,527 | 8,396 | 1,132 | 178 | 172 |
@@ -2194,7 +2194,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | \`list\` | 29,375 | 9,761 | 8,590 | 1,725 | 343 | 256 |
 | \`listbox\` | 94,458 | 30,818 | 25,165 | 10,942 | 2,996 | 2,362 |
 | \`loader\` | 28,560 | 9,693 | 8,526 | 900 | 224 | 162 |
-| \`megamenu\` | 58,768 | 20,368 | 17,992 | 4,941 | 1,357 | 1,072 |
+| \`megamenu\` | 58,768 | 20,365 | 18,023 | 4,941 | 1,355 | 989 |
 | \`menu\` | 114,091 | 38,572 | 32,324 | 8,816 | 2,239 | 1,745 |
 | \`meter\` | 31,750 | 10,542 | 9,277 | 4,099 | 1,047 | 882 |
 | \`navigation\` | 30,198 | 10,203 | 9,003 | 1,361 | 358 | 280 |
@@ -2223,7 +2223,7 @@ Structure, accessibility, state and form participation. No presentation, and no
 | \`stat\` | 28,808 | 9,624 | 8,464 | 1,148 | 189 | 159 |
 | \`steps\` | 84,562 | 27,788 | 22,780 | 6,219 | 1,510 | 1,168 |
 | \`switch\` | 35,949 | 11,576 | 10,243 | 1,524 | 481 | 350 |
-| \`table\` | 85,428 | 28,370 | 23,263 | 9,221 | 2,572 | 2,132 |
+| \`table\` | 85,463 | 28,383 | 23,227 | 9,256 | 2,581 | 2,075 |
 | \`tabs\` | 36,077 | 11,569 | 10,198 | 3,925 | 911 | 720 |
 | \`tag\` | 75,927 | 25,307 | 20,715 | 897 | 191 | 194 |
 | \`textarea\` | 38,454 | 12,148 | 10,669 | 4,026 | 1,101 | 867 |
@@ -2252,31 +2252,31 @@ The headless tier plus presentation. This is what \`bun add @fusion.dev/helix\`
 | \`app-header\` | 32,804 | 10,624 | 9,379 | 5,121 | 1,226 | 1,076 |
 | \`area-chart\` | 82,141 | 27,208 | 24,027 | 18,433 | 5,026 | 4,214 |
 | \`aura\` | 94,970 | 32,811 | 28,423 | 66,522 | 23,026 | 19,836 |
-| \`avatar\` | 34,548 | 11,085 | 9,765 | 6,832 | 1,691 | 1,349 |
+| \`avatar\` | 34,549 | 11,085 | 9,765 | 6,833 | 1,689 | 1,356 |
 | \`badge\` | 31,553 | 10,365 | 9,136 | 4,249 | 1,008 | 847 |
-| \`bar-chart\` | 89,160 | 28,516 | 25,225 | 25,442 | 6,337 | 5,281 |
+| \`bar-chart\` | 89,210 | 28,519 | 25,248 | 25,492 | 6,339 | 5,292 |
 | \`blockquote\` | 29,620 | 9,970 | 8,765 | 1,914 | 477 | 368 |
 | \`breadcrumbs\` | 80,091 | 26,152 | 21,562 | 5,518 | 1,240 | 1,051 |
 | \`button\` | 39,024 | 11,978 | 10,565 | 9,212 | 1,934 | 1,662 |
 | \`button-group\` | 29,996 | 9,950 | 8,756 | 2,320 | 528 | 499 |
 | \`callout\` | 77,642 | 25,753 | 21,314 | 2,895 | 767 | 634 |
 | \`card\` | 31,587 | 10,410 | 9,158 | 3,915 | 980 | 943 |
-| \`carousel\` | 94,968 | 29,707 | 24,655 | 20,108 | 4,328 | 3,725 |
+| \`carousel\` | 94,840 | 29,701 | 24,624 | 19,980 | 4,320 | 3,700 |
 | \`chat\` | 113,049 | 35,489 | 29,342 | 31,432 | 7,585 | 6,423 |
-| \`checkbox\` | 42,376 | 13,006 | 11,453 | 8,337 | 2,064 | 1,778 |
+| \`checkbox\` | 42,841 | 13,039 | 11,450 | 8,802 | 2,100 | 1,785 |
 | \`checkbox-group\` | 41,537 | 12,854 | 11,324 | 6,981 | 1,839 | 1,407 |
 | \`code\` | 28,016 | 9,451 | 8,318 | 1,511 | 366 | 327 |
 | \`code-block\` | 137,688 | 43,293 | 36,473 | 33,731 | 7,278 | 6,200 |
 | \`color-input\` | 168,628 | 48,951 | 41,328 | 59,311 | 11,851 | 10,104 |
 | \`color-picker\` | 130,441 | 37,570 | 31,204 | 47,984 | 9,957 | 8,550 |
 | \`combobox\` | 147,122 | 45,410 | 38,194 | 35,172 | 7,737 | 6,383 |
-| \`command\` | 113,170 | 34,701 | 28,584 | 28,157 | 6,589 | 5,541 |
+| \`command\` | 113,212 | 34,712 | 28,636 | 28,199 | 6,600 | 5,573 |
 | \`copy-button\` | 125,839 | 40,569 | 34,091 | 21,887 | 4,687 | 3,940 |
-| \`data-table\` | 207,102 | 59,152 | 49,725 | 91,546 | 20,427 | 16,850 |
+| \`data-table\` | 207,626 | 59,198 | 49,817 | 92,070 | 20,470 | 16,883 |
 | \`date-input\` | 146,243 | 45,292 | 38,229 | 34,448 | 7,741 | 6,583 |
 | \`date-picker\` | 93,154 | 30,121 | 24,814 | 15,596 | 3,955 | 3,318 |
 | \`description-list\` | 30,801 | 10,095 | 8,892 | 3,502 | 774 | 676 |
-| \`dialog\` | 36,307 | 11,623 | 10,259 | 7,037 | 1,822 | 1,555 |
+| \`dialog\` | 36,349 | 11,636 | 10,265 | 7,079 | 1,832 | 1,548 |
 | \`divider\` | 30,826 | 10,284 | 9,053 | 3,120 | 760 | 643 |
 | \`donut-chart\` | 81,645 | 26,464 | 23,449 | 19,364 | 4,953 | 4,204 |
 | \`drawer\` | 34,988 | 11,255 | 9,908 | 6,007 | 1,495 | 1,323 |
@@ -2284,13 +2284,13 @@ The headless tier plus presentation. This is what \`bun add @fusion.dev/helix\`
 | \`empty\` | 29,763 | 9,992 | 8,809 | 2,087 | 540 | 515 |
 | \`file-input\` | 98,248 | 30,977 | 25,470 | 17,344 | 3,927 | 3,363 |
 | \`filter-input\` | 171,269 | 50,094 | 42,162 | 55,844 | 11,287 | 9,406 |
-| \`flex\` | 29,298 | 9,798 | 8,623 | 1,999 | 455 | 472 |
+| \`flex\` | 29,377 | 9,803 | 8,625 | 2,078 | 459 | 452 |
 | \`format-date\` | 32,581 | 10,883 | 9,622 | 3,497 | 860 | 647 |
-| \`grid\` | 29,825 | 9,963 | 8,786 | 2,522 | 621 | 539 |
+| \`grid\` | 29,831 | 9,956 | 8,764 | 2,528 | 615 | 529 |
 | \`heatmap\` | 80,558 | 26,185 | 23,262 | 17,832 | 4,543 | 3,743 |
 | \`icon\` | 75,854 | 25,190 | 20,767 | 1,641 | 381 | 371 |
 | \`icon-button\` | 39,345 | 11,910 | 10,494 | 9,537 | 1,869 | 1,643 |
-| \`image\` | 32,252 | 10,608 | 9,338 | 4,897 | 1,310 | 1,096 |
+| \`image\` | 32,195 | 10,599 | 9,341 | 4,840 | 1,306 | 997 |
 | \`input\` | 92,448 | 29,682 | 24,353 | 10,938 | 2,630 | 2,130 |
 | \`kbd\` | 31,686 | 10,798 | 9,494 | 4,373 | 1,498 | 1,191 |
 | \`legend\` | 37,016 | 11,919 | 10,475 | 5,790 | 1,397 | 1,133 |
@@ -2298,7 +2298,7 @@ The headless tier plus presentation. This is what \`bun add @fusion.dev/helix\`
 | \`list\` | 33,439 | 10,707 | 9,426 | 5,779 | 1,299 | 1,126 |
 | \`listbox\` | 98,727 | 31,815 | 26,007 | 15,204 | 3,981 | 3,286 |
 | \`loader\` | 31,726 | 10,457 | 9,209 | 4,051 | 989 | 858 |
-| \`megamenu\` | 63,649 | 21,442 | 19,011 | 9,805 | 2,427 | 1,978 |
+| \`megamenu\` | 63,649 | 21,440 | 19,005 | 9,805 | 2,426 | 2,038 |
 | \`menu\` | 121,468 | 40,143 | 33,700 | 16,174 | 3,760 | 3,098 |
 | \`meter\` | 37,148 | 11,685 | 10,324 | 9,479 | 2,209 | 1,942 |
 | \`navigation\` | 31,579 | 10,593 | 9,325 | 2,726 | 765 | 611 |
@@ -2314,8 +2314,8 @@ The headless tier plus presentation. This is what \`bun add @fusion.dev/helix\`
 | \`progress\` | 34,630 | 11,137 | 9,846 | 6,962 | 1,661 | 1,476 |
 | \`qr-code\` | 41,913 | 14,435 | 12,705 | 14,628 | 5,111 | 4,374 |
 | \`quote\` | 28,498 | 9,609 | 8,455 | 1,191 | 295 | 222 |
-| \`radio\` | 45,833 | 13,387 | 11,823 | 10,419 | 2,184 | 1,784 |
-| \`rating\` | 44,841 | 14,195 | 12,539 | 10,730 | 3,091 | 2,509 |
+| \`radio\` | 46,423 | 13,448 | 11,882 | 11,010 | 2,247 | 1,859 |
+| \`rating\` | 44,835 | 14,196 | 12,497 | 10,724 | 3,091 | 2,486 |
 | \`sandbox\` | 63,540 | 17,409 | 15,411 | 35,445 | 7,795 | 6,587 |
 | \`scatter-chart\` | 82,664 | 27,049 | 23,880 | 19,815 | 5,259 | 4,377 |
 | \`scroll-area\` | 33,234 | 10,788 | 9,496 | 5,874 | 1,451 | 1,189 |
@@ -2329,7 +2329,7 @@ The headless tier plus presentation. This is what \`bun add @fusion.dev/helix\`
 | \`stat\` | 31,624 | 10,248 | 9,065 | 3,954 | 831 | 751 |
 | \`steps\` | 98,180 | 30,216 | 24,841 | 19,825 | 3,900 | 3,290 |
 | \`switch\` | 40,217 | 12,632 | 11,126 | 5,777 | 1,541 | 1,291 |
-| \`table\` | 90,786 | 29,472 | 24,185 | 14,568 | 3,644 | 3,137 |
+| \`table\` | 90,841 | 29,483 | 24,181 | 14,623 | 3,653 | 3,119 |
 | \`tabs\` | 42,314 | 12,842 | 11,287 | 10,153 | 2,201 | 1,744 |
 | \`tag\` | 79,131 | 26,169 | 21,453 | 4,086 | 1,022 | 831 |
 | \`text\` | 31,284 | 10,086 | 8,873 | 3,987 | 798 | 641 |
@@ -2359,11 +2359,11 @@ column is what was removed rather than part of what remains.
 | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 878,078 | 129 | 190,771 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
-| \`@fusion.dev/helix-headless\` | 11,379,677 | 472 | 859,484 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
+| \`@fusion.dev/helix-headless\` | 11,393,601 | 472 | 859,522 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
 | \`@fusion.dev/helix-icons\` | 65,943 | 11 | 20,928 | none |
 | \`@fusion.dev/helix-styles\` | 101,139 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 465,413 | 8 | 4,703 | none |
-| \`@fusion.dev/helix\` | 12,394,381 | 798 | 338,979 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
+| \`@fusion.dev/helix\` | 12,469,777 | 798 | 339,233 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
 ## Not measured yet
@@ -3662,8 +3662,8 @@ does not know which it is in; the region does.
 **Optical role.** Real, and only for things that are not controls. An avatar at
 24 in a list and 96 on a profile is a different graphic, not a taller control.
-That is why \`size\` survives on \`Avatar\` and \`Spinner\` and nowhere else: those
-are pictures.
+That is why \`size\` survives on \`Avatar\`, \`Loader\` and \`Orb\`: those are
+pictures.
 ## The test that settles it
@@ -3677,6 +3677,10 @@ one element at a time, which is exactly how a row ends up with one member the
 wrong height. Said once on the region, a ragged row is not discouraged. It is
 unwritable.
+\`Dialog\` keeps a \`size\` by the same test read from the other end. Two dialogs
+never sit together: one is on screen at a time, in the top layer, so it *is* the
+region rather than a control in one.
 That is also what makes this safe for anything generating code, whether that is
 a person or a model: there is no size to get wrong, and one question to ask per
 region instead of one per element.
@@ -5079,8 +5083,10 @@ vocabularies. You cannot invent a value, and a component may take a subset.
 | \`emphasis\` | \`ghost\`, \`muted\`, \`outlined\`, \`solid\`, \`subtle\` |
 | \`material\` | \`frosted\`, \`glass\`, \`transparent\` |
 | \`nesting\` | \`heading\`, \`peer\`, \`subordinate\` |
+| \`orientation\` | \`auto\`, \`horizontal\`, \`vertical\` |
 | \`separation\` | \`elevated\`, \`filled\`, \`outlined\`, \`plain\` |
 | \`shape\` | \`arc\`, \`circle\`, \`dots\`, \`ring\`, \`rounded\`, \`square\`, \`text\` |
+| \`size\` | \`sm\`, \`md\`, \`lg\`, \`full\` |
 | \`tone\` | The status and intent words: \`primary\`, \`accent\`, \`neutral\`, \`danger\`, and so on |
 | \`width\` | \`auto\`, \`full\` |
@@ -5112,8 +5118,8 @@ and a component reintroducing it fails the build.
 ## Two axes, not one
 This is the test. \`Megamenu\` is the worked example: a consumer can make the panel
-glass, which is not an appearance, because \`full\` already occupies that axis with
-a layout. A panel can be glass *and* outlined. Two axes.
+glass, which is not an appearance, because \`band\` already occupies that axis
+with a layout. A panel can be glass *and* outlined. Two axes.
 If you are adding a property and cannot decide which axis it belongs to, that is
 usually the answer: it is two properties.
@@ -5126,7 +5132,7 @@ usually the answer: it is two properties.
 \`\`\`
 \`variant\` takes no registry, being component-specific by definition: \`segmented\`
-against \`underlined\`, \`list\` against \`wheels\`, \`dots\` against \`marks\`. It is a
+against \`underlined\`, \`list\` against \`wheels\`, \`grip\` against \`line\`. It is a
 choice between two widgets, which is structural wherever it is made, so it lives
 on either tier.
@@ -5142,7 +5148,33 @@ what gets *rendered*: a meter at \`ring\` emits an arc rather than a bar, so the
 markup differs before any rule is written. \`nesting\` says what depth *is*: a
 tree at \`subordinate\` ranks its rows, a tree at \`heading\` makes each branch the
 name of the list under it, a file explorer does neither, and that is true of a
-tree nobody has styled.
+tree nobody has styled. \`orientation\` is \`shape\`'s reason again: \`aria-orientation\`
+is markup, and the toolbar, the splitter, the divider and the table column all
+write it with nothing painted.
+\`size\` is the axis that goes the other way. It is asked of pictures and regions
+and never of controls, which take their height from the region they sit in
+through \`data-density\`, so it lives only where something is painted.
+## What each shape is
+\`shape\` is the axis whose values are geometries that look alike in a table and
+not on a page, so it is worth saying what each one draws.
+| Value | What it draws |
+|---|---|
+| \`arc\` | An open curve, a gauge that stops short of a full turn |
+| \`circle\` | A full round, the whole edge at \`radii-full\` |
+| \`dots\` | Separate marks rather than one joined figure |
+| \`ring\` | A closed curve, the whole turn drawn as a band |
+| \`rounded\` | Corners cut to \`radii-md\`, still a rectangle |
+| \`square\` | Sharp corners, the pole \`rounded\` departs from |
+| \`text\` | A line of type's shape, as wide as a line and as tall |
+**\`square\` is not \`rounded\`.** They were one word for a while: an avatar drawing
+\`radii-md\` called it \`square\` while a QR code drawing sharp modules called it
+\`square\` too, in the same registered axis. Membership is what a check can see,
+so nothing could have caught that, and a table is what stops it happening again.
 ## What a step inward means

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-docs",
   "description": "Versioned documentation content and registry for Helix.",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -36,8 +36,8 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.54.0",
-    "@fusion.dev/helix-testing": "0.54.0",
+    "@fusion.dev/helix-cem": "0.55.0",
+    "@fusion.dev/helix-testing": "0.55.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "lit": "^3.2.1",
     "playwright": "^1.62.1"