@fusion.dev/helix-docs 0.110.3 → 0.110.5

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 (4) hide show
  1. package/content/maps.mdx +4 -1
  2. package/content/metrics.mdx +8 -8
  3. package/dist/sources.generated.js +12 -9
  4. package/package.json +3 -3
package/content/maps.mdx CHANGED
@@ -165,7 +165,10 @@ lines up with the map that replaces it. `width` and `height` are the box it is
165
165
  drawn for, and a smaller box shows its middle. A snapshot draws the land, water,
166
166
  parks, buildings, and roads, and leaves the labels to MapLibre. Its colors are
167
167
  your theme's tokens, so it is light or dark with the page and follows a theme
168
- change. It resolves to an empty string when the tiles cannot be read.
168
+ change. It resolves to an empty string when any tile it needs cannot be read
169
+ in time, so a snapshot is whole or absent and the map draws in its place. Each
170
+ request is given `timeout` milliseconds, 3000 by default. Cache only a snapshot
171
+ that is not empty.
169
172
 
170
173
  In a framework that renders the markup for you, such as React, put the snapshot
171
174
  in an element that is a direct child of the frame and has the
package/content/metrics.mdx CHANGED
@@ -58,10 +58,10 @@ either barrel. The per-component tables show what your page pays.
58
58
  | Package | Raw | Gzip | Brotli | |
59
59
  |---|---|---|---|---|
60
60
  | `@fusion.dev/helix-core` | 175,915 | 56,424 | 48,011 | The element base class, mixins, decorators, and floating positioning. |
61
- | `@fusion.dev/helix-headless` | 721,923 | 186,975 | 145,431 | Every headless family. The barrel entry includes all of them. |
61
+ | `@fusion.dev/helix-headless` | 722,755 | 187,265 | 145,717 | Every headless family. The barrel entry includes all of them. |
62
62
  | `@fusion.dev/helix-icons` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
63
63
  | `@fusion.dev/helix-theme` | 3,288 | 1,571 | 1,355 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
64
- | `@fusion.dev/helix` | 1,252,327 | 293,154 | 215,050 | Every styled family. |
64
+ | `@fusion.dev/helix` | 1,253,294 | 293,464 | 215,364 | Every styled family. |
65
65
  | `lit` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
66
66
 
67
67
  ## Stylesheets
@@ -84,9 +84,9 @@ shows the whole cost of using the base layer on its own.
84
84
 
85
85
  **Most of your first component is the shared runtime.** The median styled family is 20,614 bytes gzipped alone, and it adds 2,227 to a page that already has Helix. The shared runtime is 89 percent of the first component, and the component itself is 11 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.
86
86
 
87
- Across the 103 styled components, the smallest is `code` at 9,782 bytes gzipped alone, and the largest is `data-table` at 63,530. Every family together is 293,154.
87
+ Across the 103 styled components, the smallest is `code` at 9,782 bytes gzipped alone, and the largest is `data-table` at 63,530. Every family together is 293,464.
88
88
 
89
- 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 186,975 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 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.
89
+ 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 187,265 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 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.
90
90
 
91
91
  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 21,055 bytes gzipped alone.
92
92
 
@@ -192,7 +192,7 @@ Structure, accessibility, state, and form participation. It has no presentation
192
192
  | `button` | 36,306 | 11,274 | 9,890 | 3,182 | 824 | 585 |
193
193
  | `button-group` | 31,502 | 9,910 | 8,724 | 661 | 145 | 25 |
194
194
  | `callout` | 86,670 | 28,326 | 23,244 | 914 | 249 | 112 |
195
- | `canvas` | 84,294 | 25,542 | 22,348 | 46,815 | 14,014 | 11,823 |
195
+ | `canvas` | 85,125 | 25,790 | 22,594 | 47,644 | 14,243 | 12,042 |
196
196
  | `card` | 31,536 | 9,922 | 8,751 | 694 | 144 | 47 |
197
197
  | `carousel` | 96,953 | 31,454 | 25,821 | 10,942 | 2,796 | 2,251 |
198
198
  | `chat` | 110,291 | 36,288 | 29,738 | 17,447 | 5,133 | 4,223 |
@@ -297,7 +297,7 @@ The headless tier plus presentation. `bun add @fusion.dev/helix` installs this t
297
297
  | `button` | 42,399 | 12,383 | 10,883 | 9,257 | 1,940 | 1,540 |
298
298
  | `button-group` | 33,178 | 10,286 | 9,051 | 2,320 | 532 | 382 |
299
299
  | `callout` | 88,671 | 28,886 | 23,724 | 2,899 | 771 | 589 |
300
- | `canvas` | 103,473 | 29,019 | 25,332 | 65,979 | 17,547 | 14,712 |
300
+ | `canvas` | 104,439 | 29,311 | 25,555 | 66,947 | 17,859 | 15,035 |
301
301
  | `card` | 34,769 | 10,747 | 9,440 | 3,915 | 990 | 761 |
302
302
  | `carousel` | 107,741 | 33,201 | 27,421 | 21,719 | 4,562 | 3,867 |
303
303
  | `chat` | 124,448 | 38,804 | 31,903 | 31,590 | 7,663 | 6,457 |
@@ -399,11 +399,11 @@ stripped column shows the bytes we removed.
399
399
  | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
400
400
  |---|---|---|---|---|
401
401
  | `@fusion.dev/helix-core` | 1,131,575 | 165 | 250,424 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
402
- | `@fusion.dev/helix-headless` | 13,143,042 | 504 | 1,042,650 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
402
+ | `@fusion.dev/helix-headless` | 13,147,141 | 504 | 1,044,994 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
403
403
  | `@fusion.dev/helix-icons` | 150,162 | 21 | 50,346 | `svgo` |
404
404
  | `@fusion.dev/helix-styles` | 102,108 | 6 | 0 | none |
405
405
  | `@fusion.dev/helix-theme` | 465,413 | 8 | 4,703 | none |
406
- | `@fusion.dev/helix` | 14,271,681 | 870 | 370,874 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
406
+ | `@fusion.dev/helix` | 14,273,640 | 870 | 370,884 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |
407
407
 
408
408
  ## Not measured yet
409
409
 
package/dist/sources.generated.js CHANGED
@@ -2441,7 +2441,10 @@ lines up with the map that replaces it. \`width\` and \`height\` are the box it
2441
2441
  drawn for, and a smaller box shows its middle. A snapshot draws the land, water,
2442
2442
  parks, buildings, and roads, and leaves the labels to MapLibre. Its colors are
2443
2443
  your theme's tokens, so it is light or dark with the page and follows a theme
2444
- change. It resolves to an empty string when the tiles cannot be read.
2444
+ change. It resolves to an empty string when any tile it needs cannot be read
2445
+ in time, so a snapshot is whole or absent and the map draws in its place. Each
2446
+ request is given \`timeout\` milliseconds, 3000 by default. Cache only a snapshot
2447
+ that is not empty.
2445
2448
 
2446
2449
  In a framework that renders the markup for you, such as React, put the snapshot
2447
2450
  in an element that is a direct child of the frame and has the
@@ -2825,10 +2828,10 @@ either barrel. The per-component tables show what your page pays.
2825
2828
  | Package | Raw | Gzip | Brotli | |
2826
2829
  |---|---|---|---|---|
2827
2830
  | \`@fusion.dev/helix-core\` | 175,915 | 56,424 | 48,011 | The element base class, mixins, decorators, and floating positioning. |
2828
- | \`@fusion.dev/helix-headless\` | 721,923 | 186,975 | 145,431 | Every headless family. The barrel entry includes all of them. |
2831
+ | \`@fusion.dev/helix-headless\` | 722,755 | 187,265 | 145,717 | Every headless family. The barrel entry includes all of them. |
2829
2832
  | \`@fusion.dev/helix-icons\` | 55,565 | 17,727 | 14,864 | The whole glyph set. |
2830
2833
  | \`@fusion.dev/helix-theme\` | 3,288 | 1,571 | 1,355 | The derivation engine. Most sites run it at build time, and a theme switcher runs it in the browser. |
2831
- | \`@fusion.dev/helix\` | 1,252,327 | 293,154 | 215,050 | Every styled family. |
2834
+ | \`@fusion.dev/helix\` | 1,253,294 | 293,464 | 215,364 | Every styled family. |
2832
2835
  | \`lit\` | 15,394 | 6,118 | 5,460 | Lit itself, listed so you can subtract it from every row above. |
2833
2836
 
2834
2837
  ## Stylesheets
@@ -2851,9 +2854,9 @@ shows the whole cost of using the base layer on its own.
2851
2854
 
2852
2855
  **Most of your first component is the shared runtime.** The median styled family is 20,614 bytes gzipped alone, and it adds 2,227 to a page that already has Helix. The shared runtime is 89 percent of the first component, and the component itself is 11 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.
2853
2856
 
2854
- Across the 103 styled components, the smallest is \`code\` at 9,782 bytes gzipped alone, and the largest is \`data-table\` at 63,530. Every family together is 293,154.
2857
+ Across the 103 styled components, the smallest is \`code\` at 9,782 bytes gzipped alone, and the largest is \`data-table\` at 63,530. Every family together is 293,464.
2855
2858
 
2856
- 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 186,975 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 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.
2859
+ 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 187,265 bytes gzipped, whatever else the page imports. That is 9 times the median family above. All 103 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.
2857
2860
 
2858
2861
  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 21,055 bytes gzipped alone.
2859
2862
 
@@ -2959,7 +2962,7 @@ Structure, accessibility, state, and form participation. It has no presentation
2959
2962
  | \`button\` | 36,306 | 11,274 | 9,890 | 3,182 | 824 | 585 |
2960
2963
  | \`button-group\` | 31,502 | 9,910 | 8,724 | 661 | 145 | 25 |
2961
2964
  | \`callout\` | 86,670 | 28,326 | 23,244 | 914 | 249 | 112 |
2962
- | \`canvas\` | 84,294 | 25,542 | 22,348 | 46,815 | 14,014 | 11,823 |
2965
+ | \`canvas\` | 85,125 | 25,790 | 22,594 | 47,644 | 14,243 | 12,042 |
2963
2966
  | \`card\` | 31,536 | 9,922 | 8,751 | 694 | 144 | 47 |
2964
2967
  | \`carousel\` | 96,953 | 31,454 | 25,821 | 10,942 | 2,796 | 2,251 |
2965
2968
  | \`chat\` | 110,291 | 36,288 | 29,738 | 17,447 | 5,133 | 4,223 |
@@ -3064,7 +3067,7 @@ The headless tier plus presentation. \`bun add @fusion.dev/helix\` installs this
3064
3067
  | \`button\` | 42,399 | 12,383 | 10,883 | 9,257 | 1,940 | 1,540 |
3065
3068
  | \`button-group\` | 33,178 | 10,286 | 9,051 | 2,320 | 532 | 382 |
3066
3069
  | \`callout\` | 88,671 | 28,886 | 23,724 | 2,899 | 771 | 589 |
3067
- | \`canvas\` | 103,473 | 29,019 | 25,332 | 65,979 | 17,547 | 14,712 |
3070
+ | \`canvas\` | 104,439 | 29,311 | 25,555 | 66,947 | 17,859 | 15,035 |
3068
3071
  | \`card\` | 34,769 | 10,747 | 9,440 | 3,915 | 990 | 761 |
3069
3072
  | \`carousel\` | 107,741 | 33,201 | 27,421 | 21,719 | 4,562 | 3,867 |
3070
3073
  | \`chat\` | 124,448 | 38,804 | 31,903 | 31,590 | 7,663 | 6,457 |
@@ -3166,11 +3169,11 @@ stripped column shows the bytes we removed.
3166
3169
  | Package | Unpacked | Files | Source maps stripped | Runtime dependencies |
3167
3170
  |---|---|---|---|---|
3168
3171
  | \`@fusion.dev/helix-core\` | 1,131,575 | 165 | 250,424 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
3169
- | \`@fusion.dev/helix-headless\` | 13,143,042 | 504 | 1,042,650 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
3172
+ | \`@fusion.dev/helix-headless\` | 13,147,141 | 504 | 1,044,994 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
3170
3173
  | \`@fusion.dev/helix-icons\` | 150,162 | 21 | 50,346 | \`svgo\` |
3171
3174
  | \`@fusion.dev/helix-styles\` | 102,108 | 6 | 0 | none |
3172
3175
  | \`@fusion.dev/helix-theme\` | 465,413 | 8 | 4,703 | none |
3173
- | \`@fusion.dev/helix\` | 14,271,681 | 870 | 370,874 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
3176
+ | \`@fusion.dev/helix\` | 14,273,640 | 870 | 370,884 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |
3174
3177
 
3175
3178
  ## Not measured yet
3176
3179
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@fusion.dev/helix-docs",
3
3
  "description": "Versioned documentation content and registry for Helix.",
4
- "version": "0.110.3",
4
+ "version": "0.110.5",
5
5
  "license": "MIT",
6
6
  "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
7
7
  "repository": {
@@ -36,8 +36,8 @@
36
36
  },
37
37
  "bugs": "https://github.com/project-fusion/fusion/issues",
38
38
  "devDependencies": {
39
- "@fusion.dev/helix-cem": "0.110.3",
40
- "@fusion.dev/helix-testing": "0.110.3",
39
+ "@fusion.dev/helix-cem": "0.110.5",
40
+ "@fusion.dev/helix-testing": "0.110.5",
41
41
  "@fusion.dev/scripts": "0.0.0-dev",
42
42
  "lit": "^3.2.1",
43
43
  "playwright": "^1.62.1"